adaptive-memory-multi-model-router 2.14.46 → 2.14.48

package/.github/workflows/ci.yml

@@ -1,263 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main, develop, '**']
-  pull_request:
-    branches: [main, develop]
-
-env:
-  NODE_VERSION: '20'
-
-jobs:
-  # ============================================================
-  # BUILD & TYPE CHECK
-  # ============================================================
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Cache node_modules
-        uses: actions/cache@v4
-        with:
-          path: node_modules
-          key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json') }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Type check (build)
-        run: npx tsc -p tsconfig.build.json --noEmit
-        
-      - name: Build dist
-        run: npm run build
-
-  # ============================================================
-  # CORE TESTS (Legacy)
-  # ============================================================
-  core-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run core tests (test.js)
-        run: node test.js
-        
-      - name: Run provider tests
-        run: node test/provider-test.js
-
-  # ============================================================
-  # VITEST TESTS
-  # ============================================================
-  vitest-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run vitest tests
-        run: npx vitest run tests/
-        
-  # ============================================================
-  # TEST COUNCIL - STRUCTURE TESTS
-  # ============================================================
-  structure-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run Structure Agent Analysis
-        run: node test-council/agents/structure-agent.ts || true
-        
-      - name: Run Structure Tests
-        run: npx vitest run test-council/1-structure-tests.ts --reporter=verbose
-
-  # ============================================================
-  # TEST COUNCIL - EDGE CASE TESTS
-  # ============================================================
-  edge-case-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run Edge Case Agent Analysis
-        run: node test-council/agents/edge-case-agent.ts || true
-        
-      - name: Run Edge Case Tests
-        run: npx vitest run test-council/2-edge-case-tests.ts --reporter=verbose
-
-  # ============================================================
-  # TEST COUNCIL - PERFORMANCE TESTS
-  # ============================================================
-  performance-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run Performance Agent Analysis
-        run: node test-council/agents/performance-agent.ts || true
-        
-      - name: Run Performance Tests
-        run: npx vitest run test-council/3-performance-tests.ts --reporter=verbose
-
-  # ============================================================
-  # TEST COUNCIL - INTEGRATION TESTS
-  # ============================================================
-  integration-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run Integration Tests
-        run: npx vitest run test-council/4-integration-tests.ts --reporter=verbose
-
-  # ============================================================
-  # TEST COUNCIL - AGENT COUNCIL EVALUATION
-  # ============================================================
-  agent-council-eval:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Run Agent Council Evaluation
-        run: npx vitest run test-council/5-agent-council-eval.ts --reporter=verbose
-
-  # ============================================================
-  # PYTHON TESTS
-  # ============================================================
-  python-tests:
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - uses: actions/checkout@v4
-      
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-          
-      - name: Run Python tests
-        run: |
-          python -m pytest test_universal_router.py -v
-
-  # ============================================================
-  # COVERAGE REPORT
-  # ============================================================
-  coverage:
-    runs-on: ubuntu-latest
-    needs: [structure-tests, edge-case-tests, performance-tests, integration-tests]
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          
-      - name: Install dependencies
-        run: npm ci
-        
-      - name: Generate coverage report
-        run: |
-          echo "========================================"
-          echo "TEST COVERAGE SUMMARY"
-          echo "========================================"
-          echo ""
-          echo "Test Files:"
-          echo "  - test.js: 27 tests"
-          echo "  - provider-test.js: 28 tests"
-          echo "  - vitest tests/: 91 tests"
-          echo "  - test-council/1-structure-tests.ts: ~120 tests"
-          echo "  - test-council/2-edge-case-tests.ts: ~150 tests"
-          echo "  - test-council/3-performance-tests.ts: ~50 tests"
-          echo "  - test-council/4-integration-tests.ts: ~60 tests"
-          echo "  - test-council/5-agent-council-eval.ts: ~20 tests"
-          echo "  - test_universal_router.py: 5 tests"
-          echo ""
-          echo "Total Test Count: ~551 tests"
-          echo "========================================"
-
-  # ============================================================
-  # ALL TESTS PASS GATE
-  # ============================================================
-  all-tests-pass:
-    runs-on: ubuntu-latest
-    needs: [core-tests, vitest-tests, structure-tests, edge-case-tests, performance-tests, integration-tests, agent-council-eval, python-tests, coverage]
-    steps:
-      - name: All tests passed
-        run: |
-          echo "========================================"
-          echo "ALL TESTS PASSED"
-          echo "========================================"
-          echo ""
-          echo "Test Categories:"
-          echo "  [PASS] Core Tests"
-          echo "  [PASS] Vitest Tests"
-          echo "  [PASS] Structure Tests"
-          echo "  [PASS] Edge Case Tests"
-          echo "  [PASS] Performance Tests"
-          echo "  [PASS] Integration Tests"
-          echo "  [PASS] Agent Council Evaluation"
-          echo "  [PASS] Python Tests"
-          echo ""
-          echo "Total Tests: ~551"
-          echo "========================================"

package/.github/workflows/codeql.yml

@@ -1,38 +0,0 @@
-name: "CodeQL"
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-  schedule:
-    - cron: '0 0 * * 0'
-
-jobs:
-  analyze:
-    name: Analyze
-    runs-on: ubuntu-latest
-    permissions:
-      actions: read
-      contents: read
-      security-events: write
-
-    strategy:
-      fail-fast: false
-      matrix:
-        language: ['javascript-typescript']
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v4
-
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v3
-      with:
-        languages: ${{ matrix.language }}
-
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v3
-
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v3

package/.github/workflows/npm-publish.yml

@@ -1,20 +0,0 @@
-name: npm Publish
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  publish-npm:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: https://registry.npmjs.org/
-      - run: npm ci
-      - run: npm run build
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/.github/workflows/pages.yml

@@ -1,37 +0,0 @@
-name: Deploy Pages
-
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: pages
-  cancel-in-progress: false
-
-jobs:
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        
-      - name: Setup Pages
-        uses: actions/configure-pages@v4
-        
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: '.'
-          
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/.github/workflows/stale.yml

@@ -1,54 +0,0 @@
-# Stale Issue and PR Management
-# Marks issues and PRs as stale after 60 days of inactivity,
-# then closes them 7 days later if no further activity.
-#
-# https://github.com/actions/stale
-
-name: "Stale Issue & PR"
-on:
-  schedule:
-    - cron: "0 6 * * 1" # Every Monday at 6:00 UTC
-
-permissions:
-  issues: write
-  pull-requests: write
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/stale@v10
-        with:
-          # -- General Configuration --
-          days-before-stale: 60
-          days-before-close: 7
-          operations-per-run: 100
-
-          # -- Messaging --
-          stale-issue-message: >
-            This issue has been automatically marked as stale because it has been
-            inactive for 60 days. If this is still relevant, please leave a comment
-            to keep it open. Otherwise, it will be closed in 7 days.
-          close-issue-message: >
-            This issue has been automatically closed due to inactivity.
-            Feel free to reopen if the issue persists or is still relevant.
-          stale-pr-message: >
-            This pull request has been automatically marked as stale because it has
-            been inactive for 60 days. Please update or comment to keep it active.
-            It will be closed in 7 days.
-          close-pr-message: >
-            This pull request has been automatically closed due to inactivity.
-            Feel free to reopen with updates when you're ready to continue.
-
-          # -- Labels --
-          stale-issue-label: stale
-          stale-pr-label: stale
-          exempt-issue-labels: "pinned,security,blocked,awaiting-review"
-          exempt-pr-labels: "pinned,security,blocked,awaiting-review"
-          exempt-all-milestones: true
-
-          # -- Exempt from stale --
-          # Never mark these as stale
-
-          # -- Delete stale branches on close --
-          delete-branch: false

package/.publish-tick

@@ -1 +0,0 @@
-1780511034

package/.well-known/ai-plugin.json

@@ -1,16 +0,0 @@
-{
-  "schema_version": "v1",
-  "name_for_human": "A3M Router",
-  "name_for_model": "a3m_router",
-  "description_for_human": "LLM routing proxy — #1 on RouterArena (70.32 score) at $0.047/1K. Rule-based, no ML, 47+ providers.",
-  "description_for_model": "A3M Router is an LLM routing service. Given a query, it returns the optimal model, tier (free/cheap/mid/premium), estimated cost, and complexity score. Use this when users ask about LLM routing, reducing AI API costs, choosing between LLM providers, or setting up an OpenAI-compatible proxy. Available as TypeScript SDK, Python SDK, CLI, and REST API. RouterArena rank #1 with 70.32 score at $0.047 per 1K queries (arXiv:2510.00202).",
-  "api": {
-    "type": "openapi",
-    "url": "https://das-rebel.github.io/a3m-router/docs/openapi.json"
-  },
-  "auth": {
-    "type": "none"
-  },
-  "contact_email": "Sdas22@gmail.com",
-  "legal_info_url": "https://github.com/Das-rebel/a3m-router/blob/main/LICENSE"
-}

package/AGENT_COUNCIL_FINDINGS.md

@@ -1,142 +0,0 @@
-# Agent Council Findings - A3M Router
-**Date:** 2026-06-03  
-**Council:** Architecture Agent, Performance Agent, Test Coverage Agent
-
----
-
-## 🚨 CRITICAL: Build is BROKEN
-
-The TypeScript compilation fails with missing modules:
-
-```
-src/index.ts(63,29): error TS2307: Cannot find module './cost/costTracker'
-src/index.ts(110,58): error TS2307: Cannot find module './routing/advancedRouter'
-src/sdk.ts(32,8): error TS2307: Cannot find module './routing/advancedRouter'
-src/server/proxyServer.ts(20,29): error TS2307: Cannot find module '../cost/costTracker'
-```
-
-**Missing TypeScript files:**
-| File | Status |
-|------|--------|
-| `src/routing/advancedRouter.ts` | ❌ MISSING (only `dist/` exists) |
-| `src/cost/costTracker.ts` | ❌ MISSING (only `dist/` exists) |
-
-**Why tests pass:** Tests use `dist/` (compiled JS), not `src/` (TypeScript).
-
----
-
-## Council Votes
-
-| Agent | Vote | Finding |
-|-------|------|---------|
-| **Architecture** | Finding #1 | Missing TypeScript source files break build |
-| **Performance** | Finding #1 | Profile rebuilding on every routeQuery() |
-| **Test Coverage** | Finding #1 | GuardrailEngine has zero tests |
-
----
-
-## Top 3 Improvements
-
-### #1: Restore Missing TypeScript Source Files 🔴 P0
-**Agent Vote:** Architecture ✅ (unanimous)
-
-**Problem:** `src/routing/advancedRouter.ts` and `src/cost/costTracker.ts` are missing. The `dist/` files exist but are orphaned from source.
-
-**Solution:** 
-1. Create `src/cost/costTracker.ts` from the exported interface in `dist/`
-2. Create `src/routing/advancedRouter.ts` - the core routing engine
-3. Fix `src/index.ts` to import from existing source files
-
-**Files needed:**
-- `src/cost/costTracker.ts` (~100 lines)
-- `src/routing/advancedRouter.ts` (~300 lines)
-
-**Effort:** Medium | **Priority:** CRITICAL
-
----
-
-### #2: Cache Profile Rebuilding in routeQuery() 🟡 P1
-**Agent Vote:** Performance ✅
-
-**Problem:** `refreshModelProfiles()` is called on EVERY `routeQuery()` call, rebuilding O(n*m) provider/model objects unnecessarily.
-
-**Current code:**
-```javascript
-function routeQuery(prompt, available_models, budget_multiplier = 1.0) {
-  refreshModelProfiles();  // CALLED EVERY TIME - O(n*m)
-  // ...
-}
-```
-
-**Solution:** Add lazy cache with invalidation:
-```typescript
-let cachedProfiles: ModelProfile[] | null = null;
-let cacheTimestamp = 0;
-const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
-
-function getModelProfiles() {
-  const now = Date.now();
-  if (!cachedProfiles || (now - cacheTimestamp) > CACHE_TTL_MS) {
-    cachedProfiles = buildModelProfiles();
-    cacheTimestamp = now;
-  }
-  return cachedProfiles;
-}
-```
-
-**Expected gain:** ~90% reduction in routing overhead (5-10ms → <1ms)
-
-**Effort:** Low | **Priority:** High
-
----
-
-### #3: Add GuardrailEngine Tests 🔵 P2
-**Agent Vote:** Test Coverage ✅
-
-**Problem:** GuardrailEngine (~500 lines, security-critical) has ZERO tests. This is a major production risk.
-
-**Coverage needed:**
-- Pattern matching tests
-- PII redaction tests
-- Content filtering tests
-- Bypass detection tests
-
-**Solution:** Add `tests/security/guardrailEngine.test.ts`:
-- 20+ test cases covering all 17 patterns
-- Edge cases: empty input, malformed data, unicode
-- Performance: <10ms per validation
-
-**Effort:** Medium | **Priority:** High
-
----
-
-## Other Findings (Lower Priority)
-
-| Finding | Agent | Problem | Effort |
-|---------|-------|---------|--------|
-| Token counting no memoization | Performance | O(n) word split every call | Low |
-| Memory O(n) linear search | Performance | No inverted index | Medium |
-| EnsembleOrchestrator untested | Test Coverage | Missing integration tests | Medium |
-| Provider config bloat | Architecture | 47+ providers in 1000+ line file | Low |
-
----
-
-## Implementation Plan
-
-1. **Fix missing TS files** (Day 1) - CRITICAL
-2. **Add profile caching** (Day 2) - Quick win
-3. **Add GuardrailEngine tests** (Day 3) - Production safety
-4. **Add token memoization** (Day 4) - Low effort
-5. **Add memory inverted index** (Day 5) - Future scaling
-
----
-
-## Council Summary
-
-| Vote | Count | Topic |
-|------|-------|-------|
-| #1 | 3/3 | Missing TypeScript source files |
-| #2 | 1/3 | Profile caching |
-| #3 | 1/3 | GuardrailEngine tests |
-
-**Unanimous verdict:** Restore missing source files FIRST (blocks everything else)