@sortlist/cli 0.26.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sortlist/cli",
3
- "version": "0.26.0",
3
+ "version": "0.27.0",
4
4
  "description": "Sortlist platform CLI — GraphQL federation client and Clara AI chat",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -16,7 +16,7 @@
16
16
  ".published"
17
17
  ],
18
18
  "scripts": {
19
- "codegen": "graphql-codegen --config codegen.ts",
19
+ "codegen": "graphql-codegen --config src/codegen.ts",
20
20
  "generate": "npm run codegen",
21
21
  "type-check": "tsc --noEmit",
22
22
  "lint": "eslint . --ext .ts,.tsx,.js,.cjs --quiet",
@@ -1,32 +1,30 @@
1
- import type { CodegenConfig } from "@graphql-codegen/cli";
2
- import fs from "fs";
1
+ import fs from 'fs';
2
+ import type { CodegenConfig } from '@graphql-codegen/cli';
3
3
 
4
4
  // Schema resolution: SUPERGRAPH_PATH env → ../backend/supergraph.graphql
5
5
  function resolveSchema(): string {
6
6
  if (process.env.SUPERGRAPH_PATH && fs.existsSync(process.env.SUPERGRAPH_PATH)) {
7
7
  return process.env.SUPERGRAPH_PATH;
8
8
  }
9
- const local = "../backend/supergraph.graphql";
9
+ const local = '../../backend/supergraph.graphql';
10
10
  if (fs.existsSync(local)) return local;
11
- throw new Error(
12
- "Supergraph not found. Set SUPERGRAPH_PATH or ensure ../backend/supergraph.graphql exists.",
13
- );
11
+ throw new Error('Supergraph not found. Set SUPERGRAPH_PATH or ensure ../backend/supergraph.graphql exists.');
14
12
  }
15
13
 
16
14
  const config: CodegenConfig = {
17
15
  overwrite: true,
18
16
  schema: resolveSchema(),
19
- documents: ["src/graphql/operations/*.ts"],
17
+ documents: ['src/graphql/operations/*.ts'],
20
18
  emitLegacyCommonJSImports: false,
21
19
  generates: {
22
- "src/graphql/generated/": {
23
- preset: "client",
20
+ 'src/graphql/generated/': {
21
+ preset: 'client',
24
22
  config: {
25
23
  useTypeImports: true,
26
24
  enumsAsTypes: true,
27
25
  },
28
26
  presetConfig: {
29
- gqlTagName: "gql",
27
+ gqlTagName: 'gql',
30
28
  fragmentMasking: false,
31
29
  },
32
30
  },
@@ -295,7 +295,7 @@ const SERVICE_DESCRIPTIONS: Record<string, string> = {
295
295
  atlas: 'Atlas service (contacts, orgs)',
296
296
  marketplace: 'Marketplace service',
297
297
  hermes: 'Hermes service',
298
- chat: 'Chat AI service (conversations)',
298
+ // chat: 'Chat AI service (conversations)',
299
299
  };
300
300
 
301
301
  function serviceDescription(service: string): string {
@@ -11,8 +11,11 @@ import { error, hint, info, success, warn } from '../lib/output.ts';
11
11
 
12
12
  // TODO: fetch the set of available API scopes dynamically (e.g. from Hermes'
13
13
  // resource server) once the backend exposes them. For now the CLI requests a
14
- // fixed superset so users can exercise every subgraph.
15
- const DEFAULT_SCOPE = 'openid profile email offline_access atlas:*/* core:*/* max/*:* billing/*:*';
14
+ // fixed superset so users can exercise every subgraph. Scope strings must match
15
+ // the Auth0 resource-server format `<service>/<resource>:<action>` exactly — RBAC
16
+ // silently drops any requested scope that isn't a defined permission, which is why
17
+ // the delimiters are `/` then `:` (e.g. `atlas/*:*`, not `atlas:*/*`).
18
+ const DEFAULT_SCOPE = 'openid profile email offline_access atlas/*:* core/*:* max/*:* signals/*:* billing/*:*';
16
19
 
17
20
  function sleep(ms: number): Promise<void> {
18
21
  return new Promise((resolve) => setTimeout(resolve, ms));
@@ -4,6 +4,7 @@ import { graphqlUnauthenticated } from '../graphql/client.ts';
4
4
  import { LogoutUrl } from '../graphql/operations/hermes.ts';
5
5
  import { clearCredentials } from '../lib/auth.ts';
6
6
  import { openBrowser } from '../lib/browser.ts';
7
+ import { clearIdentity } from '../lib/config.ts';
7
8
  import { hint, info, success, warn } from '../lib/output.ts';
8
9
 
9
10
  export const logoutCommand = new Command('logout')
@@ -22,6 +23,7 @@ export const logoutCommand = new Command('logout')
22
23
  const opts = this.optsWithGlobals();
23
24
 
24
25
  clearCredentials();
26
+ clearIdentity();
25
27
  success('Logged out — credentials removed.');
26
28
 
27
29
  if (!opts.browser) {
@@ -1196,17 +1196,24 @@ export type ConnectIntegrationPayload = Node & {
1196
1196
  /** A business contact associated with an organization. */
1197
1197
  export type Contact = Node & {
1198
1198
  __typename?: 'Contact';
1199
+ /**
1200
+ * Profile picture URL from an enrichment source such as CoreSignal. Null until a
1201
+ * source provides one or the contact has no public photo.
1202
+ */
1203
+ avatarUrl?: Maybe<Scalars['String']['output']>;
1199
1204
  /** City where the contact is located. */
1200
1205
  city?: Maybe<Scalars['String']['output']>;
1201
1206
  /** Confidence score (0.0-1.0) from source quality, freshness, and diversity. */
1202
1207
  confidenceScore?: Maybe<Scalars['Float']['output']>;
1203
1208
  /** ISO 3166-1 alpha-2 country code. */
1204
1209
  countryCode?: Maybe<Scalars['String']['output']>;
1210
+ /** When the contact record was first created. */
1205
1211
  createdAt: Scalars['ISO8601DateTime']['output'];
1206
1212
  /** Primary email address. */
1207
1213
  emailAddress?: Maybe<Scalars['String']['output']>;
1208
1214
  /** Extracted email pattern (e.g. {first}.{last}). */
1209
1215
  emailPattern?: Maybe<Scalars['String']['output']>;
1216
+ /** Verification status of the primary email address. */
1210
1217
  emailStatus?: Maybe<EmailStatus>;
1211
1218
  /** First name. */
1212
1219
  firstName?: Maybe<Scalars['String']['output']>;
@@ -1224,6 +1231,7 @@ export type Contact = Node & {
1224
1231
  linkedinUrl?: Maybe<Scalars['String']['output']>;
1225
1232
  /** The organization this contact belongs to. */
1226
1233
  organization: Organization;
1234
+ /** When the contact record was last modified. */
1227
1235
  updatedAt: Scalars['ISO8601DateTime']['output'];
1228
1236
  };
1229
1237
 
@@ -1260,8 +1268,11 @@ export type ContactEnrichmentResultPayload = {
1260
1268
 
1261
1269
  /** Filter criteria for contacts. */
1262
1270
  export type ContactFilterInput = {
1271
+ /** Filter by confidence score (0.0–1.0). */
1263
1272
  confidenceScore?: InputMaybe<FloatFilterInput>;
1273
+ /** Filter by ISO 3166-1 alpha-2 country code. */
1264
1274
  countryCode?: InputMaybe<StringFilterInput>;
1275
+ /** Filter by email verification status (VALID, INVALID, CATCH_ALL, UNKNOWN). */
1265
1276
  emailStatus?: InputMaybe<EmailStatusFilterInput>;
1266
1277
  /** Filter by contact global id. */
1267
1278
  id?: InputMaybe<IdFilterInput>;
@@ -1289,7 +1300,9 @@ export type ContactIdentifyResultPayload = {
1289
1300
 
1290
1301
  /** Fields available for sorting contacts. */
1291
1302
  export type ContactSortField =
1303
+ /** Sort by merged confidence score, highest first by default. */
1292
1304
  | 'CONFIDENCE_SCORE'
1305
+ /** Sort by creation timestamp. */
1293
1306
  | 'CREATED_AT'
1294
1307
  /** Cosine distance from the linked organization's description embedding. Requires a query argument. */
1295
1308
  | 'DESCRIPTION_DISTANCE'
@@ -1309,8 +1322,11 @@ export type ContactSortInput = {
1309
1322
  query?: InputMaybe<Scalars['String']['input']>;
1310
1323
  };
1311
1324
 
1325
+ /** Contact field values to cross-check against Atlas's stored data. */
1312
1326
  export type ContactValidationChecksInput = {
1327
+ /** Email address to include in contact coherence checks. */
1313
1328
  email?: InputMaybe<Scalars['String']['input']>;
1329
+ /** Phone number to include in contact coherence checks. */
1314
1330
  phone?: InputMaybe<Scalars['String']['input']>;
1315
1331
  };
1316
1332
 
@@ -1830,13 +1846,41 @@ export type CreateSalesOfferPayload = Node & {
1830
1846
  export type CreateSourceInput = {
1831
1847
  /** A unique identifier for the client performing the mutation. */
1832
1848
  clientMutationId?: InputMaybe<Scalars['String']['input']>;
1849
+ /**
1850
+ * Maps Atlas canonical contact field names to rawData extraction expressions.
1851
+ * Keys: first_name, last_name, email_address, job_title, job_level, job_function,
1852
+ * linkedin_url, city, country_code.
1853
+ * Values: a string key ("firstname"), an array path for nested access
1854
+ * (["data", "email"]), or an operation hash
1855
+ * ({"op": "split", "key": "full_name", "index": 0}).
1856
+ * All referenced keys must exist in contact_schema.
1857
+ */
1833
1858
  contactFieldMappings?: InputMaybe<Scalars['JSON']['input']>;
1859
+ /** JSON Schema (draft-07) describing the expected shape of contact rawData payloads. */
1834
1860
  contactSchema?: InputMaybe<Scalars['JSON']['input']>;
1861
+ /**
1862
+ * Maps Atlas canonical identification field names to rawData extraction expressions.
1863
+ * Keys: ip_address, organization_domain, confidence_score.
1864
+ * Values follow the same expression syntax as contact_field_mappings.
1865
+ * All referenced keys must exist in identification_schema.
1866
+ */
1835
1867
  identificationFieldMappings?: InputMaybe<Scalars['JSON']['input']>;
1868
+ /** JSON Schema (draft-07) describing the expected shape of identification rawData payloads. */
1836
1869
  identificationSchema?: InputMaybe<Scalars['JSON']['input']>;
1870
+ /**
1871
+ * Maps Atlas canonical organization field names to rawData extraction expressions.
1872
+ * Keys: name, website, phone, contact_email, linkedin_url, description,
1873
+ * company_size, founded_year, industry, country_code, annual_revenue.
1874
+ * Values: a string key ("name"), an array path (["company", "name"]),
1875
+ * or an operation hash ({"op": "parse_employee_range", "path": ["size_range"]}).
1876
+ * All referenced keys must exist in organization_schema.
1877
+ */
1837
1878
  organizationFieldMappings?: InputMaybe<Scalars['JSON']['input']>;
1879
+ /** JSON Schema (draft-07) describing the expected shape of organization rawData payloads. */
1838
1880
  organizationSchema?: InputMaybe<Scalars['JSON']['input']>;
1881
+ /** Short machine-readable identifier for this source (e.g. snitcher, hunter). */
1839
1882
  slug: Scalars['String']['input'];
1883
+ /** Weight applied during multi-source merging, 0.0–1.0. Higher scores win field conflicts. */
1840
1884
  trustScore?: InputMaybe<Scalars['Float']['input']>;
1841
1885
  };
1842
1886
 
@@ -1844,8 +1888,12 @@ export type CreateSourceInput = {
1844
1888
  export type CreateWatcherInput = {
1845
1889
  /** A unique identifier for the client performing the mutation. */
1846
1890
  clientMutationId?: InputMaybe<Scalars['String']['input']>;
1847
- /** Identifier of the Company that will own the Watcher. */
1848
- companyId: Scalars['ID']['input'];
1891
+ /**
1892
+ * Optional identifier of the Company this Watcher relates to. Used for
1893
+ * company-scoped consumer access and activity attribution; omit it for callers
1894
+ * with no company context.
1895
+ */
1896
+ companyId?: InputMaybe<Scalars['ID']['input']>;
1849
1897
  /** Slug of the Definition to subscribe to. */
1850
1898
  definitionSlug: Scalars['String']['input'];
1851
1899
  /** Version of the Definition to subscribe to. */
@@ -2003,6 +2051,24 @@ export type DelayStepConfig = {
2003
2051
  minutesDelay?: Maybe<Scalars['Int']['output']>;
2004
2052
  };
2005
2053
 
2054
+ /** Autogenerated input type of DeleteBillingCustomer */
2055
+ export type DeleteBillingCustomerInput = {
2056
+ /** Billing customer UUID to delete. Max stores this on `companies.billing_customer_id`. */
2057
+ billingCustomerId: Scalars['ID']['input'];
2058
+ /** A unique identifier for the client performing the mutation. */
2059
+ clientMutationId?: InputMaybe<Scalars['String']['input']>;
2060
+ };
2061
+
2062
+ /** Autogenerated return type of DeleteBillingCustomer. */
2063
+ export type DeleteBillingCustomerPayload = Node & {
2064
+ __typename?: 'DeleteBillingCustomerPayload';
2065
+ /** A unique identifier for the client performing the mutation. */
2066
+ clientMutationId?: Maybe<Scalars['String']['output']>;
2067
+ /** True when the customer was deleted. */
2068
+ deleted: Scalars['Boolean']['output'];
2069
+ id: Scalars['ID']['output'];
2070
+ };
2071
+
2006
2072
  /** Autogenerated input type of DeleteOutboundCampaign */
2007
2073
  export type DeleteOutboundCampaignInput = {
2008
2074
  /** A unique identifier for the client performing the mutation. */
@@ -2680,6 +2746,7 @@ export type IdentificationEdge = Node & {
2680
2746
 
2681
2747
  /** Filter criteria for identifications. */
2682
2748
  export type IdentificationFilterInput = {
2749
+ /** Filter by confidence score (0.0–1.0). */
2683
2750
  confidenceScore?: InputMaybe<FloatFilterInput>;
2684
2751
  /** Return only matched identifications. */
2685
2752
  valid?: InputMaybe<Scalars['Boolean']['input']>;
@@ -2689,9 +2756,11 @@ export type IdentificationFilterInput = {
2689
2756
  export type IdentifyCompanyInput = {
2690
2757
  /** A unique identifier for the client performing the mutation. */
2691
2758
  clientMutationId?: InputMaybe<Scalars['String']['input']>;
2692
- /** Session visitor country code for contact boost */
2759
+ /** Visitor's ISO 3166-1 alpha-2 country code, used to boost matching accuracy. */
2693
2760
  countryCode?: InputMaybe<Scalars['String']['input']>;
2761
+ /** Caller-supplied correlation key; pass the same value to `companyIdentifyResult(externalId:)` to receive the result. */
2694
2762
  externalId: Scalars['String']['input'];
2763
+ /** The visitor's IPv4 or IPv6 address to identify. */
2695
2764
  ip: Scalars['String']['input'];
2696
2765
  /**
2697
2766
  * Optional URL to receive the result via webhook. Callers consuming results via
@@ -2767,12 +2836,18 @@ export type InitiateIntegrationOauthInput = {
2767
2836
  companyId: Scalars['ID']['input'];
2768
2837
  /** Slug of an OAuth-kind integration provider. */
2769
2838
  providerSlug: Scalars['String']['input'];
2839
+ /**
2840
+ * Relative app path (e.g. /acme/settings/integrations) the callback redirects
2841
+ * the browser back to once OAuth completes. Must be same-origin; ignored if it
2842
+ * is not a relative path.
2843
+ */
2844
+ returnPath?: InputMaybe<Scalars['String']['input']>;
2770
2845
  };
2771
2846
 
2772
2847
  /** Autogenerated return type of InitiateIntegrationOauth. */
2773
2848
  export type InitiateIntegrationOauthPayload = Node & {
2774
2849
  __typename?: 'InitiateIntegrationOauthPayload';
2775
- /** URL to open in a popup. Single-use; expires in 10 minutes. */
2850
+ /** URL to navigate the main window to. Single-use; expires in 10 minutes. */
2776
2851
  authorizeUrl: Scalars['String']['output'];
2777
2852
  /** A unique identifier for the client performing the mutation. */
2778
2853
  clientMutationId?: Maybe<Scalars['String']['output']>;
@@ -3578,8 +3653,8 @@ export type Mutation = {
3578
3653
  /** Create a new enrichment source. */
3579
3654
  createSource?: Maybe<Source>;
3580
3655
  /**
3581
- * Create a Watcher on a Company for a given Definition. All providers registered
3582
- * on the Definition are auto-provisioned atomically; the user does not choose providers.
3656
+ * Create a Watcher for a given Definition. All providers registered on the
3657
+ * Definition are auto-provisioned atomically; the user does not choose providers.
3583
3658
  */
3584
3659
  createWatcher?: Maybe<CreateWatcherPayload>;
3585
3660
  /**
@@ -3588,6 +3663,12 @@ export type Mutation = {
3588
3663
  * GraphQL error if the billingCustomerId is unknown.
3589
3664
  */
3590
3665
  debitCredits?: Maybe<DebitCreditsPayload>;
3666
+ /**
3667
+ * Hard-deletes a billing customer and its Stripe customer. Used to compensate a
3668
+ * failed sales-offer creation. Refuses a customer that has subscriptions,
3669
+ * invoices, credits, or debits.
3670
+ */
3671
+ deleteBillingCustomer?: Maybe<DeleteBillingCustomerPayload>;
3591
3672
  /**
3592
3673
  * Soft-delete a campaign. Pauses it if running and disenrolls all of its
3593
3674
  * enrollments asynchronously. Returns the soft-deleted campaign.
@@ -3613,19 +3694,41 @@ export type Mutation = {
3613
3694
  disconnectIntegration?: Maybe<DisconnectIntegrationPayload>;
3614
3695
  /** Disenroll a lead from a campaign. The enrollment is soft-deleted (disenrolledAt is set); it is not destroyed. */
3615
3696
  disenrollLeadFromOutboundCampaign?: Maybe<DisenrollLeadFromOutboundCampaignPayload>;
3616
- /** Create or update a contact for an organization. */
3697
+ /**
3698
+ * Synchronously merge a raw source payload into the contact record, applying the source's
3699
+ * trust score to resolve field conflicts, then recompute the confidence score.
3700
+ * Returns the merged Contact immediately.
3701
+ * Use when pushing enrichment data from a registered source.
3702
+ * To discover a contact from a known identifier (email, LinkedIn, name) without raw
3703
+ * source data, use `identifyContact` instead.
3704
+ */
3617
3705
  enrichContact?: Maybe<Contact>;
3618
- /** Create or update an IP-to-company identification. */
3706
+ /**
3707
+ * Synchronously store or update an IP-to-company identification record from a source payload.
3708
+ * Returns the merged Identification immediately.
3709
+ * Use when a source (e.g. Snitcher) has already resolved an IP to a company domain
3710
+ * and you want to persist that result. To trigger async resolution from an IP address,
3711
+ * use `identifyCompany` instead.
3712
+ */
3619
3713
  enrichIdentification?: Maybe<Identification>;
3620
- /** Create or update a company record from enrichment data. */
3714
+ /**
3715
+ * Synchronously merge a raw source payload into the organization record, applying the
3716
+ * source's trust score to resolve field conflicts, then recompute the confidence score.
3717
+ * Returns the merged Organization immediately.
3718
+ * Use when pushing enrichment data from a registered source.
3719
+ * To look up an existing organization without writing data, use `organization(domain:)` instead.
3720
+ */
3621
3721
  enrichOrganization?: Maybe<Organization>;
3622
3722
  /** Enroll a lead into a campaign. Optionally specify a starting step and schedule. */
3623
3723
  enrollLeadToOutboundCampaign?: Maybe<EnrollLeadToOutboundCampaignPayload>;
3624
3724
  /** Ensures the company has a billing-subgraph customer. Idempotent — returns the company with billingCustomerId populated. */
3625
3725
  ensureBillingCustomer?: Maybe<EnsureBillingCustomerPayload>;
3626
3726
  /**
3627
- * Asynchronously find a contact's email via Atlas's enrichment strategies.
3628
- * Subscribe to findContactEmailResult(externalId:) for the result.
3727
+ * Asynchronously attempt to discover a contact's email address using Atlas enrichment strategies.
3728
+ * Returns `{status: "received"}` immediately. The result (contact with email, or null if not found)
3729
+ * arrives via the `findContactEmailResult(externalId:)` subscription.
3730
+ * Use when you already have an Atlas Contact ID and need their email discovered.
3731
+ * If you don't yet have a Contact ID, use `identifyContact` to find or create the contact first.
3629
3732
  */
3630
3733
  findContactEmail?: Maybe<FindContactEmailPayload>;
3631
3734
  /**
@@ -3637,19 +3740,30 @@ export type Mutation = {
3637
3740
  * already-generated preview.
3638
3741
  */
3639
3742
  generateOutboundCampaignMessagePreview?: Maybe<GenerateOutboundCampaignMessagePreviewPayload>;
3640
- /** Asynchronously identify a company from an IP address. */
3743
+ /**
3744
+ * Asynchronously identify a company from a visitor IP address.
3745
+ * Returns `{status: "received"}` immediately. The matched Organization arrives via
3746
+ * the `companyIdentifyResult(externalId:)` subscription or the optional webhook.
3747
+ * Use when you have a visitor IP and need to resolve the company behind it.
3748
+ * To look up a company by domain directly, use `organization(domain:)` instead.
3749
+ */
3641
3750
  identifyCompany?: Maybe<IdentifyCompanyPayload>;
3642
3751
  /**
3643
- * Asynchronously identify a Contact by any of the unique-key shapes
3644
- * (linkedinUrl, emailAddress, or firstName+lastName scoped to organizationId).
3752
+ * Asynchronously discover whether an Atlas Contact record exists for a person
3753
+ * identified by email, LinkedIn URL, or full name scoped to an organization.
3754
+ * Returns `{status: "received"}` immediately. The matched or created Contact
3755
+ * arrives via the `contactIdentifyResult(externalId:)` subscription.
3756
+ * Use when you need to find a contact from a known identifier.
3757
+ * If you already have a Contact ID and only need their email address discovered,
3758
+ * use `findContactEmail` instead.
3645
3759
  */
3646
3760
  identifyContact?: Maybe<IdentifyContactPayload>;
3647
3761
  /** Generate a delegation JWT to impersonate a user via Auth0 Custom Token Exchange. Requires admin scope (max/*:*). */
3648
3762
  impersonateUser?: Maybe<ImpersonateUserPayload>;
3649
3763
  /**
3650
- * Returns a one-shot authorize URL the client opens in a popup to begin the
3651
- * OAuth dance for an integration provider. The URL embeds a signed state token
3652
- * the callback validates before persisting the connection.
3764
+ * Returns a one-shot authorize URL the client navigates the main window to in
3765
+ * order to begin the OAuth dance for an integration provider. The URL embeds a
3766
+ * signed state token the callback validates before persisting the connection.
3653
3767
  */
3654
3768
  initiateIntegrationOauth?: Maybe<InitiateIntegrationOauthPayload>;
3655
3769
  /**
@@ -3740,6 +3854,13 @@ export type Mutation = {
3740
3854
  runSignalsSynchronousWorker?: Maybe<RunSignalsSynchronousWorkerPayload>;
3741
3855
  /** Run a background job inline. Admin-only, intended for E2E test orchestration. */
3742
3856
  runSynchronousWorker?: Maybe<RunSynchronousWorkerPayload>;
3857
+ /**
3858
+ * Asynchronously search for an organization by domain.
3859
+ * Returns {status: "received"} immediately. The enriched Organization arrives via
3860
+ * the `organizationSearchResult(externalId:)` subscription once Atlas has looked up
3861
+ * or fetched the company data.
3862
+ */
3863
+ searchOrganization?: Maybe<SearchOrganizationPayload>;
3743
3864
  /**
3744
3865
  * Send a user message to a conversation. Returns the persisted user message;
3745
3866
  * subscribe to `conversationEvent` to receive the streaming assistant reply.
@@ -3752,6 +3873,12 @@ export type Mutation = {
3752
3873
  * new enum value plus a mailer action.
3753
3874
  */
3754
3875
  sendTransactionalEmail?: Maybe<SendTransactionalEmailPayload>;
3876
+ /**
3877
+ * Activate or pause delivery for a single webhook on a Watcher, reconciling the
3878
+ * upstream source's emitting state. Does not deprovision — the subscription,
3879
+ * webhook, and config are preserved.
3880
+ */
3881
+ setWebhookActive?: Maybe<SetWebhookActivePayload>;
3755
3882
  /** Mark an optional membership onboarding task as skipped so it stops blocking the onboarding flow. */
3756
3883
  skipMembershipOnboardingTask?: Maybe<SkipMembershipOnboardingTaskPayload>;
3757
3884
  /**
@@ -3806,9 +3933,19 @@ export type Mutation = {
3806
3933
  updateSource?: Maybe<Source>;
3807
3934
  /** Update the calling user's preferred UI locale. */
3808
3935
  updateUserLocale?: Maybe<UpdateUserLocalePayload>;
3809
- /** Asynchronously validate a contact and check the coherence of provided person data. */
3936
+ /**
3937
+ * Asynchronously validate that the supplied name, email, and phone are internally consistent
3938
+ * for a contact at the given organization.
3939
+ * Returns `{status: "received"}` immediately. Per-field coherence flags arrive via
3940
+ * the `contactValidationResult(externalId:)` subscription.
3941
+ */
3810
3942
  validateContact?: Maybe<ValidateContactPayload>;
3811
- /** Asynchronously validate a domain and check coherence of provided company data. */
3943
+ /**
3944
+ * Asynchronously validate that the supplied company field values are coherent with
3945
+ * Atlas's stored data for the given domain.
3946
+ * Returns `{status: "received"}` immediately. Per-field coherence flags arrive via
3947
+ * the `domainValidationResult(externalId:)` subscription.
3948
+ */
3812
3949
  validateDomain?: Maybe<ValidateDomainPayload>;
3813
3950
  };
3814
3951
 
@@ -3963,6 +4100,11 @@ export type MutationDebitCreditsArgs = {
3963
4100
  };
3964
4101
 
3965
4102
 
4103
+ export type MutationDeleteBillingCustomerArgs = {
4104
+ input: DeleteBillingCustomerInput;
4105
+ };
4106
+
4107
+
3966
4108
  export type MutationDeleteOutboundCampaignArgs = {
3967
4109
  input: DeleteOutboundCampaignInput;
3968
4110
  };
@@ -4198,6 +4340,11 @@ export type MutationRunSynchronousWorkerArgs = {
4198
4340
  };
4199
4341
 
4200
4342
 
4343
+ export type MutationSearchOrganizationArgs = {
4344
+ input: SearchOrganizationInput;
4345
+ };
4346
+
4347
+
4201
4348
  export type MutationSendMessageArgs = {
4202
4349
  input: SendMessageInput;
4203
4350
  };
@@ -4208,6 +4355,11 @@ export type MutationSendTransactionalEmailArgs = {
4208
4355
  };
4209
4356
 
4210
4357
 
4358
+ export type MutationSetWebhookActiveArgs = {
4359
+ input: SetWebhookActiveInput;
4360
+ };
4361
+
4362
+
4211
4363
  export type MutationSkipMembershipOnboardingTaskArgs = {
4212
4364
  input: SkipMembershipOnboardingTaskInput;
4213
4365
  };
@@ -4377,6 +4529,7 @@ export type Organization = Node & {
4377
4529
  contacts: ContactConnection;
4378
4530
  /** ISO 3166-1 alpha-2 country code of the primary location. */
4379
4531
  countryCode?: Maybe<Scalars['String']['output']>;
4532
+ /** When the organization record was first created. */
4380
4533
  createdAt: Scalars['ISO8601DateTime']['output'];
4381
4534
  /** Short company description or tagline. */
4382
4535
  description?: Maybe<Scalars['String']['output']>;
@@ -4394,6 +4547,8 @@ export type Organization = Node & {
4394
4547
  linkedinClaimed?: Maybe<Scalars['Boolean']['output']>;
4395
4548
  /** LinkedIn company page URL. */
4396
4549
  linkedinUrl?: Maybe<Scalars['String']['output']>;
4550
+ /** URL to the organization's logo image. */
4551
+ logoUrl?: Maybe<Scalars['String']['output']>;
4397
4552
  /** Legal or trade name. */
4398
4553
  name?: Maybe<Scalars['String']['output']>;
4399
4554
  /**
@@ -4405,6 +4560,7 @@ export type Organization = Node & {
4405
4560
  organizationAddresses: OrganizationAddressConnection;
4406
4561
  /** Main phone number. */
4407
4562
  phone?: Maybe<Scalars['String']['output']>;
4563
+ /** When the organization record was last modified. */
4408
4564
  updatedAt: Scalars['ISO8601DateTime']['output'];
4409
4565
  /** Unique identifier (UUID) for this organization. */
4410
4566
  uuid: Scalars['String']['output'];
@@ -4509,7 +4665,16 @@ export type OrganizationEdge = Node & {
4509
4665
 
4510
4666
  /** Filter criteria for organizations. */
4511
4667
  export type OrganizationFilterInput = {
4668
+ /**
4669
+ * Filter on the organization's employee-count range. Use `overlaps` with a
4670
+ * [min, max] range (a one-element [min] array means open-ended) — e.g.
4671
+ * { overlaps: [0, 100] } for "fewer than 100 employees", { overlaps: [1000] }
4672
+ * for "1000+". Callers targeting several buckets pass a single merged range.
4673
+ */
4674
+ companySize?: InputMaybe<RangeFilterInput>;
4675
+ /** Filter by confidence score (0.0–1.0). */
4512
4676
  confidenceScore?: InputMaybe<FloatFilterInput>;
4677
+ /** Filter by ISO 3166-1 alpha-2 country code. */
4513
4678
  countryCode?: InputMaybe<StringFilterInput>;
4514
4679
  /**
4515
4680
  * Description embedding filters. Each entry matches organizations whose
@@ -4538,14 +4703,24 @@ export type OrganizationFilterInput = {
4538
4703
  valid?: InputMaybe<Scalars['Boolean']['input']>;
4539
4704
  };
4540
4705
 
4706
+ /** Autogenerated return type of OrganizationSearchResult. */
4707
+ export type OrganizationSearchResultPayload = {
4708
+ __typename?: 'OrganizationSearchResultPayload';
4709
+ externalId: Scalars['ID']['output'];
4710
+ organization?: Maybe<Organization>;
4711
+ };
4712
+
4541
4713
  /** Fields available for sorting organizations. */
4542
4714
  export type OrganizationSortField =
4715
+ /** Sort by merged confidence score, highest first by default. */
4543
4716
  | 'CONFIDENCE_SCORE'
4717
+ /** Sort by creation timestamp. */
4544
4718
  | 'CREATED_AT'
4545
4719
  /** Cosine distance from the description embedding. Requires query. */
4546
4720
  | 'DESCRIPTION_DISTANCE'
4547
4721
  /** Cosine distance from the industry embedding. Requires query. */
4548
4722
  | 'INDUSTRY_DISTANCE'
4723
+ /** Sort alphabetically by legal or trade name. */
4549
4724
  | 'NAME';
4550
4725
 
4551
4726
  /** Sort configuration for organizations. */
@@ -4559,10 +4734,16 @@ export type OrganizationSortInput = {
4559
4734
  /** Federation reference to an outreach-owned OutboundCampaign. */
4560
4735
  export type OutboundCampaign = Node & {
4561
4736
  __typename?: 'OutboundCampaign';
4737
+ /** Auto-send follow-up messages without manual review. */
4738
+ automaticallySendFollowUps: Scalars['Boolean']['output'];
4739
+ /** Auto-send first-touch messages without manual review. */
4740
+ automaticallySendMessages: Scalars['Boolean']['output'];
4562
4741
  /** When the campaign was created. */
4563
4742
  createdAt: Scalars['ISO8601DateTime']['output'];
4564
4743
  /** The user who created the campaign. */
4565
4744
  creator?: Maybe<User>;
4745
+ /** Latest minute of the day (0-1439) messages may be sent. */
4746
+ endSendingMinutes: Scalars['Int']['output'];
4566
4747
  /** GlobalID-encoded campaign id. */
4567
4748
  id: Scalars['ID']['output'];
4568
4749
  /** Name of the campaign. */
@@ -4573,10 +4754,16 @@ export type OutboundCampaign = Node & {
4573
4754
  report: OutboundCampaignReport;
4574
4755
  /** The user whose mailbox/identity sends this campaign. Null when unassigned. */
4575
4756
  sender?: Maybe<User>;
4757
+ /** Days of the week messages may be sent. */
4758
+ sendingDays: Array<WeekdayEnum>;
4759
+ /** Earliest minute of the day (0-1439) messages may be sent. */
4760
+ startSendingMinutes: Scalars['Int']['output'];
4576
4761
  /** Current status: on or off. */
4577
4762
  status: Scalars['String']['output'];
4578
4763
  /** All steps in the campaign sequence. Use parentStepId and position to reconstruct the tree. */
4579
4764
  steps: OutboundCampaignStepConnection;
4765
+ /** IANA timezone for the sending schedule. */
4766
+ timezone?: Maybe<Scalars['String']['output']>;
4580
4767
  /** When the campaign was last updated. */
4581
4768
  updatedAt: Scalars['ISO8601DateTime']['output'];
4582
4769
  /** Writing style settings applied when generating messages for this campaign. */
@@ -5250,11 +5437,6 @@ export type PurchaseCreditsPayload = Node & {
5250
5437
 
5251
5438
  export type Query = {
5252
5439
  __typename?: 'Query';
5253
- /**
5254
- * Action definitions a company can bind to routines.
5255
- * @deprecated use company { availableActions { ... } } instead
5256
- */
5257
- availableActions: ActionConnection;
5258
5440
  /**
5259
5441
  * Looks up a billing customer by id, e.g. for a consumer's credit pre-check.
5260
5442
  * Billing trusts authenticated callers; tenancy is enforced upstream by Max.
@@ -5269,29 +5451,21 @@ export type Query = {
5269
5451
  */
5270
5452
  billingPlanCatalog: Array<BillingPlanCatalogEntry>;
5271
5453
  /**
5272
- * Companies the calling JWT user is a member of.
5273
- * @deprecated use me { companies { ... } } instead
5274
- */
5275
- companies: CompanyConnection;
5276
- /**
5277
- * Look up a company the JWT user is a member of by id or slug.
5278
- * @deprecated use me { company(idOrSlug:) { ... } } instead
5454
+ * List contacts with optional filtering and sorting.
5455
+ * Supports cross-organization filtering via `organizationFilter` — for example, contacts
5456
+ * whose organization is in a given industry or country.
5457
+ * When you already hold an Organization, prefer `organization { contacts { ... } }` to
5458
+ * avoid cross-joins. Maximum page size: 50.
5279
5459
  */
5280
- company?: Maybe<Company>;
5281
- /** List contacts with optional filtering and sorting. */
5282
5460
  contacts: ContactConnection;
5283
- /**
5284
- * Fetch a single conversation by its GlobalID-encoded id. Authorization is
5285
- * delegated to Max via `me.owner(conversationId:)`; the caller must own the
5286
- * conversation (Membership, Routine, …).
5287
- * @deprecated use node instead
5288
- */
5289
- conversation?: Maybe<Conversation>;
5290
5461
  /** Find a Definition by slug and version. */
5291
5462
  definition?: Maybe<Definition>;
5292
5463
  /** List of code-defined Definitions exposed by this subgraph. */
5293
5464
  definitions: DefinitionConnection;
5294
- /** List identifications with optional filtering. */
5465
+ /**
5466
+ * List IP-to-company identification records with optional filtering.
5467
+ * Use `filter.valid: true` to restrict to records that successfully matched a company.
5468
+ */
5295
5469
  identifications: IdentificationConnection;
5296
5470
  /** The static catalog of integration providers (defined in code). */
5297
5471
  integrationProviders: IntegrationProviderConnection;
@@ -5308,9 +5482,19 @@ export type Query = {
5308
5482
  node?: Maybe<Node>;
5309
5483
  /** Fetches a list of objects given a list of IDs. Supports all entity types across subgraphs. */
5310
5484
  nodes: Array<Maybe<Node>>;
5311
- /** Look up an organization by its domain. */
5485
+ /**
5486
+ * Look up an organization by its exact primary domain.
5487
+ * Returns null when no record exists for that domain.
5488
+ * Use when you have the exact domain. For attribute-based or fuzzy search,
5489
+ * use `organizations(filter:, sort:)` instead.
5490
+ */
5312
5491
  organization?: Maybe<Organization>;
5313
- /** List organizations with optional filtering and sorting. */
5492
+ /**
5493
+ * List organizations with optional filtering and sorting.
5494
+ * Supports semantic search via embedding filters on `description` and `industry`.
5495
+ * Use `organization(domain:)` for a direct single-domain lookup.
5496
+ * Maximum page size: 50.
5497
+ */
5314
5498
  organizations: OrganizationConnection;
5315
5499
  /** Liveness probe for the outreach subgraph. */
5316
5500
  outreachPing: Scalars['String']['output'];
@@ -5320,24 +5504,10 @@ export type Query = {
5320
5504
  * client-side math. Unset arguments keep the current value.
5321
5505
  */
5322
5506
  previewBillingSubscriptionChange: BillingSubscriptionChangePreview;
5323
- /**
5324
- * Look up a routine by id.
5325
- * @deprecated use node instead
5326
- */
5327
- routine?: Maybe<Routine>;
5328
- /**
5329
- * Look up a routine run by id.
5330
- * @deprecated use node instead
5331
- */
5332
- routineRun?: Maybe<RoutineRun>;
5333
5507
  /** Look up a routine template by slug. */
5334
5508
  routineTemplate?: Maybe<RoutineTemplate>;
5335
5509
  /** All registered routine templates. */
5336
5510
  routineTemplates: RoutineTemplateConnection;
5337
- /** Internal M2M lookup: company data by Max Company GID. Not user-scoped — intended for service-to-service calls only. */
5338
- serviceCompany?: Maybe<Company>;
5339
- /** Internal M2M lookup: user data by Max User GID. Not user-scoped — intended for service-to-service calls only. */
5340
- serviceUser?: Maybe<User>;
5341
5511
  /** Liveness probe for the signals subgraph */
5342
5512
  signalsPing: Scalars['String']['output'];
5343
5513
  /**
@@ -5355,33 +5525,11 @@ export type Query = {
5355
5525
  };
5356
5526
 
5357
5527
 
5358
- export type QueryAvailableActionsArgs = {
5359
- after?: InputMaybe<Scalars['String']['input']>;
5360
- before?: InputMaybe<Scalars['String']['input']>;
5361
- companyId: Scalars['ID']['input'];
5362
- first?: InputMaybe<Scalars['Int']['input']>;
5363
- last?: InputMaybe<Scalars['Int']['input']>;
5364
- };
5365
-
5366
-
5367
5528
  export type QueryBillingCustomerArgs = {
5368
5529
  id: Scalars['ID']['input'];
5369
5530
  };
5370
5531
 
5371
5532
 
5372
- export type QueryCompaniesArgs = {
5373
- after?: InputMaybe<Scalars['String']['input']>;
5374
- before?: InputMaybe<Scalars['String']['input']>;
5375
- first?: InputMaybe<Scalars['Int']['input']>;
5376
- last?: InputMaybe<Scalars['Int']['input']>;
5377
- };
5378
-
5379
-
5380
- export type QueryCompanyArgs = {
5381
- idOrSlug: Scalars['String']['input'];
5382
- };
5383
-
5384
-
5385
5533
  export type QueryContactsArgs = {
5386
5534
  after?: InputMaybe<Scalars['String']['input']>;
5387
5535
  before?: InputMaybe<Scalars['String']['input']>;
@@ -5393,11 +5541,6 @@ export type QueryContactsArgs = {
5393
5541
  };
5394
5542
 
5395
5543
 
5396
- export type QueryConversationArgs = {
5397
- id: Scalars['ID']['input'];
5398
- };
5399
-
5400
-
5401
5544
  export type QueryDefinitionArgs = {
5402
5545
  slug: Scalars['String']['input'];
5403
5546
  version: Scalars['Int']['input'];
@@ -5464,16 +5607,6 @@ export type QueryPreviewBillingSubscriptionChangeArgs = {
5464
5607
  };
5465
5608
 
5466
5609
 
5467
- export type QueryRoutineArgs = {
5468
- id: Scalars['ID']['input'];
5469
- };
5470
-
5471
-
5472
- export type QueryRoutineRunArgs = {
5473
- id: Scalars['ID']['input'];
5474
- };
5475
-
5476
-
5477
5610
  export type QueryRoutineTemplateArgs = {
5478
5611
  slug: Scalars['String']['input'];
5479
5612
  };
@@ -5487,16 +5620,6 @@ export type QueryRoutineTemplatesArgs = {
5487
5620
  };
5488
5621
 
5489
5622
 
5490
- export type QueryServiceCompanyArgs = {
5491
- id: Scalars['ID']['input'];
5492
- };
5493
-
5494
-
5495
- export type QueryServiceUserArgs = {
5496
- id: Scalars['ID']['input'];
5497
- };
5498
-
5499
-
5500
5623
  export type QueryUserArgs = {
5501
5624
  sub: Scalars['String']['input'];
5502
5625
  };
@@ -5515,6 +5638,16 @@ export type QueryWatcherArgs = {
5515
5638
  id: Scalars['ID']['input'];
5516
5639
  };
5517
5640
 
5641
+ /** Filter on an int8range column with range operators. */
5642
+ export type RangeFilterInput = {
5643
+ /** Matches rows whose range is fully within the given [min, max] range. */
5644
+ containedBy?: InputMaybe<Scalars['Range']['input']>;
5645
+ /** Matches rows whose range contains the given value. */
5646
+ contains?: InputMaybe<Scalars['Int']['input']>;
5647
+ /** Matches rows whose range overlaps the given [min, max] range. */
5648
+ overlaps?: InputMaybe<Scalars['Range']['input']>;
5649
+ };
5650
+
5518
5651
  /** Autogenerated input type of RecordActivity */
5519
5652
  export type RecordActivityInput = {
5520
5653
  /** Name of the agent or service that produced the event. */
@@ -5888,6 +6021,12 @@ export type RoutineAction = Node & {
5888
6021
  id: Scalars['ID']['output'];
5889
6022
  /** Optional name override. */
5890
6023
  label?: Maybe<Scalars['String']['output']>;
6024
+ /**
6025
+ * GlobalID of the Overloop outbound campaign this action references, when
6026
+ * configured (outreach actions only). Resolve via node(id:) — it is an
6027
+ * OUTREACH-owned entity, not a Max id.
6028
+ */
6029
+ outboundCampaignId?: Maybe<Scalars['ID']['output']>;
5891
6030
  /** Parent RoutineAction id; null for head. */
5892
6031
  parentActionId?: Maybe<Scalars['ID']['output']>;
5893
6032
  /** Bound action definition slug. */
@@ -6249,6 +6388,25 @@ export type RunSynchronousWorkerPayload = Node & {
6249
6388
  id: Scalars['ID']['output'];
6250
6389
  };
6251
6390
 
6391
+ /** Autogenerated input type of SearchOrganization */
6392
+ export type SearchOrganizationInput = {
6393
+ /** A unique identifier for the client performing the mutation. */
6394
+ clientMutationId?: InputMaybe<Scalars['String']['input']>;
6395
+ /** The company's primary web domain (no scheme, no trailing slash). */
6396
+ domain: Scalars['String']['input'];
6397
+ /** Caller-supplied correlation key; pass the same value to `organizationSearchResult(externalId:)` to receive the result. */
6398
+ externalId: Scalars['String']['input'];
6399
+ };
6400
+
6401
+ /** Autogenerated return type of SearchOrganization. */
6402
+ export type SearchOrganizationPayload = Node & {
6403
+ __typename?: 'SearchOrganizationPayload';
6404
+ /** A unique identifier for the client performing the mutation. */
6405
+ clientMutationId?: Maybe<Scalars['String']['output']>;
6406
+ id: Scalars['ID']['output'];
6407
+ status: Scalars['String']['output'];
6408
+ };
6409
+
6252
6410
  /** Seat accounting for a company: seats consumed versus the seat limit granted by the billing plan. */
6253
6411
  export type SeatUsage = {
6254
6412
  __typename?: 'SeatUsage';
@@ -6301,6 +6459,27 @@ export type SendTransactionalEmailPayload = Node & {
6301
6459
  id: Scalars['ID']['output'];
6302
6460
  };
6303
6461
 
6462
+ /** Autogenerated input type of SetWebhookActive */
6463
+ export type SetWebhookActiveInput = {
6464
+ /** True to resume delivery, false to pause it. */
6465
+ active: Scalars['Boolean']['input'];
6466
+ /** A unique identifier for the client performing the mutation. */
6467
+ clientMutationId?: InputMaybe<Scalars['String']['input']>;
6468
+ id: Scalars['ID']['input'];
6469
+ /** Webhook URL whose delivery state is toggled. */
6470
+ webhookUrl: Scalars['String']['input'];
6471
+ };
6472
+
6473
+ /** Autogenerated return type of SetWebhookActive. */
6474
+ export type SetWebhookActivePayload = Node & {
6475
+ __typename?: 'SetWebhookActivePayload';
6476
+ /** A unique identifier for the client performing the mutation. */
6477
+ clientMutationId?: Maybe<Scalars['String']['output']>;
6478
+ id: Scalars['ID']['output'];
6479
+ /** The reconciled Watcher. */
6480
+ watcher: Watcher;
6481
+ };
6482
+
6304
6483
  /** Autogenerated input type of SkipMembershipOnboardingTask */
6305
6484
  export type SkipMembershipOnboardingTaskInput = {
6306
6485
  /** A unique identifier for the client performing the mutation. */
@@ -6355,24 +6534,63 @@ export type SlackChannelEdge = Node & {
6355
6534
 
6356
6535
  /** Sort direction. */
6357
6536
  export type SortDirection =
6537
+ /** Ascending order (lowest to highest, oldest to newest). */
6358
6538
  | 'ASC'
6539
+ /** Descending order (highest to lowest, newest to oldest). */
6359
6540
  | 'DESC';
6360
6541
 
6361
6542
  /** An enrichment data source with trust score and field mappings. */
6362
6543
  export type Source = Node & {
6363
6544
  __typename?: 'Source';
6545
+ /**
6546
+ * Maps Atlas canonical contact field names to rawData extraction expressions.
6547
+ * Keys: first_name, last_name, email_address, job_title, job_level, job_function,
6548
+ * linkedin_url, city, country_code.
6549
+ * Values: a string key ("firstname"), an array path for nested access
6550
+ * (["data", "email"]), or an operation hash
6551
+ * ({"op": "split", "key": "full_name", "index": 0}).
6552
+ * All referenced keys must exist in contact_schema.
6553
+ */
6364
6554
  contactFieldMappings: Scalars['JSON']['output'];
6555
+ /** JSON Schema (draft-07) describing the expected shape of contact rawData payloads. */
6365
6556
  contactSchema: Scalars['JSON']['output'];
6557
+ /** When the source was registered. */
6366
6558
  createdAt: Scalars['ISO8601DateTime']['output'];
6367
6559
  id: Scalars['ID']['output'];
6560
+ /**
6561
+ * Maps Atlas canonical identification field names to rawData extraction expressions.
6562
+ * Keys: ip_address, organization_domain, confidence_score.
6563
+ * Values follow the same expression syntax as contact_field_mappings.
6564
+ * All referenced keys must exist in identification_schema.
6565
+ */
6368
6566
  identificationFieldMappings: Scalars['JSON']['output'];
6567
+ /** JSON Schema (draft-07) describing the expected shape of identification rawData payloads. */
6369
6568
  identificationSchema: Scalars['JSON']['output'];
6569
+ /** OAuth subject of the user who registered this source. Null for system-registered sources. */
6370
6570
  oauthId?: Maybe<Scalars['String']['output']>;
6571
+ /**
6572
+ * Maps address slot names to rawData extraction expressions.
6573
+ * The top-level key names an address slot (e.g. "headquarters").
6574
+ * Each slot maps Atlas address field names (street, city, state, postal_code,
6575
+ * country_code, is_headquarters) to extraction expressions or literal values.
6576
+ */
6371
6577
  officeFieldMappings: Scalars['JSON']['output'];
6578
+ /**
6579
+ * Maps Atlas canonical organization field names to rawData extraction expressions.
6580
+ * Keys: name, website, phone, contact_email, linkedin_url, description,
6581
+ * company_size, founded_year, industry, country_code, annual_revenue.
6582
+ * Values: a string key ("name"), an array path (["company", "name"]),
6583
+ * or an operation hash ({"op": "parse_employee_range", "path": ["size_range"]}).
6584
+ * All referenced keys must exist in organization_schema.
6585
+ */
6372
6586
  organizationFieldMappings: Scalars['JSON']['output'];
6587
+ /** JSON Schema (draft-07) describing the expected shape of organization rawData payloads. */
6373
6588
  organizationSchema: Scalars['JSON']['output'];
6589
+ /** Short machine-readable identifier for this source (e.g. snitcher, hunter). */
6374
6590
  slug: Scalars['String']['output'];
6591
+ /** Weight applied during multi-source merging, 0.0–1.0. Higher scores win field conflicts. */
6375
6592
  trustScore: Scalars['Float']['output'];
6593
+ /** When the source configuration was last updated. */
6376
6594
  updatedAt: Scalars['ISO8601DateTime']['output'];
6377
6595
  };
6378
6596
 
@@ -6407,25 +6625,52 @@ export type StringFilterInput = {
6407
6625
 
6408
6626
  export type Subscription = {
6409
6627
  __typename?: 'Subscription';
6410
- /** Result of an identify_company operation, keyed by externalId. */
6628
+ /**
6629
+ * Delivers the result of an `identifyCompany` call, keyed by `externalId`.
6630
+ * Subscribe before or immediately after calling `identifyCompany`, passing the
6631
+ * same `externalId`. The payload contains the matched Organization, or null if
6632
+ * no company could be identified.
6633
+ */
6411
6634
  companyIdentifyResult: CompanyIdentifyResultPayload;
6412
- /** Result of enriching a contact, keyed by externalId. */
6635
+ /**
6636
+ * Delivers the result of an `enrichContact` call when `externalId` was supplied,
6637
+ * keyed by that `externalId`. The payload contains the merged Contact after enrichment.
6638
+ */
6413
6639
  contactEnrichmentResult: ContactEnrichmentResultPayload;
6414
- /** Result of an identify_contact operation, keyed by externalId. */
6640
+ /**
6641
+ * Delivers the result of an `identifyContact` call, keyed by `externalId`.
6642
+ * Subscribe before or immediately after calling `identifyContact`, passing the
6643
+ * same `externalId`. The payload contains the matched Contact, or null if not found.
6644
+ */
6415
6645
  contactIdentifyResult: ContactIdentifyResultPayload;
6416
- /** Result of a validate_contact operation, keyed by externalId. */
6646
+ /**
6647
+ * Delivers the result of a `validateContact` call, keyed by `externalId`.
6648
+ * The payload contains the Contact and per-field coherence flags in `clues`.
6649
+ */
6417
6650
  contactValidationResult: ContactValidationResultPayload;
6418
6651
  /** Stream of events for an ongoing conversation: reply lifecycle, streamed content chunks, and interactive tool prompts. */
6419
6652
  conversationEvent: ConversationEventInterface;
6420
- /** Result of a validate_domain operation, keyed by externalId. */
6653
+ /**
6654
+ * Delivers the result of a `validateDomain` call, keyed by `externalId`.
6655
+ * The payload contains the Organization and per-field coherence flags in `clues`.
6656
+ */
6421
6657
  domainValidationResult: DomainValidationResultPayload;
6422
- /** Result of a find_contact_email operation, keyed by externalId. */
6658
+ /**
6659
+ * Delivers the result of a `findContactEmail` call, keyed by `externalId`.
6660
+ * The payload contains the Contact with the discovered email, or null if no email was found.
6661
+ */
6423
6662
  findContactEmailResult: FindContactEmailResultPayload;
6424
6663
  /**
6425
6664
  * Fires when the authenticated user's company memberships change. Returns the
6426
6665
  * user so the client can query updated membership data.
6427
6666
  */
6428
6667
  membershipChanged: User;
6668
+ /**
6669
+ * Delivers the result of a `searchOrganization` call, keyed by `externalId`.
6670
+ * The payload contains the Organization once Atlas has looked up or enriched it,
6671
+ * or null if no data was found for the domain.
6672
+ */
6673
+ organizationSearchResult: OrganizationSearchResultPayload;
6429
6674
  /** Spike subscription used to validate the callback transport end-to-end. */
6430
6675
  ping: PingPayload;
6431
6676
  };
@@ -6466,6 +6711,11 @@ export type SubscriptionFindContactEmailResultArgs = {
6466
6711
  };
6467
6712
 
6468
6713
 
6714
+ export type SubscriptionOrganizationSearchResultArgs = {
6715
+ externalId: Scalars['ID']['input'];
6716
+ };
6717
+
6718
+
6469
6719
  export type SubscriptionPingArgs = {
6470
6720
  externalId: Scalars['ID']['input'];
6471
6721
  };
@@ -7070,13 +7320,41 @@ export type UpdateRoutinePayload = Node & {
7070
7320
  export type UpdateSourceInput = {
7071
7321
  /** A unique identifier for the client performing the mutation. */
7072
7322
  clientMutationId?: InputMaybe<Scalars['String']['input']>;
7323
+ /**
7324
+ * Maps Atlas canonical contact field names to rawData extraction expressions.
7325
+ * Keys: first_name, last_name, email_address, job_title, job_level, job_function,
7326
+ * linkedin_url, city, country_code.
7327
+ * Values: a string key ("firstname"), an array path for nested access
7328
+ * (["data", "email"]), or an operation hash
7329
+ * ({"op": "split", "key": "full_name", "index": 0}).
7330
+ * All referenced keys must exist in contact_schema.
7331
+ */
7073
7332
  contactFieldMappings?: InputMaybe<Scalars['JSON']['input']>;
7333
+ /** JSON Schema (draft-07) describing the expected shape of contact rawData payloads. */
7074
7334
  contactSchema?: InputMaybe<Scalars['JSON']['input']>;
7335
+ /**
7336
+ * Maps Atlas canonical identification field names to rawData extraction expressions.
7337
+ * Keys: ip_address, organization_domain, confidence_score.
7338
+ * Values follow the same expression syntax as contact_field_mappings.
7339
+ * All referenced keys must exist in identification_schema.
7340
+ */
7075
7341
  identificationFieldMappings?: InputMaybe<Scalars['JSON']['input']>;
7342
+ /** JSON Schema (draft-07) describing the expected shape of identification rawData payloads. */
7076
7343
  identificationSchema?: InputMaybe<Scalars['JSON']['input']>;
7344
+ /**
7345
+ * Maps Atlas canonical organization field names to rawData extraction expressions.
7346
+ * Keys: name, website, phone, contact_email, linkedin_url, description,
7347
+ * company_size, founded_year, industry, country_code, annual_revenue.
7348
+ * Values: a string key ("name"), an array path (["company", "name"]),
7349
+ * or an operation hash ({"op": "parse_employee_range", "path": ["size_range"]}).
7350
+ * All referenced keys must exist in organization_schema.
7351
+ */
7077
7352
  organizationFieldMappings?: InputMaybe<Scalars['JSON']['input']>;
7353
+ /** JSON Schema (draft-07) describing the expected shape of organization rawData payloads. */
7078
7354
  organizationSchema?: InputMaybe<Scalars['JSON']['input']>;
7355
+ /** Global ID of the source to update. */
7079
7356
  sourceId: Scalars['ID']['input'];
7357
+ /** Weight applied during multi-source merging, 0.0–1.0. Higher scores win field conflicts. */
7080
7358
  trustScore?: InputMaybe<Scalars['Float']['input']>;
7081
7359
  };
7082
7360
 
@@ -7240,12 +7518,17 @@ export type UserVisibleToolName =
7240
7518
 
7241
7519
  /** Autogenerated input type of ValidateContact */
7242
7520
  export type ValidateContactInput = {
7521
+ /** Optional values to cross-check against Atlas data (email, phone). */
7243
7522
  checks?: InputMaybe<ContactValidationChecksInput>;
7244
7523
  /** A unique identifier for the client performing the mutation. */
7245
7524
  clientMutationId?: InputMaybe<Scalars['String']['input']>;
7525
+ /** Caller-supplied correlation key; pass the same value to `contactValidationResult(externalId:)` to receive the result. */
7246
7526
  externalId: Scalars['String']['input'];
7527
+ /** Contact's first name to validate. */
7247
7528
  firstName: Scalars['String']['input'];
7529
+ /** Contact's last name to validate. */
7248
7530
  lastName: Scalars['String']['input'];
7531
+ /** Global ID of the organization this contact belongs to. */
7249
7532
  organizationId: Scalars['ID']['input'];
7250
7533
  /**
7251
7534
  * Optional URL to receive the result via webhook. Callers consuming results via
@@ -7266,10 +7549,13 @@ export type ValidateContactPayload = Node & {
7266
7549
 
7267
7550
  /** Autogenerated input type of ValidateDomain */
7268
7551
  export type ValidateDomainInput = {
7552
+ /** Company field values to cross-check against Atlas data. */
7269
7553
  checks?: InputMaybe<ValidationChecksInput>;
7270
7554
  /** A unique identifier for the client performing the mutation. */
7271
7555
  clientMutationId?: InputMaybe<Scalars['String']['input']>;
7556
+ /** The company's primary web domain to validate. */
7272
7557
  domain: Scalars['String']['input'];
7558
+ /** Caller-supplied correlation key; pass the same value to `domainValidationResult(externalId:)` to receive the result. */
7273
7559
  externalId: Scalars['String']['input'];
7274
7560
  /**
7275
7561
  * Optional URL to receive the result via webhook. Callers consuming results via
@@ -7288,16 +7574,27 @@ export type ValidateDomainPayload = Node & {
7288
7574
  status: Scalars['String']['output'];
7289
7575
  };
7290
7576
 
7577
+ /** Company field values to cross-check against Atlas's stored organization data. */
7291
7578
  export type ValidationChecksInput = {
7579
+ /** Expected annual revenue string to validate against the stored range. */
7292
7580
  annualRevenue?: InputMaybe<Scalars['String']['input']>;
7581
+ /** Expected employee count string to validate against the stored range. */
7293
7582
  companySize?: InputMaybe<Scalars['String']['input']>;
7583
+ /** General contact email address to validate. */
7294
7584
  contactEmail?: InputMaybe<Scalars['String']['input']>;
7585
+ /** ISO 3166-1 alpha-2 country code to validate. */
7295
7586
  countryCode?: InputMaybe<Scalars['String']['input']>;
7587
+ /** Four-digit founding year to validate against the stored value. */
7296
7588
  foundedYear?: InputMaybe<Scalars['Int']['input']>;
7589
+ /** Industry string to validate against the stored classification. */
7297
7590
  industry?: InputMaybe<Scalars['String']['input']>;
7591
+ /** IP address to include in identification coherence checks. */
7298
7592
  ip?: InputMaybe<Scalars['String']['input']>;
7593
+ /** LinkedIn company page URL to validate. */
7299
7594
  linkedinUrl?: InputMaybe<Scalars['String']['input']>;
7595
+ /** Legal or trade name to validate against the stored value. */
7300
7596
  name?: InputMaybe<Scalars['String']['input']>;
7597
+ /** Main phone number to validate. */
7301
7598
  phone?: InputMaybe<Scalars['String']['input']>;
7302
7599
  };
7303
7600
 
@@ -7306,8 +7603,8 @@ export type Watcher = AcquisitionerInterface & Node & {
7306
7603
  __typename?: 'Watcher';
7307
7604
  /** Timestamp at which the Watcher was permanently canceled, or null if active or paused. */
7308
7605
  canceledAt?: Maybe<Scalars['ISO8601DateTime']['output']>;
7309
- /** Identifier of the Company that owns this Watcher. */
7310
- companyId: Scalars['ID']['output'];
7606
+ /** Identifier of the Company this Watcher relates to. Null for watchers created by a caller with no company context. */
7607
+ companyId?: Maybe<Scalars['ID']['output']>;
7311
7608
  /** Timestamp when the Watcher was created. */
7312
7609
  createdAt: Scalars['ISO8601DateTime']['output'];
7313
7610
  /** The signal Definition this Watcher tracks. */
@@ -7352,6 +7649,12 @@ export type WatcherEventsArgs = {
7352
7649
 
7353
7650
  /** Delivery endpoint registered on a Watcher. Secrets are write-only — they are never returned by the API. */
7354
7651
  export type WatcherWebhookInput = {
7652
+ /**
7653
+ * Whether this webhook should receive deliveries. Defaults to true; pass false
7654
+ * to register it without delivering events yet (e.g. for a paused or
7655
+ * credit-blocked routine), then activate it later via setWebhookActive.
7656
+ */
7657
+ active?: InputMaybe<Scalars['Boolean']['input']>;
7355
7658
  /** HMAC-SHA256 secret used to sign deliveries. Store this — it is not returned after creation. */
7356
7659
  secret: Scalars['String']['input'];
7357
7660
  /** URL that receives a POST payload when a signal fires. */
@@ -7524,6 +7827,7 @@ export type ConversationQuery = { __typename?: 'Query', node?:
7524
7827
  | { __typename?: 'CreateSalesOfferPayload' }
7525
7828
  | { __typename?: 'CreateWatcherPayload' }
7526
7829
  | { __typename?: 'DebitCreditsPayload' }
7830
+ | { __typename?: 'DeleteBillingCustomerPayload' }
7527
7831
  | { __typename?: 'DeleteWatcherPayload' }
7528
7832
  | { __typename?: 'DeprecatedActionBinding' }
7529
7833
  | { __typename?: 'DeprecatedActionBindingEdge' }
@@ -7613,7 +7917,9 @@ export type ConversationQuery = { __typename?: 'Query', node?:
7613
7917
  | { __typename?: 'RunMaxSynchronousWorkerPayload' }
7614
7918
  | { __typename?: 'RunSignalsSynchronousWorkerPayload' }
7615
7919
  | { __typename?: 'RunSynchronousWorkerPayload' }
7920
+ | { __typename?: 'SearchOrganizationPayload' }
7616
7921
  | { __typename?: 'SendTransactionalEmailPayload' }
7922
+ | { __typename?: 'SetWebhookActivePayload' }
7617
7923
  | { __typename?: 'SkipMembershipOnboardingTaskPayload' }
7618
7924
  | { __typename?: 'SlackChannel' }
7619
7925
  | { __typename?: 'SlackChannelEdge' }
package/src/index.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import fs from 'node:fs';
2
2
  import { Command } from 'commander';
3
3
 
4
- import { chatCommand } from './commands/chat/chat.ts';
4
+ // import { chatCommand } from './commands/chat/chat.ts';
5
5
  import { configCommand } from './commands/config.ts';
6
6
  import { buildServiceCommands } from './commands/dynamic.ts';
7
7
  import { loginCommand } from './commands/login.ts';
@@ -135,13 +135,16 @@ try {
135
135
 
136
136
  for (const [name, entry] of serviceCommands) {
137
137
  const cmd = entry.command;
138
+ /**
139
+ * Disabling the chat for now until we know what to do with this feature
140
+ */
138
141
  // Chat: replace the generated basic `conversation` command with the interactive one
139
- if (name === 'chat') {
140
- const chatCmds = cmd.commands as unknown as Command[];
141
- const convIdx = chatCmds.findIndex((c) => c.name() === 'conversation');
142
- if (convIdx !== -1) chatCmds.splice(convIdx, 1);
143
- cmd.addCommand(chatCommand);
144
- }
142
+ // if (name === 'chat') {
143
+ // const chatCmds = cmd.commands as unknown as Command[];
144
+ // const convIdx = chatCmds.findIndex((c) => c.name() === 'conversation');
145
+ // if (convIdx !== -1) chatCmds.splice(convIdx, 1);
146
+ // cmd.addCommand(chatCommand);
147
+ // }
145
148
  program.addCommand(cmd);
146
149
  servicesForHelp.set(name, {
147
150
  exampleQuery: entry.exampleQuery,
package/src/lib/config.ts CHANGED
@@ -47,6 +47,17 @@ export function resetConfig(): void {
47
47
  }
48
48
  }
49
49
 
50
+ /**
51
+ * Drops the cached identity (user + company/agency context) while preserving
52
+ * non-identity settings like the endpoint. Used by `logout` so the next login
53
+ * can't surface the previous account's user and company.
54
+ */
55
+ export function clearIdentity(): void {
56
+ const { endpoint } = loadConfig();
57
+ ensureDir();
58
+ fs.writeFileSync(CONFIG_PATH, JSON.stringify({ endpoint }, null, 2) + '\n');
59
+ }
60
+
50
61
  export function getEndpoint(override?: string): string {
51
62
  if (override) return override;
52
63
  if (process.env.SL_ENDPOINT) return process.env.SL_ENDPOINT;