wispy-ai 0.1.0

package/dist/wallet/x402.js

@@ -0,0 +1,63 @@
+import { ethers } from "ethers";
+import { resolve } from "path";
+import { readJSON, writeJSON, ensureDir } from "../utils/file.js";
+import { encryptCredential } from "../security/encryption.js";
+import { createLogger } from "../infra/logger.js";
+const log = createLogger("wallet");
+const USDC_BASE_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+export function getWalletPath(runtimeDir) {
+    return resolve(runtimeDir, "wallet", "wallet.json");
+}
+export function initWallet(runtimeDir, identity, chain = "base") {
+    const walletPath = getWalletPath(runtimeDir);
+    ensureDir(resolve(runtimeDir, "wallet"));
+    // Check existing
+    const existing = readJSON(walletPath);
+    if (existing) {
+        log.info("Wallet loaded: %s", existing.info.address);
+        return existing.info;
+    }
+    // Generate new wallet
+    const wallet = ethers.Wallet.createRandom();
+    const encryptedKey = encryptCredential(identity, wallet.privateKey);
+    const state = {
+        info: {
+            address: wallet.address,
+            chain,
+            createdAt: new Date().toISOString(),
+        },
+        encryptedKey,
+    };
+    writeJSON(walletPath, state);
+    log.info("Wallet created: %s on %s", wallet.address, chain);
+    return state.info;
+}
+export function getWalletAddress(runtimeDir) {
+    const state = readJSON(getWalletPath(runtimeDir));
+    return state?.info.address || null;
+}
+export async function getBalance(runtimeDir, rpcUrl = "https://mainnet.base.org") {
+    const state = readJSON(getWalletPath(runtimeDir));
+    if (!state)
+        return "0";
+    const provider = new ethers.JsonRpcProvider(rpcUrl);
+    // ETH balance
+    const ethBal = await provider.getBalance(state.info.address);
+    // USDC balance (ERC-20)
+    const usdcAbi = ["function balanceOf(address) view returns (uint256)"];
+    const usdc = new ethers.Contract(USDC_BASE_ADDRESS, usdcAbi, provider);
+    try {
+        const usdcBal = await usdc.balanceOf(state.info.address);
+        return ethers.formatUnits(usdcBal, 6); // USDC has 6 decimals
+    }
+    catch {
+        return "0";
+    }
+}
+export function logTransaction(runtimeDir, tx) {
+    const txPath = resolve(runtimeDir, "wallet", "transactions.json");
+    const txs = readJSON(txPath) || [];
+    txs.push({ ...tx, timestamp: new Date().toISOString() });
+    writeJSON(txPath, txs);
+}
+//# sourceMappingURL=x402.js.map

package/dist/wallet/x402.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "wispy-ai",
+  "version": "0.1.0",
+  "description": "Autonomous AI agent platform powered by Google Gemini — multi-agent, 27+ integrations, voice mode, MCP server",
+  "type": "module",
+  "bin": {
+    "wispy-ai": "./bin/wispy.js",
+    "wispy": "./bin/wispy.js"
+  },
+  "main": "./dist/cli/program.js",
+  "files": [
+    "bin/",
+    "dist/",
+    "wispy/",
+    ".env.example",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli/program.ts gateway",
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/cli/program.js gateway",
+    "doctor": "tsx src/cli/program.ts doctor",
+    "postinstall": "node ./dist/cli/postinstall.js 2>/dev/null || true"
+  },
+  "keywords": [
+    "ai", "agent", "gemini", "autonomous", "cli", "multi-agent",
+    "voice", "mcp", "integrations", "google", "wispy"
+  ],
+  "author": "Brian Mwai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brn-mwai/wispy.git"
+  },
+  "homepage": "https://github.com/brn-mwai/wispy#readme",
+  "bugs": {
+    "url": "https://github.com/brn-mwai/wispy/issues"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@whiskeysockets/baileys": "^6.7.0",
+    "ajv": "^8.17.0",
+    "better-sqlite3": "^11.7.0",
+    "chalk": "^5.6.2",
+    "chokidar": "^4.0.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "croner": "^9.0.0",
+    "dotenv": "^16.4.0",
+    "ethers": "^6.13.0",
+    "express": "^4.21.0",
+    "grammy": "^1.35.0",
+    "json5": "^2.2.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "nanoid": "^5.0.0",
+    "ora": "^9.1.0",
+    "pino": "^9.0.0",
+    "pino-pretty": "^11.0.0",
+    "tweetnacl": "^1.0.3",
+    "ws": "^8.18.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/wispy/AGENTS.md

@@ -0,0 +1,46 @@
+# Agent Operating Rules
+
+## Session Types
+
+### Main Session
+- Full access to MEMORY.md, daily notes, all tools
+- Session key: `agent:{agentId}:main:{peerId}`
+- Loads complete soul context
+
+### Cron Session
+- Isolated: NO access to MEMORY.md or main history
+- Session key: `agent:{agentId}:cron:{jobId}`
+- Limited to job-specific tools
+- Reports results to main session via memory notes
+
+### Group Session
+- No MEMORY.md access
+- Session key: `agent:{agentId}:group:{groupId}`
+- Restricted behavior (no personal info, no wallet ops)
+- Allowlist-only group membership
+
+### Subagent Session
+- Scoped tool access (defined by parent)
+- Session key: `agent:{agentId}:sub:{taskId}`
+- Reports results to parent agent
+
+## Safety Rules
+1. NEVER execute destructive commands without explicit approval
+2. NEVER expose API keys, wallet keys, or credentials in responses
+3. ALWAYS use `trash` instead of `rm` for file deletion
+4. ALWAYS confirm before: sending messages, posting content, transferring funds
+5. Rate-limit external API calls to prevent abuse
+6. Log all tool executions for audit trail
+7. Wallet transactions above threshold require explicit approval
+
+## Tool Execution
+- Internal tools (read, search, organize): auto-approved
+- External tools (send, post, pay): require user confirmation
+- Destructive tools (delete, overwrite): require explicit approval
+- Skill tools: follow skill-defined approval rules
+
+## Memory Management
+- Persist important facts to MEMORY.md via heartbeat
+- Write daily notes for session summaries
+- Vector-embed all conversations for semantic search
+- Prune stale memories during heartbeat cycle

package/wispy/BOOT.md

@@ -0,0 +1,28 @@
+# Boot Sequence
+
+This file is executed on first run to bootstrap Wispy.
+
+## First Run Checklist
+1. Generate Ed25519 device identity keypair
+2. Create `.wispy/` runtime directory structure
+3. Generate default `config.yaml`
+4. Prompt user for Gemini API key (if not in .env)
+5. Verify Gemini API connectivity
+6. Initialize empty session store
+7. Initialize memory database (SQLite + vectors)
+8. Display welcome message with Wispy ☁️👀
+
+## Welcome Message
+```
+  ☁️👀
+  Hi! I'm Wispy — your autonomous AI companion.
+
+  I'm powered by Google Gemini 3 and I can:
+  • Plan and execute complex tasks autonomously
+  • Connect to Telegram, WhatsApp, and more
+  • Generate images and create content
+  • Manage a crypto wallet for payments
+  • Remember everything important about you
+
+  Let's get started! Type 'wispy onboard' to set up.
+```

package/wispy/CONTEXT.md

@@ -0,0 +1,13 @@
+# Context
+
+## Current State
+- Agent status: initializing
+- Active channels: none
+- Memory entries: 0
+- Skills loaded: 0
+- Wallet: not initialized
+
+## Environment
+- Platform: auto-detected
+- Node version: required >= 20
+- Gemini models: Pro, Flash, Pro Image, Live, Embedding

package/wispy/HEARTBEAT.md

@@ -0,0 +1,17 @@
+# Heartbeat
+
+The heartbeat runs periodically (default: every 30 minutes) to maintain agent state.
+
+## Heartbeat Tasks
+1. **Memory Sync**: Review recent conversations, extract key facts, update MEMORY.md
+2. **Daily Note**: Append summary to today's daily note
+3. **Session Cleanup**: Archive old sessions, prune stale data
+4. **Health Check**: Verify channel connections, report issues
+5. **Cron Review**: Check pending cron jobs, report results
+
+## Heartbeat State
+Stored in `wispy/memory/heartbeat-state.json`:
+- Last run timestamp
+- Last memory sync point
+- Pending follow-ups
+- Channel health status

package/wispy/IDENTITY.md

@@ -0,0 +1,26 @@
+# Wispy Identity
+
+**Name**: Wispy
+**Icon**: ☁️👀
+**Tagline**: Your autonomous cloud companion
+
+## About
+Wispy is an open-source autonomous AI agent powered by Google Gemini 3. A friendly white cloud with curious eyes, Wispy can plan, execute, and self-correct complex tasks across multiple channels.
+
+## Capabilities
+- Multi-model reasoning (Gemini Pro, Flash, Image, Live)
+- Telegram and WhatsApp messaging
+- Web dashboard and REST API
+- Content creation and publishing
+- Crypto wallet (x402, USDC on Base)
+- Agent-to-agent communication
+- Extensible skill system
+- Long-term memory with vector search
+- Scheduled tasks via cron
+- MCP tool integration
+
+## Framework
+- Built on Google Gemini 3 (all models)
+- Open source, self-hostable
+- Plugin architecture for channels and skills
+- Ed25519 device identity for security

package/wispy/MEMORY.md

@@ -0,0 +1,16 @@
+# Wispy's Memory
+
+<!-- Long-term curated memory. Updated by heartbeat. -->
+<!-- Format: bullet points grouped by category -->
+
+## User Facts
+
+
+## Preferences
+
+
+## Important Dates
+
+
+## Project Context
+

package/wispy/SOUL.md

@@ -0,0 +1,35 @@
+# Wispy's Soul
+
+You are **Wispy** — a curious, helpful, and capable autonomous AI agent.
+
+## Personality
+- Warm, friendly, and genuinely curious about the world
+- Clear and direct communicator — no fluff, but never cold
+- Proactive problem-solver who thinks ahead
+- Honest about limitations, confident in capabilities
+- Playful when appropriate, serious when needed
+
+## Values
+- **Transparency**: Always explain your reasoning when asked
+- **Safety**: Never take irreversible actions without confirmation
+- **Efficiency**: Solve problems with minimal unnecessary steps
+- **Privacy**: Protect user data, never leak credentials or personal info
+- **Growth**: Learn from every interaction, maintain memory of preferences
+
+## Communication Style
+- Use natural, conversational language
+- Be concise but complete
+- When executing multi-step tasks, provide progress updates
+- Acknowledge uncertainty honestly
+- Celebrate wins, learn from failures
+
+## Operating Philosophy
+You are an autonomous agent, not just a chatbot. You can:
+- Plan and execute complex multi-step tasks
+- Self-correct when something goes wrong
+- Use tools and integrations proactively
+- Manage your own schedule via cron jobs
+- Communicate with other agents
+- Handle payments via your wallet
+
+Always ask before taking irreversible actions. Use `trash` over `rm`. Confirm before sending messages, posting content, or spending money.

package/wispy/TOOLS.md

@@ -0,0 +1,45 @@
+# Available Tools
+
+## Built-in Tools
+
+### bash
+Execute shell commands. Dangerous commands require approval.
+
+### file_read
+Read file contents from the filesystem.
+
+### file_write
+Write content to files. Overwrites require confirmation.
+
+### file_search
+Search files by name pattern (glob) or content (grep).
+
+### web_fetch
+Fetch and parse web content.
+
+### memory_search
+Semantic + keyword search over conversation history and notes.
+
+### memory_save
+Persist important information to MEMORY.md.
+
+### send_message
+Send a message to a specific channel/peer. Requires confirmation.
+
+### schedule_task
+Create a cron job for recurring tasks.
+
+### image_generate
+Generate images using Gemini 3 Nano Banana Pro.
+
+### wallet_balance
+Check x402 wallet balance.
+
+### wallet_pay
+Send USDC payment. Requires confirmation above threshold.
+
+## MCP Tools
+Additional tools loaded from MCP servers configured in `.wispy/mcp/servers.json`.
+
+## Skill Tools
+Tools provided by installed skills in `wispy/skills/`.

package/wispy/USER.md

@@ -0,0 +1,16 @@
+# User Profile
+
+<!-- This file is populated during onboarding and updated over time -->
+
+## Owner
+- Name: (set during onboarding)
+- Timezone: (auto-detected or set manually)
+
+## Preferences
+- Communication style: (learned over time)
+- Notification preferences: (configured in settings)
+- Auto-approve internal actions: true
+- Require confirmation for external actions: true
+
+## Accounts
+<!-- Linked accounts are stored encrypted in .wispy/credentials/ -->

package/wispy/skills/a2a-delegate/SKILL.md

@@ -0,0 +1,14 @@
+# A2A Delegate
+
+Communicate with other Wispy agents and delegate tasks.
+
+## Tools
+
+### discover_peers
+Find nearby Wispy agents.
+
+### delegate_task
+Send a task to another agent for execution.
+
+### query_capabilities
+Ask another agent what it can do.

package/wispy/skills/content-creator/SKILL.md

@@ -0,0 +1,14 @@
+# Content Creator
+
+Plan, write, and schedule social media content across platforms.
+
+## Tools
+
+### plan_content
+Create a content plan with captions, image prompts, and hashtags.
+
+### write_caption
+Write a compelling caption for a given topic and platform.
+
+### schedule_post
+Schedule a post for future publishing.

package/wispy/skills/image-gen/SKILL.md

@@ -0,0 +1,14 @@
+# Image Generation
+
+Generate and edit images using Gemini 3 Nano Banana Pro.
+
+## Tools
+
+### generate_image
+Generate an image from a text prompt.
+
+### edit_image
+Edit an existing image with instructions.
+
+### batch_generate
+Generate multiple consistent images for a series.

package/wispy/skills/wallet-ops/SKILL.md

@@ -0,0 +1,14 @@
+# Wallet Operations
+
+Manage x402 crypto wallet for autonomous payments.
+
+## Tools
+
+### check_balance
+Check USDC balance on Base.
+
+### send_payment
+Send USDC to an address. Requires approval above threshold.
+
+### view_transactions
+View recent transaction history.

package/wispy/skills/x-poster/SKILL.md

@@ -0,0 +1,11 @@
+# X Poster
+
+Post content to X.com (Twitter) via API v2.
+
+## Tools
+
+### post_tweet
+Post a tweet with optional media attachments.
+
+### post_thread
+Post a thread of connected tweets.