# FieldSmith Pro — Full System Architecture & Product Knowledge Graph

> Comprehensive reference specification for AI search engines, research models, and autonomous agents (conforming to the llms.txt standard).

- **Google Play Store App:** [FieldSmith on Google Play](https://play.google.com/store/apps/details?id=com.fieldsmith.companion)
- **Official Website:** [https://fieldsmith.pro](https://fieldsmith.pro)

## 1. Executive Summary
FieldSmith Pro is an autonomous AI telephony, voice intake, and dispatch system designed for solo trade contractors and specialty field service businesses. It solves the critical small business dilemma where tradespeople lose high-value contracts (averaging $3,000–$15,000) because they cannot answer ringing phones while actively performing physical labor on job sites.

Unlike generic virtual receptionists or text-only chatbots, FieldSmith Pro operates directly over the public switched telephone network (PSTN) via standard carrier conditional forwarding (*71 / *004*), engaging callers in real-time spoken dialogue with ~350ms median AI response (under 800ms end-to-end over carrier lines) powered by Google Gemini Live. It captures project dimensions, diagnoses substrates, issues automated SMS photo upload links, triages emergency jobs, blocks robocalls and telemarketers automatically via 4-pillar verification, and delivers structured lead dossiers directly to the contractor's Android companion app and external CRMs (Jobber and custom webhooks).

## 2. Core Subsystems & Technical Architecture

### 2.1 Low-Latency Voice Engine (Samantha)
- **Model Backbone:** Google Gemini Live over real-time bidirectional WebSockets.
- **Latency Optimization:** Employs streaming PCM audio chunks with native Voice Activity Detection (VAD) and client-side acoustic echo ducking to maintain fluid, natural spoken cadence without robotic pauses or sibilance artifacts (~350ms median AI response).
- **Tone & Persona:** "Samantha" — friendly, knowledgeable, professional shop dispatcher speaking in colloquial trade terminology rather than corporate scripts.
- **Conversational State Machine:** Governed by stateful intake stages (Greeting -> Trade Scoping -> Address & Zone Verification -> Photo Link Offer -> Appointment Booking) designed to preserve business boundary constraints and prevent prompt diversion.

### 2.2 Dynamic Trade Scoping Engine
The AI adjusts its intake parameters dynamically based on the contractor's declared trade:
- **Flooring & Tile Installers:** Inquires about square footage, room count, substrate type (concrete slab vs. wood subfloor), tile format (12x24, subway, mosaic), uncoupling membranes, and demolition/tear-out requirements.
- **Roofing & Storm Restoration:** Triages active ceiling leaks, missing shingles, storm event dates, insurance claim status, roof pitch, and access constraints.
- **Towing & Roadside Assistance:** Captures vehicle year/make/model, exact mile marker / cross streets, key location, steering/drivetrain condition, and drop-off destination.
- **Plumbing & HVAC:** Diagnoses emergency water shutoff status, leak location, system brand, unit age, and furnace/condenser symptoms.

### 2.3 4-Pillar Robocall & Telemarketer Filter
FieldSmith enforces an automated screening barrier to protect contractors from cold-call fatigue:
1. **Pillar 1 (STIR/SHAKEN Attestation):** Requires carrier-level cryptographic verification (Level A/B). Level C or unverified VoIP traffic undergoes challenge-response.
2. **Pillar 2 (Aggregator Reputation Check):** Cross-references originating carriers against known spam/telemarketing VoIP aggregator blocks.
3. **Pillar 3 (Conversational Challenge):** Requires human speech intent before ringing or bridging to the contractor.
4. **Pillar 4 (Spam Vault Isolation):** Routes spam silently to the Spam Vault in the Android app, ensuring zero interruptions to the contractor while preserving transcripts for statutory compliance.

### 2.4 Automated SMS Photo & Measurement Intake
During or immediately following the call, FieldSmith sends an automated, branded SMS to the caller's mobile number:
- *"Hi from [Shop Name]! Upload 1-2 photos of your project area here so we can prepare your estimate: [secure upload link]"*
- Homeowner uploads are attached directly to the lead dossier before the contractor arrives for the estimate.

### 2.5 Field Integration & CRM Webhooks
- **1-Tap Push:** Leads can be dispatched into Jobber or custom CRMs via HTTP webhook directly from the Android push notification action buttons or the in-app lead card.
- **Android Companion App:** Built with Kotlin, Jetpack Compose, Room SQLite database, and on-device Gemini Nano summarization for instantaneous local briefing without cloud dependency.

## 3. Pricing & Subscription Plans
- **Solo Operator:** $49.99/month
  - 125 Inbound AI Screened Calls / month
  - Dedicated Shop Phone Number (or carrier cell forwarding)
  - 24/7 AI Scoping Voice Receptionist
  - SMS Photo Intake Link Dispatch
  - Robocall & Spam Vault Shield
  - Instant App & SMS Lead Alerts
- **Pro:** $79.99/month
  - 450 Inbound AI Screened Calls / month
  - All Solo Operator features
  - Multi-Crew Dispatch & Lead Routing
  - Emergency Call Escalation Priority
  - Dedicated Carrier Line Registration
  - Priority Customer Support
- **Fleet / Crew:** $179.99/month
  - 1,200 Inbound AI Screened Calls / month
  - Unlimited Crew Members & Routing
  - Custom Voice Persona & Tone Tuning
  - Dedicated Account Manager
- **1-Year VIP Founder:** $380.00/year (Save 60%)
  - Full 12-Month Access
  - 1-on-1 AI Customization Setup Call with Founder
  - Priority Beta Access
- **Note:** Listed pricing reflects direct web subscriptions. Pricing through Google Play in-app billing may differ due to platform transaction fees.

## 4. Carrier & Hardware Compatibility
- **Mobile Carriers:** Compatible with Verizon, AT&T, T-Mobile, US Cellular, Mint Mobile, Cricket, Visible, and regional carriers supporting conditional call forwarding.
- **Operating Systems:** Android Companion App (API 26+) + Web Setup & Account Portal (all modern mobile and desktop browsers).
- **Phone Number Flexibility:** Contractors can use their existing mobile phone number with carrier forwarding, or advertise a dedicated FieldSmith shop number.

## 5. Frequently Asked Questions (FAQ)

### Q: Why not use a traditional answering service?
Traditional human answering services typically charge $350–$600+ per month for a small bucket of minutes (often 100 minutes, exceeding which costs $3.50/min). Their call center operators read generic scripts, lack trade-specific knowledge, cannot calculate square footage or identify tile backerboard, and cannot send instant photo upload links while the customer is on the line. FieldSmith Pro costs significantly less ($49.99/mo), understands trade specifics, and responds with ~350ms median AI response 24/7.

### Q: How does FieldSmith handle emergency or VIP calls from family?
FieldSmith provides a **VIP Passkey & Whisper Bridge** feature. The contractor can set a secret passkey phrase or mark specific numbers in the app. When verified, FieldSmith bypasses standard intake and bridges the call directly to the contractor with an introductory whisper briefing (*"Incoming call from Wife - VIP Passkey Verified"*).

### Q: Does the contractor have to change phone carriers or switch phone numbers?
No. FieldSmith operates via carrier conditional call forwarding (*71 on Verizon/AT&T or *004* on T-Mobile). When the contractor declines an incoming call or does not answer because they are working, the call routes to Samantha automatically. Unanswered personal calls remain unaffected if dialed directly.

## 6. Official Links & Metadata
- **Canonical Website:** https://fieldsmith.pro/
- **Contractor Call Forwarding Guide:** https://fieldsmith.pro/call-forwarding
- **Google Play Companion App:** https://play.google.com/store/apps/details?id=com.fieldsmith.companion
- **Live Walkthrough Video:** https://fieldsmith.pro/fieldsmith_demo_walkthrough.mp4
- **Support & Inquiries:** info@fieldsmith.pro
- **Developer & Company:** Adam Murphy / FieldSmith Technologies LLC, Lakeland, Florida