@sentropic/llm-mesh 0.13.2 → 0.14.0

package/dist/equivalence-council.d.ts

@@ -0,0 +1,61 @@
+import type { ModelProfile } from './catalog.js';
+export type CapabilityName = keyof ModelProfile['capabilities'] | `input:${ModelProfile['capabilities']['modalities']['input'][number]}` | `output:${ModelProfile['capabilities']['modalities']['output'][number]}`;
+export type CapabilityRequirement = CapabilityName | {
+    readonly capability: CapabilityName;
+    readonly required: true;
+} | {
+    readonly capability: CapabilityName;
+    readonly minimum: number;
+};
+export interface BenchmarkEvidence {
+    readonly suite: string;
+    readonly artifact: string;
+    readonly measuredAt: string;
+    readonly dimensions: Readonly<Record<string, number | string>>;
+}
+export interface ModelEquivalenceMember {
+    readonly providerId: string;
+    readonly modelId: string;
+    readonly rank: number;
+    readonly effort?: string;
+    readonly requiredCapabilities: readonly CapabilityRequirement[];
+    readonly transportPreferences?: readonly string[];
+}
+export interface ModelEquivalenceGroup {
+    readonly id: string;
+    readonly intent: 'coding' | 'general' | 'reasoning' | 'fast';
+    readonly members: readonly ModelEquivalenceMember[];
+    readonly evidence: readonly BenchmarkEvidence[];
+    readonly expiresAt: string;
+}
+export interface ModelAlias {
+    readonly alias: string;
+    readonly providerId: string;
+    readonly modelId: string;
+    readonly transportProviderId: string;
+    readonly effort?: string;
+}
+export interface EquivalenceExclusion {
+    readonly providerId: string;
+    readonly modelId: string;
+    readonly reason: string;
+    readonly reviewer: string;
+    readonly expiresAt: string;
+    readonly provenance: string;
+}
+export interface ModelEquivalenceCouncil {
+    readonly revision: string;
+    readonly expiresAt: string;
+    readonly aliases: readonly ModelAlias[];
+    readonly groups: readonly ModelEquivalenceGroup[];
+    readonly exclusions: readonly EquivalenceExclusion[];
+}
+export declare class EquivalenceCouncilError extends Error {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+export declare const capabilityRequirementEquals: (left: CapabilityRequirement, right: CapabilityRequirement) => boolean;
+export declare const modelSupportsCapability: (profile: ModelProfile | undefined, requirement: CapabilityRequirement) => boolean;
+export declare const DEFAULT_MODEL_EQUIVALENCE_COUNCIL: ModelEquivalenceCouncil;
+export declare const validateEquivalenceCouncil: (council: ModelEquivalenceCouncil, profiles: readonly ModelProfile[], now?: Date) => void;
+//# sourceMappingURL=equivalence-council.d.ts.map

package/dist/equivalence-council.d.ts.map

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

package/dist/equivalence-council.js

@@ -0,0 +1,119 @@
+import { GENERATED_MODEL_COUNCIL_SOURCE } from './generated-model-council.js';
+import { LAUNCH_ALIAS_TARGET_MAPPINGS } from './routing-targets.js';
+export class EquivalenceCouncilError extends Error {
+    issues;
+    constructor(issues) {
+        super(issues.join('; '));
+        this.issues = issues;
+        this.name = 'EquivalenceCouncilError';
+    }
+}
+const normalizedCapabilityRequirement = (requirement) => typeof requirement === 'string'
+    ? { capability: requirement }
+    : {
+        capability: requirement.capability,
+        ...('minimum' in requirement ? { minimum: requirement.minimum } : {}),
+    };
+export const capabilityRequirementEquals = (left, right) => {
+    const normalizedLeft = normalizedCapabilityRequirement(left);
+    const normalizedRight = normalizedCapabilityRequirement(right);
+    return normalizedLeft.capability === normalizedRight.capability
+        && normalizedLeft.minimum === normalizedRight.minimum;
+};
+export const modelSupportsCapability = (profile, requirement) => {
+    if (!profile)
+        return false;
+    const normalized = normalizedCapabilityRequirement(requirement);
+    if (normalized.capability.startsWith('input:')) {
+        return profile.capabilities.modalities.input.includes(normalized.capability.slice(6));
+    }
+    if (normalized.capability.startsWith('output:')) {
+        return profile.capabilities.modalities.output.includes(normalized.capability.slice(7));
+    }
+    const capability = profile.capabilities[normalized.capability];
+    if (typeof capability === 'number') {
+        return normalized.minimum === undefined
+            ? capability > 0
+            : capability >= normalized.minimum;
+    }
+    if (normalized.minimum !== undefined)
+        return false;
+    if (capability && typeof capability === 'object' && 'support' in capability) {
+        return capability.support !== 'unsupported';
+    }
+    return capability !== undefined;
+};
+const aliases = Object.entries(LAUNCH_ALIAS_TARGET_MAPPINGS).map(([alias, target]) => ({
+    alias,
+    providerId: target.providerId,
+    modelId: target.model,
+    transportProviderId: target.transportProviderId,
+    ...(target.effort ? { effort: target.effort } : {}),
+}));
+export const DEFAULT_MODEL_EQUIVALENCE_COUNCIL = {
+    revision: GENERATED_MODEL_COUNCIL_SOURCE.revision,
+    expiresAt: GENERATED_MODEL_COUNCIL_SOURCE.expiresAt,
+    aliases,
+    groups: [],
+    exclusions: GENERATED_MODEL_COUNCIL_SOURCE.excludedModelKeys.map((key) => {
+        const separator = key.indexOf(':');
+        return {
+            providerId: key.slice(0, separator),
+            modelId: key.slice(separator + 1),
+            reason: GENERATED_MODEL_COUNCIL_SOURCE.reason,
+            reviewer: GENERATED_MODEL_COUNCIL_SOURCE.reviewer,
+            expiresAt: GENERATED_MODEL_COUNCIL_SOURCE.expiresAt,
+            provenance: `${GENERATED_MODEL_COUNCIL_SOURCE.provenance}#${GENERATED_MODEL_COUNCIL_SOURCE.digest}`,
+        };
+    }),
+};
+export const validateEquivalenceCouncil = (council, profiles, now = new Date()) => {
+    const issues = [];
+    if (!Number.isFinite(Date.parse(council.expiresAt))) {
+        issues.push('council expiresAt must be a valid timestamp');
+    }
+    else if (Date.parse(council.expiresAt) <= now.getTime()) {
+        issues.push(`expired council ${council.revision}`);
+    }
+    const profilesByKey = new Map(profiles.map((profile) => [`${profile.providerId}:${profile.modelId}`, profile]));
+    const classified = new Map();
+    const add = (providerId, modelId) => {
+        const key = `${providerId}:${modelId}`;
+        classified.set(key, (classified.get(key) ?? 0) + 1);
+    };
+    council.groups.forEach((group) => {
+        if (group.evidence.length === 0)
+            issues.push(`group has no evidence: ${group.id}`);
+        if (Date.parse(group.expiresAt) <= now.getTime())
+            issues.push(`expired group ${group.id}`);
+        group.members.forEach((member) => {
+            add(member.providerId, member.modelId);
+            const key = `${member.providerId}:${member.modelId}`;
+            const profile = profilesByKey.get(key);
+            if (!profile)
+                issues.push(`unknown council model: ${key}`);
+            for (const requirement of member.requiredCapabilities) {
+                if (!modelSupportsCapability(profile, requirement)) {
+                    issues.push(`missing capability ${requirement}: ${key}`);
+                }
+            }
+        });
+    });
+    council.exclusions.forEach((exclusion) => {
+        add(exclusion.providerId, exclusion.modelId);
+        if (Date.parse(exclusion.expiresAt) <= now.getTime()) {
+            issues.push(`expired exclusion ${exclusion.providerId}:${exclusion.modelId}`);
+        }
+        if (!profilesByKey.has(`${exclusion.providerId}:${exclusion.modelId}`)) {
+            issues.push(`unknown excluded model: ${exclusion.providerId}:${exclusion.modelId}`);
+        }
+    });
+    for (const profile of profiles) {
+        const key = `${profile.providerId}:${profile.modelId}`;
+        if (classified.get(key) !== 1)
+            issues.push(`model must be classified exactly once: ${key}`);
+    }
+    if (issues.length > 0)
+        throw new EquivalenceCouncilError(issues);
+};
+//# sourceMappingURL=equivalence-council.js.map

package/dist/equivalence-council.js.map

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

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

@@ -0,0 +1,10 @@
+export declare const GENERATED_MODEL_COUNCIL_SOURCE: {
+    readonly revision: "2026-08-08.1";
+    readonly digest: "sha256:9e826c40cceab9350fbb3445d4a31c5715baa6236f6242e5645977a5af4922fc";
+    readonly expiresAt: "2027-02-08T00:00:00.000Z";
+    readonly reason: "No pinned benchmark evidence authorizes automatic substitution.";
+    readonly reviewer: "BR-73 model council";
+    readonly provenance: "spec/SPEC_EVOL_LLM_MESH_GATEWAY_ROUTING.md";
+    readonly excludedModelKeys: readonly ["anthropic:claude-fable-5", "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", "mistral:magistral-medium-2509", "mistral:mistral-small-2603", "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"];
+};
+//# sourceMappingURL=generated-model-council.d.ts.map

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

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

package/dist/generated-model-council.js

@@ -0,0 +1,32 @@
+// Generated by make refresh-llm-model-equivalences. Do not edit.
+export const GENERATED_MODEL_COUNCIL_SOURCE = {
+    revision: "2026-08-08.1",
+    digest: "sha256:9e826c40cceab9350fbb3445d4a31c5715baa6236f6242e5645977a5af4922fc",
+    expiresAt: "2027-02-08T00:00:00.000Z",
+    reason: "No pinned benchmark evidence authorizes automatic substitution.",
+    reviewer: "BR-73 model council",
+    provenance: "spec/SPEC_EVOL_LLM_MESH_GATEWAY_ROUTING.md",
+    excludedModelKeys: [
+        "anthropic:claude-fable-5",
+        "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",
+        "mistral:magistral-medium-2509",
+        "mistral:mistral-small-2603",
+        "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",
+    ],
+};
+//# sourceMappingURL=generated-model-council.js.map

package/dist/generated-model-council.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-model-council.js","sourceRoot":"","sources":["../src/generated-model-council.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,yEAAyE;IACjF,SAAS,EAAE,0BAA0B;IACrC,MAAM,EAAE,iEAAiE;IACzE,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE,4CAA4C;IACxD,iBAAiB,EAAE;QACjB,0BAA0B;QAC1B,2BAA2B;QAC3B,yBAAyB;QACzB,2BAA2B;QAC3B,0BAA0B;QAC1B,oCAAoC;QACpC,mCAAmC;QACnC,qCAAqC;QACrC,sCAAsC;QACtC,iCAAiC;QACjC,8BAA8B;QAC9B,yBAAyB;QACzB,+BAA+B;QAC/B,4BAA4B;QAC5B,qBAAqB;QACrB,qBAAqB;QACrB,gBAAgB;QAChB,qBAAqB;QACrB,oBAAoB;QACpB,sBAAsB;KACvB;CACO,CAAC"}

package/dist/generation.d.ts

@@ -24,6 +24,8 @@ export type ReasoningEffort = 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'ma
 export interface ReasoningOptions {
     effort?: ReasoningEffort;
     summary?: 'auto' | 'concise' | 'detailed';
+    enabled?: boolean;
+    budgetTokens?: number;
 }
 export interface LlmMeshRequestMetadata {
     correlationId?: string;
@@ -41,6 +43,7 @@ export interface GenerateRequest {
     auth?: AuthInput | AuthResolver;
     tools?: readonly ToolDefinition[];
     toolChoice?: ToolChoice;
+    parallelToolCalls?: boolean;
     responseFormat?: ResponseFormat;
     reasoning?: ReasoningOptions;
     maxOutputTokens?: number;

package/dist/generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE/D,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEN;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC"}

package/dist/index.d.ts

@@ -4,11 +4,20 @@ export * from './auth.js';
 export * from './capabilities.js';
 export * from './catalog.js';
 export * from './errors.js';
+export * from './equivalence-council.js';
 export * from './generation.js';
 export * from './messages.js';
 export * from './mesh.js';
 export * from './providers.js';
 export * from './registry.js';
+export * from './routing-targets.js';
+export * from './routing-policy.js';
+export * from './routing-contracts.js';
+export * from './route-planner.js';
+export * from './codex.js';
+export * from './transport/codex-runtime-client.js';
+export * from './transport/codex-runtime-wire.js';
+export * from './transport/cloud-code-runtime-client.js';
 export * from './streaming.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,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,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,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -4,11 +4,20 @@ export * from './auth.js';
 export * from './capabilities.js';
 export * from './catalog.js';
 export * from './errors.js';
+export * from './equivalence-council.js';
 export * from './generation.js';
 export * from './messages.js';
 export * from './mesh.js';
 export * from './providers.js';
 export * from './registry.js';
+export * from './routing-targets.js';
+export * from './routing-policy.js';
+export * from './routing-contracts.js';
+export * from './route-planner.js';
+export * from './codex.js';
+export * from './transport/codex-runtime-client.js';
+export * from './transport/codex-runtime-wire.js';
+export * from './transport/cloud-code-runtime-client.js';
 export * from './streaming.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,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,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,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/messages.d.ts

@@ -17,7 +17,14 @@ export interface FileContentPart {
     url?: string;
     filename?: string;
 }
-export type MessageContent = string | readonly (TextContentPart | ImageContentPart | FileContentPart)[];
+/** Provider-originated reasoning history that may carry a replay signature. */
+export interface ReasoningContentPart {
+    type: 'reasoning';
+    text: string;
+    signature?: string;
+    redacted?: boolean;
+}
+export type MessageContent = string | readonly (TextContentPart | ImageContentPart | FileContentPart | ReasoningContentPart)[];
 export interface BaseMessage {
     role: MessageRole;
     content: MessageContent;

package/dist/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC,EAAE,CAAC;AAExG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;CAAE,CAAC,GACzD,gBAAgB,GAChB,WAAW,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,CAC7C,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,oBAAoB,CAC5E,EAAE,CAAC;AAEJ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;CAAE,CAAC,GACzD,gBAAgB,GAChB,WAAW,CAAC"}

package/dist/route-attempt.d.ts

@@ -0,0 +1,18 @@
+import type { RankedRouteCandidate } from './route-selection.js';
+import type { StoredPlan } from './route-planner-state.js';
+import type { AccountDirectoryPort, Clock, PreparedRouteAttempt, RouteFailureClassification, VerifiedRoutingSubject } from './routing-contracts.js';
+export declare const prepareStoredRouteAttempt: (input: {
+    readonly stored: StoredPlan | undefined;
+    readonly subject: VerifiedRoutingSubject;
+    readonly planRef: string;
+    readonly candidateRef: string;
+    readonly requestId: string;
+    readonly attemptIndex: number;
+    readonly directory: AccountDirectoryPort;
+    readonly clock: Clock;
+    readonly onOutcome: (stored: StoredPlan, candidate: RankedRouteCandidate, classification: RouteFailureClassification) => void;
+    readonly onCommitted: (stored: StoredPlan, candidate: RankedRouteCandidate) => void;
+    readonly onSuccess: (stored: StoredPlan, candidate: RankedRouteCandidate) => void;
+    readonly onCancelled: (stored: StoredPlan, candidate: RankedRouteCandidate) => void;
+}) => Promise<PreparedRouteAttempt>;
+//# sourceMappingURL=route-attempt.d.ts.map

package/dist/route-attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-attempt.d.ts","sourceRoot":"","sources":["../src/route-attempt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EACV,oBAAoB,EACpB,KAAK,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,yBAAyB,UAAiB;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,CAClB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,oBAAoB,EAC/B,cAAc,EAAE,0BAA0B,KACvC,IAAI,CAAC;IACV,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpF,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClF,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACrF,KAAG,QAAQ,oBAAoB,CAiE/B,CAAC"}

package/dist/route-attempt.js

@@ -0,0 +1,70 @@
+import { RoutePlanError, subjectRef } from './route-planner-state.js';
+export const prepareStoredRouteAttempt = async (input) => {
+    const { stored } = input;
+    if (!stored || stored.plan.planRef !== input.planRef) {
+        throw new RoutePlanError('Unknown route plan', 'invalid-plan');
+    }
+    if (stored.subjectRef !== subjectRef(input.subject)) {
+        throw new RoutePlanError('Route plan belongs to another owner', 'invalid-plan');
+    }
+    if (Date.parse(stored.plan.expiresAt) <= input.clock.now().getTime()) {
+        throw new RoutePlanError('Route plan expired', 'expired-plan');
+    }
+    const candidate = stored.candidates[input.attemptIndex];
+    if (!candidate || candidate.candidateRef !== input.candidateRef) {
+        throw new RoutePlanError('Candidate does not match attempt index', 'invalid-plan');
+    }
+    const claim = [input.candidateRef, input.requestId, input.attemptIndex].join('\u001f');
+    if (stored.claimedAttempts.has(claim)) {
+        throw new RoutePlanError('Route attempt was already prepared', 'invalid-plan');
+    }
+    stored.claimedAttempts.add(claim);
+    const current = (await input.directory.listEligible(input.subject)).find((account) => account.accountRef === candidate.account.accountRef);
+    if (!current || current.revision !== candidate.account.revision || current.readiness !== 'ready') {
+        throw new RoutePlanError('Candidate account changed after planning', 'stale-candidate');
+    }
+    const attempt = await input.directory.prepareAttempt({
+        subject: input.subject,
+        ...(stored.affinityRef ? { affinityRef: stored.affinityRef } : {}),
+        accountRef: current.accountRef,
+        target: candidate.target,
+        requestId: input.requestId,
+        attemptIndex: input.attemptIndex,
+    });
+    let committed = false;
+    let terminal = false;
+    return {
+        attemptRef: attempt.attemptRef,
+        generate: (request) => attempt.generate(request),
+        stream: (request) => attempt.stream(request),
+        recordOutcome: async (classification, usage) => {
+            if (terminal)
+                return;
+            terminal = true;
+            input.onOutcome(stored, candidate, classification);
+            await attempt.recordOutcome(classification, usage);
+        },
+        markCommitted: async () => {
+            if (committed)
+                return;
+            committed = true;
+            input.onCommitted(stored, candidate);
+            await attempt.markCommitted();
+        },
+        complete: async (usage) => {
+            if (terminal)
+                return;
+            terminal = true;
+            input.onSuccess(stored, candidate);
+            await attempt.complete(usage);
+        },
+        releaseCancelled: async () => {
+            if (terminal)
+                return;
+            terminal = true;
+            input.onCancelled(stored, candidate);
+            await attempt.releaseCancelled();
+        },
+    };
+};
+//# sourceMappingURL=route-attempt.js.map

package/dist/route-attempt.js.map

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

package/dist/route-health.d.ts

@@ -0,0 +1,14 @@
+import type { RankedRouteCandidate } from './route-selection.js';
+import type { Clock, RouteFailureClassification } from './routing-contracts.js';
+import type { RoutePolicy } from './routing-policy.js';
+export declare class InMemoryRouteHealth {
+    private readonly clock;
+    private readonly maximumEntries;
+    private readonly entries;
+    constructor(clock: Clock, maximumEntries?: number);
+    record(candidate: RankedRouteCandidate, classification: RouteFailureClassification, policy: RoutePolicy): void;
+    isSuppressed(candidate: RankedRouteCandidate): boolean;
+    clear(candidate: RankedRouteCandidate): void;
+    private evict;
+}
+//# sourceMappingURL=route-health.d.ts.map

package/dist/route-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-health.d.ts","sourceRoot":"","sources":["../src/route-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAoCvD,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAJjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAGvC,KAAK,EAAE,KAAK,EACZ,cAAc,SAAQ;IAGzC,MAAM,CACJ,SAAS,EAAE,oBAAoB,EAC/B,cAAc,EAAE,0BAA0B,EAC1C,MAAM,EAAE,WAAW,GAClB,IAAI;IAaP,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO;IAStD,KAAK,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAI5C,OAAO,CAAC,KAAK;CAWd"}

package/dist/route-health.js

@@ -0,0 +1,69 @@
+const availabilityReasons = new Set([
+    'network-unavailable',
+    'provider-5xx',
+    'rate-limited',
+]);
+const keyFor = (candidate, scope) => {
+    switch (scope) {
+        case 'account': return `account:${candidate.account.accountRef}`;
+        case 'transport': return `transport:${candidate.target.transportProviderId}`;
+        case 'provider-model': return `provider-model:${candidate.target.providerId}:${candidate.target.modelId}`;
+        default: return [
+            'route', candidate.target.providerId, candidate.target.modelId,
+            candidate.target.transportProviderId, candidate.account.accountRef,
+        ].join(':');
+    }
+};
+const applicableKeys = (candidate) => [
+    keyFor(candidate, 'route'),
+    keyFor(candidate, 'account'),
+    keyFor(candidate, 'transport'),
+    keyFor(candidate, 'provider-model'),
+];
+export class InMemoryRouteHealth {
+    clock;
+    maximumEntries;
+    entries = new Map();
+    constructor(clock, maximumEntries = 1_000) {
+        this.clock = clock;
+        this.maximumEntries = maximumEntries;
+    }
+    record(candidate, classification, policy) {
+        if (!classification.retryable || !availabilityReasons.has(classification.reason))
+            return;
+        const requestedTtl = classification.retryAfterMs ?? policy.negativeCacheTtlMs;
+        const ttl = Math.min(Math.max(requestedTtl, 1_000), 3_600_000);
+        const key = keyFor(candidate, classification.healthScope);
+        this.entries.set(key, {
+            key,
+            reason: classification.reason,
+            expiresAt: this.clock.now().getTime() + ttl,
+        });
+        this.evict();
+    }
+    isSuppressed(candidate) {
+        this.evict();
+        const now = this.clock.now().getTime();
+        return applicableKeys(candidate).some((key) => {
+            const entry = this.entries.get(key);
+            return Boolean(entry && entry.expiresAt > now);
+        });
+    }
+    clear(candidate) {
+        applicableKeys(candidate).forEach((key) => this.entries.delete(key));
+    }
+    evict() {
+        const now = this.clock.now().getTime();
+        for (const [key, entry] of this.entries) {
+            if (entry.expiresAt <= now)
+                this.entries.delete(key);
+        }
+        while (this.entries.size > this.maximumEntries) {
+            const oldest = [...this.entries.values()].sort((a, b) => a.expiresAt - b.expiresAt)[0];
+            if (!oldest)
+                break;
+            this.entries.delete(oldest.key);
+        }
+    }
+}
+//# sourceMappingURL=route-health.js.map

package/dist/route-health.js.map

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

package/dist/route-planner-state.d.ts

@@ -0,0 +1,37 @@
+import type { RankedRouteCandidate } from './route-selection.js';
+import type { AffinityDescription, IdFactory, RouteAvailabilityDiagnostic, RoutePlan, VerifiedRoutingSubject } from './routing-contracts.js';
+import type { RoutePolicy } from './routing-policy.js';
+export interface StoredCandidate extends RankedRouteCandidate {
+    readonly candidateRef: string;
+}
+export interface StoredPlan {
+    readonly plan: RoutePlan;
+    readonly subjectRef: string;
+    readonly affinityRef?: string;
+    readonly affinityRevision?: number;
+    readonly policyProfileName?: string;
+    readonly policyProfileRevision?: string;
+    readonly hadAffinity: boolean;
+    readonly candidates: readonly StoredCandidate[];
+    readonly policy: RoutePolicy;
+    readonly claimedAttempts: Set<string>;
+    readonly roundRobinKey?: string;
+}
+export interface StoredAffinity extends AffinityDescription {
+    readonly accountRef: string;
+    readonly workspaceId?: string;
+}
+export declare class RoutePlanError extends Error {
+    readonly code: 'no-route' | 'invalid-plan' | 'expired-plan' | 'stale-candidate' | 'conflict';
+    readonly diagnostic?: RouteAvailabilityDiagnostic | undefined;
+    constructor(message: string, code: 'no-route' | 'invalid-plan' | 'expired-plan' | 'stale-candidate' | 'conflict', diagnostic?: RouteAvailabilityDiagnostic | undefined);
+}
+export declare const subjectRef: (subject: VerifiedRoutingSubject) => string;
+export declare const routingOwnerRef: (subject: VerifiedRoutingSubject) => string;
+export declare const affinityRef: (subject: VerifiedRoutingSubject, affinityKey: string, workspaceId?: string) => string;
+export declare const mergeRoutePolicy: (base: RoutePolicy, override?: Partial<RoutePolicy>) => RoutePolicy;
+export declare class SequentialIdFactory implements IdFactory {
+    private sequence;
+    next(prefix: 'plan' | 'candidate' | 'attempt'): string;
+}
+//# sourceMappingURL=route-planner-state.d.ts.map

package/dist/route-planner-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-planner-state.d.ts","sourceRoot":"","sources":["../src/route-planner-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,2BAA2B,EAC3B,SAAS,EACT,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,GAAG,UAAU;IAC5F,QAAQ,CAAC,UAAU,CAAC;gBAFpB,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,GAAG,UAAU,EACnF,UAAU,CAAC,yCAA6B;CAKpD;AAED,eAAO,MAAM,UAAU,YAAa,sBAAsB,KAAG,MACJ,CAAC;AAE1D,eAAO,MAAM,eAAe,YAAa,sBAAsB,KAAG,MAC3C,CAAC;AAExB,eAAO,MAAM,WAAW,YACb,sBAAsB,eAClB,MAAM,gBACL,MAAM,KACnB,MAAmF,CAAC;AAEvF,eAAO,MAAM,gBAAgB,SACrB,WAAW,aACN,QAAQ,WAAW,CAAC,KAC9B,WAKD,CAAC;AAEH,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAK;IAErB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM;CAIvD"}