wispy-ai 1.5.1 → 1.7.0

package/.env.example

@@ -1,6 +1,13 @@
-# Gemini API Key (required)
+# Engine selection: "gemini" (default) or "claude"
+ENGINE=gemini
+
+# Gemini API Key (required for Gemini engine, and always needed for embeddings)
 GEMINI_API_KEY=your_gemini_api_key_here
 
+# Claude / Anthropic (required when ENGINE=claude)
+# ANTHROPIC_API_KEY=sk-ant-...
+# CLAUDE_MODEL=claude-sonnet-4-20250514
+
 # Telegram Bot Token (optional)
 TELEGRAM_BOT_TOKEN=
 
@@ -42,6 +49,17 @@ TWITTER_API_SECRET=
 TWITTER_ACCESS_TOKEN=
 TWITTER_ACCESS_SECRET=
 
+# ElevenLabs (optional, premium voice AI for natural TTS)
+# ELEVENLABS_API_KEY=
+
+# Agentmail (optional, AI-native email for agents)
+# AGENTMAIL_API_KEY=
+
+# Telnyx (optional, telephony -- voice calls & SMS)
+# TELNYX_API_KEY=
+# TELNYX_CONNECTION_ID=
+# TELNYX_FROM_NUMBER=
+
 # Dashboard
 DASHBOARD_PORT=3000
 GATEWAY_PORT=4000

package/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+## [1.7.0] - 2026-02-23
+
+### Added
+- **Claude Engine** as switchable alternative to Gemini via `@anthropic-ai/sdk`
+- **Engine Abstraction Layer** (`src/ai/engine.ts`) for seamless switching between Gemini and Claude
+- **Memory Bank** skill with 4 typed categories: episodic, semantic, procedural, preference
+- Memory lifecycle management: decay (time-based), reinforcement (access-based), reflection (AI consolidation)
+- 5 new Memory Bank tools: `memory_store_typed`, `memory_reflect`, `memory_forget`, `memory_list_categories`, `memory_get_context`
+- Context-aware memory injection into system prompts
+- Claude extended thinking support with budget token mapping
+- Claude tool_use format conversion from Gemini function declarations
+
+### Changed
+- Project structure cleaned up: tests moved to `tests/integration/`, scripts to `scripts/`, docs to `docs/submissions/`
+- Removed unused stubs (`database/`, `backend/`)
+- Heartbeat now runs Memory Bank decay cycle
+- Router supports Claude model selection (Sonnet for reasoning, Haiku for fast)
+- Engine configurable via `ENGINE=gemini|claude` env var
+
+## [1.6.0] - 2026-02-20
+
+### Added
+- **Named Sessions** with isolated context, daily auto-reset, and instant switching
+- **Process Manager** to spawn, monitor, kill, and auto-restart background processes
+- **Skills.sh Registry** client with search, install, and uninstall for 67,000+ community skills
+- **Cross-Model Delegation** to Claude, GPT-4o, Llama, Groq, Kimi, and 200+ models via OpenRouter
+- **Cross-Model Payment Bridge** so any delegated model can trigger x402 payments
+- **Model Comparison** tool to send the same prompt to multiple models side-by-side
+- **Slack** channel adapter (Socket Mode with mentions, threads)
+- **Matrix** channel adapter (Client-Server API v3, long-poll sync)
+- **Signal** channel adapter (signal-cli REST API)
+- 14 new integrations: LinkedIn, Instagram, Reddit, MS Teams, Matrix, Signal, Trello, Asana, Calendly, Image Generation, Camera/Screenshot, Stripe, 1Password, Sonos
+- Canvas integration for SVG and Mermaid diagram generation
+- Budget controls with daily limits, per-transaction caps, auto-approve thresholds
+- Proactive goal tools (agent_goal_set, agent_goals_list)
+- Multi-provider setup wizard (configure Gemini + Anthropic + OpenAI + Ollama + OpenRouter in one flow)
+
+### Changed
+- Tool count expanded from 90+ to 120+
+- Integration count expanded from 27 to 42+
+- Channel count expanded from 7 to 10
+- Updated README to comprehensive product documentation
+- Updated docs site (docs.wispy.cc) with all v1.6 features
+
+## [1.5.1] - 2026-02-08
+
+### Added
+- Marathon Mode with autonomous multi-step execution, checkpointing, and auto-recovery
+- Thinking Levels (low/medium/high/ultra) with up to 24K thinking tokens
+- x402 agentic commerce with USDC payments on SKALE
+- AP2 mandate chains and BITE v2 encryption
+- DeFi swap engine with Algebra DEX integration
+- Telegram and WhatsApp channel adapters with Marathon support
+- Discord channel adapter with threads and file uploads
+- REST API and WebSocket channels
+- Agent-to-Agent (A2A) protocol support
+- 90+ built-in tools across file system, web, browser, code execution, memory, media, blockchain
+- 27 integrations across Google, productivity, social, smart home, and AI models
+- Browser automation with 39 tools + 55 built-in skills via Playwright
+- Interactive setup wizard (onboard command)
+- Health check (doctor command)
+- Day/night theme support
+
+## [1.0.0] - 2026-01-15
+
+- Initial release

package/README.md

@@ -2,315 +2,241 @@
   <img src="assets/banner.png" alt="Wispy Banner" width="100%" />
 </p>
 
-<h1 align="center">Wispy — Agentic Commerce on SKALE</h1>
+<h1 align="center">Wispy</h1>
 
 <p align="center">
-  <strong>An AI Agent That Can Spend Money on the Internet by Itself</strong>
+  <strong>Autonomous AI Agent Platform</strong><br />
+  <em>125+ tools, 42+ integrations, dual-engine (Gemini + Claude), Memory Bank, sessions, skills.sh, x402 commerce</em>
 </p>
 
 <p align="center">
-  <a href="https://dorahacks.io/hackathon/x402"><img src="https://img.shields.io/badge/Hackathon-SF%20Agentic%20Commerce%20x402-purple?style=flat-square" alt="x402 Hackathon" /></a>
   <a href="https://www.npmjs.com/package/wispy-ai"><img src="https://img.shields.io/npm/v/wispy-ai?style=flat-square&color=31ccff" alt="npm version" /></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License" /></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square" alt="Node.js" /></a>
   <a href="https://www.typescriptlang.org"><img src="https://img.shields.io/badge/TypeScript-5.7-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /></a>
-  <a href="https://github.com/hausorlabs/wispy"><img src="https://img.shields.io/badge/Submission-Hausor%20Labs-31ccff?style=flat-square" alt="Hausor Labs" /></a>
 </p>
 
 <p align="center">
-  <a href="#what-we-built">What We Built</a> &middot;
-  <a href="#track-coverage">Tracks</a> &middot;
-  <a href="#hackathon-implementation">Implementation</a> &middot;
-  <a href="#run-the-demo">Run Demo</a> &middot;
-  <a href="#architecture">Architecture</a> &middot;
-  <a href="https://wispy.cc">Website</a>
+  <a href="https://docs.wispy.cc">Docs</a> &middot;
+  <a href="https://wispy.cc">Website</a> &middot;
+  <a href="https://app.wispy.cc">Platform</a> &middot;
+  <a href="https://github.com/hausorlabs/wispy">GitHub</a>
 </p>
 
 ---
 
-## SF Agentic Commerce x402 Hackathon — SKALE Labs
-
-> **Hackathon**: [SF Agentic Commerce x402](https://dorahacks.io/hackathon/x402) | **Dates**: Feb 11–14, 2026 | **Prize Pool**: $50,000
->
-> **Team**: [Hausor Labs](https://hausorlabs.tech) — Brian Mwai, Joy C. Langat
-
----
-
-## What We Built
-
-Wispy is an **autonomous AI agent** powered by Google Gemini 2.5 Pro that can **discover, evaluate, pay for, and consume** paid services on the internet — entirely on its own.
+## What is Wispy?
 
-During the hackathon, we built a complete **agentic commerce integration** on SKALE's BITE V2 Sandbox that covers all 5 tracks:
+Wispy is an autonomous AI agent that lives in your terminal, messaging apps, and APIs. Dual-engine architecture powered by Google Gemini 2.5 Pro and Anthropic Claude, with cross-model delegation to GPT-4o, Llama, and 200+ models via OpenRouter. Features a structured Memory Bank with typed categories, lifecycle management, and AI-powered reflection.
 
-1. **The agent finds a paid API** — discovers services behind HTTP 402 paywalls
-2. **It decides if it's worth paying** — evaluates cost vs. budget with spending controls
-3. **It pays with crypto** — signs EIP-3009 USDC authorizations, routed through Kobaru facilitator
-4. **It encrypts sensitive transactions** — uses BITE v2 BLS threshold encryption so validators can't see the `to` or `data` fields until consensus
-5. **It produces a full audit trail** — every payment logged, every decision tracked, every receipt stored
-
-No human intervention. No manual approvals for micro-payments. The agent manages its own wallet, respects its spending policy, and chains multiple paid calls to complete complex tasks.
+```bash
+npm install -g wispy-ai
+wispy onboard
+wispy chat
+```
 
 ---
 
-## Track Coverage
-
-| Track | Prize | What Wispy Demonstrates | Key Files |
-|-------|-------|------------------------|-----------|
-| **1. Overall Best Agent** | $9,500 | End-to-end: discover paid API → decide ROI → pay with USDC → deliver result → audit trail | [`demo/scenarios/track1-overall.ts`](src/integrations/agentic-commerce/demo/scenarios/track1-overall.ts) |
-| **2. x402 Tool Usage** | $7,000 | Chained x402 calls with EIP-3009 signed authorizations, budget-aware spending, per-call tracking | [`x402/buyer.ts`](src/integrations/agentic-commerce/x402/buyer.ts), [`x402/tracker.ts`](src/integrations/agentic-commerce/x402/tracker.ts) |
-| **3. AP2 Integration** | $7,000 | Intent → Cart → Payment → Receipt mandate chain with failure handling and rollback | [`ap2/flow.ts`](src/integrations/agentic-commerce/ap2/flow.ts) |
-| **4. DeFi Agent** | $3,000 | Multi-source research via Algebra DEX subgraphs, risk engine with guardrails, on-chain swaps | [`defi/swap.ts`](src/integrations/agentic-commerce/defi/swap.ts), [`defi/risk-engine.ts`](src/integrations/agentic-commerce/defi/risk-engine.ts) |
-| **5. Encrypted Agents (BITE v2)** | $4,500 | BLS threshold encryption of transactions, conditional execution, on-chain verification | [`bite/encrypted-tx.ts`](src/integrations/agentic-commerce/bite/encrypted-tx.ts) |
+## Features
+
+### Core
+
+- **125+ Built-in Tools** across file system, web, browser automation, code execution, memory, media, blockchain, and identity
+- **Dual Engine** -- switch between Gemini and Claude with a single env var (`ENGINE=gemini|claude`)
+- **Memory Bank** with 4 typed categories (episodic, semantic, procedural, preference), time-based decay, reinforcement, and AI-powered reflection
+- **Marathon Mode** for multi-step, long-running autonomous tasks with checkpointing and auto-recovery
+- **Thinking Levels** (low/medium/high/ultra) with up to 24K thinking tokens (Gemini) or 32K budget tokens (Claude)
+- **Named Sessions** with isolated context, daily auto-reset, and instant switching
+- **Process Manager** to spawn, monitor, and manage background processes
+- **Skills.sh Registry** with 67,000+ community skills you can install with a single command
+
+### Multi-Model / Dual Engine
+
+- **Gemini 2.5 Pro** -- primary reasoning engine with native function calling and extended thinking
+- **Claude (Opus/Sonnet/Haiku)** -- switchable alternative engine via `@anthropic-ai/sdk` with tool_use and extended thinking
+- **Engine abstraction layer** -- seamless switching, embeddings always via Gemini
+- **Cross-model delegation** to GPT-4o, Groq, Kimi, Llama via Ollama, and 200+ models via OpenRouter
+- **Model comparison** to send the same prompt to multiple models and compare responses
+- **Setup wizard** configures all providers in one flow
+
+### Channels (10)
+
+| Channel | Status |
+|---------|--------|
+| CLI (REPL) | Built-in |
+| Telegram | Full adapter with Marathon support, file access, voice |
+| WhatsApp | Baileys adapter with Marathon support |
+| Discord | Full adapter with threads, file uploads |
+| Slack | Socket Mode adapter with mentions, threads |
+| Matrix | Client-Server API v3 with long-poll sync |
+| Signal | signal-cli REST API adapter |
+| REST API | Express with API key auth |
+| WebSocket | Real-time streaming |
+| Agent-to-Agent (A2A) | Google A2A protocol |
+
+### Integrations (42+)
+
+| Category | Integrations |
+|----------|-------------|
+| AI Models | OpenAI, Anthropic, Ollama, OpenRouter, Groq, Kimi |
+| Google | Calendar, Docs, Drive, Gmail, Maps, Meet, Search, Sheets, YouTube |
+| Chat | Discord, Slack, Matrix, Signal, MS Teams |
+| Productivity | Notion, GitHub, Linear, Obsidian, Trello, Asana, Calendly |
+| Social | Twitter/X, LinkedIn, Instagram, Reddit |
+| Smart Home | Home Assistant, Hue, Sonos |
+| Music | Spotify |
+| Commerce | Stripe |
+| Security | 1Password |
+| Media | Image Generation (DALL-E/Stability/Replicate), Camera/Screenshot |
+| Tools | Weather, Webhooks, Canvas (SVG/Mermaid) |
+| Browser | 39 automation tools + 55 built-in skills via Playwright |
+
+### Agentic Commerce (x402)
+
+- **x402 protocol** for autonomous USDC payments on SKALE (gasless)
+- **AP2 mandate chains** (intent, cart, payment, receipt)
+- **BITE v2 encryption** for private transactions (BLS threshold)
+- **DeFi swap engine** with Algebra DEX integration and risk controls
+- **Cross-model payment bridge** so any AI model can trigger payments
+- **Budget controls** with daily limits, per-transaction caps, auto-approve thresholds
 
 ---
 
-## Hackathon Implementation
-
-> **All hackathon code lives in: [`src/integrations/agentic-commerce/`](src/integrations/agentic-commerce/)**
->
-> **25 TypeScript files | 4,470 lines of code | 46 tests passing | 0 TypeScript errors**
-
-### Directory Breakdown
+## Quick Start
 
-```
-src/integrations/agentic-commerce/
-│
-├── config.ts                        # SKALE BITE V2 chain config, Algebra DEX contracts + ABIs
-│
-├── x402/                            # Track 2: x402 Protocol
-│   ├── buyer.ts                     # HTTP 402 detection → EIP-3009 USDC authorization → retry with proof
-│   ├── seller.ts                    # Mock x402 seller endpoints for demo services
-│   └── tracker.ts                   # Per-call spend tracking, daily audit ledger, budget enforcement
-│
-├── ap2/                             # Track 3: AP2 Protocol
-│   ├── mandates.ts                  # Intent / Cart / Payment mandate objects
-│   ├── receipts.ts                  # Payment receipts + transaction records
-│   └── flow.ts                      # AP2 orchestration engine (mandate chain with rollback)
-│
-├── defi/                            # Track 4: DeFi Agent
-│   ├── swap.ts                      # Algebra DEX integration (SwapRouter + QuoterV2), direct USDC fallback
-│   └── risk-engine.ts               # Position limits, volatility checks, slippage controls
-│
-├── bite/                            # Track 5: Encrypted Agents
-│   ├── encrypted-tx.ts              # BITE v2 BLS threshold encryption, on-chain submit + verify
-│   └── conditional.ts               # Conditional execution: time-lock, delivery-proof, oracle gates
-│
-├── demo/                            # Live Demo Infrastructure
-│   ├── server.ts                    # Launches mock x402 services (weather, sentiment, report, price)
-│   ├── runner.ts                    # Runs all 5 track demos end-to-end
-│   ├── verify.ts                    # On-chain verification utilities
-│   └── scenarios/
-│       ├── track1-overall.ts        # Full agent commerce lifecycle
-│       ├── track2-x402.ts           # Chained x402 paid API calls
-│       ├── track3-ap2.ts            # AP2 mandate flow demo
-│       ├── track4-defi.ts           # DeFi research + swap demo
-│       └── track5-bite.ts           # BITE encrypted transaction demo
-│
-├── tests/                           # 46 Tests (vitest)
-│   ├── ap2-flow.test.ts
-│   ├── bite-encrypt.test.ts
-│   ├── integration.test.ts
-│   ├── risk-engine.test.ts
-│   └── tracker.test.ts
-│
-├── index.ts                         # Integration entry: 11 agent tools registered into Wispy
-└── README.md                        # Detailed integration documentation
-```
+```bash
+# Install
+npm install -g wispy-ai
 
-### How Each Protocol Works
+# Interactive setup (Gemini key + optional providers + Telegram + wallet)
+wispy onboard
 
-**x402 Payment Flow (Track 2):**
-```
-Agent makes HTTP request → Server returns 402 Payment Required
-→ Agent reads price from x402 headers → Checks budget policy
-→ Signs EIP-3009 USDC authorization → Sends to Kobaru facilitator
-→ Facilitator settles on SKALE → Agent retries request with payment proof
-→ Server validates receipt → Returns paid content → Agent logs spend
-```
+# Chat in the terminal
+wispy chat
 
-**AP2 Mandate Chain (Track 3):**
-```
-Agent creates INTENT mandate ("I need weather data")
-→ Service responds with CART mandate (items + pricing)
-→ Agent creates PAYMENT mandate (signed USDC authorization)
-→ Service creates RECEIPT mandate (delivery confirmation)
-→ Any step can fail → automatic rollback and retry with budget adjustment
-```
+# Start a Marathon (autonomous multi-step task)
+wispy marathon "Build a full-stack SaaS dashboard with auth and payments"
 
-**BITE v2 Encryption Flow (Track 5):**
-```
-Agent encrypts transaction fields (to + calldata) with BLS threshold keys
-→ Submits encrypted tx to SKALE BITE magic address
-→ Transaction is opaque in mempool — no MEV, no front-running
-→ Validators cooperatively decrypt during consensus (2t+1 threshold)
-→ Agent verifies decryption via bite_getDecryptedTransactionData RPC
-```
+# Run the gateway (all channels simultaneously)
+wispy gateway
 
-**DeFi Agent Flow (Track 4):**
+# Run as a background daemon
+wispy gateway --daemon
 ```
-Agent queries Algebra DEX subgraph for pool data
-→ Checks on-chain liquidity via Factory.poolByPair()
-→ Runs risk engine (position limits, slippage, volatility)
-→ Executes swap via SwapRouter.exactInputSingle() or falls back to direct USDC transfer
-→ Logs trade decision with reason codes and risk score
-```
-
-### Agent Tools (11 Registered)
-
-The integration registers 11 tools into Wispy's tool system, making them available to the AI agent during conversations and autonomous tasks:
-
-| Tool | Track | Description |
-|------|-------|-------------|
-| `x402_pay_and_fetch` | 1, 2 | Access paid APIs via x402 with automatic payment |
-| `x402_check_budget` | 1, 2 | Check daily budget, spending limits, remaining allowance |
-| `x402_audit_trail` | 1, 2 | Full payment audit trail with per-call breakdown |
-| `ap2_purchase` | 3 | AP2 mandate flow: intent → cart → payment → receipt |
-| `ap2_get_receipts` | 3 | Retrieve AP2 transaction records |
-| `defi_research` | 4 | Multi-source market research via Algebra subgraphs |
-| `defi_swap` | 4 | Risk-controlled token swap on Algebra DEX |
-| `defi_trade_log` | 4 | Trade decisions with reason codes and risk scores |
-| `bite_encrypt_payment` | 5 | BITE v2 BLS threshold encryption of transactions |
-| `bite_check_and_execute` | 5 | Conditional execution of encrypted transactions |
-| `bite_lifecycle_report` | 5 | Encrypted payment lifecycle report |
 
 ---
 
-## Run the Demo
+## CLI Commands
 
 ```bash
-# Clone the repo
-git clone https://github.com/hausorlabs/wispy.git
-cd wispy
+wispy chat                    # Interactive REPL
+wispy agent "prompt"          # Single-shot prompt
+wispy marathon "goal"         # Autonomous multi-step task
+wispy gateway                 # Start all channels
+wispy onboard                 # Setup wizard
+wispy doctor                  # Health check
+wispy skills list             # List browser skills
+wispy integrations list       # List all integrations
+wispy wallet balance          # Check wallet balance
+wispy wallet details          # Wallet address + chain info
+```
 
-# Install dependencies
-npm install
+---
 
-# Start mock x402 services (weather, sentiment, report, price data)
-npx tsx src/integrations/agentic-commerce/demo/server.ts
+## Configuration
 
-# Run all 5 track demos (in another terminal)
-npx tsx src/integrations/agentic-commerce/demo/runner.ts
+Wispy uses `~/.wispy/config.yaml` for configuration and `.env` for secrets:
 
-# Run with real on-chain BITE transactions (requires funded wallet)
-AGENT_PRIVATE_KEY=0x... npx tsx src/integrations/agentic-commerce/demo/runner.ts
+```yaml
+# config.yaml
+engine: gemini  # or "claude"
 
-# Run individual tracks
-npx tsx src/integrations/agentic-commerce/demo/scenarios/track5-bite.ts
+gemini:
+  models:
+    pro: gemini-2.5-pro-preview-05-06
+    flash: gemini-2.5-flash-preview-05-20
 
-# Run tests (46/46 passing)
-npx vitest run src/integrations/agentic-commerce/tests/
-```
+claude:
+  models:
+    reasoning: claude-sonnet-4-20250514
+    fast: claude-haiku-4-5-20251001
 
-### Environment Variables
+channels:
+  telegram: { enabled: true }
+  discord: { enabled: false }
+  slack: { enabled: false }
 
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `AGENT_PRIVATE_KEY` | For on-chain | Hex private key for the agent wallet (EIP-3009 signing) |
-| `SELLER_PRIVATE_KEY` | No | Hex private key for mock seller (auto-generated if not set) |
-| `GEMINI_API_KEY` | For AI | Google Gemini API key for the agent's reasoning engine |
+providers:
+  anthropic: { apiKey: "..." }
+  openai: { apiKey: "..." }
 
----
+security:
+  autonomousMode: true
+  fullFilesystemAccess: true
 
-## Network & Contracts
+wallet:
+  enabled: true
+  chain: skale-bite-sandbox
 
-| Component | Value |
-|-----------|-------|
-| **Chain** | SKALE BITE V2 Sandbox (Chain ID: `103698795`) |
-| **RPC** | `https://base-sepolia-testnet.skalenodes.com/v1/bite-v2-sandbox` |
-| **USDC** | `0xc4083B1E81ceb461Ccef3FDa8A9F24F0d764B6D8` |
-| **Facilitator** | `https://gateway.kobaru.io` |
-| **Gas** | Free (SKALE is gasless) |
-| **Algebra SwapRouter** | `0x3012E9049d05B4B5369D690114D5A5861EbB85cb` |
-| **Algebra QuoterV2** | `0x03f8B4b140249Dc7B2503C928E7258CCe1d91F1A` |
-| **Algebra Factory** | `0x10253594A832f967994b44f33411940533302ACb` |
-| **BITE Magic Address** | `0x42495445204D452049274d20454e435259505444` |
+theme: day
+```
+
+```bash
+# .env
+ENGINE=gemini              # Switch engine: gemini or claude
+GEMINI_API_KEY=AIza...
+ANTHROPIC_API_KEY=sk-ant-...
+CLAUDE_MODEL=claude-sonnet-4-20250514  # Optional override
+TELEGRAM_BOT_TOKEN=123456:ABC...
+AGENT_PRIVATE_KEY=0x...
+OPENAI_API_KEY=sk-...
+```
 
 ---
 
 ## Architecture
 
-### Agentic Commerce Layer
-
 ```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    WISPY AGENTIC COMMERCE                           │
-├─────────────────────────────────────────────────────────────────────┤
-│                                                                     │
-│   AI Agent (Gemini 2.5 Pro)                                        │
-│   ┌──────────────────────────────────────────────────────────┐     │
-│   │  "Find weather data, pay for it, encrypt the payment"    │     │
-│   └──────────────┬───────────────────────────────────────────┘     │
-│                  │                                                   │
-│   ┌──────────────▼───────────────────────────────────────────┐     │
-│   │              11 Agent Tools                               │     │
-│   │  x402_pay_and_fetch │ ap2_purchase │ defi_swap │ bite_*  │     │
-│   └──────┬──────────┬──────────┬──────────┬─────────────────┘     │
-│          │          │          │          │                         │
-│   ┌──────▼────┐ ┌───▼────┐ ┌──▼─────┐ ┌─▼──────────┐            │
-│   │  x402     │ │  AP2   │ │  DeFi  │ │  BITE v2   │            │
-│   │  Buyer    │ │ Mandate│ │  Swap  │ │  Encrypted │            │
-│   │  + Track  │ │ Chain  │ │ Engine │ │  Commerce  │            │
-│   └──────┬────┘ └───┬────┘ └──┬─────┘ └─┬──────────┘            │
-│          │          │          │          │                         │
-│   ┌──────▼──────────▼──────────▼──────────▼─────────────────┐     │
-│   │           SKALE BITE V2 Sandbox (Gasless)                │     │
-│   │  USDC │ Algebra DEX │ BITE BLS Encryption │ Kobaru      │     │
-│   └─────────────────────────────────────────────────────────┘     │
-│                                                                     │
-└─────────────────────────────────────────────────────────────────────┘
+              ┌──────────────────┐     ┌──────────────────┐
+              │  Gemini 2.5 Pro  │ ◄─► │  Claude (Anthropic│
+              │  (default)       │     │  (switchable)     │
+              └────────┬─────────┘     └────────┬─────────┘
+                       └──────────┬─────────────┘
+                       ┌──────────▼──────────┐
+                       │  Engine Abstraction  │
+                       │  + Memory Bank       │
+                       │  + Cross-Model Bridge│
+                       └──────────┬──────────┘
+                                  │
+              ┌───────────────────┼───────────────────┐
+              │                   │                     │
+     ┌────────▼──────┐  ┌───────▼───────┐  ┌─────────▼────────┐
+     │  125+ Tools    │  │  42+ Integs   │  │  x402 Commerce   │
+     │  Sessions      │  │  Skills.sh    │  │  Payment Bridge  │
+     │  Processes     │  │  Browser (39) │  │  Budget Policy   │
+     └────────┬──────┘  └───────┬───────┘  └─────────┬────────┘
+              │                  │                      │
+     ┌────────▼──────────────────▼──────────────────────▼──────┐
+     │                    Channel Dock                          │
+     │  CLI | Telegram | WhatsApp | Discord | Slack | Matrix   │
+     │  Signal | REST | WebSocket | A2A                        │
+     └─────────────────────────────────────────────────────────┘
 ```
 
-### Wispy Platform (Pre-existing)
-
-Wispy is a full autonomous AI agent platform with:
-
-- **Marathon Mode** — Multi-day autonomous task execution with checkpointing
-- **27+ Built-in Tools** — File ops, web scraping, browser automation, image generation
-- **Multi-Channel** — CLI, Telegram, WhatsApp, REST API, WebSocket
-- **ERC-8004 Identity** — On-chain agent registration on Base Sepolia
-- **A2A Protocol** — Agent-to-agent communication (Google)
-- **Memory System** — SQLite + vector embeddings for persistent context
-
-The agentic commerce integration plugs into this platform as a first-class integration, registering its 11 tools alongside Wispy's existing 27+ tools.
-
 ---
 
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **AI Agent** | Wispy (TypeScript, Google Gemini 2.5 Pro) |
-| **Blockchain** | SKALE BITE V2 Sandbox |
-| **Payments** | x402 protocol (EIP-3009 signed USDC) |
-| **Wallet** | viem + @x402/evm |
-| **DEX** | Algebra Integral v1.2.2 (concentrated liquidity) |
-| **Encryption** | BITE v2 BLS threshold encryption (@skalenetwork/bite) |
-| **Authorization** | AP2 mandate protocol |
-| **Runtime** | Node.js 20+, TypeScript 5.7, ESM |
-| **Testing** | vitest (46 tests) |
-| **Mock Services** | Express.js + @x402/express |
-
----
+## Documentation
 
-## Hackathon Build Log
-
-| Day | Date | What We Built |
-|-----|------|---------------|
-| **Day 1** | Feb 11 | SKALE chain config, x402 buyer/seller/tracker, wallet setup, dependency integration |
-| **Day 2** | Feb 12 | AP2 mandate chain, BITE v2 encrypted transactions, DeFi swap engine with Algebra DEX |
-| **Day 3** | Feb 13 | Integration loader (11 tools), 5-track demo scenarios, 46 tests, demo infrastructure |
-| **Day 4** | Feb 14 | Documentation, CHANGELOG, README, submission polish |
+Full documentation at **[docs.wispy.cc](https://docs.wispy.cc)**
 
 ---
 
-## Deployed Contracts
+## Team
+
+Built by [Hausor Labs](https://hausorlabs.tech)
 
-| Contract | Address | Network |
-|----------|---------|---------|
-| Agent Registry | [`0x158B236CC840FD3039a3Cf5D72AEfBF2550045C7`](https://sepolia.basescan.org/address/0x158B236CC840FD3039a3Cf5D72AEfBF2550045C7) | Base Sepolia |
-| USDC (Sandbox) | `0xc4083B1E81ceb461Ccef3FDa8A9F24F0d764B6D8` | SKALE BITE V2 Sandbox |
-| Algebra SwapRouter | `0x3012E9049d05B4B5369D690114D5A5861EbB85cb` | SKALE BITE V2 Sandbox |
-| Algebra Factory | `0x10253594A832f967994b44f33411940533302ACb` | SKALE BITE V2 Sandbox |
+- **Brian Mwai** - Engineering
+- **Joy C. Langat** - Product
 
 ---
 
@@ -320,13 +246,10 @@ The agentic commerce integration plugs into this platform as a first-class integ
 
 ---
 
-<p align="center">
-  <strong>Wispy</strong> is built by <a href="https://hausorlabs.tech">Hausor Labs</a>
-</p>
-
 <p align="center">
   <a href="https://wispy.cc">wispy.cc</a> &middot;
   <a href="https://docs.wispy.cc">docs</a> &middot;
+  <a href="https://app.wispy.cc">platform</a> &middot;
   <a href="https://www.npmjs.com/package/wispy-ai">npm</a> &middot;
   <a href="https://github.com/hausorlabs/wispy">GitHub</a>
 </p>

package/dist/agents/tool-executor.d.ts

@@ -63,6 +63,11 @@ export declare class ToolExecutor {
     private executeFileSearch;
     private executeMemorySearch;
     private executeMemorySave;
+    private executeMemoryStoreTyped;
+    private executeMemoryReflect;
+    private executeMemoryForget;
+    private executeMemoryListCategories;
+    private executeMemoryGetContext;
     private executeWebFetch;
     private executeWebSearch;
     private executeImageGenerate;

package/dist/agents/tool-executor.d.ts.map

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