@sentropic/llm-mesh 0.25.0 → 0.26.1

package/dist/enrollment/seat-bundle.js

@@ -0,0 +1,304 @@
+// @sentropic/llm-mesh/enrollment/seat-bundle.ts
+//
+// SeatBundleV1: frozen five-CLI seat envelope and source contract.
+// Lot L0a, synthetic first: types plus static validators only.
+// This module performs no home, keyring, network or provider access.
+// Native profile variants stay UNVERIFIED until observed; fixtures are invented.
+export const SEAT_BUNDLE_SCHEMA_VERSION = 1;
+/** GitHub repository-secret snapshot limit; each serialized bundle must fit. */
+export const SEAT_BUNDLE_MAX_BYTES = 48 * 1024;
+/** Package enrollment identity per CLI; agy enrolls as cloud-code. */
+export const SEAT_PACKAGE_PROVIDER_ID = {
+    agy: 'cloud-code',
+    codex: 'codex',
+    vibe: 'mistral-vibe',
+    muse: 'muse',
+    claude: 'claude-code',
+};
+/** Application receiver tuple for agy; application cloud-code targets gemini and is refused. */
+export const SEAT_AGY_APPLICATION_TUPLE = {
+    transportProviderId: 'antigravity',
+    targetProviderId: 'cloudcode-pa',
+    productAccountSource: 'antigravity',
+};
+/** Channel rank: a bundle claim above the granted channel is an escalation. */
+const AUTHORITY_RANK = { consumer: 0, 'native-store': 1, custodian: 2 };
+/** Refresh-capable key pattern, matched case-insensitively against every key. */
+const REFRESH_KEY_PATTERN = /refresh|session.?token|device.?(code|token)/i;
+const TOP_LEVEL_KEYS = [
+    'identity', 'provenance', 'authority', 'credentialClass',
+    'lifecycle', 'canonical', 'nativeUse', 'meshUse',
+];
+const IDENTITY_KEYS = [
+    'schemaVersion', 'seatRef', 'refreshFamilyRef', 'ownerScope', 'cli',
+    'packageProviderId', 'issuingClientRef', 'endpointFamily',
+    'credentialFormatVersion', 'nativeCliVersion', 'os',
+];
+const PROVENANCE_KEYS = ['enrollmentSource', 'accountBinding', 'entitlementClass'];
+const LIFECYCLE_KEYS = [
+    'epoch', 'generation', 'operationId', 'issuedAt',
+    'providerExpiry', 'localExpiryPolicy', 'refreshAuthority',
+];
+const CANONICAL_KEYS = ['kind', 'materialRef'];
+const PROJECTION_KEYS = ['kind', 'accessRef', 'reason'];
+function fail(code, detail) {
+    return { ok: false, code, detail };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function unknownKey(value, allowed) {
+    return Object.keys(value).find((k) => !allowed.includes(k)) ?? null;
+}
+function findRefreshKey(value, depth) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const hit = findRefreshKey(item, depth + 1);
+            if (hit)
+                return hit;
+        }
+        return null;
+    }
+    if (!isRecord(value))
+        return null;
+    for (const key of Object.keys(value)) {
+        if (REFRESH_KEY_PATTERN.test(key))
+            return { key, depth };
+        const hit = findRefreshKey(value[key], depth + 1);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+function nonEmpty(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function validDate(value) {
+    return typeof value === 'string' && !Number.isNaN(Date.parse(value));
+}
+function validInt(value, min) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= min;
+}
+/** Structural validation of one bundle; predecessor comparison stays in isStaleGeneration. */
+export function validateSeatBundle(bundle, ctx) {
+    let serialized = '';
+    try {
+        serialized = JSON.stringify(bundle) ?? '';
+    }
+    catch {
+        return fail('schema-mismatch', 'bundle is not JSON-serializable');
+    }
+    if (new TextEncoder().encode(serialized).length > SEAT_BUNDLE_MAX_BYTES) {
+        return fail('size-exceeded', 'bundle exceeds 48 KiB');
+    }
+    if (!isRecord(bundle))
+        return fail('schema-mismatch', 'bundle must be an object');
+    const badTop = unknownKey(bundle, TOP_LEVEL_KEYS);
+    if (badTop)
+        return fail('unknown-field', `unknown top-level field: ${badTop}`);
+    const { identity, provenance, authority, credentialClass, lifecycle, canonical, nativeUse, meshUse } = bundle;
+    if (!isRecord(identity))
+        return fail('schema-mismatch', 'identity must be an object');
+    if (!isRecord(provenance))
+        return fail('schema-mismatch', 'provenance must be an object');
+    if (!isRecord(lifecycle))
+        return fail('schema-mismatch', 'lifecycle must be an object');
+    if (!isRecord(meshUse))
+        return fail('schema-mismatch', 'meshUse must be an object');
+    const badIdentity = unknownKey(identity, IDENTITY_KEYS);
+    if (badIdentity)
+        return fail('unknown-field', `unknown identity field: ${badIdentity}`);
+    const badProvenance = unknownKey(provenance, PROVENANCE_KEYS);
+    if (badProvenance)
+        return fail('unknown-field', `unknown provenance field: ${badProvenance}`);
+    const badLifecycle = unknownKey(lifecycle, LIFECYCLE_KEYS);
+    if (badLifecycle)
+        return fail('unknown-field', `unknown lifecycle field: ${badLifecycle}`);
+    if (identity['schemaVersion'] !== SEAT_BUNDLE_SCHEMA_VERSION) {
+        return fail('schema-mismatch', 'identity.schemaVersion must be 1');
+    }
+    const cli = identity['cli'];
+    if (cli !== 'agy' && cli !== 'codex' && cli !== 'vibe' && cli !== 'muse' && cli !== 'claude') {
+        return fail('client-mismatch', 'identity.cli must be one of the five seat CLIs');
+    }
+    if (identity['packageProviderId'] !== SEAT_PACKAGE_PROVIDER_ID[cli]) {
+        return fail('client-mismatch', `identity.packageProviderId must be ${SEAT_PACKAGE_PROVIDER_ID[cli]}`);
+    }
+    if (!nonEmpty(identity['issuingClientRef'])) {
+        return fail('client-mismatch', 'identity.issuingClientRef must be non-empty');
+    }
+    if (!nonEmpty(identity['endpointFamily'])) {
+        return fail('client-mismatch', 'identity.endpointFamily must be non-empty');
+    }
+    if (ctx?.issuingClientRef !== undefined && identity['issuingClientRef'] !== ctx.issuingClientRef) {
+        return fail('client-mismatch', 'identity.issuingClientRef does not match the expected client');
+    }
+    if (ctx?.endpointFamily !== undefined && identity['endpointFamily'] !== ctx.endpointFamily) {
+        return fail('client-mismatch', 'identity.endpointFamily does not match the expected family');
+    }
+    if (!nonEmpty(identity['seatRef']))
+        return fail('schema-mismatch', 'identity.seatRef must be non-empty');
+    if (!nonEmpty(identity['ownerScope']))
+        return fail('schema-mismatch', 'identity.ownerScope must be non-empty');
+    if (!nonEmpty(identity['credentialFormatVersion'])) {
+        return fail('schema-mismatch', 'identity.credentialFormatVersion must be non-empty');
+    }
+    if (identity['os'] !== undefined &&
+        identity['os'] !== 'linux' &&
+        identity['os'] !== 'macos' &&
+        identity['os'] !== 'windows') {
+        return fail('schema-mismatch', 'identity.os must be linux, macos or windows');
+    }
+    if (ctx?.ownerScope !== undefined && identity['ownerScope'] !== ctx.ownerScope) {
+        return fail('owner-mismatch', 'identity.ownerScope does not match the verified owner');
+    }
+    if (provenance['enrollmentSource'] !== 'cli')
+        return fail('schema-mismatch', 'provenance.enrollmentSource must be cli');
+    if (!nonEmpty(provenance['accountBinding']))
+        return fail('schema-mismatch', 'provenance.accountBinding must be non-empty');
+    if (!nonEmpty(provenance['entitlementClass'])) {
+        return fail('schema-mismatch', 'provenance.entitlementClass must be non-empty');
+    }
+    if (!validInt(lifecycle['epoch'], 1))
+        return fail('invalid-lifecycle', 'lifecycle.epoch must be an integer >= 1');
+    if (!validInt(lifecycle['generation'], 0)) {
+        return fail('invalid-lifecycle', 'lifecycle.generation must be an integer >= 0');
+    }
+    if (!nonEmpty(lifecycle['operationId']))
+        return fail('invalid-lifecycle', 'lifecycle.operationId must be non-empty');
+    if (!validDate(lifecycle['issuedAt']))
+        return fail('invalid-lifecycle', 'lifecycle.issuedAt must be a valid date');
+    if (!nonEmpty(lifecycle['localExpiryPolicy'])) {
+        return fail('invalid-lifecycle', 'lifecycle.localExpiryPolicy must be non-empty');
+    }
+    if (lifecycle['refreshAuthority'] !== 'custody' && lifecycle['refreshAuthority'] !== 'none') {
+        return fail('invalid-lifecycle', 'lifecycle.refreshAuthority must be custody or none');
+    }
+    if (lifecycle['providerExpiry'] !== undefined && !validDate(lifecycle['providerExpiry'])) {
+        return fail('invalid-lifecycle', 'lifecycle.providerExpiry must be a valid date');
+    }
+    if (authority !== 'custodian' && authority !== 'consumer' && authority !== 'native-store') {
+        return fail('schema-mismatch', 'authority must be custodian, consumer or native-store');
+    }
+    const effective = resolveEffectiveAuthority(authority, ctx?.trustedAuthority ?? 'consumer');
+    if (AUTHORITY_RANK[authority] > AUTHORITY_RANK[effective]) {
+        return fail('authority-escalation', 'bundle claims more authority than the channel grants');
+    }
+    const credClass = credentialClass;
+    if (credClass !== 'renewable' && credClass !== 'static-key' && credClass !== 'access-only' && credClass !== 'store-reference') {
+        return fail('schema-mismatch', 'credentialClass must be a known class');
+    }
+    if (credClass === 'static-key' && identity['refreshFamilyRef'] !== undefined) {
+        return fail('schema-mismatch', 'a static key carries no refresh family');
+    }
+    if (credClass !== 'static-key' && !nonEmpty(identity['refreshFamilyRef'])) {
+        return fail('schema-mismatch', 'a non-static seat requires refreshFamilyRef');
+    }
+    if (effective === 'custodian' && credClass === 'renewable' && lifecycle['refreshAuthority'] !== 'custody') {
+        return fail('invalid-lifecycle', 'a custodian renewable bundle holds custody refresh authority');
+    }
+    if (effective !== 'custodian') {
+        if (lifecycle['refreshAuthority'] !== 'none') {
+            return fail('authority-escalation', 'only the custodian holds refresh authority');
+        }
+        if (credClass === 'renewable') {
+            return fail('authority-escalation', 'only the custodian carries renewable credentials');
+        }
+        if (credClass === 'store-reference' && effective !== 'native-store') {
+            return fail('authority-escalation', 'store references are accepted on the native-store channel only');
+        }
+        if (canonical !== undefined) {
+            return fail('authority-escalation', 'a non-custodian payload cannot carry canonical material');
+        }
+    }
+    for (const [name, projection] of [['nativeUse', nativeUse], ['meshUse', meshUse]]) {
+        if (projection === undefined)
+            continue;
+        if (!isRecord(projection))
+            return fail('schema-mismatch', `${name} must be an object`);
+        if (projection['kind'] !== 'access' && projection['kind'] !== 'static-key' && projection['kind'] !== 'unavailable') {
+            return fail('schema-mismatch', `${name}.kind must be access, static-key or unavailable`);
+        }
+        if (projection['accessRef'] !== undefined && typeof projection['accessRef'] !== 'string') {
+            return fail('schema-mismatch', `${name}.accessRef must be a string`);
+        }
+        if (projection['reason'] !== undefined && typeof projection['reason'] !== 'string') {
+            return fail('schema-mismatch', `${name}.reason must be a string`);
+        }
+        const hit = findRefreshKey(projection, 0);
+        if (hit) {
+            return hit.depth === 0
+                ? fail('refresh-material-present', `${name} carries refresh material: ${hit.key}`)
+                : fail('nested-refresh-field', `${name} hides a nested renewal field: ${hit.key}`);
+        }
+        const bad = unknownKey(projection, PROJECTION_KEYS);
+        if (bad)
+            return fail('unknown-field', `unknown ${name} field: ${bad}`);
+    }
+    if (canonical !== undefined) {
+        if (!isRecord(canonical))
+            return fail('schema-mismatch', 'canonical must be an object');
+        if (canonical['kind'] !== 'renewable-material' && canonical['kind'] !== 'static-key-material') {
+            return fail('schema-mismatch', 'canonical.kind must be a known material kind');
+        }
+        if (!nonEmpty(canonical['materialRef'])) {
+            return fail('schema-mismatch', 'canonical.materialRef must be a non-empty string');
+        }
+        const bad = unknownKey(canonical, CANONICAL_KEYS);
+        if (bad)
+            return fail('unknown-field', `unknown canonical field: ${bad}`);
+    }
+    if (ctx?.predecessor !== undefined) {
+        const transition = classifyTransition(ctx.predecessor, {
+            epoch: lifecycle['epoch'],
+            generation: lifecycle['generation'],
+            operationId: lifecycle['operationId'],
+        });
+        if (transition === 'stale')
+            return fail('stale-generation', 'incoming tuple is older than current');
+        if (transition === 'conflict')
+            return fail('generation-conflict', 'same generation with a different operation');
+        if (transition === 'epoch-replacement-required') {
+            return fail('epoch-replacement-required', 'a new epoch requires the controlled replacement operation');
+        }
+        if (transition === 'idempotent')
+            return { ok: true, bundle: bundle, idempotentReimport: true };
+    }
+    return { ok: true, bundle: bundle };
+}
+/** Five-way lineage classification against the current tuple. */
+export function classifyTransition(current, incoming) {
+    if (incoming.epoch !== current.epoch) {
+        return incoming.epoch < current.epoch ? 'stale' : 'epoch-replacement-required';
+    }
+    if (incoming.generation !== current.generation) {
+        return incoming.generation < current.generation ? 'stale' : 'forward';
+    }
+    return incoming.operationId === current.operationId ? 'idempotent' : 'conflict';
+}
+/** True when the incoming tuple is older than current; same epoch/generation reimports idempotently. */
+export function isStaleGeneration(current, incoming) {
+    return classifyTransition({ ...current, operationId: '' }, { ...incoming, operationId: '' }) === 'stale';
+}
+/** True for a same-tuple reimport that must not mutate the receiving account. */
+export function isIdempotentReimport(current, incoming) {
+    return classifyTransition(current, incoming) === 'idempotent';
+}
+/** The trusted path authority wins; a JSON field claiming an owner is not authorization. */
+export function resolveEffectiveAuthority(_claimed, trustedPathAuthority) {
+    return trustedPathAuthority;
+}
+/** Credential-free receipt; carries metadata only, never credential bytes. */
+export function createReceipt(bundle, outcome, reason, checkedAt) {
+    return {
+        seatRef: bundle.identity.seatRef,
+        cli: bundle.identity.cli,
+        epoch: bundle.lifecycle.epoch,
+        generation: bundle.lifecycle.generation,
+        operationId: bundle.lifecycle.operationId,
+        outcome,
+        ...(reason !== undefined ? { reason } : {}),
+        checkedAt: checkedAt ?? new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=seat-bundle.js.map

package/dist/enrollment/seat-bundle.js.map

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

package/dist/errors.d.ts

@@ -1,4 +1,22 @@
 import type { ProviderId } from './providers.js';
+/** Trusted transport measurement; never derive numbers from provider prose or caller headers. */
+export interface RequestSizeDetail {
+    readonly requestBytes: number;
+    readonly limitBytes?: number;
+    readonly sizeIsLowerBound?: boolean;
+    readonly source: 'gateway' | 'upstream';
+}
+export declare const readRequestSizeDetail: (value: unknown) => RequestSizeDetail | undefined;
+export declare class RequestTooLargeError extends Error {
+    readonly status = 413;
+    readonly code = "request_too_large";
+    readonly requestSize: RequestSizeDetail;
+    constructor(detail: RequestSizeDetail);
+}
+/** Bounded cause traversal retains typed size evidence across runtime/SDK wrappers. */
+export declare const requestTooLargeDetail: (error: unknown) => {
+    requestSize?: RequestSizeDetail;
+} | undefined;
 export type ProviderErrorRetryReason = 'rate_limit' | 'timeout' | 'server_error' | 'network' | 'overloaded' | 'unknown';
 export interface NormalizedProviderError {
     providerId: ProviderId;
@@ -10,6 +28,7 @@ export interface NormalizedProviderError {
     statusCode?: number;
     cause?: unknown;
     metadata?: Record<string, unknown>;
+    requestSize?: RequestSizeDetail;
 }
 export interface ProviderErrorNormalizationOptions {
     defaultMessage?: string;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAChC,YAAY,GACZ,SAAS,GACT,cAAc,GACd,SAAS,GACT,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iCAAiC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AA6CD,eAAO,MAAM,wBAAwB,eACvB,MAAM,GAAG,SAAS,QACxB,MAAM,GAAG,SAAS,YACf,iCAAiC,KACzC,OAYF,CAAC;AAEF,eAAO,MAAM,sBAAsB,eACrB,UAAU,SACf,OAAO,YACL,iCAAiC,KACzC,uBAsCF,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;CACzC;AAED,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG,iBAAiB,GAAG,SAS1E,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;gBAC5B,MAAM,EAAE,iBAAiB;CAOtC;AAED,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG;IAAE,WAAW,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAAG,SAgB5F,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,YAAY,GACZ,SAAS,GACT,cAAc,GACd,SAAS,GACT,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,iCAAiC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AA6CD,eAAO,MAAM,wBAAwB,eACvB,MAAM,GAAG,SAAS,QACxB,MAAM,GAAG,SAAS,YACf,iCAAiC,KACzC,OAcF,CAAC;AAEF,eAAO,MAAM,sBAAsB,eACrB,UAAU,SACf,OAAO,YACL,iCAAiC,KACzC,uBAwCF,CAAC"}

package/dist/errors.js

@@ -1,3 +1,45 @@
+export const readRequestSizeDetail = (value) => {
+    const detail = value;
+    if (!detail || typeof detail !== 'object' || !Number.isSafeInteger(detail.requestBytes)
+        || detail.requestBytes < 0 || (detail.source !== 'gateway' && detail.source !== 'upstream')
+        || (detail.limitBytes !== undefined && (!Number.isSafeInteger(detail.limitBytes) || detail.limitBytes <= 0))
+        || (detail.sizeIsLowerBound !== undefined && typeof detail.sizeIsLowerBound !== 'boolean'))
+        return undefined;
+    return Object.freeze({ requestBytes: detail.requestBytes, source: detail.source,
+        ...(detail.limitBytes !== undefined ? { limitBytes: detail.limitBytes } : {}),
+        ...(detail.sizeIsLowerBound !== undefined ? { sizeIsLowerBound: detail.sizeIsLowerBound } : {}) });
+};
+export class RequestTooLargeError extends Error {
+    status = 413;
+    code = 'request_too_large';
+    requestSize;
+    constructor(detail) {
+        super('Request body is too large');
+        this.name = 'RequestTooLargeError';
+        const safe = readRequestSizeDetail(detail);
+        if (!safe)
+            throw new TypeError('Invalid request size measurement');
+        this.requestSize = safe;
+    }
+}
+/** Bounded cause traversal retains typed size evidence across runtime/SDK wrappers. */
+export const requestTooLargeDetail = (error) => {
+    let current = error;
+    let detected = false;
+    let requestSize;
+    const seen = new Set();
+    for (let depth = 0; depth < 8 && current && typeof current === 'object' && !seen.has(current); depth++) {
+        seen.add(current);
+        const record = current;
+        const metadata = record.metadata;
+        requestSize ??= readRequestSizeDetail(record.requestSize) ?? readRequestSizeDetail(metadata?.requestSize);
+        detected ||= record.status === 413 || record.statusCode === 413 || record.kind === 'request-too-large'
+            || [record.code, record.type].some(value => typeof value === 'string'
+                && ['request_too_large', 'request-too-large'].includes(value.toLowerCase()));
+        current = record.cause ?? record.error ?? record.response;
+    }
+    return detected ? { ...(requestSize ? { requestSize } : {}) } : undefined;
+};
 const defaultRetryableStatusCodes = [408, 409, 425, 429, 500, 502, 503, 504];
 const defaultRetryableCodes = [
     'rate_limit',
@@ -37,6 +79,9 @@ const inferRetryReason = (statusCode, code) => {
     return undefined;
 };
 export const isRetryableProviderError = (statusCode, code, options = {}) => {
+    if (statusCode === 413 || code?.toLowerCase() === 'request_too_large'
+        || code?.toLowerCase() === 'request-too-large')
+        return false;
     const retryableStatusCodes = options.retryableStatusCodes ?? defaultRetryableStatusCodes;
     const retryableCodes = options.retryableCodes ?? defaultRetryableCodes;
     const nonRetryableCodes = options.nonRetryableCodes ?? [];
@@ -52,15 +97,16 @@ export const isRetryableProviderError = (statusCode, code, options = {}) => {
 export const normalizeProviderError = (providerId, error, options = {}) => {
     const record = asRecord(error);
     const nested = nestedErrorRecord(record);
-    const statusCode = readNumber(record, 'statusCode') ||
+    const tooLarge = requestTooLargeDetail(error);
+    const statusCode = (tooLarge ? 413 : undefined) || readNumber(record, 'statusCode') ||
         readNumber(record, 'status') ||
         readNumber(nested, 'statusCode') ||
         readNumber(nested, 'status');
-    const code = readString(record, 'code') ||
+    const code = (tooLarge ? 'request_too_large' : undefined) || readString(record, 'code') ||
         readString(record, 'type') ||
         readString(nested, 'code') ||
         readString(nested, 'status');
-    const message = readString(record, 'message') ||
+    const message = (tooLarge ? 'Request body is too large' : undefined) || readString(record, 'message') ||
         readString(nested, 'message') ||
         (error instanceof Error && error.message) ||
         options.defaultMessage ||
@@ -77,7 +123,8 @@ export const normalizeProviderError = (providerId, error, options = {}) => {
         retryable,
         ...(code ? { code } : {}),
         ...(retryReason ? { retryReason } : {}),
-        ...(retryAfterMs ? { retryAfterMs } : {}),
+        ...(!tooLarge && retryAfterMs ? { retryAfterMs } : {}),
+        ...(tooLarge?.requestSize ? { requestSize: tooLarge.requestSize } : {}),
         ...(typeof statusCode === 'number' ? { statusCode } : {}),
         ...(error instanceof Error || record ? { cause: error } : {}),
     };

package/dist/errors.js.map

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

package/dist/execution-features.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Execution features (spec §16.3): request requirements finer than the
+ * existing `requiredCapabilities`, derived by the gateway from validated
+ * Responses input — never from a caller-supplied feature list:
+ * named/parallel tool control, strict schema, structured output, reasoning
+ * controls, native reasoning replay, verbosity and an explicit output
+ * ceiling.
+ *
+ * This module holds capability facts only: the feature taxonomy, the
+ * mesh-known per-transport support table and one pure predicate. It copies
+ * no route map (keyed by transport, never by model, account or affinity).
+ * Unknown support is not support: a transport with no proven declaration
+ * for a required feature is ineligible, before acquisition.
+ *
+ * Two taxonomy items are bounded extensions from pinned CLI captures
+ * (spec §16.9): `reasoning-context` (Codex `reasoning.context`, a
+ * server-side retention semantic only native Codex execution can honor)
+ * and `custom-tools` (Codex freeform tools, carried opaquely for native
+ * execution only). Translated adapters never declare them.
+ */
+export type ExecutionFeature = 'named-tool-choice' | 'parallel-tool-control' | 'strict-schema' | 'structured-output' | 'reasoning-controls' | 'reasoning-context' | 'custom-tools' | 'native-reasoning-replay' | 'verbosity' | 'explicit-output-ceiling';
+export declare const EXECUTION_FEATURES: readonly ExecutionFeature[];
+/** Mesh-known support for a transport; empty when unknown (fail closed). */
+export declare const declaredExecutionFeatures: (transportProviderId: string) => readonly ExecutionFeature[];
+/**
+ * Pure eligibility of one actual model/transport pair. Shared by planning
+ * and quoting, including quote identity/revalidation:
+ * - no required features: eligible (no behavior change for existing wires);
+ * - unpinned transport: kept — the plan-time account check decides;
+ * - pinned transport: every required feature must be in the trusted
+ *   declaration (per-account override when supplied, else the mesh table).
+ */
+export declare const transportSupportsExecutionFeatures: (transportProviderId: string | undefined, required: readonly ExecutionFeature[] | undefined, declared?: readonly ExecutionFeature[] | undefined) => boolean;
+//# sourceMappingURL=execution-features.d.ts.map

package/dist/execution-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-features.d.ts","sourceRoot":"","sources":["../src/execution-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,cAAc,GACd,yBAAyB,GACzB,WAAW,GACX,yBAAyB,CAAC;AAE9B,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAWzD,CAAC;AAoCF,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,wBACf,MAAM,KAC1B,SAAS,gBAAgB,EAC6B,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,wBACxB,MAAM,GAAG,SAAS,YAC7B,SAAS,gBAAgB,EAAE,GAAG,SAAS,aACtC,SAAS,gBAAgB,EAAE,GAAG,SAAS,KACjD,OAOF,CAAC"}

package/dist/execution-features.js

@@ -0,0 +1,84 @@
+/**
+ * Execution features (spec §16.3): request requirements finer than the
+ * existing `requiredCapabilities`, derived by the gateway from validated
+ * Responses input — never from a caller-supplied feature list:
+ * named/parallel tool control, strict schema, structured output, reasoning
+ * controls, native reasoning replay, verbosity and an explicit output
+ * ceiling.
+ *
+ * This module holds capability facts only: the feature taxonomy, the
+ * mesh-known per-transport support table and one pure predicate. It copies
+ * no route map (keyed by transport, never by model, account or affinity).
+ * Unknown support is not support: a transport with no proven declaration
+ * for a required feature is ineligible, before acquisition.
+ *
+ * Two taxonomy items are bounded extensions from pinned CLI captures
+ * (spec §16.9): `reasoning-context` (Codex `reasoning.context`, a
+ * server-side retention semantic only native Codex execution can honor)
+ * and `custom-tools` (Codex freeform tools, carried opaquely for native
+ * execution only). Translated adapters never declare them.
+ */
+export const EXECUTION_FEATURES = [
+    'named-tool-choice',
+    'parallel-tool-control',
+    'strict-schema',
+    'structured-output',
+    'reasoning-controls',
+    'reasoning-context',
+    'custom-tools',
+    'native-reasoning-replay',
+    'verbosity',
+    'explicit-output-ceiling',
+];
+/**
+ * Mesh-known execution support per account transport. Populated only with
+ * proven adapter controls as their fixes land with tests (D16-C); a
+ * transport absent here has unknown support and is ineligible for any
+ * required feature. Never a model route map — transport keys only.
+ *
+ * D16-C proofs: Codex projects named choice, parallel control, reasoning
+ * (including `reasoning.context`), strict schemas, `text.verbosity`,
+ * `prompt_cache_key`, custom tools with their namespace and completed
+ * reasoning items natively (it cannot enforce an explicit output ceiling —
+ * no `max_output_tokens` slot, spec §16.4). The translated Chat clients
+ * project named choice and parallel control with tests; Mistral
+ * additionally forwards the Vibe-proven `reasoning_effort` slot. Meta has
+ * no proven reasoning slot on the Chat egress (spec §16.4, R5-MAJ-1):
+ * unauthenticated probes are auth-first (401 for every variant), Meta 400s
+ * unknown params (`max_output_tokens` precedent), and the binary
+ * `reasoningEffort` belongs to the native TBH `/responses` transport, not
+ * this OpenAI-compat shim — so `muse` declares no `reasoning-controls` and
+ * reasoning requests fail closed until a slot is proven by an authenticated
+ * probe. `max_tokens` is projected, so `explicit-output-ceiling` holds.
+ * Both translated clients forward the validated `strict` flag on function
+ * tools (standard OpenAI function shape); a provider that rejects it fails
+ * visibly as a provider 400, never as a silent drop.
+ */
+const TRANSPORT_EXECUTION_FEATURES = {
+    codex: ['named-tool-choice', 'parallel-tool-control', 'reasoning-controls', 'strict-schema',
+        'reasoning-context', 'custom-tools', 'verbosity'],
+    muse: ['named-tool-choice', 'parallel-tool-control', 'explicit-output-ceiling',
+        'strict-schema'],
+    'mistral-vibe': ['named-tool-choice', 'parallel-tool-control', 'reasoning-controls', 'strict-schema'],
+};
+/** Mesh-known support for a transport; empty when unknown (fail closed). */
+export const declaredExecutionFeatures = (transportProviderId) => TRANSPORT_EXECUTION_FEATURES[transportProviderId] ?? [];
+/**
+ * Pure eligibility of one actual model/transport pair. Shared by planning
+ * and quoting, including quote identity/revalidation:
+ * - no required features: eligible (no behavior change for existing wires);
+ * - unpinned transport: kept — the plan-time account check decides;
+ * - pinned transport: every required feature must be in the trusted
+ *   declaration (per-account override when supplied, else the mesh table).
+ */
+export const transportSupportsExecutionFeatures = (transportProviderId, required, declared) => {
+    if (!required || required.length === 0)
+        return true;
+    if (transportProviderId === undefined)
+        return true;
+    const support = declared
+        ?? TRANSPORT_EXECUTION_FEATURES[transportProviderId]
+        ?? [];
+    return required.every((feature) => support.includes(feature));
+};
+//# sourceMappingURL=execution-features.js.map

package/dist/execution-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-features.js","sourceRoot":"","sources":["../src/execution-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,mBAAmB;IACnB,uBAAuB;IACvB,eAAe;IACf,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;IACnB,cAAc;IACd,yBAAyB;IACzB,WAAW;IACX,yBAAyB;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,4BAA4B,GAE9B;IACF,KAAK,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,eAAe;QACzF,mBAAmB,EAAE,cAAc,EAAE,WAAW,CAAC;IACnD,IAAI,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,yBAAyB;QAC5E,eAAe,CAAC;IAClB,cAAc,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,eAAe,CAAC;CACtG,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,mBAA2B,EACE,EAAE,CAC/B,4BAA4B,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,mBAAuC,EACvC,QAAiD,EACjD,QAAkD,EACzC,EAAE;IACX,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,mBAAmB,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,OAAO,GAAG,QAAQ;WACnB,4BAA4B,CAAC,mBAAmB,CAAC;WACjD,EAAE,CAAC;IACR,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC"}

package/dist/generated-model-council.d.ts

@@ -1,10 +1,10 @@
 export declare const GENERATED_MODEL_COUNCIL_SOURCE: {
     readonly revision: "2026-10-07.1";
-    readonly digest: "sha256:d5dddbf432757b74860febd7bd8721d343a08d804b747e09b2d712d56a78da7e";
+    readonly digest: "sha256:7b77e4f444f9ee6cfaf69ac320a6ac264b24bc527a518e9d2e795acdccc6814a";
     readonly expiresAt: "2027-03-03T00:00:00.000Z";
     readonly reason: "No pinned benchmark evidence authorizes automatic substitution.";
     readonly reviewer: "GPT-6.1 Sol catalog owner directive";
     readonly provenance: "feat/llm-mesh-mistral-vibe-glm53 owner task; inherited capabilities unverified; no benchmark evidence";
-    readonly excludedModelKeys: readonly ["anthropic:claude-fable-5", "anthropic:claude-fable-5-1", "anthropic:claude-opus-4-8", "anthropic:claude-opus-5", "anthropic:claude-sonnet-5", "cohere:command-a-03-2025", "cohere:command-a-reasoning-08-2025", "gcp:anthropic/claude-opus-4-6@gcp", "gcp:anthropic/claude-sonnet-4-6@gcp", "gcp:google/gemini-3.1-flash-lite@gcp", "gcp:google/gemini-3.5-flash@gcp", "gemini:gemini-3.1-flash-lite", "gemini:gemini-3.5-flash", "gemini:gemini-3.7-flash", "gemini:gemini-3.8-flash", "mistral:magistral-medium-2509", "mistral:mistral-large-4", "mistral:mistral-small-2603", "mistral:zai-glm-5-3", "muse:muse-spark-1.3", "muse:muse-spark-1.3-contributor", "openai:gpt-4.1-nano", "openai:gpt-5.4-nano", "openai:gpt-5.5", "openai:gpt-5.6-luna", "openai:gpt-5.6-sol", "openai:gpt-5.6-terra", "openai:gpt-6-astra", "openai:gpt-6-luna", "openai:gpt-6-sol", "openai:gpt-6.1-sol"];
+    readonly excludedModelKeys: readonly ["anthropic:claude-fable-5", "anthropic:claude-fable-5-1", "anthropic:claude-opus-4-8", "anthropic:claude-opus-5", "anthropic:claude-sonnet-5", "cohere:command-a-03-2025", "cohere:command-a-reasoning-08-2025", "gcp:anthropic/claude-opus-4-6@gcp", "gcp:anthropic/claude-sonnet-4-6@gcp", "gcp:google/gemini-3.1-flash-lite@gcp", "gcp:google/gemini-3.5-flash@gcp", "gemini:gemini-3.1-flash-lite", "gemini:gemini-3.5-flash", "gemini:gemini-3.7-flash", "gemini:gemini-3.8-flash", "gemini:gemini-4-argon", "mistral:magistral-medium-2509", "mistral:mistral-large-4", "mistral:mistral-medium-3.5", "mistral:mistral-small-2603", "mistral:zai-glm-5-3", "muse:muse-spark-1.3", "muse:muse-spark-1.3-contributor", "muse:muse-wonder-1.0", "muse:muse-wonder-full-1.0", "openai:gpt-4.1-nano", "openai:gpt-5.4-nano", "openai:gpt-5.5", "openai:gpt-5.6-luna", "openai:gpt-5.6-sol", "openai:gpt-5.6-terra", "openai:gpt-6-astra", "openai:gpt-6-luna", "openai:gpt-6-sol", "openai:gpt-6.1-sol"];
 };
 //# sourceMappingURL=generated-model-council.d.ts.map

package/dist/generated-model-council.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-model-council.d.ts","sourceRoot":"","sources":["../src/generated-model-council.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,8BAA8B;;;;;;;;CAwCjC,CAAC"}
+{"version":3,"file":"generated-model-council.d.ts","sourceRoot":"","sources":["../src/generated-model-council.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,8BAA8B;;;;;;;;CA4CjC,CAAC"}