@outlit/cli 1.5.0 → 1.6.0

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "1.5.0",
+    version: "1.6.0",
     description: "CLI for Outlit customer intelligence platform",
     license: "Apache-2.0",
     repository: {
@@ -134,8 +134,9 @@ var init_package = __esm(() => {
       typecheck: "tsc --noEmit"
     },
     dependencies: {
-      citty: "^0.2.1",
-      "@clack/prompts": "^1.0.1"
+      "@clack/prompts": "^1.0.1",
+      "@outlit/tools": "^0.1.0",
+      citty: "^0.2.1"
     },
     devDependencies: {
       typescript: "^5.9.3",
@@ -1488,6 +1489,725 @@ var init_signup = __esm(() => {
   });
 });
 
+// ../tools/dist/index.js
+function isCustomerToolName(value) {
+  return customerToolNameSet.has(value);
+}
+function resolveCustomerContextSearchInput(value) {
+  if (!value.query) {
+    return {
+      ok: false,
+      message: "A query argument is required"
+    };
+  }
+  const normalizedQuery = value.query.trim();
+  if (normalizedQuery.length < 2) {
+    return {
+      ok: false,
+      message: "Query must be at least 2 non-whitespace characters"
+    };
+  }
+  if (value.after !== undefined && !iso8601UtcDateTimeRegex.test(value.after)) {
+    return {
+      ok: false,
+      message: "--after must be a valid ISO 8601 datetime"
+    };
+  }
+  const afterTime = value.after === undefined ? undefined : new Date(value.after).getTime();
+  if (afterTime !== undefined && Number.isNaN(afterTime)) {
+    return {
+      ok: false,
+      message: "--after must be a valid ISO 8601 datetime"
+    };
+  }
+  if (value.before !== undefined && !iso8601UtcDateTimeRegex.test(value.before)) {
+    return {
+      ok: false,
+      message: "--before must be a valid ISO 8601 datetime"
+    };
+  }
+  const beforeTime = value.before === undefined ? undefined : new Date(value.before).getTime();
+  if (beforeTime !== undefined && Number.isNaN(beforeTime)) {
+    return {
+      ok: false,
+      message: "--before must be a valid ISO 8601 datetime"
+    };
+  }
+  if (afterTime !== undefined && beforeTime !== undefined && afterTime > beforeTime) {
+    return {
+      ok: false,
+      message: "--after must be before or equal to --before"
+    };
+  }
+  return {
+    ok: true,
+    request: {
+      query: normalizedQuery,
+      customer: value.customer,
+      topK: value.topK,
+      after: value.after,
+      before: value.before,
+      sourceTypes: value.sourceTypes
+    }
+  };
+}
+function createOutlitClient(options) {
+  const key = options.apiKey.trim();
+  const baseUrl = options.baseUrl ?? DEFAULT_OUTLIT_API_URL;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  if (!key) {
+    throw new Error("apiKey is required");
+  }
+  if (!fetchImpl) {
+    throw new Error("fetch is not available");
+  }
+  return {
+    key,
+    baseUrl,
+    async callTool(toolName, input = {}) {
+      if (!isCustomerToolName(toolName)) {
+        throw new Error(`Unknown customer tool: ${toolName}`);
+      }
+      const response = await fetchImpl(new URL("/api/tools/call", baseUrl).toString(), {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${key}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          tool: toolName,
+          input
+        })
+      });
+      if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`API error (${response.status}): ${text}`);
+      }
+      return response.json();
+    }
+  };
+}
+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 init_dist4 = __esm(() => {
+  customerToolNames = [
+    "outlit_list_customers",
+    "outlit_list_users",
+    "outlit_get_customer",
+    "outlit_get_timeline",
+    "outlit_list_facts",
+    "outlit_get_fact",
+    "outlit_get_source",
+    "outlit_search_customer_context",
+    "outlit_query",
+    "outlit_schema"
+  ];
+  customerToolContracts = {
+    outlit_list_customers: {
+      toolName: "outlit_list_customers",
+      description: "Browse and filter customers. Use this to find customers by billing status, activity recency, revenue, or name. Returns a paginated list with summary info (MRR, last activity, status).",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          billingStatus: {
+            description: "Filter by billing status",
+            type: "string",
+            enum: ["NONE", "TRIALING", "PAYING", "PAST_DUE", "CHURNED"]
+          },
+          hasActivityInLast: {
+            description: "Filter customers with activity in the last N days",
+            type: "string",
+            enum: ["7d", "14d", "30d", "90d"]
+          },
+          noActivityInLast: {
+            description: "Filter customers with NO activity in the last N days",
+            type: "string",
+            enum: ["7d", "14d", "30d", "90d"]
+          },
+          mrrAbove: {
+            description: "Minimum MRR in cents (e.g., 10000 = $100)",
+            type: "number",
+            minimum: 0
+          },
+          mrrBelow: {
+            description: "Maximum MRR in cents",
+            type: "number",
+            minimum: 0
+          },
+          traitFilters: {
+            description: "Filter by exact trait values using key/value pairs",
+            type: "object",
+            propertyNames: {
+              type: "string",
+              pattern: "^[A-Za-z0-9_-]{1,100}$"
+            },
+            additionalProperties: {
+              anyOf: [
+                {
+                  type: "string",
+                  maxLength: 500
+                },
+                {
+                  type: "number"
+                },
+                {
+                  type: "boolean"
+                }
+              ]
+            }
+          },
+          search: {
+            description: "Search by customer name or domain (case-insensitive)",
+            type: "string",
+            maxLength: 500
+          },
+          limit: {
+            description: "Results per page (max 1000)",
+            default: 50,
+            type: "number",
+            minimum: 1,
+            maximum: 1000
+          },
+          cursor: {
+            description: "Pagination cursor from previous response",
+            type: "string"
+          },
+          orderBy: {
+            description: "Field to order results by",
+            default: "last_activity_at",
+            type: "string",
+            enum: ["last_activity_at", "first_seen_at", "name", "mrr_cents"]
+          },
+          orderDirection: {
+            description: "Sort direction",
+            default: "desc",
+            type: "string",
+            enum: ["asc", "desc"]
+          }
+        },
+        additionalProperties: false
+      }
+    },
+    outlit_list_users: {
+      toolName: "outlit_list_users",
+      description: "Browse and filter users. Use this to find users by journey stage, activity recency, customer, or email/name. Returns a paginated list with activity info.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          journeyStage: {
+            description: "Filter by user journey stage",
+            type: "string",
+            enum: ["DISCOVERED", "SIGNED_UP", "ACTIVATED", "ENGAGED", "INACTIVE"]
+          },
+          customerId: {
+            description: "Filter users by customer ID",
+            type: "string",
+            maxLength: 500
+          },
+          traitFilters: {
+            description: "Filter by exact trait values using key/value pairs",
+            type: "object",
+            propertyNames: {
+              type: "string",
+              pattern: "^[A-Za-z0-9_-]{1,100}$"
+            },
+            additionalProperties: {
+              anyOf: [
+                {
+                  type: "string",
+                  maxLength: 500
+                },
+                {
+                  type: "number"
+                },
+                {
+                  type: "boolean"
+                }
+              ]
+            }
+          },
+          hasActivityInLast: {
+            description: "Filter users active within this window. Format: Nd, Nh, or Nm (e.g., '7d', '24h', '90m')",
+            type: "string",
+            pattern: "^\\d+(d|h|m)$"
+          },
+          noActivityInLast: {
+            description: "Filter users NOT active within this window. Format: Nd, Nh, or Nm (e.g., '30d', '2h')",
+            type: "string",
+            pattern: "^\\d+(d|h|m)$"
+          },
+          search: {
+            description: "Search by user email or name (case-insensitive)",
+            type: "string",
+            maxLength: 500
+          },
+          limit: {
+            description: "Results per page (max 1000)",
+            default: 50,
+            type: "number",
+            minimum: 1,
+            maximum: 1000
+          },
+          cursor: {
+            description: "Pagination cursor from previous response",
+            type: "string"
+          },
+          orderBy: {
+            description: "Field to order by",
+            default: "last_activity_at",
+            type: "string",
+            enum: ["last_activity_at", "first_seen_at", "email"]
+          },
+          orderDirection: {
+            description: "Sort direction",
+            default: "desc",
+            type: "string",
+            enum: ["asc", "desc"]
+          }
+        },
+        additionalProperties: false
+      }
+    },
+    outlit_get_customer: {
+      toolName: "outlit_get_customer",
+      description: "Get full details for a single customer. Use this when you already know which customer you want to inspect. Optionally include related data (users, revenue, recent activity, engagement metrics).",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          customer: {
+            type: "string",
+            description: "Customer ID, domain, or name to look up"
+          },
+          include: {
+            description: "Additional data sections to include in the response",
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["users", "revenue", "recentTimeline", "behaviorMetrics"]
+            }
+          },
+          timeframe: {
+            description: "Timeframe for timeline and behavior metrics (default: 30d)",
+            default: "30d",
+            type: "string",
+            enum: ["7d", "14d", "30d", "90d"]
+          }
+        },
+        required: ["customer"],
+        additionalProperties: false
+      }
+    },
+    outlit_get_timeline: {
+      toolName: "outlit_get_timeline",
+      description: "Get the chronological activity timeline for a customer. Use this to see what happened and when — emails, calls, Slack messages, billing events, etc. Supports channel and date filtering.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          customer: {
+            type: "string",
+            description: "Customer ID or domain"
+          },
+          channels: {
+            description: "Filter by event channel (e.g., EMAIL, SLACK, CALL)",
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["SDK", "EMAIL", "SLACK", "CALL", "CRM", "BILLING", "SUPPORT", "INTERNAL"]
+            }
+          },
+          eventTypes: {
+            description: "Filter by event type",
+            type: "array",
+            items: {
+              type: "string"
+            }
+          },
+          timeframe: {
+            description: "Relative time window (default: 30d). Cannot be used with startDate/endDate.",
+            type: "string",
+            enum: ["7d", "14d", "30d", "90d", "all"]
+          },
+          startDate: {
+            description: "Start of time window (ISO 8601, e.g. '2025-01-01T00:00:00Z'). Cannot be used with timeframe.",
+            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))$"
+          },
+          endDate: {
+            description: "End of time window (ISO 8601, e.g. '2025-01-31T23:59:59Z'). Cannot be used with timeframe.",
+            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))$"
+          },
+          limit: {
+            description: "Results per page (max 1000)",
+            default: 50,
+            type: "number",
+            minimum: 1,
+            maximum: 1000
+          },
+          cursor: {
+            description: "Pagination cursor from previous response",
+            type: "string"
+          }
+        },
+        required: ["customer"],
+        additionalProperties: false
+      }
+    },
+    outlit_list_facts: {
+      toolName: "outlit_list_facts",
+      description: "List structured facts known about a customer. Use filters like status, sourceTypes, factTypes, factCategories, and date bounds to narrow the result set. For topic-specific retrieval, use outlit_search_customer_context instead.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          customer: {
+            type: "string",
+            description: "Customer ID or domain"
+          },
+          status: {
+            description: "Optional fact status filter",
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["ACTIVE", "ACKNOWLEDGED", "RESOLVED", "SNOOZED", "CANDIDATE"]
+            }
+          },
+          sourceTypes: {
+            description: "Optional generic source types to restrict fact results to.",
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"]
+            }
+          },
+          factTypes: {
+            description: "Optional customer-memory fact type filters, such as CHURN_RISK, EXPANSION, SENTIMENT, or BUDGET. Anomaly detector fact types are not supported.",
+            type: "array",
+            items: {
+              type: "string",
+              enum: [
+                "CUSTOM",
+                "COMPANY_CHANGE",
+                "FUNDING_REVENUE",
+                "TECHNOLOGY",
+                "STRATEGY",
+                "COMPETITIVE",
+                "SENTIMENT",
+                "CHAMPION_RISK",
+                "EXPANSION",
+                "CHURN_RISK",
+                "TIMELINE",
+                "BUDGET",
+                "DECISION_MAKER",
+                "REQUIREMENTS",
+                "PRODUCT_USAGE",
+                "CONTACT_INFO",
+                "CONTACT_PREFERENCE"
+              ]
+            }
+          },
+          factCategories: {
+            description: "Optional public fact category filters. Supported values: MEMORY, CUSTOM.",
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["MEMORY", "CUSTOM"]
+            }
+          },
+          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))$"
+          },
+          limit: {
+            description: "Results per page (max 100)",
+            default: 50,
+            type: "number",
+            minimum: 1,
+            maximum: 100
+          },
+          cursor: {
+            description: "Pagination cursor from previous response",
+            type: "string"
+          }
+        },
+        required: ["customer"],
+        additionalProperties: false
+      }
+    },
+    outlit_get_fact: {
+      toolName: "outlit_get_fact",
+      description: "Get one exact fact by ID. Returns the canonical fact shape and optionally expands requested related data such as evidence.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          factId: {
+            type: "string",
+            minLength: 1,
+            maxLength: 500,
+            description: "Exact fact ID to retrieve"
+          },
+          include: {
+            description: "Optional best-effort expansions. Use include=['evidence'] to request evidence when available; unsupported include values are ignored.",
+            type: "array",
+            items: {
+              type: "string",
+              minLength: 1,
+              maxLength: 100
+            }
+          }
+        },
+        required: ["factId"],
+        additionalProperties: false
+      }
+    },
+    outlit_get_source: {
+      toolName: "outlit_get_source",
+      description: "Get one exact source record by generic sourceType and sourceId. Use this when you already know the concrete underlying source you want to inspect.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          sourceType: {
+            type: "string",
+            enum: ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"]
+          },
+          sourceId: {
+            type: "string",
+            minLength: 1,
+            maxLength: 500
+          }
+        },
+        required: ["sourceType", "sourceId"],
+        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.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          customer: {
+            description: "Customer ID, domain, or name. Omit to search across all customers.",
+            anyOf: [
+              {
+                type: "string",
+                minLength: 1,
+                maxLength: 500
+              },
+              {
+                type: "null"
+              }
+            ]
+          },
+          query: {
+            type: "string",
+            minLength: 2,
+            maxLength: 2000,
+            description: "Natural language query or topic to search for."
+          },
+          topK: {
+            description: "Maximum number of artifact results to return (default 20).",
+            type: "integer",
+            minimum: 1,
+            maximum: 50
+          },
+          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))$"
+          },
+          sourceTypes: {
+            description: "Optional generic source types to restrict the search to.",
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"]
+            }
+          }
+        },
+        required: ["query"],
+        additionalProperties: false
+      }
+    },
+    outlit_query: {
+      toolName: "outlit_query",
+      description: `Execute raw SQL queries against your analytics data.
+
+Available tables:
+- events: Customer activity events (event_type, event_channel, customer_id, occurred_at, properties, ...)
+- customer_dimensions: Customer attributes (customer_id, domain, name, billing_status, plan, mrr_cents, ...)
+- user_dimensions: User attributes (user_id, email, name, customer_id, ...)
+- mrr_snapshots: Revenue snapshots over time (customer_id, snapshot_date, mrr_cents, ...)
+
+All queries are automatically filtered to your organization's data.
+Only SELECT queries are allowed.
+
+Example queries:
+- SELECT event_type, count(*) FROM events GROUP BY 1 ORDER BY 2 DESC LIMIT 10
+- SELECT billing_status, sum(mrr_cents)/100 as mrr FROM customer_dimensions GROUP BY 1
+- SELECT * FROM events WHERE customer_id = 'cust_123' ORDER BY occurred_at DESC LIMIT 50`,
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          sql: {
+            type: "string",
+            description: "SQL SELECT query to execute"
+          },
+          limit: {
+            description: "Max rows to return (default 1000, max 10000)",
+            default: 1000,
+            type: "number",
+            maximum: 1e4
+          }
+        },
+        required: ["sql"],
+        additionalProperties: false
+      }
+    },
+    outlit_schema: {
+      toolName: "outlit_schema",
+      description: `Get table schemas for available analytics tables.
+
+Use this to discover column names, types, and descriptions before writing SQL queries.
+Returns column definitions and example queries for each table.`,
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          table: {
+            description: "Specific table to describe, or omit for all tables",
+            type: "string",
+            enum: ["events", "customer_dimensions", "user_dimensions", "mrr_snapshots"]
+          }
+        },
+        additionalProperties: false
+      }
+    }
+  };
+  customerBillingStatuses = [
+    "NONE",
+    "TRIALING",
+    "PAYING",
+    "PAST_DUE",
+    "CHURNED"
+  ];
+  customerFactStatuses = [
+    "ACTIVE",
+    "ACKNOWLEDGED",
+    "RESOLVED",
+    "SNOOZED",
+    "CANDIDATE"
+  ];
+  customerFactTypes = [
+    "CUSTOM",
+    "COMPANY_CHANGE",
+    "FUNDING_REVENUE",
+    "TECHNOLOGY",
+    "STRATEGY",
+    "COMPETITIVE",
+    "SENTIMENT",
+    "CHAMPION_RISK",
+    "EXPANSION",
+    "CHURN_RISK",
+    "TIMELINE",
+    "BUDGET",
+    "DECISION_MAKER",
+    "REQUIREMENTS",
+    "PRODUCT_USAGE",
+    "CONTACT_INFO",
+    "CONTACT_PREFERENCE"
+  ];
+  unsupportedCustomerFactTypes = [
+    "TRACKING_GAP",
+    "SCHEMA_DRIFT",
+    "INGESTION_LAG",
+    "ACTIVATION_RATE_DROP",
+    "FUNNEL_DROPOFF",
+    "CORE_ACTION_DECAY",
+    "CADENCE_BREAK",
+    "QUIET_ACCOUNT",
+    "CHAMPION_AT_RISK",
+    "SEGMENT_DIVERGENCE"
+  ];
+  customerFactCategories = ["MEMORY", "CUSTOM"];
+  customerIncludeSections = [
+    "users",
+    "revenue",
+    "recentTimeline",
+    "behaviorMetrics"
+  ];
+  customerSourceTypes = ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"];
+  customerTimeframes = ["7d", "14d", "30d", "90d"];
+  timelineChannels = [
+    "SDK",
+    "EMAIL",
+    "SLACK",
+    "CALL",
+    "CRM",
+    "BILLING",
+    "SUPPORT",
+    "INTERNAL"
+  ];
+  timelineTimeframes = ["7d", "14d", "30d", "90d", "all"];
+  userJourneyStages = [
+    "DISCOVERED",
+    "SIGNED_UP",
+    "ACTIVATED",
+    "ENGAGED",
+    "INACTIVE"
+  ];
+  schemaTables = [
+    "events",
+    "customer_dimensions",
+    "user_dimensions",
+    "mrr_snapshots"
+  ];
+  customerToolNameSet = new Set(customerToolNames);
+  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))$/;
+  defaultAgentToolNames = [
+    "outlit_list_customers",
+    "outlit_list_users",
+    "outlit_get_customer",
+    "outlit_get_timeline",
+    "outlit_list_facts",
+    "outlit_get_fact",
+    "outlit_get_source",
+    "outlit_search_customer_context"
+  ];
+  sqlToolNames = [
+    "outlit_schema",
+    "outlit_query"
+  ];
+  analyticalAgentToolNames = [
+    ...defaultAgentToolNames,
+    ...sqlToolNames
+  ];
+});
+
 // src/lib/client.ts
 function buildUrl(base, path, params) {
   const url = new URL(path, base);
@@ -1513,11 +2233,18 @@ async function createClient(flagApiKey) {
     throw new Error(`Invalid API key format. Keys must start with "ok_" followed by at least 32 alphanumeric characters. Get one at ${OUTLIT_DASHBOARD_URL}`);
   }
   const baseUrl = process.env.OUTLIT_API_URL ?? DEFAULT_API_URL;
+  const toolsClient = createOutlitClient({
+    apiKey: credential.key,
+    baseUrl
+  });
   return {
     key: credential.key,
     baseUrl,
     async callTool(toolName, params) {
-      const endpoint = TOOL_ENDPOINTS[toolName];
+      if (isCustomerToolName(toolName)) {
+        return toolsClient.callTool(toolName, params);
+      }
+      const endpoint = CLI_TOOL_ENDPOINTS[toolName];
       if (!endpoint) {
         throw new Error(`Unknown tool: ${toolName}`);
       }
@@ -1546,31 +2273,22 @@ async function createClient(flagApiKey) {
     }
   };
 }
-var API_KEY_REGEX, TOOL_ENDPOINTS;
+var API_KEY_REGEX, CLI_TOOL_ENDPOINTS;
 var init_client = __esm(() => {
+  init_dist4();
   init_config();
   API_KEY_REGEX = /^ok_[A-Za-z0-9_-]{32,}$/;
-  TOOL_ENDPOINTS = {
-    outlit_list_customers: { method: "GET", path: "/api/internal/mcp/customers" },
-    outlit_get_customer: { method: "POST", path: "/api/internal/mcp/customers" },
-    outlit_list_users: { method: "GET", path: "/api/internal/mcp/users" },
-    outlit_get_timeline: { method: "POST", path: "/api/internal/mcp/timeline" },
-    outlit_list_facts: { method: "POST", path: "/api/internal/mcp/facts" },
-    outlit_get_fact: { method: "POST", path: "/api/internal/mcp/facts/get" },
-    outlit_get_source: { method: "POST", path: "/api/internal/mcp/context-source" },
-    outlit_schema: { method: "GET", path: "/api/internal/mcp/sql-schema" },
-    outlit_query: { method: "POST", path: "/api/internal/mcp/sql" },
-    outlit_search_customer_context: { method: "POST", path: "/api/internal/mcp/context-search" },
-    outlit_list_integrations: { method: "GET", path: "/api/internal/mcp/integrations" },
-    outlit_connect_integration: { method: "POST", path: "/api/internal/mcp/integrations/connect" },
-    outlit_connect_status: { method: "GET", path: "/api/internal/mcp/integrations/connect/status" },
+  CLI_TOOL_ENDPOINTS = {
+    outlit_list_integrations: { method: "GET", path: "/api/integrations" },
+    outlit_connect_integration: { method: "POST", path: "/api/integrations/connect" },
+    outlit_connect_status: { method: "GET", path: "/api/integrations/connect/status" },
     outlit_disconnect_integration: {
       method: "POST",
-      path: "/api/internal/mcp/integrations/disconnect"
+      path: "/api/integrations/disconnect"
     },
     outlit_integration_sync_status: {
       method: "GET",
-      path: "/api/internal/mcp/integrations/sync-status"
+      path: "/api/integrations/sync-status"
     }
   };
 });
@@ -1700,7 +2418,7 @@ async function getClientOrExit(flagApiKey, json) {
 }
 async function pingApiKey(apiKey) {
   const baseUrl = process.env.OUTLIT_API_URL ?? DEFAULT_API_URL;
-  const url = new URL("/api/internal/mcp/validate-api-key", baseUrl).toString();
+  const url = new URL("/api/validate-api-key", baseUrl).toString();
   const response = await globalThis.fetch(url, {
     method: "POST",
     headers: {
@@ -2201,148 +2919,6 @@ Use this to fetch the next page of results.`
   };
 });
 
-// src/generated/tool-contracts.ts
-function resolveCustomerContextSearchInput(value) {
-  if (!value.query) {
-    return {
-      ok: false,
-      message: "A query argument is required"
-    };
-  }
-  const normalizedQuery = value.query.trim();
-  if (normalizedQuery.length < 2) {
-    return {
-      ok: false,
-      message: "Query must be at least 2 non-whitespace characters"
-    };
-  }
-  if (value.after !== undefined && value.before !== undefined && new Date(value.after).getTime() > new Date(value.before).getTime()) {
-    return {
-      ok: false,
-      message: "--after must be before or equal to --before"
-    };
-  }
-  return {
-    ok: true,
-    request: {
-      query: normalizedQuery,
-      customer: value.customer,
-      topK: value.topK,
-      after: value.after,
-      before: value.before,
-      sourceTypes: value.sourceTypes
-    }
-  };
-}
-var customerToolContracts, customerBillingStatuses, customerFactStatuses, customerIncludeSections, customerSourceTypes, customerTimeframes, timelineChannels, timelineTimeframes, userJourneyStages, schemaTables;
-var init_tool_contracts = __esm(() => {
-  customerToolContracts = {
-    outlit_list_customers: {
-      toolName: "outlit_list_customers",
-      description: "Browse and filter customers. Use this to find customers by billing status, activity recency, revenue, or name. Returns a paginated list with summary info (MRR, last activity, status)."
-    },
-    outlit_list_users: {
-      toolName: "outlit_list_users",
-      description: "Browse and filter users. Use this to find users by journey stage, activity recency, customer, or email/name. Returns a paginated list with activity info."
-    },
-    outlit_get_customer: {
-      toolName: "outlit_get_customer",
-      description: "Get full details for a single customer. Use this when you already know which customer you want to inspect. Optionally include related data (users, revenue, recent activity, engagement metrics)."
-    },
-    outlit_get_timeline: {
-      toolName: "outlit_get_timeline",
-      description: "Get the chronological activity timeline for a customer. Use this to see what happened and when — emails, calls, Slack messages, billing events, etc. Supports channel and date filtering."
-    },
-    outlit_list_facts: {
-      toolName: "outlit_list_facts",
-      description: "List structured facts known about a customer. Use filters like status, sourceTypes, and date bounds to narrow the result set. For topic-specific retrieval, use outlit_search_customer_context instead."
-    },
-    outlit_get_fact: {
-      toolName: "outlit_get_fact",
-      description: "Get one exact fact by ID. Returns the canonical fact shape and optionally expands requested related data such as evidence."
-    },
-    outlit_get_source: {
-      toolName: "outlit_get_source",
-      description: "Get one exact source record by generic sourceType and sourceId. Use this when you already know the concrete underlying source you want to inspect."
-    },
-    outlit_search_customer_context: {
-      toolName: "outlit_search_customer_context",
-      description: "Search across all known customer context using a natural-language query. Returns grouped artifact-level results for matching sources and facts. Omit customer to search across all customers in the organization."
-    },
-    outlit_query: {
-      toolName: "outlit_query",
-      description: `Execute raw SQL queries against your analytics data.
-
-Available tables:
-- events: Customer activity events (event_type, event_channel, customer_id, occurred_at, properties, ...)
-- customer_dimensions: Customer attributes (customer_id, domain, name, billing_status, plan, mrr_cents, ...)
-- user_dimensions: User attributes (user_id, email, name, customer_id, ...)
-- mrr_snapshots: Revenue snapshots over time (customer_id, snapshot_date, mrr_cents, ...)
-
-All queries are automatically filtered to your organization's data.
-Only SELECT queries are allowed.
-
-Example queries:
-- SELECT event_type, count(*) FROM events GROUP BY 1 ORDER BY 2 DESC LIMIT 10
-- SELECT billing_status, sum(mrr_cents)/100 as mrr FROM customer_dimensions GROUP BY 1
-- SELECT * FROM events WHERE customer_id = 'cust_123' ORDER BY occurred_at DESC LIMIT 50`
-    },
-    outlit_schema: {
-      toolName: "outlit_schema",
-      description: `Get table schemas for available analytics tables.
-
-Use this to discover column names, types, and descriptions before writing SQL queries.
-Returns column definitions and example queries for each table.`
-    }
-  };
-  customerBillingStatuses = [
-    "NONE",
-    "TRIALING",
-    "PAYING",
-    "PAST_DUE",
-    "CHURNED"
-  ];
-  customerFactStatuses = [
-    "ACTIVE",
-    "ACKNOWLEDGED",
-    "RESOLVED",
-    "SNOOZED",
-    "CANDIDATE"
-  ];
-  customerIncludeSections = [
-    "users",
-    "revenue",
-    "recentTimeline",
-    "behaviorMetrics"
-  ];
-  customerSourceTypes = ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"];
-  customerTimeframes = ["7d", "14d", "30d", "90d"];
-  timelineChannels = [
-    "SDK",
-    "EMAIL",
-    "SLACK",
-    "CALL",
-    "CRM",
-    "BILLING",
-    "SUPPORT",
-    "INTERNAL"
-  ];
-  timelineTimeframes = ["7d", "14d", "30d", "90d", "all"];
-  userJourneyStages = [
-    "DISCOVERED",
-    "SIGNED_UP",
-    "ACTIVATED",
-    "ENGAGED",
-    "INACTIVE"
-  ];
-  schemaTables = [
-    "events",
-    "customer_dimensions",
-    "user_dimensions",
-    "mrr_snapshots"
-  ];
-});
-
 // src/lib/format.ts
 function formatCents(value) {
   if (value == null || typeof value !== "number" || Number.isNaN(value))
@@ -2401,12 +2977,12 @@ __export(exports_list, {
 });
 var list_default;
 var init_list = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_filters();
   init_output2();
   init_pagination();
-  init_tool_contracts();
   init_api();
   init_output();
   list_default = defineCommand2({
@@ -2514,10 +3090,10 @@ __export(exports_get, {
 });
 var get_default;
 var init_get = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
-  init_tool_contracts();
   init_api();
   init_config();
   get_default = defineCommand2({
@@ -2591,11 +3167,11 @@ __export(exports_timeline, {
 });
 var timeline_default;
 var init_timeline = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
   init_pagination();
-  init_tool_contracts();
   init_api();
   init_config();
   timeline_default = defineCommand2({
@@ -2617,7 +3193,7 @@ var init_timeline = __esm(() => {
         "  outlit customers timeline acme.com",
         "  outlit customers timeline acme.com --timeframe 90d",
         "  outlit customers timeline acme.com --channels EMAIL,SLACK",
-        "  outlit customers timeline acme.com --start-date 2025-01-01 --end-date 2025-03-01",
+        "  outlit customers timeline acme.com --start-date 2025-01-01T00:00:00Z --end-date 2025-03-01T23:59:59Z",
         "  outlit customers timeline acme.com --event-types PAGE_VIEW,MEETING --limit 50",
         "",
         AGENT_JSON_HINT
@@ -2648,11 +3224,11 @@ var init_timeline = __esm(() => {
       },
       "start-date": {
         type: "string",
-        description: "Start date for the event range (ISO 8601, e.g. 2025-01-01). When set, --timeframe is ignored."
+        description: "Start datetime for the event range (ISO 8601, e.g. 2025-01-01T00:00:00Z). When set, --timeframe is ignored."
       },
       "end-date": {
         type: "string",
-        description: "End date for the event range (ISO 8601, e.g. 2025-03-01). When set, --timeframe is ignored."
+        description: "End datetime for the event range (ISO 8601, e.g. 2025-03-01T23:59:59Z). When set, --timeframe is ignored."
       }
     },
     async run({ args }) {
@@ -2719,12 +3295,12 @@ __export(exports_list2, {
 });
 var list_default2;
 var init_list2 = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_filters();
   init_output2();
   init_pagination();
-  init_tool_contracts();
   init_api();
   init_output();
   list_default2 = defineCommand2({
@@ -3797,11 +4373,11 @@ function invalidValues(values, allowed) {
 }
 var list_default3;
 var init_list3 = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
   init_pagination();
-  init_tool_contracts();
   init_api();
   init_config();
   init_output();
@@ -3816,11 +4392,13 @@ var init_list3 = __esm(() => {
         "Examples:",
         "  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 --limit 50 --json",
         "",
         `Statuses: ${customerFactStatuses.join(", ")}`,
         `Source types: ${customerSourceTypes.join(", ")}`,
+        `Fact categories: ${customerFactCategories.join(", ")}`,
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -3843,6 +4421,14 @@ var init_list3 = __esm(() => {
         type: "string",
         description: `Comma-separated generic source type filter (${customerSourceTypes.join(", ")})`
       },
+      "fact-types": {
+        type: "string",
+        description: "Comma-separated customer-memory fact type filter, such as CHURN_RISK, EXPANSION, or SENTIMENT"
+      },
+      "fact-categories": {
+        type: "string",
+        description: `Comma-separated fact category filter (${customerFactCategories.join(", ")})`
+      },
       after: {
         type: "string",
         description: "Filter to facts occurring after this ISO 8601 datetime"
@@ -3856,6 +4442,8 @@ var init_list3 = __esm(() => {
       const json = !!args.json;
       const statuses = parseCsvArg(args.status);
       const sourceTypes = parseCsvArg(args["source-types"]);
+      const factTypes = parseCsvArg(args["fact-types"]);
+      const factCategories = parseCsvArg(args["fact-categories"]);
       const invalidStatuses = invalidValues(statuses, customerFactStatuses);
       if (invalidStatuses.length > 0) {
         return outputError({
@@ -3870,6 +4458,29 @@ var init_list3 = __esm(() => {
           code: "invalid_input"
         }, json);
       }
+      const invalidFactTypes = invalidValues(factTypes, customerFactTypes);
+      if (invalidFactTypes.length > 0) {
+        const anomalyFactTypes = invalidFactTypes.filter((value) => unsupportedCustomerFactTypes.includes(value));
+        const unknownFactTypes = invalidFactTypes.filter((value) => !unsupportedCustomerFactTypes.includes(value));
+        const messageParts = [];
+        if (anomalyFactTypes.length > 0) {
+          messageParts.push(`Anomaly detector fact types are not supported as public filters: ${anomalyFactTypes.join(", ")}. Use customer-memory fact types such as CHURN_RISK, EXPANSION, SENTIMENT, or PRODUCT_USAGE.`);
+        }
+        if (unknownFactTypes.length > 0) {
+          messageParts.push(`Unknown fact types: ${unknownFactTypes.join(", ")}. Allowed: ${customerFactTypes.join(", ")}`);
+        }
+        return outputError({
+          message: messageParts.join(" "),
+          code: "invalid_input"
+        }, json);
+      }
+      const invalidFactCategories = invalidValues(factCategories, customerFactCategories);
+      if (invalidFactCategories.length > 0) {
+        return outputError({
+          message: `Unsupported fact categories: ${invalidFactCategories.join(", ")}. Allowed: ${customerFactCategories.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
       const afterDate = args.after ? new Date(args.after) : null;
       const beforeDate = args.before ? new Date(args.before) : null;
       if (afterDate && Number.isNaN(afterDate.getTime())) {
@@ -3898,6 +4509,10 @@ var init_list3 = __esm(() => {
         params.status = statuses;
       if (sourceTypes)
         params.sourceTypes = sourceTypes;
+      if (factTypes)
+        params.factTypes = factTypes;
+      if (factCategories)
+        params.factCategories = factCategories;
       if (args.after)
         params.after = args.after;
       if (args.before)
@@ -3921,10 +4536,10 @@ function parseCsvArg2(value) {
 }
 var get_default2;
 var init_get2 = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
-  init_tool_contracts();
   init_api();
   init_config();
   get_default2 = defineCommand2({
@@ -4007,10 +4622,10 @@ __export(exports_get3, {
 });
 var get_default3;
 var init_get3 = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
-  init_tool_contracts();
   init_api();
   init_output();
   get_default3 = defineCommand2({
@@ -4095,10 +4710,10 @@ __export(exports_search, {
 });
 var search_default;
 var init_search = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
-  init_tool_contracts();
   init_api();
   init_config();
   init_output();
@@ -4193,10 +4808,10 @@ __export(exports_sql, {
 import { readFileSync as readFileSync4 } from "node:fs";
 var sql_default;
 var init_sql = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
-  init_tool_contracts();
   init_api();
   init_output();
   sql_default = defineCommand2({
@@ -4271,10 +4886,10 @@ __export(exports_schema, {
 });
 var schema_default;
 var init_schema = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
-  init_tool_contracts();
   init_api();
   schema_default = defineCommand2({
     meta: {
@@ -5181,6 +5796,8 @@ var init_completions = __esm(() => {
             ...PAGINATED,
             { name: "--status", desc: "Filter by fact status" },
             { name: "--source-types", desc: "Filter by source types" },
+            { name: "--fact-types", desc: "Filter by fact types" },
+            { name: "--fact-categories", desc: "Filter by fact categories" },
             { name: "--after", desc: "Facts after date (ISO 8601)" },
             { name: "--before", desc: "Facts before date (ISO 8601)" }
           ]
@@ -6053,7 +6670,7 @@ Usage examples:
   outlit customers get acme.com --include users,revenue
   outlit customers timeline acme.com --timeframe 90d
   outlit users list --journey-stage CHAMPION
-  outlit facts list acme.com --source-types CALL --after 2025-01-01T00:00:00Z
+  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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/cli",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "CLI for Outlit customer intelligence platform",
   "license": "Apache-2.0",
   "repository": {
@@ -30,8 +30,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "citty": "^0.2.1",
-    "@clack/prompts": "^1.0.1"
+    "@clack/prompts": "^1.0.1",
+    "@outlit/tools": "^0.1.0",
+    "citty": "^0.2.1"
   },
   "devDependencies": {
     "typescript": "^5.9.3",