@blockrun/clawrouter 0.10.4 → 0.10.6

package/dist/index.d.ts

@@ -738,6 +738,10 @@ type UsageEntry = {
     baselineCost: number;
     savings: number;
     latencyMs: number;
+    /** Partner service ID (e.g., "x_users_lookup") — only set for partner API calls */
+    partnerId?: string;
+    /** Partner service name (e.g., "AttentionVC") — only set for partner API calls */
+    service?: string;
 };
 /**
  * Log a usage entry as a JSON line.
@@ -991,6 +995,81 @@ declare function getStats(days?: number): Promise<AggregatedStats>;
  */
 declare function formatStatsAscii(stats: AggregatedStats): string;
 
+/**
+ * Partner Service Registry
+ *
+ * Defines available partner APIs that can be called through ClawRouter's proxy.
+ * Partners provide specialized data (Twitter/X, etc.) via x402 micropayments.
+ * The same wallet used for LLM calls pays for partner API calls — zero extra setup.
+ */
+type PartnerServiceParam = {
+    name: string;
+    type: "string" | "string[]" | "number";
+    description: string;
+    required: boolean;
+};
+type PartnerServiceDefinition = {
+    /** Unique service ID used in tool names: blockrun_{id} */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Partner providing this service */
+    partner: string;
+    /** Short description for tool listing */
+    description: string;
+    /** Proxy path (relative to /v1) */
+    proxyPath: string;
+    /** HTTP method */
+    method: "GET" | "POST";
+    /** Parameters for the tool's JSON Schema */
+    params: PartnerServiceParam[];
+    /** Pricing info for display */
+    pricing: {
+        perUnit: string;
+        unit: string;
+        minimum: string;
+        maximum: string;
+    };
+    /** Example usage for help text */
+    example: {
+        input: Record<string, unknown>;
+        description: string;
+    };
+};
+/**
+ * All registered partner services.
+ * New partners are added here — the rest of the system picks them up automatically.
+ */
+declare const PARTNER_SERVICES: PartnerServiceDefinition[];
+/**
+ * Get a partner service by ID.
+ */
+declare function getPartnerService(id: string): PartnerServiceDefinition | undefined;
+
+/**
+ * Partner Tool Builder
+ *
+ * Converts partner service definitions into OpenClaw tool definitions.
+ * Each tool's execute() calls through the local proxy which handles
+ * x402 payment transparently using the same wallet.
+ */
+/** OpenClaw tool definition shape (duck-typed) */
+type PartnerToolDefinition = {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+};
+/**
+ * Build OpenClaw tool definitions for all registered partner services.
+ * @param proxyBaseUrl - Local proxy base URL (e.g., "http://127.0.0.1:8402")
+ */
+declare function buildPartnerTools(proxyBaseUrl: string): PartnerToolDefinition[];
+
 /**
  * @blockrun/clawrouter
  *
@@ -1012,4 +1091,4 @@ declare function formatStatsAscii(stats: AggregatedStats): string;
 
 declare const plugin: OpenClawPluginDefinition;
 
-export { type AggregatedStats, BALANCE_THRESHOLDS, BLOCKRUN_MODELS, type BalanceInfo, BalanceMonitor, type CachedLLMResponse, type CachedPaymentParams, type CachedResponse, DEFAULT_RETRY_CONFIG, DEFAULT_ROUTING_CONFIG, DEFAULT_SESSION_CONFIG, type DailyStats, EmptyWalletError, InsufficientFundsError, type InsufficientFundsInfo, type LowBalanceInfo, MODEL_ALIASES, OPENCLAW_MODELS, PaymentCache, type PaymentFetchResult, type PreAuthParams, type ProxyHandle, type ProxyOptions, RequestDeduplicator, ResponseCache, type ResponseCacheConfig, type RetryConfig, type RoutingConfig, type RoutingDecision, RpcError, type SessionConfig, type SessionEntry, SessionStore, type SufficiencyResult, type Tier, type UsageEntry, blockrunProvider, buildProviderModels, calculateModelCost, createPaymentFetch, plugin as default, fetchWithRetry, formatStatsAscii, getAgenticModels, getFallbackChain, getFallbackChainFiltered, getModelContextWindow, getProxyPort, getSessionId, getStats, isAgenticModel, isBalanceError, isEmptyWalletError, isInsufficientFundsError, isRetryable, isRpcError, logUsage, resolveModelAlias, route, startProxy };
+export { type AggregatedStats, BALANCE_THRESHOLDS, BLOCKRUN_MODELS, type BalanceInfo, BalanceMonitor, type CachedLLMResponse, type CachedPaymentParams, type CachedResponse, DEFAULT_RETRY_CONFIG, DEFAULT_ROUTING_CONFIG, DEFAULT_SESSION_CONFIG, type DailyStats, EmptyWalletError, InsufficientFundsError, type InsufficientFundsInfo, type LowBalanceInfo, MODEL_ALIASES, OPENCLAW_MODELS, PARTNER_SERVICES, type PartnerServiceDefinition, type PartnerToolDefinition, PaymentCache, type PaymentFetchResult, type PreAuthParams, type ProxyHandle, type ProxyOptions, RequestDeduplicator, ResponseCache, type ResponseCacheConfig, type RetryConfig, type RoutingConfig, type RoutingDecision, RpcError, type SessionConfig, type SessionEntry, SessionStore, type SufficiencyResult, type Tier, type UsageEntry, blockrunProvider, buildPartnerTools, buildProviderModels, calculateModelCost, createPaymentFetch, plugin as default, fetchWithRetry, formatStatsAscii, getAgenticModels, getFallbackChain, getFallbackChainFiltered, getModelContextWindow, getPartnerService, getProxyPort, getSessionId, getStats, isAgenticModel, isBalanceError, isEmptyWalletError, isInsufficientFundsError, isRetryable, isRpcError, logUsage, resolveModelAlias, route, startProxy };