@aglyn/aglyn 1.0.0-beta.221 → 1.0.0-beta.222

package/src/lib/app-utils/crm.d.ts

@@ -48,6 +48,7 @@ import { type ConsentGroup } from './consent-groups';
 import { type ContactLifecycleStage, type CrmActivityKind, type CrmTaskKind } from './crm-kinds';
 import { type ContactInteraction, type ContactSegment, type ContactSource } from './contacts';
 import { type EmailState } from './email-state';
+import { mintPicklistValueId, normalizePicklistLabel, picklistActiveValues, picklistDefaultLabel, picklistFromLabels, type PicklistJudgement, picklistOptions, type PicklistOption, picklistRank, type PicklistSpec, type PicklistValue, picklistValueByLabel, type PicklistValueSet } from './picklists';
 import { type ScopeToken } from './scope-tokens';
 export * from './crm-kinds';
 /**
@@ -227,10 +228,38 @@ export interface CrmCompany extends CrmScoped {
     website?: string;
     /** E.164 — `normalizePhone` before writing. */
     phone?: string;
+    /** The billing address — Salesforce's Billing Address, under its original name. */
     address?: AglynPostalAddress | null;
+    /**
+     * Salesforce's Industry: a label of the `industry` picklist (AGL-3514).
+     * A record written while it was free text keeps its text.
+     */
     industry?: string;
     ownerUid?: string;
     notes?: string;
+    /** Account Type: a label of the `accountType` picklist. */
+    type?: string | null;
+    /** Rating: a label of the `rating` picklist. */
+    rating?: string | null;
+    /** Ownership: a label of the `ownership` picklist. */
+    ownership?: string | null;
+    /** Account Source: a label of the `leadSource` picklist. */
+    accountSource?: string | null;
+    /** Annual revenue in the minor unit of {@link CrmCompany.currency}. */
+    annualRevenueCents?: number | null;
+    /** Lowercase ISO 4217, the deals' convention; `'usd'` when absent. */
+    currency?: string;
+    numberOfEmployees?: number | null;
+    /** E.164 — `normalizePhone`, like `phone`. */
+    fax?: string | null;
+    accountNumber?: string | null;
+    /** Salesforce's Account Site: which of the company's locations this record is. */
+    site?: string | null;
+    tickerSymbol?: string | null;
+    sicCode?: string | null;
+    shippingAddress?: AglynPostalAddress | null;
+    /** Another company of the same scope this one sits under; never itself or a descendant. */
+    parentCompanyId?: string | null;
     /**
      * Lowercased, deduplicated, capped at twenty — the same shape a contact's
      * tags take, so a bulk "Add tag" over companies and one over contacts
@@ -271,7 +300,55 @@ export interface CrmDealStage {
      * between.
      */
     kind: 'open' | 'won' | 'lost';
+    /**
+     * The forecast category a deal takes on landing here (AGL-3516) — see
+     * {@link CrmForecastCategory}. Absent on a stage written before the field
+     * existed, which reads as its kind's: Closed for won, Omitted for lost,
+     * Pipeline for open ({@link dealStageForecastCategory}).
+     */
+    forecastCategory?: CrmForecastCategory;
 }
+export declare const CRM_FORECAST_CATEGORIES: readonly ["omitted", "pipeline", "bestCase", "commit", "closed"];
+export type CrmForecastCategory = (typeof CRM_FORECAST_CATEGORIES)[number];
+export declare const CRM_FORECAST_CATEGORY_LABELS: Record<CrmForecastCategory, string>;
+export declare function isCrmForecastCategory(value: unknown): value is CrmForecastCategory;
+/**
+ * A category as typed — the stored key or its label in any case and
+ * spacing ("Best Case", "best case", `bestCase`) — or `null`.
+ */
+export declare function readCrmForecastCategory(value: unknown): CrmForecastCategory | null;
+/** The category a stage stamps: its own, else its kind's. */
+export declare function dealStageForecastCategory(stage: Pick<CrmDealStage, 'kind' | 'forecastCategory'>): CrmForecastCategory;
+/**
+ * A deal's forecast category as every reader takes it: the deal's own,
+ * else its stage's, else its status's — a deal written before the field
+ * existed forecasts where its stage puts it.
+ */
+export declare function dealForecastCategory(deal: Partial<Pick<CrmDeal, 'forecastCategory' | 'status'>>, stage: Pick<CrmDealStage, 'kind' | 'forecastCategory'> | null | undefined): CrmForecastCategory;
+/** The longest Next step a deal keeps — Salesforce's own 255. */
+export declare const DEAL_NEXT_STEP_MAX = 255;
+/**
+ * A probability override as stored: a whole number 0–100, or `null` for
+ * none (the stage's applies). Anything that is not a number in range is
+ * `undefined` — unreadable, for the writer to refuse.
+ */
+export declare function readDealProbability(value: unknown): number | null | undefined;
+/**
+ * A deal's probability: its own override when it holds one, else its
+ * stage's, else `null` for a stage the pipeline no longer has.
+ */
+export declare function dealProbability(deal: Partial<Pick<CrmDeal, 'probability'>>, stage: Pick<CrmDealStage, 'probability'> | null | undefined): number | null;
+/**
+ * What a stage move writes besides the stage, the status and the clocks:
+ * the new stage's forecast category, and the probability override CLEARED
+ * — Salesforce re-defaults a probability when the stage changes, so an
+ * override typed for the last stage does not follow the deal into the next.
+ * A write that sets either field itself, in the same request, wins.
+ */
+export declare function dealStageMoveFields(stage: Pick<CrmDealStage, 'kind' | 'forecastCategory'>): {
+    forecastCategory: CrmForecastCategory;
+    probability: null;
+};
 /** `orgs/{orgId}/pipelines/{pipelineId}`. */
 export interface CrmPipeline extends CrmScoped {
     name: string;
@@ -289,7 +366,14 @@ export interface CrmPipeline extends CrmScoped {
 /** Whether a pipeline has been retired — see {@link CrmPipeline.archivedAt}. */
 export declare function isPipelineArchived(pipeline: Pick<CrmPipeline, 'archivedAt'> | null | undefined): boolean;
 /**
- * The stages a fresh pipeline starts with.
+ * The stages a fresh pipeline starts with: Salesforce's standard
+ * Opportunity stages, with its probabilities and forecast categories
+ * (AGL-3516). A pipeline seeded before them keeps the stages it was seeded
+ * with — nothing migrates a stored pipeline.
+ *
+ * The closing stages keep the ids `won` and `lost` every pipeline has had,
+ * so an automation filter naming them reads the same on old pipelines and
+ * new ones.
  *
  * Readonly on purpose: a pipeline document stores its own COPY (`[...]`), so
  * a merchant editing their stages must not be editing the module's default,
@@ -370,6 +454,42 @@ export interface CrmDeal extends CrmScoped {
     lostReason?: string;
     notes?: string;
     createdByUid?: string;
+    /**
+     * Salesforce's Type — the LABEL of one of the org's `opportunityType`
+     * values (New Business, Existing Business, …); `typeKey` beside it is
+     * what the Deals list filters by.
+     */
+    type?: string;
+    /**
+     * Salesforce's Lead Source — the LABEL of one of the org's `leadSource`
+     * values, the picklist a lead's own lead source is; stamped from the
+     * lead a conversion opens the deal for. `leadSourceKey` beside it.
+     */
+    leadSource?: string;
+    /** What happens next, at most {@link DEAL_NEXT_STEP_MAX} characters. */
+    nextStep?: string;
+    /**
+     * This deal's own chance of closing, a whole number 0–100, overriding
+     * its stage's; `null` or absent means the stage's applies. Cleared by
+     * every stage move ({@link dealStageMoveFields}).
+     */
+    probability?: number | null;
+    /**
+     * Where the deal is forecast — stamped from the stage at every stage move
+     * and changeable for this deal afterwards. See {@link dealForecastCategory}.
+     */
+    forecastCategory?: CrmForecastCategory;
+    /**
+     * Salesforce's Primary Campaign Source: ONE of the org's campaigns (the
+     * Marketing plugin's containers, which a lead's `campaignIds` name).
+     */
+    campaignId?: string;
+    /**
+     * Salesforce's Opportunity Contact Roles (AGL-3521): the people on the
+     * deal and the part each plays, at most one of them Primary — the one
+     * `contactId` names. See {@link dealContactRolesOf}.
+     */
+    contactRoles?: CrmDealContactRole[];
     /**
      * Custom field values, keyed by the key of a definition whose `object`
      * is `deal` — see {@link fieldDefinitionObject} (AGL-2661).
@@ -392,6 +512,53 @@ export interface CrmDeal extends CrmScoped {
     /** Org-library files attached to the deal (AGL-2662) — see {@link CRM_MEDIA_IDS_MAX}. */
     mediaIds?: string[];
 }
+/** The most contacts one deal names — a buying committee, not a mailing list. */
+export declare const DEAL_CONTACT_ROLES_MAX = 50;
+/** One contact on a deal. */
+export interface CrmDealContactRole {
+    contactId: string;
+    /** The `opportunityContactRole` label, absent for a contact with no role yet. */
+    role?: string;
+    primary: boolean;
+}
+/**
+ * Stored or sent roles, read defensively: a row without a usable contact
+ * id is dropped, a contact named twice keeps its first row, only the first
+ * Primary stays Primary, and the list stops at {@link DEAL_CONTACT_ROLES_MAX}.
+ */
+export declare function readDealContactRoles(raw: unknown): CrmDealContactRole[];
+/**
+ * `roles` with `contactId` as the one Primary — added first, with no role,
+ * when the list does not name them — or, for `null`, with no Primary.
+ */
+export declare function dealContactRolesWithPrimary(roles: readonly CrmDealContactRole[], contactId: string | null | undefined): CrmDealContactRole[];
+/**
+ * The roles a deal holds, in step with its `contactId`: the stored list
+ * with the contact `contactId` names as its Primary — so a deal written
+ * before roles reads as its one contact, Primary, with no role.
+ */
+export declare function dealContactRolesOf(deal: {
+    contactId?: unknown;
+    contactRoles?: unknown;
+}): CrmDealContactRole[];
+/** The Primary's contact id, or `null` for a deal with none. */
+export declare function dealPrimaryContactId(roles: readonly CrmDealContactRole[]): string | null;
+/** `roles` without one contact — a delete or an erasure of that person. */
+export declare function dealContactRolesWithout(roles: readonly CrmDealContactRole[], contactId: string): CrmDealContactRole[];
+/**
+ * `roles` with every row naming `from` moved to `to` — a contact merge.
+ * When both are on the deal the survivor keeps its own row, taking the
+ * merged row's role where it has none and its Primary where it was.
+ */
+export declare function dealContactRolesRepointed(roles: readonly CrmDealContactRole[], from: string, to: string): CrmDealContactRole[];
+/**
+ * What a deal stores for a list of roles: the list, and the `contactId`
+ * its Primary names — `null` for none, which a writer turns into a delete.
+ */
+export declare function dealContactRoleFields(roles: readonly CrmDealContactRole[]): {
+    contactRoles: CrmDealContactRole[];
+    contactId: string | null;
+};
 export declare const CRM_TASK_KIND_LABELS: Record<CrmTaskKind, string>;
 export type CrmTaskPriority = 'low' | 'normal' | 'high';
 export type CrmTaskStatus = 'open' | 'done';
@@ -413,6 +580,15 @@ export interface CrmTask extends Omit<CrmScoped, 'hostId'> {
     kind: CrmTaskKind;
     priority: CrmTaskPriority;
     status: CrmTaskStatus;
+    /**
+     * The org's labels for `status`, `priority` and `kind` (AGL-3517) — a
+     * value of the `taskStatus`, `taskPriority` and `taskType` picklists,
+     * whose meaning is the field beside it. Absent or `null` shows the first
+     * active value of that meaning; see `crmTaskPicklistLabels`.
+     */
+    statusLabel?: string | null;
+    priorityLabel?: string | null;
+    typeLabel?: string | null;
     dueAtMs?: number | null;
     completedAtMs?: number | null;
     /**
@@ -549,6 +725,21 @@ export declare function crmEmailDeliveryTags(input: {
  * which only the capture route files (AGL-2657).
  */
 export type CrmEmailDirection = 'outbound' | 'inbound';
+/**
+ * Which way a call went (AGL-3517) — Salesforce's Call Type: `inbound` for
+ * one the contact placed, `outbound` for one the team placed, `internal`
+ * for one between teammates about the record.
+ */
+export type CrmCallDirection = CrmEmailDirection | 'internal';
+/** An activity's direction: a call's three, of which an email takes the first two. */
+export type CrmActivityDirection = CrmCallDirection;
+/** The directions each kind takes, in the order a select lists them; none for the rest. */
+export declare const CRM_ACTIVITY_DIRECTIONS: Readonly<Partial<Record<CrmActivityKind, readonly CrmActivityDirection[]>>>;
+export declare const CRM_ACTIVITY_DIRECTION_LABELS: Record<CrmActivityDirection, string>;
+/** `value` when `kind` takes it as a direction, else `null`. */
+export declare function crmActivityDirection(kind: unknown, value: unknown): CrmActivityDirection | null;
+/** "Inbound call", "Outbound email", "Internal call" — or the kind alone with no direction. */
+export declare function crmActivityKindTitle(kind: CrmActivityKind, direction?: unknown): string;
 /**
  * `orgs/{orgId}/crmActivities/{activityId}` — one thing that happened.
  *
@@ -608,10 +799,12 @@ export interface CrmActivity extends CrmScoped {
     /** The address the message left for. */
     to?: string;
     /**
-     * `outbound` for a message the platform sent or a teammate copied to the
-     * capture address; `inbound` for one a correspondent wrote (AGL-2657).
+     * On an email: `outbound` for a message the platform sent or a teammate
+     * copied to the capture address; `inbound` for one a correspondent wrote
+     * (AGL-2657). On a call: inbound, outbound or internal (AGL-3517). See
+     * {@link CRM_ACTIVITY_DIRECTIONS}.
      */
-    direction?: CrmEmailDirection;
+    direction?: CrmActivityDirection;
     /** See {@link CrmEmailDeliveryState}; advanced by the delivery webhook. */
     deliveryState?: CrmEmailDeliveryState;
     /** When the delivery state last moved, epoch ms. */
@@ -919,8 +1112,11 @@ export declare function dealStageById(pipeline: Pick<CrmPipeline, 'stages'> | nu
  * of itself. An open deal with no resolvable stage is worth nothing rather
  * than everything: the pipeline lost the stage, and a forecast that filled
  * the gap with 100% would be the most optimistic number available.
+ *
+ * An open deal's own probability override (AGL-3516) replaces its stage's
+ * — see {@link dealProbability}.
  */
-export declare function weightedDealAmountCents(deal: Pick<CrmDeal, 'amountCents' | 'status'>, stage: Pick<CrmDealStage, 'probability'> | null | undefined): number;
+export declare function weightedDealAmountCents(deal: Pick<CrmDeal, 'amountCents' | 'status'> & Partial<Pick<CrmDeal, 'probability'>>, stage: Pick<CrmDealStage, 'probability'> | null | undefined): number;
 /** Whether a deal's amount is derived — it has at least one line item. */
 export declare function dealHasLineItems(deal: Pick<CrmDeal, 'lineItems'> | null | undefined): boolean;
 /**
@@ -984,6 +1180,89 @@ export declare function normalizeCompanyDomain(input: unknown): string | null;
  * website imported are stored the same way.
  */
 export declare function normalizeCompanyWebsite(input: unknown): string | null;
+/** Each company picklist field: the list it holds a value of, and the key the list filters by. */
+export declare const CRM_COMPANY_PICKLIST_FIELDS: readonly [{
+    readonly field: "type";
+    readonly picklistId: "accountType";
+    readonly keyField: "typeKey";
+}, {
+    readonly field: "industry";
+    readonly picklistId: "industry";
+    readonly keyField: "industryKey";
+}, {
+    readonly field: "rating";
+    readonly picklistId: "rating";
+    readonly keyField: "ratingKey";
+}, {
+    readonly field: "ownership";
+    readonly picklistId: "ownership";
+}, {
+    readonly field: "accountSource";
+    readonly picklistId: "leadSource";
+    readonly keyField: "accountSourceKey";
+}];
+export type CrmCompanyPicklistField = (typeof CRM_COMPANY_PICKLIST_FIELDS)[number]['field'];
+/** The short text fields, each capped at Salesforce's own length. */
+export declare const CRM_COMPANY_TEXT_MAX: {
+    readonly accountNumber: 40;
+    readonly site: 80;
+    readonly tickerSymbol: 20;
+    readonly sicCode: 20;
+};
+export type CrmCompanyTextField = keyof typeof CRM_COMPANY_TEXT_MAX;
+/** The most employees a company records — Salesforce's eight digits. */
+export declare const CRM_COMPANY_EMPLOYEES_MAX = 99999999;
+/** The account fields that are not picklists, as every door names them. */
+export declare const CRM_COMPANY_ACCOUNT_FIELDS: readonly ["annualRevenueCents", "currency", "numberOfEmployees", "fax", "accountNumber", "site", "tickerSymbol", "sicCode", "shippingAddress"];
+export type CrmCompanyAccountField = (typeof CRM_COMPANY_ACCOUNT_FIELDS)[number];
+/** A short text field as stored: trimmed, single-spaced. */
+export declare function normalizeCompanyText(value: unknown): string;
+/**
+ * The account fields a request names, normalized, or the refusal of each
+ * one that cannot be stored — see the block above. A value the door has
+ * already parsed from text (the drawer's revenue, a file's head count)
+ * arrives here as the number it parsed.
+ */
+export declare function readCrmCompanyAccountFields(input: Readonly<Record<string, unknown>>): {
+    values: Partial<Pick<CrmCompany, CrmCompanyAccountField>>;
+    errors: Record<string, string>;
+};
+/**
+ * The picklist fields a request names, judged against the org's lists —
+ * `lists` holds each list the caller read, and a list it did not read is
+ * judged as the standard values alone. `current` is the record as stored:
+ * its value is kept even when the list no longer offers it, which is how
+ * a company whose industry was typed before Industry became a picklist
+ * keeps it. On a create (`created`), a field not named starts from its
+ * list's default when the org set one.
+ */
+export declare function judgeCrmCompanyPicklists(lists: Readonly<Partial<Record<CrmPicklistId, CrmPicklist>>>, requested: Readonly<Partial<Record<string, unknown>>>, options?: {
+    current?: Readonly<Partial<Record<string, unknown>>>;
+    created?: boolean;
+}): {
+    values: Partial<Record<CrmCompanyPicklistField, string | null>>;
+    errors: Record<string, string>;
+};
+/** How deep a chain of parent companies may run. */
+export declare const CRM_COMPANY_PARENT_DEPTH_MAX = 25;
+/**
+ * What a parent lookup answers for one company id: its own parent, or
+ * `null` when there is no such company the writer may see.
+ */
+export type CrmCompanyParentReader = (companyId: string) => Promise<{
+    parentCompanyId: string | null;
+} | null>;
+/**
+ * Why `parentId` cannot be the parent of `companyId` (`null` for a company
+ * not yet created), or `null` when it can: a company is never its own
+ * parent, the parent must be a company the writer can see, and a company
+ * already UNDER this one cannot be put above it — the cycle Salesforce
+ * refuses too. Walks up from the parent through `read`, at most
+ * {@link CRM_COMPANY_PARENT_DEPTH_MAX} steps.
+ */
+export declare function crmCompanyParentRefusal(companyId: string | null, parentId: string, read: CrmCompanyParentReader): Promise<string | null>;
+/** A stored parent id as a reader takes it, `null` for none. */
+export declare function crmCompanyParentId(value: unknown): string | null;
 /**
  * Mailbox domains that belong to people rather than to a business: the
  * providers anybody can sign up with, and the ones an internet provider
@@ -1401,6 +1680,12 @@ export declare function isCrmLeadStatus(value: unknown): value is CrmLeadStatus;
  */
 export interface CrmLeadFields extends CrmLeadProfile {
     status?: CrmLeadStatus;
+    /**
+     * Which of the org's Lead status values of `status`'s meaning the lead
+     * holds (AGL-3512); absent, the lead shows its meaning's default label —
+     * see `crmLeadStatusLabel`.
+     */
+    statusLabel?: string;
     /** The team member working the lead. */
     ownerUid?: string;
     notes?: string;
@@ -1463,9 +1748,39 @@ export interface CrmLeadProfile {
      * of the org's lead source values (see {@link CrmPicklist}).
      */
     leadSource?: string;
+    /** One of the org's salutation values, by label (`Mr.`, `Dr.` …) — the contact's list. */
+    salutation?: string;
+    /**
+     * The person's given and family names. While either is set, the lead's
+     * `name` is their composition ({@link crmLeadComposedName}), so the name
+     * the list shows and searches is the person the structured fields name. A
+     * lead holding only `name` keeps it as captured: nothing splits a stored
+     * name into parts after the fact.
+     */
+    firstName?: string;
+    lastName?: string;
+    /** E.164, like {@link phone}. */
+    mobilePhone?: string;
+    /** E.164. */
+    fax?: string;
+    /** A label of the `industry` picklist — the list companies keep (AGL-3514). */
+    industry?: string;
+    /** A label of the `rating` picklist — the list companies keep. */
+    rating?: string;
+    /** Annual revenue in the minor unit of {@link currency}, the company's convention. */
+    annualRevenueCents?: number;
+    /** Lowercase ISO 4217 of the revenue; `'usd'` when absent. */
+    currency?: string;
+    numberOfEmployees?: number;
+    /**
+     * The person asked not to be phoned. Stored only as `true`; absent is
+     * "may be called". A hint beside every number and on the Call button,
+     * never a block — the contact's rule.
+     */
+    doNotCall?: boolean;
 }
 /** The profile's keys, in the order a card lists them. */
-export declare const CRM_LEAD_PROFILE_KEYS: readonly ["company", "jobTitle", "phone", "website", "address", "tags", "leadSource"];
+export declare const CRM_LEAD_PROFILE_KEYS: readonly ["salutation", "firstName", "lastName", "company", "jobTitle", "phone", "mobilePhone", "fax", "doNotCall", "website", "address", "tags", "leadSource", "industry", "rating", "annualRevenueCents", "currency", "numberOfEmployees"];
 export type CrmLeadProfileKey = (typeof CRM_LEAD_PROFILE_KEYS)[number];
 /**
  * A profile as a writer receives it: a key present is a value to store, a
@@ -1502,103 +1817,884 @@ export declare function normalizeCrmLeadProfile(input: Record<string, unknown> |
     patch: CrmLeadProfilePatch;
     errors: CrmLeadProfileErrors;
 };
-/** The picklists an org keeps, by document id — one per standard field. */
-export declare const CRM_PICKLIST_IDS: readonly ["leadSource"];
-export type CrmPicklistId = (typeof CRM_PICKLIST_IDS)[number];
+/**
+ * The `name` a write must store beside a lead's first and last names
+ * (AGL-3513), the contact's rule: while either part is set the name is
+ * their composition, written whenever either moves. `undefined` when the
+ * write names neither part, or when it leaves both blank — a name-only
+ * lead keeps its name, and clearing both parts leaves the name as it
+ * stands.
+ */
+export declare function crmLeadComposedName(stored: Readonly<Record<string, unknown>> | null | undefined, patch: Readonly<Pick<CrmLeadProfilePatch, 'firstName' | 'lastName'>>): string | undefined;
+/**
+ * Each lead picklist field beside the lead source (AGL-3513): the list it
+ * holds a value of, and the key the Leads list filters by. The lists are
+ * the contact's and the company's own — one Salutation, one Industry, one
+ * Rating per org — so a lead converts into the same values.
+ */
+export declare const CRM_LEAD_PICKLIST_FIELDS: readonly [{
+    readonly field: "salutation";
+    readonly picklistId: "salutation";
+}, {
+    readonly field: "industry";
+    readonly picklistId: "industry";
+    readonly keyField: "industryKey";
+}, {
+    readonly field: "rating";
+    readonly picklistId: "rating";
+    readonly keyField: "ratingKey";
+}];
+export type CrmLeadPicklistField = (typeof CRM_LEAD_PICKLIST_FIELDS)[number]['field'];
+/**
+ * The lead picklist fields a write names, judged against the org's lists
+ * — the company's {@link judgeCrmCompanyPicklists} over the lead's fields:
+ * `lists` holds each list the caller read (a list it did not read is
+ * judged as the standard values alone), the lead's `current` value is kept
+ * even when the list no longer offers it, and on a create a field not
+ * named starts from its list's default.
+ */
+export declare function judgeCrmLeadPicklists(lists: Readonly<Partial<Record<CrmPicklistId, CrmPicklist>>>, requested: Readonly<Partial<Record<string, unknown>>>, options?: {
+    current?: Readonly<Partial<Record<string, unknown>>> | null;
+    created?: boolean;
+}): {
+    values: Partial<Record<CrmLeadPicklistField, string | null>>;
+    errors: Partial<Record<CrmLeadPicklistField, string>>;
+};
+/** The CRM objects a picklist's values are kept on. */
+export type CrmPicklistObject = CrmFieldObject | 'task';
+/**
+ * The Fields tabs, in order: every object with custom fields, then Tasks,
+ * which has standard picklists and no custom fields (AGL-3517).
+ */
+export declare const CRM_PICKLIST_OBJECTS: readonly CrmPicklistObject[];
+/** How each object reads on the Fields tabs and in a refusal. */
+export declare const CRM_PICKLIST_OBJECT_LABELS: Record<CrmPicklistObject, string>;
+export declare function isCrmPicklistObject(value: unknown): value is CrmPicklistObject;
+/**
+ * One place records hold a picklist's label. `field` is the record's own
+ * field; `keyField`, when set, is the query key written beside it
+ * ({@link crmPicklistKey}); `facet` means the label lives in each holder's
+ * facet on a contact rather than on the record itself.
+ *
+ * `arrayKey` (AGL-3521) means `field` is a LIST of objects and the label is
+ * each entry's `arrayKey` — a deal's contact roles, `{ contactId, role }`.
+ * Such a target always names a `keyField`, which is then the list of the
+ * keys its entries hold: the one array a query can find the records by.
+ */
+export interface CrmPicklistTarget {
+    object: CrmPicklistObject;
+    field: string;
+    keyField?: string;
+    facet?: true;
+    arrayKey?: string;
+}
+/** A standard picklist field of the CRM. */
+export interface CrmPicklistDefinition extends PicklistSpec {
+    /** The document id under `crmPicklists`, and the field's name in code. */
+    id: string;
+    /** The field's name in a sentence's subject: "Lead source must be one of: …". */
+    label: string;
+    /** The values in a sentence: "no active lead sources". */
+    plural: string;
+    /** The Fields tab its values are managed on. */
+    object: CrmPicklistObject;
+    /** Every place records hold its label — what a rename and a delete rewrite. */
+    targets: readonly CrmPicklistTarget[];
+    /** How each of `meanings` reads on screen — the Fields page's Means column (AGL-3512). */
+    meaningLabels?: Readonly<Record<string, string>>;
+    /**
+     * Meanings only the platform sets, which an org-added value may not take
+     * (AGL-3512): a lead is Qualified by its conversion alone.
+     */
+    reservedMeanings?: readonly string[];
+}
+/** Every standard picklist field the CRM keeps, one document each. */
+export declare const CRM_PICKLIST_DEFINITIONS: readonly [{
+    readonly id: "leadSource";
+    readonly label: "Lead source";
+    readonly plural: "lead sources";
+    readonly object: "lead";
+    readonly restricted: true;
+    readonly groups: readonly [{
+        readonly id: "inbound";
+        readonly label: "Inbound";
+    }, {
+        readonly id: "outbound";
+        readonly label: "Outbound";
+    }];
+    readonly standardValues: readonly [{
+        readonly id: "web";
+        readonly label: "Web";
+        readonly group: "inbound";
+    }, {
+        readonly id: "phone-inquiry";
+        readonly label: "Phone inquiry";
+        readonly group: "inbound";
+    }, {
+        readonly id: "email-inquiry";
+        readonly label: "Email inquiry";
+        readonly group: "inbound";
+    }, {
+        readonly id: "partner-referral";
+        readonly label: "Partner referral";
+        readonly group: "inbound";
+    }, {
+        readonly id: "employee-referral";
+        readonly label: "Employee referral";
+        readonly group: "inbound";
+    }, {
+        readonly id: "external-referral";
+        readonly label: "External referral";
+        readonly group: "inbound";
+    }, {
+        readonly id: "advertisement";
+        readonly label: "Advertisement";
+        readonly group: "inbound";
+    }, {
+        readonly id: "trade-show";
+        readonly label: "Trade show";
+        readonly group: "inbound";
+    }, {
+        readonly id: "webinar";
+        readonly label: "Webinar";
+        readonly group: "inbound";
+    }, {
+        readonly id: "word-of-mouth";
+        readonly label: "Word of mouth";
+        readonly group: "inbound";
+    }, {
+        readonly id: "website-form";
+        readonly label: "Website form";
+        readonly group: "inbound";
+    }, {
+        readonly id: "booking";
+        readonly label: "Booking";
+        readonly group: "inbound";
+    }, {
+        readonly id: "newsletter-sign-up";
+        readonly label: "Newsletter sign-up";
+        readonly group: "inbound";
+    }, {
+        readonly id: "site-member-sign-up";
+        readonly label: "Site member sign-up";
+        readonly group: "inbound";
+    }, {
+        readonly id: "online-purchase";
+        readonly label: "Online purchase";
+        readonly group: "inbound";
+    }, {
+        readonly id: "account-sign-up";
+        readonly label: "Account sign-up";
+        readonly group: "inbound";
+    }, {
+        readonly id: "purchased-list";
+        readonly label: "Purchased list";
+        readonly group: "outbound";
+    }, {
+        readonly id: "sequence";
+        readonly label: "Sequence";
+        readonly group: "outbound";
+    }, {
+        readonly id: "email-campaign";
+        readonly label: "Email campaign";
+        readonly group: "outbound";
+    }, {
+        readonly id: "other";
+        readonly label: "Other";
+    }];
+    readonly targets: readonly [{
+        readonly object: "lead";
+        readonly field: "leadSource";
+        readonly keyField: "leadSourceKey";
+    }, {
+        readonly object: "contact";
+        readonly field: "leadSource";
+        readonly facet: true;
+    }, {
+        readonly object: "company";
+        readonly field: "accountSource";
+        readonly keyField: "accountSourceKey";
+    }, {
+        readonly object: "deal";
+        readonly field: "leadSource";
+        readonly keyField: "leadSourceKey";
+    }];
+}, {
+    readonly id: "leadStatus";
+    readonly label: "Lead status";
+    readonly plural: "lead statuses";
+    readonly object: "lead";
+    readonly restricted: true;
+    readonly meanings: readonly ["new", "nurturing", "working", "qualified", "unqualified"];
+    readonly meaningLabels: Record<"new" | "nurturing" | "working" | "qualified" | "unqualified", string>;
+    readonly reservedMeanings: readonly ["qualified"];
+    readonly standardValues: readonly [{
+        readonly id: "new";
+        readonly label: string;
+        readonly meaning: "new";
+    }, {
+        readonly id: "nurturing";
+        readonly label: string;
+        readonly meaning: "nurturing";
+    }, {
+        readonly id: "working";
+        readonly label: string;
+        readonly meaning: "working";
+    }, {
+        readonly id: "qualified";
+        readonly label: string;
+        readonly meaning: "qualified";
+    }, {
+        readonly id: "unqualified";
+        readonly label: string;
+        readonly meaning: "unqualified";
+    }];
+    readonly targets: readonly [{
+        readonly object: "lead";
+        readonly field: "statusLabel";
+    }];
+}, {
+    readonly id: "accountType";
+    readonly label: "Type";
+    readonly plural: "account types";
+    readonly object: "company";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "analyst";
+        readonly label: "Analyst";
+    }, {
+        readonly id: "press";
+        readonly label: "Press";
+    }, {
+        readonly id: "competitor";
+        readonly label: "Competitor";
+    }, {
+        readonly id: "prospect";
+        readonly label: "Prospect";
+    }, {
+        readonly id: "customer";
+        readonly label: "Customer";
+    }, {
+        readonly id: "reseller";
+        readonly label: "Reseller";
+    }, {
+        readonly id: "integrator";
+        readonly label: "Integrator";
+    }, {
+        readonly id: "investor";
+        readonly label: "Investor";
+    }, {
+        readonly id: "partner";
+        readonly label: "Partner";
+    }, {
+        readonly id: "consulting";
+        readonly label: "Consulting";
+    }, {
+        readonly id: "other";
+        readonly label: "Other";
+    }];
+    readonly targets: readonly [{
+        readonly object: "company";
+        readonly field: "type";
+        readonly keyField: "typeKey";
+    }];
+}, {
+    readonly id: "industry";
+    readonly label: "Industry";
+    readonly plural: "industries";
+    readonly object: "company";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "agriculture";
+        readonly label: "Agriculture";
+    }, {
+        readonly id: "apparel";
+        readonly label: "Apparel";
+    }, {
+        readonly id: "banking";
+        readonly label: "Banking";
+    }, {
+        readonly id: "biotechnology";
+        readonly label: "Biotechnology";
+    }, {
+        readonly id: "chemicals";
+        readonly label: "Chemicals";
+    }, {
+        readonly id: "communications";
+        readonly label: "Communications";
+    }, {
+        readonly id: "construction";
+        readonly label: "Construction";
+    }, {
+        readonly id: "consulting";
+        readonly label: "Consulting";
+    }, {
+        readonly id: "education";
+        readonly label: "Education";
+    }, {
+        readonly id: "electronics";
+        readonly label: "Electronics";
+    }, {
+        readonly id: "energy";
+        readonly label: "Energy";
+    }, {
+        readonly id: "engineering";
+        readonly label: "Engineering";
+    }, {
+        readonly id: "entertainment";
+        readonly label: "Entertainment";
+    }, {
+        readonly id: "environmental";
+        readonly label: "Environmental";
+    }, {
+        readonly id: "finance";
+        readonly label: "Finance";
+    }, {
+        readonly id: "food-and-beverage";
+        readonly label: "Food & Beverage";
+    }, {
+        readonly id: "government";
+        readonly label: "Government";
+    }, {
+        readonly id: "healthcare";
+        readonly label: "Healthcare";
+    }, {
+        readonly id: "hospitality";
+        readonly label: "Hospitality";
+    }, {
+        readonly id: "insurance";
+        readonly label: "Insurance";
+    }, {
+        readonly id: "machinery";
+        readonly label: "Machinery";
+    }, {
+        readonly id: "manufacturing";
+        readonly label: "Manufacturing";
+    }, {
+        readonly id: "media";
+        readonly label: "Media";
+    }, {
+        readonly id: "not-for-profit";
+        readonly label: "Not For Profit";
+    }, {
+        readonly id: "recreation";
+        readonly label: "Recreation";
+    }, {
+        readonly id: "retail";
+        readonly label: "Retail";
+    }, {
+        readonly id: "shipping";
+        readonly label: "Shipping";
+    }, {
+        readonly id: "technology";
+        readonly label: "Technology";
+    }, {
+        readonly id: "telecommunications";
+        readonly label: "Telecommunications";
+    }, {
+        readonly id: "transportation";
+        readonly label: "Transportation";
+    }, {
+        readonly id: "utilities";
+        readonly label: "Utilities";
+    }, {
+        readonly id: "other";
+        readonly label: "Other";
+    }];
+    readonly targets: readonly [{
+        readonly object: "company";
+        readonly field: "industry";
+        readonly keyField: "industryKey";
+    }, {
+        readonly object: "lead";
+        readonly field: "industry";
+        readonly keyField: "industryKey";
+    }];
+}, {
+    readonly id: "rating";
+    readonly label: "Rating";
+    readonly plural: "ratings";
+    readonly object: "company";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "hot";
+        readonly label: "Hot";
+    }, {
+        readonly id: "warm";
+        readonly label: "Warm";
+    }, {
+        readonly id: "cold";
+        readonly label: "Cold";
+    }];
+    readonly targets: readonly [{
+        readonly object: "company";
+        readonly field: "rating";
+        readonly keyField: "ratingKey";
+    }, {
+        readonly object: "lead";
+        readonly field: "rating";
+        readonly keyField: "ratingKey";
+    }];
+}, {
+    readonly id: "ownership";
+    readonly label: "Ownership";
+    readonly plural: "ownership values";
+    readonly object: "company";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "public";
+        readonly label: "Public";
+    }, {
+        readonly id: "private";
+        readonly label: "Private";
+    }, {
+        readonly id: "subsidiary";
+        readonly label: "Subsidiary";
+    }, {
+        readonly id: "other";
+        readonly label: "Other";
+    }];
+    readonly targets: readonly [{
+        readonly object: "company";
+        readonly field: "ownership";
+    }];
+}, {
+    readonly id: "salutation";
+    readonly label: "Salutation";
+    readonly plural: "salutations";
+    readonly object: "contact";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "mr";
+        readonly label: "Mr.";
+    }, {
+        readonly id: "ms";
+        readonly label: "Ms.";
+    }, {
+        readonly id: "mrs";
+        readonly label: "Mrs.";
+    }, {
+        readonly id: "dr";
+        readonly label: "Dr.";
+    }, {
+        readonly id: "prof";
+        readonly label: "Prof.";
+    }];
+    readonly targets: readonly [{
+        readonly object: "contact";
+        readonly field: "salutation";
+        readonly facet: true;
+    }, {
+        readonly object: "lead";
+        readonly field: "salutation";
+    }];
+}, {
+    readonly id: "opportunityType";
+    readonly label: "Type";
+    readonly plural: "deal types";
+    readonly object: "deal";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "existing-business";
+        readonly label: "Existing Business";
+    }, {
+        readonly id: "new-business";
+        readonly label: "New Business";
+    }];
+    readonly targets: readonly [{
+        readonly object: "deal";
+        readonly field: "type";
+        readonly keyField: "typeKey";
+    }];
+}, {
+    readonly id: "opportunityContactRole";
+    readonly label: "Contact role";
+    readonly plural: "contact roles";
+    readonly object: "deal";
+    readonly restricted: true;
+    readonly standardValues: readonly [{
+        readonly id: "business-user";
+        readonly label: "Business User";
+    }, {
+        readonly id: "decision-maker";
+        readonly label: "Decision Maker";
+    }, {
+        readonly id: "economic-buyer";
+        readonly label: "Economic Buyer";
+    }, {
+        readonly id: "economic-decision-maker";
+        readonly label: "Economic Decision Maker";
+    }, {
+        readonly id: "evaluator";
+        readonly label: "Evaluator";
+    }, {
+        readonly id: "executive-sponsor";
+        readonly label: "Executive Sponsor";
+    }, {
+        readonly id: "influencer";
+        readonly label: "Influencer";
+    }, {
+        readonly id: "technical-buyer";
+        readonly label: "Technical Buyer";
+    }, {
+        readonly id: "other";
+        readonly label: "Other";
+    }];
+    readonly targets: readonly [{
+        readonly object: "deal";
+        readonly field: "contactRoles";
+        readonly arrayKey: "role";
+        readonly keyField: "contactRoleKeys";
+    }];
+}, {
+    readonly id: "taskStatus";
+    readonly label: "Status";
+    readonly plural: "task statuses";
+    readonly object: "task";
+    readonly restricted: true;
+    readonly meanings: readonly ["open", "done"];
+    readonly standardValues: readonly [{
+        readonly id: "not-started";
+        readonly label: "Not Started";
+        readonly meaning: "open";
+    }, {
+        readonly id: "in-progress";
+        readonly label: "In Progress";
+        readonly meaning: "open";
+    }, {
+        readonly id: "waiting";
+        readonly label: "Waiting on someone else";
+        readonly meaning: "open";
+    }, {
+        readonly id: "deferred";
+        readonly label: "Deferred";
+        readonly meaning: "open";
+    }, {
+        readonly id: "completed";
+        readonly label: "Completed";
+        readonly meaning: "done";
+    }];
+    readonly defaultValueId: "not-started";
+    readonly targets: readonly [{
+        readonly object: "task";
+        readonly field: "statusLabel";
+    }];
+}, {
+    readonly id: "taskPriority";
+    readonly label: "Priority";
+    readonly plural: "task priorities";
+    readonly object: "task";
+    readonly restricted: true;
+    readonly meanings: readonly ["low", "normal", "high"];
+    readonly standardValues: readonly [{
+        readonly id: "high";
+        readonly label: "High";
+        readonly meaning: "high";
+    }, {
+        readonly id: "normal";
+        readonly label: "Normal";
+        readonly meaning: "normal";
+    }, {
+        readonly id: "low";
+        readonly label: "Low";
+        readonly meaning: "low";
+    }];
+    readonly defaultValueId: "normal";
+    readonly targets: readonly [{
+        readonly object: "task";
+        readonly field: "priorityLabel";
+    }];
+}, {
+    readonly id: "taskType";
+    readonly label: "Type";
+    readonly plural: "task types";
+    readonly object: "task";
+    readonly restricted: true;
+    readonly meanings: readonly ["call", "email", "meeting", "todo"];
+    readonly standardValues: readonly [{
+        readonly id: "call";
+        readonly label: "Call";
+        readonly meaning: "call";
+    }, {
+        readonly id: "email";
+        readonly label: "Email";
+        readonly meaning: "email";
+    }, {
+        readonly id: "meeting";
+        readonly label: "Meeting";
+        readonly meaning: "meeting";
+    }, {
+        readonly id: "todo";
+        readonly label: "To-do";
+        readonly meaning: "todo";
+    }];
+    readonly defaultValueId: "todo";
+    readonly targets: readonly [{
+        readonly object: "task";
+        readonly field: "typeLabel";
+    }];
+}, {
+    readonly id: "taskSubject";
+    readonly label: "Subject";
+    readonly plural: "task subjects";
+    readonly object: "task";
+    readonly restricted: false;
+    readonly standardValues: readonly [{
+        readonly id: "call";
+        readonly label: "Call";
+    }, {
+        readonly id: "send-letter";
+        readonly label: "Send Letter";
+    }, {
+        readonly id: "send-quote";
+        readonly label: "Send Quote";
+    }, {
+        readonly id: "other";
+        readonly label: "Other";
+    }];
+    readonly targets: readonly [];
+}];
+export type CrmPicklistId = (typeof CRM_PICKLIST_DEFINITIONS)[number]['id'];
+/** The picklists an org keeps, by document id. */
+export declare const CRM_PICKLIST_IDS: readonly CrmPicklistId[];
 /** The lead source value set's document id. */
 export declare const CRM_LEAD_SOURCE_PICKLIST: CrmPicklistId;
+/** The salutation value set's document id (AGL-3515). */
+export declare const CRM_SALUTATION_PICKLIST: CrmPicklistId;
+/** A deal's Type value set's document id (AGL-3516). */
+export declare const CRM_OPPORTUNITY_TYPE_PICKLIST: CrmPicklistId;
+/** A deal contact's role value set's document id (AGL-3521). */
+export declare const CRM_OPPORTUNITY_CONTACT_ROLE_PICKLIST: CrmPicklistId;
+/**
+ * The built-in Lead source value each first-party door stamps (AGL-3519), by
+ * the door's word for how it met a person — a capture's source, or the
+ * outreach that reached them. `api`, `import` and `manual` are ways a record
+ * was ADDED, not where a person came from, and stamp nothing.
+ */
+export declare const CRM_LEAD_SOURCE_ORIGINS: Readonly<Record<string, string>>;
+export declare function isCrmPicklistId(value: unknown): value is CrmPicklistId;
+/** The definition an id names, or `null` for one the registry does not hold. */
+export declare function crmPicklistDefinition(id: unknown): CrmPicklistDefinition | null;
+/** The definitions whose values are managed on one Fields tab, in registry order. */
+export declare function crmPicklistDefinitionsFor(object: CrmPicklistObject): CrmPicklistDefinition[];
 /** The most values one picklist holds — a menu, not a table. */
 export declare const CRM_PICKLIST_VALUES_MAX = 200;
 /** One value of a picklist. `id` never changes; `label` is what records store. */
-export interface CrmPicklistValue {
-    id: string;
-    label: string;
-    active: boolean;
-}
+export type CrmPicklistValue = PicklistValue;
 /** A picklist as stored and as every reader takes it. */
-export interface CrmPicklist {
-    /** In the order every picker lists them. */
-    values: CrmPicklistValue[];
-    /** The value a new record starts with, by id — `null` for none. */
-    defaultValueId: string | null;
-}
+export type CrmPicklist = PicklistValueSet;
+/** One option of a picklist select. */
+export type CrmPicklistOption = PicklistOption;
 /**
- * The values an org that has never edited its list reads — see the block
- * header. Salesforce's own standard set, trimmed to what a small team
- * recognizes.
+ * The values an org without a lead source document offered before the
+ * standard set was built in. "Referral" and "Partner" are not standard: a
+ * record holding one, in an org that never stored its list, reads as not in
+ * the list until the value is written down as the org's own.
  */
 export declare const CRM_LEAD_SOURCE_STARTER_LABELS: readonly string[];
 /** A label as a picklist stores it: trimmed, single-spaced, capped. */
-export declare function normalizeCrmPicklistLabel(value: unknown): string;
-/**
- * A new value's id: the label as a slug, suffixed until it is not one of
- * `taken`. Derived rather than random so a seeded list reads the same in
- * every org, and never reused, because a default names a value by it.
- */
-export declare function crmPicklistValueId(label: string, taken: Iterable<string>): string;
+export declare const normalizeCrmPicklistLabel: typeof normalizePicklistLabel;
+/** A new value's id — see `mintPicklistValueId`. */
+export declare const crmPicklistValueId: typeof mintPicklistValueId;
 /** A picklist of active values from labels, in order, with no default. */
-export declare function crmPicklistFromLabels(labels: readonly string[]): CrmPicklist;
+export declare const crmPicklistFromLabels: typeof picklistFromLabels;
 /**
- * A stored document as a picklist, or `null` for one that holds none.
- *
- * Tolerant, because the document is client-written: a value with no label
- * is dropped, a second value with the same label (in any case) or the same
- * id is dropped, `active` is true unless it is `false`, and a default that
- * names no value is no default.
+ * A stored document as a picklist, or `null` for one that holds none —
+ * tolerant, as `normalizePicklistValueSet` reads it, and without the
+ * standard values merged in. {@link effectiveCrmPicklist} is what a reader
+ * judges against.
  */
 export declare function normalizeCrmPicklist(raw: unknown): CrmPicklist | null;
-/** The org's lead source list as every reader should take it — see the block header. */
+/** An org's list for one picklist as every reader should take it — see the block header. */
+export declare function effectiveCrmPicklist(id: CrmPicklistId, raw: unknown): CrmPicklist;
+/** The org's lead source list as every reader should take it. */
 export declare function effectiveCrmLeadSourcePicklist(raw: unknown): CrmPicklist;
+/**
+ * The label a door stamps for `origin` (AGL-3519): its built-in value as the
+ * org spells it, while that value is ACTIVE — an org that deactivated it has
+ * said not to file people under it — else `null`, as for a word with none.
+ */
+export declare function crmLeadSourceForOrigin(picklist: CrmPicklist, origin: unknown): string | null;
+/** Whether a value is one of a picklist's standard values — computed from its id, never stored. */
+export declare function isStandardCrmPicklistValue(id: CrmPicklistId, valueId: string): boolean;
 /** The value a label names, in any case or spacing — `null` for none. */
-export declare function crmPicklistValueByLabel(picklist: CrmPicklist, label: unknown): CrmPicklistValue | null;
+export declare const crmPicklistValueByLabel: typeof picklistValueByLabel;
 /** The values a picker offers. */
-export declare function crmPicklistActiveValues(picklist: CrmPicklist): CrmPicklistValue[];
+export declare const crmPicklistActiveValues: typeof picklistActiveValues;
 /** The label a new record starts with — only while the default value is active. */
-export declare function crmPicklistDefaultLabel(picklist: CrmPicklist): string | null;
+export declare const crmPicklistDefaultLabel: typeof picklistDefaultLabel;
 /**
- * The sentence a lead source outside the list is refused with, naming what
- * the list allows. A long list is cut at twenty names so the sentence stays
- * one a person can read.
+ * The sentence a value outside a restricted picklist is refused with,
+ * naming what the list allows, and where to add one when it allows none.
  */
+export declare function crmPicklistRefusal(id: CrmPicklistId, picklist: CrmPicklist): string;
+/** The sentence a lead source outside the list is refused with. */
 export declare function crmLeadSourceRefusal(picklist: CrmPicklist): string;
 /**
- * Whether a write may store `value` as a record's lead source, and the
- * label it stores.
- *
- *  - Blank or `null` clears the field — lead source is never required.
- *  - An ACTIVE value, in any case or spacing, stores that value's label.
- *  - The record's `current` value is kept even when it is inactive or no
- *    longer listed: re-saving a record must never be refused for a value
- *    somebody else deactivated.
- *  - Anything else is refused with {@link crmLeadSourceRefusal}.
+ * Whether a write may store `value` as a record's value of picklist `id`,
+ * and the label it stores — `judgePicklistValue` under the definition's
+ * restriction: blank clears, an active value stores the list's spelling,
+ * the record's `current` value is always kept, and on a restricted
+ * picklist anything else is refused with {@link crmPicklistRefusal}.
+ */
+export declare function judgeCrmPicklistValue(id: CrmPicklistId, picklist: CrmPicklist, value: unknown, current?: unknown): PicklistJudgement;
+/**
+ * A deal's contact roles with each role judged against the org's
+ * `opportunityContactRole` list (AGL-3521): an active value stored as the
+ * list spells it, a blank cleared, and the role a contact already holds on
+ * the deal (`current`) kept — or the first refusal, naming what the list
+ * allows.
  */
-export declare function judgeCrmLeadSource(picklist: CrmPicklist, value: unknown, current?: unknown): {
+export declare function judgeDealContactRoles(picklist: CrmPicklist, roles: readonly CrmDealContactRole[], current?: readonly CrmDealContactRole[]): {
     ok: true;
-    value: string | null;
+    roles: CrmDealContactRole[];
 } | {
     ok: false;
     error: string;
 };
-/** One option of a lead source select. */
-export interface CrmPicklistOption {
-    label: string;
-    /** Listed but deactivated — shown with an "(inactive)" hint. */
-    inactive: boolean;
-    /** Not in the list at all — a value written before the list existed. */
-    unlisted: boolean;
-}
+/** {@link judgeCrmPicklistValue} for the lead source. */
+export declare function judgeCrmLeadSource(picklist: CrmPicklist, value: unknown, current?: unknown): PicklistJudgement;
 /**
  * What a select offers for a record holding `current`: every active value
  * in order, then the record's own value when the list would not otherwise
  * show it, so the select keeps what the record holds until it is changed.
  */
-export declare function crmPicklistOptions(picklist: CrmPicklist, current?: unknown): CrmPicklistOption[];
+export declare const crmPicklistOptions: typeof picklistOptions;
 /**
  * Where a label sorts: its value's position in the list, unlisted values
  * after every listed one, and a record with none last. The order the admin
  * chose is the order a sort by the field reads in, as Salesforce's does.
  */
-export declare function crmPicklistRank(picklist: CrmPicklist, label: unknown): number;
+export declare const crmPicklistRank: typeof picklistRank;
+/** The lead status value set's document id. */
+export declare const CRM_LEAD_STATUS_PICKLIST: CrmPicklistId;
+/** The field a lead's status label is stored in, beside `status`. */
+export declare const CRM_LEAD_STATUS_LABEL_FIELD = "statusLabel";
+/** The org's lead status list as every reader should take it. */
+export declare function effectiveCrmLeadStatusPicklist(raw: unknown): CrmPicklist;
+/** The standard lead statuses alone — what a reader answers before the org's list is read. */
+export declare const STANDARD_CRM_LEAD_STATUS_PICKLIST: CrmPicklist;
+/**
+ * The value a lead with `status` shows when it names none of its own: the
+ * default when active and of that meaning, else the first active value of
+ * that meaning, else the first of that meaning at all.
+ */
+export declare function crmLeadStatusValueFor(picklist: CrmPicklist, status: CrmLeadStatus): CrmPicklistValue | null;
+/** The label a writer stamps beside `status` when it sets a meaning and names no value. */
+export declare function crmLeadStatusLabelFor(picklist: CrmPicklist, status: CrmLeadStatus): string;
+/**
+ * How a lead's status reads: its own `statusLabel` while that is a value of
+ * its `status`'s meaning (as the list spells it), else the meaning's label
+ * by {@link crmLeadStatusLabelFor}. A label the list no longer holds is shown
+ * as stored while nothing contradicts it — a value deleted without moving
+ * every lead off it reads as what the lead was given.
+ */
+export declare function crmLeadStatusLabel(lead: Pick<CrmLeadFields, 'status' | 'statusLabel'> | null | undefined, picklist?: CrmPicklist): string;
+/** A status write, as both fields a lead stores — or why it is refused. */
+export type CrmLeadStatusWrite = {
+    ok: true;
+    status: CrmLeadStatus;
+    statusLabel: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * What a write naming a lead status stores (AGL-3512): an ACTIVE value's
+ * label, in any case or spacing, stores its meaning and its label; one of
+ * the meanings themselves (`working`) stores that meaning and the label
+ * {@link crmLeadStatusLabelFor} gives it; the lead's `current` label is
+ * kept even when inactive. `allowed` narrows the meanings this door may
+ * set — every door but a conversion leaves Qualified out — and anything
+ * else is refused naming what the door accepts.
+ */
+export declare function resolveCrmLeadStatusWrite(picklist: CrmPicklist, requested: unknown, options?: {
+    allowed?: readonly CrmLeadStatus[];
+    current?: Pick<CrmLeadFields, 'status' | 'statusLabel'> | null;
+}): CrmLeadStatusWrite;
+/**
+ * The values a lead status select offers for a lead holding `current`:
+ * every active value whose meaning `allowed` admits, in the list's order,
+ * then the lead's own value when the list would not otherwise show it.
+ */
+export declare function crmLeadStatusOptions(picklist: CrmPicklist, allowed?: readonly CrmLeadStatus[], current?: Pick<CrmLeadFields, 'status' | 'statusLabel'> | null): Array<{
+    label: string;
+    status: CrmLeadStatus;
+    inactive: boolean;
+}>;
+/** The label a value of `meaning` reads as: the first active one, else the first at all. */
+export declare function crmPicklistMeaningLabel(picklist: CrmPicklist, meaning: unknown): string | null;
+/**
+ * What a record shows for a semantic field: its own label when it holds
+ * one, else the first active value of its meaning, else the meaning itself.
+ */
+export declare function crmPicklistShownLabel(picklist: CrmPicklist, meaning: unknown, label: unknown): string;
+/**
+ * The label a NEW record of `meaning` starts with: the list's default when
+ * it means that, else the first active value that does.
+ */
+export declare function crmPicklistLabelForNew(picklist: CrmPicklist, meaning: unknown): string | null;
+/** What a semantic write stores: the meaning and the label beside it. */
+export type CrmSemanticPicklistWrite = {
+    ok: true;
+    meaning: string;
+    label: string | null;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * A label OR a meaning, as a write names it, resolved against picklist `id`:
+ *
+ *  - an active value's label (any case or spacing) stores that value's
+ *    label and its meaning;
+ *  - the record's `current` label is kept, with its value's meaning, even
+ *    when the value has since been deactivated;
+ *  - one of the definition's meanings (`high`, `done`, `call`) stores that
+ *    meaning with the first active value's label — or the record's current
+ *    label when that already means it;
+ *  - anything else is refused naming the values the list allows.
+ *
+ * `null` answers a blank input: the caller keeps its own default.
+ */
+export declare function resolveCrmSemanticPicklistWrite(id: CrmPicklistId, picklist: CrmPicklist, input: unknown, current?: unknown): CrmSemanticPicklistWrite | null;
+/** A task's three semantic picklists, as every task surface reads them. */
+export interface CrmTaskPicklists {
+    status: CrmPicklist;
+    priority: CrmPicklist;
+    type: CrmPicklist;
+}
+/** The picklist id behind each of a task's semantic fields. */
+export declare const CRM_TASK_PICKLIST_IDS: {
+    readonly status: "taskStatus";
+    readonly priority: "taskPriority";
+    readonly type: "taskType";
+};
+/** The org's three task lists from their stored documents — standard values alone for none. */
+export declare function effectiveCrmTaskPicklists(raw?: Partial<Record<keyof CrmTaskPicklists, unknown>>): CrmTaskPicklists;
+/** What a task shows for its status, priority and type — see `crmPicklistShownLabel`. */
+export declare function crmTaskPicklistLabels(task: Partial<Pick<CrmTask, 'status' | 'statusLabel' | 'priority' | 'priorityLabel' | 'kind' | 'typeLabel'>>, picklists: CrmTaskPicklists): {
+    status: string;
+    priority: string;
+    type: string;
+};
+/**
+ * The status a tick or an untick writes: done with the first active done
+ * value's label ("Completed"), or open with the label a new task starts
+ * with ("Not Started").
+ */
+export declare function crmTaskStatusWrite(picklist: CrmPicklist, done: boolean): {
+    status: CrmTaskStatus;
+    statusLabel: string | null;
+};
+/** The labels a new task of these meanings starts with. */
+export declare function crmTaskLabelsForNew(picklists: CrmTaskPicklists, meanings: Pick<CrmTask, 'kind' | 'priority'> & {
+    status?: CrmTaskStatus;
+}): {
+    statusLabel: string | null;
+    priorityLabel: string | null;
+    typeLabel: string | null;
+};
 /** The name a lead is listed under: the name it carries, else its address. */
 export declare function crmLeadDisplayName(lead: Record<string, unknown> | null | undefined): string;
 /**
@@ -1846,6 +2942,11 @@ export declare function crmSearchFields(visibleTo: unknown, values: readonly unk
 export declare const CRM_EMAIL_STATUS_FIELD = "emailStatus";
 export declare const CRM_EMAIL_STATUS_NONE = "none";
 export declare function crmEmailStatusKey(record: Record<string, unknown> | null | undefined): string;
+/**
+ * A picklist label as a list query compares it — the key a target's
+ * `keyField` holds beside the label — `null` for none.
+ */
+export declare function crmPicklistKey(value: unknown): string | null;
 /** A lead's lead source as the list compares it: the picklist's key, `null` for none. */
 export declare const CRM_LEAD_SOURCE_KEY_FIELD = "leadSourceKey";
 export declare function crmLeadSourceKey(value: unknown): string | null;
@@ -1872,22 +2973,53 @@ export declare function crmLeadListFields(record: object): {
     status: CrmLeadStatus;
     leadSourceKey: string | null;
     emailStatus: string;
+    industryKey: string | null;
+    ratingKey: string | null;
 };
 /** What a company's search box reads: its name and its domain. */
 export declare const CRM_COMPANY_SEARCH_SOURCES: readonly ["name", "domain"];
+/**
+ * Every field the Companies list queries by: the search tokens, and the
+ * key of each picklist field that names one (AGL-3514) — `null` for none,
+ * so "no value" is a value a query can ask for.
+ */
 export declare function crmCompanyListFields(record: object): {
     searchTokens: string[];
     scopedSearchTokens: string[];
+    typeKey: string | null;
+    industryKey: string | null;
+    ratingKey: string | null;
+    accountSourceKey: string | null;
 };
 /**
  * What a deal's search box reads: its title (AGL-3315) — as word prefixes,
  * and as `titleLower`, the whole title's key, which a reader whose access
- * is some sites searches by its start.
+ * is some sites searches by its start. And the keys the Deals list filters
+ * its Type and Lead source by (AGL-3516): each label as the picklist
+ * compares it, `null` for none.
  */
 export declare function crmDealListFields(record: object): {
     searchTokens: string[];
     scopedSearchTokens: string[];
     titleLower: string;
+    typeKey: string | null;
+    leadSourceKey: string | null;
+    contactRoleContactIds: string[];
+    scopedContactRoleContactIds: string[];
+    contactRoleKeys: string[];
+};
+/**
+ * The arrays a deal's contact roles are found by (AGL-3521): every contact
+ * on it — `contactRoleContactIds`, which a contact's page asks
+ * `array-contains` at the organization level, and the same ids behind each
+ * scope token (`scopedContactRoleContactIds`, `host:x~contactId`), which it
+ * asks under a site in the one array clause a query has — and the keys of
+ * the roles they hold, which a rename of a role finds the deals by.
+ */
+export declare function crmDealContactRoleListFields(deal: Record<string, unknown>): {
+    contactRoleContactIds: string[];
+    scopedContactRoleContactIds: string[];
+    contactRoleKeys: string[];
 };
 /** What a task's search box reads: its title. */
 export declare function crmTaskListFields(record: object): {
@@ -1900,7 +3032,7 @@ export declare const CRM_FACET_KEY_ANY_GROUP = "*";
 /** The most facet keys one contact keeps. */
 export declare const CRM_FACET_KEYS_MAX = 600;
 /** The facet fields a contact list filters by, as their keys name them. */
-export type CrmFacetKeyField = 'owner' | 'stage' | 'source' | 'company' | 'tag' | 'orders' | 'ltv' | `custom.${string}`;
+export type CrmFacetKeyField = 'owner' | 'stage' | 'source' | 'company' | 'tag' | 'orders' | 'ltv' | `custom.${string}` | 'leadSource';
 /** A facet value as its key spells it, or `null` for a value a key cannot hold. */
 export declare function crmFacetKeyValue(value: unknown): string | null;
 /** One facet key: `{group}:{field}` for presence, `{group}:{field}={value}` for a value. */