@guava-ai/guava-sdk 0.1.0

package/dist/src/events.js

@@ -0,0 +1,109 @@
+import * as z from "zod";
+export const sessionStartedEvent = z.object({
+    event_type: z.literal("session-started"),
+    session_id: z.string(),
+});
+export const inboundCallEvent = z.object({
+    event_type: z.literal("inbound-call"),
+    caller_number: z.e164().optional(),
+    agent_number: z.e164().optional(),
+});
+/**
+ * @description The caller has said something.
+ */
+export const callerSpeechEvent = z.object({
+    event_type: z.literal("caller-speech"),
+    utterance: z.string(),
+});
+/**
+ * @description The agent has said something.
+ */
+export const agentSpeechEvent = z.object({
+    event_type: z.literal("agent-speech"),
+    utterance: z.string(),
+    interrupted: z.boolean().default(false),
+});
+export const errorEvent = z.object({
+    event_type: z.literal("error"),
+    content: z.string(),
+});
+export const warningEvent = z.object({
+    event_type: z.literal("warning"),
+    content: z.string(),
+});
+export const agentQuestionEvent = z.object({
+    event_type: z.literal("agent-question"),
+    question_id: z.string(),
+    question: z.string(),
+});
+export const intentEvent = z.object({
+    event_type: z.literal("intent"),
+    intent_id: z.string(),
+    intent_summary: z.string(),
+});
+export const actionItemCompletedEvent = z.object({
+    event_type: z.literal("action-item-done"),
+    key: z.string(),
+    payload: z.unknown(),
+});
+export const taskCompletedEvent = z.object({
+    event_type: z.literal("task-done"),
+    task_id: z.string(),
+});
+export const outboundCallConnected = z.object({
+    event_type: z.literal("outbound-call-connected"),
+});
+export const outboundCallFailed = z.object({
+    event_type: z.literal("outbound-call-failed"),
+    error_code: z.int(),
+    error_reason: z.string(),
+});
+export const botSessionEnded = z.object({
+    event_type: z.literal("bot-session-ended"),
+});
+export const anyEvent = z.union([
+    sessionStartedEvent,
+    inboundCallEvent,
+    callerSpeechEvent,
+    agentSpeechEvent,
+    errorEvent,
+    warningEvent,
+    agentQuestionEvent,
+    intentEvent,
+    actionItemCompletedEvent,
+    taskCompletedEvent,
+    outboundCallConnected,
+    outboundCallFailed,
+    botSessionEnded,
+]);
+export function decodeEvent(serialized_event) {
+    let data;
+    if (typeof serialized_event == "string") {
+        data = JSON.parse(serialized_event);
+    }
+    else if (serialized_event instanceof ArrayBuffer) {
+        data = JSON.parse(new TextDecoder().decode(serialized_event));
+    }
+    else if (serialized_event instanceof Array) {
+        let decoded = "";
+        for (const buf of serialized_event) {
+            decoded += buf.toString("utf8");
+        }
+        data = JSON.parse(decoded);
+    }
+    else {
+        data = JSON.parse(serialized_event.toString("utf8"));
+    }
+    try {
+        return anyEvent.parse(data);
+    }
+    catch (e) {
+        // TODO logging global use signleton to warn
+        return null;
+    }
+}
+export const inboundTunnelEvent = z.object({
+    call_id: z.string(),
+    event: anyEvent,
+});
+//# sourceMappingURL=events.js.map

package/dist/src/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"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"}

package/dist/src/example_data.d.ts

@@ -0,0 +1 @@
+export declare const PROPERTY_INSURANCE_POLICY = "HARPER VALLEY PROPERTY INSURANCE\nCOMPREHENSIVE RESIDENTIAL PROGRAM MANUAL\n\n1. COMPANY OVERVIEW\n\nHarper Valley Property Insurance (\u201CHVPI,\u201D \u201Cwe,\u201D \u201Cus,\u201D \u201Cour\u201D) is a property and casualty carrier specializing in residential property risks. This document describes the principal policy forms offered, the coverages provided, common exclusions and limitations, optional endorsements, and the standard pricing framework for residential policyholders.\n\nNothing in this document constitutes legal advice or an actual insurance contract. In practice, coverage is determined solely by the terms and conditions of the issued policy and applicable law. The provisions described here are subject to change based on regulatory requirements, underwriting guidelines, and product updates.\n\n2. POLICY PORTFOLIO OVERVIEW\n\nHVPI offers the following core policy types in its Residential Program:\n\n1. HV-HO1 \u2013 Essential Homeowners Policy\n   - For owner-occupied, 1\u20132 family dwellings.\n   - Named-peril form with basic coverage at an economical price.\n\n2. HV-HO3 \u2013 Comprehensive Homeowners Policy\n   - For owner-occupied, 1\u20134 family dwellings.\n   - \u201CAll-risk\u201D (open-peril) coverage on the dwelling, named-peril on personal property, subject to exclusions.\n\n3. HV-CO \u2013 Condominium Unit Owners Policy\n   - For owner-occupied or secondary residence condominium units.\n   - Covers unit interior, improvements and betterments, personal property, and loss assessment exposures.\n\n4. HV-RT \u2013 Renters Policy\n   - For tenants occupying residential units.\n   - Covers personal property and personal liability; no building coverage.\n\n5. HV-LP \u2013 Landlord Residential Policy\n   - For non-owner-occupied 1\u20134 family dwellings.\n   - Provides building coverage, loss of rents, and optionally premises liability.\n\n6. HV-PR \u2013 Personal Residential Umbrella\n   - Excess personal liability coverage over qualifying underlying policies (e.g., HV-HO3, HV-RT, personal auto).\n\n7. HV-HV \u2013 High-Value Home Program\n   - For custom or high-value homes with Coverage A of $1,500,000 or greater.\n   - Broader limits, higher sublimits, and tailored endorsements for affluent risks.\n\nIn addition, HVPI offers endorsements and ancillary coverages that may be attached to these core policies, subject to eligibility and underwriting approval.\n\n3. KEY DEFINITIONS\n\nUnless modified by endorsement, the following terms apply to all HVPI residential policies:\n\n3.1 Actual Cash Value (ACV)\nThe cost to repair or replace covered property with similar kind and quality, less deduction for physical depreciation, wear, and obsolescence.\n\n3.2 Additional Living Expense (ALE)\nThe reasonable increase in living costs necessary to maintain the household\u2019s normal standard of living when a covered loss makes the residence premises uninhabitable.\n\n3.3 Bodily Injury\nBodily harm, sickness, or disease, including resulting death, sustained by a person.\n\n3.4 Deductible\nThe amount the insured must bear on each covered loss, as shown in the Declarations, before HVPI pays any benefit.\n\n3.5 Declarations (Dec Page)\nThe front pages of the policy detailing the insured name, address, policy period, coverages, limits, deductibles, forms, endorsements, and premium.\n\n3.6 Dwelling\nThe building structure identified as the residence premises in the Declarations, including attached structures.\n\n3.7 Endorsement (Rider)\nA form that modifies the insurance contract by adding, restricting, or clarifying coverage.\n\n3.8 Exclusion\nA provision specifying what is not covered under the policy.\n\n3.9 Insured / You / Your\nThe Named Insured shown in the Declarations and, if a personal lines policy, members of the household who qualify as insureds under the policy\u2019s definition.\n\n3.10 Named Perils\nSpecific causes of loss listed in the policy (e.g., fire, lightning, windstorm, theft).\n\n3.11 Open-Peril (All-Risk)\nCoverage for direct physical loss to property unless the cause of loss is excluded.\n\n3.12 Personal Property\nTangible property owned or used by an insured that is not permanently attached to the dwelling.\n\n3.13 Residence Premises\nThe address or location shown in the Declarations where the insured resides and which is covered under the policy.\n\n3.14 Replacement Cost (RC)\nThe cost to repair or replace damaged property with materials of like kind and quality without deduction for depreciation, subject to the terms of the Replacement Cost loss settlement provision.\n\n4. GENERAL POLICY CONDITIONS (APPLICABLE TO ALL FORMS)\n\n4.1 Policy Period and Territory\nThe policy applies only to losses occurring:\n- During the policy period shown on the Declarations; and\n- Within the policy territory (the United States and Canada, unless otherwise stated).\n\n4.2 Insurable Interest and Limit of Liability\nHVPI will not pay more than the insured\u2019s financial interest in the property. The total liability for any one occurrence will not exceed:\n- The applicable limit of liability stated on the Declarations; and\n- Any applicable sublimit, endorsement, or aggregate limit.\n\n4.3 Deductibles\nA standard deductible applies per occurrence for property coverages unless a separate deductible (e.g., wind/hail, hurricane, earthquake) is specified. No deductible applies to Coverage E \u2013 Personal Liability under standard forms, unless otherwise endorsed.\n\n4.4 Cancellation and Nonrenewal\nThe Named Insured may cancel at any time by written notice. HVPI may cancel or nonrenew only in accordance with:\n- The specific policy provisions; and\n- Applicable jurisdictional law (such as nonpayment of premium, material misrepresentation, or substantial change in risk).\n\n4.5 Concealment, Misrepresentation, or Fraud\nCoverage may be void as to any insured who, whether before or after a loss, has:\n- Intentionally concealed or misrepresented a material fact; or\n- Engaged in fraudulent conduct relating to insurance or a claim.\n\n4.6 Liberalization Clause\nIf HVPI adopts a revision that broadens coverage without additional premium during the policy period, the broadening will automatically apply to the insured\u2019s policy as of the date the revision is effective.\n\n4.7 Assignment\nAssignment of the policy is not valid unless HVPI provides written consent.\n\n5. POLICY FORMS AND CORE COVERAGE STRUCTURE\n\n5.1 HV-HO1 \u2013 Essential Homeowners Policy\n\n5.1.1 Eligible Risks\n- 1\u20132 family primary residences.\n- Standard construction (frame, masonry, or superior).\n- Owner-occupied at least 9 months per year, unless otherwise approved.\n\n5.1.2 Covered Property and Limits (Typical Defaults)\nCoverage structure (modifiable on Declarations):\n\nCoverage A \u2013 Dwelling:\n- User-selected limit, minimum $100,000.\n\nCoverage B \u2013 Other Structures:\n- 10% of Coverage A by default.\n\nCoverage C \u2013 Personal Property:\n- 50% of Coverage A by default.\n\nCoverage D \u2013 Loss of Use (ALE):\n- 20% of Coverage A by default.\n\nCoverage E \u2013 Personal Liability:\n- $100,000 per occurrence baseline; options up to $500,000.\n\nCoverage F \u2013 Medical Payments to Others:\n- $1,000 per person baseline; options up to $5,000.\n\n5.1.3 Perils Insured Against\nCoverage A & B (Dwelling/Other Structures): Named perils, including:\n- Fire or lightning\n- Windstorm or hail\n- Explosion\n- Smoke\n- Aircraft or vehicles\n- Riot or civil commotion\n- Vandalism or malicious mischief\n- Theft\n- Volcanic eruption\n\nCoverage C (Personal Property): Same named perils, subject to additional theft restrictions for property away from the premises.\n\n5.1.4 Notable Exclusions (Partial List)\n- Flood, surface water, storm surge.\n- Earth movement, landslide, sinkhole (unless endorsed).\n- Wear and tear, deterioration, mechanical breakdown.\n- Mold, fungus, wet or dry rot (unless endorsed, often sublimited).\n- Ordinance or law beyond limited additional coverage.\n\n5.2 HV-HO3 \u2013 Comprehensive Homeowners Policy\n\nThe flagship form with broader property coverage.\n\n5.2.1 Covered Property and Limits (Typical Defaults)\n\nCoverage A \u2013 Dwelling:\n- User-selected limit, minimum $150,000.\n\nCoverage B \u2013 Other Structures:\n- 10% of Coverage A.\n\nCoverage C \u2013 Personal Property:\n- 60% of Coverage A.\n\nCoverage D \u2013 Loss of Use (ALE):\n- 30% of Coverage A.\n\nCoverage E \u2013 Personal Liability:\n- $300,000 baseline; options $100,000\u2013$1,000,000.\n\nCoverage F \u2013 Medical Payments:\n- $5,000 per person baseline; options $1,000\u2013$10,000.\n\n5.2.2 Perils Insured Against\nCoverage A & B (Dwelling/Other Structures):\n- Open-peril (all-risk) coverage for direct physical loss to property, subject to exclusions.\n\nCoverage C (Personal Property):\n- Named-peril coverage including, but not limited to:\n  - Fire, lightning, windstorm, hail, theft, accidental discharge of water or steam from plumbing or HVAC systems, falling objects, weight of ice or snow, sudden and accidental tearing apart of heating or air conditioning systems, and similar hazards specified in the policy.\n\n5.2.3 Important Sub-Limits for Personal Property (Typical Defaults)\n- Jewelry, watches, furs: $1,500 per occurrence for theft.\n- Firearms: $2,500 per occurrence.\n- Silverware, goldware, pewterware: $2,500 per occurrence for theft.\n- Business property on premises: $2,500; off premises: $500.\n- Cash, coins, and similar monetary property: $200.\n\nThese sublimits may be increased via scheduled personal property endorsements.\n\n5.2.4 Loss Settlement Provisions\nCoverage A & B:\n- Replacement Cost (RC) if the insured maintains Coverage A at least 80% of the full replacement cost of the dwelling at time of loss; otherwise, coinsurance may apply.\n\nCoverage C:\n- Actual Cash Value (ACV) by default.\n- Optional Replacement Cost on personal property available for additional premium.\n\n5.2.5 Additional Coverages (Selected)\nIncluded without additional premium, subject to internal limits:\n- Debris Removal (may provide up to 5% of Coverage A in additional coverage).\n- Reasonable Repairs to protect the property after a covered loss.\n- Trees, Shrubs, and Plants (up to 5% of Coverage A, maximum $500 per item).\n- Ordinance or Law (10% of Coverage A, unless increased by endorsement).\n- Credit Card, Forgery, and Counterfeit Money (up to $1,000).\n- Loss Assessment (condo/HOA-related assessments, up to $1,000; higher limits by endorsement).\n\n5.3 HV-CO \u2013 Condominium Unit Owners Policy\n\n5.3.1 Coverage Components\n- Coverage A \u2013 Unit interior, fixtures, and improvements & betterments.\n- Coverage C \u2013 Personal Property.\n- Coverage D \u2013 Loss of Use.\n- Coverage E \u2013 Personal Liability.\n- Coverage F \u2013 Medical Payments.\n- Special Coverage \u2013 Loss Assessment for condominium association exposures.\n\nCoverage A is typically selected between $25,000 and $250,000 depending on the association\u2019s master policy and allocation of responsibility for interior elements.\n\n5.4 HV-RT \u2013 Renters Policy\n\nProvides Coverage C, D, E, and F only. There is no dwelling structure coverage for tenants.\n\nTypical ranges:\n- Coverage C \u2013 Personal Property: $15,000 to $250,000.\n- Coverage D \u2013 Loss of Use: 30% of Coverage C.\n- Coverage E \u2013 Personal Liability: $100,000\u2013$500,000.\n- Coverage F \u2013 Medical Payments: $1,000\u2013$5,000 per person.\n\n5.5 HV-LP \u2013 Landlord Residential Policy\n\nDesigned for non-owner-occupied residential dwellings (1\u20134 units).\n\nCoverage elements:\n- Coverage A \u2013 Dwelling (RC or ACV depending on selected form and endorsements).\n- Coverage B \u2013 Other Structures.\n- Coverage D-LR \u2013 Loss of Rents (usually 20% of Coverage A, extendable to 40%).\n- Premises Liability \u2013 Optional coverage with limits generally from $100,000 to $1,000,000.\n\n5.6 HV-HV \u2013 High-Value Home Program\n\nKey differences versus HV-HO3:\n- Higher standard sublimits for personal property:\n  - Jewelry: $5,000 per item, $25,000 per occurrence (subject to underwriting).\n  - Fine arts: blanket coverage with optional itemization.\n- Broader worldwide coverage for personal property and personal liability.\n- More generous additional living expense (up to 36\u201348 months).\n- Risk-specific underwriting, factoring in age of home, upgrades, specialized construction, and private fire protection arrangements.\n\n6. MAJOR EXCLUSIONS (ALL FORMS \u2013 NON-EXHAUSTIVE)\n\nUnless specifically endorsed, the following exclusions commonly apply across all forms:\n\n6.1 Flood and Surface Water\nLoss or damage from flood, surface water, waves, storm surge, overflow of any body of water, or spray from such sources.\n\n6.2 Earth Movement\nEarthquake, landslide, mine subsidence, sinkhole collapse, or other earth movement (unless covered by specific endorsement).\n\n6.3 War and Nuclear Hazard\nLoss or damage caused by war, warlike actions, insurrection, rebellion, nuclear reaction, nuclear radiation, or radioactive contamination.\n\n6.4 Intentional Loss\nAny loss resulting from intentional or criminal acts of an insured.\n\n6.5 Neglect\nFailure of the insured to use reasonable means to save and preserve property following a loss.\n\n6.6 Wear and Tear / Deterioration\nIncluding rust, corrosion, smog, dry rot, settling, shrinking, bulging, or expansion, mechanical breakdown, or inherent vice.\n\n6.7 Governmental Action\nConfiscation, seizure, or destruction by order of governmental or public authority.\n\n6.8 Mold, Fungi, Wet or Dry Rot\nExcept as specifically provided under limited additional coverage, often subject to a separate sublimit (e.g., $5,000\u2013$10,000) and special conditions.\n\n7. OPTIONAL ENDORSEMENTS\n\nAvailability, form, and pricing vary by state, territory, and underwriting guidelines. Examples include:\n\n7.1 Scheduled Personal Property (HV-SPP)\nFor high-value items such as jewelry, fine arts, musical instruments, cameras, and collectibles.\n- Typically open-peril, worldwide coverage.\n- No deductible, agreed value or itemized limits per article.\n\n7.2 Water Backup and Sump Overflow (HV-WB)\nCoverage for water damage from backup of sewers or drains, or sump pump overflow.\n- Offered with sublimits such as $5,000, $10,000, $25,000 per occurrence.\n\n7.3 Equipment Breakdown (HV-EB)\nCoverage for damage from mechanical or electrical breakdown of household systems and appliances, such as HVAC, boilers, and electrical panels.\n\n7.4 Service Line Coverage (HV-SL)\nCoverage for buried piping and electrical lines from the street or utility connection to the dwelling (e.g., water, sewer, power lines), subject to specific exclusions and conditions.\n\n7.5 Identity Theft Expense (HV-ID)\nLimited reimbursement for expenses incurred due to identity theft, such as costs of notarizing affidavits, certified mail, and certain lost wages.\n\n7.6 Short-Term Rental / Home-Sharing (HV-STR)\nModifies exclusions applicable to business use and provides limited coverage tailored to home-sharing or short-term rental exposures, subject to restrictions and occupancy limits.\n\n7.7 Ordinance or Law Enhancement (HV-OL)\nIncreases the percentage of Coverage A available for increased costs due to enforcement of building codes or ordinances during repair or reconstruction after a covered loss.\n\n7.8 Earthquake (HV-EQ) and Flood (HV-FL)\nSeparate endorsements or companion policies for earthquake and flood risks, with their own rating, underwriting, and deductibles.\n\n8. PRICING FRAMEWORK\n\nPricing is determined using a combination of:\n- Base rates per $1,000 of Coverage A for the dwelling.\n- Territory rating (geographic risk factors such as weather and crime).\n- Construction and protection class.\n- Occupancy and use.\n- Claims history and credit-based insurance score (where permitted by law).\n- Selected deductibles and endorsements.\n- Discounts and surcharges.\n\n8.1 Base Rate Structure\n\nFor HV-HO3 policies, the annual base dwelling rate per $1,000 of Coverage A may be organized by risk tier, for example:\n\n- Tier 1 \u2013 Preferred:\n  Newer homes, superior construction, low-risk area; indicative base rate $0.35 per $1,000 Coverage A.\n\n- Tier 2 \u2013 Standard:\n  Average construction, moderate risk area; indicative base rate $0.50 per $1,000 Coverage A.\n\n- Tier 3 \u2013 Nonstandard:\n  Older homes, moderate deficiencies, higher risk; indicative base rate $0.80 per $1,000 Coverage A.\n\nAdditional factors apply on top of these base rates.\n\n8.2 Rating Factors\n\nIllustrative rating factors may include:\n\n1. Territory Factor (TF)\n   Reflects regional risks (weather, crime, legal environment).\n   Typical range: 0.80 \u2013 1.40.\n\n2. Construction Factor (CF)\n   - Frame: 1.00\n   - Masonry: 0.90\n   - Superior fire-resistive construction: 0.80\n\n3. Protection Class Factor (PF)\n   Based on distance to fire station, quality of fire protection, and water supply.\n   Typical range: 0.75 (best) \u2013 1.50 (least favorable).\n\n4. Occupancy Factor (OF)\n   - Primary residence: 1.00\n   - Seasonal residence: 1.15\n   - Short-term rental: 1.25\u20131.50 (or rated under HV-STR guidelines).\n\n5. Deductible Factor (DF)\n   - $500 deductible: 1.10\n   - $1,000 deductible: 1.00\n   - $2,500 deductible: 0.90\n   - $5,000 deductible: 0.80\n\n6. Claims History Factor (CHF)\n   - No claims in 5+ years: 0.95\n   - One minor claim in last 5 years: 1.05\n   - Multiple or major claims: 1.20\u20131.50.\n\n7. Credit/Insurance Score Factor (CSF) (where allowed)\n   - High score: 0.90\n   - Average: 1.00\n   - Below average: 1.10\u20131.25.\n\n8.3 Liability, Endorsement, and Miscellaneous Premium\n\nLiability and certain endorsements are often rated as flat charges, sometimes adjusted by exposure characteristics. Typical illustrative charges:\n\nPersonal Liability (Coverage E):\n- $100,000 limit: $50\u2013$75.\n- $300,000 limit: $90\u2013$130.\n- $500,000 limit: $140\u2013$200.\n\nMedical Payments (Coverage F):\n- $1,000 per person: $10\u2013$15.\n- $5,000 per person: $25\u2013$40.\n\nWater Backup Endorsement:\n- $5,000 limit: $40\u2013$75.\n- $10,000 limit: $70\u2013$125.\n\nEquipment Breakdown:\n- $35\u2013$75 per policy.\n\nService Line:\n- $25\u2013$60 per policy.\n\nScheduled Personal Property:\n- Rate per $100 of scheduled value, varying by category (for example, jewelry $0.80\u2013$1.20 per $100 of value).\n\n9. DISCOUNTS AND SURCHARGES\n\nHVPI may apply credits and debits to the base premium as follows:\n\n9.1 Common Discounts\n- Multi-Policy Discount (home plus auto or other qualifying policy): 10\u201320%.\n- Protective Devices (central station alarm, automatic sprinklers, monitored fire and burglary systems): 5\u201315%.\n- New Home or Recent Renovation: 5\u201315%.\n- Claim-Free Longevity: up to 10%, based on years without claims.\n- Gated Community or Secure Building: approximately 5%.\n\n9.2 Common Surcharges\n- Attractive nuisances such as trampolines, unfenced pools, or other hazardous recreational equipment without adequate safety measures: 10\u201325% surcharge.\n- Short-term rental or frequent room-sharing without applicable endorsement: surcharge or declination, depending on exposure.\n- Certain dog breeds, prior liability incidents, or similar risk factors: surcharge, exclusion, or restricted liability coverage.\n\n10. PREMIUM CALCULATION EXAMPLE (HV-HO3)\n\nThe following example demonstrates how premium may be calculated.\n\nAssumptions:\n- Policy: HV-HO3\n- Coverage A (Dwelling): $400,000\n- Coverage C: 60% of A = $240,000\n- Coverage D: 30% of A = $120,000\n- Territory: Moderate risk, TF = 1.10\n- Construction: Masonry, CF = 0.90\n- Protection Class: Good, PF = 0.85\n- Occupancy: Primary residence, OF = 1.00\n- Deductible: $1,000, DF = 1.00\n- Claims History: No claims in 5 years, CHF = 0.95\n- Credit Score: Average, CSF = 1.00\n- Risk Tier: Tier 2 \u2013 Standard; base rate = $0.50 per $1,000 Coverage A\n- Liability: Coverage E = $300,000 (flat $110 premium)\n- Medical Payments: $5,000 (flat $30 premium)\n- Endorsements:\n  - Water Backup $10,000 limit: $90\n  - Equipment Breakdown: $50\n  - Service Line: $40\n- Discounts:\n  - Multi-Policy Discount: 10%\n  - Protective Devices: 10%\n\n10.1 Dwelling Premium\n\n1. Dwelling base units:\n   Coverage A / $1,000 = $400,000 / $1,000 = 400 units.\n\n2. Base dwelling premium (unmodified):\n   Units \u00D7 base rate = 400 \u00D7 $0.50 = $200.00.\n\n3. Apply multiplicative rating factors:\n   Combined factor = TF \u00D7 CF \u00D7 PF \u00D7 OF \u00D7 DF \u00D7 CHF \u00D7 CSF\n   = 1.10 \u00D7 0.90 \u00D7 0.85 \u00D7 1.00 \u00D7 1.00 \u00D7 0.95 \u00D7 1.00.\n\n   Stepwise:\n   - 1.10 \u00D7 0.90 = 0.99\n   - 0.99 \u00D7 0.85 = 0.8415\n   - 0.8415 \u00D7 1.00 = 0.8415\n   - 0.8415 \u00D7 1.00 = 0.8415\n   - 0.8415 \u00D7 0.95 \u2248 0.7994\n   - 0.7994 \u00D7 1.00 = 0.7994\n\n   Combined factor \u2248 0.7994.\n\n4. Modified dwelling premium:\n   $200.00 \u00D7 0.7994 \u2248 $159.88.\n\n10.2 Other Property Premium Components\n\nAssume Coverage B and Coverage C premiums are derived as percentages of the modified dwelling premium:\n\n- Coverage B (Other Structures) premium:\n  10% of dwelling premium = 0.10 \u00D7 $159.88 \u2248 $15.99.\n\n- Coverage C (Personal Property) premium:\n  40% of dwelling premium = 0.40 \u00D7 $159.88 \u2248 $63.95.\n\n- Coverage D (Loss of Use) premium:\n  20% of dwelling premium = 0.20 \u00D7 $159.88 \u2248 $31.98.\n\nTotal property coverage (A, B, C, D) premium before endorsements:\n$159.88 + $15.99 + $63.95 + $31.98 = $271.80 (rounded).\n\n10.3 Liability and Endorsements\n\n- Personal Liability (Coverage E): $110.00.\n- Medical Payments (Coverage F): $30.00.\n- Water Backup endorsement: $90.00.\n- Equipment Breakdown endorsement: $50.00.\n- Service Line endorsement: $40.00.\n\nSubtotal for liability and endorsements:\n$110 + $30 + $90 + $50 + $40 = $320.00.\n\n10.4 Total Premium Before Discounts\n\nTotal pre-discount premium:\nProperty + Liability/Endorsements = $271.80 + $320.00 = $591.80.\n\n10.5 Apply Discounts\n\nCombined discounts:\n- Multi-Policy: 10% (factor 0.90).\n- Protective Devices: 10% (factor 0.90).\n\nCombined discount factor:\n0.90 \u00D7 0.90 = 0.81.\n\nDiscounted total premium:\n$591.80 \u00D7 0.81 \u2248 $479.36.\n\nSample annual premium: approximately $479 for this risk, subject to rounding, state-specific rules, and underwriting.\n\n11. CLAIMS HANDLING OVERVIEW\n\nWhile this document focuses primarily on coverage and pricing, HVPI also defines a standard claims process.\n\n11.1 Notice of Loss\nThe insured must provide prompt notice, describing date, time, location, and circumstances of the loss. Emergency measures to protect property from further damage are encouraged and may be covered, subject to policy terms.\n\n11.2 Duties After Loss\nThe insured is expected to:\n- Protect property from further damage.\n- Make a list of damaged items with description, age, and estimated value.\n- Provide access for inspection and cooperate with the adjuster.\n- Provide requested documents (proof of ownership, repair estimates, receipts, and other supporting materials).\n\n11.3 Loss Payment\nHVPI will pay covered losses within the timeframe required by applicable law and policy terms once:\n- Agreement is reached on the amount of loss; or\n- A final judgment is entered; or\n- An appraisal award is issued (if the appraisal clause is invoked).\n\n11.4 Other Insurance\nIf other valid and collectible insurance applies to the same loss, HVPI pays no more than its share of the loss according to the policy\u2019s other insurance condition.\n\n12. ILLUSTRATIVE POLICY COMPARISON\n\nThe following simplified comparison highlights key features for selected forms:\n\nFeature: Dwelling Coverage (A)\n- HV-HO1 Essential: Named peril.\n- HV-HO3 Comprehensive: Open peril.\n- HV-RT Renters: Not covered.\n- HV-LP Landlord: Named or open peril depending on form.\n\nFeature: Personal Property Coverage (C)\n- HV-HO1 Essential: Named peril.\n- HV-HO3 Comprehensive: Named peril.\n- HV-RT Renters: Named peril.\n- HV-LP Landlord: Limited or none (form-specific).\n\nFeature: Loss of Use\n- HV-HO1 Essential: 20% of Coverage A.\n- HV-HO3 Comprehensive: 30% of Coverage A.\n- HV-RT Renters: 30% of Coverage C.\n- HV-LP Landlord: Loss of Rents (generally 20% of Coverage A).\n\nFeature: Personal Liability\n- HV-HO1 Essential: Optional.\n- HV-HO3 Comprehensive: Included.\n- HV-RT Renters: Included.\n- HV-LP Landlord: Optional premises liability.\n\nFeature: Mold Limited Coverage\n- All forms: Typically sublimited, subject to special conditions and exclusions, unless otherwise endorsed.\n\nFeature: Short-Term Rental Coverage\n- HV-HO1 Essential: Not covered unless endorsed.\n- HV-HO3 Comprehensive: Available via HV-STR endorsement.\n- HV-RT Renters: Not standard; special underwriting may be required.\n- HV-LP Landlord: Available via endorsement or specific landlord form.\n\n13. ADMINISTRATIVE PROVISIONS AND ENDNOTES\n\n13.1 Rate Revisions\nHVPI reserves the right to revise rates and rating criteria at renewal, subject to regulatory approval where required by law.\n\n13.2 Form Updates\nPolicy forms and endorsements may be amended periodically to reflect market conditions, loss experience, legal changes, and regulatory guidance.\n\n13.3 State-Specific Variations\nCoverage limitations, definitions, and premium rating methodologies may vary by jurisdiction; state-specific endorsements and notices may supersede general provisions described in this manual.\n\n13.4 Entire Contract\nThe actual insurance policy, including Declarations, core forms, endorsements, and any applicable riders, constitutes the entire contract between HVPI and the policyholder.\n\nEnd of Harper Valley Property Insurance\nComprehensive Residential Program Manual.";