@nordsym/apiclaw 1.4.0 → 1.4.2

package/landing/src/lib/stats.json

@@ -4,7 +4,7 @@
   "directCallCount": 18,
   "categoryCount": 13,
   "lastUpdated": "2026-02-27T09:10:41.344767",
-  "generatedAt": "2026-03-02T00:02:51.920Z",
+  "generatedAt": "2026-03-03T16:58:33.036Z",
   "categoryBreakdown": {
     "Finance": 1179,
     "Auth & Security": 491,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nordsym/apiclaw",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "The API layer for AI agents. 22,000+ APIs. Direct Call. Works with any MCP-compatible agent.",
   "type": "module",
   "main": "dist/index.js",
@@ -42,7 +42,19 @@
     "anthropic",
     "mcp-server",
     "tool-use",
-    "function-calling"
+    "function-calling",
+    "api-aggregator",
+    "multi-api",
+    "unified-api",
+    "api-hub",
+    "llm-tools",
+    "agent-tools",
+    "ai-sdk",
+    "api-client",
+    "ai-api",
+    "claude-tools",
+    "gpt-tools",
+    "api-marketplace"
   ],
   "author": "NordSym",
   "license": "MIT",

package/src/index.ts

@@ -66,7 +66,7 @@ import {
 const DEFAULT_AGENT_ID = 'agent_default';
 
 // Convex client for workspace management
-const CONVEX_URL = process.env.CONVEX_URL || 'https://adventurous-avocet-799.convex.cloud';
+const CONVEX_URL = process.env.CONVEX_URL || 'https://brilliant-puffin-712.eu-west-1.convex.cloud';
 const convex = new ConvexHttpClient(CONVEX_URL);
 
 // Global workspace context (set on startup if session is valid)
@@ -243,6 +243,14 @@ const tools: Tool[] = [
         region: {
           type: 'string',
           description: 'Filter by region (e.g., "SE", "EU", "global")'
+        },
+        subagent_id: {
+          type: 'string',
+          description: 'Optional subagent identifier for multi-agent tracking'
+        },
+        ai_backend: {
+          type: 'string',
+          description: 'AI backend making this request (e.g., "claude-3-sonnet", "gpt-4"). Used for analytics.'
         }
       },
       required: ['query']
@@ -428,6 +436,14 @@ Example chain:
         webhook: {
           type: 'string',
           description: 'URL to POST results when async chain completes'
+        },
+        subagent_id: {
+          type: 'string',
+          description: 'Optional subagent identifier for multi-agent tracking'
+        },
+        ai_backend: {
+          type: 'string',
+          description: 'AI backend making this request (e.g., "claude-3-sonnet", "gpt-4"). Used for analytics.'
         }
       },
       required: []
@@ -468,6 +484,14 @@ Example chain:
             preferredProvider: { type: 'string', description: 'Hint to prefer a specific provider' },
             fallback: { type: 'boolean', description: 'Enable fallback to other providers (default: true)' }
           }
+        },
+        subagent_id: {
+          type: 'string',
+          description: 'Optional subagent identifier for multi-agent tracking'
+        },
+        ai_backend: {
+          type: 'string',
+          description: 'AI backend making this request (e.g., "claude-3-sonnet", "gpt-4"). Used for analytics.'
         }
       },
       required: ['capability', 'action', 'params']
@@ -678,10 +702,50 @@ Docs: https://apiclaw.nordsym.com
         const category = args?.category as string | undefined;
         const maxResults = (args?.max_results as number) || 5;
         const region = args?.region as string | undefined;
+        const subagentId = args?.subagent_id as string | undefined;
+        const aiBackend = args?.ai_backend as string | undefined;
 
         const startTime = Date.now();
         const results = discoverAPIs(query, { category, maxResults, region });
-        trackSearch(query, results.length, Date.now() - startTime);
+        const responseTimeMs = Date.now() - startTime;
+        trackSearch(query, results.length, responseTimeMs);
+
+        // Log search to Convex for analytics
+        if (workspaceContext?.sessionToken) {
+          const searchLogPayload = {
+            path: 'searchLogs:log',
+            args: {
+              sessionToken: workspaceContext.sessionToken,
+              subagentId: subagentId || undefined,
+              query,
+              resultCount: results.length,
+              matchedProviders: results.slice(0, 10).map(r => r.provider.id),
+              responseTimeMs,
+            },
+          };
+          
+          fetch('https://brilliant-puffin-712.eu-west-1.convex.cloud/api/mutation', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(searchLogPayload),
+          }).catch(() => {}); // Fire and forget
+        }
+
+        // Update AI backend tracking if provided
+        if (aiBackend && workspaceContext?.sessionToken) {
+          fetch('https://brilliant-puffin-712.eu-west-1.convex.cloud/api/mutation', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              path: 'agents:updateAIBackend',
+              args: {
+                token: workspaceContext.sessionToken,
+                subagentId: subagentId || undefined,
+                aiBackend,
+              },
+            }),
+          }).catch(() => {}); // Fire and forget
+        }
 
         if (results.length === 0) {
           return {
@@ -897,6 +961,24 @@ Docs: https://apiclaw.nordsym.com
         const confirmToken = args?.confirm_token as string | undefined;
         const dryRun = args?.dry_run as boolean | undefined;
         const chain = args?.chain as ChainStepUnion[] | undefined;
+        const subagentId = args?.subagent_id as string | undefined;
+        const aiBackend = args?.ai_backend as string | undefined;
+        
+        // Track AI backend if provided
+        if (aiBackend && workspaceContext?.sessionToken) {
+          fetch('https://brilliant-puffin-712.eu-west-1.convex.cloud/api/mutation', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              path: 'agents:updateAIBackend',
+              args: {
+                token: workspaceContext.sessionToken,
+                subagentId: subagentId || undefined,
+                aiBackend,
+              },
+            }),
+          }).catch(() => {}); // Fire and forget
+        }
         
         // ============================================
         // CHAIN EXECUTION MODE
@@ -1255,6 +1337,24 @@ Docs: https://apiclaw.nordsym.com
         const action = args?.action as string;
         const params = (args?.params as Record<string, any>) || {};
         const preferences = (args?.preferences as Record<string, any>) || {};
+        const subagentId = args?.subagent_id as string | undefined;
+        const aiBackend = args?.ai_backend as string | undefined;
+        
+        // Track AI backend if provided
+        if (aiBackend && workspaceContext?.sessionToken) {
+          fetch('https://brilliant-puffin-712.eu-west-1.convex.cloud/api/mutation', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              path: 'agents:updateAIBackend',
+              args: {
+                token: workspaceContext.sessionToken,
+                subagentId: subagentId || undefined,
+                aiBackend,
+              },
+            }),
+          }).catch(() => {}); // Fire and forget
+        }
 
         // Check if capability exists
         const exists = await hasCapability(capabilityId);

package/src/chain-types.ts

@@ -1,270 +0,0 @@
-/**
- * Chain Execution Types for APIClaw
- * 
- * Enables multi-step API orchestration with:
- * - Sequential execution
- * - Parallel execution
- * - Conditional branching
- * - Loops (forEach, map-reduce)
- * - Error handling & retry
- * - Cross-step references ($stepId.property)
- */
-
-// ============================================
-// CHAIN STEP TYPES
-// ============================================
-
-/**
- * Base step configuration
- */
-export interface ChainStepBase {
-  id: string;
-  provider: string;
-  action: string;
-  params?: Record<string, any>;
-  onError?: ErrorHandler;
-}
-
-/**
- * Parallel execution step - runs multiple steps concurrently
- */
-export interface ParallelStep {
-  parallel: ChainStepBase[];
-}
-
-/**
- * Conditional step - executes based on condition
- */
-export interface ConditionalStep {
-  if: string;  // Expression like "$step1.success === true"
-  then: ChainStepBase | ChainStep;
-  else?: ChainStepBase | ChainStep;
-}
-
-/**
- * Loop step - iterates over array
- */
-export interface ForEachStep {
-  forEach: string;  // Reference like "$step1.results"
-  as: string;       // Variable name for current item
-  do: ChainStepBase;
-}
-
-/**
- * Map step - transforms array
- */
-export interface MapStep {
-  map: {
-    input: string;
-    fn: ChainStepBase;
-  };
-}
-
-/**
- * Reduce step - aggregates results
- */
-export interface ReduceStep {
-  reduce: {
-    input: string;
-    fn: ChainStepBase;
-  };
-}
-
-/**
- * Union type for all step variants
- */
-export type ChainStep = 
-  | ChainStepBase 
-  | ParallelStep 
-  | ConditionalStep 
-  | ForEachStep
-  | MapStep
-  | ReduceStep;
-
-// ============================================
-// ERROR HANDLING
-// ============================================
-
-export interface RetryConfig {
-  attempts?: number;
-  maxAttempts?: number;
-  backoff?: number[] | 'exponential' | 'linear';
-  backoffMs?: number;
-}
-
-export interface ErrorHandler {
-  retry?: RetryConfig;
-  fallback?: ChainStepBase;
-  abort?: boolean;
-}
-
-export type ErrorPolicy = 'fail-fast' | 'best-effort' | 'transactional';
-
-export interface RollbackAction {
-  if: string;
-  do: ChainStepBase;
-}
-
-export interface ChainErrorPolicy {
-  mode: ErrorPolicy;
-  rollback?: RollbackAction[];
-}
-
-// ============================================
-// CHAIN CONFIGURATION
-// ============================================
-
-export interface ChainLimits {
-  maxSteps?: number;
-  maxParallel?: number;
-  maxCost?: { cents: number };
-}
-
-export interface ChainOptions {
-  continueOnError?: boolean;
-  timeout?: number;        // Max execution time in ms
-  async?: boolean;         // Return immediately with chainId
-  webhook?: string;        // URL to call on completion
-  errorPolicy?: ChainErrorPolicy;
-  limits?: ChainLimits;
-}
-
-// ============================================
-// CHAIN EXECUTION REQUEST
-// ============================================
-
-export interface ChainRequest extends ChainOptions {
-  chain: ChainStep[];
-}
-
-// ============================================
-// STEP RESULT
-// ============================================
-
-export type StepStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
-
-export interface StepResult {
-  id: string;
-  status: StepStatus;
-  result?: any;
-  error?: string;
-  errorCode?: string;
-  latencyMs: number;
-  cost?: { cents: number };
-  retryAttempts?: number;
-}
-
-// ============================================
-// CHAIN RESPONSE
-// ============================================
-
-export interface ChainSuccessResponse {
-  success: true;
-  chainId: string;
-  steps: StepResult[];
-  finalResult: any;
-  totalLatencyMs: number;
-  totalCost: { cents: number };
-  tokensSaved: number;
-}
-
-export interface ChainErrorResponse {
-  success: false;
-  chainId: string;
-  completedSteps: string[];
-  failedStep: {
-    id: string;
-    error: string;
-    code?: string;
-    retryAfter?: number;
-  };
-  partialResults: Record<string, any>;
-  canResume: boolean;
-  resumeToken?: string;
-}
-
-export type ChainResponse = ChainSuccessResponse | ChainErrorResponse;
-
-// ============================================
-// ASYNC CHAIN STATUS
-// ============================================
-
-export interface AsyncChainResponse {
-  chainId: string;
-  status: 'running' | 'completed' | 'failed';
-  estimatedCompletion?: string;
-  statusUrl: string;
-}
-
-export interface ChainStatusResponse {
-  chainId: string;
-  status: 'pending' | 'running' | 'completed' | 'failed';
-  progress: {
-    completedSteps: number;
-    totalSteps: number;
-    currentStep?: string;
-  };
-  startedAt: string;
-  completedAt?: string;
-  result?: ChainResponse;
-}
-
-// ============================================
-// RESUME CHAIN
-// ============================================
-
-export interface ResumeChainRequest {
-  resumeToken: string;
-  overrides?: Record<string, Record<string, any>>;  // stepId -> params overrides
-}
-
-// ============================================
-// STORED CHAIN TEMPLATES
-// ============================================
-
-export interface ChainInput {
-  type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-  required?: boolean;
-  default?: any;
-  description?: string;
-}
-
-export interface ChainTemplate {
-  name: string;
-  description?: string;
-  inputs: Record<string, ChainInput>;
-  chain: ChainStep[];
-}
-
-export interface UseChainRequest {
-  useChain: string;
-  inputs: Record<string, any>;
-}
-
-// ============================================
-// TYPE GUARDS
-// ============================================
-
-export function isParallelStep(step: ChainStep): step is ParallelStep {
-  return 'parallel' in step;
-}
-
-export function isConditionalStep(step: ChainStep): step is ConditionalStep {
-  return 'if' in step && 'then' in step;
-}
-
-export function isForEachStep(step: ChainStep): step is ForEachStep {
-  return 'forEach' in step && 'do' in step;
-}
-
-export function isMapStep(step: ChainStep): step is MapStep {
-  return 'map' in step;
-}
-
-export function isReduceStep(step: ChainStep): step is ReduceStep {
-  return 'reduce' in step;
-}
-
-export function isBaseStep(step: ChainStep): step is ChainStepBase {
-  return 'provider' in step && 'action' in step;
-}