@antseed/cli 0.1.143 → 0.1.145

package/dist/proxy/peer-health.js

@@ -0,0 +1,182 @@
+/**
+ * Per-peer failure bookkeeping and cooldown state for the buyer proxy.
+ *
+ * A peer that stops responding should stop being picked, but only temporarily:
+ * peers go offline for legitimate reasons, so there is no permanent auto-ban.
+ * Whether a failure is even allowed to escalate is decided separately, by
+ * `peer-attribution.ts` — this module owns the state machine, not the blame.
+ *
+ * Cooldown is always advisory. The proxy still dispatches to a cooling-down
+ * peer when a request names it, so a pinned conversation keeps working and no
+ * amount of cooldown can deadlock routing.
+ */
+// The escalation curve is defined once in
+// `packages/router-core/src/peer-metrics.ts` (`computeFailureCooldownMs`).
+// These constants mirror it; router-core is not a dependency of the CLI and a
+// six-line curve does not justify making it one. Keep the two in step.
+const MAX_FAILURES = 3;
+const BASE_COOLDOWN_MS = 30_000;
+const MAX_DOUBLINGS = 4;
+/** Failures older than this start a fresh streak rather than compounding. */
+export const PEER_HEALTH_WINDOW_MS = 5 * 60_000;
+/** Concurrent requests failing together count as one episode, not several. */
+export const PEER_HEALTH_COALESCE_MS = 1_000;
+/** Ceiling on any single cooldown, and the sanity bound for persisted values. */
+export const PEER_HEALTH_MAX_COOLDOWN_MS = 8 * 60_000;
+/** How long an idle entry is kept before it is forgotten entirely. */
+export const PEER_HEALTH_RETENTION_MS = 24 * 60 * 60_000;
+/** Upper bound on tracked peers, newest failures retained. */
+export const PEER_HEALTH_MAX_ENTRIES = 512;
+const FAILURE_REASONS = [
+    'request-failed', 'seller-5xx', 'seller-timeout', 'seller-busy', 'buyer-local',
+];
+/** Whether a reason is even a candidate for cooling a peer down. */
+export function reasonEscalates(reason) {
+    return reason === 'request-failed' || reason === 'seller-5xx' || reason === 'seller-timeout';
+}
+export function computeCooldownMs(failureStreak) {
+    if (!Number.isFinite(failureStreak) || failureStreak < MAX_FAILURES)
+        return 0;
+    const penaltyPower = Math.min(MAX_DOUBLINGS, Math.trunc(failureStreak) - MAX_FAILURES);
+    return Math.min(BASE_COOLDOWN_MS * (2 ** penaltyPower), PEER_HEALTH_MAX_COOLDOWN_MS);
+}
+function emptyEntry() {
+    return {
+        failureStreak: 0,
+        windowStartedAt: 0,
+        episodeStartedAt: 0,
+        lastFailureAt: 0,
+        lastReason: 'request-failed',
+        cooldownUntil: 0,
+        lastSuccessAt: 0,
+    };
+}
+/**
+ * Fold a failure into a peer's health.
+ *
+ * `escalate` comes from the attribution gates: when false the failure is still
+ * recorded for diagnostics and UI, but the streak and cooldown stay put.
+ */
+export function recordPeerFailureEntry(previous, reason, now, escalate) {
+    const prev = previous ?? emptyEntry();
+    if (!escalate) {
+        return { ...prev, lastFailureAt: now, lastReason: reason };
+    }
+    // Two requests to the same dead peer failing together are one episode; without
+    // this they would skip a doubling step each time concurrency rises.
+    const episodeStartedAt = prev.episodeStartedAt;
+    if (episodeStartedAt > 0 && now - episodeStartedAt < PEER_HEALTH_COALESCE_MS && now >= prev.lastFailureAt) {
+        return { ...prev, lastFailureAt: now, lastReason: reason };
+    }
+    const windowLapsed = prev.lastFailureAt <= 0
+        || now - prev.lastFailureAt > PEER_HEALTH_WINDOW_MS
+        // Clock stepped backwards; the old window is meaningless.
+        || now < prev.lastFailureAt;
+    const failureStreak = windowLapsed ? 1 : prev.failureStreak + 1;
+    const cooldownMs = computeCooldownMs(failureStreak);
+    return {
+        failureStreak,
+        windowStartedAt: windowLapsed ? now : (prev.windowStartedAt || now),
+        episodeStartedAt: now,
+        lastFailureAt: now,
+        lastReason: reason,
+        cooldownUntil: cooldownMs > 0 ? now + cooldownMs : 0,
+        lastSuccessAt: prev.lastSuccessAt,
+    };
+}
+/**
+ * Any response from a peer is proof of life, so a success wipes the streak and
+ * releases the cooldown. `lastSuccessAt` is kept for diagnostics.
+ */
+export function clearPeerHealthEntry(previous, now) {
+    return {
+        ...(previous ?? emptyEntry()),
+        failureStreak: 0,
+        windowStartedAt: 0,
+        episodeStartedAt: 0,
+        cooldownUntil: 0,
+        lastSuccessAt: now,
+    };
+}
+export function isCoolingDown(entry, now) {
+    if (!entry || entry.cooldownUntil <= now)
+        return false;
+    // A corrupt or clock-skewed future value must not hold a peer hostage.
+    return entry.cooldownUntil - now <= PEER_HEALTH_MAX_COOLDOWN_MS;
+}
+/** Whether an entry still carries information worth persisting. */
+function isEntryMeaningful(entry, now) {
+    if (entry.cooldownUntil > now)
+        return true;
+    const lastActivity = Math.max(entry.lastFailureAt, entry.lastSuccessAt);
+    if (lastActivity <= 0)
+        return false;
+    return now - lastActivity < PEER_HEALTH_RETENTION_MS;
+}
+/** Drop stale entries and cap the map, keeping the most recently active peers. */
+export function prunePeerHealth(entries, now) {
+    const kept = [...entries.entries()].filter(([, entry]) => isEntryMeaningful(entry, now));
+    if (kept.length > PEER_HEALTH_MAX_ENTRIES) {
+        kept.sort((a, b) => Math.max(b[1].lastFailureAt, b[1].lastSuccessAt)
+            - Math.max(a[1].lastFailureAt, a[1].lastSuccessAt));
+        kept.length = PEER_HEALTH_MAX_ENTRIES;
+    }
+    return new Map(kept);
+}
+function finiteNonNegative(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+/**
+ * Parse the `peerHealth` map out of a buyer.state.json blob.
+ *
+ * Cooldown survives a restart — a peer that died ten seconds before we exited is
+ * still dead — but is never extended or resurrected by one: anything expired,
+ * impossibly far in the future, or stamped after `now` is discarded.
+ */
+export function parsePersistedPeerHealth(parsed, now = Date.now()) {
+    const result = new Map();
+    if (!parsed || typeof parsed !== 'object')
+        return result;
+    const raw = parsed.peerHealth;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return result;
+    for (const [rawPeerId, rawEntry] of Object.entries(raw)) {
+        const peerId = rawPeerId.toLowerCase();
+        if (!/^[0-9a-f]{40}$/.test(peerId))
+            continue;
+        if (!rawEntry || typeof rawEntry !== 'object' || Array.isArray(rawEntry))
+            continue;
+        const entry = rawEntry;
+        const lastFailureAt = finiteNonNegative(entry.lastFailureAt);
+        const lastSuccessAt = finiteNonNegative(entry.lastSuccessAt);
+        // Timestamps ahead of the clock mean the entry cannot be reasoned about.
+        if (lastFailureAt > now || lastSuccessAt > now)
+            continue;
+        const rawStreak = finiteNonNegative(entry.failureStreak);
+        const failureStreak = Math.min(64, Math.trunc(rawStreak));
+        const lastReason = FAILURE_REASONS.includes(entry.lastReason)
+            ? entry.lastReason
+            : 'request-failed';
+        const rawCooldown = finiteNonNegative(entry.cooldownUntil);
+        const cooldownUntil = rawCooldown > now && rawCooldown - now <= PEER_HEALTH_MAX_COOLDOWN_MS
+            ? rawCooldown
+            : 0;
+        const candidate = {
+            failureStreak,
+            windowStartedAt: Math.min(finiteNonNegative(entry.windowStartedAt), now),
+            episodeStartedAt: Math.min(finiteNonNegative(entry.episodeStartedAt) || lastFailureAt, now),
+            lastFailureAt,
+            lastReason,
+            cooldownUntil,
+            lastSuccessAt,
+        };
+        if (!isEntryMeaningful(candidate, now))
+            continue;
+        result.set(peerId, candidate);
+    }
+    return prunePeerHealth(result, now);
+}
+export function serializePeerHealth(entries) {
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=peer-health.js.map

package/dist/proxy/peer-health.js.map

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

package/dist/proxy/peer-health.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=peer-health.test.d.ts.map

package/dist/proxy/peer-health.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-health.test.d.ts","sourceRoot":"","sources":["../../src/proxy/peer-health.test.ts"],"names":[],"mappings":""}

package/dist/proxy/peer-health.test.js

@@ -0,0 +1,197 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { recordPeerFailureEntry, clearPeerHealthEntry, isCoolingDown, parsePersistedPeerHealth, prunePeerHealth, computeCooldownMs, reasonEscalates, PEER_HEALTH_WINDOW_MS, PEER_HEALTH_COALESCE_MS, PEER_HEALTH_MAX_COOLDOWN_MS, PEER_HEALTH_RETENTION_MS, PEER_HEALTH_MAX_ENTRIES, } from './peer-health.js';
+const NOW = 1_700_000_000_000;
+const A = 'a'.repeat(40);
+function escalatingFailures(count, startAt = NOW, stepMs = 2_000) {
+    let entry;
+    for (let i = 0; i < count; i += 1) {
+        entry = recordPeerFailureEntry(entry, 'request-failed', startAt + i * stepMs, true);
+    }
+    return entry;
+}
+test('reasonEscalates only admits reasons that indicate the peer is down', () => {
+    assert.equal(reasonEscalates('request-failed'), true);
+    assert.equal(reasonEscalates('seller-5xx'), true);
+    assert.equal(reasonEscalates('seller-timeout'), true);
+    assert.equal(reasonEscalates('seller-busy'), false);
+    assert.equal(reasonEscalates('buyer-local'), false);
+});
+test('computeCooldownMs matches the shared escalation curve and its ceiling', () => {
+    assert.equal(computeCooldownMs(2), 0);
+    assert.equal(computeCooldownMs(3), 30_000);
+    assert.equal(computeCooldownMs(4), 60_000);
+    assert.equal(computeCooldownMs(5), 120_000);
+    assert.equal(computeCooldownMs(7), 480_000);
+    assert.equal(computeCooldownMs(50), PEER_HEALTH_MAX_COOLDOWN_MS);
+});
+test('a peer cools down only on the third failure in the window', () => {
+    const after1 = recordPeerFailureEntry(undefined, 'request-failed', NOW, true);
+    assert.equal(after1.failureStreak, 1);
+    assert.equal(isCoolingDown(after1, NOW), false);
+    const after2 = recordPeerFailureEntry(after1, 'request-failed', NOW + 2_000, true);
+    assert.equal(isCoolingDown(after2, NOW + 2_000), false);
+    const after3 = recordPeerFailureEntry(after2, 'request-failed', NOW + 4_000, true);
+    assert.equal(after3.failureStreak, 3);
+    assert.equal(after3.cooldownUntil, NOW + 4_000 + 30_000);
+    assert.equal(isCoolingDown(after3, NOW + 4_000), true);
+});
+test('further failures double the cooldown', () => {
+    const after4 = escalatingFailures(4);
+    assert.equal(after4.cooldownUntil - after4.lastFailureAt, 60_000);
+    const after5 = escalatingFailures(5);
+    assert.equal(after5.cooldownUntil - after5.lastFailureAt, 120_000);
+});
+test('a non-escalating failure updates diagnostics but never the streak or cooldown', () => {
+    const escalated = escalatingFailures(2);
+    const suppressed = recordPeerFailureEntry(escalated, 'seller-busy', NOW + 10_000, false);
+    assert.equal(suppressed.failureStreak, escalated.failureStreak);
+    assert.equal(suppressed.cooldownUntil, escalated.cooldownUntil);
+    assert.equal(suppressed.lastReason, 'seller-busy');
+    assert.equal(suppressed.lastFailureAt, NOW + 10_000);
+});
+test('a diagnostic-only failure does not coalesce away the next escalating failure', () => {
+    const diagnostic = recordPeerFailureEntry(undefined, 'seller-busy', NOW, false);
+    const escalated = recordPeerFailureEntry(diagnostic, 'request-failed', NOW + 100, true);
+    assert.equal(escalated.failureStreak, 1);
+    assert.equal(escalated.episodeStartedAt, NOW + 100);
+});
+test('failures inside the coalesce window count as a single episode', () => {
+    let entry = recordPeerFailureEntry(undefined, 'request-failed', NOW, true);
+    entry = recordPeerFailureEntry(entry, 'request-failed', NOW + 100, true);
+    entry = recordPeerFailureEntry(entry, 'request-failed', NOW + 200, true);
+    assert.equal(entry.failureStreak, 1);
+    assert.equal(isCoolingDown(entry, NOW + 200), false);
+});
+test('the coalesce window is anchored to the episode start', () => {
+    let entry = recordPeerFailureEntry(undefined, 'request-failed', NOW, true);
+    entry = recordPeerFailureEntry(entry, 'request-failed', NOW + PEER_HEALTH_COALESCE_MS - 100, true);
+    entry = recordPeerFailureEntry(entry, 'request-failed', NOW + PEER_HEALTH_COALESCE_MS + 100, true);
+    assert.equal(entry.failureStreak, 2);
+    assert.equal(entry.episodeStartedAt, NOW + PEER_HEALTH_COALESCE_MS + 100);
+});
+test('a lapsed window starts a fresh streak instead of compounding', () => {
+    const twoFailures = escalatingFailures(2);
+    const muchLater = recordPeerFailureEntry(twoFailures, 'request-failed', twoFailures.lastFailureAt + PEER_HEALTH_WINDOW_MS + 1, true);
+    assert.equal(muchLater.failureStreak, 1);
+    assert.equal(muchLater.cooldownUntil, 0);
+});
+test('a backwards clock jump resets the window rather than compounding', () => {
+    const twoFailures = escalatingFailures(2);
+    const backwards = recordPeerFailureEntry(twoFailures, 'request-failed', NOW - 60_000, true);
+    assert.equal(backwards.failureStreak, 1);
+    assert.equal(backwards.cooldownUntil, 0);
+});
+test('a success clears the streak and releases the cooldown', () => {
+    const cooling = escalatingFailures(3);
+    assert.equal(isCoolingDown(cooling, cooling.lastFailureAt), true);
+    const recovered = clearPeerHealthEntry(cooling, cooling.lastFailureAt + 1_000);
+    assert.equal(recovered.failureStreak, 0);
+    assert.equal(recovered.cooldownUntil, 0);
+    assert.equal(recovered.lastSuccessAt, cooling.lastFailureAt + 1_000);
+    assert.equal(isCoolingDown(recovered, recovered.lastSuccessAt), false);
+});
+test('isCoolingDown rejects an impossibly distant cooldown', () => {
+    const entry = {
+        ...escalatingFailures(3),
+        cooldownUntil: NOW + PEER_HEALTH_MAX_COOLDOWN_MS * 10,
+    };
+    assert.equal(isCoolingDown(entry, NOW), false);
+});
+test('parsePersistedPeerHealth ignores junk input', () => {
+    assert.equal(parsePersistedPeerHealth(null, NOW).size, 0);
+    assert.equal(parsePersistedPeerHealth('nope', NOW).size, 0);
+    assert.equal(parsePersistedPeerHealth({}, NOW).size, 0);
+    assert.equal(parsePersistedPeerHealth({ peerHealth: [] }, NOW).size, 0);
+    assert.equal(parsePersistedPeerHealth({ peerHealth: 'x' }, NOW).size, 0);
+});
+test('parsePersistedPeerHealth rejects malformed peer ids and entries', () => {
+    const parsed = parsePersistedPeerHealth({
+        peerHealth: {
+            'not-a-peer-id': { lastFailureAt: NOW - 1_000, failureStreak: 3 },
+            [`0x${'a'.repeat(40)}`]: { lastFailureAt: NOW - 1_000, failureStreak: 3 },
+            [A]: 'not-an-object',
+        },
+    }, NOW);
+    assert.equal(parsed.size, 0);
+});
+test('parsePersistedPeerHealth restores a live cooldown unchanged', () => {
+    const cooldownUntil = NOW + 20_000;
+    const parsed = parsePersistedPeerHealth({
+        peerHealth: {
+            [A.toUpperCase()]: {
+                failureStreak: 3, windowStartedAt: NOW - 5_000, lastFailureAt: NOW - 1_000,
+                lastReason: 'seller-5xx', cooldownUntil, lastSuccessAt: 0,
+            },
+        },
+    }, NOW);
+    const entry = parsed.get(A);
+    assert.ok(entry);
+    assert.equal(entry.cooldownUntil, cooldownUntil);
+    assert.equal(entry.failureStreak, 3);
+    assert.equal(entry.lastReason, 'seller-5xx');
+});
+test('parsePersistedPeerHealth drops an expired or impossible cooldown', () => {
+    const expired = parsePersistedPeerHealth({
+        peerHealth: { [A]: { failureStreak: 3, lastFailureAt: NOW - 1_000, cooldownUntil: NOW - 1 } },
+    }, NOW);
+    assert.equal(expired.get(A)?.cooldownUntil, 0);
+    const absurd = parsePersistedPeerHealth({
+        peerHealth: {
+            [A]: {
+                failureStreak: 3,
+                lastFailureAt: NOW - 1_000,
+                cooldownUntil: NOW + PEER_HEALTH_MAX_COOLDOWN_MS * 100,
+            },
+        },
+    }, NOW);
+    assert.equal(absurd.get(A)?.cooldownUntil, 0);
+});
+test('parsePersistedPeerHealth discards entries stamped in the future', () => {
+    const parsed = parsePersistedPeerHealth({
+        peerHealth: { [A]: { failureStreak: 3, lastFailureAt: NOW + 60_000 } },
+    }, NOW);
+    assert.equal(parsed.size, 0);
+});
+test('parsePersistedPeerHealth coerces non-finite numbers and unknown reasons', () => {
+    const parsed = parsePersistedPeerHealth({
+        peerHealth: {
+            [A]: {
+                failureStreak: 'lots', windowStartedAt: Number.NaN, lastFailureAt: NOW - 1_000,
+                lastReason: 'made-up-reason', cooldownUntil: Number.POSITIVE_INFINITY,
+                lastSuccessAt: -5,
+            },
+        },
+    }, NOW);
+    const entry = parsed.get(A);
+    assert.ok(entry);
+    assert.equal(entry.failureStreak, 0);
+    assert.equal(entry.windowStartedAt, 0);
+    assert.equal(entry.lastReason, 'request-failed');
+    assert.equal(entry.cooldownUntil, 0);
+    assert.equal(entry.lastSuccessAt, 0);
+});
+test('parsePersistedPeerHealth forgets entries past the retention window', () => {
+    const parsed = parsePersistedPeerHealth({
+        peerHealth: { [A]: { failureStreak: 3, lastFailureAt: NOW - PEER_HEALTH_RETENTION_MS - 1 } },
+    }, NOW);
+    assert.equal(parsed.size, 0);
+});
+test('prunePeerHealth caps the map keeping the most recently active peers', () => {
+    const entries = new Map();
+    const total = PEER_HEALTH_MAX_ENTRIES + 10;
+    for (let i = 0; i < total; i += 1) {
+        const peerId = i.toString(16).padStart(40, '0');
+        entries.set(peerId, {
+            failureStreak: 1, windowStartedAt: 0, lastFailureAt: NOW - (total - i) * 1_000,
+            episodeStartedAt: NOW - (total - i) * 1_000,
+            lastReason: 'request-failed', cooldownUntil: 0, lastSuccessAt: 0,
+        });
+    }
+    const pruned = prunePeerHealth(entries, NOW);
+    assert.equal(pruned.size, PEER_HEALTH_MAX_ENTRIES);
+    // The freshest peer survives; the stalest is evicted.
+    assert.ok(pruned.has((total - 1).toString(16).padStart(40, '0')));
+    assert.equal(pruned.has((0).toString(16).padStart(40, '0')), false);
+});
+//# sourceMappingURL=peer-health.test.js.map

package/dist/proxy/peer-health.test.js.map

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

package/dist/proxy/routing-parameters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routing-parameters.test.d.ts.map

package/dist/proxy/routing-parameters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-parameters.test.d.ts","sourceRoot":"","sources":["../../src/proxy/routing-parameters.test.ts"],"names":[],"mappings":""}

package/dist/proxy/routing-parameters.test.js

@@ -0,0 +1,97 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { findUnannouncedRequestParameters } from './routing.js';
+const encode = (value) => new TextEncoder().encode(JSON.stringify(value));
+function makePeer(overrides = {}) {
+    return {
+        peerId: 'a'.repeat(40),
+        lastSeen: 0,
+        providers: ['openai'],
+        ...overrides,
+    };
+}
+function makeRequest(body) {
+    return {
+        requestId: 'req-1',
+        method: 'POST',
+        path: '/v1/images/generations',
+        headers: { 'content-type': 'application/json' },
+        body: encode(body),
+    };
+}
+const imagePeer = makePeer({
+    providerServiceCapabilities: {
+        openai: {
+            services: {
+                'gpt-image-1': {
+                    outputs: ['image'],
+                    supportedParameters: ['background', 'output_format', 'quality', 'size'],
+                },
+            },
+        },
+    },
+});
+test('flags parameters outside the announced list plus protocol baseline', () => {
+    const unannounced = findUnannouncedRequestParameters(imagePeer, 'openai', 'gpt-image-1', 'openai-images', makeRequest({ model: 'gpt-image-1', prompt: 'an ant', n: 2, size: '1024x1024', seed: 42, style: 'vivid' }));
+    assert.deepEqual(unannounced.sort(), ['seed', 'style']);
+});
+test('accepts requests that stay within the announced list', () => {
+    const unannounced = findUnannouncedRequestParameters(imagePeer, 'openai', 'gpt-image-1', 'openai-images', makeRequest({ model: 'gpt-image-1', prompt: 'an ant', background: 'transparent', output_format: 'webp' }));
+    assert.deepEqual(unannounced, []);
+});
+test('never flags when the peer announces no supportedParameters', () => {
+    const silentPeer = makePeer({
+        providerServiceCapabilities: {
+            openai: { services: { 'gpt-image-1': { outputs: ['image'] } } },
+        },
+    });
+    const request = makeRequest({ model: 'gpt-image-1', prompt: 'an ant', seed: 42 });
+    assert.deepEqual(findUnannouncedRequestParameters(silentPeer, 'openai', 'gpt-image-1', 'openai-images', request), []);
+    assert.deepEqual(findUnannouncedRequestParameters(makePeer(), 'openai', 'gpt-image-1', 'openai-images', request), []);
+});
+test('matches provider and service names case-insensitively', () => {
+    const unannounced = findUnannouncedRequestParameters(imagePeer, 'OpenAI', 'GPT-Image-1', 'openai-images', makeRequest({ model: 'gpt-image-1', prompt: 'an ant', seed: 42 }));
+    assert.deepEqual(unannounced, ['seed']);
+});
+test('checks multipart text fields and ignores file parts', () => {
+    const boundary = 'test-boundary';
+    const multipart = [
+        `--${boundary}`,
+        'content-disposition: form-data; name="model"',
+        '',
+        'gpt-image-1',
+        `--${boundary}`,
+        'content-disposition: form-data; name="seed"',
+        '',
+        '42',
+        `--${boundary}`,
+        'content-disposition: form-data; name="image"; filename="in.png"',
+        'content-type: image/png',
+        '',
+        'binary-bytes',
+        `--${boundary}--`,
+        '',
+    ].join('\r\n');
+    const unannounced = findUnannouncedRequestParameters(imagePeer, 'openai', 'gpt-image-1', 'openai-images', {
+        requestId: 'req-2',
+        method: 'POST',
+        path: '/v1/images/edits',
+        headers: { 'content-type': `multipart/form-data; boundary=${boundary}` },
+        body: new TextEncoder().encode(multipart),
+    });
+    assert.deepEqual(unannounced, ['seed']);
+});
+test('skips unparseable bodies and requests without a resolved service or protocol', () => {
+    const rawRequest = {
+        requestId: 'req-3',
+        method: 'POST',
+        path: '/v1/images/generations',
+        headers: { 'content-type': 'application/json' },
+        body: new TextEncoder().encode('not-json'),
+    };
+    assert.deepEqual(findUnannouncedRequestParameters(imagePeer, 'openai', 'gpt-image-1', 'openai-images', rawRequest), []);
+    const request = makeRequest({ model: 'gpt-image-1', prompt: 'an ant', seed: 42 });
+    assert.deepEqual(findUnannouncedRequestParameters(imagePeer, 'openai', null, 'openai-images', request), []);
+    assert.deepEqual(findUnannouncedRequestParameters(imagePeer, 'openai', 'gpt-image-1', null, request), []);
+});
+//# sourceMappingURL=routing-parameters.test.js.map

package/dist/proxy/routing-parameters.test.js.map

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

package/dist/proxy/routing.d.ts

@@ -13,5 +13,13 @@ export declare function getExplicitProviderOverride(request: SerializedHttpReque
 export declare function getExplicitPeerIdOverride(request: SerializedHttpRequest, sessionPinnedPeerId: string | undefined, requestPinnedPeerId?: string | null): string | null;
 export declare function resolvePeerRoutePlan(peer: PeerInfo, requestProtocol: ServiceApiProtocol | null, requestedService: string | null, explicitProvider: string | null, serviceFilterMode?: ServiceFilterMode): PeerProtocolRoutePlan | null;
 export declare function selectCandidatePeersForRouting(peers: PeerInfo[], requestProtocol: ServiceApiProtocol | null, requestedService: string | null, explicitProvider: string | null, serviceFilterMode?: ServiceFilterMode): CandidatePeerRouteSelection;
+/**
+ * Soft pre-flight check against the peer's announced `supportedParameters`
+ * capability: returns request-body parameter names the peer did not announce
+ * for the routed service. Empty when the peer announces no list (absence
+ * means unknown, not unsupported) or the body is not parseable. Callers log
+ * a warning — never reject — since the list is a hint, not a contract.
+ */
+export declare function findUnannouncedRequestParameters(peer: PeerInfo, provider: string, requestedService: string | null, requestProtocol: ServiceApiProtocol | null, request: SerializedHttpRequest): string[];
 export declare function pickProviderForPeer(peer: PeerInfo, request: SerializedHttpRequest): string;
 //# sourceMappingURL=routing.d.ts.map

package/dist/proxy/routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/proxy/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAA;AAGjC,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,cAAc,EAAE,QAAQ,EAAE,CAAA;IAC1B,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;CACtD,CAAA;AAKD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEpD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAGzF;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,GAClC,MAAM,GAAG,IAAI,CAMf;AAiGD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,kBAAkB,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,iBAAiB,GAAE,iBAA4B,GAC9C,qBAAqB,GAAG,IAAI,CAkC9B;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,QAAQ,EAAE,EACjB,eAAe,EAAE,kBAAkB,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,iBAAiB,GAAE,iBAA4B,GAC9C,2BAA2B,CAoB7B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgB1F"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/proxy/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAA;AAGjC,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,cAAc,EAAE,QAAQ,EAAE,CAAA;IAC1B,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;CACtD,CAAA;AAKD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEpD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAGzF;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,GAClC,MAAM,GAAG,IAAI,CAMf;AAiGD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,kBAAkB,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,iBAAiB,GAAE,iBAA4B,GAC9C,qBAAqB,GAAG,IAAI,CAkC9B;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,QAAQ,EAAE,EACjB,eAAe,EAAE,kBAAkB,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,iBAAiB,GAAE,iBAA4B,GAC9C,2BAA2B,CAoB7B;AAYD;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,eAAe,EAAE,kBAAkB,GAAG,IAAI,EAC1C,OAAO,EAAE,qBAAqB,GAC7B,MAAM,EAAE,CAgBV;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgB1F"}

package/dist/proxy/routing.js

@@ -1,4 +1,4 @@
-import { inferProviderDefaultServiceApiProtocols, selectTargetProtocolForRequest, } from './service-api-adapter.js';
+import { extractRequestBodyFields, inferProviderDefaultServiceApiProtocols, selectTargetProtocolForRequest, } from './service-api-adapter.js';
 import { log, normalizePeerId } from './request-utils.js';
 export function getExplicitProviderOverride(request) {
     const provider = request.headers['x-antseed-provider']?.trim().toLowerCase();
@@ -112,6 +112,41 @@ export function selectCandidatePeersForRouting(peers, requestProtocol, requested
         routePlanByPeerId,
     };
 }
+// Protocol-core request fields that are never flagged against a peer's
+// announced supportedParameters: the announced list describes optional
+// extras, not the fields every request on that protocol carries.
+const PROTOCOL_BASELINE_FIELDS = {
+    'openai-images': ['model', 'prompt', 'image', 'mask', 'n', 'stream'],
+    'openai-chat-completions': ['model', 'messages', 'stream'],
+    'openai-responses': ['model', 'input', 'stream'],
+    'anthropic-messages': ['model', 'messages', 'max_tokens', 'stream'],
+};
+/**
+ * Soft pre-flight check against the peer's announced `supportedParameters`
+ * capability: returns request-body parameter names the peer did not announce
+ * for the routed service. Empty when the peer announces no list (absence
+ * means unknown, not unsupported) or the body is not parseable. Callers log
+ * a warning — never reject — since the list is a hint, not a contract.
+ */
+export function findUnannouncedRequestParameters(peer, provider, requestedService, requestProtocol, request) {
+    const normalizedService = requestedService?.trim().toLowerCase();
+    if (!requestProtocol || !normalizedService)
+        return [];
+    const providerKey = Object.keys(peer.providerServiceCapabilities ?? {})
+        .find((key) => key.toLowerCase() === provider.toLowerCase());
+    const services = providerKey ? peer.providerServiceCapabilities?.[providerKey]?.services : undefined;
+    if (!services)
+        return [];
+    const serviceKey = Object.keys(services).find((key) => key.toLowerCase() === normalizedService);
+    const announced = serviceKey ? services[serviceKey]?.supportedParameters : undefined;
+    if (!announced || announced.length === 0)
+        return [];
+    const fields = extractRequestBodyFields(request.headers, request.body);
+    if (!fields)
+        return [];
+    const allowed = new Set([...announced, ...(PROTOCOL_BASELINE_FIELDS[requestProtocol] ?? [])]);
+    return Object.keys(fields).filter((key) => !allowed.has(key));
+}
 export function pickProviderForPeer(peer, request) {
     const explicit = getExplicitProviderOverride(request);
     if (explicit) {

package/dist/proxy/routing.js.map

@@ -1 +1 @@
-{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../src/proxy/routing.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uCAAuC,EACvC,8BAA8B,GAG/B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAiBzD,MAAM,UAAU,2BAA2B,CAAC,OAA8B;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC5E,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAA8B,EAC9B,mBAAuC,EACvC,mBAAmC;IAEnC,qDAAqD;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAA;IAC5D,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAA;IACvF,IAAI,mBAAmB;QAAE,OAAO,mBAAmB,CAAC,WAAW,EAAE,CAAA;IACjE,OAAO,mBAAmB,EAAE,WAAW,EAAE,IAAI,IAAI,CAAA;AACnD,CAAC;AAED,SAAS,wBAAwB,CAC/B,IAAc,EACd,QAAgB,EAChB,gBAA+B,EAC/B,oBAAuC,QAAQ;IAE/C,MAAM,0BAA0B,GAAG,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAC3D,MAAM,YAAY,GAChB,IAGD,CAAC,2BAA2B,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,0BAA0B,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CACnD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,0BAA0B,CAAC,WAAW,EAAE,CACxE,CAAA;YACD,IAAI,cAAc,IAAI,YAAY,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;gBAC3D,GAAG,CACD,uBAAuB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,QAAQ,aAAa,0BAA0B,IAAI;sBAC5G,MAAM,YAAY,CAAC,cAAc,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACnD,CAAA;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,cAAc,CAAE,CAAC,CAAC,CAAA;YAC3D,CAAC;YAED,IAAI,iBAAiB,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3E,GAAG,CACD,6BAA6B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,QAAQ,aAAa,0BAA0B,IAAI;sBAClH,mDAAmD,CACtD,CAAA;gBACD,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAA;QACjD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,GAAG,CACD,2BAA2B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,QAAQ,aAAa,gBAAgB,6DAA6D,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAC1M,CAAA;YACH,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,uCAAuC,CAAC,QAAQ,CAAC,CAAA;IAClE,GAAG,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,QAAQ,gBAAgB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3G,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,yBAAyB,CAChC,IAAc,EACd,QAAgB,EAChB,gBAA+B;IAE/B,MAAM,0BAA0B,GAAG,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAC3D,IAAI,CAAC,0BAA0B;QAAE,OAAO,EAAE,CAAA;IAE1C,MAAM,YAAY,GAChB,IAGD,CAAC,2BAA2B,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAA;IAE5B,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CACnD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,0BAA0B,CAAC,WAAW,EAAE,CACxE,CAAA;IACD,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3E,OAAO,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAChE,CAAC;AAED,SAAS,wBAAwB,CAC/B,UAAoB,EACpB,eAAmC,EACnC,qBAAiE;IAEjE,IAAI,mBAAmB,GAAiC,IAAI,CAAA;IAC5D,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;QAC1D,MAAM,SAAS,GAAG,8BAA8B,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAA;QACrF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;YACjC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;QAChC,CAAC;QACD,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,mBAAmB,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,mBAAmB,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAc,EACd,eAA0C,EAC1C,gBAA+B,EAC/B,gBAA+B,EAC/B,oBAAuC,QAAQ;IAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS;SAC7B,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAChD,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAE5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEpE,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;QAC9B,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACxD,CAAC;IAED,IAAI,iBAAiB,KAAK,SAAS,IAAI,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,wBAAwB,CACxC,UAAU,EACV,eAAe,EACf,CAAC,QAAQ,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAC1E,CAAA;QACD,IAAI,SAAS;YAAE,OAAO,SAAS,CAAA;IACjC,CAAC;IAED,OAAO,wBAAwB,CAC7B,UAAU,EACV,eAAe,EACf,CAAC,QAAQ,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAC5F,CAAA;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAiB,EACjB,eAA0C,EAC1C,gBAA+B,EAC/B,gBAA+B,EAC/B,oBAAuC,QAAQ;IAE/C,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAiC,CAAA;IAClE,IAAI,CAAC,eAAe,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,iBAAiB;SAClB,CAAA;IACH,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;QAC/G,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACvB,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACxC,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,cAAc;QACd,iBAAiB;KAClB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,OAA8B;IAChF,MAAM,QAAQ,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAA;IACrD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpF,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;IACvC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;IAC5B,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC"}
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../src/proxy/routing.ts"],"names":[],"mappings":"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"}