@outlit/cli 3.2.4 → 3.2.6

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "3.2.4",
+    version: "3.2.6",
     description: "CLI for querying Outlit customer context and installing agent skills",
     license: "Apache-2.0",
     repository: {
@@ -147,7 +147,7 @@ var init_package = __esm(() => {
     },
     dependencies: {
       "@clack/prompts": "^1.0.1",
-      "@outlit/tools": "^2.2.3",
+      "@outlit/tools": "^2.2.5",
       citty: "^0.2.1"
     },
     devDependencies: {
@@ -1715,7 +1715,7 @@ function matchesNumberBounds(value, schema, integer) {
     return false;
   return true;
 }
-var publicToolNames, publicToolContracts, consumerToolPolicies, toolGatewayTransport, apiKeyValidationTransport, apiKeyValidationSuccessSchema, apiKeyValidationFailureSchema, toolGatewayErrorSchema, customerBillingStatuses, customerFactStatuses, customerFactTypes, unsupportedCustomerFactTypes, customerFactCategories, customerIncludeSections, customerSourceTypes, customerSourceTypeAliasMap, customerSourceTypeAliases, customerSourceTypeInputs, customerTimeframes, timelineChannels, timelineTimeframes, userJourneyStages, workspaceUserListOrderFields, publicToolNameSet, customerSourceTypeSet, iso8601UtcDateTimeRegex, DEFAULT_OUTLIT_API_URL = "https://app.outlit.ai", OutlitToolsApiError, defaultToolNames, analyticalToolNames, piToolNames, cliToolNames, defaultToolNameSet, sqlToolNames;
+var publicToolNames, publicToolContracts, consumerToolPolicies, toolGatewayTransport, apiKeyValidationTransport, apiKeyValidationSuccessSchema, apiKeyValidationFailureSchema, apiKeyContractHeader = "Outlit-Api-Key-Contract", apiKeyValidationSuccessSchemaV2, toolGatewayErrorSchema, customerBillingStatuses, customerFactStatuses, customerFactTypes, unsupportedCustomerFactTypes, customerFactCategories, customerIncludeSections, customerSourceTypes, customerSourceTypeAliasMap, customerSourceTypeAliases, customerSourceTypeInputs, customerTimeframes, timelineChannels, timelineTimeframes, userJourneyStages, workspaceUserListOrderFields, publicToolNameSet, customerSourceTypeSet, iso8601UtcDateTimeRegex, DEFAULT_OUTLIT_API_URL = "https://app.outlit.ai", OutlitToolsApiError, defaultToolNames, analyticalToolNames, piToolNames, cliToolNames, defaultToolNameSet, sqlToolNames;
 var init_dist4 = __esm(() => {
   publicToolNames = [
     "outlit_list_customers",
@@ -2103,7 +2103,7 @@ var init_dist4 = __esm(() => {
       commandVersion: 1,
       ownerDomain: "users",
       title: "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.",
+      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 and each user's sources: where Outlit found them (CRM, support tool, product analytics, Slack) and the calls, meetings, emails, tickets and Slack threads they took part in.",
       annotations: {
         readOnlyHint: true,
         destructiveHint: false
@@ -2284,6 +2284,77 @@ var init_dist4 = __esm(() => {
                     }
                   ]
                 },
+                sources: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      system: {
+                        type: "string",
+                        description: "Lowercase id of the system, such as hubspot, salesforce, attio, pylon, posthog, slack, stripe, google-mail, google-calendar, ergo, fireflies, gong, mixpanel, outlit (the Outlit SDK) or product-analytics (a product-analytics provider Outlit did not record)."
+                      },
+                      kind: {
+                        type: "string",
+                        enum: [
+                          "contact",
+                          "product_user",
+                          "chat_member",
+                          "billing_customer",
+                          "call",
+                          "meeting",
+                          "email",
+                          "support_ticket",
+                          "slack_thread"
+                        ],
+                        description: "Records: contact (a contact in a CRM or support tool), product_user (a user in product analytics or product sign-in), chat_member (a Slack member), billing_customer. Conversations the person took part in: call, meeting, email, support_ticket, slack_thread."
+                      },
+                      count: {
+                        anyOf: [
+                          {
+                            type: "integer",
+                            minimum: 1,
+                            maximum: 9007199254740991
+                          },
+                          {
+                            type: "null"
+                          }
+                        ],
+                        description: "How many conversations of this kind; null for records."
+                      },
+                      firstSeenAt: {
+                        anyOf: [
+                          {
+                            type: "string"
+                          },
+                          {
+                            type: "null"
+                          }
+                        ],
+                        description: "When the record was created in the system (or first linked to this person), or the first conversation."
+                      },
+                      lastSeenAt: {
+                        anyOf: [
+                          {
+                            type: "string"
+                          },
+                          {
+                            type: "null"
+                          }
+                        ],
+                        description: "The latest conversation; null for records."
+                      }
+                    },
+                    required: [
+                      "system",
+                      "kind",
+                      "count",
+                      "firstSeenAt",
+                      "lastSeenAt"
+                    ],
+                    additionalProperties: false
+                  },
+                  description: "Where Outlit found this person: the systems that hold a record of them and the conversations they took part in. Empty when Outlit has no source recorded; absent from servers that predate it."
+                },
                 relationshipRole: {
                   anyOf: [
                     {
@@ -2578,7 +2649,7 @@ var init_dist4 = __esm(() => {
       commandVersion: 1,
       ownerDomain: "customers",
       title: "Get Customer",
-      description: "Get full details for a single customer. Optionally include users, revenue, recent activity, engagement metrics, or company enrichment. Revenue amounts (currentMrr, lifetimeRevenue) are in the billing provider's units for the customer's currency, which the result doesn't name. For USD, EUR, GBP and CAD these are cents: divide by 100 (e.g. 1234500 is $12,345, USD). Other currencies follow the provider's amount rules. ARR is 12 × currentMrr in the same units.",
+      description: "Get full details for a single customer. Optionally include users (each with their sources: where Outlit found them and the conversations they took part in), revenue, recent activity, engagement metrics, or company enrichment. Revenue amounts (currentMrr, lifetimeRevenue) are in the billing provider's units for the customer's currency, which the result doesn't name. For USD, EUR, GBP and CAD these are cents: divide by 100 (e.g. 1234500 is $12,345, USD). Other currencies follow the provider's amount rules. ARR is 12 × currentMrr in the same units.",
       annotations: {
         readOnlyHint: true,
         destructiveHint: false
@@ -2781,6 +2852,77 @@ var init_dist4 = __esm(() => {
                     }
                   ]
                 },
+                sources: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      system: {
+                        type: "string",
+                        description: "Lowercase id of the system, such as hubspot, salesforce, attio, pylon, posthog, slack, stripe, google-mail, google-calendar, ergo, fireflies, gong, mixpanel, outlit (the Outlit SDK) or product-analytics (a product-analytics provider Outlit did not record)."
+                      },
+                      kind: {
+                        type: "string",
+                        enum: [
+                          "contact",
+                          "product_user",
+                          "chat_member",
+                          "billing_customer",
+                          "call",
+                          "meeting",
+                          "email",
+                          "support_ticket",
+                          "slack_thread"
+                        ],
+                        description: "Records: contact (a contact in a CRM or support tool), product_user (a user in product analytics or product sign-in), chat_member (a Slack member), billing_customer. Conversations the person took part in: call, meeting, email, support_ticket, slack_thread."
+                      },
+                      count: {
+                        anyOf: [
+                          {
+                            type: "integer",
+                            minimum: 1,
+                            maximum: 9007199254740991
+                          },
+                          {
+                            type: "null"
+                          }
+                        ],
+                        description: "How many conversations of this kind; null for records."
+                      },
+                      firstSeenAt: {
+                        anyOf: [
+                          {
+                            type: "string"
+                          },
+                          {
+                            type: "null"
+                          }
+                        ],
+                        description: "When the record was created in the system (or first linked to this person), or the first conversation."
+                      },
+                      lastSeenAt: {
+                        anyOf: [
+                          {
+                            type: "string"
+                          },
+                          {
+                            type: "null"
+                          }
+                        ],
+                        description: "The latest conversation; null for records."
+                      }
+                    },
+                    required: [
+                      "system",
+                      "kind",
+                      "count",
+                      "firstSeenAt",
+                      "lastSeenAt"
+                    ],
+                    additionalProperties: false
+                  },
+                  description: "Where Outlit found this person: the systems that hold a record of them and the conversations they took part in. Empty when Outlit has no source recorded; absent from servers that predate it."
+                },
                 relationshipRole: {
                   anyOf: [
                     {
@@ -17774,6 +17916,226 @@ Returns column definitions and example queries for each view.`,
     ],
     additionalProperties: false
   };
+  apiKeyValidationSuccessSchemaV2 = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    type: "object",
+    properties: {
+      valid: {
+        type: "boolean",
+        const: true
+      },
+      organizationId: {
+        type: "string"
+      },
+      createdById: {
+        anyOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      organization: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string"
+          },
+          name: {
+            anyOf: [
+              {
+                type: "string"
+              },
+              {
+                type: "null"
+              }
+            ]
+          },
+          slug: {
+            anyOf: [
+              {
+                type: "string"
+              },
+              {
+                type: "null"
+              }
+            ]
+          }
+        },
+        required: [
+          "id",
+          "name",
+          "slug"
+        ],
+        additionalProperties: false
+      },
+      createdBy: {
+        anyOf: [
+          {
+            type: "object",
+            properties: {
+              id: {
+                type: "string"
+              },
+              email: {
+                type: "string"
+              },
+              name: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              }
+            },
+            required: [
+              "id",
+              "email",
+              "name"
+            ],
+            additionalProperties: false
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      apiKey: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string"
+          },
+          name: {
+            type: "string"
+          },
+          prefix: {
+            type: "string"
+          },
+          keyType: {
+            type: "string",
+            enum: [
+              "api",
+              "cli",
+              "mcp",
+              "ci"
+            ]
+          },
+          grants: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: [
+                "customer_intelligence:read",
+                "workspace_members:read",
+                "analytics:read",
+                "destinations:manage",
+                "behavior_metrics:manage",
+                "integrations:connect_own",
+                "integrations:manage",
+                "activation:read",
+                "activation:manage",
+                "workspace_settings:read",
+                "workspace_settings:manage",
+                "customer_access:manage",
+                "customer_identity:review",
+                "customer_identity:merge"
+              ]
+            }
+          },
+          createdAt: {
+            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))$"
+          },
+          lastUsedAt: {
+            anyOf: [
+              {
+                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))$"
+              },
+              {
+                type: "null"
+              }
+            ]
+          },
+          totalRequests: {
+            type: "integer",
+            minimum: 0,
+            maximum: 9007199254740991
+          },
+          expiresAt: {
+            anyOf: [
+              {
+                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))$"
+              },
+              {
+                type: "null"
+              }
+            ]
+          }
+        },
+        required: [
+          "id",
+          "name",
+          "prefix",
+          "keyType",
+          "grants",
+          "createdAt",
+          "lastUsedAt",
+          "totalRequests",
+          "expiresAt"
+        ],
+        additionalProperties: false
+      },
+      authorization: {
+        type: "object",
+        properties: {
+          grants: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: [
+                "customer_intelligence:read",
+                "workspace_members:read",
+                "analytics:read",
+                "destinations:manage",
+                "behavior_metrics:manage",
+                "integrations:connect_own",
+                "integrations:manage",
+                "activation:read",
+                "activation:manage",
+                "workspace_settings:read",
+                "workspace_settings:manage",
+                "customer_access:manage",
+                "customer_identity:review",
+                "customer_identity:merge"
+              ]
+            }
+          }
+        },
+        required: [
+          "grants"
+        ],
+        additionalProperties: false
+      }
+    },
+    required: [
+      "valid",
+      "organizationId",
+      "createdById",
+      "authorization"
+    ],
+    additionalProperties: false
+  };
   toolGatewayErrorSchema = {
     $schema: "https://json-schema.org/draft/2020-12/schema",
     type: "object",
@@ -18060,6 +18422,33 @@ var init_client = __esm(() => {
   cliToolNameSet = new Set(cliToolNames);
 });
 
+// src/lib/key-expiry.ts
+function keyExpiryWarning(expiresAt, now = new Date) {
+  if (!expiresAt)
+    return null;
+  const remainingMs = Date.parse(expiresAt) - now.getTime();
+  if (Number.isNaN(remainingMs) || remainingMs <= 0)
+    return null;
+  if (remainingMs > KEY_EXPIRY_WARNING_DAYS * DAY_MS)
+    return null;
+  const days = Math.max(1, Math.ceil(remainingMs / DAY_MS));
+  return `Warning: your Outlit API key expires in ${days} day${days === 1 ? "" : "s"}. Run \`outlit login\` to get a new one.
+`;
+}
+function warnIfKeyExpiresSoon(expiresAt) {
+  if (warned)
+    return;
+  const warning = keyExpiryWarning(expiresAt);
+  if (!warning)
+    return;
+  warned = true;
+  process.stderr.write(warning);
+}
+var KEY_EXPIRY_WARNING_DAYS = 14, DAY_MS, warned = false;
+var init_key_expiry = __esm(() => {
+  DAY_MS = 24 * 60 * 60 * 1000;
+});
+
 // src/lib/spinner.ts
 function createSpinner(message) {
   if (!isInteractive()) {
@@ -18194,7 +18583,8 @@ async function pingApiKey(apiKey) {
   const response = await globalThis.fetch(url, {
     method: apiKeyValidationTransport.method,
     headers: {
-      Authorization: `Bearer ${apiKey}`
+      Authorization: `Bearer ${apiKey}`,
+      [apiKeyContractHeader]: "2"
     }
   });
   const text = await response.text();
@@ -18209,8 +18599,13 @@ async function pingApiKey(apiKey) {
     const message2 = matchesGeneratedJsonSchema(payload, apiKeyValidationFailureSchema) ? payload.error : undefined;
     throw new ApiKeyValidationUnavailableError(message2);
   }
-  if (response.status === apiKeyValidationTransport.responseStatuses.success && matchesGeneratedJsonSchema(payload, apiKeyValidationSuccessSchema)) {
-    return payload;
+  if (response.status === apiKeyValidationTransport.responseStatuses.success) {
+    if (matchesGeneratedJsonSchema(payload, apiKeyValidationSuccessSchemaV2)) {
+      warnIfKeyExpiresSoon(payload.apiKey?.expiresAt);
+      return payload;
+    }
+    if (matchesGeneratedJsonSchema(payload, apiKeyValidationSuccessSchema))
+      return payload;
   }
   const message = matchesGeneratedJsonSchema(payload, apiKeyValidationFailureSchema) ? payload.error : text.length > 0 ? text : `API error (${response.status})`;
   if (!response.ok || response.status === apiKeyValidationTransport.responseStatuses.invalid) {
@@ -18302,6 +18697,7 @@ var init_api = __esm(() => {
   init_dist4();
   init_client();
   init_config();
+  init_key_expiry();
   init_output();
   init_spinner();
   init_table();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/cli",
-  "version": "3.2.4",
+  "version": "3.2.6",
   "description": "CLI for querying Outlit customer context and installing agent skills",
   "license": "Apache-2.0",
   "repository": {
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
-    "@outlit/tools": "^2.2.3",
+    "@outlit/tools": "^2.2.5",
     "citty": "^0.2.1"
   },
   "devDependencies": {