@antseed/router-local-chat 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @antseed/router-local-chat
+
+Latency-prioritized router for the Antseed desktop chat application. Optimizes peer selection for interactive conversations where response time matters most.
+
+## Installation
+
+```bash
+antseed plugin add @antseed/router-local-chat
+```
+
+## Usage
+
+```bash
+antseed connect --router local-chat
+```
+
+## Configuration
+
+| Key | Type | Required | Default | Description |
+|-----|------|----------|---------|-------------|
+| `ANTSEED_MIN_REPUTATION` | number | No | 50 | Minimum peer reputation (0-100) |
+| `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 |
+
+## Scoring Weights
+
+Tuned for interactive chat -- latency is weighted highest:
+
+| Factor | Weight |
+|--------|--------|
+| latency | 0.35 |
+| capacity | 0.20 |
+| price | 0.15 |
+| reputation | 0.15 |
+| freshness | 0.10 |
+| reliability | 0.05 |
+
+## How It Works
+
+Uses `scoreCandidates` and `PeerMetricsTracker` from `@antseed/router-core`. Peers that fail repeatedly are placed on cooldown. Stale peers are deprioritized. Among equal-scored peers, deterministic tie-breaking ensures consistent routing.

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;AAG9E,QAAA,MAAM,MAAM,EAAE,mBAoCb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,eAAO,MAAM,UAAU,2CAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+import { WELL_KNOWN_TOOL_HINTS, formatToolHints } from '@antseed/router-core';
+import { LocalChatRouter } from './router.js';
+const plugin = {
+    name: 'local-chat',
+    displayName: 'Local Chat',
+    version: '0.1.0',
+    type: 'router',
+    description: 'Latency-prioritized router for desktop chat applications',
+    configSchema: [
+        { key: 'ANTSEED_MIN_REPUTATION', label: 'Min Reputation', type: 'number', required: false, default: 50, description: 'Min peer reputation 0-100' },
+        { 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 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 LocalChatRouter({
+            minReputation,
+            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":"AACA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,GAAwB;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,0DAA0D;IACvE,YAAY,EAAE;QACZ,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE;QAClJ,EAAE,GAAG,EAAE,sBAAsB,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE;QAClK,EAAE,GAAG,EAAE,6BAA6B,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,uCAAuC,EAAE;QAC7K,EAAE,GAAG,EAAE,+BAA+B,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,6BAA6B,EAAE;KACzK;IACD,YAAY,CAAC,MAA8B;QACzC,MAAM,aAAa,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,wBAAwB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpH,IAAI,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9G,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,iBAAiB,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,6BAA6B,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClI,IAAI,iBAAiB,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,kBAAkB,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,+BAA+B,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvI,IAAI,kBAAkB,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,eAAe,CAAC;YACzB,aAAa;YACb,WAAW;YACX,iBAAiB;YACjB,kBAAkB;SACnB,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,CAAC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,28 @@
+import type { Router, PeerInfo, SerializedHttpRequest } from '@antseed/node';
+export interface LocalChatRouterConfig {
+    minReputation?: number;
+    maxFailures?: number;
+    failureCooldownMs?: number;
+    maxPeerStalenessMs?: number;
+    now?: () => number;
+}
+export declare class LocalChatRouter implements Router {
+    private readonly _minReputation;
+    private readonly _maxFailures;
+    private readonly _maxPeerStalenessMs;
+    private readonly _now;
+    private readonly _metrics;
+    constructor(config?: LocalChatRouterConfig);
+    selectPeer(req: SerializedHttpRequest, peers: PeerInfo[]): PeerInfo | null;
+    onResult(peer: PeerInfo, result: {
+        success: boolean;
+        latencyMs: number;
+        tokens: number;
+    }): void;
+    private _effectiveReputation;
+    private _extractRequestedModel;
+    private _resolvePeerOfferPrice;
+    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;AAkB7E,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,eAAgB,YAAW,MAAM;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,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,CAAqB;gBAElC,MAAM,CAAC,EAAE,qBAAqB;IAY1C,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI;IAoE1E,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,sBAAsB;IAkB9B,OAAO,CAAC,sBAAsB;IAgC9B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,aAAa;CAMtB"}

package/dist/router.js

@@ -0,0 +1,138 @@
+import { scoreCandidates, PeerMetricsTracker, } from '@antseed/router-core';
+/** Latency-prioritized weights for desktop chat. */
+const CHAT_WEIGHTS = {
+    price: 0.15,
+    latency: 0.35,
+    capacity: 0.20,
+    reputation: 0.15,
+    freshness: 0.10,
+    reliability: 0.05,
+};
+export class LocalChatRouter {
+    _minReputation;
+    _maxFailures;
+    _maxPeerStalenessMs;
+    _now;
+    _metrics;
+    constructor(config) {
+        this._minReputation = config?.minReputation ?? 50;
+        this._maxFailures = Math.max(1, config?.maxFailures ?? 3);
+        this._maxPeerStalenessMs = Math.max(1, config?.maxPeerStalenessMs ?? 300_000);
+        this._now = config?.now ?? (() => Date.now());
+        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
+            const reputation = this._effectiveReputation(peer);
+            if (reputation < this._minReputation) {
+                continue;
+            }
+            // Cooldown filter
+            if (this._metrics.isCoolingDown(peer.peerId)) {
+                continue;
+            }
+            // Use first available provider (no preference list for chat)
+            const provider = peer.providers[0];
+            if (!provider) {
+                continue;
+            }
+            const offer = this._resolvePeerOfferPrice(peer, provider, requestedModel);
+            if (!offer) {
+                continue;
+            }
+            candidates.push({
+                peer,
+                provider,
+                providerRank: Number.MAX_SAFE_INTEGER,
+                offer,
+            });
+        }
+        if (candidates.length === 0)
+            return null;
+        if (candidates.length === 1) {
+            return candidates[0].peer;
+        }
+        // Delegate scoring to router-core with latency-prioritized weights
+        const scoringInput = candidates.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: CHAT_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;
+    }
+    _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;
+        }
+    }
+    _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;
+    }
+    _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-chat",
+  "version": "0.1.0",
+  "description": "Antseed local chat router plugin — latency-prioritized for desktop",
+  "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,46 @@
+import type { AntseedRouterPlugin } from '@antseed/node';
+import { WELL_KNOWN_TOOL_HINTS, formatToolHints } from '@antseed/router-core';
+import { LocalChatRouter } from './router.js';
+
+const plugin: AntseedRouterPlugin = {
+  name: 'local-chat',
+  displayName: 'Local Chat',
+  version: '0.1.0',
+  type: 'router',
+  description: 'Latency-prioritized router for desktop chat applications',
+  configSchema: [
+    { key: 'ANTSEED_MIN_REPUTATION', label: 'Min Reputation', type: 'number', required: false, default: 50, description: 'Min peer reputation 0-100' },
+    { 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 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 LocalChatRouter({
+      minReputation,
+      maxFailures,
+      failureCooldownMs,
+      maxPeerStalenessMs,
+    });
+  },
+};
+
+export default plugin;
+
+export const TOOL_HINTS = WELL_KNOWN_TOOL_HINTS;
+export { formatToolHints };

package/src/router.test.ts

@@ -0,0 +1,111 @@
+import { describe, it, expect } from 'vitest';
+import type { PeerInfo, SerializedHttpRequest } from '@antseed/node';
+import { LocalChatRouter } 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('LocalChatRouter', () => {
+  it('prefers lower-latency peer due to latency-prioritized weights', () => {
+    let now = 1_000_000;
+    const router = new LocalChatRouter({ now: () => now });
+
+    const fastPeer = makePeer({
+      peerId: '1'.repeat(64) as PeerInfo['peerId'],
+      lastSeen: now,
+    });
+    const slowPeer = makePeer({
+      peerId: '2'.repeat(64) as PeerInfo['peerId'],
+      lastSeen: now,
+      providerPricing: {
+        anthropic: {
+          defaults: { inputUsdPerMillion: 5, outputUsdPerMillion: 5 },
+        },
+      },
+      defaultInputUsdPerMillion: 5,
+      defaultOutputUsdPerMillion: 5,
+    });
+
+    // Record latency history
+    router.onResult(fastPeer, { success: true, latencyMs: 50, tokens: 100 });
+    router.onResult(slowPeer, { success: true, latencyMs: 500, tokens: 100 });
+
+    const selected = router.selectPeer(makeRequest(), [slowPeer, fastPeer]);
+    expect(selected?.peerId).toBe(fastPeer.peerId);
+  });
+
+  it('filters out peers below minimum reputation', () => {
+    const router = new LocalChatRouter({ 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('returns null when no peers are available', () => {
+    const router = new LocalChatRouter();
+    expect(router.selectPeer(makeRequest(), [])).toBeNull();
+  });
+
+  it('puts peers on cooldown after failure threshold', () => {
+    let now = 1_000_000;
+    const router = new LocalChatRouter({
+      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 });
+
+    expect(router.selectPeer(makeRequest(), [flaky, fallback])?.peerId).toBe(fallback.peerId);
+
+    now += 501;
+    // Selectable when no alternatives exist after cooldown expires.
+    expect(router.selectPeer(makeRequest(), [flaky])?.peerId).toBe(flaky.peerId);
+  });
+});

package/src/router.ts

@@ -0,0 +1,191 @@
+import type { Router, PeerInfo, SerializedHttpRequest } from '@antseed/node';
+import {
+  scoreCandidates,
+  PeerMetricsTracker,
+  type TokenPricingUsdPerMillion,
+  type ScoringWeights,
+} from '@antseed/router-core';
+
+/** Latency-prioritized weights for desktop chat. */
+const CHAT_WEIGHTS: ScoringWeights = {
+  price: 0.15,
+  latency: 0.35,
+  capacity: 0.20,
+  reputation: 0.15,
+  freshness: 0.10,
+  reliability: 0.05,
+};
+
+export interface LocalChatRouterConfig {
+  minReputation?: number;
+  maxFailures?: number;
+  failureCooldownMs?: number;
+  maxPeerStalenessMs?: number;
+  now?: () => number;
+}
+
+export class LocalChatRouter implements Router {
+  private readonly _minReputation: number;
+  private readonly _maxFailures: number;
+  private readonly _maxPeerStalenessMs: number;
+  private readonly _now: () => number;
+  private readonly _metrics: PeerMetricsTracker;
+
+  constructor(config?: LocalChatRouterConfig) {
+    this._minReputation = config?.minReputation ?? 50;
+    this._maxFailures = Math.max(1, config?.maxFailures ?? 3);
+    this._maxPeerStalenessMs = Math.max(1, config?.maxPeerStalenessMs ?? 300_000);
+    this._now = config?.now ?? (() => Date.now());
+    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
+      const reputation = this._effectiveReputation(peer);
+      if (reputation < this._minReputation) {
+        continue;
+      }
+
+      // Cooldown filter
+      if (this._metrics.isCoolingDown(peer.peerId)) {
+        continue;
+      }
+
+      // Use first available provider (no preference list for chat)
+      const provider = peer.providers[0];
+      if (!provider) {
+        continue;
+      }
+
+      const offer = this._resolvePeerOfferPrice(peer, provider, requestedModel);
+      if (!offer) {
+        continue;
+      }
+
+      candidates.push({
+        peer,
+        provider,
+        providerRank: Number.MAX_SAFE_INTEGER,
+        offer,
+      });
+    }
+
+    if (candidates.length === 0) return null;
+
+    if (candidates.length === 1) {
+      return candidates[0]!.peer;
+    }
+
+    // Delegate scoring to router-core with latency-prioritized weights
+    const scoringInput = candidates.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: CHAT_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 _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 _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 _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"]
+}