@nordsym/apiclaw 2.1.0 → 2.2.1

package/apiclaw-README.md

@@ -1,494 +0,0 @@
----
-nord_type: NOTE
-nord_owner: APIClaw
-nord_status: LIVE
----
-
-# 🦞 APIClaw
-
-The API layer for AI agents. 18 providers → 1000s of capabilities. Workspace → Dashboard → Ship.
-
-[![npm version](https://img.shields.io/npm/v/@nordsym/apiclaw.svg)](https://www.npmjs.com/package/@nordsym/apiclaw)
-[![npm downloads](https://img.shields.io/npm/dw/@nordsym/apiclaw.svg)](https://www.npmjs.com/package/@nordsym/apiclaw)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
-[![GitHub Stars](https://img.shields.io/github/stars/nordsym/apiclaw?style=social)](https://github.com/nordsym/apiclaw)
-[![Built with MCP](https://img.shields.io/badge/Built%20with-MCP-purple)](https://modelcontextprotocol.io)
-
-> **If APIClaw saves you time, [⭐ star the repo](https://github.com/nordsym/apiclaw) — it helps more developers find us.**
-
-![APIClaw Demo](landing/public/demo.gif)
-
----
-
-## The Platform
-
-**[apiclaw.cloud](https://apiclaw.cloud)** — Your workspace for API-powered agents.
-
-| Layer | What You Get |
-|-------|--------------|
-| **Workspace** | Manage API keys, team access, usage analytics |
-| **Dashboard** | Real-time logs, cost tracking, rate limit monitoring |
-| **18 Direct Call Providers** | 1000+ ML models, 100+ LLMs, voice, SMS, email — zero config |
-| **1,636 Open APIs** | Curated public APIs, instant access |
-| **22,392 Discovery** | Full API index for exploration |
-
-One `mcp-install` connects your agent to all of it.
-
----
-
-## Quick Start
-
-**No signup required — just install and use.**
-
-```bash
-# Install
-curl -fsSL https://apiclaw.cloud/install.sh | bash
-
-# Restart your AI assistant
-# Immediately use any API (10 calls/week)
-
-# Optional: Register for 50 calls/week
-register_owner({ email: "you@example.com" })
-```
-
-That's it. All 18 Direct Call providers work instantly through NordSym's infrastructure. Your API calls are proxied, authenticated, and rate-limited automatically.
-
-**Usage Limits:**
-- **Anonymous:** 10 calls/week (no registration)
-- **Registered:** 50 calls/week (5x more)
-- **Upgrade:** See [Pricing](#pricing) below
-
-Start calling APIs immediately. No setup, no API keys, no configuration.
-
----
-
-## End-to-End Example
-
-Here's a complete agent workflow — send an SMS, generate an image, and search the web in one session:
-
-```javascript
-// 1. Register for 50 calls/week
-register_owner({ email: "you@example.com" })
-
-// 2. Send an SMS via 46elks
-call_api({
-  provider: "46elks",
-  action: "send_sms",
-  params: {
-    to: "+46701234567",
-    message: "APIClaw is live! 🦞"
-  }
-})
-
-// 3. Generate an image via Replicate
-call_api({
-  provider: "replicate",
-  action: "run",
-  params: {
-    model: "stability-ai/sdxl",
-    input: { prompt: "a lobster wearing a top hat, digital art" }
-  }
-})
-
-// 4. Search the web via Brave
-call_api({
-  provider: "brave",
-  action: "search",
-  params: { q: "MCP protocol AI agents 2025", count: 5 }
-})
-```
-
-All three calls go through APIClaw's proxy — zero API keys, zero configuration.
-
----
-
-## What You Get
-
-### Instant API Access
-Tell your agent what to do. APIClaw handles auth, rate limits, and execution.
-
-### 18 Direct Call Providers
-Premium APIs ready for production. Voice, AI, SMS, Email, Search — all pre-configured.
-
-### 1,636 Open APIs
-Public APIs indexed and callable. Weather, crypto, sports, government data.
-
-### 22,392 Discovery APIs
-The full catalog. Search, explore, find the right API for any task.
-
-### Workspace Dashboard
-See every call, track costs, monitor usage. One place for your entire team.
-
----
-
-## 18 Direct Call Providers
-
-Pre-configured, production-ready APIs. Just call them.
-
-### 🤖 AI & LLM
-
-| Provider | Capability |
-|----------|------------|
-| **Replicate** | 1,000+ ML models — image gen, video, audio, any model |
-| **OpenRouter** | 100+ LLMs — GPT-4, Claude, Llama, Mistral, unified API |
-| **Groq** | Ultra-fast inference — Llama, Mixtral at 500+ tokens/sec |
-| **Mistral** | Mistral models — Mistral Large, Medium, Small |
-| **Cohere** | Enterprise NLP — embeddings, rerank, generate |
-| **Together AI** | Open models — fine-tuning, fast inference |
-| **Stability AI** | Image generation — Stable Diffusion, SDXL, SD3 |
-
-### 🎤 Voice
-
-| Provider | Capability |
-|----------|------------|
-| **ElevenLabs** | Text-to-speech — 29 languages, voice cloning, realistic voices |
-| **Deepgram** | Speech-to-text — real-time transcription, 36 languages |
-| **AssemblyAI** | Audio intelligence — transcription, summarization, sentiment |
-
-### 📱 SMS
-
-| Provider | Capability |
-|----------|------------|
-| **46elks** | Swedish SMS API — simple, reliable, great pricing |
-| **Twilio** | Global SMS — 180+ countries, programmable messaging |
-
-### 📧 Email
-
-| Provider | Capability |
-|----------|------------|
-| **Resend** | Developer email — simple API, great deliverability |
-
-### 🔍 Search
-
-| Provider | Capability |
-|----------|------------|
-| **Brave Search** | Web search — privacy-focused, no tracking |
-| **Firecrawl** | Web scraping — extract content, convert to markdown |
-| **Serper** | Google Search API — SERP data, real-time results |
-
-### 💻 Code
-
-| Provider | Capability |
-|----------|------------|
-| **E2B** | Code sandbox — run any code safely, isolated environments |
-
-### 🛠️ Dev
-
-| Provider | Capability |
-|----------|------------|
-| **GitHub** | GitHub API — repos, issues, PRs, actions |
-
----
-
-## 1,636 Open APIs
-
-Public APIs, instantly callable. No API keys needed.
-
-**Categories:**
-- Weather & Environment
-- Finance & Crypto
-- Sports & Entertainment
-- Government & Public Data
-- Transportation
-- Food & Recipes
-- Science & Education
-
-Browse at [apiclaw.cloud/open-apis](https://apiclaw.cloud/open-apis)
-
----
-
-## 22,392 Discovery APIs
-
-The full index. Every API we've cataloged.
-
-Use `discover_apis` to search:
-```
-"Find APIs for flight tracking"
-"Show me cryptocurrency price APIs"
-"What APIs exist for recipe data?"
-```
-
-Browse at [apiclaw.cloud/discover](https://apiclaw.cloud/discover)
-
----
-
-## Installation
-
-### One-Line Install (Recommended)
-
-```bash
-curl -fsSL https://apiclaw.cloud/install.sh | bash
-```
-
-Auto-detects Claude Desktop or Claude Code. Configures MCP. Done.
-
-### Options
-
-```bash
-# Target specific client
-npx @nordsym/apiclaw mcp-install --client claude-desktop
-npx @nordsym/apiclaw mcp-install --client claude-code
-
-# Preview without applying
-npx @nordsym/apiclaw mcp-install --dry-run
-```
-
-### Codex (OpenAI) Setup
-
-Use Codex's native MCP manager:
-
-```bash
-# Recommended for local APIClaw development (strict stdio-safe)
-codex mcp add apiclaw -- node /absolute/path/to/apiclaw/dist/index.js
-
-# Example
-codex mcp add apiclaw -- node /Users/gustavhemmingsson/Projects/apiclaw/dist/index.js
-
-# Verify
-codex mcp get apiclaw
-codex mcp list
-```
-
-### Global Install
-
-```bash
-npm install -g @nordsym/apiclaw
-apiclaw setup
-```
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `mcp-install` | Quick setup for Claude Desktop/Code |
-| `setup` | Full setup with all MCP client options |
-| `doctor` | Diagnose your APIClaw installation |
-| `restore` | Restore config from backup |
-| `uninstall` | Remove APIClaw from clients |
-
-### setup
-
-Full-featured setup for any MCP client.
-
-```bash
-npx @nordsym/apiclaw setup --client cursor
-npx @nordsym/apiclaw setup --client windsurf
-npx @nordsym/apiclaw setup --client cline
-npx @nordsym/apiclaw setup --workspace ws_abc123
-npx @nordsym/apiclaw setup --wizard
-```
-
-### doctor
-
-Check your setup.
-
-```bash
-npx @nordsym/apiclaw doctor
-```
-
-```
-🔍 APIClaw Health Check
-========================
-System:
-  ✓ Node.js v20.11.0
-  ✓ npm 10.2.4
-
-MCP Clients:
-  ✓ Claude Desktop - Configured ✓
-  ✓ Cursor - Configured ✓
-
-Status: All systems operational ✓
-```
-
-### restore
-
-Restore from backup.
-
-```bash
-npx @nordsym/apiclaw restore --list
-npx @nordsym/apiclaw restore
-```
-
-### uninstall
-
-Remove APIClaw.
-
-```bash
-npx @nordsym/apiclaw uninstall
-npx @nordsym/apiclaw uninstall --client cursor
-```
-
----
-
-## MCP Clients
-
-| Client | macOS | Windows | Linux |
-|--------|:-----:|:-------:|:-----:|
-| **Claude Desktop** | ✅ | ✅ | ✅ |
-| **Claude Code** | ✅ | ✅ | ✅ |
-| **Cursor** | ✅ | ✅ | ✅ |
-| **Windsurf** | ✅ | ✅ | ✅ |
-| **Cline** | ✅ | ✅ | ✅ |
-| **Continue** | ✅ | ✅ | ✅ |
-| **Codex (OpenAI)** | ✅ | ✅ | ✅ |
-
-<details>
-<summary>Config Locations</summary>
-
-**Claude Desktop**
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-- Linux: `~/.config/Claude/claude_desktop_config.json`
-
-**Cursor**
-- macOS: `~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/config.json`
-- Windows: `%APPDATA%\Cursor\User\globalStorage\cursor.mcp\config.json`
-
-**Windsurf**
-- All: `~/.codeium/windsurf/mcp_config.json`
-
-**Cline**
-- macOS: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
-
-**Continue**
-- All: `~/.continue/config.json`
-
-**Codex (OpenAI)**
-- All: `~/.codex/config.toml` (managed via `codex mcp add/get/list/remove`)
-
-</details>
-
----
-
-## How It Works
-
-```json
-{
-  "mcpServers": {
-    "apiclaw": {
-      "command": "npx",
-      "args": ["-y", "@nordsym/apiclaw"]
-    }
-  }
-}
-```
-
-1. Your agent launches APIClaw as an MCP server
-2. APIClaw exposes APIs as callable tools
-3. Agent calls `send_sms`, `generate_image`, `search_web`
-4. APIClaw handles auth, rate limits, execution
-5. Results flow back to the agent
-
----
-
-## Proxy Architecture
-
-**All 18 Direct Call providers work through NordSym's infrastructure.**
-
-You don't manage API keys. You don't configure auth. You don't worry about rate limits.
-
-**How it works:**
-- Your API calls go through NordSym's proxy
-- We handle authentication with each provider
-- Usage is tracked and limited (fair use)
-- 10 calls/week anonymous, 50 with registration
-- No setup required — just install and use
-
-**What you get:**
-- Instant access to 18 premium APIs
-- No API key management
-- Automatic rate limiting
-- Usage analytics in your workspace
-- Production-ready from day one
-
-**Want higher limits?** See [Pricing](#pricing) below or upgrade at [apiclaw.cloud](https://apiclaw.cloud).
-
----
-
-## Dry-Run Mode
-
-Test without making real API calls.
-
-```javascript
-call_api({
-  provider: "46elks",
-  action: "send_sms",
-  params: { to: "+46701234567", message: "Test" },
-  dry_run: true
-})
-```
-
-Returns the exact request that *would* be sent, with mock response data.
-
----
-
-## Why APIClaw?
-
-| | **APIClaw** | **RapidAPI** | **Direct API Keys** | **Kong / custom gateway** |
-|---|---|---|---|---|
-| **Setup time** | `curl \| bash` (30 sec) | Account + per-API signup | Per-provider signup | Hours of config |
-| **API keys to manage** | 0 | Per API | 1 per provider | 1 per provider |
-| **Providers covered** | 18 premium + 1,636 open | 40,000+ (DIY) | 1 at a time | Any (DIY) |
-| **MCP-native** | ✅ First-class | ❌ | ❌ | ❌ |
-| **Works in AI agents** | ✅ Out of the box | ⚠️ Manual wiring | ⚠️ Manual wiring | ⚠️ Manual wiring |
-| **Free tier** | ✅ 50 calls/week | ✅ Limited | Varies | ❌ |
-| **Self-hosted option** | ✅ | ❌ | — | ✅ |
-
-APIClaw is purpose-built for AI agents and MCP clients. No glue code, no key juggling — just call the API.
-
----
-
-## Social Proof
-
-**9,000+ npm installs** · 88 versions shipped · Used in Claude Agents, GPT Builders, and Codex workflows worldwide.
-
----
-
-## Pricing
-
-| Plan | Price | Calls/month | Best for |
-|------|-------|-------------|----------|
-| **Free** | $0 | 50 | Exploring, prototyping |
-| **Pro** | $79/mo | 5,000 | Solo builders & small teams |
-| **Scale** | $249/mo | 25,000 | Production agents |
-| **Enterprise** | Custom | Unlimited | Large teams & custom SLAs |
-
-→ [Upgrade at apiclaw.cloud](https://apiclaw.cloud) · Enterprise: [book a call](https://apiclaw.cloud/contact)
-
----
-
-## AI Discoverability
-
-APIClaw is optimized for discovery by AI agents and LLM tooling:
-
-- **llms.txt:** [apiclaw.cloud/llms.txt](https://apiclaw.cloud/llms.txt) — Machine-readable API index
-- **llms-full.txt:** [apiclaw.cloud/llms-full.txt](https://apiclaw.cloud/llms-full.txt) — Full capability descriptions
-- **ai-plugin.json:** [apiclaw.cloud/.well-known/ai-plugin.json](https://apiclaw.cloud/.well-known/ai-plugin.json) — OpenAI plugin manifest
-- **MCP:** Install with one command and any MCP-compatible agent can use APIClaw immediately
-
----
-
-## Contributing & Changelog
-
-- [CONTRIBUTING.md](apiclaw-CONTRIBUTING.md) — How to contribute
-- [CHANGELOG.md](apiclaw-CHANGELOG.md) — Release history
-
----
-
-## Links
-
-- **Platform:** [apiclaw.cloud](https://apiclaw.cloud)
-- **Docs:** [apiclaw.cloud/docs](https://apiclaw.cloud/docs)
-- **GitHub:** [github.com/nordsym/apiclaw](https://github.com/nordsym/apiclaw)
-- **npm:** [@nordsym/apiclaw](https://www.npmjs.com/package/@nordsym/apiclaw)
-- **Security:** [SECURITY.md](SECURITY.md)
-
----
-
-MIT © [NordSym](https://nordsym.com)
-
----
-*[[03 - Products/Apiclaw/Apiclaw|APIClaw]] · [[MOC|Production Line]]*

package/convex/_generated/api.d.ts

@@ -1,137 +0,0 @@
-/* eslint-disable */
-/**
- * Generated `api` utility.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import type * as adminActivate from "../adminActivate.js";
-import type * as adminStats from "../adminStats.js";
-import type * as agents from "../agents.js";
-import type * as analytics from "../analytics.js";
-import type * as apiKeys from "../apiKeys.js";
-import type * as backfillAnalytics from "../backfillAnalytics.js";
-import type * as backfillSearchLogs from "../backfillSearchLogs.js";
-import type * as billing from "../billing.js";
-import type * as capabilities from "../capabilities.js";
-import type * as chains from "../chains.js";
-import type * as credits from "../credits.js";
-import type * as crons from "../crons.js";
-import type * as debugFilestackLogs from "../debugFilestackLogs.js";
-import type * as debugGetToken from "../debugGetToken.js";
-import type * as directCall from "../directCall.js";
-import type * as earnProgress from "../earnProgress.js";
-import type * as email from "../email.js";
-import type * as feedback from "../feedback.js";
-import type * as http from "../http.js";
-import type * as inbound from "../inbound.js";
-import type * as logs from "../logs.js";
-import type * as migrateFilestack from "../migrateFilestack.js";
-import type * as migratePartnersProd from "../migratePartnersProd.js";
-import type * as migratePratham from "../migratePratham.js";
-import type * as migrateProviderWorkspaces from "../migrateProviderWorkspaces.js";
-import type * as mou from "../mou.js";
-import type * as providerKeys from "../providerKeys.js";
-import type * as providers from "../providers.js";
-import type * as purchases from "../purchases.js";
-import type * as ratelimit from "../ratelimit.js";
-import type * as searchLogs from "../searchLogs.js";
-import type * as seedAPILayerAPIs from "../seedAPILayerAPIs.js";
-import type * as seedDirectCallConfigs from "../seedDirectCallConfigs.js";
-import type * as seedPratham from "../seedPratham.js";
-import type * as spendAlerts from "../spendAlerts.js";
-import type * as stripeActions from "../stripeActions.js";
-import type * as teams from "../teams.js";
-import type * as telemetry from "../telemetry.js";
-import type * as updateAPIStatus from "../updateAPIStatus.js";
-import type * as usage from "../usage.js";
-import type * as usageReports from "../usageReports.js";
-import type * as waitlist from "../waitlist.js";
-import type * as webhooks from "../webhooks.js";
-import type * as workspaceSettings from "../workspaceSettings.js";
-import type * as workspaces from "../workspaces.js";
-
-import type {
-  ApiFromModules,
-  FilterApi,
-  FunctionReference,
-} from "convex/server";
-
-declare const fullApi: ApiFromModules<{
-  adminActivate: typeof adminActivate;
-  adminStats: typeof adminStats;
-  agents: typeof agents;
-  analytics: typeof analytics;
-  apiKeys: typeof apiKeys;
-  backfillAnalytics: typeof backfillAnalytics;
-  backfillSearchLogs: typeof backfillSearchLogs;
-  billing: typeof billing;
-  capabilities: typeof capabilities;
-  chains: typeof chains;
-  credits: typeof credits;
-  crons: typeof crons;
-  debugFilestackLogs: typeof debugFilestackLogs;
-  debugGetToken: typeof debugGetToken;
-  directCall: typeof directCall;
-  earnProgress: typeof earnProgress;
-  email: typeof email;
-  feedback: typeof feedback;
-  http: typeof http;
-  inbound: typeof inbound;
-  logs: typeof logs;
-  migrateFilestack: typeof migrateFilestack;
-  migratePartnersProd: typeof migratePartnersProd;
-  migratePratham: typeof migratePratham;
-  migrateProviderWorkspaces: typeof migrateProviderWorkspaces;
-  mou: typeof mou;
-  providerKeys: typeof providerKeys;
-  providers: typeof providers;
-  purchases: typeof purchases;
-  ratelimit: typeof ratelimit;
-  searchLogs: typeof searchLogs;
-  seedAPILayerAPIs: typeof seedAPILayerAPIs;
-  seedDirectCallConfigs: typeof seedDirectCallConfigs;
-  seedPratham: typeof seedPratham;
-  spendAlerts: typeof spendAlerts;
-  stripeActions: typeof stripeActions;
-  teams: typeof teams;
-  telemetry: typeof telemetry;
-  updateAPIStatus: typeof updateAPIStatus;
-  usage: typeof usage;
-  usageReports: typeof usageReports;
-  waitlist: typeof waitlist;
-  webhooks: typeof webhooks;
-  workspaceSettings: typeof workspaceSettings;
-  workspaces: typeof workspaces;
-}>;
-
-/**
- * A utility for referencing Convex functions in your app's public API.
- *
- * Usage:
- * ```js
- * const myFunctionReference = api.myModule.myFunction;
- * ```
- */
-export declare const api: FilterApi<
-  typeof fullApi,
-  FunctionReference<any, "public">
->;
-
-/**
- * A utility for referencing Convex functions in your app's internal API.
- *
- * Usage:
- * ```js
- * const myFunctionReference = internal.myModule.myFunction;
- * ```
- */
-export declare const internal: FilterApi<
-  typeof fullApi,
-  FunctionReference<any, "internal">
->;
-
-export declare const components: {};

package/convex/_generated/api.js

@@ -1,23 +0,0 @@
-/* eslint-disable */
-/**
- * Generated `api` utility.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import { anyApi, componentsGeneric } from "convex/server";
-
-/**
- * A utility for referencing Convex functions in your app's API.
- *
- * Usage:
- * ```js
- * const myFunctionReference = api.myModule.myFunction;
- * ```
- */
-export const api = anyApi;
-export const internal = anyApi;
-export const components = componentsGeneric();

package/convex/_generated/dataModel.d.ts

@@ -1,60 +0,0 @@
-/* eslint-disable */
-/**
- * Generated data model types.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import type {
-  DataModelFromSchemaDefinition,
-  DocumentByName,
-  TableNamesInDataModel,
-  SystemTableNames,
-} from "convex/server";
-import type { GenericId } from "convex/values";
-import schema from "../schema.js";
-
-/**
- * The names of all of your Convex tables.
- */
-export type TableNames = TableNamesInDataModel<DataModel>;
-
-/**
- * The type of a document stored in Convex.
- *
- * @typeParam TableName - A string literal type of the table name (like "users").
- */
-export type Doc<TableName extends TableNames> = DocumentByName<
-  DataModel,
-  TableName
->;
-
-/**
- * An identifier for a document in Convex.
- *
- * Convex documents are uniquely identified by their `Id`, which is accessible
- * on the `_id` field. To learn more, see [Document IDs](https://docs.convex.dev/using/document-ids).
- *
- * Documents can be loaded using `db.get(tableName, id)` in query and mutation functions.
- *
- * IDs are just strings at runtime, but this type can be used to distinguish them from other
- * strings when type checking.
- *
- * @typeParam TableName - A string literal type of the table name (like "users").
- */
-export type Id<TableName extends TableNames | SystemTableNames> =
-  GenericId<TableName>;
-
-/**
- * A type describing your Convex data model.
- *
- * This type includes information about what tables you have, the type of
- * documents stored in those tables, and the indexes defined on them.
- *
- * This type is used to parameterize methods like `queryGeneric` and
- * `mutationGeneric` to make them type-safe.
- */
-export type DataModel = DataModelFromSchemaDefinition<typeof schema>;