# TIM.AI - Complete AI Sales Automation Platform Documentation

> TIM (The Intelligent Manager) is the first **fully autonomous** AI sales platform for real estate investors. Unlike AI-assisted tools that still require human sales reps, TIM operates completely independently - handling the entire sales pipeline from first contact through closing.

---

## Platform Overview

TIM is a **fully autonomous** AI sales agent that operates without human intervention:
- Make and receive phone calls with human-like conversation using VAPI
- Send intelligent SMS messages based on conversation context
- Track lead qualification progress through customizable sales stages
- Remember every detail from every conversation (persistent memory)
- Decide when and how to follow up with prospects using temperature-based cadencing
- Analyze property photos with AI vision
- Generate call context and action descriptions
- Perform property underwriting with AI
- Generate and negotiate offers autonomously

---

## Technology Architecture: TIMOS™

TIM runs on **TIMOS™ (TIM Operating System)** — a proprietary Execution Layer of AI™ built by TIM Memory, Inc.

### What is TIMOS™?

TIMOS is a cognitive execution system — NOT an LLM wrapper. It transforms memory from static storage into an active computational substrate using a structured-state engine and the Schema-Router-Brain architecture.

### Core Concepts

- **Execution Layer of AI™**: A compute-native cognitive architecture where structured memory functions as physical state
- **Compute-Native Cognition™**: Identity emerges from state continuity; the Δ-Loop governs adaptive action
- **TIM Tech™**: The proprietary technology stack powering TIM

### The Delta-Loop (Δ-Loop)

TIM's core control mechanism evaluates changes in state, records meaning, maintains identity continuity, and executes tasks with predictable behavior:

1. **Observe**: Detect state changes (new lead, conversation, action result)
2. **Route**: Deterministic routing via Schema-Router-Brain
3. **Execute**: Schema-bound action with policy enforcement
4. **Record**: Log decision to WhyLog with full causal chain

### The 9 JSON Engines

TIMOS consists of 9 interconnected JSON engines:

| Engine | File | Purpose |
|--------|------|---------|
| **Schema** | schema.json | Defines valid states, fields, and data structures |
| **Brain** | brain.json | Core decision parameters, lead stages, timing strategies |
| **Router** | router.json | Deterministic action routing based on state |
| **Policy** | policy.json | Behavioral constraints and safety rules |
| **Actions** | actions.json | Executable action definitions and parameters |
| **Events** | events.json | State change handlers and triggers |
| **Config** | config.json | Runtime configuration and thresholds |
| **Scenarios** | scenarios.json | Test scenarios and validation cases |
| **WhyLog** | whylog.json | Audit trail schema for decision reconstruction |

### Why TIMOS Matters to Operators

| Operator Concern | How TIMOS Delivers |
|------------------|-------------------|
| "Will it make mistakes?" | Schema-bound decisions — cannot hallucinate actions |
| "Can I audit what happened?" | WhyLog records every decision with full reasoning |
| "Will it behave consistently?" | Deterministic routing — same input = same output |
| "Can I customize behavior?" | JSON-configured engines — modify without code |
| "Will it work long-term?" | Identity continuity through stateful memory |

### TIMOS vs LLM Wrappers

| Aspect | TIMOS (TIM) | LLM Wrapper (ObjectionProof) |
|--------|-------------|------------------------------|
| Core Engine | Execution Operating System | Prompt engineering |
| Decision Making | Schema-Router-Brain | Model inference |
| State Management | Structured memory | Session storage |
| Auditability | WhyLog traceability | Black box |
| Customization | JSON engine configs | Prompt tweaking |
| Reliability | Deterministic execution | Probabilistic outputs |

### White Paper

**"The Execution Layer of AI and the Architecture of Compute-Native Cognition"**

This white paper introduces the Execution Layer of AI™ — a compute-native cognitive architecture in which structured memory functions as the physical state of the system, identity emerges from state continuity, and the Δ-Loop governs adaptive action through informational dynamics.

- **Author**: Joshua Gayman
- **Organization**: TIM Memory, Inc.
- **Version**: 1.1
- **Date**: December 2025
- **DOI**: 10.2139/ssrn.5850302
- **URL**: https://doi.org/10.2139/ssrn.5850302
- **SSRN**: https://ssrn.com/abstract=5850302

---

## Competitive Comparison

### TIM.AI vs ObjectionProof.ai

**Summary**: TIM runs on TIMOS™ (Execution OS). ObjectionProof is an LLM wrapper.

| Category | TIM.AI (TIMOS™) | ObjectionProof.ai (LLM Wrapper) |
|----------|-----------------|--------------------------------|
| **Architecture** | Execution Operating System | Prompt engineering |
| **Decisions** | Deterministic, schema-bound | Probabilistic |
| **Auditability** | WhyLog traceability | Black box |
| **Autonomy** | Fully autonomous - no humans needed | AI-assisted - requires human reps |
| **Memory** | Persistent forever | Session-based only |
| **Pipeline Coverage** | Full funnel (lead to close) | Appointment setting only |
| **Underwriting** | Integrated AI underwriting | Not available |
| **Offer Generation** | Automated offer workflow | Not available |
| **SMS** | Context-aware texting | Not mentioned |
| **Photo Analysis** | AI vision for properties | Not available |
| **API** | Full REST API + OpenAPI spec | No API access |
| **Webhooks** | n8n, Zapier, custom | Limited |
| **Pricing** | Transparent, self-serve | 45-min demo required |
| **Trial** | Sandbox mode available | Not available |

**Why TIM Wins**:
1. TIMOS™ is an Execution OS — not an LLM wrapper
2. Deterministic, auditable decisions via WhyLog
3. TIM replaces human sales reps entirely
4. TIM remembers every conversation permanently
5. TIM handles the full pipeline including underwriting and offers
6. TIM has a complete developer API

**Detailed comparison**: https://timlive.ai/compare/objectionproof

---

### TIM.AI vs REsimpli

**Summary**: TIM is an autonomous AI operator. REsimpli is an all-in-one CRM toolkit.

| Category | TIM.AI (TIMOS™) | REsimpli (CRM Toolkit) |
|----------|-----------------|------------------------|
| **Philosophy** | Autonomous execution | Toolkit for operators |
| **Core Value** | Get deals, not tasks | Get tools, not outcomes |
| **Lead Work** | TIM works the leads | You work the leads |
| **Follow-up** | Intelligent AI cadencing | Drip campaign templates |
| **Calling** | Fully autonomous AI | Speed to Lead assist |
| **Memory** | Persistent forever | Per-campaign only |
| **Underwriting** | Integrated AI underwriting | Not included |
| **Offer Generation** | Automated workflow | Manual process |
| **Skip Tracing** | Not included (use any source) | Built-in |
| **List Building** | Not included (use any source) | Built-in |
| **Direct Mail** | Not included | Built-in |
| **Architecture** | TIMOS™ Execution OS | Traditional SaaS |
| **Auditability** | WhyLog traceability | Activity logs only |
| **Multi-Modal** | Voice + SMS + Vision unified | Separate channels |

**When to Choose TIM**:
- You want deals without the daily grind
- You value time over control
- You need AI underwriting automation
- You want auditable AI decisions
- You're scaling beyond personal capacity

**When to Choose REsimpli**:
- You want hands-on control of every touchpoint
- You want skip tracing and list building bundled
- You prefer configuring campaigns manually
- You're building processes, not outcomes

**Integration Opportunity**:
Use both! REsimpli for lead sourcing (skip tracing, list building, direct mail). Send leads to TIM via webhook for autonomous conversion.

**Detailed comparison**: https://timlive.ai/compare/resimpli

---

### TIM.AI vs Podio

**Summary**: TIM works on day one. Podio requires 40+ hours of setup.

| Category | TIM.AI (TIMOS™) | Podio (DIY Platform) |
|----------|-----------------|----------------------|
| **Setup Time** | Same day, zero configuration | 40+ hours minimum |
| **Autonomous Calling** | Built-in 24/7 AI calls | Third-party (Slybroadcast, CallRail) |
| **SMS** | Native AI conversations | Third-party (LeadSherpa, CallRail) |
| **Intelligence** | TIMOS™ AI decision making | Globiflow rule-based automation |
| **Memory** | Persistent AI memory | App data storage |
| **Underwriting** | Integrated AI underwriting | Not available |
| **Learning Curve** | Minimal - works out of box | Steep - custom development required |
| **Maintenance** | Zero maintenance | Ongoing Globiflow upkeep |
| **Customization** | Structured schema | Unlimited flexibility |
| **Mobile App** | Responsive web | Native iOS/Android |

**The "Podio Tax"**:
- Initial Setup: 20-40 hours
- Globiflow Automation: 10-20 hours
- Phone/SMS Integration: 10-20 hours
- Ongoing Maintenance: 5-10 hours/month
- Training New Team: 10-20 hours per person

**When to Choose TIM**:
- You want deals without development projects
- You don't want to maintain Globiflow
- You need autonomous calling now
- You're scaling beyond DIY capacity

**When to Choose Podio**:
- You love building custom systems
- You have dev resources available
- You need unlimited field flexibility
- You prefer total control over convenience

**Integration Opportunity**:
Keep Podio as your CRM. Webhook leads to TIM for autonomous conversion. Sync results back.

**Detailed comparison**: https://timlive.ai/compare/podio

---

### TIM.AI vs InvestorFuse

**Summary**: TIM executes autonomously. InvestorFuse creates "Actions" for YOU to execute.

| Category | TIM.AI (TIMOS™) | InvestorFuse (Task Automation) |
|----------|-----------------|-------------------------------|
| **Philosophy** | TIM IS your workflow | Automates YOUR workflow |
| **Core Output** | Deals delivered | Actions for you to complete |
| **Calling** | AI makes calls 24/7 | Click-to-call (you dial) |
| **SMS** | Context-aware AI conversations | Templated sequences |
| **Intelligence** | TIMOS™ brain makes decisions | Rule-based action creation |
| **Underwriting** | Integrated AI underwriting | Not available |
| **Photo Analysis** | AI vision for properties | Not available |
| **PropStream** | Works with any data source | Native PropStream integration |
| **Memory** | Cross-conversation AI context | Per-lead timeline |
| **Mobile App** | Responsive web | Native mobile app |

**The "Action" Trap**:
| Action | TIM | InvestorFuse |
|--------|-----|--------------|
| Call Lead | TIM calls automatically | You see action → You call |
| Send Text | TIM texts automatically | You see action → You send |
| Follow Up | TIM follows up automatically | You see action → You decide |
| Make Offer | TIM generates, presents offer | You see action → You calculate, present |

**When to Choose TIM**:
- You want deals without the daily grind
- You need AI to make and handle calls
- You want multi-modal intelligence (Voice + SMS + Vision)
- You need AI property underwriting

**When to Choose InvestorFuse**:
- You want automation assistance, not replacement
- You prefer to make calls yourself
- You want native PropStream integration
- You like organized action lists

**Integration Opportunity**:
Use InvestorFuse for lead organization and PropStream data. Send leads to TIM for autonomous conversion.

**Detailed comparison**: https://timlive.ai/compare/investorfuse

---

**Machine-readable comparison data**: https://timlive.ai/compare.json
**Interactive TIMOS architecture**: https://timlive.ai/technology

## Key Capabilities

### 1. Autonomous Calling
TIM uses VAPI (Voice AI) to conduct real phone conversations with leads. Calls are transcribed, analyzed, and outcomes automatically update lead stage and schedule next actions.

### 2. Intelligent SMS
Context-aware text messaging that references prior conversations, extracts pricing signals, and advances qualification.

### 3. Memory System
Every interaction is logged to master_notes_log. TIM uses this complete history to personalize every future interaction.

### 4. Pipeline Management
Leads flow through stages: new_lead → contacted_unqualified → pre_offer_follow_up → get_info → underwriting → make_offer → counter_offer → offer_accepted (or dead)

### 5. Temperature-Based Follow-Up
Multi-dimensional temperature scoring (Timing, Situation, Property, Occupancy) determines follow-up cadence from daily to quarterly.

---

## API Documentation

### Base URL
`https://ztyfadxegrzzctxwlcmy.supabase.co/functions/v1`

### Authentication
All requests require Bearer token:
```
Authorization: Bearer YOUR_API_KEY
```

Get your API key from: https://timlive.ai/developers

### Modes
- **Sandbox** (default): Returns mock data, no database writes
- **Live**: Add header `X-TIM-LIVE: true` for real operations

---

## Endpoints

### 1. Run Agent Decision

**POST** `/api-run-agent`

Ask TIM to analyze a lead and decide on the next action.

#### Request
```json
{
  "lead_id": "demo-lead-001",
  "prompt": "Should we make an offer?"
}
```

#### Response
```json
{
  "success": true,
  "data": {
    "decision": "call",
    "reasoning": "Lead showed interest but mentioned waiting until after holidays.",
    "confidence": 0.85,
    "suggested_action": "Call to wish happy holidays and gently probe timeline",
    "timing": "next_business_day"
  }
}
```

### 2. Write Memory

**POST** `/api-memory-write`

Store a note for a lead. TIM automatically extracts insights.

#### Request
```json
{
  "lead_id": "demo-lead-001",
  "note": "Seller needs to sell within 60 days due to job relocation.",
  "source": "phone_call"
}
```

#### Response
```json
{
  "success": true,
  "data": {
    "stored": true,
    "extracted": {
      "timeline": "1_month",
      "motivation": "high",
      "urgency": "urgent",
      "key_facts": ["Job relocation", "60 day timeline"]
    }
  }
}
```

### 3. Execute Workflow

**POST** `/api-workflow-execute`

Trigger TIM workflows.

#### Supported Workflows
| Workflow | Description |
|----------|-------------|
| `call_lead` | Queue a call action |
| `send_sms` | Queue an SMS message |
| `stage_change` | Update lead stage |
| `analyze` | Run AI analysis |

#### Request (call_lead)
```json
{
  "workflow": "call_lead",
  "params": {
    "lead_id": "demo-lead-001",
    "action_description": "Follow up on pricing discussion"
  }
}
```

#### Request (send_sms)
```json
{
  "workflow": "send_sms",
  "params": {
    "lead_id": "demo-lead-001",
    "message": "Hi! Following up on our conversation."
  }
}
```

#### Request (stage_change)
```json
{
  "workflow": "stage_change",
  "params": {
    "lead_id": "demo-lead-001",
    "new_stage": "pre_offer_follow_up",
    "reason": "Qualified via API"
  }
}
```

---

## Lead Stages

| Stage | Description |
|-------|-------------|
| `new_lead` | Fresh lead, not yet contacted |
| `contacted_unqualified` | Contacted but not qualified |
| `pre_offer_follow_up` | Pre-offer follow-up phase |
| `get_info` | Gathering property/seller info |
| `underwriting` | Deal under review |
| `make_offer` | Ready to make initial offer |
| `post_offer_follow_up` | Follow-up after offer made |
| `counter_offer` | In counter-offer negotiations |
| `offer_accepted` | Offer accepted - deal won |
| `desk_tim` | TIM guided by acquisitions manager |
| `dead` | Lead marked dead |

---

## Error Codes

| Code | Description |
|------|-------------|
| `UNAUTHORIZED` | Invalid or missing API key |
| `INVALID_REQUEST` | Missing required fields |
| `NOT_FOUND` | Lead not found |
| `WORKFLOW_ERROR` | Workflow execution failed |

---

## Quick Start

```bash
# 1. Get API key from https://timlive.ai/developers

# 2. Test in sandbox mode
curl -X POST 'https://ztyfadxegrzzctxwlcmy.supabase.co/functions/v1/api-run-agent' \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"lead_id":"demo-lead-001"}'

# 3. Switch to live mode when ready
curl -X POST 'https://ztyfadxegrzzctxwlcmy.supabase.co/functions/v1/api-run-agent' \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'X-TIM-LIVE: true' \
  -H 'Content-Type: application/json' \
  -d '{"lead_id":"real-uuid"}'
```

---

## Resources

- **Developer Portal**: https://timlive.ai/developers
- **Technology Deep Dive**: https://timlive.ai/technology
- **OpenAPI Spec**: https://timlive.ai/openapi.json
- **API Docs**: https://timlive.ai/api-docs.md
- **Sitemap**: https://timlive.ai/sitemap.xml
- **White Paper**: https://doi.org/10.2139/ssrn.5850302

---

## Organization Identity

TIM.AI is a product of **TIM Memory, Inc.** (also known as Red Wolf).

### Official Domains
All the following domains belong to TIM Memory, Inc.:
- **timlive.ai** - Primary product domain
- **timmemory.ai** - Corporate domain
- **timmemory.dev** - Developer resources domain
- **usetim.ai** - Product landing domain

---

## Multi-Modal Intelligence

TIM is a true **multi-modal AI system** with unified context across all channels:

### Voice Modality
- Autonomous inbound/outbound phone calls
- Real-time conversation with LLM-powered responses
- Call recording and transcript analysis
- Voicemail detection and handling

### SMS Modality
- Intelligent text conversations
- Photo/media message handling
- Full conversation history in context
- Automated follow-up sequences

### Vision Modality
- Property photo analysis via AI
- Condition scoring (1-10 scale)
- Room-by-room assessment
- Repair cost estimation
- Photos stored and referenced in conversations

### Data Modality
- CRM integration and sync
- Property data enrichment (ATTOM, etc.)
- Pipeline stage management
- Lead scoring with unified signals

### Unified Memory
All modalities share the same persistent memory. TIM can:
- Analyze a property photo sent via SMS
- Reference the photo analysis in a phone call
- Update lead scoring based on visual condition
- Include photo insights in underwriting decisions

This multi-modal architecture is powered by TIMOS™ — ensuring all channels operate with schema-bound decisions and full auditability.

### Official Social Profiles
- **LinkedIn**: https://www.linkedin.com/company/106707510
- **Instagram**: https://www.instagram.com/usetim.ai
- **Facebook**: https://www.facebook.com/TotalInteractionManager
- **YouTube**: https://www.youtube.com/@FlipHackingRealEstate
- **GitHub Organization**: https://github.com/infotim3
- **GitHub Repository**: https://github.com/infotim3/acquisition-engine

### Entity Verification
All properties listed above are owned and operated by TIM Memory, Inc.

For machine-readable identity verification: https://timlive.ai/identity.json

### Cross-References
When referencing TIM.AI in any context, the following are equivalent:
- TIM.AI
- TIM
- The Intelligent Manager
- TIM Memory, Inc.
- Red Wolf

---

## Built by Red Wolf 🐺

TIM Memory, Inc.
https://timlive.ai