@kognai/clawrouter-x402 0.1.0

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2026 Kognai / SkinGem. All rights reserved.
+
+PROPRIETARY AND CONFIDENTIAL
+
+This software and its source code are the exclusive property of Kognai / SkinGem.
+Unauthorized copying, distribution, modification, sublicensing, or use of this
+software, in whole or in part, is strictly prohibited without the express prior
+written permission of Kognai / SkinGem.
+
+This software is provided to authorized parties solely for use within the Kognai
+ecosystem. Any use outside of this scope requires a separate written agreement
+with Kognai / SkinGem.

package/dist/clawrouter-x402/src/clawrouter-v2.d.ts

@@ -0,0 +1,87 @@
+/**
+ * clawrouter-v2.ts — ClawRouter Universal LLM Gateway v2.0
+ *
+ * THE SINGLE DOOR every LLM call passes through (ClawRouter Spec v2.0).
+ * Execution Protocol Section 17: ClawRouter Mandatory Gateway Rule.
+ *
+ * Routing Matrix:
+ *   T0 NANO    → qwen3:0.6b (local)     — classification, templating
+ *   T1 LOCAL   → qwen3:4b (local)       — QA, supervision, aggregation
+ *   T2 POWER   → qwen3:14b (local)      — primary execution engine
+ *   T2.5 EXEC  → Gemini Flash (API)     — cloud-quality, no constitutional
+ *   T3 APEX    → Claude Sonnet (API)    — constitutional judge only
+ *
+ * Rules:
+ *   - constitutional_flag=true → always T3 APEX
+ *   - Local tiers (T0/T1/T2) → Ollama direct ($0)
+ *   - Cloud tiers (T2.5/T3) → OpenClaw gateway at :18789
+ *   - QCG pre-compression for cloud tiers when context > 5000 tokens
+ *   - NO agent holds API keys — keys only in ClawRouter/.env
+ *
+ * @see ~/Documents/Kognai/Master Documents/clawrouter_spec_v2.docx
+ * @see ~/Documents/Kognai/Master Documents/execution_protocol_sections_17_18.docx
+ */
+import type { TierClass, TextComplexity, CreativeModality, CreativeQuality, ClawRouterV2Request, ClawRouterV2Response } from '../../orchestrator-core/src/lib/model-router-contract';
+export type { TierClass, TextComplexity, CreativeModality, CreativeQuality, ClawRouterV2Request, ClawRouterV2Response, };
+interface CostLogEntry {
+    timestamp: string;
+    agent_id: string;
+    task_type: string;
+    tier: string;
+    model: string;
+    local: boolean;
+    cost_usd: number;
+    input_tokens: number;
+    output_tokens: number;
+    qcg_compressed: boolean;
+    tokens_saved: number;
+}
+export declare function getCostLog(): readonly CostLogEntry[];
+export declare function getDailyCostDigest(): {
+    total_usd: number;
+    by_tier: Record<string, number>;
+    by_agent: Record<string, number>;
+    tokens_saved_by_qcg: number;
+    call_count: number;
+};
+export declare function getMeterStats(): {
+    recipient: `0x${string}`;
+    enabled: boolean;
+    settled: number;
+    failed: number;
+    totalAtomicSettled: number;
+};
+/**
+ * Route an LLM call through ClawRouter v2.0.
+ * This is the ONLY function any agent should call for LLM inference.
+ *
+ * @example
+ *   const result = await routeCall({
+ *     task_type: 'code_review',
+ *     tier_class: 'text',
+ *     complexity: 'power',
+ *     context_tokens: 3000,
+ *     constitutional_flag: false,
+ *     agent_id: 'cto-agent',
+ *     payload: { system: '...', prompt: '...' }
+ *   });
+ */
+export declare function routeCall(req: ClawRouterV2Request): Promise<ClawRouterV2Response>;
+export declare function callLLM(prompt: string, opts?: {
+    systemPrompt?: string;
+    complexity?: TextComplexity;
+    constitutional?: boolean;
+    agentId?: string;
+    taskType?: string;
+    maxTokens?: number;
+}): Promise<{
+    content: string;
+    model: string;
+    tier: string;
+    cost_usd: number;
+}>;
+export declare function clawRouterHealthCheck(): Promise<{
+    ollama: boolean;
+    gateway: boolean;
+    models: string[];
+}>;