@nordsym/apiclaw 1.3.6 → 1.3.8

package/docs/PRD-final-polish.md

@@ -0,0 +1,117 @@
+# PRD: APIClaw Final Polish
+
+Samlar alla återstående issues för en sista polish-runda.
+
+---
+
+## Issues
+
+### 1. 🔴 "Available APIs: 10" Kort Förvirrar
+
+**Problem:**
+- Kortet visar "Available APIs: 10"
+- User tror det är en personlig begränsning
+- User tänker "kan jag köpa fler?"
+- Verkligheten: 10 Direct Call + 22k+ via MCP
+
+**Lösning:**
+- Ta bort "Available APIs" kortet helt
+- Behåll: API Calls, My Agents, My APIs
+- Direct Call-sektionen visar redan de 10 APIs
+
+**Scope:** Ändra OverviewTab, ta bort första stat-kortet
+
+---
+
+### 2. 🔴 Stripe Environment Variables
+
+**Problem:**
+- Stripe-koden finns men env vars saknas
+- Betalning fungerar inte förrän keys är satta
+
+**Variabler som behövs:**
+```
+STRIPE_SECRET_KEY=sk_live_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+STRIPE_PRICE_ID_USAGE=price_...
+```
+
+**Lösning:**
+- Gustav hämtar keys från Stripe dashboard
+- Lägg in i Convex environment variables
+- Testa checkout flow
+
+**Scope:** Config only (ingen kod)
+
+---
+
+### 3. 🟡 Logging Hook → Execute.ts
+
+**Problem:**
+- Logs UI finns och visar data
+- Men logs kopplas inte automatiskt till faktiska API-anrop
+- `logs:createLog` mutation finns men anropas inte från execute
+
+**Lösning:**
+- Hitta execute-funktionen i MCP-servern
+- Efter varje Direct Call, anropa createLog
+- Logga: provider, action, status, latency, workspaceId
+
+**Filer:**
+- `src/execute.ts` (eller liknande i MCP-servern)
+- Anropa Convex mutation efter varje call
+
+**Scope:** 1 agent
+
+---
+
+### 4. 🟢 Auto-Configure Feature
+
+**Problem:**
+- Användare måste manuellt konfigurera MCP config
+- Friktion i onboarding
+
+**Vision:**
+- Klicka "Auto-Configure" i workspace
+- Permission dialog (File System Access API)
+- AI lokaliserar och modifierar MCP config
+- Visuell bekräftelse
+
+**Tekniska alternativ:**
+1. File System Access API (Chrome/Edge)
+2. Browser extension
+3. Local daemon
+4. CLI command + copy-paste
+
+**Scope:** Egen mini-PRD, 2-3 agenter
+
+---
+
+## Agenter
+
+| # | Agent | Scope | Prio |
+|---|-------|-------|------|
+| 1 | `overview-cleanup` | Ta bort "Available APIs" kort | 🔴 |
+| 2 | `stripe-config` | Dokumentera env var setup | 🔴 |
+| 3 | `logging-hook` | Koppla execute → logs | 🟡 |
+| 4 | `auto-configure-prd` | Skriv detaljerad PRD | 🟢 |
+
+**Total: 4 agenter**
+
+---
+
+## Acceptanskriterier
+
+- [ ] Overview visar 3 kort (inte 4)
+- [ ] Stripe checkout fungerar live
+- [ ] API-anrop loggas automatiskt
+- [ ] Auto-Configure PRD dokumenterad
+
+---
+
+## Prioritetsordning
+
+1. **Overview cleanup** — Snabb fix, tar bort förvirring
+2. **Stripe config** — Gustav gör manuellt med guide
+3. **Logging hook** — Kräver research i MCP-servern
+4. **Auto-Configure** — Future feature, PRD först

package/docs/PRD-mobile-responsive.md

@@ -0,0 +1,56 @@
+# PRD: APIClaw Mobile Responsiveness
+
+## Scope
+Göra workspace och landing page mobile-friendly.
+
+## Arbete (1 agent, ingen spawn)
+
+Jag gör allt själv — inga subagenter. Estimat: ~20 min.
+
+---
+
+## Del 1: Workspace Mobile (workspace/page.tsx)
+
+### Ändringar:
+1. **Sidebar** → Dold på mobil, visa via hamburger-meny
+2. **Tabs** → Horisontell scroll eller dropdown på mobil
+3. **Cards/Tables** → Stack vertically på små skärmar
+4. **Agent-kort** → Responsiv layout, knappar under content
+5. **Input-fält** → Full width på mobil
+
+### Tekniskt:
+- Tailwind breakpoints: `sm:`, `md:`, `lg:`
+- Befintlig `Menu`/`X` icons redan importerade
+- Mobil sidebar state: `sidebarOpen` finns redan
+
+---
+
+## Del 2: Landing Page Header (page.tsx)
+
+### Ändringar:
+1. **Desktop nav** → Dölj på mobil (`hidden lg:flex`)
+2. **Hamburger** → Visa på mobil (`lg:hidden`)
+3. **Mobile menu** → Slide-in eller dropdown
+4. **CTA-knappar** → Stack på mobil
+
+### Tekniskt:
+- Lägg till mobile menu state
+- Animera med Tailwind transitions
+
+---
+
+## Filer som ändras:
+1. `landing/src/app/workspace/page.tsx`
+2. `landing/src/app/page.tsx`
+
+## Inga nya dependencies
+
+## Teststrategi:
+- Chrome DevTools mobile view
+- Breakpoints: 375px (iPhone), 768px (tablet)
+
+---
+
+## Attestera?
+
+Svara **"kör"** för att starta.

package/docs/PRD-navigation-expansion.md

@@ -0,0 +1,295 @@
+# PRD: APIClaw Navigation & Feature Expansion
+
+## Vision
+
+APIClaw är **räls för AI-agenter**. Workspace-dashboarden ska kännas som n8n/Vercel/GitHub — professionell, komplett, skalbar.
+
+---
+
+## Ny Sidebar-struktur
+
+```
+┌─────────────────────┐
+│ APIClaw             │
+│ user@email.com      │
+│ Free · 50/50 calls  │
+├─────────────────────┤
+│ Overview            │
+│ APIs                │
+│ Agents              │
+│ Logs                │  ← NY
+│ Analytics      ▼    │
+│ Usage               │
+│ Webhooks            │  ← NY
+├─────────────────────┤
+│ API Keys            │  ← NY (BYOK)
+│ Earn Credits        │
+│ Docs                │
+│ Feedback            │  ← NY
+├─────────────────────┤
+│ ⚙ Settings          │  ← NY
+│ ☀ Theme             │
+│ → Sign Out          │
+└─────────────────────┘
+```
+
+Ikoner: Lucide React (redan installerat)
+
+---
+
+## NYA TABS
+
+### 1. Logs
+**Syfte:** Visa alla API-anrop, fel, debug-info.
+
+**Innehåll:**
+- Tabell: timestamp, provider, action, status, latency
+- Filter: provider, status (success/error), datum
+- Expandera rad → visa request/response
+- Export som JSON/CSV
+
+**Data:** Ny `apiLogs` tabell i Convex
+
+---
+
+### 2. Webhooks
+**Syfte:** Reagera på events (usage alerts, errors, etc.)
+
+**Innehåll:**
+- Lista webhooks: URL, events, status
+- Skapa ny: URL + välj events
+- Test-knapp
+- Logs per webhook
+
+**Events:**
+- `usage.threshold` (80%, 100%)
+- `api.error`
+- `agent.connected`
+- `agent.revoked`
+
+---
+
+### 3. Feedback
+**Syfte:** Samla feedback från användare.
+
+**Innehåll:**
+- Fritext-formulär
+- Quick reactions: 👍/👎 på specifika features
+- Feature requests lista (up/downvote)
+- Status: "Under review" / "Planned" / "Shipped"
+
+**Data:** Ny `feedback` tabell
+
+---
+
+### 4. Settings
+**Syfte:** Konto- och workspace-inställningar.
+
+**Sektioner:**
+- **Profile:** Namn, email
+- **Security:** Lösenord, sessions, 2FA (future)
+- **Notifications:** Email-preferenser
+- **Workspace:** Namn, delete workspace
+- **API Tokens:** Generera tokens för extern access
+
+---
+
+## BYOK (Bring Your Own Key)
+
+### Positionering — KRITISKT
+
+**APIClaw's kärnvärde:** "Direct Call — ingen API-nyckel behövs"
+
+**BYOK är INTE huvudfeature.** Det är en power-user-option.
+
+### Varför BYOK?
+
+| Usecase | Förklaring |
+|---------|------------|
+| **Obegränsade anrop** | Dina nycklar = räknas inte mot free tier |
+| **Privacy** | Requests går direkt till provider, ej via NordSym |
+| **Egna modeller** | Fine-tuned models, custom endpoints |
+| **Enterprise compliance** | Vissa företag MÅSTE äga sina credentials |
+| **Providers vi ej stödjer** | Lägg till vilken REST API som helst |
+
+### UX-princip
+
+```
+┌─────────────────────────────────────────────────────┐
+│  Brave Search                                       │
+│  ────────────────────────────────────────────────── │
+│  ✓ Direct Call (NordSym)     ○ Use your own key    │
+│                                                     │
+│  Using Direct Call: No setup needed.                │
+│  50 free calls/month included.                      │
+│                                                     │
+│  [Switch to your own key →]                         │
+└─────────────────────────────────────────────────────┘
+```
+
+**Default = Direct Call.** BYOK är opt-in, aldrig påtvingat.
+
+### API Keys Tab
+
+**Struktur:**
+
+```
+┌─────────────────────────────────────────────────────┐
+│  API Keys                                           │
+│  ─────────────────────────────────────────────────  │
+│                                                     │
+│  Your keys are encrypted and stored securely.       │
+│  Using your own keys = unlimited calls, no proxy.   │
+│                                                     │
+│  ┌───────────────────────────────────────────────┐  │
+│  │ Provider      │ Status        │ Actions       │  │
+│  ├───────────────────────────────────────────────┤  │
+│  │ Brave Search  │ Direct Call   │ [Add Key]     │  │
+│  │ OpenRouter    │ Direct Call   │ [Add Key]     │  │
+│  │ ElevenLabs    │ Your Key ✓    │ [Edit][Remove]│  │
+│  │ + Add Custom  │               │ [Configure]   │  │
+│  └───────────────────────────────────────────────┘  │
+│                                                     │
+└─────────────────────────────────────────────────────┘
+```
+
+### Custom Provider (Add Any API)
+
+**Flow:**
+1. Klicka "+ Add Custom"
+2. Ange: Namn, Base URL, Auth type, Headers
+3. Definiera actions (endpoints)
+4. Test connection
+5. Spara
+
+**Detta gör APIClaw till en universal API gateway** — inte bara våra providers.
+
+---
+
+## Datamodell (Convex)
+
+### Nya tabeller:
+
+```typescript
+// apiLogs
+{
+  workspaceId: Id<"workspaces">,
+  provider: string,
+  action: string,
+  status: "success" | "error",
+  latencyMs: number,
+  requestSize: number,
+  responseSize: number,
+  error?: string,
+  createdAt: number,
+}
+
+// webhooks
+{
+  workspaceId: Id<"workspaces">,
+  url: string,
+  events: string[],
+  secret: string,
+  enabled: boolean,
+  lastTriggeredAt?: number,
+  createdAt: number,
+}
+
+// feedback
+{
+  workspaceId: Id<"workspaces">,
+  type: "bug" | "feature" | "general",
+  content: string,
+  votes: number,
+  status: "new" | "reviewing" | "planned" | "shipped",
+  createdAt: number,
+}
+
+// providerKeys (BYOK)
+{
+  workspaceId: Id<"workspaces">,
+  provider: string,
+  encryptedKey: string,
+  isCustom: boolean,
+  customConfig?: {
+    baseUrl: string,
+    authType: string,
+    headers: Record<string, string>,
+  },
+  createdAt: number,
+}
+```
+
+---
+
+## Implementation Plan
+
+### Fas 1: Core Navigation
+**Agent:** 1 (frontend)
+- Lägg till nya tabs i sidebar
+- Settings-sida med sektioner
+- Feedback-formulär (basic)
+- Placeholder för Logs, Webhooks, API Keys
+
+### Fas 2: Logs
+**Agent:** 1 (backend + frontend)
+- Convex schema för apiLogs
+- Logga alla Direct Call requests
+- Frontend: tabell med filter
+
+### Fas 3: BYOK
+**Agent:** 1 (backend + frontend + crypto)
+- Convex schema för providerKeys
+- Encrypt/decrypt keys
+- UI för add/edit/remove keys
+- Modify executeAPICall to use user keys
+
+### Fas 4: Webhooks
+**Agent:** 1 (backend)
+- Convex schema
+- Webhook delivery system
+- UI för manage webhooks
+
+### Fas 5: Feedback System
+**Agent:** 1 (full-stack)
+- Voting system
+- Admin view för triage
+
+---
+
+## Agenter
+
+| Fas | Agent | Scope |
+|-----|-------|-------|
+| 1 | `nav-expansion` | Sidebar, Settings, Feedback placeholder |
+| 2 | `logs-system` | apiLogs backend + frontend |
+| 3 | `byok-system` | providerKeys + UI + execution |
+| 4 | `webhooks` | Webhook delivery |
+| 5 | `feedback-full` | Voting + admin |
+
+**Total: 5 agenter, sekventiellt**
+
+---
+
+## Framtidssäkring
+
+### BYOK som competitive moat:
+
+1. **Lock-in prevention:** Användare kan alltid ta med sina nycklar
+2. **Enterprise-ready:** Compliance teams älskar BYOK
+3. **Extensibility:** Custom providers = infinite APIs
+4. **Hybrid model:** Börja med Direct Call, migrera till BYOK när de växer
+
+### Monetization alignment:
+
+- **Free:** Direct Call (50 calls)
+- **Pro:** Direct Call (10k calls) + BYOK
+- **Enterprise:** BYOK only, self-hosted option
+
+---
+
+## Attestering
+
+Svara **"kör fas 1"** för att starta med navigation expansion.
+
+Eller **"kör alla"** för att köra fas 1-5 sekventiellt.