@sentropic/llm-mesh 0.27.1 → 0.28.1

package/dist/decision/verdict.js

@@ -0,0 +1,140 @@
+import { isDecisionRule, scoreDirections } from './criterion.js';
+import { has, hasOnlyKeys, isRecord, isText, snapshotBoundedJson } from './validation.js';
+/** Preserve native values and direction; normalization is relative position, not accuracy. */
+export function parseDecisionScore(candidate) {
+    const snapshot = snapshotBoundedJson(candidate);
+    if (!snapshot.ok)
+        return null;
+    const value = snapshot.value;
+    if (!isRecord(value) || !hasOnlyKeys(value, ['value', 'scale', 'meaning', 'normalized'])
+        || typeof value.value !== 'number' || !Number.isFinite(value.value) || !isRecord(value.scale)
+        || !['rubric-grade', 'probability-true', 'support', 'provider-defined'].some((v) => v === value.meaning))
+        return null;
+    const scale = value.scale;
+    let position;
+    if (scale.kind === 'unknown') {
+        if (!hasOnlyKeys(scale, ['kind', 'reason']) || scale.reason !== 'unknown (source-gap)' || has(value, 'normalized'))
+            return null;
+    }
+    else if (scale.kind === 'bounded') {
+        if (!hasOnlyKeys(scale, ['kind', 'min', 'max', 'direction'])
+            || typeof scale.min !== 'number' || typeof scale.max !== 'number'
+            || !Number.isFinite(scale.min) || !Number.isFinite(scale.max) || scale.max < scale.min
+            || value.value < scale.min || value.value > scale.max
+            || !scoreDirections.some((direction) => direction === scale.direction))
+            return null;
+        const span = scale.max - scale.min;
+        if (span > 0 && Number.isFinite(span))
+            position = (value.value - scale.min) / span;
+    }
+    else
+        return null;
+    if (has(value, 'normalized') && (!isRecord(value.normalized)
+        || !hasOnlyKeys(value.normalized, ['value', 'transform']) || position === undefined
+        || value.normalized.transform !== 'linear-min-max' || typeof value.normalized.value !== 'number'
+        || !Number.isFinite(value.normalized.value) || value.normalized.value !== position))
+        return null;
+    return { value: value.value, scale: { ...scale }, meaning: value.meaning,
+        ...(position === undefined ? {} : { normalized: { value: position, transform: 'linear-min-max' } }) };
+}
+/** A descriptor supplies the documented meaning; this never derives confidence from score. */
+export function parseDecisionConfidence(candidate) {
+    const snapshot = snapshotBoundedJson(candidate);
+    if (!snapshot.ok)
+        return null;
+    const value = snapshot.value;
+    if (!isRecord(value)
+        || !hasOnlyKeys(value, ['value', 'min', 'max', 'meaning', 'meaningRef', 'origin'])
+        || typeof value.value !== 'number' || typeof value.min !== 'number' || typeof value.max !== 'number'
+        || !Number.isFinite(value.value) || !Number.isFinite(value.min) || !Number.isFinite(value.max)
+        || value.max < value.min || value.value < value.min || value.value > value.max
+        || (value.meaning !== 'provider-confidence' && value.meaning !== 'decision-confidence')
+        || !isText(value.meaningRef) || value.origin !== 'provider')
+        return null;
+    return { value: value.value, min: value.min, max: value.max, meaning: value.meaning,
+        meaningRef: value.meaningRef, origin: 'provider' };
+}
+/** Map an exact, descriptor-owned native key set, preserving order and probabilities. */
+export function mapDecisionDistribution(candidate, declared) {
+    const snapshot = snapshotBoundedJson(candidate);
+    const outcomeSnapshot = snapshotBoundedJson(declared);
+    if (!snapshot.ok || !outcomeSnapshot.ok || !Array.isArray(outcomeSnapshot.value))
+        return null;
+    const probabilities = snapshot.value;
+    const outcomes = outcomeSnapshot.value;
+    if (!isRecord(probabilities) || !outcomes.length || Object.keys(probabilities).length !== outcomes.length)
+        return null;
+    let sum = 0;
+    const outcomeIds = new Set();
+    const nativeIds = new Set();
+    const entries = [];
+    for (const item of outcomes) {
+        if (!isRecord(item) || !hasOnlyKeys(item, ['outcome', 'nativeOutcome']))
+            return null;
+        const { outcome, nativeOutcome } = item;
+        if (!isText(outcome) || !isText(nativeOutcome) || outcomeIds.has(outcome) || nativeIds.has(nativeOutcome))
+            return null;
+        const probability = probabilities[nativeOutcome];
+        if (!has(probabilities, nativeOutcome)
+            || typeof probability !== 'number' || !Number.isFinite(probability)
+            || probability < 0 || probability > 1)
+            return null;
+        sum += probability;
+        outcomeIds.add(outcome);
+        nativeIds.add(nativeOutcome);
+        entries.push({ outcome, nativeOutcome, probability });
+    }
+    if (Math.abs(sum - 1) > 1e-4)
+        return null;
+    return entries;
+}
+export function deriveDecision(input) {
+    const { rule, score, label, providerDecision } = input;
+    if (rule !== undefined && !isDecisionRule(rule))
+        return { ok: false, code: 'REQUEST_INVALID' };
+    if (providerDecision !== null) {
+        if (typeof providerDecision !== 'boolean')
+            return { ok: false, code: 'VERDICT_INVALID' };
+        if (rule && rule.kind !== 'provider')
+            return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+        return { ok: true, decision: { pass: providerDecision, origin: 'provider' } };
+    }
+    if (!rule)
+        return { ok: true, decision: null };
+    if (rule.kind === 'provider')
+        return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+    if (rule.kind === 'threshold') {
+        if (score === null)
+            return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+        const checked = parseDecisionScore(score);
+        if (checked === null)
+            return { ok: false, code: 'VERDICT_INVALID' };
+        if (checked.scale.kind === 'unknown')
+            return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+        if (rule.value < checked.scale.min || rule.value > checked.scale.max)
+            return { ok: false, code: 'REQUEST_INVALID' };
+        return { ok: true, decision: { pass: rule.op === 'gte' ? checked.value >= rule.value : checked.value <= rule.value,
+                origin: 'threshold', rule: { ...rule } } };
+    }
+    const declared = input.declaredLabels ?? [];
+    if (label === null || !declared.length)
+        return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+    if (!declared.includes(label))
+        return { ok: false, code: 'VERDICT_INVALID' };
+    if (!rule.passing.every((v) => declared.includes(v)))
+        return { ok: false, code: 'REQUEST_INVALID' };
+    return { ok: true, decision: { pass: rule.passing.includes(label), origin: 'labels',
+            rule: { kind: 'labels', passing: [...rule.passing] } } };
+}
+/** Primary values must be meaningful; false and zero are valid evidence. */
+export function hasDecisionVerdictValue(value) {
+    if (value.score !== null && parseDecisionScore(value.score) === null)
+        return false;
+    if (value.decision !== null && (!isRecord(value.decision) || typeof value.decision.pass !== 'boolean'
+        || !['provider', 'threshold', 'labels'].includes(value.decision.origin)))
+        return false;
+    if (value.label !== null && (!isRecord(value.label) || !isText(value.label.value) || value.label.origin !== 'provider'))
+        return false;
+    return value.score !== null || value.decision !== null || value.label !== null;
+}
+//# sourceMappingURL=verdict.js.map

package/dist/decision/verdict.js.map

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

package/dist/index.d.ts

@@ -30,5 +30,6 @@ export * from './transport/claude-code-runtime-client.js';
 export * from './transport/muse-runtime-client.js';
 export * from './transport/mistral-runtime-client.js';
 export * from './streaming.js';
+export * from './speech/index.js';
 export * from './tools.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,0BAA0B,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,iBAAiB,GAChF,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,0BAA0B,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,iBAAiB,GAChF,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -30,5 +30,6 @@ export * from './transport/claude-code-runtime-client.js';
 export * from './transport/muse-runtime-client.js';
 export * from './transport/mistral-runtime-client.js';
 export * from './streaming.js';
+export * from './speech/index.js';
 export * from './tools.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,0BAA0B,EAAE,eAAe,EAAE,UAAU,GACxD,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,0BAA0B,EAAE,eAAe,EAAE,UAAU,GACxD,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/providers.d.ts

@@ -1,7 +1,7 @@
-export declare const providerIds: readonly ["openai", "gemini", "anthropic", "mistral", "cohere", "gcp", "local", "muse"];
+export declare const providerIds: readonly ["openai", "gemini", "anthropic", "mistral", "cohere", "gcp", "local", "muse", "typesafe"];
 export type ProviderId = (typeof providerIds)[number];
 export type ProviderStatus = 'ready' | 'planned';
-export type ProviderFamily = 'openai' | 'google' | 'anthropic' | 'mistral' | 'cohere' | 'meta';
+export type ProviderFamily = 'openai' | 'google' | 'anthropic' | 'mistral' | 'cohere' | 'meta' | 'typesafe';
 export type ReasoningTier = 'none' | 'light' | 'standard' | 'advanced';
 export type ModelTaskHint = 'chat' | 'structured' | 'summary' | 'doc';
 export declare const knownModelIds: readonly ["gpt-5.6-sol", "gpt-6-sol", "gpt-6.1-sol", "gpt-6-astra", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-6-luna", "gpt-5.5", "gpt-5.4-nano", "gpt-4.1-nano", "gemini-3.7-flash", "gemini-3.8-flash", "gemini-4-argon", "gemini-3.5-flash", "gemini-3.1-flash-lite", "claude-sonnet-5", "claude-opus-5", "claude-opus-4-8", "claude-fable-5", "claude-fable-5-1", "mistral-small-2603", "magistral-medium-2509", "mistral-large-4", "mistral-medium-3.5", "zai-glm-5-3", "command-a-03-2025", "command-a-reasoning-08-2025", "google/gemini-3.5-flash@gcp", "google/gemini-3.1-flash-lite@gcp", "anthropic/claude-sonnet-4-6@gcp", "anthropic/claude-opus-4-6@gcp", "laneformer-2b-it", "muse-spark-1.3", "muse-spark-1.3-contributor", "muse-wonder-1.0", "muse-wonder-full-1.0"];
@@ -17,6 +17,7 @@ export declare const knownModelIdsByProvider: {
     readonly gcp: readonly ["google/gemini-3.5-flash@gcp", "google/gemini-3.1-flash-lite@gcp", "anthropic/claude-sonnet-4-6@gcp", "anthropic/claude-opus-4-6@gcp"];
     readonly local: readonly ["laneformer-2b-it"];
     readonly muse: readonly ["muse-spark-1.3", "muse-spark-1.3-contributor", "muse-wonder-1.0", "muse-wonder-full-1.0"];
+    readonly typesafe: readonly [];
 };
 export interface ModelReference {
     providerId: ProviderId;
@@ -25,6 +26,6 @@ export interface ModelReference {
 export declare const toQualifiedModelId: (model: ModelReference) => QualifiedModelId;
 export declare const antigravityModelFleet: readonly ["claude-sonnet-4-6", "claude-opus-4-6-thinking", "gemini-3-pro-high", "gemini-3-pro-low", "gpt-oss-120b-medium"];
 export type AntigravityFleetModelId = (typeof antigravityModelFleet)[number];
-export declare const isProviderId: (value: string) => value is "openai" | "gemini" | "anthropic" | "mistral" | "cohere" | "gcp" | "local" | "muse";
+export declare const isProviderId: (value: string) => value is "openai" | "gemini" | "anthropic" | "mistral" | "cohere" | "gcp" | "local" | "muse" | "typesafe";
 export declare const isKnownModelId: (value: string) => value is "gpt-5.6-sol" | "gpt-6-sol" | "gpt-6.1-sol" | "gpt-6-astra" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-6-luna" | "gpt-5.5" | "gpt-5.4-nano" | "gpt-4.1-nano" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-4-argon" | "gemini-3.5-flash" | "gemini-3.1-flash-lite" | "claude-sonnet-5" | "claude-opus-5" | "claude-opus-4-8" | "claude-fable-5" | "claude-fable-5-1" | "mistral-small-2603" | "magistral-medium-2509" | "mistral-large-4" | "mistral-medium-3.5" | "zai-glm-5-3" | "command-a-03-2025" | "command-a-reasoning-08-2025" | "google/gemini-3.5-flash@gcp" | "google/gemini-3.1-flash-lite@gcp" | "anthropic/claude-sonnet-4-6@gcp" | "anthropic/claude-opus-4-6@gcp" | "laneformer-2b-it" | "muse-spark-1.3" | "muse-spark-1.3-contributor" | "muse-wonder-1.0" | "muse-wonder-full-1.0";
 //# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,yFAA0F,CAAC;AAEnH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/F,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAEtE,eAAO,MAAM,aAAa,ovBAiEhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAEzD,eAAO,MAAM,uBAAuB;;;;;;;;;CAoB4B,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB,UAAW,cAAc,KAAG,gBAE1D,CAAC;AAUF,eAAO,MAAM,qBAAqB,4HAMxB,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E,eAAO,MAAM,YAAY,UAAW,MAAM,iGAEzC,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,MAAM,wxBAE3C,CAAC"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,qGAAsG,CAAC;AAE/H,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5G,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAEtE,eAAO,MAAM,aAAa,ovBAiEhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAEzD,eAAO,MAAM,uBAAuB;;;;;;;;;;CAqB4B,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB,UAAW,cAAc,KAAG,gBAE1D,CAAC;AAUF,eAAO,MAAM,qBAAqB,4HAMxB,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E,eAAO,MAAM,YAAY,UAAW,MAAM,8GAEzC,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,MAAM,wxBAE3C,CAAC"}

package/dist/providers.js

@@ -1,4 +1,4 @@
-export const providerIds = ['openai', 'gemini', 'anthropic', 'mistral', 'cohere', 'gcp', 'local', 'muse'];
+export const providerIds = ['openai', 'gemini', 'anthropic', 'mistral', 'cohere', 'gcp', 'local', 'muse', 'typesafe'];
 export const knownModelIds = [
     'gpt-5.6-sol',
     'gpt-6-sol',
@@ -85,6 +85,7 @@ export const knownModelIdsByProvider = {
     gcp: ['google/gemini-3.5-flash@gcp', 'google/gemini-3.1-flash-lite@gcp', 'anthropic/claude-sonnet-4-6@gcp', 'anthropic/claude-opus-4-6@gcp'],
     local: ['laneformer-2b-it'],
     muse: ['muse-spark-1.3', 'muse-spark-1.3-contributor', 'muse-wonder-1.0', 'muse-wonder-full-1.0'],
+    typesafe: [],
 };
 export const toQualifiedModelId = (model) => {
     return `${model.providerId}:${model.modelId}`;

package/dist/providers.js.map

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

package/dist/registry.d.ts

@@ -3,6 +3,8 @@ import type { GenerateRequest, GenerateResponse, StreamRequest, StreamResult } f
 import type { ModelProfile, ProviderDescriptor } from './catalog.js';
 import type { ProviderId } from './providers.js';
 import type { NormalizedProviderError } from './errors.js';
+import type { EvaluatorRef, DecisionRequest } from './decision/request.js';
+import type { DecisionAdapterResult } from './decision/adapter.js';
 export interface CredentialValidationResult {
     ok: boolean;
     message?: string;
@@ -14,6 +16,10 @@ export interface ProviderRuntimeContext {
 export interface ProviderAdapter {
     readonly provider: ProviderDescriptor;
     listModels(): readonly ModelProfile[];
+    listEvaluators?(): readonly EvaluatorRef[];
+    decision?(request: DecisionRequest, context?: ProviderRuntimeContext & {
+        signal?: AbortSignal;
+    }): Promise<DecisionAdapterResult>;
     generate(request: GenerateRequest, context?: ProviderRuntimeContext): Promise<GenerateResponse>;
     stream(request: StreamRequest, context?: ProviderRuntimeContext): Promise<StreamResult>;
     validateAuth(source?: AuthInput): CredentialValidationResult;

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,UAAU,IAAI,SAAS,YAAY,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxF,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,0BAA0B,CAAC;IAC7D,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,IAAI,SAAS,kBAAkB,EAAE,CAAC;IAC/C,UAAU,IAAI,SAAS,YAAY,EAAE,CAAC;IACtC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC;CAC1D;AAED,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;gBAEzD,QAAQ,EAAE,SAAS,eAAe,EAAE;IAIhD,aAAa,IAAI,SAAS,kBAAkB,EAAE;IAI9C,UAAU,IAAI,SAAS,YAAY,EAAE;IAIrC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;IAI3D,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe;CAOzD;AAED,eAAO,MAAM,sBAAsB,aACvB,SAAS,eAAe,EAAE,KACnC,gBAEF,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,UAAU,IAAI,SAAS,YAAY,EAAE,CAAC;IACtC,cAAc,CAAC,IAAI,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjI,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxF,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,0BAA0B,CAAC;IAC7D,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,IAAI,SAAS,kBAAkB,EAAE,CAAC;IAC/C,UAAU,IAAI,SAAS,YAAY,EAAE,CAAC;IACtC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC;CAC1D;AAED,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;gBAEzD,QAAQ,EAAE,SAAS,eAAe,EAAE;IAIhD,aAAa,IAAI,SAAS,kBAAkB,EAAE;IAI9C,UAAU,IAAI,SAAS,YAAY,EAAE;IAIrC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;IAI3D,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe;CAOzD;AAED,eAAO,MAAM,sBAAsB,aACvB,SAAS,eAAe,EAAE,KACnC,gBAEF,CAAC"}

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAgCA,MAAM,OAAO,sBAAsB;IAChB,SAAS,CAA2C;IAErE,YAAY,QAAoC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,WAAW,CAAC,UAAsB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED,eAAe,CAAC,UAAsB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAoC,EAClB,EAAE;IACpB,OAAO,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAoCA,MAAM,OAAO,sBAAsB;IAChB,SAAS,CAA2C;IAErE,YAAY,QAAoC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,WAAW,CAAC,UAAsB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED,eAAe,CAAC,UAAsB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAoC,EAClB,EAAE;IACpB,OAAO,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC,CAAC"}

package/dist/speech/capabilities.d.ts

@@ -0,0 +1,48 @@
+import type { CapabilitySupport } from '../capabilities.js';
+import type { SpeechAudioFormat, SpeechBinding, SpeechEngineIdentity } from './contracts.js';
+export declare const speechCapabilityNames: readonly ["streamingStt", "partialTranscript", "nativeDuplex", "tts", "serverVad", "clientVad", "manualCommit", "playoutTruncate", "toolCancellation", "resume"];
+export type SpeechCapabilityName = (typeof speechCapabilityNames)[number];
+export type SpeechUsageUnit = 'audio-seconds' | 'audio-tokens' | 'text-tokens' | 'characters' | 'session-seconds';
+/** Evidence is specific to this adapter/model/placement tuple, never inherited. */
+export interface SpeechCapabilities {
+    readonly binding: SpeechEngineIdentity;
+    /** Missing sets are unqualified; explicit selectors require membership evidence. */
+    readonly languages?: readonly string[];
+    readonly voices?: readonly string[];
+    readonly regions?: readonly string[];
+    readonly features: Readonly<Record<SpeechCapabilityName, CapabilitySupport>>;
+    readonly inputFormats: readonly SpeechAudioFormat[];
+    readonly outputFormats: readonly SpeechAudioFormat[];
+    readonly usageUnits: readonly SpeechUsageUnit[];
+}
+export interface SpeechNegotiationRequest {
+    readonly binding: SpeechBinding;
+    readonly required: readonly SpeechCapabilityName[];
+    readonly inputFormats?: readonly SpeechAudioFormat[];
+    readonly outputFormats?: readonly SpeechAudioFormat[];
+}
+export type SpeechNegotiationResult = {
+    readonly ok: true;
+    readonly binding: SpeechBinding;
+    readonly inputFormat?: SpeechAudioFormat;
+    readonly outputFormat?: SpeechAudioFormat;
+} | {
+    readonly ok: false;
+    readonly reason: 'unavailable' | 'identity';
+} | {
+    readonly ok: false;
+    readonly reason: 'selector';
+    readonly selector: 'language' | 'voice' | 'region';
+} | {
+    readonly ok: false;
+    readonly reason: 'capability';
+    readonly capability: SpeechCapabilityName;
+    readonly support: CapabilitySupport;
+} | {
+    readonly ok: false;
+    readonly reason: 'format';
+    readonly direction: 'input' | 'output';
+};
+/** Pure tuple/media check. Gateway admission and cluster configuration remain authoritative. */
+export declare const negotiateSpeech: (capabilities: SpeechCapabilities | undefined, request: SpeechNegotiationRequest) => SpeechNegotiationResult;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/speech/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/speech/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7F,eAAO,MAAM,qBAAqB,kKAGxB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAElH,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACvD;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACvF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;CAAE,GACvG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,CAAC;AAc9F,gGAAgG;AAChG,eAAO,MAAM,eAAe,iBACZ,kBAAkB,GAAG,SAAS,WAAW,wBAAwB,KAC9E,uBAuBF,CAAC"}

package/dist/speech/capabilities.js

@@ -0,0 +1,41 @@
+export const speechCapabilityNames = [
+    'streamingStt', 'partialTranscript', 'nativeDuplex', 'tts', 'serverVad',
+    'clientVad', 'manualCommit', 'playoutTruncate', 'toolCancellation', 'resume',
+];
+const bindingKeys = [
+    'providerId', 'modelId', 'modelRevision', 'adapterId', 'adapterRevision', 'placement',
+];
+const selectFormat = (offered, requested) => requested.find((wanted) => wanted.channels === 1 && [16000, 24000, 48000].includes(wanted.sampleRateHz)
+    && ['pcm16-le', 'opus'].includes(wanted.codec)
+    && offered.some((format) => format.codec === wanted.codec
+        && format.sampleRateHz === wanted.sampleRateHz && format.channels === wanted.channels));
+/** Pure tuple/media check. Gateway admission and cluster configuration remain authoritative. */
+export const negotiateSpeech = (capabilities, request) => {
+    if (!capabilities)
+        return { ok: false, reason: 'unavailable' };
+    if (bindingKeys.some((key) => capabilities.binding[key] !== request.binding[key])) {
+        return { ok: false, reason: 'identity' };
+    }
+    for (const [selector, supported] of [
+        ['language', capabilities.languages], ['voice', capabilities.voices], ['region', capabilities.regions],
+    ]) {
+        const selected = request.binding[selector];
+        if (selected !== undefined && !supported?.includes(selected)) {
+            return { ok: false, reason: 'selector', selector };
+        }
+    }
+    for (const capability of request.required) {
+        const support = capabilities.features[capability] ?? 'unknown';
+        if (support !== 'supported')
+            return { ok: false, reason: 'capability', capability, support };
+    }
+    const inputFormat = request.inputFormats && selectFormat(capabilities.inputFormats, request.inputFormats);
+    if (request.inputFormats && !inputFormat)
+        return { ok: false, reason: 'format', direction: 'input' };
+    const outputFormat = request.outputFormats && selectFormat(capabilities.outputFormats, request.outputFormats);
+    if (request.outputFormats && !outputFormat)
+        return { ok: false, reason: 'format', direction: 'output' };
+    return { ok: true, binding: request.binding,
+        ...(inputFormat ? { inputFormat } : {}), ...(outputFormat ? { outputFormat } : {}) };
+};
+//# sourceMappingURL=capabilities.js.map

package/dist/speech/capabilities.js.map

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

package/dist/speech/catalog.d.ts

@@ -0,0 +1,8 @@
+import type { SpeechCapabilities } from './capabilities.js';
+/** Each entry qualifies a full engine tuple. STT/TTS engines need no chat profile. */
+export type SpeechEngineCatalogue = readonly SpeechCapabilities[];
+/** L1 supplies the contract; engine qualification populates this catalogue later. */
+export declare const speechEngineCatalogue: SpeechEngineCatalogue;
+/** Return all adapters, revisions and placements; never choose an implicit default. */
+export declare const getModelSpeechCapabilities: (providerId: string, modelId: string, catalogue?: SpeechEngineCatalogue) => readonly SpeechCapabilities[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/speech/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/speech/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,sFAAsF;AACtF,MAAM,MAAM,qBAAqB,GAAG,SAAS,kBAAkB,EAAE,CAAC;AAElE,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,EAAE,qBAA0B,CAAC;AAE/D,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,eACzB,MAAM,WACT,MAAM,wCAEd,SAAS,kBAAkB,EACiD,CAAC"}

package/dist/speech/catalog.js

@@ -0,0 +1,5 @@
+/** L1 supplies the contract; engine qualification populates this catalogue later. */
+export const speechEngineCatalogue = [];
+/** Return all adapters, revisions and placements; never choose an implicit default. */
+export const getModelSpeechCapabilities = (providerId, modelId, catalogue = speechEngineCatalogue) => catalogue.filter((entry) => entry.binding.providerId === providerId && entry.binding.modelId === modelId);
+//# sourceMappingURL=catalog.js.map

package/dist/speech/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/speech/catalog.ts"],"names":[],"mappings":"AAKA,qFAAqF;AACrF,MAAM,CAAC,MAAM,qBAAqB,GAA0B,EAAE,CAAC;AAE/D,uFAAuF;AACvF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,UAAkB,EAClB,OAAe,EACf,YAAmC,qBAAqB,EACzB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7D,KAAK,CAAC,OAAO,CAAC,UAAU,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC"}

package/dist/speech/contracts.d.ts

@@ -0,0 +1,196 @@
+import type { SpeechCapabilities, SpeechCapabilityName } from './capabilities.js';
+export declare const speechPlacements: readonly ["endpoint-native", "browser-wasm", "local-companion", "cluster-hosted", "cloud-relay"];
+export type SpeechPlacement = (typeof speechPlacements)[number];
+export type SpeechPipeline = 'chained' | 'native-duplex';
+export type SpeechMicMode = 'key' | 'open-mic';
+export type SpeechStage = 'stt' | 'tts' | 'duplex';
+/** Exact engine tuple, independent of the existing agent model/route. No secrets. */
+export interface SpeechEngineIdentity {
+    readonly providerId: string;
+    readonly modelId: string;
+    readonly modelRevision: string;
+    readonly adapterId: string;
+    readonly adapterRevision: string;
+    readonly placement: SpeechPlacement;
+}
+/** Session selectors are independent of the engine's catalogue identity. */
+export interface SpeechBinding extends SpeechEngineIdentity {
+    readonly language?: string;
+    readonly voice?: string;
+    readonly region?: string;
+    readonly accountRef?: string;
+    readonly resourceRef?: string;
+}
+export interface SpeechConfigurationReference {
+    readonly profileId: string;
+    readonly configRevision: string;
+    readonly policyRef: string;
+}
+export interface SpeechTarget {
+    readonly sessionId: string;
+    readonly sourceGeneration: string;
+    readonly controllerEpoch: number;
+    readonly consentRevision: string;
+}
+export interface SpeechAudioFormat {
+    readonly codec: 'pcm16-le' | 'opus';
+    readonly sampleRateHz: 16000 | 24000 | 48000;
+    readonly channels: 1;
+}
+/** Timestamps are comparable only within the named monotonic clock domain. */
+export interface SpeechEventMetadata {
+    readonly schemaVersion: 1;
+    readonly speechSessionId: string;
+    readonly connectionEpoch: number;
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly causalCommandId?: string;
+    readonly clock: {
+        readonly id: string;
+        readonly monotonicMs: number;
+    };
+}
+interface SpeechAudioFrame extends SpeechEventMetadata {
+    readonly streamId: string;
+    readonly sampleCount: number;
+    readonly format: SpeechAudioFormat;
+    /** Binary media is transient; never persist it in control/usage event logs. */
+    readonly payload: Uint8Array;
+}
+export interface SpeechInputFrame extends SpeechAudioFrame {
+    readonly type: 'audio.input';
+    readonly utteranceId: string;
+    readonly capturedAtMs: number;
+}
+export interface SpeechOutputFrame extends SpeechAudioFrame {
+    readonly type: 'audio.output';
+    readonly responseId: string;
+    readonly outputItemId: string;
+    readonly turnId: string;
+    readonly turnEpoch: number;
+    readonly sampleOffset: number;
+}
+export interface SpeechPlaybackProgress extends SpeechEventMetadata {
+    readonly type: 'playback.progress';
+    readonly outputItemId: string;
+    readonly playedSamples: number;
+    readonly uncertaintySamples: number;
+}
+interface SpeechTranscriptBase extends SpeechEventMetadata {
+    readonly binding: SpeechBinding;
+    readonly utteranceId: string;
+    readonly revision: number;
+    readonly text: string;
+}
+export interface SpeechTranscriptPartial extends SpeechTranscriptBase {
+    readonly type: 'transcript.partial';
+    /** Replace a UTF-16 range of the previous hypothesis; display only. */
+    readonly replaces: {
+        readonly start: number;
+        readonly end: number;
+    };
+    readonly confidence?: number;
+}
+export interface SpeechTranscriptFinal extends SpeechTranscriptBase {
+    readonly type: 'transcript.final';
+    readonly replaces?: never;
+    readonly audioInterval: {
+        readonly startMs: number;
+        readonly endMs: number;
+    };
+    readonly language: string;
+}
+/** Finals are immutable; a correction is a separate user edit, never a new submission. */
+export type SpeechTranscript = SpeechTranscriptPartial | SpeechTranscriptFinal;
+/** Pure display projection for one utterance. L2 owns stream ordering and durable submission. */
+export declare const reviseSpeechTranscript: (previous: SpeechTranscript | undefined, next: SpeechTranscript) => SpeechTranscript | undefined;
+export interface SpeechSessionRequest {
+    readonly protocolVersion: 1;
+    readonly configuration: SpeechConfigurationReference;
+    readonly target: SpeechTarget;
+    readonly pipeline: SpeechPipeline;
+    readonly micMode: SpeechMicMode;
+    readonly bindings: Readonly<Partial<Record<SpeechStage, SpeechBinding>>>;
+    readonly requiredCapabilities: readonly SpeechCapabilityName[];
+    readonly inputFormats: readonly SpeechAudioFormat[];
+    readonly outputFormats: readonly SpeechAudioFormat[];
+    readonly maxDurationMs: number;
+    readonly maxCostUsd: number;
+    readonly budgetRef: string;
+    readonly allowedPlacements: readonly SpeechPlacement[];
+    readonly egressPolicyRef: string;
+}
+/** Trusted admission pins the effective tuple before any audio is transmitted. */
+export interface SpeechSessionReceipt {
+    readonly protocolVersion: 1;
+    readonly speechSessionId: string;
+    readonly connectionEpoch: number;
+    readonly configuration: SpeechConfigurationReference;
+    readonly target: SpeechTarget;
+    readonly pipeline: SpeechPipeline;
+    readonly micMode: SpeechMicMode;
+    readonly stages: Readonly<Partial<Record<SpeechStage, SpeechCapabilities>>>;
+    readonly inputFormat?: SpeechAudioFormat;
+    readonly outputFormat?: SpeechAudioFormat;
+}
+export type SpeechSessionState = 'opening' | 'ready' | 'closing' | 'closed' | 'failed';
+export type SpeechCommand = SpeechEventMetadata & ({
+    readonly type: 'input.commit' | 'input.clear';
+    readonly utteranceId: string;
+} | {
+    readonly type: 'session.mute';
+    readonly muted: boolean;
+} | {
+    readonly type: 'session.close';
+} | {
+    readonly type: 'playback.clear';
+    readonly turnEpoch: number;
+} | {
+    readonly type: 'response.cancel';
+    readonly responseId: string;
+    readonly turnEpoch: number;
+});
+export type SpeechEvent = SpeechInputFrame | SpeechOutputFrame | SpeechTranscript | SpeechPlaybackProgress | (SpeechEventMetadata & ({
+    readonly type: 'vad.speech_started' | 'vad.speech_stopped';
+    readonly utteranceId: string;
+    readonly audioOffsetMs: number;
+    readonly detector: 'client' | 'server';
+    readonly confidence?: number;
+} | {
+    readonly type: 'audio.output_done';
+    readonly responseId: string;
+    readonly outputItemId: string;
+    readonly turnId: string;
+    readonly turnEpoch: number;
+} | {
+    readonly type: 'provider.cancelled';
+    readonly responseId: string;
+} | {
+    readonly type: 'session.state';
+    readonly state: SpeechSessionState;
+} | {
+    readonly type: 'audio.gap';
+    readonly streamId: string;
+    readonly startMs: number;
+    readonly endMs: number;
+} | {
+    readonly type: 'session.degraded' | 'error';
+    readonly reason: string;
+    readonly retryable: boolean;
+}));
+/** Duplex provider port, not the agent-control authority. Writes must honor backpressure. */
+export interface SpeechSession {
+    readonly receipt: SpeechSessionReceipt;
+    readonly events: AsyncIterable<SpeechEvent>;
+    write(frame: SpeechInputFrame, signal?: AbortSignal): Promise<void>;
+    command(command: SpeechCommand, signal?: AbortSignal): Promise<void>;
+    close(): Promise<void>;
+}
+export interface SpeechAdapter {
+    readonly capabilities: SpeechCapabilities;
+    open(request: SpeechSessionRequest, signal: AbortSignal): Promise<SpeechSession>;
+}
+/** Validate frame-local metadata; epoch/order/queue enforcement belongs to L2. */
+export declare const isValidSpeechAudioFrame: (frame: SpeechInputFrame | SpeechOutputFrame) => boolean;
+export {};
+//# sourceMappingURL=contracts.d.ts.map