@antseed/router-local-proxy 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# @antseed/router-local-proxy
+
+Local HTTP proxy router for AI coding tools. Drop-in replacement for `ANTHROPIC_BASE_URL` or `OPENAI_BASE_URL` that routes requests through the Antseed P2P network.
+
+## Installation
+
+```bash
+antseed plugin add @antseed/router-local-proxy
+```
+
+## Usage
+
+```bash
+antseed connect --router local-proxy
+
+# Then configure your tools:
+export ANTHROPIC_BASE_URL=http://localhost:8377
+```
+
+Works with Claude Code, Aider, Continue.dev, OpenAI Codex, and any tool that supports custom base URLs.
+
+## Configuration
+
+| Key | Type | Required | Default | Description |
+|-----|------|----------|---------|-------------|
+| `ANTSEED_MIN_REPUTATION` | number | No | 50 | Minimum peer reputation (0-100) |
+| `ANTSEED_PREFERRED_PROVIDERS` | string[] | No | -- | Ordered list of preferred providers |
+| `ANTSEED_MAX_PRICING_JSON` | string | No | -- | Max pricing config as JSON |
+| `ANTSEED_MAX_FAILURES` | number | No | 3 | Max failures before cooldown |
+| `ANTSEED_FAILURE_COOLDOWN_MS` | number | No | 30000 | Cooldown duration after failures (ms) |
+| `ANTSEED_MAX_PEER_STALENESS_MS` | number | No | 300000 | Max age of peer info before deprioritizing |
+
+## Max Pricing
+
+Set maximum prices you're willing to pay:
+
+```bash
+export ANTSEED_MAX_PRICING_JSON='{"defaults":{"inputUsdPerMillion":20,"outputUsdPerMillion":60}}'
+```
+
+Or with per-provider overrides:
+
+```bash
+export ANTSEED_MAX_PRICING_JSON='{"defaults":{"inputUsdPerMillion":20,"outputUsdPerMillion":60},"providers":{"anthropic":{"models":{"claude-sonnet-4-5-20250929":{"inputUsdPerMillion":15,"outputUsdPerMillion":75}}}}}'
+```
+
+## How It Works
+
+Uses `scoreCandidates` and `PeerMetricsTracker` from `@antseed/router-core`. Scores peers on price, latency, capacity, reputation, freshness, and reliability. Enforces max pricing limits and preferred provider ordering. Peers that exceed price limits or fail repeatedly are excluded.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { AntseedRouterPlugin } from '@antseed/node';
+import { formatToolHints } from '@antseed/router-core';
+declare const plugin: AntseedRouterPlugin;
+export default plugin;
+export declare const TOOL_HINTS: import("@antseed/router-core").ToolHint[];
+export { formatToolHints };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAyB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAsH9E,QAAA,MAAM,MAAM,EAAE,mBA0Cb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,eAAO,MAAM,UAAU,2CAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,149 @@
+import { WELL_KNOWN_TOOL_HINTS, formatToolHints } from '@antseed/router-core';
+import { LocalProxyRouter } from './router.js';
+function parseCsvProviders(raw) {
+    if (!raw)
+        return undefined;
+    const parsed = raw
+        .split(',')
+        .map((provider) => provider.trim())
+        .filter((provider) => provider.length > 0);
+    return parsed.length > 0 ? parsed : undefined;
+}
+function isNonNegativeFinite(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+function parseMaxPricingJson(raw) {
+    if (!raw)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('ANTSEED_MAX_PRICING_JSON must be valid JSON');
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('ANTSEED_MAX_PRICING_JSON must be an object');
+    }
+    const root = parsed;
+    const defaults = root['defaults'];
+    if (!defaults || typeof defaults !== 'object' || Array.isArray(defaults)) {
+        throw new Error('ANTSEED_MAX_PRICING_JSON.defaults must be an object');
+    }
+    const input = defaults['inputUsdPerMillion'];
+    const output = defaults['outputUsdPerMillion'];
+    if (!isNonNegativeFinite(input) || !isNonNegativeFinite(output)) {
+        throw new Error('ANTSEED_MAX_PRICING_JSON.defaults must include non-negative inputUsdPerMillion/outputUsdPerMillion');
+    }
+    const result = {
+        defaults: {
+            inputUsdPerMillion: input,
+            outputUsdPerMillion: output,
+        },
+    };
+    const providersRaw = root['providers'];
+    if (providersRaw !== undefined) {
+        if (!providersRaw || typeof providersRaw !== 'object' || Array.isArray(providersRaw)) {
+            throw new Error('ANTSEED_MAX_PRICING_JSON.providers must be an object');
+        }
+        const providersOut = {};
+        for (const [provider, rawProviderConfig] of Object.entries(providersRaw)) {
+            if (!rawProviderConfig || typeof rawProviderConfig !== 'object' || Array.isArray(rawProviderConfig)) {
+                throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider} must be an object`);
+            }
+            const providerObj = rawProviderConfig;
+            const providerOut = {};
+            const providerDefaults = providerObj['defaults'];
+            if (providerDefaults !== undefined) {
+                if (!providerDefaults || typeof providerDefaults !== 'object' || Array.isArray(providerDefaults)) {
+                    throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.defaults must be an object`);
+                }
+                const providerInput = providerDefaults['inputUsdPerMillion'];
+                const providerOutput = providerDefaults['outputUsdPerMillion'];
+                if (!isNonNegativeFinite(providerInput) || !isNonNegativeFinite(providerOutput)) {
+                    throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.defaults must include non-negative inputUsdPerMillion/outputUsdPerMillion`);
+                }
+                providerOut.defaults = {
+                    inputUsdPerMillion: providerInput,
+                    outputUsdPerMillion: providerOutput,
+                };
+            }
+            const modelPricing = providerObj['models'];
+            if (modelPricing !== undefined) {
+                if (!modelPricing || typeof modelPricing !== 'object' || Array.isArray(modelPricing)) {
+                    throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.models must be an object`);
+                }
+                const modelsOut = {};
+                for (const [model, modelPricingRaw] of Object.entries(modelPricing)) {
+                    if (!modelPricingRaw || typeof modelPricingRaw !== 'object' || Array.isArray(modelPricingRaw)) {
+                        throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.models.${model} must be an object`);
+                    }
+                    const modelInput = modelPricingRaw['inputUsdPerMillion'];
+                    const modelOutput = modelPricingRaw['outputUsdPerMillion'];
+                    if (!isNonNegativeFinite(modelInput) || !isNonNegativeFinite(modelOutput)) {
+                        throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.models.${model} must include non-negative inputUsdPerMillion/outputUsdPerMillion`);
+                    }
+                    modelsOut[model] = {
+                        inputUsdPerMillion: modelInput,
+                        outputUsdPerMillion: modelOutput,
+                    };
+                }
+                if (Object.keys(modelsOut).length > 0) {
+                    providerOut.models = modelsOut;
+                }
+            }
+            providersOut[provider] = providerOut;
+        }
+        if (Object.keys(providersOut).length > 0) {
+            result.providers = providersOut;
+        }
+    }
+    return result;
+}
+const plugin = {
+    name: 'local-proxy',
+    displayName: 'Local Proxy',
+    version: '0.1.0',
+    type: 'router',
+    description: 'Local proxy router for Claude Code, Aider, Continue.dev, OpenAI Codex',
+    configSchema: [
+        { key: 'ANTSEED_MIN_REPUTATION', label: 'Min Reputation', type: 'number', required: false, default: 50, description: 'Min peer reputation 0-100' },
+        { key: 'ANTSEED_PREFERRED_PROVIDERS', label: 'Preferred Providers', type: 'string[]', required: false, description: 'Ordered preferred providers' },
+        { key: 'ANTSEED_MAX_PRICING_JSON', label: 'Max Pricing JSON', type: 'string', required: false, description: 'Buyer max pricing JSON' },
+        { key: 'ANTSEED_MAX_FAILURES', label: 'Max Failures', type: 'number', required: false, default: 3, description: 'Max consecutive failures before excluding peer' },
+        { key: 'ANTSEED_FAILURE_COOLDOWN_MS', label: 'Failure Cooldown (ms)', type: 'number', required: false, default: 30000, description: 'Cooldown after repeated failures (ms)' },
+        { key: 'ANTSEED_MAX_PEER_STALENESS_MS', label: 'Max Peer Staleness (ms)', type: 'number', required: false, default: 300000, description: 'Peer staleness horizon (ms)' },
+    ],
+    createRouter(config) {
+        const minReputation = config['ANTSEED_MIN_REPUTATION'] ? parseInt(config['ANTSEED_MIN_REPUTATION'], 10) : undefined;
+        if (minReputation !== undefined && Number.isNaN(minReputation)) {
+            throw new Error('ANTSEED_MIN_REPUTATION must be a valid number');
+        }
+        const preferredProviders = parseCsvProviders(config['ANTSEED_PREFERRED_PROVIDERS']);
+        const maxPricing = parseMaxPricingJson(config['ANTSEED_MAX_PRICING_JSON']);
+        const maxFailures = config['ANTSEED_MAX_FAILURES'] ? parseInt(config['ANTSEED_MAX_FAILURES'], 10) : undefined;
+        if (maxFailures !== undefined && Number.isNaN(maxFailures)) {
+            throw new Error('ANTSEED_MAX_FAILURES must be a valid number');
+        }
+        const failureCooldownMs = config['ANTSEED_FAILURE_COOLDOWN_MS'] ? parseInt(config['ANTSEED_FAILURE_COOLDOWN_MS'], 10) : undefined;
+        if (failureCooldownMs !== undefined && Number.isNaN(failureCooldownMs)) {
+            throw new Error('ANTSEED_FAILURE_COOLDOWN_MS must be a valid number');
+        }
+        const maxPeerStalenessMs = config['ANTSEED_MAX_PEER_STALENESS_MS'] ? parseInt(config['ANTSEED_MAX_PEER_STALENESS_MS'], 10) : undefined;
+        if (maxPeerStalenessMs !== undefined && Number.isNaN(maxPeerStalenessMs)) {
+            throw new Error('ANTSEED_MAX_PEER_STALENESS_MS must be a valid number');
+        }
+        return new LocalProxyRouter({
+            preferredProviders,
+            minReputation,
+            maxPricing,
+            maxFailures,
+            failureCooldownMs,
+            maxPeerStalenessMs,
+        });
+    },
+};
+export default plugin;
+export const TOOL_HINTS = WELL_KNOWN_TOOL_HINTS;
+export { formatToolHints };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/router.d.ts

@@ -0,0 +1,45 @@
+import type { Router, PeerInfo, SerializedHttpRequest } from '@antseed/node';
+import { type TokenPricingUsdPerMillion, type ScoringWeights } from '@antseed/router-core';
+export interface BuyerMaxPricingConfig {
+    defaults: TokenPricingUsdPerMillion;
+    providers?: Record<string, {
+        defaults?: TokenPricingUsdPerMillion;
+        models?: Record<string, TokenPricingUsdPerMillion>;
+    }>;
+}
+export interface LocalProxyRouterConfig {
+    preferredProviders?: string[];
+    minReputation?: number;
+    maxPricing?: BuyerMaxPricingConfig;
+    maxFailures?: number;
+    failureCooldownMs?: number;
+    maxPeerStalenessMs?: number;
+    weights?: Partial<ScoringWeights>;
+    now?: () => number;
+}
+export declare class LocalProxyRouter implements Router {
+    private readonly _preferredProviders;
+    private readonly _minReputation;
+    private readonly _maxPricing;
+    private readonly _maxFailures;
+    private readonly _maxPeerStalenessMs;
+    private readonly _now;
+    private readonly _weights;
+    private readonly _metrics;
+    constructor(config?: LocalProxyRouterConfig);
+    selectPeer(req: SerializedHttpRequest, peers: PeerInfo[]): PeerInfo | null;
+    onResult(peer: PeerInfo, result: {
+        success: boolean;
+        latencyMs: number;
+        tokens: number;
+    }): void;
+    private _effectiveReputation;
+    private _hasReputation;
+    private _extractRequestedModel;
+    private _selectProviderForPeer;
+    private _resolvePeerOfferPrice;
+    private _resolveBuyerMaxPrice;
+    private _isFiniteNonNegative;
+    private _isValidOffer;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,QAAQ,CAAC,EAAE,yBAAyB,CAAC;QACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;KACpD,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAW;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,MAAM,CAAC,EAAE,sBAAsB;IAuB3C,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI;IAmF1E,QAAQ,CACN,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC9D,IAAI;IAOP,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,sBAAsB;IAgC9B,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,aAAa;CAMtB"}

package/dist/router.js

@@ -0,0 +1,197 @@
+import { scoreCandidates, PeerMetricsTracker, } from '@antseed/router-core';
+export class LocalProxyRouter {
+    _preferredProviders;
+    _minReputation;
+    _maxPricing;
+    _maxFailures;
+    _maxPeerStalenessMs;
+    _now;
+    _weights;
+    _metrics;
+    constructor(config) {
+        this._preferredProviders = (config?.preferredProviders ?? [])
+            .map((provider) => provider.trim())
+            .filter((provider) => provider.length > 0);
+        this._minReputation = config?.minReputation ?? 50;
+        this._maxPricing = {
+            defaults: {
+                inputUsdPerMillion: config?.maxPricing?.defaults.inputUsdPerMillion ?? Number.POSITIVE_INFINITY,
+                outputUsdPerMillion: config?.maxPricing?.defaults.outputUsdPerMillion ?? Number.POSITIVE_INFINITY,
+            },
+            ...(config?.maxPricing?.providers ? { providers: config.maxPricing.providers } : {}),
+        };
+        this._maxFailures = Math.max(1, config?.maxFailures ?? 3);
+        this._maxPeerStalenessMs = Math.max(1, config?.maxPeerStalenessMs ?? 300_000);
+        this._now = config?.now ?? (() => Date.now());
+        this._weights = config?.weights;
+        this._metrics = new PeerMetricsTracker({
+            maxFailures: this._maxFailures,
+            failureCooldownMs: Math.max(1, config?.failureCooldownMs ?? 30_000),
+            now: this._now,
+        });
+    }
+    selectPeer(req, peers) {
+        const now = this._now();
+        const requestedModel = this._extractRequestedModel(req);
+        const candidates = [];
+        for (const peer of peers) {
+            // Reputation filter
+            if (this._hasReputation(peer)) {
+                const reputation = this._effectiveReputation(peer);
+                if (reputation < this._minReputation) {
+                    continue;
+                }
+            }
+            // Cooldown filter
+            if (this._metrics.isCoolingDown(peer.peerId)) {
+                continue;
+            }
+            // Provider availability filter
+            const selectedProvider = this._selectProviderForPeer(peer);
+            if (!selectedProvider) {
+                continue;
+            }
+            // Pricing filter
+            const offer = this._resolvePeerOfferPrice(peer, selectedProvider.provider, requestedModel);
+            if (!offer) {
+                continue;
+            }
+            const max = this._resolveBuyerMaxPrice(selectedProvider.provider, requestedModel);
+            if (offer.inputUsdPerMillion > max.inputUsdPerMillion || offer.outputUsdPerMillion > max.outputUsdPerMillion) {
+                continue;
+            }
+            candidates.push({
+                peer,
+                provider: selectedProvider.provider,
+                providerRank: selectedProvider.rank,
+                offer,
+            });
+        }
+        if (candidates.length === 0)
+            return null;
+        // Provider preference filtering
+        let providerFiltered = candidates;
+        if (this._preferredProviders.length > 0) {
+            const bestRank = Math.min(...candidates.map((c) => c.providerRank));
+            providerFiltered = candidates.filter((c) => c.providerRank === bestRank);
+        }
+        if (providerFiltered.length === 1) {
+            return providerFiltered[0].peer;
+        }
+        // Delegate scoring to router-core
+        const scoringInput = providerFiltered.map((c) => ({
+            peer: c.peer,
+            provider: c.provider,
+            providerRank: c.providerRank,
+            offer: c.offer,
+            metrics: this._metrics.getMetrics(c.peer.peerId),
+        }));
+        const scored = scoreCandidates(scoringInput, {
+            now,
+            medianLatency: this._metrics.getMedianLatency(),
+            maxPeerStalenessMs: this._maxPeerStalenessMs,
+            maxFailures: this._maxFailures,
+            weights: this._weights,
+        });
+        return scored[0]?.peer ?? null;
+    }
+    onResult(peer, result) {
+        this._metrics.recordResult(peer.peerId, {
+            success: result.success,
+            latencyMs: result.latencyMs,
+        });
+    }
+    _effectiveReputation(p) {
+        if (p.onChainReputation !== undefined) {
+            return p.onChainReputation;
+        }
+        return p.trustScore ?? p.reputationScore ?? 0;
+    }
+    _hasReputation(p) {
+        if (this._isFiniteNonNegative(p.onChainReputation)) {
+            const sessionCount = this._isFiniteNonNegative(p.onChainSessionCount) ? p.onChainSessionCount : undefined;
+            const disputeCount = this._isFiniteNonNegative(p.onChainDisputeCount) ? p.onChainDisputeCount : undefined;
+            if (sessionCount !== undefined || disputeCount !== undefined) {
+                return (sessionCount ?? 0) > 0 || (disputeCount ?? 0) > 0;
+            }
+            return true;
+        }
+        return this._isFiniteNonNegative(p.trustScore) || this._isFiniteNonNegative(p.reputationScore);
+    }
+    _extractRequestedModel(req) {
+        const contentType = req.headers['content-type'] ?? req.headers['Content-Type'] ?? '';
+        if (!contentType.toLowerCase().includes('application/json')) {
+            return null;
+        }
+        try {
+            const parsed = JSON.parse(new TextDecoder().decode(req.body));
+            if (!parsed || typeof parsed !== 'object') {
+                return null;
+            }
+            const model = parsed['model'];
+            return typeof model === 'string' && model.trim().length > 0 ? model.trim() : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    _selectProviderForPeer(peer) {
+        const availableProviders = peer.providers
+            .map((provider) => provider.trim())
+            .filter((provider) => provider.length > 0);
+        if (this._preferredProviders.length === 0) {
+            const provider = availableProviders[0];
+            return provider ? { provider, rank: Number.MAX_SAFE_INTEGER } : null;
+        }
+        for (let i = 0; i < this._preferredProviders.length; i++) {
+            const preferred = this._preferredProviders[i];
+            if (availableProviders.includes(preferred)) {
+                return { provider: preferred, rank: i };
+            }
+        }
+        return null;
+    }
+    _resolvePeerOfferPrice(peer, provider, model) {
+        const providerPricing = peer.providerPricing?.[provider];
+        if (model) {
+            const modelSpecific = providerPricing?.models?.[model];
+            if (modelSpecific && this._isValidOffer(modelSpecific)) {
+                return modelSpecific;
+            }
+        }
+        const providerDefaults = providerPricing?.defaults;
+        if (providerDefaults && this._isValidOffer(providerDefaults)) {
+            return providerDefaults;
+        }
+        if (this._isFiniteNonNegative(peer.defaultInputUsdPerMillion) &&
+            this._isFiniteNonNegative(peer.defaultOutputUsdPerMillion)) {
+            return {
+                inputUsdPerMillion: peer.defaultInputUsdPerMillion,
+                outputUsdPerMillion: peer.defaultOutputUsdPerMillion,
+            };
+        }
+        return null;
+    }
+    _resolveBuyerMaxPrice(provider, model) {
+        const providerPricing = this._maxPricing.providers?.[provider];
+        if (model) {
+            const modelOverride = providerPricing?.models?.[model];
+            if (modelOverride && this._isValidOffer(modelOverride)) {
+                return modelOverride;
+            }
+        }
+        const providerDefaults = providerPricing?.defaults;
+        if (providerDefaults && this._isValidOffer(providerDefaults)) {
+            return providerDefaults;
+        }
+        return this._maxPricing.defaults;
+    }
+    _isFiniteNonNegative(value) {
+        return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+    }
+    _isValidOffer(offer) {
+        return (this._isFiniteNonNegative(offer.inputUsdPerMillion) &&
+            this._isFiniteNonNegative(offer.outputUsdPerMillion));
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@antseed/router-local-proxy",
+  "version": "0.1.0",
+  "description": "Antseed local proxy router plugin — Claude Code, Aider, Continue.dev",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@antseed/router-core": "workspace:*"
+  },
+  "peerDependencies": {
+    "@antseed/node": ">=0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@antseed/node": "workspace:*"
+  }
+}

package/src/index.ts

@@ -0,0 +1,167 @@
+import type { AntseedRouterPlugin } from '@antseed/node';
+import { WELL_KNOWN_TOOL_HINTS, formatToolHints } from '@antseed/router-core';
+import { LocalProxyRouter, type BuyerMaxPricingConfig } from './router.js';
+
+function parseCsvProviders(raw: string | undefined): string[] | undefined {
+  if (!raw) return undefined;
+  const parsed = raw
+    .split(',')
+    .map((provider) => provider.trim())
+    .filter((provider) => provider.length > 0);
+  return parsed.length > 0 ? parsed : undefined;
+}
+
+function isNonNegativeFinite(value: unknown): value is number {
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+
+function parseMaxPricingJson(raw: string | undefined): BuyerMaxPricingConfig | undefined {
+  if (!raw) return undefined;
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(raw) as unknown;
+  } catch {
+    throw new Error('ANTSEED_MAX_PRICING_JSON must be valid JSON');
+  }
+
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw new Error('ANTSEED_MAX_PRICING_JSON must be an object');
+  }
+
+  const root = parsed as Record<string, unknown>;
+  const defaults = root['defaults'];
+  if (!defaults || typeof defaults !== 'object' || Array.isArray(defaults)) {
+    throw new Error('ANTSEED_MAX_PRICING_JSON.defaults must be an object');
+  }
+
+  const input = (defaults as Record<string, unknown>)['inputUsdPerMillion'];
+  const output = (defaults as Record<string, unknown>)['outputUsdPerMillion'];
+  if (!isNonNegativeFinite(input) || !isNonNegativeFinite(output)) {
+    throw new Error('ANTSEED_MAX_PRICING_JSON.defaults must include non-negative inputUsdPerMillion/outputUsdPerMillion');
+  }
+
+  const result: BuyerMaxPricingConfig = {
+    defaults: {
+      inputUsdPerMillion: input,
+      outputUsdPerMillion: output,
+    },
+  };
+
+  const providersRaw = root['providers'];
+  if (providersRaw !== undefined) {
+    if (!providersRaw || typeof providersRaw !== 'object' || Array.isArray(providersRaw)) {
+      throw new Error('ANTSEED_MAX_PRICING_JSON.providers must be an object');
+    }
+
+    const providersOut: NonNullable<BuyerMaxPricingConfig['providers']> = {};
+    for (const [provider, rawProviderConfig] of Object.entries(providersRaw as Record<string, unknown>)) {
+      if (!rawProviderConfig || typeof rawProviderConfig !== 'object' || Array.isArray(rawProviderConfig)) {
+        throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider} must be an object`);
+      }
+
+      const providerObj = rawProviderConfig as Record<string, unknown>;
+      const providerOut: NonNullable<BuyerMaxPricingConfig['providers']>[string] = {};
+
+      const providerDefaults = providerObj['defaults'];
+      if (providerDefaults !== undefined) {
+        if (!providerDefaults || typeof providerDefaults !== 'object' || Array.isArray(providerDefaults)) {
+          throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.defaults must be an object`);
+        }
+        const providerInput = (providerDefaults as Record<string, unknown>)['inputUsdPerMillion'];
+        const providerOutput = (providerDefaults as Record<string, unknown>)['outputUsdPerMillion'];
+        if (!isNonNegativeFinite(providerInput) || !isNonNegativeFinite(providerOutput)) {
+          throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.defaults must include non-negative inputUsdPerMillion/outputUsdPerMillion`);
+        }
+        providerOut.defaults = {
+          inputUsdPerMillion: providerInput,
+          outputUsdPerMillion: providerOutput,
+        };
+      }
+
+      const modelPricing = providerObj['models'];
+      if (modelPricing !== undefined) {
+        if (!modelPricing || typeof modelPricing !== 'object' || Array.isArray(modelPricing)) {
+          throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.models must be an object`);
+        }
+
+        const modelsOut: NonNullable<BuyerMaxPricingConfig['providers']>[string]['models'] = {};
+        for (const [model, modelPricingRaw] of Object.entries(modelPricing as Record<string, unknown>)) {
+          if (!modelPricingRaw || typeof modelPricingRaw !== 'object' || Array.isArray(modelPricingRaw)) {
+            throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.models.${model} must be an object`);
+          }
+          const modelInput = (modelPricingRaw as Record<string, unknown>)['inputUsdPerMillion'];
+          const modelOutput = (modelPricingRaw as Record<string, unknown>)['outputUsdPerMillion'];
+          if (!isNonNegativeFinite(modelInput) || !isNonNegativeFinite(modelOutput)) {
+            throw new Error(`ANTSEED_MAX_PRICING_JSON.providers.${provider}.models.${model} must include non-negative inputUsdPerMillion/outputUsdPerMillion`);
+          }
+          modelsOut[model] = {
+            inputUsdPerMillion: modelInput,
+            outputUsdPerMillion: modelOutput,
+          };
+        }
+
+        if (Object.keys(modelsOut).length > 0) {
+          providerOut.models = modelsOut;
+        }
+      }
+
+      providersOut[provider] = providerOut;
+    }
+
+    if (Object.keys(providersOut).length > 0) {
+      result.providers = providersOut;
+    }
+  }
+
+  return result;
+}
+
+const plugin: AntseedRouterPlugin = {
+  name: 'local-proxy',
+  displayName: 'Local Proxy',
+  version: '0.1.0',
+  type: 'router',
+  description: 'Local proxy router for Claude Code, Aider, Continue.dev, OpenAI Codex',
+  configSchema: [
+    { key: 'ANTSEED_MIN_REPUTATION', label: 'Min Reputation', type: 'number', required: false, default: 50, description: 'Min peer reputation 0-100' },
+    { key: 'ANTSEED_PREFERRED_PROVIDERS', label: 'Preferred Providers', type: 'string[]', required: false, description: 'Ordered preferred providers' },
+    { key: 'ANTSEED_MAX_PRICING_JSON', label: 'Max Pricing JSON', type: 'string', required: false, description: 'Buyer max pricing JSON' },
+    { key: 'ANTSEED_MAX_FAILURES', label: 'Max Failures', type: 'number', required: false, default: 3, description: 'Max consecutive failures before excluding peer' },
+    { key: 'ANTSEED_FAILURE_COOLDOWN_MS', label: 'Failure Cooldown (ms)', type: 'number', required: false, default: 30000, description: 'Cooldown after repeated failures (ms)' },
+    { key: 'ANTSEED_MAX_PEER_STALENESS_MS', label: 'Max Peer Staleness (ms)', type: 'number', required: false, default: 300000, description: 'Peer staleness horizon (ms)' },
+  ],
+  createRouter(config: Record<string, string>) {
+    const minReputation = config['ANTSEED_MIN_REPUTATION'] ? parseInt(config['ANTSEED_MIN_REPUTATION'], 10) : undefined;
+    if (minReputation !== undefined && Number.isNaN(minReputation)) {
+      throw new Error('ANTSEED_MIN_REPUTATION must be a valid number');
+    }
+    const preferredProviders = parseCsvProviders(config['ANTSEED_PREFERRED_PROVIDERS']);
+    const maxPricing = parseMaxPricingJson(config['ANTSEED_MAX_PRICING_JSON']);
+    const maxFailures = config['ANTSEED_MAX_FAILURES'] ? parseInt(config['ANTSEED_MAX_FAILURES'], 10) : undefined;
+    if (maxFailures !== undefined && Number.isNaN(maxFailures)) {
+      throw new Error('ANTSEED_MAX_FAILURES must be a valid number');
+    }
+    const failureCooldownMs = config['ANTSEED_FAILURE_COOLDOWN_MS'] ? parseInt(config['ANTSEED_FAILURE_COOLDOWN_MS'], 10) : undefined;
+    if (failureCooldownMs !== undefined && Number.isNaN(failureCooldownMs)) {
+      throw new Error('ANTSEED_FAILURE_COOLDOWN_MS must be a valid number');
+    }
+    const maxPeerStalenessMs = config['ANTSEED_MAX_PEER_STALENESS_MS'] ? parseInt(config['ANTSEED_MAX_PEER_STALENESS_MS'], 10) : undefined;
+    if (maxPeerStalenessMs !== undefined && Number.isNaN(maxPeerStalenessMs)) {
+      throw new Error('ANTSEED_MAX_PEER_STALENESS_MS must be a valid number');
+    }
+    return new LocalProxyRouter({
+      preferredProviders,
+      minReputation,
+      maxPricing,
+      maxFailures,
+      failureCooldownMs,
+      maxPeerStalenessMs,
+    });
+  },
+};
+
+export default plugin;
+
+export const TOOL_HINTS = WELL_KNOWN_TOOL_HINTS;
+export { formatToolHints };

package/src/router.test.ts

@@ -0,0 +1,256 @@
+import { describe, it, expect } from 'vitest';
+import type { PeerInfo, SerializedHttpRequest } from '@antseed/node';
+import { LocalProxyRouter } from './router.js';
+
+function makePeer(overrides?: Partial<PeerInfo>): PeerInfo {
+  return {
+    peerId: 'a'.repeat(64) as PeerInfo['peerId'],
+    lastSeen: Date.now(),
+    providers: ['anthropic'],
+    reputationScore: 80,
+    trustScore: 80,
+    defaultInputUsdPerMillion: 10,
+    defaultOutputUsdPerMillion: 10,
+    providerPricing: {
+      anthropic: {
+        defaults: {
+          inputUsdPerMillion: 10,
+          outputUsdPerMillion: 10,
+        },
+      },
+    },
+    maxConcurrency: 10,
+    currentLoad: 1,
+    ...overrides,
+  };
+}
+
+function makeRequest(model?: string): SerializedHttpRequest {
+  const payload = model ? { model } : { messages: [{ role: 'user', content: 'hi' }] };
+  return {
+    requestId: 'req-1',
+    method: 'POST',
+    path: '/v1/messages',
+    headers: { 'content-type': 'application/json' },
+    body: new TextEncoder().encode(JSON.stringify(payload)),
+  };
+}
+
+describe('LocalProxyRouter', () => {
+  it('enforces ordered provider preferences even when lower-ranked provider is cheaper', () => {
+    const router = new LocalProxyRouter({
+      preferredProviders: ['anthropic', 'openai'],
+      maxPricing: {
+        defaults: { inputUsdPerMillion: 1_000, outputUsdPerMillion: 1_000 },
+      },
+    });
+
+    const preferredButExpensive = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      providers: ['anthropic'],
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 100, outputUsdPerMillion: 100 },
+        },
+      },
+      defaultInputUsdPerMillion: 100,
+      defaultOutputUsdPerMillion: 100,
+    });
+    const cheaperLowerRank = makePeer({
+      peerId: '2'.repeat(64) as PeerInfo['peerId'],
+      providers: ['openai'],
+      providerPricing: {
+        openai: {
+          defaults: { inputUsdPerMillion: 1, outputUsdPerMillion: 1 },
+        },
+      },
+      defaultInputUsdPerMillion: 1,
+      defaultOutputUsdPerMillion: 1,
+    });
+
+    const selected = router.selectPeer(makeRequest('claude-sonnet-4-5-20250929'), [cheaperLowerRank, preferredButExpensive]);
+    expect(selected?.peerId).toBe(preferredButExpensive.peerId);
+  });
+
+  it('rejects peers when output price exceeds buyer max even if input is within max', () => {
+    const router = new LocalProxyRouter({
+      maxPricing: {
+        defaults: { inputUsdPerMillion: 50, outputUsdPerMillion: 10 },
+      },
+    });
+
+    const overpricedOutputPeer = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 5, outputUsdPerMillion: 20 },
+        },
+      },
+      defaultInputUsdPerMillion: 5,
+      defaultOutputUsdPerMillion: 20,
+    });
+
+    expect(router.selectPeer(makeRequest('claude-sonnet-4-5-20250929'), [overpricedOutputPeer])).toBeNull();
+  });
+
+  it('uses model-specific seller offer pricing when request model is present', () => {
+    const router = new LocalProxyRouter({
+      maxPricing: {
+        defaults: { inputUsdPerMillion: 1_000, outputUsdPerMillion: 1_000 },
+      },
+    });
+
+    const peerA = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 10, outputUsdPerMillion: 10 },
+          models: {
+            'model-a': { inputUsdPerMillion: 90, outputUsdPerMillion: 90 },
+          },
+        },
+      },
+      defaultInputUsdPerMillion: 10,
+      defaultOutputUsdPerMillion: 10,
+    });
+    const peerB = makePeer({
+      peerId: '2'.repeat(64) as PeerInfo['peerId'],
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 20, outputUsdPerMillion: 20 },
+          models: {
+            'model-a': { inputUsdPerMillion: 5, outputUsdPerMillion: 5 },
+          },
+        },
+      },
+      defaultInputUsdPerMillion: 20,
+      defaultOutputUsdPerMillion: 20,
+    });
+
+    const selected = router.selectPeer(makeRequest('model-a'), [peerA, peerB]);
+    expect(selected?.peerId).toBe(peerB.peerId);
+  });
+
+  it('falls back to provider defaults when request model is absent', () => {
+    const router = new LocalProxyRouter({
+      maxPricing: {
+        defaults: { inputUsdPerMillion: 1_000, outputUsdPerMillion: 1_000 },
+      },
+    });
+
+    const expensiveDefault = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 40, outputUsdPerMillion: 40 },
+          models: {
+            'model-a': { inputUsdPerMillion: 1, outputUsdPerMillion: 1 },
+          },
+        },
+      },
+      defaultInputUsdPerMillion: 40,
+      defaultOutputUsdPerMillion: 40,
+    });
+    const cheapDefault = makePeer({
+      peerId: '2'.repeat(64) as PeerInfo['peerId'],
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 5, outputUsdPerMillion: 5 },
+        },
+      },
+      defaultInputUsdPerMillion: 5,
+      defaultOutputUsdPerMillion: 5,
+    });
+
+    const selected = router.selectPeer(makeRequest(undefined), [expensiveDefault, cheapDefault]);
+    expect(selected?.peerId).toBe(cheapDefault.peerId);
+  });
+
+  it('puts peers on cooldown after failure threshold and re-allows them later', () => {
+    let now = 1_000_000;
+    const router = new LocalProxyRouter({
+      maxFailures: 2,
+      failureCooldownMs: 500,
+      now: () => now,
+    });
+
+    const flaky = makePeer({ peerId: '1'.repeat(64) as PeerInfo['peerId'], lastSeen: now });
+    const fallback = makePeer({ peerId: 'f'.repeat(64) as PeerInfo['peerId'], lastSeen: now });
+
+    router.onResult(flaky, { success: false, latencyMs: 300, tokens: 0 });
+    router.onResult(flaky, { success: false, latencyMs: 300, tokens: 0 });
+
+    // Flaky is cooling down; fallback should be selected.
+    expect(router.selectPeer(makeRequest(), [flaky, fallback])?.peerId).toBe(fallback.peerId);
+
+    now += 501;
+    // Cooldown expired; flaky is allowed again, but still penalized by reliability history.
+    expect(router.selectPeer(makeRequest(), [flaky, fallback])?.peerId).toBe(fallback.peerId);
+    // It should still be selectable when no alternatives exist.
+    expect(router.selectPeer(makeRequest(), [flaky])?.peerId).toBe(flaky.peerId);
+  });
+
+  it('filters out peers below minimum reputation', () => {
+    const router = new LocalProxyRouter({
+      minReputation: 70,
+    });
+
+    const lowRep = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      reputationScore: 40,
+      trustScore: 40,
+    });
+    const highRep = makePeer({
+      peerId: '2'.repeat(64) as PeerInfo['peerId'],
+      reputationScore: 90,
+      trustScore: 90,
+    });
+
+    const selected = router.selectPeer(makeRequest(), [lowRep, highRep]);
+    expect(selected?.peerId).toBe(highRep.peerId);
+  });
+
+  it('keeps peers eligible when reputation fields are missing', () => {
+    const router = new LocalProxyRouter();
+    const unrated = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      reputationScore: undefined,
+      trustScore: undefined,
+      onChainReputation: undefined,
+    });
+
+    const selected = router.selectPeer(makeRequest(), [unrated]);
+    expect(selected?.peerId).toBe(unrated.peerId);
+  });
+
+  it('treats on-chain zero reputation with zero sessions as unrated', () => {
+    const router = new LocalProxyRouter();
+    const newSeller = makePeer({
+      peerId: '3'.repeat(64) as PeerInfo['peerId'],
+      trustScore: 0,
+      reputationScore: undefined,
+      onChainReputation: 0,
+      onChainSessionCount: 0,
+      onChainDisputeCount: 0,
+    });
+
+    const selected = router.selectPeer(makeRequest(), [newSeller]);
+    expect(selected?.peerId).toBe(newSeller.peerId);
+  });
+
+  it('ignores empty provider entries when selecting a peer provider', () => {
+    const router = new LocalProxyRouter();
+    const malformedProviders = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      providers: ['', 'anthropic'],
+    });
+
+    const selected = router.selectPeer(makeRequest(), [malformedProviders]);
+    expect(selected?.peerId).toBe(malformedProviders.peerId);
+  });
+
+  it('returns null when no peers are available', () => {
+    const router = new LocalProxyRouter();
+    expect(router.selectPeer(makeRequest(), [])).toBeNull();
+  });
+});

package/src/router.ts

@@ -0,0 +1,272 @@
+import type { Router, PeerInfo, SerializedHttpRequest } from '@antseed/node';
+import {
+  scoreCandidates,
+  PeerMetricsTracker,
+  type TokenPricingUsdPerMillion,
+  type ScoringWeights,
+} from '@antseed/router-core';
+
+export interface BuyerMaxPricingConfig {
+  defaults: TokenPricingUsdPerMillion;
+  providers?: Record<string, {
+    defaults?: TokenPricingUsdPerMillion;
+    models?: Record<string, TokenPricingUsdPerMillion>;
+  }>;
+}
+
+export interface LocalProxyRouterConfig {
+  preferredProviders?: string[];
+  minReputation?: number;
+  maxPricing?: BuyerMaxPricingConfig;
+  maxFailures?: number;
+  failureCooldownMs?: number;
+  maxPeerStalenessMs?: number;
+  weights?: Partial<ScoringWeights>;
+  now?: () => number;
+}
+
+export class LocalProxyRouter implements Router {
+  private readonly _preferredProviders: string[];
+  private readonly _minReputation: number;
+  private readonly _maxPricing: BuyerMaxPricingConfig;
+  private readonly _maxFailures: number;
+  private readonly _maxPeerStalenessMs: number;
+  private readonly _now: () => number;
+  private readonly _weights: Partial<ScoringWeights> | undefined;
+  private readonly _metrics: PeerMetricsTracker;
+
+  constructor(config?: LocalProxyRouterConfig) {
+    this._preferredProviders = (config?.preferredProviders ?? [])
+      .map((provider) => provider.trim())
+      .filter((provider) => provider.length > 0);
+    this._minReputation = config?.minReputation ?? 50;
+    this._maxPricing = {
+      defaults: {
+        inputUsdPerMillion: config?.maxPricing?.defaults.inputUsdPerMillion ?? Number.POSITIVE_INFINITY,
+        outputUsdPerMillion: config?.maxPricing?.defaults.outputUsdPerMillion ?? Number.POSITIVE_INFINITY,
+      },
+      ...(config?.maxPricing?.providers ? { providers: config.maxPricing.providers } : {}),
+    };
+    this._maxFailures = Math.max(1, config?.maxFailures ?? 3);
+    this._maxPeerStalenessMs = Math.max(1, config?.maxPeerStalenessMs ?? 300_000);
+    this._now = config?.now ?? (() => Date.now());
+    this._weights = config?.weights;
+    this._metrics = new PeerMetricsTracker({
+      maxFailures: this._maxFailures,
+      failureCooldownMs: Math.max(1, config?.failureCooldownMs ?? 30_000),
+      now: this._now,
+    });
+  }
+
+  selectPeer(req: SerializedHttpRequest, peers: PeerInfo[]): PeerInfo | null {
+    const now = this._now();
+    const requestedModel = this._extractRequestedModel(req);
+
+    const candidates: {
+      peer: PeerInfo;
+      provider: string;
+      providerRank: number;
+      offer: TokenPricingUsdPerMillion;
+    }[] = [];
+
+    for (const peer of peers) {
+      // Reputation filter
+      if (this._hasReputation(peer)) {
+        const reputation = this._effectiveReputation(peer);
+        if (reputation < this._minReputation) {
+          continue;
+        }
+      }
+
+      // Cooldown filter
+      if (this._metrics.isCoolingDown(peer.peerId)) {
+        continue;
+      }
+
+      // Provider availability filter
+      const selectedProvider = this._selectProviderForPeer(peer);
+      if (!selectedProvider) {
+        continue;
+      }
+
+      // Pricing filter
+      const offer = this._resolvePeerOfferPrice(peer, selectedProvider.provider, requestedModel);
+      if (!offer) {
+        continue;
+      }
+
+      const max = this._resolveBuyerMaxPrice(selectedProvider.provider, requestedModel);
+      if (offer.inputUsdPerMillion > max.inputUsdPerMillion || offer.outputUsdPerMillion > max.outputUsdPerMillion) {
+        continue;
+      }
+
+      candidates.push({
+        peer,
+        provider: selectedProvider.provider,
+        providerRank: selectedProvider.rank,
+        offer,
+      });
+    }
+
+    if (candidates.length === 0) return null;
+
+    // Provider preference filtering
+    let providerFiltered = candidates;
+    if (this._preferredProviders.length > 0) {
+      const bestRank = Math.min(...candidates.map((c) => c.providerRank));
+      providerFiltered = candidates.filter((c) => c.providerRank === bestRank);
+    }
+
+    if (providerFiltered.length === 1) {
+      return providerFiltered[0]!.peer;
+    }
+
+    // Delegate scoring to router-core
+    const scoringInput = providerFiltered.map((c) => ({
+      peer: c.peer,
+      provider: c.provider,
+      providerRank: c.providerRank,
+      offer: c.offer,
+      metrics: this._metrics.getMetrics(c.peer.peerId),
+    }));
+
+    const scored = scoreCandidates(scoringInput, {
+      now,
+      medianLatency: this._metrics.getMedianLatency(),
+      maxPeerStalenessMs: this._maxPeerStalenessMs,
+      maxFailures: this._maxFailures,
+      weights: this._weights,
+    });
+
+    return scored[0]?.peer ?? null;
+  }
+
+  onResult(
+    peer: PeerInfo,
+    result: { success: boolean; latencyMs: number; tokens: number },
+  ): void {
+    this._metrics.recordResult(peer.peerId, {
+      success: result.success,
+      latencyMs: result.latencyMs,
+    });
+  }
+
+  private _effectiveReputation(p: PeerInfo): number {
+    if (p.onChainReputation !== undefined) {
+      return p.onChainReputation;
+    }
+    return p.trustScore ?? p.reputationScore ?? 0;
+  }
+
+  private _hasReputation(p: PeerInfo): boolean {
+    if (this._isFiniteNonNegative(p.onChainReputation)) {
+      const sessionCount = this._isFiniteNonNegative(p.onChainSessionCount) ? p.onChainSessionCount : undefined;
+      const disputeCount = this._isFiniteNonNegative(p.onChainDisputeCount) ? p.onChainDisputeCount : undefined;
+      if (sessionCount !== undefined || disputeCount !== undefined) {
+        return (sessionCount ?? 0) > 0 || (disputeCount ?? 0) > 0;
+      }
+      return true;
+    }
+
+    return this._isFiniteNonNegative(p.trustScore) || this._isFiniteNonNegative(p.reputationScore);
+  }
+
+  private _extractRequestedModel(req: SerializedHttpRequest): string | null {
+    const contentType = req.headers['content-type'] ?? req.headers['Content-Type'] ?? '';
+    if (!contentType.toLowerCase().includes('application/json')) {
+      return null;
+    }
+
+    try {
+      const parsed = JSON.parse(new TextDecoder().decode(req.body)) as unknown;
+      if (!parsed || typeof parsed !== 'object') {
+        return null;
+      }
+      const model = (parsed as Record<string, unknown>)['model'];
+      return typeof model === 'string' && model.trim().length > 0 ? model.trim() : null;
+    } catch {
+      return null;
+    }
+  }
+
+  private _selectProviderForPeer(peer: PeerInfo): { provider: string; rank: number } | null {
+    const availableProviders = peer.providers
+      .map((provider) => provider.trim())
+      .filter((provider) => provider.length > 0);
+
+    if (this._preferredProviders.length === 0) {
+      const provider = availableProviders[0];
+      return provider ? { provider, rank: Number.MAX_SAFE_INTEGER } : null;
+    }
+
+    for (let i = 0; i < this._preferredProviders.length; i++) {
+      const preferred = this._preferredProviders[i]!;
+      if (availableProviders.includes(preferred)) {
+        return { provider: preferred, rank: i };
+      }
+    }
+
+    return null;
+  }
+
+  private _resolvePeerOfferPrice(
+    peer: PeerInfo,
+    provider: string,
+    model: string | null,
+  ): TokenPricingUsdPerMillion | null {
+    const providerPricing = peer.providerPricing?.[provider];
+
+    if (model) {
+      const modelSpecific = providerPricing?.models?.[model];
+      if (modelSpecific && this._isValidOffer(modelSpecific)) {
+        return modelSpecific;
+      }
+    }
+
+    const providerDefaults = providerPricing?.defaults;
+    if (providerDefaults && this._isValidOffer(providerDefaults)) {
+      return providerDefaults;
+    }
+
+    if (
+      this._isFiniteNonNegative(peer.defaultInputUsdPerMillion) &&
+      this._isFiniteNonNegative(peer.defaultOutputUsdPerMillion)
+    ) {
+      return {
+        inputUsdPerMillion: peer.defaultInputUsdPerMillion,
+        outputUsdPerMillion: peer.defaultOutputUsdPerMillion,
+      };
+    }
+
+    return null;
+  }
+
+  private _resolveBuyerMaxPrice(provider: string, model: string | null): TokenPricingUsdPerMillion {
+    const providerPricing = this._maxPricing.providers?.[provider];
+
+    if (model) {
+      const modelOverride = providerPricing?.models?.[model];
+      if (modelOverride && this._isValidOffer(modelOverride)) {
+        return modelOverride;
+      }
+    }
+
+    const providerDefaults = providerPricing?.defaults;
+    if (providerDefaults && this._isValidOffer(providerDefaults)) {
+      return providerDefaults;
+    }
+
+    return this._maxPricing.defaults;
+  }
+
+  private _isFiniteNonNegative(value: number | undefined): value is number {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+  }
+
+  private _isValidOffer(offer: TokenPricingUsdPerMillion): boolean {
+    return (
+      this._isFiniteNonNegative(offer.inputUsdPerMillion) &&
+      this._isFiniteNonNegative(offer.outputUsdPerMillion)
+    );
+  }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["src/**/*.test.ts"]
+}