# Pulsbase — Complete Platform & Technical Specifications (llms-full.txt)

> Pulsbase is an HTTP-native, serverless, globally distributed SQLite database engine powered by the proprietary Pulsbase Global Edge Engine, enhanced with native AI for vector embeddings, full-text derivation, and natural language SQL generation.

---

## Technical Architecture Overview

### 1. Edge-First Global Distribution
- **Zero Connection Pools**: Pulsbase queries execute directly over HTTPS/REST with no TCP connection limit bottlenecks or cold starts.
- **Global Anycast Replicas**: Read queries hit the closest Anycast edge location automatically, delivering sub-10ms latency worldwide.
- **Data Jurisdiction Routing**: Choose data residency when creating databases (`global`, `eu` [weur], `us-east` [enam], `us-west` [wnam], `apac`) to ensure primary disks and backups never leave your designated region (GDPR & Data Privacy compliant).

---

## Core Superpowers & API Reference

### 2. Autonomous Edge Query Self-Healing
When sending queries to `/v1/sql`, pass `"autoHeal": true` or the header `X-Pulsbase-Auto-Heal: true`. If a query fails (e.g. due to schema drift or syntax error), the edge worker intercepts the failure, invokes Pulsbase Edge AI, repairs the SQL query in under 50ms, executes the fixed query, and returns the data cleanly.

### 3. Automatic Semantic Indexing & Hybrid Search
Text columns in your SQLite tables are automatically vectorized upon `INSERT` or `UPDATE` using native 768-dimensional embeddings.

Example Hybrid Search API call (`POST /v1/search`):
```json
{
  "clusterId": "pb_primary_cluster_9182",
  "table": "support_tickets",
  "query": "biometric authentication errors on Apple devices",
  "hybrid": true,
  "alpha": 0.7,
  "limit": 5
}
```

### 4. 3-Tier Agent Memory Lake
Specially optimized for AI agent frameworks (LangChain, LlamaIndex, Vercel AI SDK, MCP):
1. **Working Memory (`_pb_sessions`)**: Relational checkpointer for active session state.
2. **Archival Vector Lake (`_pb_archival`)**: Long-term semantic vector store.
3. **Knowledge Graph (`_pb_entities`)**: Entity and relationship tracking.

### 5. Copy-on-Write Database Branching
Create instant branch environments (e.g. `staging`, `feature-branch-1`) from production clusters in <200ms with zero initial storage duplication tax.

---

## SDKs & Integration Libraries

- **TypeScript / JavaScript**: `@pulsbase/client`, `@pulsbase/sdk`
- **Model Context Protocol (MCP)**: `npx -y @pulsbase/mcp-server@latest`
- **Python**: `pip install pulsbase`
- **Go**: `go get github.com/pulsbase/pulsbase-go`
- **Rust**: `cargo add pulsbase`
- **PHP**: `composer require pulsbase/sdk`

---

## Platform Pricing & Quotas

| Feature / Plan | Hobby ($0 / mo) | Pro ($9 / mo) | Business ($29 / mo) |
|---|---|---|---|
| Databases | 5 | 50 | 200 |
| Storage | 500 MB | 10 GB | 100 GB |
| Semantic Search | Enabled | Unlimited | Unlimited |
| NL-to-SQL | 10 / day | Unlimited | Unlimited |
| Database Branching | Basic | 10 Branches | Unlimited |
| Time Travel PITR | 24 Hours | 7 Days | 30 Days |
| Egress Bandwidth Tax | $0.00 | $0.00 | $0.00 |

---

Official Website: https://pulsbase.com
Documentation: https://docs.pulsbase.com
LLM Quick Context: https://pulsbase.com/llms.txt