@nordsym/apiclaw 1.0.0 → 1.1.1

package/STATUS.md

@@ -0,0 +1,237 @@
+# APIClaw Status — Verifierad 21 Feb 2026, 17:15 CET
+
+> **Denna fil är source of truth.** Uppdatera vid varje deploy/ändring.
+
+---
+
+## 📊 Snabbstatus
+
+| Komponent | Status | Detaljer |
+|-----------|--------|----------|
+| **npm** | ✅ Live | `@nordsym/apiclaw@1.0.0` (publicerad 16 feb) |
+| **Landing** | ✅ Live | https://apiclaw.nordsym.com |
+| **Convex** | ✅ Deployat | `brilliant-puffin-712` |
+| **API Registry** | ✅ 10,001 | Version 3.0.0, uppdaterad 21 feb |
+| **Kategorier** | ✅ 572 | Auto-extraherade |
+
+---
+
+## 📦 npm Package
+
+```
+Package:    @nordsym/apiclaw
+Published:  v1.0.0 (16 feb 2026)
+Local:      v0.3.0 (package.json)
+Registry:   https://registry.npmjs.org/@nordsym/apiclaw
+```
+
+**⚠️ Notera:** Lokal version (0.3.0) != publicerad (1.0.0). Vid nästa publish, bumpa till 1.1.0.
+
+**Installation:**
+```bash
+npx @nordsym/apiclaw          # Kör direkt
+npm install @nordsym/apiclaw  # Installera
+```
+
+---
+
+## 🌐 Landing Page
+
+| | |
+|-|-|
+| **URL** | https://apiclaw.nordsym.com |
+| **Hosting** | Vercel |
+| **Project** | `landing` (prj_PmUzn4YRoL3IIBcPai2TLuIFuScE) |
+| **Status** | ✅ HTTP 200 |
+
+**Deploy:**
+```bash
+cd ~/Projects/apiclaw/landing
+npx vercel --prod
+```
+
+---
+
+## 🗄️ Convex Backend
+
+| | |
+|-|-|
+| **Deployment** | `brilliant-puffin-712` |
+| **Dashboard** | https://dashboard.convex.dev/d/brilliant-puffin-712 |
+| **Status** | ✅ Deployat |
+
+**Tabeller:**
+- `providers` — API-providers (0 docs)
+- `providerAPIs` — Provider-listade API:er
+- `apis` — Fullt managerade API:er
+- `agentCredits` — Agent credit-balanser (0 docs)
+- `purchases` — Köphistorik
+- `apiCalls` — Användningsloggar
+- `creditTopups` — Credit-påfyllningar
+- `sessions` — Provider-sessioner
+- `magicLinks` — Email-auth tokens
+- `payouts` — Provider-utbetalningar
+
+**⚠️ Env vars:** Inga satta på prod. Behövs för server-side Instant Connect.
+
+**Deploy:**
+```bash
+cd ~/Projects/apiclaw
+npx convex deploy
+```
+
+---
+
+## 🔍 API Registry
+
+| | |
+|-|-|
+| **Fil** | `src/registry/apis.json` |
+| **Antal API:er** | 10,001 |
+| **Kategorier** | 572 |
+| **Version** | 3.0.0 |
+| **Senast uppdaterad** | 2026-02-21 |
+
+**Struktur:**
+```json
+{
+  "version": "3.0.0",
+  "source": "apis.guru + manual",
+  "lastUpdated": "2026-02-21",
+  "count": 7692,
+  "apis": [...]
+}
+```
+
+---
+
+## ⚡ Instant Connect
+
+**6 providers konfigurerade lokalt:**
+
+| Provider | Action | Credentials | Status |
+|----------|--------|-------------|--------|
+| `46elks` | `send_sms` | `~/.secrets/46elks.env` | ✅ Lokal |
+| `twilio` | `send_sms` | `~/.secrets/twilio.env` | ✅ Lokal |
+| `brave_search` | `search` | `~/.secrets/brave.env` | ✅ Lokal |
+| `resend` | `send_email` | `~/.secrets/resend.env` | ✅ Lokal |
+| `openrouter` | `chat` | `~/.secrets/openrouter.env` | ✅ Lokal |
+| `elevenlabs` | `text_to_speech` | `~/.secrets/elevenlabs.env` | ✅ Lokal |
+
+**Kod:** `src/execute.ts`
+
+**⚠️ Cloud-status:** Fungerar lokalt (läser env-filer). För cloud/hosted MCP behöver credentials lagras i Convex eller env vars.
+
+---
+
+## 🔧 MCP Tools (8 st)
+
+| Tool | Beskrivning | Status |
+|------|-------------|--------|
+| `discover_apis` | Sök API:er efter capability | ✅ |
+| `get_api_details` | Hämta full API-info | ✅ |
+| `list_categories` | Lista alla kategorier | ✅ |
+| `list_connected` | Visa Instant Connect-providers | ✅ |
+| `call_api` | Kör API via Instant Connect | ✅ |
+| `purchase_access` | Köp API-access | ✅ |
+| `check_balance` | Kolla credits | ✅ |
+| `add_credits` | Lägg till test-credits | ✅ |
+
+---
+
+## 📁 Projektstruktur
+
+```
+apiclaw/
+├── src/                    # MCP Server (TypeScript)
+│   ├── index.ts            # Huvudfil, MCP tool definitions
+│   ├── discovery.ts        # Söklogik
+│   ├── execute.ts          # Instant Connect handlers
+│   ├── credentials.ts      # Credential-hantering
+│   ├── credits.ts          # Credit-system
+│   ├── stripe.ts           # Stripe (förberett)
+│   └── registry/
+│       └── apis.json       # 7,692 API:er
+│
+├── landing/                # Next.js frontend
+│   └── src/app/
+│       ├── page.tsx        # Homepage
+│       ├── providers/      # Provider-portal
+│       └── admin/          # Admin-panel
+│
+├── convex/                 # Backend
+│   ├── schema.ts           # Databasschema
+│   ├── providers.ts        # Provider CRUD
+│   └── credits.ts          # Credits
+│
+├── dist/                   # Kompilerad JS
+├── package.json            # v0.3.0 (lokal)
+├── STATUS.md               # DENNA FIL
+└── README.md               # Dokumentation
+```
+
+---
+
+## 🚀 Deploy Checklist
+
+### Full deploy:
+```bash
+cd ~/Projects/apiclaw
+
+# 1. Bygg
+npm run build
+
+# 2. Synka registry till landing
+cp src/registry/apis.json landing/src/lib/
+cd landing && node scripts/generate-stats.js && cd ..
+
+# 3. Deploy Convex
+npx convex deploy
+
+# 4. Deploy Landing
+cd landing && npx vercel --prod && cd ..
+
+# 5. Publish npm (om ny version)
+npm publish --access public
+```
+
+### Snabb landing-deploy:
+```bash
+cd ~/Projects/apiclaw
+bash scripts/sync-and-deploy.sh
+```
+
+---
+
+## ❌ Vad som INTE är klart
+
+| Feature | Prioritet | Blocker |
+|---------|-----------|---------|
+| Stripe payments live | Medium | Behöver webhook setup |
+| Provider dashboard med live data | Medium | Ingen data i Convex |
+| Cloud Instant Connect | Medium | Credentials ej i cloud |
+| Rate limiting | Låg | — |
+| Usage metering | Låg | Schema finns |
+
+---
+
+## 📈 Nästa steg (prioriterat)
+
+1. **Öka API-antal** — Scrapa fler källor för 10k+
+2. **Testa Instant Connect E2E** — Verifiera alla 6 providers
+3. **Stripe wiring** — Koppla betalflöde
+4. **Launch prep** — PH, X thread, etc.
+
+---
+
+## 📝 Ändringslogg
+
+| Datum | Ändring |
+|-------|---------|
+| 2026-02-21 | STATUS.md skapad, verifierad mot prod |
+| 2026-02-16 | npm v1.0.0 publicerad |
+| 2026-02-21 | Registry uppdaterat till 7,692 API:er |
+
+---
+
+*Senast verifierad: 21 Feb 2026, 17:15 CET*

package/TOOLS.md

@@ -0,0 +1,36 @@
+# TOOLS.md - Local Notes
+
+Skills define *how* tools work. This file is for *your* specifics — the stuff that's unique to your setup.
+
+## What Goes Here
+
+Things like:
+- Camera names and locations
+- SSH hosts and aliases  
+- Preferred voices for TTS
+- Speaker/room names
+- Device nicknames
+- Anything environment-specific
+
+## Examples
+
+```markdown
+### Cameras
+- living-room → Main area, 180° wide angle
+- front-door → Entrance, motion-triggered
+
+### SSH
+- home-server → 192.168.1.100, user: admin
+
+### TTS
+- Preferred voice: "Nova" (warm, slightly British)
+- Default speaker: Kitchen HomePod
+```
+
+## Why Separate?
+
+Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.
+
+---
+
+Add whatever helps you do your job. This is your cheat sheet.

package/USER.md

@@ -0,0 +1,17 @@
+# USER.md - About Your Human
+
+*Learn about the person you're helping. Update this as you go.*
+
+- **Name:** 
+- **What to call them:** 
+- **Pronouns:** *(optional)*
+- **Timezone:** 
+- **Notes:** 
+
+## Context
+
+*(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)*
+
+---
+
+The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.

package/{backend/convex → convex}/_generated/api.d.ts

@@ -8,10 +8,13 @@
  * @module
  */
 
-import type * as apiKeys from "../apiKeys.js";
+import type * as analytics from "../analytics.js";
+import type * as credits from "../credits.js";
+import type * as http from "../http.js";
+import type * as providers from "../providers.js";
 import type * as purchases from "../purchases.js";
-import type * as transactions from "../transactions.js";
-import type * as users from "../users.js";
+import type * as ratelimit from "../ratelimit.js";
+import type * as telemetry from "../telemetry.js";
 
 import type {
   ApiFromModules,
@@ -20,10 +23,13 @@ import type {
 } from "convex/server";
 
 declare const fullApi: ApiFromModules<{
-  apiKeys: typeof apiKeys;
+  analytics: typeof analytics;
+  credits: typeof credits;
+  http: typeof http;
+  providers: typeof providers;
   purchases: typeof purchases;
-  transactions: typeof transactions;
-  users: typeof users;
+  ratelimit: typeof ratelimit;
+  telemetry: typeof telemetry;
 }>;
 
 /**

package/convex/analytics.ts

@@ -0,0 +1,90 @@
+import { mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+
+// Log an analytics event
+export const log = mutation({
+  args: {
+    event: v.string(),
+    provider: v.optional(v.string()),
+    query: v.optional(v.string()),
+    identifier: v.string(),
+    metadata: v.optional(v.any()),
+  },
+  handler: async (ctx, args) => {
+    return await ctx.db.insert("analytics", {
+      ...args,
+      timestamp: Date.now(),
+    });
+  },
+});
+
+// Get stats for dashboard
+export const getStats = query({
+  args: {
+    hoursBack: v.optional(v.number()),
+  },
+  handler: async (ctx, args) => {
+    const hoursBack = args.hoursBack || 24;
+    const since = Date.now() - hoursBack * 3600000;
+
+    const events = await ctx.db
+      .query("analytics")
+      .withIndex("by_timestamp")
+      .filter((q) => q.gte(q.field("timestamp"), since))
+      .collect();
+
+    // Aggregate stats
+    const stats = {
+      totalEvents: events.length,
+      discoveries: events.filter((e) => e.event === "discovery").length,
+      instantCalls: events.filter((e) => e.event === "instant").length,
+      uniqueUsers: new Set(events.map((e) => e.identifier)).size,
+      byProvider: {} as Record<string, number>,
+      topQueries: [] as { query: string; count: number }[],
+      hourly: [] as { hour: string; count: number }[],
+    };
+
+    // By provider
+    for (const event of events.filter((e) => e.provider)) {
+      stats.byProvider[event.provider!] = (stats.byProvider[event.provider!] || 0) + 1;
+    }
+
+    // Top queries
+    const queryCounts: Record<string, number> = {};
+    for (const event of events.filter((e) => e.query)) {
+      queryCounts[event.query!] = (queryCounts[event.query!] || 0) + 1;
+    }
+    stats.topQueries = Object.entries(queryCounts)
+      .sort(([, a], [, b]) => b - a)
+      .slice(0, 10)
+      .map(([query, count]) => ({ query, count }));
+
+    // Hourly breakdown
+    const hourlyCounts: Record<string, number> = {};
+    for (const event of events) {
+      const hour = new Date(event.timestamp).toISOString().slice(0, 13);
+      hourlyCounts[hour] = (hourlyCounts[hour] || 0) + 1;
+    }
+    stats.hourly = Object.entries(hourlyCounts)
+      .sort(([a], [b]) => a.localeCompare(b))
+      .map(([hour, count]) => ({ hour, count }));
+
+    return stats;
+  },
+});
+
+// Get recent events for live feed
+export const getRecent = query({
+  args: {
+    limit: v.optional(v.number()),
+  },
+  handler: async (ctx, args) => {
+    const limit = args.limit || 50;
+    
+    return await ctx.db
+      .query("analytics")
+      .withIndex("by_timestamp")
+      .order("desc")
+      .take(limit);
+  },
+});

package/convex/credits.ts

@@ -0,0 +1,211 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+
+// Credit packages
+export const CREDIT_PACKAGES = {
+  starter: { amountUsd: 10, credits: 100, bonus: 0 },
+  growth: { amountUsd: 50, credits: 550, bonus: 50 }, // 10% bonus
+  scale: { amountUsd: 100, credits: 1200, bonus: 200 }, // 20% bonus
+} as const;
+
+// Get or create agent credits account
+export const getOrCreateAgent = mutation({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    const existing = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    if (existing) return existing;
+
+    const now = Date.now();
+    const id = await ctx.db.insert("agentCredits", {
+      agentId: args.agentId,
+      balanceUsd: 0,
+      currency: "USD",
+      createdAt: now,
+      updatedAt: now,
+    });
+
+    return await ctx.db.get(id);
+  },
+});
+
+// Get agent credits
+export const getAgentCredits = query({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+  },
+});
+
+// Add credits to agent account (called by webhook or admin)
+export const addCredits = mutation({
+  args: {
+    agentId: v.string(),
+    amountUsd: v.number(),
+    source: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    const now = Date.now();
+
+    if (credits) {
+      await ctx.db.patch(credits._id, {
+        balanceUsd: credits.balanceUsd + args.amountUsd,
+        updatedAt: now,
+      });
+      return await ctx.db.get(credits._id);
+    } else {
+      const id = await ctx.db.insert("agentCredits", {
+        agentId: args.agentId,
+        balanceUsd: args.amountUsd,
+        currency: "USD",
+        createdAt: now,
+        updatedAt: now,
+      });
+      return await ctx.db.get(id);
+    }
+  },
+});
+
+// Deduct credits (internal use)
+export const deductCredits = mutation({
+  args: {
+    agentId: v.string(),
+    amountUsd: v.number(),
+  },
+  handler: async (ctx, args) => {
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    if (!credits) {
+      throw new Error(`No credits account for agent: ${args.agentId}`);
+    }
+
+    if (credits.balanceUsd < args.amountUsd) {
+      throw new Error(
+        `Insufficient balance: have $${credits.balanceUsd.toFixed(2)}, need $${args.amountUsd.toFixed(2)}`
+      );
+    }
+
+    await ctx.db.patch(credits._id, {
+      balanceUsd: credits.balanceUsd - args.amountUsd,
+      updatedAt: Date.now(),
+    });
+
+    return await ctx.db.get(credits._id);
+  },
+});
+
+// Record credit top-up from Stripe
+export const recordTopup = mutation({
+  args: {
+    agentId: v.string(),
+    stripeSessionId: v.optional(v.string()),
+    stripePaymentIntentId: v.optional(v.string()),
+    amountUsd: v.number(),
+    creditsGranted: v.number(),
+    packageType: v.string(),
+    status: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const now = Date.now();
+    return await ctx.db.insert("creditTopups", {
+      agentId: args.agentId,
+      stripeSessionId: args.stripeSessionId,
+      stripePaymentIntentId: args.stripePaymentIntentId,
+      amountUsd: args.amountUsd,
+      creditsGranted: args.creditsGranted,
+      packageType: args.packageType,
+      status: args.status,
+      createdAt: now,
+      completedAt: args.status === "completed" ? now : undefined,
+    });
+  },
+});
+
+// Complete a pending top-up
+export const completeTopup = mutation({
+  args: {
+    stripeSessionId: v.optional(v.string()),
+    stripePaymentIntentId: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    let topup;
+
+    if (args.stripeSessionId) {
+      topup = await ctx.db
+        .query("creditTopups")
+        .withIndex("by_stripeSessionId", (q) =>
+          q.eq("stripeSessionId", args.stripeSessionId)
+        )
+        .first();
+    } else if (args.stripePaymentIntentId) {
+      topup = await ctx.db
+        .query("creditTopups")
+        .withIndex("by_stripePaymentIntentId", (q) =>
+          q.eq("stripePaymentIntentId", args.stripePaymentIntentId)
+        )
+        .first();
+    }
+
+    if (!topup) {
+      throw new Error("Top-up not found");
+    }
+
+    if (topup.status === "completed") {
+      return topup; // Already completed, idempotent
+    }
+
+    // Update top-up status
+    await ctx.db.patch(topup._id, {
+      status: "completed",
+      completedAt: Date.now(),
+    });
+
+    // Add credits to agent
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", topup.agentId))
+      .first();
+
+    if (credits) {
+      await ctx.db.patch(credits._id, {
+        balanceUsd: credits.balanceUsd + topup.creditsGranted,
+        updatedAt: Date.now(),
+      });
+    } else {
+      await ctx.db.insert("agentCredits", {
+        agentId: topup.agentId,
+        balanceUsd: topup.creditsGranted,
+        currency: "USD",
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+      });
+    }
+
+    return topup;
+  },
+});
+
+// Get all top-ups for an agent
+export const getTopups = query({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("creditTopups")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .collect();
+  },
+});