@producerflow/producerflowapi 1.0.2 → 1.0.5

package/dist/producerflow/producer/v1/producer_pb.d.ts

@@ -43,11 +43,19 @@ export declare const PaginationSchema: GenMessage<Pagination>;
  */
 export type Address = Message<"producerflow.producer.v1.Address"> & {
     /**
-     * Street address including house/building number and street name
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: string street = 1;
+     * @generated from field: string street = 1 [deprecated = true];
+     * @deprecated
      */
     street: string;
+    /**
+     * Primary address line including house/building number and street name.
+     * For backward compatibility, either street or address_line_1 can be used.
+     *
+     * @generated from field: string address_line_1 = 7;
+     */
+    addressLine1: string;
     /**
      * City of the address
      *
@@ -73,11 +81,11 @@ export type Address = Message<"producerflow.producer.v1.Address"> & {
      */
     county: string;
     /**
-     * Optional second line of street address (apt, suite, unit, etc.)
+     * Optional second line of address (apt, suite, unit, etc.)
      *
-     * @generated from field: optional string street_line_2 = 6;
+     * @generated from field: optional string address_line_2 = 6;
      */
-    streetLine2?: string;
+    addressLine2?: string;
 };
 /**
  * Describes the message producerflow.producer.v1.Address.
@@ -85,7 +93,13 @@ export type Address = Message<"producerflow.producer.v1.Address"> & {
  */
 export declare const AddressSchema: GenMessage<Address>;
 /**
- * CreateAgencyOnboardingURLRequest contains information needed to generate an agency onboarding URL. This includes basic agency information and defaults. All fields in this request are optional. You can provide as much or as little information as you have available. Any missing information will be collected from the user during the onboarding process through the generated URL.
+ * CreateAgencyOnboardingURLRequest contains information needed to generate
+ * an agency onboarding URL. This includes basic agency information and
+ * defaults.
+ *
+ * All fields in this request are optional. You can provide as much or as little
+ * information as you have available. Any missing information will be collected
+ * from the user during the onboarding process through the generated URL.
  *
  * @generated from message producerflow.producer.v1.CreateAgencyOnboardingURLRequest
  */
@@ -359,7 +373,10 @@ export declare const ProducerDataSchema: GenMessage<ProducerData>;
  */
 export type ProducerData_Address = Message<"producerflow.producer.v1.ProducerData.Address"> & {
     /**
-     * @generated from field: string street = 1;
+     * Deprecated: Use address_line_1 instead.
+     *
+     * @generated from field: string street = 1 [deprecated = true];
+     * @deprecated
      */
     street: string;
     /**
@@ -378,6 +395,16 @@ export type ProducerData_Address = Message<"producerflow.producer.v1.ProducerDat
      * @generated from field: string country = 5;
      */
     country: string;
+    /**
+     * @generated from field: optional string address_line_2 = 6;
+     */
+    addressLine2?: string;
+    /**
+     * Primary address line including house/building number and street name
+     *
+     * @generated from field: string address_line_1 = 7;
+     */
+    addressLine1: string;
 };
 /**
  * Describes the message producerflow.producer.v1.ProducerData.Address.
@@ -640,6 +667,13 @@ export type NewAgencyRequest_Agency_Principal = Message<"producerflow.producer.v
     tenantAdditionalQuestions: {
         [key: string]: string;
     };
+    /**
+     * The mailing address of the principal.
+     * This is where correspondence for the principal will be sent.
+     *
+     * @generated from field: producerflow.producer.v1.Address mailing_address = 9;
+     */
+    mailingAddress?: Address;
 };
 /**
  * Describes the message producerflow.producer.v1.NewAgencyRequest.Agency.Principal.
@@ -1230,12 +1264,26 @@ export type UpdateProducerRequest_Producer = Message<"producerflow.producer.v1.U
      */
     phone?: string;
     /**
-     * Street address of the producer.
-     * If provided, must be non-empty.
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: optional string street = 6;
+     * @generated from field: optional string street = 6 [deprecated = true];
+     * @deprecated
      */
     street?: string;
+    /**
+     * Primary address line of the producer.
+     * If provided, must be non-empty.
+     *
+     * @generated from field: optional string address_line_1 = 14;
+     */
+    addressLine1?: string;
+    /**
+     * Second line of the address (apartment, suite, unit, etc.).
+     * If provided, must be non-empty.
+     *
+     * @generated from field: optional string address_line_2 = 13;
+     */
+    addressLine2?: string;
     /**
      * City of the producer.
      * If provided, must be non-empty.
@@ -1408,10 +1456,10 @@ export declare const UpdateAgencyRequest_AgencySchema: GenMessage<UpdateAgencyRe
  */
 export type UpdateAgencyRequest_Agency_Address = Message<"producerflow.producer.v1.UpdateAgencyRequest.Agency.Address"> & {
     /**
-     * Street address including house/building number and street name.
-     * If provided, must be non-empty.
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: optional string street = 1;
+     * @generated from field: optional string street = 1 [deprecated = true];
+     * @deprecated
      */
     street?: string;
     /**
@@ -1435,6 +1483,20 @@ export type UpdateAgencyRequest_Agency_Address = Message<"producerflow.producer.
      * @generated from field: optional string zip = 4;
      */
     zip?: string;
+    /**
+     * Additional address line (e.g., apartment, suite, floor number).
+     * If provided, must be non-empty.
+     *
+     * @generated from field: optional string address_line_2 = 5;
+     */
+    addressLine2?: string;
+    /**
+     * Primary address line including house/building number and street name.
+     * If provided, must be non-empty.
+     *
+     * @generated from field: optional string address_line_1 = 6;
+     */
+    addressLine1?: string;
 };
 /**
  * Describes the message producerflow.producer.v1.UpdateAgencyRequest.Agency.Address.
@@ -1492,13 +1554,27 @@ export type ListNewProducersResponse = Message<"producerflow.producer.v1.ListNew
  */
 export declare const ListNewProducersResponseSchema: GenMessage<ListNewProducersResponse>;
 /**
- * Agency represents a complete agency entity with all associated information.
+ * Agency represents a complete insurance agency with all associated data.
+ *
+ * This message contains comprehensive agency information including:
+ * - Basic contact and identification details
+ * - Principal producer information
+ * - Banking details for commission payments
+ * - Business operating information
+ * - NIPR-synchronized licensing and regulatory data
+ * - Physical locations
+ *
+ * The NIPR data is automatically synchronized from the National Insurance
+ * Producer Registry and includes licenses, appointments, regulatory actions,
+ * and addresses. This data is read-only and can only be updated by triggering
+ * NIPR sync operations.
  *
  * @generated from message producerflow.producer.v1.Agency
  */
 export type Agency = Message<"producerflow.producer.v1.Agency"> & {
     /**
-     * Unique identifier for the agency.
+     * Unique identifier for the agency (UUID format).
+     * This ID is used in all API operations that reference this agency.
      *
      * @generated from field: string agency_id = 1;
      */
@@ -1711,9 +1787,10 @@ export declare const Agency_AgencyInfoSchema: GenMessage<Agency_AgencyInfo>;
  */
 export type Agency_Address = Message<"producerflow.producer.v1.Agency.Address"> & {
     /**
-     * Street name and number of the location.
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: string street = 1;
+     * @generated from field: string street = 1 [deprecated = true];
+     * @deprecated
      */
     street: string;
     /**
@@ -1734,6 +1811,18 @@ export type Agency_Address = Message<"producerflow.producer.v1.Agency.Address">
      * @generated from field: string zip = 4;
      */
     zip: string;
+    /**
+     * Primary address line including street name and number of the location.
+     *
+     * @generated from field: string address_line_1 = 5;
+     */
+    addressLine1: string;
+    /**
+     * Optional second line of address (apt, suite, unit, etc.)
+     *
+     * @generated from field: optional string address_line_2 = 6;
+     */
+    addressLine2?: string;
 };
 /**
  * Describes the message producerflow.producer.v1.Agency.Address.
@@ -2124,9 +2213,10 @@ export type Agency_NIPR_Address = Message<"producerflow.producer.v1.Agency.NIPR.
      */
     addressState: string;
     /**
-     * Street address.
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: string street = 4;
+     * @generated from field: string street = 4 [deprecated = true];
+     * @deprecated
      */
     street: string;
     /**
@@ -2159,6 +2249,12 @@ export type Agency_NIPR_Address = Message<"producerflow.producer.v1.Agency.NIPR.
      * @generated from field: google.protobuf.Timestamp updated_at = 9;
      */
     updatedAt?: Timestamp;
+    /**
+     * Primary address line.
+     *
+     * @generated from field: string address_line_1 = 10;
+     */
+    addressLine1: string;
 };
 /**
  * Describes the message producerflow.producer.v1.Agency.NIPR.Address.
@@ -2487,14 +2583,36 @@ export type Agency_NIPR_Appointment = Message<"producerflow.producer.v1.Agency.N
  */
 export declare const Agency_NIPR_AppointmentSchema: GenMessage<Agency_NIPR_Appointment>;
 /**
- * Producer represents a producer that has been onboarded.
- *
- * Internal ID of the producer.
+ * Producer represents an insurance producer (agent) with complete licensing
+ * information.
+ *
+ * This message contains comprehensive producer information including:
+ * - Basic contact details (name, email, phone, address)
+ * - Agency association
+ * - NIPR-synchronized licensing data (licenses, appointments, regulatory actions)
+ * - Location assignments within the agency
+ *
+ * NIPR Data Synchronization:
+ * The NIPR data is automatically fetched from the National Insurance Producer
+ * Registry when the producer is created (if sync_with_nipr is enabled) and can
+ * be refreshed by:
+ * - Calling SyncProducerWithNIPR manually
+ * - Automatic daily updates via PDB Alerts (if pdb_alerts_sync_enabled is true)
+ *
+ * Use Cases:
+ * - Verify producer licenses before selling insurance products
+ * - Check Lines of Authority (LOAs) to ensure producers can sell specific product types
+ * - Monitor license expiration dates for compliance
+ * - Track carrier appointments to know which companies the producer can represent
+ * - Review regulatory history before hiring or contracting
  *
  * @generated from message producerflow.producer.v1.Producer
  */
 export type Producer = Message<"producerflow.producer.v1.Producer"> & {
     /**
+     * Unique identifier for the producer (UUID format).
+     * This ID is used in all API operations that reference this producer.
+     *
      * @generated from field: string id = 1;
      */
     id: string;
@@ -2540,7 +2658,8 @@ export type Producer = Message<"producerflow.producer.v1.Producer"> & {
     phone: string;
     /**
      * Indicates whether the producer is enabled to be synchronized with NIPR API.
-     * When true, the system will regularly check for updates from NIPR.
+     * When true, the system will regularly check for updates from NIPR using
+     * PDB Alerts, providing automatic daily updates at no extra cost.
      *
      * @generated from field: bool pdb_alerts_sync_enabled = 13;
      */
@@ -2676,9 +2795,18 @@ export type Producer_NIPR = Message<"producerflow.producer.v1.Producer.NIPR"> &
      */
     regulatoryInfo?: Producer_NIPR_ProducerRegulatoryInfo;
     /**
-     * List of carrier appointments held by the producer in NIPR.
-     * These represent relationships with insurance carriers that allow
-     * the producer to sell their products.
+     * List of carrier appointments held by the producer.
+     *
+     * Each appointment represents authorization to sell a specific carrier's
+     * products for a specific line of authority. A producer typically has
+     * multiple appointments across different carriers and LOAs.
+     *
+     * Before allowing a producer to quote or sell a product:
+     * 1. Verify they have an active appointment with that carrier
+     * 2. Verify the appointment's LOA matches the product type
+     * 3. Check the appointment renewal date hasn't passed
+     *
+     * This data is synchronized from NIPR and is read-only.
      *
      * @generated from field: repeated producerflow.producer.v1.Producer.NIPR.Appointment appointments = 10;
      */
@@ -2690,7 +2818,25 @@ export type Producer_NIPR = Message<"producerflow.producer.v1.Producer.NIPR"> &
  */
 export declare const Producer_NIPRSchema: GenMessage<Producer_NIPR>;
 /**
- * License contains information about a producer's insurance license.
+ * License contains information about a producer's insurance license in a
+ * specific state.
+ *
+ * Each producer can hold multiple licenses across different states. Each
+ * license includes a set of Lines of Authority (LOAs) that define what
+ * types of insurance the producer is authorized to sell.
+ *
+ * Key Concepts:
+ * - Resident License: License in the producer's home state
+ * - Non-Resident License: License in states other than the producer's home
+ *   state
+ * - Lines of Authority (LOAs): Specific insurance types the license permits
+ *   (e.g., Life, Health, Property & Casualty, Variable Contracts)
+ *
+ * Compliance Use Cases:
+ * - Verify producer is licensed in the state where they're selling
+ * - Check license hasn't expired before allowing sales
+ * - Ensure producer has the correct LOA for the product type
+ * - Monitor expiration dates to send renewal reminders
  *
  * @generated from message producerflow.producer.v1.Producer.NIPR.License
  */
@@ -2740,8 +2886,12 @@ export type Producer_NIPR_License = Message<"producerflow.producer.v1.Producer.N
      */
     updatedAt?: Timestamp;
     /**
-     * Lines of Authority associated with this license.
-     * These define what types of insurance the producer can sell in this state.
+     * Lines of Authority (LOAs) associated with this license.
+     *
+     * These define what types of insurance the producer is authorized to sell
+     * in this state. A single license typically has multiple LOAs. Always
+     * check that the producer has an active LOA matching the product type
+     * before allowing sales.
      *
      * @generated from field: repeated producerflow.producer.v1.Producer.NIPR.License.LineOfAuthority lines_of_authority = 8;
      */
@@ -2753,27 +2903,60 @@ export type Producer_NIPR_License = Message<"producerflow.producer.v1.Producer.N
  */
 export declare const Producer_NIPR_LicenseSchema: GenMessage<Producer_NIPR_License>;
 /**
- * LineOfAuthority represents a specific type of insurance coverage
- * that a producer is authorized to sell under this license.
+ * LineOfAuthority (LOA) represents a specific type of insurance that a
+ * producer is authorized to sell under this license.
+ *
+ * Each license can have multiple LOAs. For example, a license might
+ * include:
+ * - LIFE
+ * - HEALTH
+ * - ACCIDENT AND HEALTH
+ * - PROPERTY AND CASUALTY
+ * - VARIABLE LIFE AND VARIABLE ANNUITY
+ *
+ * LOA Compliance:
+ * Before allowing a producer to sell a product, verify they have an
+ * active LOA that matches the product type. For example, a producer with
+ * only a LIFE LOA cannot sell Property & Casualty insurance.
+ *
+ * LOA names are standardized by NIPR but may vary slightly between
+ * states.
  *
  * @generated from message producerflow.producer.v1.Producer.NIPR.License.LineOfAuthority
  */
 export type Producer_NIPR_License_LineOfAuthority = Message<"producerflow.producer.v1.Producer.NIPR.License.LineOfAuthority"> & {
     /**
-     * The Line of Authority description (e.g., "Life", "Property and Casualty", "Health").
-     * This is typically an uppercase string that describes the insurance type.
+     * The Line of Authority name (e.g., "LIFE", "PROPERTY AND CASUALTY",
+     * "HEALTH").
+     *
+     * Common LOA types:
+     * - LIFE: Life insurance products
+     * - HEALTH: Health insurance products
+     * - ACCIDENT AND HEALTH: Combined accident and health coverage
+     * - PROPERTY: Property insurance
+     * - CASUALTY: Casualty insurance
+     * - PROPERTY AND CASUALTY: Combined property and casualty
+     * - VARIABLE LIFE AND VARIABLE ANNUITY: Variable products requiring
+     *   securities license
+     * - PERSONAL LINES: Homeowners, auto, and personal umbrella policies
+     * - COMMERCIAL LINES: Business insurance policies
+     *
+     * This is typically an uppercase string standardized by NIPR.
      *
      * @generated from field: string loa = 1;
      */
     loa: string;
     /**
      * Whether this Line of Authority is currently active.
+     * Inactive LOAs cannot be used to sell that type of insurance.
      *
      * @generated from field: bool active = 2;
      */
     active: boolean;
     /**
-     * The date when this Line of Authority was issued.
+     * The date when this Line of Authority was first issued.
+     * This helps track how long the producer has been authorized for this
+     * insurance type.
      *
      * @generated from field: google.protobuf.Timestamp issue_date = 3;
      */
@@ -2785,7 +2968,7 @@ export type Producer_NIPR_License_LineOfAuthority = Message<"producerflow.produc
  */
 export declare const Producer_NIPR_License_LineOfAuthoritySchema: GenMessage<Producer_NIPR_License_LineOfAuthority>;
 /**
- * LicenseStatus defines the possible statuses of an insurance license.
+ * LicenseStatus defines the current state of an insurance license.
  *
  * @generated from enum producerflow.producer.v1.Producer.NIPR.License.LicenseStatus
  */
@@ -2797,20 +2980,26 @@ export declare enum Producer_NIPR_License_LicenseStatus {
      */
     UNSPECIFIED = 0,
     /**
-     * The license has expired and is no longer valid.
+     * The license has expired and is no longer valid for selling insurance.
+     * The producer must renew the license before conducting business in
+     * this state.
      *
      * @generated from enum value: LICENSE_STATUS_EXPIRED = 1;
      */
     EXPIRED = 1,
     /**
-     * License is currently active.
+     * License is currently active and in good standing.
+     * The producer can sell insurance in this state according to their
+     * LOAs.
      *
      * @generated from enum value: LICENSE_STATUS_VALID = 2;
      */
     VALID = 2,
     /**
-     * The license exists but is not in an active state.
-     * This could be due to suspension, revocation, or other reasons.
+     * The license exists but is not currently active.
+     * Reasons include: suspension, revocation, lapsed (not renewed), or
+     * voluntarily inactive. The producer cannot sell insurance in this
+     * state until the license is reinstated.
      *
      * @generated from enum value: LICENSE_STATUS_NOT_ACTIVE = 3;
      */
@@ -2983,48 +3172,88 @@ export type Producer_NIPR_ProducerRegulatoryInfo_RegulatoryAction = Message<"pro
  */
 export declare const Producer_NIPR_ProducerRegulatoryInfo_RegulatoryActionSchema: GenMessage<Producer_NIPR_ProducerRegulatoryInfo_RegulatoryAction>;
 /**
- * Appointment represents a relationship between a producer and an insurance carrier.
+ * Appointment represents a producer's authorization to sell products for a
+ * specific insurance carrier.
+ *
+ * What is an Appointment?
+ * An appointment is a formal relationship between a producer and an
+ * insurance company that grants the producer authority to sell that
+ * company's insurance products. Having a license is not enough - the
+ * producer must also be appointed by each carrier whose products they want
+ * to sell.
+ *
+ * Appointment Lifecycle:
+ * 1. Active: Producer can sell this carrier's products
+ * 2. Terminated: Appointment ended (various reasons: producer left, carrier
+ *    terminated, etc.)
+ *
+ * Use Cases:
+ * - Verify producer is appointed before allowing them to quote/sell a
+ *   carrier's products
+ * - Track which carriers each producer can represent
+ * - Monitor appointment renewal dates
+ * - Understand termination reasons for compliance and vetting
  *
  * @generated from message producerflow.producer.v1.Producer.NIPR.Appointment
  */
 export type Producer_NIPR_Appointment = Message<"producerflow.producer.v1.Producer.NIPR.Appointment"> & {
     /**
+     * Branch identifier for multi-branch agencies.
+     * This links the appointment to a specific agency branch if applicable.
+     *
      * @generated from field: string branch_id = 1;
      */
     branchId: string;
     /**
      * Name of the insurance company for this appointment.
+     * Examples: "State Farm", "Allstate", "Blue Cross Blue Shield"
      *
      * @generated from field: string company_name = 2;
      */
     companyName: string;
     /**
-     * Federal Employer Identification Number of the producer's company.
+     * Federal Employer Identification Number (FEIN) of the insurance carrier.
+     * This uniquely identifies the carrier company.
      *
      * @generated from field: string fein = 3;
      */
     fein: string;
     /**
-     * Company code for the insurance carrier.
+     * Company code: A standardized code identifying the insurance carrier.
+     * This is used in industry systems for carrier identification.
      *
      * @generated from field: string co_code = 4;
      */
     coCode: string;
     /**
-     * Line of authority for this appointment (e.g., Life, Property, Casualty).
-     * Indicates what types of insurance the producer can sell.
+     * Line of authority for this appointment.
+     *
+     * This indicates what type of insurance the producer can sell for this
+     * carrier. A producer might have multiple appointments with the same
+     * carrier for different LOAs.
+     *
+     * Examples: "LIFE", "HEALTH", "PROPERTY AND CASUALTY", "VARIABLE LIFE AND
+     * VARIABLE ANNUITY"
      *
      * @generated from field: string line_of_authority = 5;
      */
     lineOfAuthority: string;
     /**
-     * Code for the line of authority for this appointment.
+     * Code for the line of authority.
+     * A standardized code representing the LOA type.
      *
      * @generated from field: string loa_code = 6;
      */
     loaCode: string;
     /**
-     * Current status of the appointment (e.g., Active, Terminated).
+     * Current status of the appointment.
+     *
+     * Common values:
+     * - "Active": Producer can sell this carrier's products
+     * - "Terminated": Appointment has ended
+     * - "Pending": Appointment is being processed
+     *
+     * Always check status is "Active" before allowing sales.
      *
      * @generated from field: string status = 7;
      */
@@ -3032,23 +3261,35 @@ export type Producer_NIPR_Appointment = Message<"producerflow.producer.v1.Produc
     /**
      * Reason for termination if the appointment has been terminated.
      *
+     * Common termination reasons:
+     * - Producer requested termination
+     * - Carrier terminated appointment
+     * - Producer left agency
+     * - Compliance or regulatory issues
+     *
+     * This field is empty if the appointment is still active.
+     *
      * @generated from field: string termination_reason = 8;
      */
     terminationReason: string;
     /**
-     * Date associated with the current status or reason.
+     * Date when the status or termination reason became effective.
+     * For terminated appointments, this is when the termination occurred.
      *
      * @generated from field: google.protobuf.Timestamp status_reason_date = 9;
      */
     statusReasonDate?: Timestamp;
     /**
      * Date when the appointment will renew.
+     * Appointments typically renew annually. Monitor this date for upcoming
+     * renewals.
      *
      * @generated from field: google.protobuf.Timestamp appointment_renewal_date = 10;
      */
     appointmentRenewalDate?: Timestamp;
     /**
      * Additional affiliations or roles the producer has with the agency.
+     * This may include special designations or relationship details.
      *
      * @generated from field: string agency_affiliations = 11;
      */
@@ -3066,9 +3307,10 @@ export declare const Producer_NIPR_AppointmentSchema: GenMessage<Producer_NIPR_A
  */
 export type Producer_Address = Message<"producerflow.producer.v1.Producer.Address"> & {
     /**
-     * Street address of the producer.
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: string street = 1;
+     * @generated from field: string street = 1 [deprecated = true];
+     * @deprecated
      */
     street: string;
     /**
@@ -3089,6 +3331,18 @@ export type Producer_Address = Message<"producerflow.producer.v1.Producer.Addres
      * @generated from field: string zip = 4;
      */
     zip: string;
+    /**
+     * Optional second line of address (apt, suite, unit, etc.)
+     *
+     * @generated from field: optional string address_line_2 = 13;
+     */
+    addressLine2?: string;
+    /**
+     * Primary address line of the producer.
+     *
+     * @generated from field: string address_line_1 = 14;
+     */
+    addressLine1: string;
 };
 /**
  * Describes the message producerflow.producer.v1.Producer.Address.
@@ -3098,75 +3352,155 @@ export declare const Producer_AddressSchema: GenMessage<Producer_Address>;
 /**
  * NewProducer represents the data needed to create a new producer in the system.
  *
+ * This message is used by both NewProducer (single) and NewProducers (bulk) RPCs
+ * to define producer information during creation. Producers are licensed insurance
+ * professionals who can sell insurance products on behalf of carriers.
+ *
+ * Required vs Optional Fields:
+ * - Required: first_name, last_name, email
+ * - Strongly recommended: npn (for NIPR sync and validation)
+ * - Optional: All other fields
+ *
+ * NIPR Integration:
+ * If an NPN is provided, the system will validate it against NIPR's database.
+ * Depending on the sync_with_nipr setting, it may also fetch complete license,
+ * appointment, and regulatory information from NIPR.
+ *
  * @generated from message producerflow.producer.v1.NewProducer
  */
 export type NewProducer = Message<"producerflow.producer.v1.NewProducer"> & {
     /**
      * First name of the producer.
-     * Required and must be non-empty.
+     * Required field that must be non-empty.
+     * Used for identification and correspondence.
      *
      * @generated from field: string first_name = 1;
      */
     firstName: string;
     /**
      * Last name of the producer.
-     * Required and must be non-empty.
+     * Required field that must be non-empty.
+     * Used for identification and formal communications.
      *
      * @generated from field: string last_name = 2;
      */
     lastName: string;
     /**
      * Middle name of the producer.
-     * Optional.
+     * Optional field for complete name identification.
+     * Important for NIPR matching when multiple producers have similar names.
      *
      * @generated from field: string middle_name = 7;
      */
     middleName: string;
     /**
      * Email address of the producer.
-     * Required and must be a valid email format.
-     * Must be unique within the tenant.
+     * Required field with email format validation.
+     * Must be unique across all producers in the tenant.
+     * Used for:
+     * - Account notifications and communications
+     * - Password resets and authentication
+     * - Unique identifier within the system
      *
      * @generated from field: string email = 3;
      */
     email: string;
     /**
      * National Producer Number (NPN) of the producer.
+     * Optional but strongly recommended for licensed producers.
+     * This unique identifier from NAIC enables:
+     * - NIPR data synchronization (licenses, appointments, regulatory actions)
+     * - Carrier appointment verification
+     * - Compliance tracking across states
+     * If provided, must be valid in NIPR's database or creation will fail.
      *
      * @generated from field: string npn = 4;
      */
     npn: string;
     /**
      * Phone number of the producer.
-     * Optional if default value, but if provided must match the pattern of a valid phone number.
+     * Optional field for contact purposes.
+     * If provided, must match international phone number pattern.
+     * Format: Can include country code (e.g., +1 for US)
      *
      * @generated from field: string phone = 5;
      */
     phone: string;
     /**
      * Mailing address of the producer.
-     * This is where correspondence will be sent.
+     * Optional but recommended for complete producer profiles.
+     * This address is used for physical mail delivery and may differ
+     * from the agency's address.
      *
      * @generated from field: producerflow.producer.v1.NewProducer.Address mailing_address = 6;
      */
     mailingAddress?: NewProducer_Address;
     /**
-     * Optional. External identifier for the producer in the tenant's system. This field allows tenants to maintain a reference to their own internal ID for this producer, enabling bi-directional synchronization between ProducerFlow and the tenant's system. Usage: Provide this when you have an existing identifier for the producer in your system. Omit if you don't need to track a reference to your internal system. This is independent of ProducerFlow's internal IDs and the authentication tenant context. Can be used with SetExternalID RPC to update this value after creation. Common use cases: Linking to an existing CRM or AMS system producer ID. Maintaining synchronization with legacy systems. Enabling lookups from external systems back to ProducerFlow. Format: Any string identifier that is meaningful in your system (e.g., "PROD-12345", "uuid"). Validation: Maximum length of 255 characters.
+     * External identifier for the producer in the tenant's system.
+     *
+     * Optional field that enables bi-directional synchronization between ProducerFlow
+     * and your internal systems. This allows you to maintain your existing producer
+     * identifiers while leveraging ProducerFlow's capabilities.
+     *
+     * Usage Guidelines:
+     * - Provide this when you have an existing identifier for the producer
+     * - Omit if you don't need to track a reference to your internal system
+     * - Can be updated later using the SetExternalID RPC
+     * - Must be unique within your tenant for meaningful lookups
+     *
+     * Common Use Cases:
+     * - Linking to an existing CRM or AMS system producer ID
+     * - Maintaining synchronization with legacy systems
+     * - Enabling lookups from external systems back to ProducerFlow
+     * - Supporting data migration and system transitions
+     *
+     * Format: Any string identifier meaningful in your system (e.g., "PROD-12345", UUID)
+     * Maximum length: 255 characters
      *
      * @generated from field: string tenant_id = 8;
      */
     tenantId: string;
     /**
-     * Optional list of location IDs to assign to the producer during creation.
-     * All locations must exist and belong to the specified agency.
+     * Location IDs to assign to the producer during creation.
+     *
+     * Optional field for associating the producer with specific agency locations.
+     * This is useful for multi-location agencies where producers work from or
+     * service specific offices.
+     *
+     * Validation:
+     * - All location IDs must be valid UUIDs
+     * - All locations must exist and belong to the specified agency
+     * - Maximum of 100 locations per producer
+     * - Invalid location IDs will cause the entire creation to fail
+     *
+     * Post-Creation Management:
+     * - Use AssignProducerToLocations to add more locations later
+     * - Use UnassignProducerFromLocations to remove locations
+     * - Use ListAgencyLocations to see available locations for an agency
      *
      * @generated from field: repeated string location_ids = 10;
      */
     locationIds: string[];
     /**
-     * MetadataQuestions contains custom metadata questions and answers for the producer.
-     * The map key is the question identifier/text, and the value is the answer provided.
-     * This field is deprecated and will be removed in a future release.
+     * Custom metadata questions and answers for the producer.
+     *
+     * Optional field for storing tenant-specific information collected during
+     * producer onboarding. This allows tenants to capture additional data points
+     * that are important for their business processes but not part of the
+     * standard producer fields.
+     *
+     * Structure:
+     * - Key: Question identifier or the question text itself
+     * - Value: The producer's answer or response
+     *
+     * Common Use Cases:
+     * - Compliance questionnaires (e.g., "Have you ever had a license revoked?")
+     * - Business preferences (e.g., "Preferred carrier partners")
+     * - Specializations (e.g., "Areas of expertise")
+     * - Internal classifications (e.g., "Producer tier", "Region")
+     *
+     * Note: This data is stored but not validated by ProducerFlow. Ensure your
+     * application handles any necessary validation of the responses.
      *
      * @generated from field: map<string, string> metadata_questions = 11;
      */
@@ -3191,38 +3525,55 @@ export type NewProducer = Message<"producerflow.producer.v1.NewProducer"> & {
 export declare const NewProducerSchema: GenMessage<NewProducer>;
 /**
  * Address represents a mailing address for the producer.
+ * All fields are required when an address is provided.
+ * This address is used for:
+ * - Official correspondence
+ * - Licensing documentation
+ * - Commission statements
  *
  * @generated from message producerflow.producer.v1.NewProducer.Address
  */
 export type NewProducer_Address = Message<"producerflow.producer.v1.NewProducer.Address"> & {
     /**
-     * Street address of the producer.
-     * Required and must be non-empty.
+     * Deprecated: Use address_line_1 instead.
      *
-     * @generated from field: string street = 1;
+     * @generated from field: string street = 1 [deprecated = true];
+     * @deprecated
      */
     street: string;
     /**
-     * City of the producer.
-     * Required and must be non-empty.
+     * City of the producer's mailing address.
      *
      * @generated from field: string city = 2;
      */
     city: string;
     /**
-     * State of the producer.
-     * Required and must be a 2-letter state code.
+     * State of the producer's mailing address.
+     * Must be a valid 2-letter US state code (e.g., "CA", "NY").
      *
      * @generated from field: string state = 3;
      */
     state: string;
     /**
-     * Zip code of the producer.
-     * Required and must be between 1 and 10 characters.
+     * Zip code of the producer's mailing address.
+     * Supports both 5-digit (12345) and ZIP+4 (12345-6789) formats.
      *
      * @generated from field: string zip = 4;
      */
     zip: string;
+    /**
+     * Optional second line of address (apt, suite, unit, etc.)
+     *
+     * @generated from field: optional string address_line_2 = 5;
+     */
+    addressLine2?: string;
+    /**
+     * Primary address line of the producer.
+     * For backward compatibility, either street or address_line_1 can be used.
+     *
+     * @generated from field: string address_line_1 = 6;
+     */
+    addressLine1: string;
 };
 /**
  * Describes the message producerflow.producer.v1.NewProducer.Address.
@@ -3284,30 +3635,65 @@ export type NewProducerResponse = Message<"producerflow.producer.v1.NewProducerR
  */
 export declare const NewProducerResponseSchema: GenMessage<NewProducerResponse>;
 /**
- * NewProducersRequest is used to create multiple producers in a single request.
- * All producers will be associated with the specified agency.
+ * NewProducersRequest creates multiple producers and associates them with a single agency.
+ *
+ * This request supports bulk creation of producers, which is more efficient than making
+ * multiple individual NewProducer calls. All producers in the request will be associated
+ * with the same agency, making this ideal for onboarding producer teams.
+ *
+ * Operation Behavior:
+ * Producers are created sequentially. If a producer fails validation, the request
+ * returns an error, but any producers created before the failure will remain in
+ * the system.
+ *
+ * Request Limits:
+ * - Minimum producers: 1 (enforced by validation)
+ * - All producers must be for the same agency
+ *
+ * Each producer in the list can specify:
+ * - Basic information (name, email, phone)
+ * - NPN for NIPR validation and sync
+ * - Mailing address
+ * - Location assignments within the agency
+ * - External ID for tenant system integration
+ * - Custom metadata questions
+ *
+ * Common Use Cases:
+ * - Bulk importing producers from spreadsheets or CSV files
+ * - Migrating producer data from legacy systems
+ * - Setting up new agencies with their initial producer roster
+ * - Adding multiple producers during mergers or acquisitions
  *
  * @generated from message producerflow.producer.v1.NewProducersRequest
  */
 export type NewProducersRequest = Message<"producerflow.producer.v1.NewProducersRequest"> & {
     /**
-     * The UUID of the agency to associate the producers with.
-     * Must be a valid UUID format.
+     * The UUID of the agency to associate all producers with.
+     * This agency must exist and belong to the authenticated tenant.
+     * All producers in the request will be assigned to this single agency.
      *
      * @generated from field: string agency_id = 1;
      */
     agencyId: string;
     /**
-     * List of producers to create.
-     * This field is required and must contain at least one producer.
+     * List of producers to create in this bulk operation.
+     * Required field that must contain at least one producer.
+     * Each producer undergoes full validation including NPN verification if provided.
      *
      * @generated from field: repeated producerflow.producer.v1.NewProducer producers = 2;
      */
     producers: NewProducer[];
     /**
-     * Optional. Overrides the tenant's default NIPR sync setting during onboarding.
-     * Most tenants have this enabled by default, so it usually doesn't need to be set.
-     * If specified, this value takes precedence over the tenant's default behavior.
+     * Optional. Overrides the tenant's default NIPR sync setting for all producers in this request.
+     * NPN validation is always performed regardless of this setting.
+     * When true: Fetches full NIPR EntityInfo data after validation (paid lookup)
+     * When false: Skips NIPR EntityInfo fetch, only performs NPN validation
+     * When omitted: Uses the tenant's default configuration
+     *
+     * Cost Implications:
+     * Setting this to true will trigger billable NIPR EntityInfo lookups for each producer
+     * with an NPN, counting against your monthly quota. Consider using false for test data
+     * or when you plan to sync later via SyncProducerWithNIPR.
      *
      * @generated from field: optional bool sync_with_nipr = 3;
      */
@@ -3319,14 +3705,34 @@ export type NewProducersRequest = Message<"producerflow.producer.v1.NewProducers
  */
 export declare const NewProducersRequestSchema: GenMessage<NewProducersRequest>;
 /**
- * NewProducersResponse contains the IDs of all created producers.
+ * NewProducersResponse contains the IDs of all successfully created producers.
+ *
+ * The response provides a list of producer IDs that directly corresponds to the
+ * order of producers in the request, allowing you to map each request entry to
+ * its created resource.
+ *
+ * Order Guarantee:
+ * The producer_ids array maintains the exact same order as the producers array
+ * in the request. For example:
+ * - Request producers[0] → Response producer_ids[0]
+ * - Request producers[1] → Response producer_ids[1]
+ * This ordering guarantee simplifies client-side processing and record keeping.
+ *
+ * Post-Creation Actions:
+ * After receiving this response, you can:
+ * - Use the IDs to fetch full producer details via GetProducer
+ * - Assign producers to locations via AssignProducerToLocations
+ * - Trigger NIPR sync if it was skipped during creation
+ * - Set external IDs via SetExternalID if not provided during creation
  *
  * @generated from message producerflow.producer.v1.NewProducersResponse
  */
 export type NewProducersResponse = Message<"producerflow.producer.v1.NewProducersResponse"> & {
     /**
      * List of UUIDs for the newly created producers.
-     * The order matches the order of producers in the request.
+     * These IDs are immediately available for use in subsequent API calls.
+     * The array length will always match the number of producers in the request.
+     * Order is guaranteed to match the request's producer array order.
      *
      * @generated from field: repeated string producer_ids = 1;
      */
@@ -3383,9 +3789,9 @@ export type NewContact = Message<"producerflow.producer.v1.NewContact"> & {
     /**
      * Mailing address of the contact.
      *
-     * @generated from field: producerflow.producer.v1.NewContact.Address address = 6;
+     * @generated from field: producerflow.producer.v1.Address address = 6;
      */
-    address?: NewContact_Address;
+    address?: Address;
     /**
      * Role or position of the contact within the agency.
      * Required and must be non-empty.
@@ -3411,46 +3817,6 @@ export type NewContact = Message<"producerflow.producer.v1.NewContact"> & {
  * Use `create(NewContactSchema)` to create a new message.
  */
 export declare const NewContactSchema: GenMessage<NewContact>;
-/**
- * Address represents a mailing address for the contact.
- *
- * @generated from message producerflow.producer.v1.NewContact.Address
- */
-export type NewContact_Address = Message<"producerflow.producer.v1.NewContact.Address"> & {
-    /**
-     * Street address of the contact.
-     * Required and must be non-empty.
-     *
-     * @generated from field: string street = 1;
-     */
-    street: string;
-    /**
-     * City of the contact.
-     * Required and must be non-empty.
-     *
-     * @generated from field: string city = 2;
-     */
-    city: string;
-    /**
-     * State of the contact's address.
-     * Required and must be exactly 2 characters (state code).
-     *
-     * @generated from field: string state = 3;
-     */
-    state: string;
-    /**
-     * Zip code of the contact's address.
-     * Required and must be between 1 and 10 characters.
-     *
-     * @generated from field: string zip = 4;
-     */
-    zip: string;
-};
-/**
- * Describes the message producerflow.producer.v1.NewContact.Address.
- * Use `create(NewContact_AddressSchema)` to create a new message.
- */
-export declare const NewContact_AddressSchema: GenMessage<NewContact_Address>;
 /**
  * NewContactRequest is used to create a new contact and associate it with an agency.
  *
@@ -3592,9 +3958,11 @@ export type Contact = Message<"producerflow.producer.v1.Contact"> & {
      */
     role: string;
     /**
-     * @generated from field: producerflow.producer.v1.Contact.Address address = 8;
+     * Mailing address of the contact.
+     *
+     * @generated from field: producerflow.producer.v1.Address address = 8;
      */
-    address?: Contact_Address;
+    address?: Address;
     /**
      * National Producer Number (NPN) of the contact, if applicable.
      *
@@ -3613,43 +3981,6 @@ export type Contact = Message<"producerflow.producer.v1.Contact"> & {
  * Use `create(ContactSchema)` to create a new message.
  */
 export declare const ContactSchema: GenMessage<Contact>;
-/**
- * Mailing address of the contact.
- * Address represents a mailing address for the contact.
- *
- * @generated from message producerflow.producer.v1.Contact.Address
- */
-export type Contact_Address = Message<"producerflow.producer.v1.Contact.Address"> & {
-    /**
-     * Street address of the contact.
-     *
-     * @generated from field: string street = 1;
-     */
-    street: string;
-    /**
-     * City of the contact.
-     *
-     * @generated from field: string city = 2;
-     */
-    city: string;
-    /**
-     * State of the contact.
-     *
-     * @generated from field: string state = 3;
-     */
-    state: string;
-    /**
-     * Zip code of the contact.
-     *
-     * @generated from field: string zip = 4;
-     */
-    zip: string;
-};
-/**
- * Describes the message producerflow.producer.v1.Contact.Address.
- * Use `create(Contact_AddressSchema)` to create a new message.
- */
-export declare const Contact_AddressSchema: GenMessage<Contact_Address>;
 /**
  * ListAgencyContactsRequest requests all contacts associated with an agency.
  *
@@ -4074,68 +4405,92 @@ export type StopSyncAgencyWithNIPRResponse = Message<"producerflow.producer.v1.S
  */
 export declare const StopSyncAgencyWithNIPRResponseSchema: GenMessage<StopSyncAgencyWithNIPRResponse>;
 /**
- * AgencySummary contains a lightweight summary of an agency for list views.
- * This message contains only the essential fields needed for displaying agencies in a list.
+ * AgencySummary provides essential agency information for list views and quick
+ * reference.
+ *
+ * This message is optimized for displaying agencies in lists, tables, and
+ * search results without the overhead of full NIPR data. It contains only the
+ * most commonly needed fields for agency identification and basic contact
+ * information.
+ *
+ * For complete agency information including NIPR data, licenses, appointments,
+ * and associated producers, use the GetAgencyAndProducers RPC.
  *
  * @generated from message producerflow.producer.v1.AgencySummary
  */
 export type AgencySummary = Message<"producerflow.producer.v1.AgencySummary"> & {
     /**
-     * Unique identifier for the agency.
+     * Unique identifier for the agency (UUID format).
+     * Use this ID to retrieve full agency details via GetAgencyAndProducers.
      *
      * @generated from field: string agency_id = 1;
      */
     agencyId: string;
     /**
-     * Agency name.
+     * The official name of the agency.
+     * This is typically the legal business name.
      *
      * @generated from field: string name = 2;
      */
     name: string;
     /**
-     * Agency email address.
+     * Primary email address for the agency.
+     * Used for general communication and must be unique within the tenant.
      *
      * @generated from field: string email = 3;
      */
     email: string;
     /**
-     * Agency phone number.
+     * Main phone number for the agency.
+     * Format may vary but typically includes country code for international numbers.
      *
      * @generated from field: string phone = 4;
      */
     phone: string;
     /**
-     * Agency NPN (National Producer Number).
+     * National Producer Number (NPN) assigned by NIPR.
+     * Only present for standard agencies (not sole proprietors).
+     * Empty string if the agency doesn't have an NPN.
      *
      * @generated from field: string npn = 5;
      */
     npn: string;
     /**
-     * Agency FEIN (Federal Employer Identification Number).
+     * Federal Employer Identification Number (FEIN).
+     * Nine-digit number assigned by the IRS for tax purposes.
+     * May be empty for sole proprietors or agencies without FEIN.
      *
      * @generated from field: string fein = 6;
      */
     fein: string;
     /**
      * Organization ID that the agency belongs to.
+     * References organizations like aggregators or agency networks.
+     * Optional field - null if the agency isn't part of an organization.
      *
      * @generated from field: optional string organization_id = 7;
      */
     organizationId?: string;
     /**
-     * Whether this is an internal tenant agency.
+     * Indicates whether this is an internal tenant agency.
+     * True for agencies owned/operated by the tenant.
+     * False for external/partner agencies.
      *
      * @generated from field: bool is_tenant_agency = 8;
      */
     isTenantAgency: boolean;
     /**
-     * Whether this is a sole proprietor.
+     * Indicates whether this agency is a sole proprietor.
+     * True: Individual producer operating as their own agency (ENTITY_TYPE_SOLE_PROPRIETOR).
+     * False: Standard agency with multiple producers (ENTITY_TYPE_AGENCY).
      *
      * @generated from field: bool is_sole_proprietor = 9;
      */
     isSoleProprietor: boolean;
     /**
-     * When the agency was created.
+     * Timestamp when the agency was created in the system.
+     * Used for sorting agencies by creation date in list views.
+     * Always in UTC timezone.
      *
      * @generated from field: google.protobuf.Timestamp created_at = 10;
      */
@@ -4147,50 +4502,73 @@ export type AgencySummary = Message<"producerflow.producer.v1.AgencySummary"> &
  */
 export declare const AgencySummarySchema: GenMessage<AgencySummary>;
 /**
- * ListAgenciesRequest requests a list of agencies associated with the tenant.
- * Supports optional filtering and pagination parameters.
+ * ListAgenciesRequest enables flexible querying of agencies with multiple filter
+ * options and pagination support.
+ *
+ * All filters are optional and can be combined for precise results. When multiple
+ * filters are specified, they are applied with AND logic (agencies must match all
+ * specified criteria).
+ *
+ * Example Use Cases:
+ * - Get all agencies in an organization: set organization_id
+ * - Search for an agency by name: set search_query
+ * - Find failing NIPR syncs: set nipr_sync_statuses to [NIPR_SYNC_STATE_FAILING]
+ * - Get sole proprietors only: set entity_type to ENTITY_TYPE_SOLE_PROPRIETOR
+ * - Paginate through all agencies: use pagination with page_token
  *
  * @generated from message producerflow.producer.v1.ListAgenciesRequest
  */
 export type ListAgenciesRequest = Message<"producerflow.producer.v1.ListAgenciesRequest"> & {
     /**
      * Optional. Filter agencies by organization ID.
-     * If provided, only agencies belonging to this organization will be returned.
+     * Only agencies belonging to this specific organization will be returned.
+     * Must be a valid UUID if provided.
+     * Use ListOrganizations to get valid organization IDs.
      *
      * @generated from field: optional string organization_id = 1;
      */
     organizationId?: string;
     /**
-     * Optional. Search query to filter agencies by name, NPN, or email.
-     * If provided, only agencies matching the search query will be returned.
+     * Optional. Free-text search across agency fields.
+     * Searches in: agency name, NPN, and email address.
+     * The search is case-insensitive and uses partial matching.
+     * Example: "smith" will match "Smith Insurance Agency" and "john.smith@agency.com"
      *
      * @generated from field: optional string search_query = 2;
      */
     searchQuery?: string;
     /**
-     * Optional. Pagination parameters.
-     * If not provided, defaults to page_size=50.
+     * Optional. Pagination parameters for controlling result set size and navigation.
+     * If not provided, defaults to page_size=50 with no offset.
+     * Maximum allowed page_size is 200; values above this will be capped.
      *
      * @generated from field: producerflow.producer.v1.Pagination pagination = 3;
      */
     pagination?: Pagination;
     /**
-     * Optional. Filter by agency type (internal vs external).
-     * If not provided, returns all agencies regardless of type.
+     * Optional. Filter by agency classification (internal vs external).
+     * - AGENCY_TYPE_INTERNAL: Agencies owned/operated by the tenant
+     * - AGENCY_TYPE_EXTERNAL: Partner or third-party agencies
+     * If not specified, returns both internal and external agencies.
      *
      * @generated from field: optional producerflow.producer.v1.AgencyType agency_type = 4;
      */
     agencyType?: AgencyType;
     /**
-     * Optional. Filter by entity type (sole proprietor vs agency).
-     * If not provided, returns all agencies regardless of entity type.
+     * Optional. Filter by business entity structure.
+     * - ENTITY_TYPE_SOLE_PROPRIETOR: Individual producers as agencies
+     * - ENTITY_TYPE_AGENCY: Standard multi-producer agencies
+     * If not specified, returns both sole proprietors and standard agencies.
      *
      * @generated from field: optional producerflow.producer.v1.EntityType entity_type = 5;
      */
     entityType?: EntityType;
     /**
-     * Optional. Filter by NIPR sync status.
-     * If not provided, returns all agencies regardless of sync status.
+     * Optional. Filter by NIPR synchronization status.
+     * Multiple statuses can be specified to match agencies in any of those states.
+     * Useful for monitoring sync health and identifying agencies needing attention.
+     * Valid values: ACTIVE, FAILING, PENDING, DISABLED
+     * If empty, returns agencies in all sync states.
      *
      * @generated from field: repeated producerflow.producer.v1.NIPRSyncState nipr_sync_statuses = 6;
      */
@@ -4202,27 +4580,45 @@ export type ListAgenciesRequest = Message<"producerflow.producer.v1.ListAgencies
  */
 export declare const ListAgenciesRequestSchema: GenMessage<ListAgenciesRequest>;
 /**
- * ListAgenciesResponse contains the list of agencies matching the filter criteria.
+ * ListAgenciesResponse provides paginated agency results with metadata for
+ * navigation and total counts.
+ *
+ * The response is optimized for UI display with summary data only. For complete
+ * agency information including NIPR data, use GetAgencyAndProducers with the
+ * agency_id from the summary.
+ *
+ * Pagination Notes:
+ * - Results are always ordered by creation date (newest first)
+ * - Page tokens are opaque and should not be constructed by clients
+ * - Total count reflects all matching agencies, not just the current page
+ * - Empty agencies list with total_count > 0 indicates you've paginated past the end
  *
  * @generated from message producerflow.producer.v1.ListAgenciesResponse
  */
 export type ListAgenciesResponse = Message<"producerflow.producer.v1.ListAgenciesResponse"> & {
     /**
      * List of agency summaries matching the filter criteria.
-     * The agencies are ordered by creation date, most recent first.
+     * Ordered by creation date with the most recently created agencies first.
+     * Will be empty if no agencies match the filters or if paginating past the last page.
+     * Maximum of page_size agencies per response (default 50, max 200).
      *
      * @generated from field: repeated producerflow.producer.v1.AgencySummary agencies = 1;
      */
     agencies: AgencySummary[];
     /**
-     * A token that can be sent as `page_token` to retrieve the next page.
-     * If this field is omitted, there are no subsequent pages.
+     * Pagination token for retrieving the next page of results.
+     * Pass this value as page_token in the next request to continue pagination.
+     * Empty string indicates this is the last page of results.
+     * Tokens are opaque and their format may change; treat as black box.
      *
      * @generated from field: string next_page_token = 2;
      */
     nextPageToken: string;
     /**
-     * Total number of agencies matching the filter criteria.
+     * Total number of agencies matching the filter criteria across all pages.
+     * This count is independent of pagination and represents the full result set.
+     * Useful for displaying "Showing X-Y of Z agencies" in UIs.
+     * Will be 0 if no agencies match the specified filters.
      *
      * @generated from field: int32 total_count = 3;
      */
@@ -4234,16 +4630,33 @@ export type ListAgenciesResponse = Message<"producerflow.producer.v1.ListAgencie
  */
 export declare const ListAgenciesResponseSchema: GenMessage<ListAgenciesResponse>;
 /**
- * ListOrganizationsRequest requests a list of all organizations associated with the tenant.
- * This request requires no parameters  and will return all organizations that
- * the authenticated tenant has access to.
+ * ListOrganizationsRequest requests a list of all organizations associated with
+ * the authenticated tenant.
+ *
+ * Organizations provide a way to group agencies into logical business units,
+ * networks, or aggregator relationships. This endpoint returns all organizations
+ * accessible to your tenant, which can be used to:
+ * - Display organization hierarchies in user interfaces
+ * - Filter agencies by organization
+ * - Apply organization-specific business rules or workflows
+ *
+ * The response supports pagination for tenants with large numbers of organizations.
  *
  * @generated from message producerflow.producer.v1.ListOrganizationsRequest
  */
 export type ListOrganizationsRequest = Message<"producerflow.producer.v1.ListOrganizationsRequest"> & {
     /**
-     * Optional. Pagination parameters.
-     * If not provided, defaults to page_size=50.
+     * Optional pagination parameters to control the result set.
+     *
+     * Pagination allows you to retrieve organizations in manageable chunks:
+     * - page_size: Number of organizations to return (default: 50, max: 200)
+     * - page_token: Token from previous response to get the next page
+     *
+     * Example usage:
+     * - First request: page_size=100 (returns first 100 organizations)
+     * - Subsequent requests: Use next_page_token from previous response
+     *
+     * If omitted, returns the first 50 organizations.
      *
      * @generated from field: producerflow.producer.v1.Pagination pagination = 1;
      */
@@ -4255,36 +4668,71 @@ export type ListOrganizationsRequest = Message<"producerflow.producer.v1.ListOrg
  */
 export declare const ListOrganizationsRequestSchema: GenMessage<ListOrganizationsRequest>;
 /**
- * Organization represents a logical grouping or hierarchical structure within a tenant.
- * Organizations can be used to organize agencies into meaningful groups
- * such as agency networks, aggregators, or other business hierarchies.
+ * Organization represents a logical grouping or hierarchical structure for managing agencies.
+ *
+ * Organizations enable better management of insurance distribution networks by grouping
+ * agencies into meaningful business units. Common organization types include:
+ * - Agency networks or clusters
+ * - Aggregators
+ * - Geographic regions or territories
+ * - Franchise groups or corporate structures
+ * - Market segments or product lines
+ *
  *
  * @generated from message producerflow.producer.v1.Organization
  */
 export type Organization = Message<"producerflow.producer.v1.Organization"> & {
     /**
-     * Unique identifier for the organization.
-     * This is a UUID that can be used to reference the organization in other API calls.
+     * Unique identifier for the organization (UUID format).
+     *
+     * This ID is system-generated and immutable. Use this ID to:
+     * - Reference the organization in API calls (GetOrganization, agency creation)
+     * - Establish relationships between organizations and agencies
+     * - Track organization-level metrics and reporting
+     *
+     * Format: Standard UUID v4 (e.g., "123e4567-e89b-12d3-a456-426614174000")
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
      * Display name of the organization.
-     * This is the human-readable name that identifies the organization to users.
+     *
+     * This is the human-readable name shown in user interfaces and reports.
+     * Names must be unique within your tenant (case-insensitive comparison).
+     *
+     * Best Practices:
+     * - Use clear, descriptive names that reflect the organization's purpose
+     * - Include geographic or business unit identifiers when relevant
+     * - Avoid special characters that may cause display issues
+     *
+     * Examples: "West Coast Network", "AgencyHero Aggregator", "Premium Partners Group"
      *
      * @generated from field: string name = 2;
      */
     name: string;
     /**
      * External identifier for the organization.
-     * This is the identifier used by the tenant's system to identify the organization.
+     *
+     * This field maps the ProducerFlow organization to your internal system's
+     * organization ID, enabling bi-directional synchronization and integration.
+     *
+     * Use Cases:
+     * - Maintain references to your CRM or ERP system
+     * - Enable data synchronization between systems
+     * - Support migration from legacy systems
+     *
+     * This field is optional and can be any string format meaningful to your system.
+     * Examples: "ORG-12345", "west-coast-001", UUID from your system
      *
      * @generated from field: string external_id = 3;
      */
     externalId: string;
     /**
-     * Contact email address for the organization.
+     * Primary contact email address for the organization.
+     *
+     * Optional field. If provided, must be a valid email format.
+     * Example: "admin@westcoastnetwork.com"
      *
      * @generated from field: string email = 4;
      */
@@ -4296,31 +4744,61 @@ export type Organization = Message<"producerflow.producer.v1.Organization"> & {
  */
 export declare const OrganizationSchema: GenMessage<Organization>;
 /**
- * ListOrganizationsResponse contains the list of organizations associated with the tenant.
- * The organizations are returned ordered by name. If the tenant has no organizations,
- * the organizations list will be empty.
+ * ListOrganizationsResponse contains the paginated list of organizations for the tenant.
+ *
+ * The response includes all organizations accessible to your authenticated tenant,
+ * ordered alphabetically by name for consistent display. Empty results indicate
+ * that your tenant either doesn't use organizational hierarchies or has no
+ * organizations configured yet.
+ *
+ * Pagination is automatically applied to large result sets to ensure optimal
+ * performance and reasonable response sizes.
  *
  * @generated from message producerflow.producer.v1.ListOrganizationsResponse
  */
 export type ListOrganizationsResponse = Message<"producerflow.producer.v1.ListOrganizationsResponse"> & {
     /**
      * List of organizations associated with the tenant.
-     * Each organization includes its unique identifier and display name.
-     * The list may be empty if no organizations are associated with the tenant.
-     * Organizations are ordered alphabetically by name.
+     *
+     * Each organization in the list includes:
+     * - Unique identifier (id) for API operations
+     * - Display name for user interfaces
+     * - External ID for system integration
+     * - Contact email (if configured)
+     *
+     * The list may be empty ([]) if:
+     * - No organizations are configured for your tenant
+     * - Your tenant doesn't use organizational hierarchies
      *
      * @generated from field: repeated producerflow.producer.v1.Organization organizations = 1;
      */
     organizations: Organization[];
     /**
-     * A token that can be sent as `page_token` to retrieve the next page.
-     * If this field is omitted, there are no subsequent pages.
+     * Pagination token for retrieving the next page of results.
+     *
+     * When present, indicates more organizations are available. Pass this
+     * token as the page_token in the next ListOrganizationsRequest to
+     * retrieve the subsequent page.
+     *
+     * Empty string or omitted field indicates this is the last page.
+     *
+     * Important: Tokens are opaque and may expire. Don't store tokens
+     * long-term; retrieve fresh data when needed.
      *
      * @generated from field: string next_page_token = 2;
      */
     nextPageToken: string;
     /**
-     * Total number of organizations matching the filter criteria.
+     * Total count of organizations matching the filter criteria.
+     *
+     * This count represents the total number of organizations available
+     * to your tenant, regardless of pagination. Use this to:
+     * - Display result counts in user interfaces ("Showing 1-50 of 237")
+     * - Calculate the number of pages available
+     * - Determine if pagination is needed
+     *
+     * The count remains consistent across paginated requests unless
+     * organizations are added or removed between calls.
      *
      * @generated from field: int32 total_count = 3;
      */
@@ -4332,14 +4810,26 @@ export type ListOrganizationsResponse = Message<"producerflow.producer.v1.ListOr
  */
 export declare const ListOrganizationsResponseSchema: GenMessage<ListOrganizationsResponse>;
 /**
- * GetOrganizationRequest specifies which organization to retrieve.
+ * GetOrganizationRequest specifies which organization to retrieve detailed information for.
+ *
+ * Use this request to fetch comprehensive details about a specific organization,
+ * including all agencies assigned to it and their current status.
  *
  * @generated from message producerflow.producer.v1.GetOrganizationRequest
  */
 export type GetOrganizationRequest = Message<"producerflow.producer.v1.GetOrganizationRequest"> & {
     /**
      * Unique identifier of the organization to retrieve.
-     * Must be a valid UUID.
+     *
+     * This must be a valid UUID that was previously returned from:
+     * - ListOrganizations response
+     * - Agency creation response (when agency is assigned to an organization)
+     * - Other API calls that reference organizations
+     *
+     * The organization must belong to your authenticated tenant; attempting
+     * to access organizations from other tenants will result in a NOT_FOUND error.
+     *
+     * Format: Standard UUID v4 (e.g., "123e4567-e89b-12d3-a456-426614174000")
      *
      * @generated from field: string organization_id = 1;
      */
@@ -4351,13 +4841,13 @@ export type GetOrganizationRequest = Message<"producerflow.producer.v1.GetOrgani
  */
 export declare const GetOrganizationRequestSchema: GenMessage<GetOrganizationRequest>;
 /**
- * GetOrganizationResponse contains the details of the requested organization.
+ * GetOrganizationResponse contains details about the requested organization.
  *
  * @generated from message producerflow.producer.v1.GetOrganizationResponse
  */
 export type GetOrganizationResponse = Message<"producerflow.producer.v1.GetOrganizationResponse"> & {
     /**
-     * The requested organization.
+     * The requested organization with all available details.
      *
      * @generated from field: producerflow.producer.v1.Organization organization = 1;
      */
@@ -4368,6 +4858,56 @@ export type GetOrganizationResponse = Message<"producerflow.producer.v1.GetOrgan
  * Use `create(GetOrganizationResponseSchema)` to create a new message.
  */
 export declare const GetOrganizationResponseSchema: GenMessage<GetOrganizationResponse>;
+/**
+ * CreateOrganizationRequest contains the information needed to create a new organization.
+ *
+ * @generated from message producerflow.producer.v1.CreateOrganizationRequest
+ */
+export type CreateOrganizationRequest = Message<"producerflow.producer.v1.CreateOrganizationRequest"> & {
+    /**
+     * Required. The display name of the organization.
+     * Must be unique within the tenant.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Optional. The external identifier for the organization.
+     * This is the identifier used by the tenant's system to identify the organization.
+     *
+     * @generated from field: string external_id = 2;
+     */
+    externalId: string;
+    /**
+     * Optional. The contact email address for the organization.
+     *
+     * @generated from field: string email = 3;
+     */
+    email: string;
+};
+/**
+ * Describes the message producerflow.producer.v1.CreateOrganizationRequest.
+ * Use `create(CreateOrganizationRequestSchema)` to create a new message.
+ */
+export declare const CreateOrganizationRequestSchema: GenMessage<CreateOrganizationRequest>;
+/**
+ * CreateOrganizationResponse contains the result of creating a new organization.
+ *
+ * @generated from message producerflow.producer.v1.CreateOrganizationResponse
+ */
+export type CreateOrganizationResponse = Message<"producerflow.producer.v1.CreateOrganizationResponse"> & {
+    /**
+     * The unique identifier of the newly created organization.
+     *
+     * @generated from field: string organization_id = 1;
+     */
+    organizationId: string;
+};
+/**
+ * Describes the message producerflow.producer.v1.CreateOrganizationResponse.
+ * Use `create(CreateOrganizationResponseSchema)` to create a new message.
+ */
+export declare const CreateOrganizationResponseSchema: GenMessage<CreateOrganizationResponse>;
 /**
  * CreateProducerUploadURLRequest contains information needed to generate
  * a producer upload URL. This includes the agency NPN.
@@ -4776,34 +5316,58 @@ export type UnassignProducerFromLocationsResponse = Message<"producerflow.produc
  */
 export declare const UnassignProducerFromLocationsResponseSchema: GenMessage<UnassignProducerFromLocationsResponse>;
 /**
- * EntityType defines the business entity type for an agency.
+ * EntityType defines the business structure of an agency.
+ *
+ * This determines important business rules around NPNs, producers, and
+ * onboarding requirements.
  *
  * @generated from enum producerflow.producer.v1.EntityType
  */
 export declare enum EntityType {
     /**
      * Default unspecified value. Do not use.
+     * This value is invalid and will be rejected by the API.
      *
      * @generated from enum value: ENTITY_TYPE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * An individual producer operating as their own agency.
-     * For this type, an agency NPN is not allowed, and additional producers are not supported.
+     * Sole proprietor: An individual insurance producer operating independently.
+     *
+     * Business Rules for Sole Proprietors:
+     * - Cannot have a separate agency NPN (only the principal's NPN is used)
+     * - Cannot have additional producers beyond the principal
+     * - The principal producer IS the agency
+     * - FEIN is optional
+     *
+     * Use this type for independent agents who operate alone.
      *
      * @generated from enum value: ENTITY_TYPE_SOLE_PROPRIETOR = 1;
      */
     SOLE_PROPRIETOR = 1,
     /**
-     * A standard insurance agency that can have multiple producers.
-     * For this type, either NPN or FEIN is required.
+     * Standard insurance agency: A business entity with multiple producers.
+     *
+     * Business Rules for Agencies:
+     * - Must provide either an agency NPN or FEIN (or both)
+     * - Can have multiple producers in addition to the principal
+     * - The agency is a separate legal entity from its producers
+     * - Typically has business structure (LLC, Corporation, Partnership, etc.)
+     *
+     * Use this type for traditional insurance agencies with multiple agents.
      *
      * @generated from enum value: ENTITY_TYPE_AGENCY = 2;
      */
     AGENCY = 2,
     /**
-     * Ask during onboarding because the entity type is not known when the agency onboarding url is created.
-     * The UI will ask the user to select the entity type.
+     * Dynamic determination: Let the user select during onboarding.
+     *
+     * Use this value only when generating onboarding URLs and you don't know
+     * the entity type in advance. The onboarding form will present both options
+     * and let the user choose.
+     *
+     * This value is ONLY valid for CreateAgencyOnboardingURL and will be rejected
+     * by NewAgency and other direct creation endpoints.
      *
      * @generated from enum value: ENTITY_TYPE_ASK_DURING_ONBOARDING = 3;
      */
@@ -4884,26 +5448,73 @@ export declare enum NIPRSyncState {
  */
 export declare const NIPRSyncStateSchema: GenEnum<NIPRSyncState>;
 /**
- * ProducerService provides a comprehensive API for managing insurance producers
- * and agencies, including onboarding, data synchronization, and integration with
- * external systems like NIPR for license verification.
+ * ProducerService provides a comprehensive API for managing insurance
+ * producers and agencies. This service simplifies producer and agency
+ * onboarding, data synchronization, and integration with the National Insurance
+ * Producer Registry (NIPR).
+ *
+ * Key capabilities:
+ * - Producer and agency onboarding with self-service URLs
+ * - Automatic synchronization of license, appointment, and regulatory data from NIPR
+ * - NPN (National Producer Number) validation and lookup
+ * - Multi-location management for agencies
+ * - Integration with NIPR PDB Gateway, PDB Alerts, and NPN Lookup services
+ *
+ * NIPR Integration:
+ * This service automatically fetches and maintains up-to-date licensing
+ * information, carrier appointments, and regulatory actions from NIPR. Most
+ * NIPR sync operations are billable and count against your monthly unique NPN
+ * quota. Enable PDB Alerts synchronization to receive automatic daily updates
+ * and reduce manual sync costs.
  *
- * Available endpoints:
- *   UAT (User Acceptance Testing): https://api.uat.producerflow.com
- *   Production: https://api.producerflow.com
+ * Authentication:
+ * All endpoints require API key authentication provided via the Authorization header.
  *
- * RPCs for starting the onboarding agency process.
+ * Onboarding Operations
+ * Generate self-service URLs and create agencies/producers with NIPR validation.
  *
  * @generated from service producerflow.producer.v1.ProducerService
  */
 export declare const ProducerService: GenService<{
     /**
-     * CreateAgencyOnboardingURL generates a URL that can be used to onboard a new agency.
-     * The URL contains encoded information about the agency defaults and tenant context.
-     * All fields in the request are optional - you can provide as much or as little
-     * information as available. Any missing information will be collected during
-     * the onboarding process.
-     * Returns a URL string that can be shared with the agency for self-onboarding.
+     * CreateAgencyOnboardingURL generates a secure, pre-filled URL for agency
+     * self-onboarding.
+     *
+     * Use this endpoint to create personalized onboarding links that can be
+     * shared with agencies. The URL encodes agency defaults, tenant context, and
+     * optional pre-filled information to streamline the onboarding experience.
+     *
+     * All fields in the request are optional. Provide as much or as little
+     * information as available - any missing data will be collected through the
+     * onboarding flow.
+     *
+     * Typical Workflow:
+     * 1. Generate onboarding URL with optional pre-filled data (agency name, NPN,
+     *    principal info)
+     * 2. Share URL with agency contact via email or portal
+     * 3. Agency completes onboarding form through the URL
+     * 4. System validates NPN with NIPR and creates agency record
+     * 5. Optionally sync with NIPR to fetch licenses and appointments
+     *
+     * Validation Rules:
+     * All fields in the request are optional. The system generates valid URLs
+     * even with an empty request. When fields are provided:
+     * - entity_type: Must be ENTITY_TYPE_SOLE_PROPRIETOR (1), ENTITY_TYPE_AGENCY (2),
+     *   or ENTITY_TYPE_ASK_DURING_ONBOARDING (3). This is the only endpoint where
+     *   ENTITY_TYPE_ASK_DURING_ONBOARDING is valid.
+     * - email: Must be a valid email format if provided
+     * - npn: Must be a valid NPN format (2-10 digits) if provided. Note that NPN
+     *   validation against NIPR occurs during onboarding, not during URL generation.
+     * - fein: Must be exactly 9 digits if provided
+     * - organization_id: Must be a valid organization ID belonging to your tenant if provided
+     * - principal.email: Must be a valid email format if provided
+     * - principal.npn: Must be a valid NPN format (2-10 digits) if provided
+     * - principal.tenant_id: Maximum 255 characters if provided
+     *
+     * Returns:
+     * A time-limited URL string that can be shared with the agency for
+     * self-service onboarding.
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.CreateAgencyOnboardingURL
      */
@@ -4913,10 +5524,43 @@ export declare const ProducerService: GenService<{
         output: typeof CreateAgencyOnboardingURLResponseSchema;
     };
     /**
-     * CreateProducerOnboardingURL generates a secure, time-limited link for onboarding a new producer
-     * with optional pre-filled NPN. The URL can be shared directly with the producer.
-     * The generated URL will take the producer through the onboarding flow with the NPN field
-     * pre-populated if provided, reducing friction in the onboarding process.
+     * CreateProducerOnboardingURL generates a secure, pre-filled URL for producer
+     * self-onboarding.
+     *
+     * Use this endpoint to create personalized onboarding links for individual
+     * producers joining an existing agency. The URL can include optional
+     * pre-filled data like NPN, name, email, and address to reduce manual data
+     * entry.
+     *
+     * The producer must be associated with an existing agency. Use
+     * CreateAgencyOnboardingURL if you need to onboard an agency and its
+     * principal together.
+     *
+     * Typical Workflow:
+     * 1. Generate producer onboarding URL with agency_id and optional pre-filled data
+     * 2. Share URL with producer via email
+     * 3. Producer completes onboarding form through the URL
+     * 4. System validates NPN with NIPR and associates producer with agency
+     * 5. Optionally sync with NIPR to fetch producer licenses and appointments
+     *
+     * Validation Rules:
+     * - agency_id: Required. must be a valid UUID of an agency belonging
+     *   to your tenant.
+     * - producer_data: All fields are optional. When provided:
+     *   - npn: Must be a valid NPN format (1-10 characters). Note that NPN validation
+     *     against NIPR occurs during onboarding, not during URL generation.
+     *   - email: Must be a valid email format if provided
+     *   - mailing_address.state: Must be exactly 2 characters (state code) if provided
+     *   - mailing_address.zip: Must be 1-10 characters if provided
+     *
+     * Returns:
+     * A time-limited URL string that can be shared with the producer for
+     * self-service onboarding.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     * - INVALID_ARGUMENT: Invalid NPN provided (not found in NIPR)
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.CreateProducerOnboardingURL
      */
@@ -4926,7 +5570,88 @@ export declare const ProducerService: GenService<{
         output: typeof CreateProducerOnboardingURLResponseSchema;
     };
     /**
-     * NewAgency creates a new agency, optionally with associated producers. It performs the following validation checks: Ensures all required fields are present and valid. Checks whether the NPN is already registered. Verifies agency and principal information with NIPR. Business rules: Sole proprietors can't have an agency NPN or additional producers. Regular agencies must provide either an NPN or a FEIN. If validation passes, it creates the agency, principal, and any producers. Returns the IDs of the created agency, principal, and producers.
+     * NewAgency creates a new agency with principal and optional additional producers.
+     *
+     * This is the programmatic alternative to CreateAgencyOnboardingURL - use
+     * this when you want to create agencies directly via API instead of through a
+     * self-service form.
+     *
+     * Entity Type Rules:
+     * - ENTITY_TYPE_SOLE_PROPRIETOR: Individual producer operating as their own agency.
+     *   Cannot have an agency NPN. Only the principal is created.
+     * - ENTITY_TYPE_AGENCY: Standard insurance agency with multiple producers.
+     *   Must provide either an NPN or FEIN. Can have multiple producers beyond the principal.
+     *
+     * NIPR Validation and Sync:
+     * The system performs free NIPR API lookups to validate NPNs before
+     * creation. If sync_with_nipr is true (or tenant default), the system
+     * performs paid NIPR EntityInfo lookups to fetch complete license, appointment,
+     * and regulatory data.
+     *
+     * Validation Performed:
+     * - Required fields are present and valid
+     * - Email addresses are unique within tenant
+     * - Agency NPN exists in NIPR (if provided)
+     * - Principal NPN exists in NIPR
+     * - Entity type rules are followed
+     * - Principal and subsequent producers last names must match NIPR records for the given NPN
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency: Required field containing all agency information
+     * - agency.name: Required, must be non-empty
+     * - agency.email: Required, must be a valid email format
+     * - agency.phone: Optional, if provided must match E.164 pattern (e.g., +15551234567)
+     * - agency.entity_type: Required, must be ENTITY_TYPE_SOLE_PROPRIETOR (1) or
+     *   ENTITY_TYPE_AGENCY (2). ENTITY_TYPE_ASK_DURING_ONBOARDING is NOT valid here.
+     * - agency.fein: Optional, if provided must be exactly 9 digits. Required for
+     *   ENTITY_TYPE_AGENCY if NPN is not provided.
+     * - agency.principal: Required, contains principal producer information
+     *   - principal.first_name: Required, must be non-empty
+     *   - principal.last_name: Required, must be non-empty
+     *   - principal.email: Required, must be a valid email format
+     *   - principal.npn: Required, must be 1-10 characters
+     *   - principal.phone: Optional, if provided must match E.164 pattern
+     *   - principal.tenant_id: Optional, maximum 255 characters
+     * - agency.bank_account (optional, if provided all subfields are required):
+     *   - account_number: 8-17 characters
+     *   - routing_number: Exactly 9 characters
+     *   - account_type: Required, must be CHECKING (1) or SAVINGS (2)
+     *   - account_holder_name: Required, must be non-empty
+     * - agency.eo_info (optional, if provided):
+     *   - carrier: Required, must be non-empty
+     *   - expiration_date: Required, must be in the future
+     *   - coverage_amount: Required, must be non-empty
+     *   - effective_date: Required
+     *   - per_occurrence: Required, must be non-empty
+     * - agency.business_hours (optional, if provided):
+     *   - timezone: Required, must be non-empty
+     *   - business_hours: Required, at least one entry
+     *     - week_days: Required, 1-7 days
+     *     - opening_time: Required
+     *     - closing_time: Required
+     * - agency.producers: Optional list of additional producers (see NewProducer validation)
+     * - agency.points_of_contact (optional, for each contact):
+     *   - email: Required, must be a valid email format
+     *   - role: Required
+     * - agency.root_organization_id: Optional, if provided must be 1-36 characters
+     * - agency.locations: Optional, maximum 100 locations
+     *
+     * Business logic validation:
+     * - agency.email: Must be unique within the tenant
+     * - agency.npn: If provided, must exist in NIPR (validated via free NIPR lookup)
+     * - principal.email: Must be unique within the tenant
+     * - principal.npn: Must exist in NIPR (validated via free NIPR lookup)
+     * - All producer emails must be unique within the tenant
+     *
+     * Returns:
+     * IDs of the created agency, principal, optional producers, and locations (if provided).
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Missing required fields, entity type rule violations, or
+     *   NPN not found in NIPR
+     * - ALREADY_EXISTS: Email or NPN already registered in your tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.NewAgency
      */
@@ -4936,8 +5661,41 @@ export declare const ProducerService: GenService<{
         output: typeof NewAgencyResponseSchema;
     };
     /**
-     * ListAgencies returns a list of agencies associated with the tenant.
-     * Supports optional filtering by organization ID and search queries.
+     * ListAgencies retrieves a paginated list of agencies associated with the tenant.
+     *
+     * This endpoint provides comprehensive agency listing with powerful filtering
+     * capabilities to efficiently manage and search through large numbers of
+     * agencies. Each agency in the response includes summary information for
+     * quick overview without the full NIPR data.
+     *
+     * Filtering Capabilities:
+     * - Organization: Filter agencies belonging to a specific organization
+     * - Search: Free-text search across agency name, NPN, and email
+     * - Agency Type: Filter by internal (tenant) vs external agencies
+     * - Entity Type: Filter by sole proprietor vs standard agency
+     * - NIPR Sync Status: Filter by synchronization state (active, failing, pending, disabled)
+     *
+     * The response uses cursor-based pagination for efficient data retrieval:
+     * - Default page size is 50 if not specified
+     * - Maximum page size is 200
+     * - Results are ordered by creation date, most recent first
+     * - Use the next_page_token to retrieve subsequent pages
+     *
+     * Validation Rules:
+     * All fields are optional filters:
+     * - organization_id: If provided, must be a valid UUID format
+     * - search_query: Optional free-text search string (case-insensitive, partial matching)
+     * - pagination.page_size: Must be <= 200. Default is 50 if not specified.
+     * - pagination.page_token: Opaque token from previous response for pagination
+     * - agency_type: If provided, must be AGENCY_TYPE_INTERNAL (1) or AGENCY_TYPE_EXTERNAL (2)
+     * - entity_type: If provided, must be ENTITY_TYPE_SOLE_PROPRIETOR (1) or ENTITY_TYPE_AGENCY (2)
+     * - nipr_sync_statuses: Array of sync states to filter by (ACTIVE, FAILING, PENDING, DISABLED)
+     *
+     * Returns:
+     * A paginated list of AgencySummary objects containing essential agency
+     * information without full NIPR data. Use GetAgencyAndProducers for complete
+     * agency details including NIPR data.
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ListAgencies
      */
@@ -4947,9 +5705,28 @@ export declare const ProducerService: GenService<{
         output: typeof ListAgenciesResponseSchema;
     };
     /**
-     * ListOrganizations returns a list of organizations associated with the tenant.
-     * Organizations represent logical groupings or hierarchical structures within a tenant
-     * that can be used to organize agencies and producers.
+     * ListOrganizations retrieves all organizations accessible to your tenant.
+     *
+     * Organizations represent logical groupings or hierarchical structures for
+     * managing agencies. They enable better organization of agencies into business
+     * units, networks, or aggregator relationships. Each
+     * organization can contain multiple agencies, allowing for hierarchical
+     * management and reporting across your insurance distribution network.
+     *
+     * Not all tenants use organizations - this list may be empty if your tenant
+     * doesn't have organizational hierarchies enabled.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * All fields are optional:
+     * - pagination.page_size: Must be <= 200. Default is 50 if not specified.
+     * - pagination.page_token: Opaque token from previous response for pagination
+     *
+     * Returns:
+     * A list of all organizations accessible to your tenant, including their IDs,
+     * names and external identifiers. Organizations are
+     * returned in alphabetical order by name for consistent presentation.
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ListOrganizations
      */
@@ -4959,8 +5736,25 @@ export declare const ProducerService: GenService<{
         output: typeof ListOrganizationsResponseSchema;
     };
     /**
-     * GetOrganization retrieves details of a specific organization by ID.
-     * Returns the organization's information including name and external ID.
+     * GetOrganization retrieves comprehensive details about a specific organization.
+     *
+     * This endpoint returns complete organization information including all
+     * agencies assigned to it. For each agency, it provides summary data including
+     * appointment overview statistics and NIPR synchronization status. This allows
+     * you to understand the full scope of an organization's agency network in a
+     * single API call.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - organization_id: Required, must be a valid UUID format
+     *
+     * Returns:
+     * Complete organization details including all assigned agencies with their
+     * appointment overviews and sync statuses.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Organization doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.GetOrganization
      */
@@ -4970,9 +5764,88 @@ export declare const ProducerService: GenService<{
         output: typeof GetOrganizationResponseSchema;
     };
     /**
-     * NewProducer creates a new producer and associates them with an existing agency.
-     * It validates the producer's information and checks that the email is unique.
-     * Returns the ID of the created producer.
+     * CreateOrganization creates a new organization for the authenticated tenant.
+     *
+     * Organizations are top-level groupings used to organize agencies within your
+     * tenant. They can represent business units, regions, or any logical grouping
+     * that makes sense for your operations.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - name: Required, must be non-empty
+     * - external_id: Optional, your system's identifier for the organization
+     * - email: Optional, contact email for the organization
+     *
+     * Business logic validation:
+     * - name: Must be unique within the tenant (case-insensitive)
+     *
+     * Returns:
+     * The UUID of the newly created organization, which can be used to assign
+     * agencies to this organization.
+     *
+     * Common Error Codes:
+     * - ALREADY_EXISTS: Organization with the same name already exists in tenant
+     *
+     *
+     * @generated from rpc producerflow.producer.v1.ProducerService.CreateOrganization
+     */
+    createOrganization: {
+        methodKind: "unary";
+        input: typeof CreateOrganizationRequestSchema;
+        output: typeof CreateOrganizationResponseSchema;
+    };
+    /**
+     * NewProducer adds a single producer to an existing agency.
+     *
+     * Use this endpoint to programmatically add producers to agencies. This is
+     * the programmatic alternative to CreateProducerOnboardingURL.
+     *
+     * NIPR Validation and Sync:
+     * The system validates the provided NPN exists in NIPR using a free API
+     * lookup. If sync_with_nipr is enabled, the system performs a paid NIPR
+     * EntityInfo lookup to fetch complete license, appointment, and regulatory
+     * data.
+     *
+     * Validation Performed:
+     * - Email is unique within tenant
+     * - Agency exists and belongs to tenant
+     * - NPN exists in NIPR
+     * - Location IDs exist and belong to the agency (if provided)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - producer: Required, contains producer information
+     *   - first_name: Required, must be non-empty
+     *   - last_name: Required, must be non-empty
+     *   - email: Required, must be a valid email format
+     *   - npn: Required, used for NIPR validation
+     *   - phone: Optional, if provided must match E.164 pattern (e.g., +15551234567)
+     *   - mailing_address (optional, if provided):
+     *     - street: Required, must be non-empty
+     *     - city: Required, must be non-empty
+     *     - state: Required, must be exactly 2 characters (state code)
+     *     - zip: Required, must be 1-10 characters
+     *   - tenant_id: Optional, maximum 255 characters (external identifier)
+     *   - location_ids: Optional, maximum 100 items, each must be a valid UUID
+     * - sync_with_nipr: Optional, overrides tenant default NIPR sync setting
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - email: Must be unique within the tenant (not already used by another producer or contact)
+     * - npn: Must exist in NIPR and the provided last name must match the NIPR records
+     * - npn: Must be unique within the tenant (not already assigned to another producer)
+     * - location_ids: All locations must exist and belong to the specified agency
+     *
+     * Returns:
+     * The UUID of the created producer.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or producer NPN not found in NIPR
+     * - ALREADY_EXISTS: Producer with email or NPN already exists in tenant
+     * - INVALID_ARGUMENT: Producer NPN is required (when NPN validation is enabled)
+     * - FAILED_PRECONDITION: Producer name does not match NIPR records for the provided NPN
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.NewProducer
      */
@@ -4982,9 +5855,68 @@ export declare const ProducerService: GenService<{
         output: typeof NewProducerResponseSchema;
     };
     /**
-     * NewProducers creates multiple producers and associates them with the specified agency.
-     * It performs the same validations as NewProducer for each entry.
-     * Returns the IDs of all created producers.
+     * NewProducers creates multiple producers in bulk and associates them with a single agency.
+     *
+     * This endpoint provides an efficient way to onboard multiple producers to the same
+     * agency in a single API call.
+     *
+     * Bulk Operation Behavior:
+     * Producers are created sequentially. If a producer fails validation, the request
+     * returns an error, but any producers created before the failure will remain in
+     * the system. Each producer in the request undergoes the same validation as
+     * individual NewProducer calls.
+     *
+     * NIPR Validation and Sync:
+     * For each producer:
+     * - The system performs a free NIPR API lookup to validate the NPN exists
+     * - If sync_with_nipr is true (or tenant default), performs paid NIPR EntityInfo lookups
+     * - All NIPR validations must succeed for the bulk operation to proceed
+     *
+     * Validation Performed (for each producer):
+     * - Required fields are present and valid (name, email, NPN)
+     * - Email addresses are unique within the tenant
+     * - Agency exists and belongs to the authenticated tenant
+     * - NPNs exist in NIPR
+     * - Location IDs exist and belong to the agency (if provided)
+     * - Phone numbers match valid patterns (if provided)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - producers: Required, must contain at least 1 producer. Each producer:
+     *   - first_name: Required, must be non-empty
+     *   - last_name: Required, must be non-empty
+     *   - email: Required, must be a valid email format
+     *   - npn: Required, used for NIPR validation
+     *   - phone: Optional, if provided must match E.164 pattern (e.g., +15551234567)
+     *   - mailing_address (optional, if provided):
+     *     - street: Required, must be non-empty
+     *     - city: Required, must be non-empty
+     *     - state: Required, must be exactly 2 characters (state code)
+     *     - zip: Required, must be 1-10 characters
+     *   - tenant_id: Optional, maximum 255 characters (external identifier)
+     *   - location_ids: Optional, maximum 100 items per producer, each must be a valid UUID
+     * - sync_with_nipr: Optional, overrides tenant default NIPR sync setting for all producers
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - All producer emails must be unique within the tenant
+     * - All producer NPNs must exist in NIPR, match the provided last name, and be unique within the tenant
+     * - All location_ids must exist and belong to the specified agency
+     * - This is an all-or-nothing operation: if any producer fails validation, no producers
+     *   are created
+     *
+     * Returns:
+     * List of UUIDs for all created producers in the same order as the request. This
+     * ordering guarantee allows you to map request entries to their created IDs.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or producer NPN not found in NIPR
+     * - ALREADY_EXISTS: Producer with email or NPN already exists in tenant
+     * - INVALID_ARGUMENT: Producer NPN is required (when NPN validation is enabled)
+     * - FAILED_PRECONDITION: Producer name does not match NIPR records for the provided NPN
+     * - PERMISSION_DENIED: Agency doesn't belong to the authenticated tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.NewProducers
      */
@@ -4994,8 +5926,29 @@ export declare const ProducerService: GenService<{
         output: typeof NewProducersResponseSchema;
     };
     /**
-     * GetAgencyAndProducers retrieves details for an agency and all associated producers.
-     * Returns the agency information and a list of producers.
+     * GetAgencyAndProducers retrieves complete information for an agency and all
+     * its producers.
+     *
+     * This endpoint returns comprehensive agency details including:
+     * - Agency contact information and business details
+     * - Principal producer information
+     * - Bank account for commission payments
+     * - Errors & Omissions insurance details
+     * - Business hours and contact points
+     * - NIPR synchronized data (licenses, appointments, regulatory actions, addresses)
+     * - All associated producers with their NIPR data
+     * - Agency locations
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     *
+     * Returns:
+     * Agency object with complete NIPR data and list of all associated producers.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.GetAgencyAndProducers
      */
@@ -5006,8 +5959,38 @@ export declare const ProducerService: GenService<{
     };
     /**
      * GetProducer retrieves detailed information about a specific producer.
-     * The producer can be found by ID, NPN, or email.
-     * Returns the producer's information, including NIPR data and agency association.
+     *
+     * Supports three lookup methods:
+     * - By producer ID (UUID)
+     * - By NPN (National Producer Number)
+     * - By email address
+     *
+     * The response includes:
+     * - Producer contact information (name, email, phone, address)
+     * - Associated agency information
+     * - NIPR synchronized data:
+     *   - State licenses with expiration dates and Lines of Authority (LOAs)
+     *   - Biographic information (name, DOB, state of domicile)
+     *   - Regulatory actions by state
+     *   - Carrier appointments with status and renewal dates
+     * - Location assignments
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * Exactly one lookup method must be provided (oneof required):
+     * - producer_id_lookup.producer_id: Must be a valid UUID format
+     * - npn_lookup.producer_npn: Must be non-empty string
+     * - email_lookup.email: Must be a valid email format
+     *
+     * Returns:
+     * Complete producer information including all NIPR data.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Producer doesn't exist or doesn't belong to tenant, or
+     *   associated agency not found
+     * - UNIMPLEMENTED: Lookup method not supported (only producer_id, npn, and email
+     *   lookups are implemented)
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.GetProducer
      */
@@ -5017,7 +6000,28 @@ export declare const ProducerService: GenService<{
         output: typeof GetProducerResponseSchema;
     };
     /**
-     * GetAgencyFiles returns URLs for accessing files associated with an agency, such as contracts.
+     * GetAgencyFiles retrieves signed URLs for accessing agency documents.
+     *
+     * Returns pre-signed URLs for the following document types:
+     * - Errors & Omissions (E&O) insurance certificate
+     * - Voided check for ACH commission payments
+     * - W9 tax form
+     * - License documents
+     * - Broker bond documents
+     *
+     * The URLs are time-limited and grant temporary read access to the documents.
+     * Empty strings are returned for documents that haven't been uploaded.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     *
+     * Returns:
+     * A set of pre-signed URLs for accessing agency documents.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.GetAgencyFiles
      */
@@ -5027,11 +6031,49 @@ export declare const ProducerService: GenService<{
         output: typeof GetAgencyFilesResponseSchema;
     };
     /**
-     * UpdateProducer updates information for an existing producer.
-     * Supports updating contact details, background check responses,
-     * employment history, and non-uniform licensing questions.
-     * Information from NIPR and other third-party sources cannot be updated.
-     * Validates email uniqueness if the email is changed.
+     * UpdateProducer updates editable fields for an existing producer.
+     *
+     * Only information collected during onboarding can be updated via this
+     * endpoint. NIPR-sourced data (licenses, appointments, regulatory actions) is
+     * read-only and can only be updated by triggering a NIPR sync via
+     * SyncProducerWithNIPR.
+     *
+     * Updatable Fields:
+     * - Contact information (first_name, last_name, middle_name, email, phone)
+     * - Mailing address (street, city, state, zip)
+     * - External metadata (for tenant-specific data)
+     *
+     * Note: NPN cannot be updated after creation. The NPN field is deprecated
+     * in UpdateProducerRequest.Producer and will be ignored.
+     *
+     * Validation:
+     * - Email must be unique within tenant if changed
+     * - All field format validations apply (e.g., valid email format, phone pattern)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - producer_id: Required, must be a valid UUID format
+     * - producer: Required, contains fields to update (all fields optional):
+     *   - first_name: If provided, must be non-empty
+     *   - last_name: If provided, must be non-empty
+     *   - middle_name: If provided, must be non-empty
+     *   - email: If provided, must be a valid email format
+     *   - npn: Deprecated and ignored - NPN cannot be updated after creation
+     *   - phone: If provided, must match E.164 pattern (e.g., +15551234567)
+     *   - street: If provided, must be non-empty
+     *   - city: If provided, must be non-empty
+     *   - state: If provided, must be at most 2 characters
+     *   - zip: If provided, must be at least 5 characters
+     *   - external_metadata: Map of key-value pairs for tenant-specific data
+     *
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Producer doesn't exist or doesn't belong to tenant
+     * - INVALID_ARGUMENT: Producer field is missing in request
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.UpdateProducer
      */
@@ -5041,12 +6083,59 @@ export declare const ProducerService: GenService<{
         output: typeof UpdateProducerResponseSchema;
     };
     /**
-     * UpdateAgency updates information for an existing agency.
-     * Supports updating contact details (email, phone, fax), website, physical address,
-     * requested appointments, and notes.
-     * Information from NIPR and other third-party sources cannot be updated.
+     * UpdateAgency updates editable fields for an existing agency.
+     *
+     * Only information collected during onboarding can be updated via this
+     * endpoint. NIPR-sourced data (licenses, appointments, regulatory actions) is
+     * read-only and can only be updated by triggering a NIPR sync via
+     * SyncAgencyWithNIPR.
+     *
+     * Updatable Fields:
+     * - Contact details (email, phone, fax)
+     * - Website URL
+     * - Physical address components
+     * - Requested appointments (state codes)
+     * - Notes
+     * - External metadata (for tenant-specific data)
+     *
      * All fields are optional - only provide the fields you want to update.
-     * Validates email uniqueness if the email is changed.
+     * Unchanged fields retain their current values.
+     *
+     * Validation:
+     * - Email must be unique within tenant if changed
+     * - All field format validations apply
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - agency: Required, contains fields to update (all fields optional):
+     *   - email: If provided, must be a valid email format
+     *   - phone: If provided, must match E.164 pattern (e.g., +15551234567)
+     *   - fax: If provided, must match E.164 pattern
+     *   - website: If provided, must be a valid URI format
+     *   - requested_appointments: Array of unique 2-letter state codes (e.g., ["CA", "NY"])
+     *   - notes: If provided, maximum 500 characters
+     *   - physical_address (optional, if provided):
+     *     - street: If provided, must be non-empty
+     *     - city: If provided, must be non-empty
+     *     - state: If provided, must be exactly 2 characters
+     *     - zip: If provided, must be 1-10 characters
+     *   - external_metadata: Map of key-value pairs for tenant-specific data
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - email: If changed, must be unique within the tenant (case-insensitive comparison)
+     * - phone: If provided, must be a valid phone number format
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     * - ALREADY_EXISTS: Email already exists within tenant
+     * - INVALID_ARGUMENT: Invalid phone number format or all address fields required
+     *   when creating new address
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.UpdateAgency
      */
@@ -5057,8 +6146,48 @@ export declare const ProducerService: GenService<{
     };
     /**
      * NewContact creates a new contact associated with an agency.
-     * Contacts represent non-producer individuals linked to the agency.
-     * Returns the ID of the created contact.
+     *
+     * Use this endpoint to programmatically add non-producer individuals to
+     * agencies. Contacts represent staff members, administrators, or other
+     * personnel who are not licensed insurance producers but need to be
+     * associated with the agency for communication or administrative purposes.
+     *
+     * Validation Performed:
+     * - Agency exists and belongs to the authenticated tenant
+     * - Email is unique within the tenant (across both producers and contacts)
+     * - Required fields are present and valid (first name, last name, email, role)
+     * - Phone number matches valid pattern (if provided)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - contact: Required, contains contact information:
+     *   - first_name: Required, must be non-empty
+     *   - last_name: Required, must be non-empty
+     *   - email: Required, must be a valid email format
+     *   - role: Required, must be non-empty
+     *   - phone: Optional, if provided must match E.164 pattern (e.g., +15551234567)
+     *   - middle_name: Optional
+     *   - address (optional, if provided):
+     *     - street: Required, must be non-empty
+     *     - city: Required, must be non-empty
+     *     - state: Required, must be exactly 2 characters (state code)
+     *     - zip: Required, must be 1-10 characters
+     *   - tenant_id: Optional, maximum 255 characters (external identifier)
+     *   - npn: Optional
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - email: Must be unique within the tenant (not already used by another producer or contact)
+     *
+     * Returns:
+     * The UUID of the created contact.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Missing required fields or invalid field format
+     * - ALREADY_EXISTS: Email already registered in your tenant
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.NewContact
      */
@@ -5068,9 +6197,59 @@ export declare const ProducerService: GenService<{
         output: typeof NewContactResponseSchema;
     };
     /**
-     * NewContacts creates multiple contacts in a single request.
-     * Each contact is associated with the specified agency.
-     * Returns the IDs of all created contacts.
+     * NewContacts creates multiple contacts in bulk and associates them with a
+     * single agency.
+     *
+     * This endpoint provides an efficient way to add multiple non-producer
+     * contacts to the same agency in a single API call. Contacts represent staff
+     * members, administrators, or other personnel who are not licensed insurance
+     * producers.
+     *
+     * Partial Success Behavior:
+     * Unlike bulk producer operations, this endpoint uses partial success
+     * semantics. Contacts that pass validation are created even if other contacts
+     * in the request fail. The response contains only the IDs of successfully
+     * created contacts.
+     *
+     * Validation Performed (for each contact):
+     * - Agency exists and belongs to the authenticated tenant
+     * - Email is unique within the tenant (across both producers and contacts)
+     * - Required fields are present and valid (first name, last name, email, role)
+     * - Phone number matches valid pattern (if provided)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - contacts: Required, must contain at least 1 contact. Each contact:
+     *   - first_name: Required, must be non-empty
+     *   - last_name: Required, must be non-empty
+     *   - email: Required, must be a valid email format
+     *   - role: Required, must be non-empty
+     *   - phone: Optional, if provided must match E.164 pattern (e.g., +15551234567)
+     *   - middle_name: Optional
+     *   - address (optional, if provided):
+     *     - street: Required, must be non-empty
+     *     - city: Required, must be non-empty
+     *     - state: Required, must be exactly 2 characters (state code)
+     *     - zip: Required, must be 1-10 characters
+     *   - tenant_id: Optional, maximum 255 characters (external identifier)
+     *   - npn: Optional
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - Each contact email: Must be unique within the tenant. Contacts with duplicate
+     *   emails are skipped (partial success - other valid contacts are still created)
+     *
+     * Returns:
+     * List of UUIDs for successfully created contacts. If some contacts failed
+     * validation, only the IDs of successfully created contacts are returned.
+     * Failed contacts are logged but not included in the response. The order of
+     * returned IDs corresponds to the order of successful contacts, not the
+     * original request order.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.NewContacts
      */
@@ -5081,7 +6260,30 @@ export declare const ProducerService: GenService<{
     };
     /**
      * ListAgencyContacts retrieves all contacts associated with an agency.
-     * Returns a list of contacts with their full details.
+     *
+     * Use this endpoint to fetch all non-producer contacts linked to a specific
+     * agency. Contacts represent staff members, administrators, or other
+     * personnel who are not licensed insurance producers but are associated with
+     * the agency.
+     *
+     * The response includes complete contact information:
+     * - Personal details (name, email, phone)
+     * - Role within the agency
+     * - Mailing address
+     * - NPN (if applicable)
+     * - Creation timestamp
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     *
+     * Returns:
+     * A list of all contacts associated with the specified agency. Returns an
+     * empty list if the agency has no contacts.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ListAgencyContacts
      */
@@ -5091,8 +6293,55 @@ export declare const ProducerService: GenService<{
         output: typeof ListAgencyContactsResponseSchema;
     };
     /**
-     * SetExternalID sets an external identifier for a producer or contact.
-     * Useful for integrating with external systems that use different ID schemes.
+     * SetExternalID sets an external identifier for a producer, agency, contact,
+     * or organization.
+     *
+     * Use this endpoint to link ProducerFlow entities to corresponding records in
+     * your external systems (CRM, AMS, legacy databases). This enables bi-directional
+     * synchronization and lookups across systems.
+     *
+     * Supported Entity Types:
+     * - Producer: Links a producer to an external system record
+     * - Agency: Links an agency to an external system record
+     * - Contact: Links a contact to an external system record
+     * - Organization: Links an organization to an external system record
+     *
+     * Exactly one entity type must be specified per request.
+     *
+     * Validation Performed:
+     * - Exactly one entity ID is provided (producer_id, agency_id, contact_id, or organization_id)
+     * - The external ID (tenant_id) is non-empty and at most 255 characters
+     * - The external ID is unique within the tenant (not already assigned to another entity)
+     * - The specified entity exists and belongs to the authenticated tenant
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * Exactly one entity ID must be provided (oneof required):
+     * - producer_id: Must be a valid UUID format
+     * - agency_id: Must be a valid UUID format
+     * - contact_id: Must be a valid UUID format
+     * - organization_id: Must be a valid UUID format
+     *
+     * Required field:
+     * - tenant_id: Required, must be 1-255 characters (the external identifier to assign)
+     *
+     * Business logic validation:
+     * - tenant_id: Must be unique within the tenant (not already assigned to any other entity)
+     * - Entity must exist and belong to the authenticated tenant:
+     *   - Producer: Verified via tenant-scoped lookup
+     *   - Contact: Verified via tenant-scoped lookup
+     *   - Agency: Verified via tenant-scoped lookup and tenant ownership check
+     *   - Organization: Verified via tenant-scoped lookup and tenant ownership check
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: No entity ID provided or external ID validation failed
+     * - NOT_FOUND: The specified entity doesn't exist or doesn't belong to tenant
+     * - ALREADY_EXISTS: The external ID is already assigned to another entity in the tenant
+     * - PERMISSION_DENIED: The entity doesn't belong to the authenticated tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.SetExternalID
      */
@@ -5102,9 +6351,36 @@ export declare const ProducerService: GenService<{
         output: typeof SetExternalIDResponseSchema;
     };
     /**
-     * ValidateProducerNPN checks whether a producer’s National Producer Number (NPN) is valid.
-     * It performs a lookup against NIPR and applies internal validation rules.
-     * Returns a validity flag and any associated error messages.
+     * ValidateProducerNPN checks whether a producer's National Producer Number (NPN)
+     * exists in NIPR.
+     *
+     * Use this endpoint to verify an NPN is valid before creating a producer. This
+     * is a free NIPR API lookup that does not count against your monthly billing
+     * quota.
+     *
+     * Validation Modes:
+     * - NPN only: Validates that the NPN exists in NIPR
+     * - NPN with name: Validates that the NPN exists AND the name matches the NIPR
+     *   record (recommended for additional verification)
+     *
+     * NIPR Billing:
+     * This is a FREE operation. It uses the NIPR NPN Lookup service which does not
+     * incur charges, unlike the other NIPR entity lookups used during sync operations.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - npn: Required, must be non-empty string
+     * - name: Optional, if provided validates NPN matches this producer name in NIPR
+     *
+     * Business logic validation:
+     * - NPN is validated against NIPR database via free NIPR NPN Lookup API
+     * - If name is provided, both NPN and name must match a producer record in NIPR
+     * - If name is not provided, only NPN existence is verified
+     *
+     * Returns:
+     * A boolean indicating whether the NPN is valid. Returns true if the NPN exists
+     * in NIPR (and name matches, if provided), false otherwise.
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ValidateProducerNPN
      */
@@ -5114,9 +6390,29 @@ export declare const ProducerService: GenService<{
         output: typeof ValidateProducerNPNResponseSchema;
     };
     /**
-     * ValidateAgencyNPN checks whether an agency’s National Producer Number (NPN) is valid.
-     * It performs a lookup against NIPR and applies internal validation rules.
-     * Returns a validity flag and any associated error messages.
+     * ValidateAgencyNPN checks whether an agency's National Producer Number (NPN)
+     * exists in NIPR.
+     *
+     * Use this endpoint to verify an agency NPN is valid before creating an agency.
+     * This is a free NIPR API lookup that does not count against your monthly
+     * billing quota.
+     *
+     * NIPR Billing:
+     * This is a FREE operation. It uses the NIPR NPN Lookup service which does not
+     * incur charges, unlike the NIPR entity lookups used during sync operations.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - npn: Required, must be non-empty string
+     *
+     * Business logic validation:
+     * - NPN is validated against NIPR database via free NIPR NPN Lookup API
+     * - Agency NPN must exist in NIPR's agency records
+     *
+     * Returns:
+     * A boolean indicating whether the agency NPN is valid. Returns true if the NPN
+     * exists in NIPR, false otherwise.
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ValidateAgencyNPN
      */
@@ -5126,9 +6422,31 @@ export declare const ProducerService: GenService<{
         output: typeof ValidateAgencyNPNResponseSchema;
     };
     /**
-     * LookupNPNByFEIN finds an NPN using a Federal Employer Identification Number.
-     * Used to help agencies that know their FEIN but not their NPN.
-     * Returns the NPN if found or an error message.
+     * LookupNPNByFEIN finds an agency's NPN using their Federal Employer
+     * Identification Number (FEIN).
+     *
+     * Use this endpoint to help agencies discover their NPN when they only know
+     * their FEIN. This is common during onboarding when agencies may not have
+     * their NPN readily available but know their tax identification number.
+     *
+     * NIPR Billing:
+     * This is a FREE operation. It uses the NIPR NPN Lookup service which does not
+     * incur charges, unlike the EntityInfo lookups used during sync operations.
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - fein: Required, must be exactly 9 characters
+     *
+     * Business logic validation:
+     * - FEIN is looked up against NIPR database via free NIPR NPN Lookup API
+     * - Agency with the given FEIN must exist in NIPR's records
+     *
+     * Returns:
+     * The agency's NPN if found in NIPR.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: No agency found in NIPR with the given FEIN
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.LookupNPNByFEIN
      */
@@ -5138,7 +6456,13 @@ export declare const ProducerService: GenService<{
         output: typeof LookupNPNByFEINResponseSchema;
     };
     /**
-     * ResyncProducer triggers a manual resynchronization of a producer's data. This can be used to refresh data after external changes. WARNING: This call counts as an additional NPN lookup for billing purposes. Most billing plans are based on unique NPNs per month, so using this method may result in extra charges.
+     * ResyncProducer triggers a manual resynchronization of a producer's data.
+     * This can be used to refresh data after external change
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Producer doesn't exist or doesn't belong to tenant
+     * - INVALID_ARGUMENT: Producer ID is empty
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ResyncProducer
      */
@@ -5148,7 +6472,12 @@ export declare const ProducerService: GenService<{
         output: typeof ResyncProducerResponseSchema;
     };
     /**
-     * ResyncAgency triggers a manual resynchronization of an agency's data. Similar to ResyncProducer, this can be used to refresh data after external changes. WARNING: This call counts as an additional NPN lookup for billing purposes. Most billing plans are based on unique NPNs per month, so using this method may result in extra charges.
+     * ResyncAgency triggers a manual resynchronization of an agency's data. Similar
+     * to ResyncProducer, this can be used to refresh data after external changes.
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     * - INVALID_ARGUMENT: Agency ID is empty or request is empty
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ResyncAgency
      */
@@ -5158,7 +6487,46 @@ export declare const ProducerService: GenService<{
         output: typeof ResyncAgencyResponseSchema;
     };
     /**
-     * SyncProducerWithNIPR synchronizes a producer's data with the NIPR system. Fetches the latest producer information and appointments. WARNING: This call counts as an extra NPN lookup against your billing. Most billing plans are based on unique NPNs per month, so using this method may result in additional charges.
+     * SyncProducerWithNIPR synchronizes a producer's data with NIPR.
+     *
+     * Use this endpoint to manually trigger an immediate refresh of producer data
+     * from NIPR. The operation validates the producer NPN exists in NIPR before
+     * syncing.
+     *
+     * What Gets Synchronized:
+     * - State licenses with expiration dates and Lines of Authority
+     * - Carrier appointments with status and renewal dates
+     * - Regulatory actions and disciplinary history
+     * - Biographic information (name, DOB, state of domicile)
+     * - Address by state
+     *
+     * Preconditions:
+     * - Producer must exist and belong to the authenticated tenant
+     * - Producer must have a valid NPN registered in NIPR
+     * - Producer must not already be in active sync state
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - producer_id: Required, must be a valid UUID format
+     *
+     * Business logic validation:
+     * - producer_id: Producer must exist and belong to the authenticated tenant
+     * - Producer must have an NPN assigned (cannot sync a producer without NPN)
+     * - Producer's NPN must exist in NIPR (validated via NIPR NPN Lookup API)
+     * - Producer must not already be in ACTIVE sync state (prevents redundant syncs)
+     *
+     * Timeout: 30 seconds. If NIPR takes longer, you'll receive a
+     * DEADLINE_EXCEEDED error.
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Producer doesn't exist or doesn't belong to tenant
+     * - INVALID_ARGUMENT: Producer has no NPN or NPN is not registered in NIPR
+     * - FAILED_PRECONDITION: Producer is already synced with NIPR (ACTIVE sync state)
+     * - DEADLINE_EXCEEDED: NIPR sync took longer than 30 seconds
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.SyncProducerWithNIPR
      */
@@ -5168,7 +6536,53 @@ export declare const ProducerService: GenService<{
         output: typeof SyncProducerWithNIPRResponseSchema;
     };
     /**
-     * SyncAgencyWithNIPR synchronizes an agency's data with the NIPR system. Fetches the latest agency information and appointments. WARNING: This call counts as an extra NPN lookup against your billing. Most billing plans are based on unique NPNs per month, so using this method may result in additional charges.
+     * SyncAgencyWithNIPR synchronizes an agency's data with NIPR.
+     *
+     * Use this endpoint to manually trigger an immediate refresh of agency data
+     * from NIPR. The operation validates the agency NPN exists in NIPR before
+     * syncing.
+     *
+     * What Gets Synchronized:
+     * - Agency biographic information (company name, FEIN, contact details)
+     * - State licenses with expiration dates and Lines of Authority
+     * - Carrier appointments with status and renewal dates
+     * - Regulatory actions and disciplinary history
+     * - Address history by state
+     *
+     * Bulk Producer Sync:
+     * When sync_all_producers is set to true, the system will also sync all
+     * producers associated with the agency. This extends the timeout to 10
+     * minutes to accommodate the additional operations. Each producer sync is
+     * a separate billable NIPR lookup.
+     *
+     * Preconditions:
+     * - Agency must exist and belong to the authenticated tenant
+     * - Agency must have a valid NPN registered in NIPR
+     * - Agency must not already be in active sync state
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - sync_all_producers: Optional boolean, defaults to false
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - Agency's NPN must exist in NIPR (validated via NIPR NPN Lookup API)
+     * - Agency must not already be in ACTIVE sync state (prevents redundant syncs)
+     *
+     * Timeout:
+     * - 30 seconds when syncing agency only
+     * - 10 minutes when sync_all_producers is true
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     * - INVALID_ARGUMENT: Agency NPN is not valid (not found in NIPR)
+     * - FAILED_PRECONDITION: Agency is already synced with NIPR (ACTIVE sync state)
+     * - DEADLINE_EXCEEDED: NIPR sync operation timed out (30s for agency only, 10m with sync_all_producers)
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.SyncAgencyWithNIPR
      */
@@ -5178,8 +6592,35 @@ export declare const ProducerService: GenService<{
         output: typeof SyncAgencyWithNIPRResponseSchema;
     };
     /**
-     * StopSyncProducerWithNIPR stops the synchronization process with NIPR for a producer.
-     * Use this to prevent further automatic updates from NIPR.
+     * StopSyncProducerWithNIPR disables automatic NIPR synchronization for a producer.
+     *
+     * Use this endpoint to stop receiving automatic updates from NIPR for a
+     * specific producer. Once stopped, the producer's NIPR data will no longer
+     * be refreshed via PDB Alerts or other automatic sync mechanisms.
+     *
+     * This does not delete existing NIPR data - it only prevents future updates.
+     * To re-enable synchronization, use the SyncProducerWithNIPR endpoint.
+     *
+     * Preconditions:
+     * - Producer must exist and belong to the authenticated tenant
+     * - Producer must be in active or failing sync state (not already disabled/pending)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - producer_id: Required, must be a valid UUID format
+     *
+     * Business logic validation:
+     * - producer_id: Producer must exist and belong to the authenticated tenant
+     * - Producer must be in ACTIVE or FAILING sync state (cannot stop if already
+     *   DISABLED or PENDING)
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Producer doesn't exist or doesn't belong to tenant
+     * - FAILED_PRECONDITION: Producer is already unsynced (DISABLED or PENDING sync state)
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.StopSyncProducerWithNIPR
      */
@@ -5189,8 +6630,43 @@ export declare const ProducerService: GenService<{
         output: typeof StopSyncProducerWithNIPRResponseSchema;
     };
     /**
-     * StopSyncAgencyWithNIPR stops the synchronization process with NIPR for an agency.
-     * Use this to prevent further automatic updates from NIPR.
+     * StopSyncAgencyWithNIPR disables automatic NIPR synchronization for an agency.
+     *
+     * Use this endpoint to stop receiving automatic updates from NIPR for a
+     * specific agency. Once stopped, the agency's NIPR data will no longer be
+     * refreshed via PDB Alerts or other automatic sync mechanisms.
+     *
+     * This does not delete existing NIPR data - it only prevents future updates.
+     * To re-enable synchronization, use the SyncAgencyWithNIPR endpoint.
+     *
+     * Bulk Producer Stop:
+     * When stop_all_producers is set to true, the system will also stop sync for
+     * all producers associated with the agency. This is useful when offboarding
+     * an entire agency from NIPR synchronization. When this flag is set, the
+     * precondition check for agency sync state is bypassed.
+     *
+     * Preconditions:
+     * - Agency must exist and belong to the authenticated tenant
+     * - Agency must be in active or failing sync state (unless stop_all_producers is true)
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - stop_all_producers: Optional boolean, defaults to false
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - Unless stop_all_producers is true, agency must be in ACTIVE or FAILING sync
+     *   state (cannot stop if already DISABLED or PENDING)
+     *
+     * Returns:
+     * Empty response on success.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     * - FAILED_PRECONDITION: Agency is already unsynced (DISABLED or PENDING sync state,
+     *   unless stop_all_producers is true)
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.StopSyncAgencyWithNIPR
      */
@@ -5200,7 +6676,54 @@ export declare const ProducerService: GenService<{
         output: typeof StopSyncAgencyWithNIPRResponseSchema;
     };
     /**
-     * CreateProducerUploadURL generates a URL that can be used to upload new producers for an existing agency. The agency is identified by its NPN, and the URL can be shared with the agency to allow them to upload producer information securely. The URL is time-limited and includes necessary security tokens. A default expiration of 7 days will be used. The agency must: Exist and belong to the authenticated tenant. Have a valid NPN. Returns a URL string that can be shared with the agency for producer uploads. Returns errors in the following cases: INVALID_ARGUMENT: if agency NPN is empty or invalid format. NOT_FOUND: if agency NPN doesn't exist. INTERNAL: for other unexpected errors.
+     * CreateProducerUploadURL generates a secure URL for bulk producer uploads to
+     * an existing agency.
+     *
+     * Use this endpoint to create a shareable link that allows agencies to upload
+     * multiple producers at once. The URL includes security tokens and tenant
+     * context to ensure secure, authenticated access.
+     *
+     * Unlike CreateProducerOnboardingURL which creates a self-service form for a
+     * single producer, this endpoint generates a URL for bulk uploading producer
+     * data (typically via CSV or spreadsheet format).
+     *
+     * The agency is identified by its National Producer Number (NPN), which must
+     * already exist in your tenant. Use ListAgencies or GetAgencyAndProducers to
+     * look up agency NPNs if needed.
+     *
+     * Typical Workflow:
+     * 1. Generate producer upload URL using the agency's NPN
+     * 2. Share URL with agency contact via email or portal
+     * 3. Agency uploads producer data through the URL
+     * 4. System processes uploads, validates NPNs with NIPR, and creates producer
+     *    records
+     * 5. Producers are associated with the agency and optionally synced with NIPR
+     *
+     * URL Expiration:
+     * The generated URL has a default expiration of 7 days. After expiration, a
+     * new URL must be generated.
+     *
+     * Validation Performed:
+     * - Agency NPN format is valid (numeric string, 2-10 digits)
+     * - Agency with the given NPN exists in your tenant
+     * - Agency belongs to the authenticated tenant
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_npn: Required, must be 2-10 digits (numeric characters only)
+     *
+     * Business logic validation:
+     * - Agency with the given NPN must exist in the authenticated tenant
+     * - Agency must belong to the authenticated tenant (ownership verification)
+     * - Only one agency should match the NPN (multiple matches indicate data issue)
+     *
+     * Returns:
+     * A time-limited URL string that can be shared with the agency for bulk
+     * producer uploads.
+     *
+     * Common Error Codes:
+     * - NOT_FOUND: No agency found with the given NPN in your tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.CreateProducerUploadURL
      */
@@ -5210,7 +6733,53 @@ export declare const ProducerService: GenService<{
         output: typeof CreateProducerUploadURLResponseSchema;
     };
     /**
-     * AddAgencyLocations adds one or more locations to an existing agency. Each location must have a unique name within the agency and valid address information. You can add up to 100 locations in a single request. This is a bulk operation with all-or-nothing behavior - if any location fails validation, the entire request will fail and no locations will be added. Returns the IDs of successfully added locations. Returns errors in the following cases: UNAUTHENTICATED: if the API key is invalid or missing. INVALID_ARGUMENT: if the request is nil, agency_id is empty, no locations provided, location names are duplicated within the request or already exist for the agency. NOT_FOUND: if the agency doesn't exist or doesn't belong to the authenticated tenant.
+     * AddAgencyLocations adds one or more locations to an existing agency.
+     *
+     * Use this endpoint to programmatically add physical locations (offices,
+     * branches, etc.) to an agency. Locations enable organizing producers by
+     * their work sites and tracking agency presence across different addresses.
+     *
+     * Bulk Operation Behavior:
+     * This is an all-or-nothing operation - if any location fails validation,
+     * the entire request will fail and no locations will be added. You can add
+     * up to 100 locations in a single request.
+     *
+     * Validation Performed:
+     * - Agency exists and belongs to the authenticated tenant
+     * - At least one location is provided
+     * - Location names are unique within the agency (case-insensitive)
+     * - Location names are not duplicated within the request
+     * - Valid address information is provided for each location
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - locations: Required, 1-100 locations. Each location:
+     *   - name: Required, must be non-empty (unique within agency)
+     *   - address: Required
+     *     - street: Required, must be non-empty
+     *     - city: Required, must be non-empty
+     *     - state: Required, must be exactly 2 characters (state code)
+     *     - zip: Required, must be 1-10 characters
+     *   - phone: Required, must match E.164 pattern (e.g., +15551234567)
+     *   - email: Required, must be a valid email format
+     *   - is_primary: Optional boolean, marks location as primary
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - Location names must be unique within the agency (case-insensitive)
+     * - Location names must not duplicate any existing location names in the agency
+     * - Location names must not duplicate other location names within the same request
+     *
+     * Returns:
+     * List of UUIDs for all created locations in the same order as the request.
+     * This ordering guarantee allows you to map request entries to their created IDs.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Missing agency_id, no locations provided, duplicate
+     *   location names, or location with name already exists in agency
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.AddAgencyLocations
      */
@@ -5220,7 +6789,39 @@ export declare const ProducerService: GenService<{
         output: typeof AddAgencyLocationsResponseSchema;
     };
     /**
-     * RemoveAgencyLocations removes one or more locations from an agency. Locations that don't exist will be silently ignored. Returns the IDs of successfully removed locations. When a location is removed, all the producers associated with that location will be unassigned from that location. Returns errors in the following cases: UNAUTHENTICATED: if the API key is invalid or missing. INVALID_ARGUMENT: if the request is nil, agency_id is empty, or no location_ids provided. NOT_FOUND: if the agency doesn't exist or doesn't belong to the authenticated tenant.
+     * RemoveAgencyLocations removes one or more locations from an agency.
+     *
+     * Use this endpoint to delete locations that are no longer needed. This is
+     * useful when closing branch offices or consolidating agency locations.
+     *
+     * Producer Unassignment:
+     * When a location is removed, all producers assigned to that location are
+     * automatically unassigned. The producers themselves are not deleted - they
+     * remain associated with the agency but without a location assignment.
+     *
+     * Partial Success Behavior:
+     * Locations that don't exist are silently ignored. The response contains only
+     * the IDs of locations that were actually removed.
+     *
+     * Validation Performed:
+     * - At least one location ID is provided
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - location_ids: Required, 1-100 items, each must be a valid UUID format
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - Location IDs that don't exist are silently ignored (partial success)
+     *
+     * Returns:
+     * List of UUIDs for locations that were successfully removed.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Missing agency_id or no location_ids provided
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.RemoveAgencyLocations
      */
@@ -5230,7 +6831,30 @@ export declare const ProducerService: GenService<{
         output: typeof RemoveAgencyLocationsResponseSchema;
     };
     /**
-     * ListAgencyLocations retrieves all locations associated with an agency. Returns errors in the following cases: UNAUTHENTICATED: if the API key is invalid or missing. INVALID_ARGUMENT: if the agency_id is empty. NOT_FOUND: if the agency doesn't exist.
+     * ListAgencyLocations retrieves all locations associated with an agency.
+     *
+     * Use this endpoint to fetch the complete list of physical locations
+     * belonging to an agency. Each location includes its address, contact
+     * information, and primary status.
+     *
+     * The response includes complete location information:
+     * - Location ID and name
+     * - Physical address (street, city, state, zip)
+     * - Contact information (phone, email)
+     * - Primary location indicator
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     *
+     * Returns:
+     * A list of all locations associated with the specified agency. Returns an
+     * empty list if the agency has no locations.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Invalid request
+     * - NOT_FOUND: Agency doesn't exist or doesn't belong to tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.ListAgencyLocations
      */
@@ -5240,7 +6864,45 @@ export declare const ProducerService: GenService<{
         output: typeof ListAgencyLocationsResponseSchema;
     };
     /**
-     * AssignProducerToLocations assigns one or more locations to a producer. The locations must belong to the same agency as the producer. Error cases: UNAUTHENTICATED: Invalid or missing API key. INVALID_ARGUMENT: Empty producer_id or no location_ids. NOT_FOUND: Producer or locations don't exist. PERMISSION_DENIED: Locations don't belong to the producer's agency.
+     * AssignProducerToLocations assigns one or more locations to a producer.
+     *
+     * Use this endpoint to associate a producer with specific agency locations
+     * (branch offices, work sites, etc.). A producer can be assigned to multiple
+     * locations within their agency.
+     *
+     * Location Ownership:
+     * All specified locations must belong to the same agency as the producer.
+     * Cross-agency location assignments are not permitted.
+     *
+     * Idempotent Behavior:
+     * If a producer is already assigned to a location, the assignment is
+     * preserved without error. The response includes all successfully assigned
+     * location IDs.
+     *
+     * Validation Performed:
+     * - Producer exists and belongs to the authenticated tenant
+     * - All location IDs exist and belong to the producer's agency
+     * - At least one location ID is provided
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - producer_id: Required, must be a valid UUID format
+     * - location_ids: Required, 1-100 items, each must be a valid UUID format
+     *
+     * Business logic validation:
+     * - producer_id: Producer must exist and belong to the authenticated tenant
+     * - Producer's agency must exist and belong to the authenticated tenant
+     * - All location_ids must exist and belong to the producer's agency
+     *
+     * Returns:
+     * List of location IDs that were successfully assigned to the producer.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Request is missing
+     * - NOT_FOUND: Producer doesn't exist, agency doesn't exist, or specified
+     *   locations don't exist
+     * - PERMISSION_DENIED: Agency doesn't belong to the authenticated tenant
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.AssignProducerToLocations
      */
@@ -5250,7 +6912,39 @@ export declare const ProducerService: GenService<{
         output: typeof AssignProducerToLocationsResponseSchema;
     };
     /**
-     * UnassignProducerFromLocations removes one or more location assignments from a producer. The locations must belong to the same agency as the producer. Error cases: UNAUTHENTICATED: Invalid or missing API key. INVALID_ARGUMENT: Empty producer_id or no location_ids. NOT_FOUND: Producer doesn't exist.
+     * UnassignProducerFromLocations removes one or more location assignments from
+     * a producer.
+     *
+     * Use this endpoint to disassociate a producer from specific agency locations.
+     * This is useful when producers change work sites or when consolidating
+     * location assignments.
+     *
+     * Producer Preservation:
+     * This operation only removes the location assignments - the producer remains
+     * active and associated with the agency. To fully remove a producer, use the
+     * appropriate producer deletion endpoint.
+     *
+     * Validation Performed:
+     * - Producer exists and belongs to the authenticated tenant
+     * - All location IDs exist and belong to the producer's agency
+     * - At least one location ID is provided
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - producer_id: Required, must be a valid UUID format
+     * - location_ids: Required, 1-100 items, each must be a valid UUID format
+     *
+     * Business logic validation:
+     * - producer_id: Producer must exist and belong to the authenticated tenant
+     * - All location_ids must exist and belong to the producer's agency
+     *
+     * Returns:
+     * List of location IDs that were successfully unassigned from the producer.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Request is missing, producer_id is empty, or no location_ids provided
+     * - NOT_FOUND: Producer doesn't exist or specified locations don't exist
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.UnassignProducerFromLocations
      */
@@ -5260,7 +6954,53 @@ export declare const ProducerService: GenService<{
         output: typeof UnassignProducerFromLocationsResponseSchema;
     };
     /**
-     * UpdateAgencyLocation updates an existing agency location. You can update the name, address, contact information, and primary status of a location. All fields are optional - only provide the fields you want to update. Location name must be unique within the agency. Returns the updated location details. Error cases: UNAUTHENTICATED: Invalid or missing API key. INVALID_ARGUMENT: Missing agency_id or location_id. NOT_FOUND: Agency or location doesn't exist. ALREADY_EXISTS: Location name already exists within the agency.
+     * UpdateAgencyLocation updates an existing agency location.
+     *
+     * Use this endpoint to modify location details such as address, contact
+     * information, or primary status. This is useful when locations move,
+     * change phone numbers, or when designating a new primary location.
+     *
+     * Updatable Fields:
+     * - Name (must remain unique within the agency)
+     * - Address (street, city, state, zip)
+     * - Contact information (phone, email)
+     * - Primary location status
+     *
+     * All fields are optional - only provide the fields you want to update.
+     * Unchanged fields retain their current values.
+     *
+     * Name Uniqueness:
+     * If updating the location name, the new name must not already exist for
+     * another location within the same agency (case-insensitive comparison).
+     *
+     * Validation Rules:
+     * Proto validation (format checks):
+     * - agency_id: Required, must be a valid UUID format
+     * - location_id: Required, must be a valid UUID format
+     * - name: If provided, must be non-empty (unique within agency)
+     * - address: If provided (all fields optional within):
+     *   - street: If provided, must be non-empty
+     *   - city: If provided, must be non-empty
+     *   - state: If provided, must be exactly 2 characters (state code)
+     *   - zip: If provided, must be 1-10 characters
+     * - phone: If provided, must match E.164 pattern (e.g., +15551234567)
+     * - email: If provided, must be a valid email format
+     * - is_primary: Optional boolean
+     *
+     * Business logic validation:
+     * - agency_id: Agency must exist and belong to the authenticated tenant
+     * - location_id: Location must exist and belong to the specified agency
+     * - name: If provided, must be unique within the agency (case-insensitive,
+     *   excluding the location being updated)
+     *
+     * Returns:
+     * The complete updated location object with all current field values.
+     *
+     * Common Error Codes:
+     * - INVALID_ARGUMENT: Missing agency_id or location_id, or invalid request
+     * - NOT_FOUND: Agency or location doesn't exist or doesn't belong to tenant
+     * - ALREADY_EXISTS: New location name already exists within the agency
+     *
      *
      * @generated from rpc producerflow.producer.v1.ProducerService.UpdateAgencyLocation
      */