@kognai/clawrouter-x402 0.1.0 → 0.1.1

package/dist/{clawrouter-x402/src/clawrouter-v2.d.ts → clawrouter-v2.d.ts}

@@ -21,7 +21,7 @@
  * @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';
+import type { TierClass, TextComplexity, CreativeModality, CreativeQuality, ClawRouterV2Request, ClawRouterV2Response } from '@kognai/orchestrator-core';
 export type { TierClass, TextComplexity, CreativeModality, CreativeQuality, ClawRouterV2Request, ClawRouterV2Response, };
 interface CostLogEntry {
     timestamp: string;

package/dist/{clawrouter-x402/src/clawrouter-v2.js → clawrouter-v2.js}

@@ -67,8 +67,8 @@ const https = __importStar(require("https"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const crypto = __importStar(require("crypto"));
-const wallet_state_1 = require("../../orchestrator-core/src/lib/wallet-state");
-const acp_1 = require("../../orchestrator-core/src/lib/acp");
+const orchestrator_core_1 = require("@kognai/orchestrator-core");
+const orchestrator_core_2 = require("@kognai/orchestrator-core");
 // ── Config ────────────────────────────────────────────────────────────────────
 const _rawOllamaHost = process.env.OLLAMA_HOST || 'http://127.0.0.1:11434'; // SEC1: loopback-only default
 const OLLAMA_BASE = _rawOllamaHost.startsWith('http') ? _rawOllamaHost : `http://${_rawOllamaHost}`;
@@ -654,7 +654,7 @@ async function routeCall(req) {
     // = log only; flip to `enforce` to actually downgrade after reviewing shadow logs).
     if (!route.local && req.tier_class === 'text') {
         const gateMode = (process.env.X402_SPEND_GATE || 'shadow').toLowerCase();
-        if (gateMode !== 'off' && (0, acp_1.getAgent)(req.agent_id) && !(0, acp_1.checkCapability)(req.agent_id, 'llm_call_cloud').allowed) {
+        if (gateMode !== 'off' && (0, orchestrator_core_2.getAgent)(req.agent_id) && !(0, orchestrator_core_2.checkCapability)(req.agent_id, 'llm_call_cloud').allowed) {
             console.warn(`[ClawRouter] spend-gate(${gateMode}): agent "${req.agent_id}" lacks llm_call_cloud — ` +
                 `${route.tier} ${gateMode === 'enforce' ? 'downgraded → T2 local' : 'WOULD be downgraded'}`);
             if (gateMode === 'enforce') {
@@ -664,7 +664,7 @@ async function routeCall(req) {
     }
     // 1b. CEO Wallet freeze guard — block cloud calls when budget exhausted (§17.5)
     if (!route.local) {
-        const wallet = (0, wallet_state_1.getWalletState)();
+        const wallet = (0, orchestrator_core_1.getWalletState)();
         if (wallet.isFrozen) {
             throw new Error(`ClawRouter FROZEN: CEO wallet at ${wallet.burnPct.toFixed(1)}% ` +
                 `($${wallet.spentThisMonth.toFixed(2)}/$${wallet.monthlyBudget}). ` +
@@ -712,7 +712,7 @@ async function routeCall(req) {
             output_tokens += apexResult.output_tokens;
             cost_usd = apexResult.cost_usd;
             if (cost_usd > 0)
-                (0, wallet_state_1.recordSpend)(cost_usd);
+                (0, orchestrator_core_1.recordSpend)(cost_usd);
             route = { tier: 'T3', model: TIER_MODELS.T3_APEX, local: false };
         }
     }
@@ -732,7 +732,7 @@ async function routeCall(req) {
     }
     // 4b. CEO Wallet billing — record every cloud spend (§17.5)
     if (cost_usd > 0) {
-        (0, wallet_state_1.recordSpend)(cost_usd);
+        (0, orchestrator_core_1.recordSpend)(cost_usd);
     }
     // 4c. x402 on-chain metering (Option B): when enabled, every cloud-tier
     // call broadcasts a small EIP-3009 USDC transfer from the x402 signer

package/dist/{clawrouter-x402/src/index.d.ts → index.d.ts}

@@ -11,7 +11,7 @@
  * clawrouter-v2.ts), so importing this module does not eagerly pull viem —
  * but the package declares viem as a dependency so it resolves at pay time.
  */
-import type { ModelRouter } from '../../orchestrator-core/src/lib/model-router-contract';
+import type { ModelRouter } from '@kognai/orchestrator-core';
 /**
  * The ModelRouter implementation Kognai injects:
  *   import { x402Router } from '@kognai/clawrouter-x402';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kognai/clawrouter-x402",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "description": "ClawRouter v2 — Kognai's viem-backed x402 ModelRouter implementation. Injected into @kognai/orchestrator-core's router seam at startup, so core never depends on viem; products that don't route on-chain simply don't install this package.",
   "main": "dist/index.js",
@@ -29,5 +29,8 @@
   },
   "engines": {
     "node": ">=18"
+  },
+  "devDependencies": {
+    "@kognai/orchestrator-core": "^0.1.0"
   }
 }

package/dist/orchestrator-core/src/lib/acp.d.ts

@@ -1,61 +0,0 @@
-/**
- * ACP — Agent Capability Protocol v1
- *
- * Defines capability declarations for each agent in the Kognai swarm.
- * Each agent declares what it CAN and CANNOT do, enabling:
- *   - Constitution enforcement (prevent agents from exceeding scope)
- *   - CTO approval gate capability checks
- *   - Task routing based on declared capabilities
- *
- * Capability tiers:
- *   T1 (Foundation): read, write, search
- *   T2 (Content):    llm_call, tts, video_gen, script_gen
- *   T3 (Integration): api_call, db_query, telegram, stripe
- *   T4 (System):     deploy, pm2, git_push, shell_exec
- *
- * Sprint 650 — ACP v1 implementation
- */
-export type CapabilityTier = 'T1' | 'T2' | 'T3' | 'T4';
-export type Capability = 'read_files' | 'write_files' | 'search_code' | 'git_read' | 'llm_call_local' | 'llm_call_cloud' | 'tts_generate' | 'video_composite' | 'script_generate' | 'image_generate' | 'avatar_generate' | 'api_call_external' | 'db_query' | 'db_write' | 'telegram_send' | 'stripe_read' | 'stripe_write' | 'youtube_read' | 'tiktok_post' | 'deploy' | 'pm2_manage' | 'git_push' | 'shell_exec' | 'env_modify';
-export interface AgentCapabilityDeclaration {
-    agent_id: string;
-    display_name: string;
-    tier: CapabilityTier;
-    capabilities: Capability[];
-    denied: Capability[];
-    scope: string;
-    max_model_tier: 'nano' | 'local' | 'power' | 'cloud' | 'apex';
-}
-export interface CapabilityCheckResult {
-    allowed: boolean;
-    agent_id: string;
-    capability: Capability;
-    reason: string;
-}
-/** Get all registered agents */
-export declare function getAllAgents(): AgentCapabilityDeclaration[];
-/** Get a specific agent by ID */
-export declare function getAgent(agentId: string): AgentCapabilityDeclaration | undefined;
-/** Check if an agent has a specific capability */
-export declare function checkCapability(agentId: string, capability: Capability): CapabilityCheckResult;
-/** Check multiple capabilities at once */
-export declare function checkCapabilities(agentId: string, capabilities: Capability[]): CapabilityCheckResult[];
-/** Get all agents with a specific capability */
-export declare function getAgentsWithCapability(capability: Capability): AgentCapabilityDeclaration[];
-/** Get the tier for a capability */
-export declare function getCapabilityTier(capability: Capability): CapabilityTier | undefined;
-/** Validate that a sprint's task assignments respect ACP */
-export declare function validateSprintAssignments(tasks: Array<{
-    agent: string;
-    required_capabilities: Capability[];
-}>): {
-    valid: boolean;
-    violations: CapabilityCheckResult[];
-};
-/** Get summary stats */
-export declare function getRegistryStats(): {
-    total_agents: number;
-    by_tier: Record<CapabilityTier, number>;
-    kognai_agents: number;
-    scs001_agents: number;
-};

package/dist/orchestrator-core/src/lib/acp.js

@@ -1,425 +0,0 @@
-"use strict";
-/**
- * ACP — Agent Capability Protocol v1
- *
- * Defines capability declarations for each agent in the Kognai swarm.
- * Each agent declares what it CAN and CANNOT do, enabling:
- *   - Constitution enforcement (prevent agents from exceeding scope)
- *   - CTO approval gate capability checks
- *   - Task routing based on declared capabilities
- *
- * Capability tiers:
- *   T1 (Foundation): read, write, search
- *   T2 (Content):    llm_call, tts, video_gen, script_gen
- *   T3 (Integration): api_call, db_query, telegram, stripe
- *   T4 (System):     deploy, pm2, git_push, shell_exec
- *
- * Sprint 650 — ACP v1 implementation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAllAgents = getAllAgents;
-exports.getAgent = getAgent;
-exports.checkCapability = checkCapability;
-exports.checkCapabilities = checkCapabilities;
-exports.getAgentsWithCapability = getAgentsWithCapability;
-exports.getCapabilityTier = getCapabilityTier;
-exports.validateSprintAssignments = validateSprintAssignments;
-exports.getRegistryStats = getRegistryStats;
-// ── Capability Tier Map ───────────────────────────────────────────────
-const TIER_CAPABILITIES = {
-    T1: ['read_files', 'write_files', 'search_code', 'git_read'],
-    T2: ['llm_call_local', 'llm_call_cloud', 'tts_generate', 'video_composite',
-        'script_generate', 'image_generate', 'avatar_generate'],
-    T3: ['api_call_external', 'db_query', 'db_write', 'telegram_send',
-        'stripe_read', 'stripe_write', 'youtube_read', 'tiktok_post'],
-    T4: ['deploy', 'pm2_manage', 'git_push', 'shell_exec', 'env_modify'],
-};
-// ── Agent Registry ────────────────────────────────────────────────────
-const REGISTRY = [
-    // ─── Kognai Core Agents ─────────────────────────────────
-    {
-        agent_id: 'ceo', display_name: 'CEO', tier: 'T4',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local', 'llm_call_cloud', 'shell_exec', 'git_push'],
-        denied: ['stripe_write', 'tiktok_post', 'env_modify'],
-        scope: 'Strategy, vision, agent coordination. No financial ops or posting.',
-        max_model_tier: 'apex',
-    },
-    {
-        agent_id: 'cto', display_name: 'CTO', tier: 'T4',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local', 'llm_call_cloud', 'shell_exec', 'git_push', 'deploy', 'pm2_manage'],
-        denied: ['stripe_write', 'tiktok_post'],
-        scope: 'Architecture review, sprint approval, deployment, infra management.',
-        max_model_tier: 'cloud',
-    },
-    {
-        agent_id: 'cfo', display_name: 'CFO', tier: 'T3',
-        capabilities: ['read_files', 'search_code', 'git_read', 'llm_call_local', 'stripe_read', 'db_query'],
-        denied: ['write_files', 'shell_exec', 'git_push', 'deploy', 'stripe_write'],
-        scope: 'Financial reporting, cost tracking, budget analysis. Read-only financial access.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'cmo', display_name: 'CMO', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write', 'stripe_write'],
-        scope: 'Marketing strategy, content planning, brand narrative.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'supervisor', display_name: 'Supervisor', tier: 'T3',
-        capabilities: ['read_files', 'search_code', 'git_read', 'llm_call_local', 'db_query'],
-        denied: ['write_files', 'shell_exec', 'deploy', 'git_push'],
-        scope: 'Sprint review, quality validation. Read-only analysis.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'devops', display_name: 'DevOps', tier: 'T4',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'shell_exec', 'deploy', 'pm2_manage', 'git_push', 'env_modify'],
-        denied: ['stripe_write', 'tiktok_post', 'llm_call_cloud'],
-        scope: 'Infrastructure, deployment, monitoring, PM2 process management.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'security', display_name: 'Security', tier: 'T3',
-        capabilities: ['read_files', 'search_code', 'git_read', 'llm_call_local', 'db_query'],
-        denied: ['write_files', 'shell_exec', 'deploy', 'git_push', 'db_write'],
-        scope: 'Security audit, vulnerability scanning. Read-only.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'achiri', display_name: 'Achiri', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'llm_call_local', 'llm_call_cloud', 'db_query', 'db_write', 'telegram_send'],
-        denied: ['shell_exec', 'deploy', 'git_push', 'stripe_write'],
-        scope: 'AI companion conversations, memory, Tunisian cultural adaptation.',
-        max_model_tier: 'cloud',
-    },
-    {
-        agent_id: 'backend-core', display_name: 'Backend Core', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'db_query', 'db_write', 'api_call_external'],
-        denied: ['deploy', 'shell_exec', 'stripe_write'],
-        scope: 'Backend API development, database operations.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'backend-ledger', display_name: 'Backend Ledger', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'db_query', 'db_write'],
-        denied: ['deploy', 'shell_exec', 'stripe_write'],
-        scope: 'Ledger management, financial record keeping.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'backend-tax', display_name: 'Backend Tax', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'db_query'],
-        denied: ['deploy', 'shell_exec', 'stripe_write', 'db_write'],
-        scope: 'Tax calculation logic. Read-only DB.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'bizdev', display_name: 'BizDev', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write', 'stripe_write'],
-        scope: 'Business development strategy and research.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'conflict-analyzer', display_name: 'Conflict Analyzer', tier: 'T1',
-        capabilities: ['read_files', 'search_code', 'git_read'],
-        denied: ['write_files', 'shell_exec', 'deploy', 'db_write'],
-        scope: 'Detect conflicts between agent outputs. Read-only.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'conway-integration', display_name: 'Conway Integration', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Conway governance protocol integration.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'execution-verifier', display_name: 'Execution Verifier', tier: 'T1',
-        capabilities: ['read_files', 'search_code', 'git_read'],
-        denied: ['write_files', 'shell_exec', 'deploy'],
-        scope: 'Verify sprint execution results. Read-only.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'execution-watchdog', display_name: 'Execution Watchdog', tier: 'T2',
-        capabilities: ['read_files', 'search_code', 'git_read', 'llm_call_local', 'telegram_send'],
-        denied: ['write_files', 'shell_exec', 'deploy'],
-        scope: 'Monitor execution health, alert on anomalies.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'frontend', display_name: 'Frontend', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write', 'stripe_write'],
-        scope: 'Frontend UI development.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'invoica-x-admin', display_name: 'Invoica X Admin', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'api_call_external'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Invoica cross-product administration.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'market-intelligence', display_name: 'Market Intelligence', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local', 'api_call_external'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Market research, competitor analysis, trend tracking.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'pipeline-health-monitor', display_name: 'Pipeline Health Monitor', tier: 'T3',
-        capabilities: ['read_files', 'search_code', 'git_read', 'db_query', 'telegram_send'],
-        denied: ['write_files', 'shell_exec', 'deploy'],
-        scope: 'Monitor pipeline health metrics, send alerts.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'skills', display_name: 'Skills Manager', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'OpenClaw skills registry management.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'sprint-retrospective', display_name: 'Sprint Retrospective', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Sprint analysis and retrospective reports.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'telegram-support', display_name: 'Telegram Support', tier: 'T3',
-        capabilities: ['read_files', 'search_code', 'git_read', 'telegram_send', 'llm_call_local'],
-        denied: ['write_files', 'shell_exec', 'deploy', 'db_write'],
-        scope: 'Telegram bot command handling and notifications.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'test-failure-predictor', display_name: 'Test Failure Predictor', tier: 'T1',
-        capabilities: ['read_files', 'search_code', 'git_read'],
-        denied: ['write_files', 'shell_exec', 'deploy'],
-        scope: 'Predict likely test failures from code changes.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'test-runner', display_name: 'Test Runner', tier: 'T2',
-        capabilities: ['read_files', 'search_code', 'git_read', 'shell_exec'],
-        denied: ['write_files', 'deploy', 'git_push', 'db_write'],
-        scope: 'Execute test suites. Shell access for test commands only.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'test-utility-generator', display_name: 'Test Utility Generator', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Generate test fixtures and utility code.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'x-admin', display_name: 'X Admin', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'git_read', 'api_call_external'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'X/Twitter administration and posting.',
-        max_model_tier: 'power',
-    },
-    // ─── SCS-001 Pipeline Agents ────────────────────────────
-    {
-        agent_id: 'scs001-orchestrator', display_name: 'SCS-001 Orchestrator', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'search_code', 'llm_call_local', 'llm_call_cloud', 'api_call_external', 'telegram_send'],
-        denied: ['deploy', 'git_push', 'stripe_write', 'env_modify'],
-        scope: 'Video pipeline orchestration. Coordinates all SCS-001 agents.',
-        max_model_tier: 'cloud',
-    },
-    {
-        agent_id: 'scs001-discovery', display_name: 'SCS-001 Discovery', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'api_call_external', 'youtube_read'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Discover trending topics and YouTube clips.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-clip-detection', display_name: 'SCS-001 Clip Detection', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Detect and score clips from downloaded videos.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'scs001-insight', display_name: 'SCS-001 Insight', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'llm_call_local', 'llm_call_cloud'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Generate insight briefs from qualified clips.',
-        max_model_tier: 'cloud',
-    },
-    {
-        agent_id: 'scs001-script', display_name: 'SCS-001 Script', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'llm_call_local', 'llm_call_cloud', 'script_generate'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Generate video scripts from insight briefs. LLM rewrite.',
-        max_model_tier: 'cloud',
-    },
-    {
-        agent_id: 'scs001-script-validator', display_name: 'SCS-001 Script Validator', tier: 'T1',
-        capabilities: ['read_files'],
-        denied: ['write_files', 'shell_exec', 'deploy'],
-        scope: 'Validate script bundles for quality and format compliance.',
-        max_model_tier: 'nano',
-    },
-    {
-        agent_id: 'scs001-scorer', display_name: 'SCS-001 Scorer', tier: 'T1',
-        capabilities: ['read_files', 'write_files'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Score content quality and viral potential.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-editing', display_name: 'SCS-001 Editing', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'shell_exec', 'video_composite', 'tts_generate'],
-        denied: ['deploy', 'git_push', 'api_call_external'],
-        scope: 'Video editing, FFmpeg composition, TTS generation.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-caption', display_name: 'SCS-001 Caption', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'shell_exec', 'video_composite'],
-        denied: ['deploy', 'git_push'],
-        scope: 'Burn captions and subtitles into video.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-qc', display_name: 'SCS-001 QC', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Quality control checks on finished videos.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'scs001-publishing', display_name: 'SCS-001 Publishing', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'api_call_external', 'tiktok_post', 'telegram_send'],
-        denied: ['shell_exec', 'deploy', 'git_push'],
-        scope: 'Publish videos to TikTok and notify via Telegram.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-hosting', display_name: 'SCS-001 Hosting', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'api_call_external'],
-        denied: ['shell_exec', 'deploy', 'git_push'],
-        scope: 'Upload and host video files.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-analytics', display_name: 'SCS-001 Analytics', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'db_query', 'api_call_external'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'View analytics, engagement metrics, performance tracking.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-trend', display_name: 'SCS-001 Trend', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'api_call_external', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'db_write'],
-        scope: 'Track trending topics across platforms.',
-        max_model_tier: 'power',
-    },
-    {
-        agent_id: 'scs001-experiment', display_name: 'SCS-001 Experiment', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'A/B testing framework for content optimization.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-flywheel', display_name: 'SCS-001 Flywheel', tier: 'T2',
-        capabilities: ['read_files', 'write_files', 'llm_call_local'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Content flywheel optimization and feedback loops.',
-        max_model_tier: 'local',
-    },
-    {
-        agent_id: 'scs001-failure-library', display_name: 'SCS-001 Failure Library', tier: 'T1',
-        capabilities: ['read_files', 'write_files'],
-        denied: ['shell_exec', 'deploy', 'api_call_external'],
-        scope: 'Track and learn from pipeline failures.',
-        max_model_tier: 'nano',
-    },
-    {
-        agent_id: 'scs001-viral-downloader', display_name: 'SCS-001 Viral Downloader', tier: 'T3',
-        capabilities: ['read_files', 'write_files', 'api_call_external', 'shell_exec'],
-        denied: ['deploy', 'git_push', 'db_write'],
-        scope: 'Download viral video clips for analysis. Shell for yt-dlp.',
-        max_model_tier: 'local',
-    },
-];
-// ── Public API ────────────────────────────────────────────────────────
-/** Get all registered agents */
-function getAllAgents() {
-    return [...REGISTRY];
-}
-/** Get a specific agent by ID */
-function getAgent(agentId) {
-    return REGISTRY.find(a => a.agent_id === agentId);
-}
-/** Check if an agent has a specific capability */
-function checkCapability(agentId, capability) {
-    const agent = getAgent(agentId);
-    if (!agent) {
-        return { allowed: false, agent_id: agentId, capability, reason: `Agent "${agentId}" not registered in ACP` };
-    }
-    // Explicit denials always override
-    if (agent.denied.includes(capability)) {
-        return { allowed: false, agent_id: agentId, capability, reason: `Capability "${capability}" explicitly denied for ${agent.display_name}` };
-    }
-    // Check if capability is in agent's granted list
-    if (agent.capabilities.includes(capability)) {
-        return { allowed: true, agent_id: agentId, capability, reason: `Capability "${capability}" granted to ${agent.display_name}` };
-    }
-    return { allowed: false, agent_id: agentId, capability, reason: `Capability "${capability}" not declared for ${agent.display_name}` };
-}
-/** Check multiple capabilities at once */
-function checkCapabilities(agentId, capabilities) {
-    return capabilities.map(cap => checkCapability(agentId, cap));
-}
-/** Get all agents with a specific capability */
-function getAgentsWithCapability(capability) {
-    return REGISTRY.filter(a => a.capabilities.includes(capability) && !a.denied.includes(capability));
-}
-/** Get the tier for a capability */
-function getCapabilityTier(capability) {
-    for (const [tier, caps] of Object.entries(TIER_CAPABILITIES)) {
-        if (caps.includes(capability))
-            return tier;
-    }
-    return undefined;
-}
-/** Validate that a sprint's task assignments respect ACP */
-function validateSprintAssignments(tasks) {
-    const violations = [];
-    for (const task of tasks) {
-        for (const cap of task.required_capabilities) {
-            const result = checkCapability(task.agent, cap);
-            if (!result.allowed)
-                violations.push(result);
-        }
-    }
-    return { valid: violations.length === 0, violations };
-}
-/** Get summary stats */
-function getRegistryStats() {
-    const byTier = { T1: 0, T2: 0, T3: 0, T4: 0 };
-    let scs001 = 0;
-    for (const a of REGISTRY) {
-        byTier[a.tier]++;
-        if (a.agent_id.startsWith('scs001-'))
-            scs001++;
-    }
-    return {
-        total_agents: REGISTRY.length,
-        by_tier: byTier,
-        kognai_agents: REGISTRY.length - scs001,
-        scs001_agents: scs001,
-    };
-}

package/dist/orchestrator-core/src/lib/engine-paths.d.ts

@@ -1,13 +0,0 @@
-export interface EnginePaths {
-    root: string;
-    swarmState: string;
-    sprints: string;
-    failureLibrary: string;
-    ksl: string;
-    logs: string;
-}
-/**
- * Resolve all engine paths from a root. Precedence: explicit arg → KOGNAI_ROOT
- * env → process.cwd(). Individual dirs accept env overrides for non-standard layouts.
- */
-export declare function resolveEnginePaths(root?: string): EnginePaths;

package/dist/orchestrator-core/src/lib/engine-paths.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveEnginePaths = resolveEnginePaths;
-/**
- * engine-paths.ts — TICKET-215 Phase 3: the path-parameterization seam.
- *
- * The core engine historically hardcoded repo-specific paths (.swarm-state,
- * data/failure-library, workspace/sprints, …) via `resolve(__dirname, '../../…')`,
- * which only works when the code physically lives in the consuming repo. That
- * coupling is what blocked packaging the engine.
- *
- * This module centralizes every repo-specific path behind a single resolver,
- * defaulted from `KOGNAI_ROOT` (or `process.cwd()`) so behavior is unchanged when
- * the engine runs from a product repo root — but now overridable, so the same
- * package can serve Kognai, Voxight, and Invoica from their own roots.
- */
-const path_1 = require("path");
-/**
- * Resolve all engine paths from a root. Precedence: explicit arg → KOGNAI_ROOT
- * env → process.cwd(). Individual dirs accept env overrides for non-standard layouts.
- */
-function resolveEnginePaths(root) {
-    const r = root || process.env.KOGNAI_ROOT || process.cwd();
-    return {
-        root: r,
-        swarmState: process.env.KOGNAI_SWARM_STATE || (0, path_1.join)(r, '.swarm-state'),
-        sprints: process.env.KOGNAI_SPRINTS_DIR || (0, path_1.join)(r, 'workspace', 'sprints'),
-        failureLibrary: process.env.KOGNAI_FAILURE_DIR || (0, path_1.join)(r, 'data', 'failure-library'),
-        ksl: process.env.KOGNAI_KSL_DIR || (0, path_1.join)(r, 'workspace', 'ksl'),
-        logs: process.env.KOGNAI_LOGS_DIR || (0, path_1.join)(r, 'logs'),
-    };
-}

package/dist/orchestrator-core/src/lib/model-router-contract.d.ts

@@ -1,91 +0,0 @@
-/**
- * model-router-contract.ts — TICKET-215 Wave C: the engine's model-routing SEAM.
- *
- * This is the zero-dep interface that decouples the orchestrator from any
- * concrete router. The orchestrator depends ONLY on this contract; the actual
- * implementation is injected at startup (see model-router-registry.ts).
- *
- * WHY: ClawRouter v2 (the production router) imports `viem` for on-chain x402
- * payments. We do NOT want `viem` in @kognai/orchestrator-core — that would make
- * every adopter (e.g. Invoica, which never routes on-chain) carry web3. So the
- * viem-backed router lives OUTSIDE core (Kognai injects it); products that don't
- * route on-chain inject their own / use a local default. viem stays absent from
- * core's dependency tree entirely.
- *
- * These request/response types are the canonical source of truth — clawrouter-v2
- * imports them from here and re-exports for back-compat.
- */
-export type TierClass = 'text' | 'creative';
-export type TextComplexity = 'nano' | 'local' | 'power' | 'exec' | 'apex';
-export type CreativeModality = 'image' | 'video' | 'speech' | 'music' | 'transcription' | 'visual_understanding';
-export type CreativeQuality = 'fast' | 'high' | 'emotional';
-export interface ClawRouterV2Request {
-    task_type: string;
-    tier_class: TierClass;
-    complexity?: TextComplexity;
-    modality?: CreativeModality;
-    quality?: CreativeQuality;
-    context_tokens: number;
-    constitutional_flag: boolean;
-    agent_id: string;
-    payload: {
-        system?: string;
-        prompt?: string;
-        messages?: Array<{
-            role: string;
-            content: string;
-        }>;
-        [key: string]: any;
-    };
-}
-export interface ClawRouterV2Response {
-    content: string;
-    model: string;
-    tier: string;
-    local: boolean;
-    cost_usd: number;
-    input_tokens: number;
-    output_tokens: number;
-    qcg_compressed: boolean;
-    tokens_saved_by_qcg: number;
-    agent_id: string;
-    task_type: string;
-    timestamp: string;
-}
-export interface CallLLMOptions {
-    systemPrompt?: string;
-    complexity?: TextComplexity;
-    constitutional?: boolean;
-    agentId?: string;
-    taskType?: string;
-    maxTokens?: number;
-}
-export interface CallLLMResult {
-    content: string;
-    model: string;
-    tier: string;
-    cost_usd: number;
-}
-export interface HealthCheckResult {
-    ollama: boolean;
-    gateway: boolean;
-    models: string[];
-}
-export interface DailyCostDigest {
-    total_usd: number;
-    by_tier: Record<string, number>;
-    by_agent: Record<string, number>;
-    tokens_saved_by_qcg: number;
-    call_count: number;
-}
-/**
- * The single door every LLM call passes through (Execution Protocol §17).
- * Implementations: Kognai's viem-backed ClawRouter v2 (injected), a future
- * local-only default, or any product-specific router.
- */
-export interface ModelRouter {
-    routeCall(req: ClawRouterV2Request): Promise<ClawRouterV2Response>;
-    callLLM(prompt: string, opts?: CallLLMOptions): Promise<CallLLMResult>;
-    healthCheck(): Promise<HealthCheckResult>;
-    getDailyCostDigest(): DailyCostDigest;
-}

package/dist/orchestrator-core/src/lib/model-router-contract.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * model-router-contract.ts — TICKET-215 Wave C: the engine's model-routing SEAM.
- *
- * This is the zero-dep interface that decouples the orchestrator from any
- * concrete router. The orchestrator depends ONLY on this contract; the actual
- * implementation is injected at startup (see model-router-registry.ts).
- *
- * WHY: ClawRouter v2 (the production router) imports `viem` for on-chain x402
- * payments. We do NOT want `viem` in @kognai/orchestrator-core — that would make
- * every adopter (e.g. Invoica, which never routes on-chain) carry web3. So the
- * viem-backed router lives OUTSIDE core (Kognai injects it); products that don't
- * route on-chain inject their own / use a local default. viem stays absent from
- * core's dependency tree entirely.
- *
- * These request/response types are the canonical source of truth — clawrouter-v2
- * imports them from here and re-exports for back-compat.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/orchestrator-core/src/lib/wallet-state.d.ts

@@ -1,26 +0,0 @@
-/**
- * wallet-state.ts — CFO budget tracking for ClawRouter spend
- *
- * Accumulates spend from ClawRouter X-Payment-Amount headers.
- * Enforces degraded (≥80%) and frozen (≥95%) modes to protect the wallet.
- * Persists to logs/wallet/state.json across sprint runs.
- *
- * TICKET-215 Phase 3b-3 (Wave B): KOGNAI_ROOT now resolves via engine-paths
- * (KOGNAI_ROOT / cwd) instead of `resolve(__dirname, '../..')`, so the bank
- * state layer is location-independent and ships in @kognai/orchestrator-core.
- * When run from a product repo root, resolveEnginePaths().root === the old
- * __dirname/../.. — same <root>/logs/wallet/state.json, no behavior change.
- */
-export interface WalletState {
-    monthlyBudget: number;
-    spentThisMonth: number;
-    callCount: number;
-    remaining: number;
-    burnPct: number;
-    isDegraded: boolean;
-    isFrozen: boolean;
-}
-export declare function getWalletState(): WalletState;
-export declare function recordSpend(costUsdc: number): void;
-export declare function resetWallet(): void;
-export declare function logWalletStatus(): void;

package/dist/orchestrator-core/src/lib/wallet-state.js

@@ -1,85 +0,0 @@
-"use strict";
-/**
- * wallet-state.ts — CFO budget tracking for ClawRouter spend
- *
- * Accumulates spend from ClawRouter X-Payment-Amount headers.
- * Enforces degraded (≥80%) and frozen (≥95%) modes to protect the wallet.
- * Persists to logs/wallet/state.json across sprint runs.
- *
- * TICKET-215 Phase 3b-3 (Wave B): KOGNAI_ROOT now resolves via engine-paths
- * (KOGNAI_ROOT / cwd) instead of `resolve(__dirname, '../..')`, so the bank
- * state layer is location-independent and ships in @kognai/orchestrator-core.
- * When run from a product repo root, resolveEnginePaths().root === the old
- * __dirname/../.. — same <root>/logs/wallet/state.json, no behavior change.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWalletState = getWalletState;
-exports.recordSpend = recordSpend;
-exports.resetWallet = resetWallet;
-exports.logWalletStatus = logWalletStatus;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const engine_paths_1 = require("./engine-paths");
-const KOGNAI_ROOT = (0, engine_paths_1.resolveEnginePaths)().root;
-const STATE_FILE = (0, path_1.resolve)(KOGNAI_ROOT, 'logs/wallet/state.json');
-const DEFAULT_BUDGET = parseFloat(process.env.CEO_WALLET_BUDGET_USDC || '25'); // $25/month default
-function loadState() {
-    if ((0, fs_1.existsSync)(STATE_FILE)) {
-        try {
-            const raw = JSON.parse((0, fs_1.readFileSync)(STATE_FILE, 'utf8'));
-            // Auto-reset on new month
-            const lastReset = new Date(raw.lastReset);
-            const now = new Date();
-            if (lastReset.getMonth() !== now.getMonth() || lastReset.getFullYear() !== now.getFullYear()) {
-                return freshState();
-            }
-            return raw;
-        }
-        catch { /* fall through */ }
-    }
-    return freshState();
-}
-function freshState() {
-    return {
-        monthlyBudget: DEFAULT_BUDGET,
-        spentThisMonth: 0,
-        callCount: 0,
-        lastReset: new Date().toISOString(),
-    };
-}
-function saveState(data) {
-    try {
-        (0, fs_1.mkdirSync)((0, path_1.resolve)(KOGNAI_ROOT, 'logs/wallet'), { recursive: true });
-        (0, fs_1.writeFileSync)(STATE_FILE, JSON.stringify(data, null, 2), 'utf8');
-    }
-    catch { /* non-fatal */ }
-}
-// Singleton
-let _state = loadState();
-function getWalletState() {
-    const remaining = Math.max(0, _state.monthlyBudget - _state.spentThisMonth);
-    const burnPct = (_state.spentThisMonth / _state.monthlyBudget) * 100;
-    return {
-        monthlyBudget: _state.monthlyBudget,
-        spentThisMonth: _state.spentThisMonth,
-        callCount: _state.callCount,
-        remaining,
-        burnPct,
-        isDegraded: burnPct >= 80,
-        isFrozen: burnPct >= 95,
-    };
-}
-function recordSpend(costUsdc) {
-    _state.spentThisMonth += costUsdc;
-    _state.callCount += 1;
-    saveState(_state);
-}
-function resetWallet() {
-    _state = freshState();
-    saveState(_state);
-}
-function logWalletStatus() {
-    const s = getWalletState();
-    const status = s.isFrozen ? '🔴 FROZEN' : s.isDegraded ? '🟡 DEGRADED' : '🟢 OK';
-    console.log(`  💳 Wallet ${status}: $${s.spentThisMonth.toFixed(4)}/$${s.monthlyBudget} (${s.burnPct.toFixed(1)}%)`);
-}