@outlit/tools 2.2.3 → 2.2.5

package/dist/index.d.cts

@@ -244,7 +244,7 @@ declare const publicToolContracts: {
         readonly commandVersion: 1;
         readonly ownerDomain: "users";
         readonly title: "List Users";
-        readonly 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.";
+        readonly 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.";
         readonly annotations: {
             readonly readOnlyHint: true;
             readonly destructiveHint: false;
@@ -384,6 +384,52 @@ declare const publicToolContracts: {
                                     readonly type: "null";
                                 }];
                             };
+                            readonly sources: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly system: {
+                                            readonly type: "string";
+                                            readonly 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).";
+                                        };
+                                        readonly kind: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["contact", "product_user", "chat_member", "billing_customer", "call", "meeting", "email", "support_ticket", "slack_thread"];
+                                            readonly 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.";
+                                        };
+                                        readonly count: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "integer";
+                                                readonly minimum: 1;
+                                                readonly maximum: 9007199254740991;
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "How many conversations of this kind; null for records.";
+                                        };
+                                        readonly firstSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "When the record was created in the system (or first linked to this person), or the first conversation.";
+                                        };
+                                        readonly lastSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "The latest conversation; null for records.";
+                                        };
+                                    };
+                                    readonly required: readonly ["system", "kind", "count", "firstSeenAt", "lastSeenAt"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly 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.";
+                            };
                             readonly relationshipRole: {
                                 readonly anyOf: readonly [{
                                     readonly type: "string";
@@ -600,7 +646,7 @@ declare const publicToolContracts: {
         readonly commandVersion: 1;
         readonly ownerDomain: "customers";
         readonly title: "Get Customer";
-        readonly 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.";
+        readonly 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.";
         readonly annotations: {
             readonly readOnlyHint: true;
             readonly destructiveHint: false;
@@ -738,6 +784,52 @@ declare const publicToolContracts: {
                                     readonly type: "null";
                                 }];
                             };
+                            readonly sources: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly system: {
+                                            readonly type: "string";
+                                            readonly 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).";
+                                        };
+                                        readonly kind: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["contact", "product_user", "chat_member", "billing_customer", "call", "meeting", "email", "support_ticket", "slack_thread"];
+                                            readonly 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.";
+                                        };
+                                        readonly count: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "integer";
+                                                readonly minimum: 1;
+                                                readonly maximum: 9007199254740991;
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "How many conversations of this kind; null for records.";
+                                        };
+                                        readonly firstSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "When the record was created in the system (or first linked to this person), or the first conversation.";
+                                        };
+                                        readonly lastSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "The latest conversation; null for records.";
+                                        };
+                                    };
+                                    readonly required: readonly ["system", "kind", "count", "firstSeenAt", "lastSeenAt"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly 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.";
+                            };
                             readonly relationshipRole: {
                                 readonly anyOf: readonly [{
                                     readonly type: "string";
@@ -11711,6 +11803,146 @@ declare const apiKeyValidationFailureSchema: {
     readonly required: readonly ["valid", "error"];
     readonly additionalProperties: false;
 };
+declare const apiKeyContractHeader: "Outlit-Api-Key-Contract";
+declare const apiKeyValidationSuccessSchemaV2: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly type: "object";
+    readonly properties: {
+        readonly valid: {
+            readonly type: "boolean";
+            readonly const: true;
+        };
+        readonly organizationId: {
+            readonly type: "string";
+        };
+        readonly createdById: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly organization: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly slug: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+            readonly required: readonly ["id", "name", "slug"];
+            readonly additionalProperties: false;
+        };
+        readonly createdBy: {
+            readonly anyOf: readonly [{
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly email: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                };
+                readonly required: readonly ["id", "email", "name"];
+                readonly additionalProperties: false;
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly apiKey: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly prefix: {
+                    readonly type: "string";
+                };
+                readonly keyType: {
+                    readonly type: "string";
+                    readonly enum: readonly ["api", "cli", "mcp", "ci"];
+                };
+                readonly grants: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["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"];
+                    };
+                };
+                readonly createdAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly 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))$";
+                };
+                readonly lastUsedAt: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly 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))$";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly totalRequests: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 9007199254740991;
+                };
+                readonly expiresAt: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly 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))$";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+            readonly required: readonly ["id", "name", "prefix", "keyType", "grants", "createdAt", "lastUsedAt", "totalRequests", "expiresAt"];
+            readonly additionalProperties: false;
+        };
+        readonly authorization: {
+            readonly type: "object";
+            readonly properties: {
+                readonly grants: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["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"];
+                    };
+                };
+            };
+            readonly required: readonly ["grants"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["valid", "organizationId", "createdById", "authorization"];
+    readonly additionalProperties: false;
+};
 declare const toolGatewayErrorCodes: readonly ["INVALID_JSON", "INVALID_TOOL_CALL", "INVALID_TOOL_INPUT", "INVALID_CREDENTIALS", "TOOL_CALL_FORBIDDEN", "TOOL_BINDING_MISSING", "TOOL_IMPLEMENTATION_ERROR", "TOOL_OUTPUT_INVALID", "TOOL_RESOURCE_NOT_FOUND", "TOOL_RESULT_TOO_LARGE", "TOOL_GATEWAY_ERROR", "plan_api_limit_exceeded", "plan_billing_action_required"];
 declare const toolGatewayErrorSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
@@ -12479,7 +12711,7 @@ declare const userJourneyStages: readonly ["DISCOVERED", "SIGNED_UP", "ACTIVATED
 declare const userListOrderFields: readonly ["last_activity_at", "first_seen_at", "email"];
 declare const workspaceUserListOrderFields: readonly ["name", "email", "owned_customer_count"];
 declare const schemaTables: readonly ["activity", "customers", "users", "revenue"];
-declare const sdkConsumerContractHash: "4487d082473e65e51514b2a491210e1aab16dc7b0045412e4c11e6d89bc4ab5a";
+declare const sdkConsumerContractHash: "2fa67b23109e55e6b48d9899d1cfd176784feadf1d052a30a218cb69a3b59cbb";
 
 type JsonSchema = Readonly<Record<string, unknown>>;
 type PublicToolName = (typeof publicToolNames)[number];
@@ -12553,6 +12785,8 @@ type JsonSchemaValue<TSchema> = TSchema extends {
 } ? null : unknown;
 type PublicToolResult<TToolName extends PublicToolName> = JsonSchemaValue<(typeof publicToolContracts)[TToolName]["outputSchema"]>;
 type ApiKeyValidationSuccess = JsonSchemaValue<typeof apiKeyValidationSuccessSchema>;
+/** v2 adds `apiKey.expiresAt`; returned only to requests that send `apiKeyContractHeader: 2`. */
+type ApiKeyValidationSuccessV2 = JsonSchemaValue<typeof apiKeyValidationSuccessSchemaV2>;
 type ApiKeyValidationFailure = JsonSchemaValue<typeof apiKeyValidationFailureSchema>;
 type CustomerListResult = PublicToolResult<"outlit_list_customers">;
 type CustomerListItem = CustomerListResult["items"][number];
@@ -12639,4 +12873,4 @@ type CliToolName = (typeof cliToolNames)[number];
 type PiToolName = (typeof piToolNames)[number];
 declare const sqlToolNames: ("outlit_list_customers" | "outlit_list_users" | "outlit_get_customer" | "outlit_get_timeline" | "outlit_list_facts" | "outlit_get_fact" | "outlit_get_source" | "outlit_list_sources" | "outlit_search_customer_context" | "outlit_query" | "outlit_schema")[];
 
-export { type ApiKeyValidationFailure, type ApiKeyValidationSuccess, type AttentionItem, type AttentionItemResult, type AttentionItemSummary, type AttentionListResult, type CliToolName, type CustomerAnalyticsRow, type CustomerContextSearchInput, type CustomerCredit, type CustomerCreditsResult, type CustomerDetail, type CustomerDetailResult, type CustomerFeature, type CustomerFeaturesResult, type CustomerListItem, type CustomerListResult, type CustomerRelationship, type CustomerRelationshipResult, type CustomerSourceType, type CustomerSourceTypeInput, DEFAULT_OUTLIT_API_URL, type Feature, type FeatureArchiveResult, type FeatureCreateResult, type FeatureDefinition, type FeatureListResult, type FeatureRef, type FeedbackSubmitResult, type JsonSchema, type JsonSchemaValue, OutlitToolsApiError, type OutlitToolsClient, type OutlitToolsClientOptions, type OutlitToolsFetch, type PiToolName, type PublicToolContract, type PublicToolName, type PublicToolResult, type RuntimeJsonSchema, type SearchArgsLike, type ToolGatewayErrorCode, type ToolGatewayErrorEnvelope, allPublicToolNames, analyticalToolNames, apiKeyGrants, apiKeyValidationFailureSchema, apiKeyValidationSuccessSchema, apiKeyValidationTransport, cliToolNames, consumerToolPolicies, contractVersion, createOutlitClient, customerActivityWindows, customerBillingStatuses, customerFactCategories, customerFactIncludes, customerFactStatuses, customerFactTypes, customerIncludeSections, customerListOrderFields, customerSourceTypeAliasMap, customerSourceTypeAliases, customerSourceTypeInputs, customerSourceTypes, customerTimeframes, defaultToolNames, getPublicToolContract, ingestTransport, isOutlitToolsApiError, isPublicToolName, matchesGeneratedJsonSchema, normalizeCustomerSourceType, piToolNames, publicOpenApiTransports, publicToolContracts, publicToolNames, resolveCustomerContextSearchInput, schemaTables, sdkConsumerContractHash, sqlToolNames, timelineChannels, timelineTimeframes, toolGatewayErrorCodes, toolGatewayErrorSchema, toolGatewayTransport, unsupportedCustomerFactTypes, userJourneyStages, userListOrderFields, workspaceUserListOrderFields };
+export { type ApiKeyValidationFailure, type ApiKeyValidationSuccess, type ApiKeyValidationSuccessV2, type AttentionItem, type AttentionItemResult, type AttentionItemSummary, type AttentionListResult, type CliToolName, type CustomerAnalyticsRow, type CustomerContextSearchInput, type CustomerCredit, type CustomerCreditsResult, type CustomerDetail, type CustomerDetailResult, type CustomerFeature, type CustomerFeaturesResult, type CustomerListItem, type CustomerListResult, type CustomerRelationship, type CustomerRelationshipResult, type CustomerSourceType, type CustomerSourceTypeInput, DEFAULT_OUTLIT_API_URL, type Feature, type FeatureArchiveResult, type FeatureCreateResult, type FeatureDefinition, type FeatureListResult, type FeatureRef, type FeedbackSubmitResult, type JsonSchema, type JsonSchemaValue, OutlitToolsApiError, type OutlitToolsClient, type OutlitToolsClientOptions, type OutlitToolsFetch, type PiToolName, type PublicToolContract, type PublicToolName, type PublicToolResult, type RuntimeJsonSchema, type SearchArgsLike, type ToolGatewayErrorCode, type ToolGatewayErrorEnvelope, allPublicToolNames, analyticalToolNames, apiKeyContractHeader, apiKeyGrants, apiKeyValidationFailureSchema, apiKeyValidationSuccessSchema, apiKeyValidationSuccessSchemaV2, apiKeyValidationTransport, cliToolNames, consumerToolPolicies, contractVersion, createOutlitClient, customerActivityWindows, customerBillingStatuses, customerFactCategories, customerFactIncludes, customerFactStatuses, customerFactTypes, customerIncludeSections, customerListOrderFields, customerSourceTypeAliasMap, customerSourceTypeAliases, customerSourceTypeInputs, customerSourceTypes, customerTimeframes, defaultToolNames, getPublicToolContract, ingestTransport, isOutlitToolsApiError, isPublicToolName, matchesGeneratedJsonSchema, normalizeCustomerSourceType, piToolNames, publicOpenApiTransports, publicToolContracts, publicToolNames, resolveCustomerContextSearchInput, schemaTables, sdkConsumerContractHash, sqlToolNames, timelineChannels, timelineTimeframes, toolGatewayErrorCodes, toolGatewayErrorSchema, toolGatewayTransport, unsupportedCustomerFactTypes, userJourneyStages, userListOrderFields, workspaceUserListOrderFields };

package/dist/index.d.ts

@@ -244,7 +244,7 @@ declare const publicToolContracts: {
         readonly commandVersion: 1;
         readonly ownerDomain: "users";
         readonly title: "List Users";
-        readonly 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.";
+        readonly 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.";
         readonly annotations: {
             readonly readOnlyHint: true;
             readonly destructiveHint: false;
@@ -384,6 +384,52 @@ declare const publicToolContracts: {
                                     readonly type: "null";
                                 }];
                             };
+                            readonly sources: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly system: {
+                                            readonly type: "string";
+                                            readonly 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).";
+                                        };
+                                        readonly kind: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["contact", "product_user", "chat_member", "billing_customer", "call", "meeting", "email", "support_ticket", "slack_thread"];
+                                            readonly 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.";
+                                        };
+                                        readonly count: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "integer";
+                                                readonly minimum: 1;
+                                                readonly maximum: 9007199254740991;
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "How many conversations of this kind; null for records.";
+                                        };
+                                        readonly firstSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "When the record was created in the system (or first linked to this person), or the first conversation.";
+                                        };
+                                        readonly lastSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "The latest conversation; null for records.";
+                                        };
+                                    };
+                                    readonly required: readonly ["system", "kind", "count", "firstSeenAt", "lastSeenAt"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly 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.";
+                            };
                             readonly relationshipRole: {
                                 readonly anyOf: readonly [{
                                     readonly type: "string";
@@ -600,7 +646,7 @@ declare const publicToolContracts: {
         readonly commandVersion: 1;
         readonly ownerDomain: "customers";
         readonly title: "Get Customer";
-        readonly 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.";
+        readonly 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.";
         readonly annotations: {
             readonly readOnlyHint: true;
             readonly destructiveHint: false;
@@ -738,6 +784,52 @@ declare const publicToolContracts: {
                                     readonly type: "null";
                                 }];
                             };
+                            readonly sources: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly system: {
+                                            readonly type: "string";
+                                            readonly 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).";
+                                        };
+                                        readonly kind: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["contact", "product_user", "chat_member", "billing_customer", "call", "meeting", "email", "support_ticket", "slack_thread"];
+                                            readonly 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.";
+                                        };
+                                        readonly count: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "integer";
+                                                readonly minimum: 1;
+                                                readonly maximum: 9007199254740991;
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "How many conversations of this kind; null for records.";
+                                        };
+                                        readonly firstSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "When the record was created in the system (or first linked to this person), or the first conversation.";
+                                        };
+                                        readonly lastSeenAt: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                            readonly description: "The latest conversation; null for records.";
+                                        };
+                                    };
+                                    readonly required: readonly ["system", "kind", "count", "firstSeenAt", "lastSeenAt"];
+                                    readonly additionalProperties: false;
+                                };
+                                readonly 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.";
+                            };
                             readonly relationshipRole: {
                                 readonly anyOf: readonly [{
                                     readonly type: "string";
@@ -11711,6 +11803,146 @@ declare const apiKeyValidationFailureSchema: {
     readonly required: readonly ["valid", "error"];
     readonly additionalProperties: false;
 };
+declare const apiKeyContractHeader: "Outlit-Api-Key-Contract";
+declare const apiKeyValidationSuccessSchemaV2: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly type: "object";
+    readonly properties: {
+        readonly valid: {
+            readonly type: "boolean";
+            readonly const: true;
+        };
+        readonly organizationId: {
+            readonly type: "string";
+        };
+        readonly createdById: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly organization: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly slug: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+            readonly required: readonly ["id", "name", "slug"];
+            readonly additionalProperties: false;
+        };
+        readonly createdBy: {
+            readonly anyOf: readonly [{
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly email: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                };
+                readonly required: readonly ["id", "email", "name"];
+                readonly additionalProperties: false;
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly apiKey: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly prefix: {
+                    readonly type: "string";
+                };
+                readonly keyType: {
+                    readonly type: "string";
+                    readonly enum: readonly ["api", "cli", "mcp", "ci"];
+                };
+                readonly grants: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["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"];
+                    };
+                };
+                readonly createdAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly 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))$";
+                };
+                readonly lastUsedAt: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly 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))$";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly totalRequests: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 9007199254740991;
+                };
+                readonly expiresAt: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly 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))$";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+            readonly required: readonly ["id", "name", "prefix", "keyType", "grants", "createdAt", "lastUsedAt", "totalRequests", "expiresAt"];
+            readonly additionalProperties: false;
+        };
+        readonly authorization: {
+            readonly type: "object";
+            readonly properties: {
+                readonly grants: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["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"];
+                    };
+                };
+            };
+            readonly required: readonly ["grants"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["valid", "organizationId", "createdById", "authorization"];
+    readonly additionalProperties: false;
+};
 declare const toolGatewayErrorCodes: readonly ["INVALID_JSON", "INVALID_TOOL_CALL", "INVALID_TOOL_INPUT", "INVALID_CREDENTIALS", "TOOL_CALL_FORBIDDEN", "TOOL_BINDING_MISSING", "TOOL_IMPLEMENTATION_ERROR", "TOOL_OUTPUT_INVALID", "TOOL_RESOURCE_NOT_FOUND", "TOOL_RESULT_TOO_LARGE", "TOOL_GATEWAY_ERROR", "plan_api_limit_exceeded", "plan_billing_action_required"];
 declare const toolGatewayErrorSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
@@ -12479,7 +12711,7 @@ declare const userJourneyStages: readonly ["DISCOVERED", "SIGNED_UP", "ACTIVATED
 declare const userListOrderFields: readonly ["last_activity_at", "first_seen_at", "email"];
 declare const workspaceUserListOrderFields: readonly ["name", "email", "owned_customer_count"];
 declare const schemaTables: readonly ["activity", "customers", "users", "revenue"];
-declare const sdkConsumerContractHash: "4487d082473e65e51514b2a491210e1aab16dc7b0045412e4c11e6d89bc4ab5a";
+declare const sdkConsumerContractHash: "2fa67b23109e55e6b48d9899d1cfd176784feadf1d052a30a218cb69a3b59cbb";
 
 type JsonSchema = Readonly<Record<string, unknown>>;
 type PublicToolName = (typeof publicToolNames)[number];
@@ -12553,6 +12785,8 @@ type JsonSchemaValue<TSchema> = TSchema extends {
 } ? null : unknown;
 type PublicToolResult<TToolName extends PublicToolName> = JsonSchemaValue<(typeof publicToolContracts)[TToolName]["outputSchema"]>;
 type ApiKeyValidationSuccess = JsonSchemaValue<typeof apiKeyValidationSuccessSchema>;
+/** v2 adds `apiKey.expiresAt`; returned only to requests that send `apiKeyContractHeader: 2`. */
+type ApiKeyValidationSuccessV2 = JsonSchemaValue<typeof apiKeyValidationSuccessSchemaV2>;
 type ApiKeyValidationFailure = JsonSchemaValue<typeof apiKeyValidationFailureSchema>;
 type CustomerListResult = PublicToolResult<"outlit_list_customers">;
 type CustomerListItem = CustomerListResult["items"][number];
@@ -12639,4 +12873,4 @@ type CliToolName = (typeof cliToolNames)[number];
 type PiToolName = (typeof piToolNames)[number];
 declare const sqlToolNames: ("outlit_list_customers" | "outlit_list_users" | "outlit_get_customer" | "outlit_get_timeline" | "outlit_list_facts" | "outlit_get_fact" | "outlit_get_source" | "outlit_list_sources" | "outlit_search_customer_context" | "outlit_query" | "outlit_schema")[];
 
-export { type ApiKeyValidationFailure, type ApiKeyValidationSuccess, type AttentionItem, type AttentionItemResult, type AttentionItemSummary, type AttentionListResult, type CliToolName, type CustomerAnalyticsRow, type CustomerContextSearchInput, type CustomerCredit, type CustomerCreditsResult, type CustomerDetail, type CustomerDetailResult, type CustomerFeature, type CustomerFeaturesResult, type CustomerListItem, type CustomerListResult, type CustomerRelationship, type CustomerRelationshipResult, type CustomerSourceType, type CustomerSourceTypeInput, DEFAULT_OUTLIT_API_URL, type Feature, type FeatureArchiveResult, type FeatureCreateResult, type FeatureDefinition, type FeatureListResult, type FeatureRef, type FeedbackSubmitResult, type JsonSchema, type JsonSchemaValue, OutlitToolsApiError, type OutlitToolsClient, type OutlitToolsClientOptions, type OutlitToolsFetch, type PiToolName, type PublicToolContract, type PublicToolName, type PublicToolResult, type RuntimeJsonSchema, type SearchArgsLike, type ToolGatewayErrorCode, type ToolGatewayErrorEnvelope, allPublicToolNames, analyticalToolNames, apiKeyGrants, apiKeyValidationFailureSchema, apiKeyValidationSuccessSchema, apiKeyValidationTransport, cliToolNames, consumerToolPolicies, contractVersion, createOutlitClient, customerActivityWindows, customerBillingStatuses, customerFactCategories, customerFactIncludes, customerFactStatuses, customerFactTypes, customerIncludeSections, customerListOrderFields, customerSourceTypeAliasMap, customerSourceTypeAliases, customerSourceTypeInputs, customerSourceTypes, customerTimeframes, defaultToolNames, getPublicToolContract, ingestTransport, isOutlitToolsApiError, isPublicToolName, matchesGeneratedJsonSchema, normalizeCustomerSourceType, piToolNames, publicOpenApiTransports, publicToolContracts, publicToolNames, resolveCustomerContextSearchInput, schemaTables, sdkConsumerContractHash, sqlToolNames, timelineChannels, timelineTimeframes, toolGatewayErrorCodes, toolGatewayErrorSchema, toolGatewayTransport, unsupportedCustomerFactTypes, userJourneyStages, userListOrderFields, workspaceUserListOrderFields };
+export { type ApiKeyValidationFailure, type ApiKeyValidationSuccess, type ApiKeyValidationSuccessV2, type AttentionItem, type AttentionItemResult, type AttentionItemSummary, type AttentionListResult, type CliToolName, type CustomerAnalyticsRow, type CustomerContextSearchInput, type CustomerCredit, type CustomerCreditsResult, type CustomerDetail, type CustomerDetailResult, type CustomerFeature, type CustomerFeaturesResult, type CustomerListItem, type CustomerListResult, type CustomerRelationship, type CustomerRelationshipResult, type CustomerSourceType, type CustomerSourceTypeInput, DEFAULT_OUTLIT_API_URL, type Feature, type FeatureArchiveResult, type FeatureCreateResult, type FeatureDefinition, type FeatureListResult, type FeatureRef, type FeedbackSubmitResult, type JsonSchema, type JsonSchemaValue, OutlitToolsApiError, type OutlitToolsClient, type OutlitToolsClientOptions, type OutlitToolsFetch, type PiToolName, type PublicToolContract, type PublicToolName, type PublicToolResult, type RuntimeJsonSchema, type SearchArgsLike, type ToolGatewayErrorCode, type ToolGatewayErrorEnvelope, allPublicToolNames, analyticalToolNames, apiKeyContractHeader, apiKeyGrants, apiKeyValidationFailureSchema, apiKeyValidationSuccessSchema, apiKeyValidationSuccessSchemaV2, apiKeyValidationTransport, cliToolNames, consumerToolPolicies, contractVersion, createOutlitClient, customerActivityWindows, customerBillingStatuses, customerFactCategories, customerFactIncludes, customerFactStatuses, customerFactTypes, customerIncludeSections, customerListOrderFields, customerSourceTypeAliasMap, customerSourceTypeAliases, customerSourceTypeInputs, customerSourceTypes, customerTimeframes, defaultToolNames, getPublicToolContract, ingestTransport, isOutlitToolsApiError, isPublicToolName, matchesGeneratedJsonSchema, normalizeCustomerSourceType, piToolNames, publicOpenApiTransports, publicToolContracts, publicToolNames, resolveCustomerContextSearchInput, schemaTables, sdkConsumerContractHash, sqlToolNames, timelineChannels, timelineTimeframes, toolGatewayErrorCodes, toolGatewayErrorSchema, toolGatewayTransport, unsupportedCustomerFactTypes, userJourneyStages, userListOrderFields, workspaceUserListOrderFields };