@zhivex-ai/core 1.7.0 → 1.9.0

package/dist/model-resolver.d.ts

@@ -0,0 +1,105 @@
+import type { ModelCatalog, ModelCatalogEntry } from "./catalog.js";
+import { ConfigurationError } from "./errors.js";
+import type { LanguageModel, ModelCapabilities, ProviderAdapter } from "./types.js";
+export type ModelResolutionErrorCode = "invalid_configuration" | "invalid_identifier" | "alias_collision" | "unknown_alias" | "unknown_provider" | "unknown_model" | "invalid_resolved_model";
+/** Typed, preflight-only failure raised by the optional model resolver. */
+export declare class ModelResolutionError extends ConfigurationError {
+    readonly code: ModelResolutionErrorCode;
+    readonly details: {
+        identifier?: string;
+        provider?: string;
+        modelId?: string;
+        alias?: string;
+    };
+    constructor(code: ModelResolutionErrorCode, message: string, details?: {
+        identifier?: string;
+        provider?: string;
+        modelId?: string;
+        alias?: string;
+    }, options?: {
+        cause?: unknown;
+    });
+}
+export interface ModelReference {
+    readonly provider: string;
+    readonly modelId: string;
+}
+export interface ModelResolverAlias {
+    /** Application-owned shorthand. Aliases cannot contain `/`, so they never shadow explicit identifiers. */
+    readonly alias: string;
+    /** Explicit provider/model target or its structured equivalent. Alias chains are intentionally unsupported. */
+    readonly target: string | ModelReference;
+}
+export interface ModelResolverBackend<TLanguageModel extends LanguageModel = LanguageModel> {
+    /** Safe, application-defined label emitted in resolution metadata. Never use an endpoint or credential here. */
+    readonly name: string;
+    languageModel(reference: ModelReference): TLanguageModel;
+}
+export interface ModelResolutionCatalogMetadata {
+    readonly schemaVersion: number;
+    readonly contractVersion: string;
+    readonly snapshotVersion: string;
+    readonly pricingVersion?: string;
+    readonly currency?: string;
+}
+export interface ModelResolutionSourceMetadata {
+    readonly kind: "adapter" | "backend";
+    readonly name: string;
+}
+export type ModelResolutionCatalogEntry = Readonly<Omit<ModelCatalogEntry, "aliases" | "longContextPricing" | "recommendedFor">> & {
+    readonly aliases?: ReadonlyArray<NonNullable<ModelCatalogEntry["aliases"]>[number]>;
+    readonly longContextPricing?: Readonly<NonNullable<ModelCatalogEntry["longContextPricing"]>>;
+    readonly recommendedFor?: ReadonlyArray<NonNullable<ModelCatalogEntry["recommendedFor"]>[number]>;
+};
+export type ModelResolutionCapabilities = Readonly<Omit<ModelCapabilities, "reasoningEfforts" | "reasoningModes" | "reasoningContexts" | "realtime" | "agentCapabilities">> & {
+    readonly reasoningEfforts?: ReadonlyArray<NonNullable<ModelCapabilities["reasoningEfforts"]>[number]>;
+    readonly reasoningModes?: ReadonlyArray<NonNullable<ModelCapabilities["reasoningModes"]>[number]>;
+    readonly reasoningContexts?: ReadonlyArray<NonNullable<ModelCapabilities["reasoningContexts"]>[number]>;
+    readonly realtime?: Readonly<NonNullable<ModelCapabilities["realtime"]>>;
+    readonly agentCapabilities?: Readonly<NonNullable<ModelCapabilities["agentCapabilities"]>>;
+};
+export interface ModelResolutionMetadata {
+    readonly schemaVersion: 1;
+    /** Exact, validated application input. */
+    readonly identifier: string;
+    /** Explicit target after expanding an application alias, before catalog aliases are canonicalized. */
+    readonly requested: Readonly<ModelReference>;
+    /** Canonical identity from the injected catalog. */
+    readonly resolved: Readonly<ModelReference>;
+    readonly alias?: string;
+    readonly source: Readonly<ModelResolutionSourceMetadata>;
+    readonly catalog: Readonly<ModelResolutionCatalogMetadata>;
+    readonly catalogEntry: ModelResolutionCatalogEntry;
+    readonly capabilities: ModelResolutionCapabilities;
+}
+export interface ModelResolution<TLanguageModel extends LanguageModel = LanguageModel> {
+    readonly model: TLanguageModel;
+    readonly metadata: ModelResolutionMetadata;
+}
+export interface ModelResolver<TLanguageModel extends LanguageModel = LanguageModel> {
+    /** Resolve both the existing provider model and immutable trace/budget metadata. */
+    resolve(identifier: string): ModelResolution<TLanguageModel>;
+    /** Convenience path for passing a resolved model directly to generateText, Agent, or another runtime API. */
+    model(identifier: string): TLanguageModel;
+}
+interface ModelResolverSharedOptions {
+    /** Explicit immutable inventory used to reject unknown providers/models before adapter or backend execution. */
+    catalog: ModelCatalog;
+    aliases?: readonly ModelResolverAlias[];
+    /** Receives frozen, secret-free metadata after a successful local resolution. */
+    onResolve?: (metadata: ModelResolutionMetadata) => void;
+}
+export type CreateModelResolverOptions<TLanguageModel extends LanguageModel = LanguageModel> = ModelResolverSharedOptions & ({
+    adapters: Readonly<Record<string, ProviderAdapter<TLanguageModel>>>;
+    backend?: never;
+} | {
+    adapters?: never;
+    backend: ModelResolverBackend<TLanguageModel>;
+});
+/**
+ * Creates an instance-local, immutable Beta registry for optional provider/model identifiers.
+ * Direct provider factories remain the canonical low-level path.
+ */
+export declare const createModelResolver: <TLanguageModel extends LanguageModel = LanguageModel>(options: CreateModelResolverOptions<TLanguageModel>) => ModelResolver<TLanguageModel>;
+export {};
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/model-resolver.d.ts.map

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

package/dist/model-resolver.js

@@ -0,0 +1,396 @@
+import { ConfigurationError } from "./errors.js";
+const MAX_PROVIDER_LENGTH = 128;
+const MAX_MODEL_ID_LENGTH = 256;
+const MAX_ALIAS_LENGTH = 128;
+/** Typed, preflight-only failure raised by the optional model resolver. */
+export class ModelResolutionError extends ConfigurationError {
+    code;
+    details;
+    constructor(code, message, details = {}, options) {
+        super(message, options);
+        this.code = code;
+        this.details = details;
+    }
+}
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isObjectOrFunction = (value) => (typeof value === "object" && value !== null) || typeof value === "function";
+const hasControlCharacters = (value) => /[\u0000-\u001f\u007f]/u.test(value);
+const validateProvider = (provider) => typeof provider === "string" &&
+    provider.length > 0 &&
+    provider.length <= MAX_PROVIDER_LENGTH &&
+    provider === provider.trim() &&
+    /^[A-Za-z0-9][A-Za-z0-9._-]*$/u.test(provider);
+const validateModelId = (modelId) => typeof modelId === "string" &&
+    modelId.length > 0 &&
+    modelId.length <= MAX_MODEL_ID_LENGTH &&
+    modelId === modelId.trim() &&
+    !modelId.includes("://") &&
+    !hasControlCharacters(modelId);
+const invalidIdentifier = (message) => {
+    throw new ModelResolutionError("invalid_identifier", message);
+};
+const normalizeReference = (input) => {
+    if (typeof input === "string") {
+        if (input.length === 0 || input !== input.trim() || hasControlCharacters(input)) {
+            return invalidIdentifier("Model identifiers must be non-empty and must not contain surrounding whitespace or control characters.");
+        }
+        const separator = input.indexOf("/");
+        if (separator <= 0 || separator === input.length - 1) {
+            return invalidIdentifier('Model identifiers must use the explicit "provider/model" format.');
+        }
+        return normalizeReference({
+            provider: input.slice(0, separator),
+            modelId: input.slice(separator + 1)
+        });
+    }
+    if (!isObject(input) || !validateProvider(input.provider) || !validateModelId(input.modelId)) {
+        return invalidIdentifier(`Model references require a provider of at most ${MAX_PROVIDER_LENGTH} safe characters and a modelId of at most ${MAX_MODEL_ID_LENGTH} characters.`);
+    }
+    return Object.freeze({ provider: input.provider, modelId: input.modelId });
+};
+const normalizeAlias = (alias) => {
+    if (typeof alias !== "string" ||
+        alias.length === 0 ||
+        alias.length > MAX_ALIAS_LENGTH ||
+        alias !== alias.trim() ||
+        alias.includes("/") ||
+        hasControlCharacters(alias)) {
+        throw new ModelResolutionError("invalid_configuration", `Model aliases must be non-empty, contain no slash, and be at most ${MAX_ALIAS_LENGTH} characters.`);
+    }
+    return alias;
+};
+const requiredCapabilityBooleans = [
+    "streaming",
+    "tools",
+    "structuredOutput",
+    "jsonMode",
+    "toolChoice",
+    "parallelToolCalls",
+    "vision",
+    "files",
+    "audioInput",
+    "audioOutput",
+    "embeddings",
+    "reasoning",
+    "webSearch"
+];
+const optionalCapabilityBooleans = [
+    "imageGeneration",
+    "videoGeneration",
+    "musicGeneration",
+    "fileSearch",
+    "urlContext",
+    "contextCaching",
+    "explicitPromptCaching",
+    "batch",
+    "interactions",
+    "rawPrediction",
+    "computerUse"
+];
+const hasBooleanFields = (value, fields) => fields.every((field) => typeof value[field] === "boolean");
+const hasOptionalBooleanFields = (value, fields) => fields.every((field) => value[field] === undefined || typeof value[field] === "boolean");
+const isStringArrayOrUndefined = (value) => value === undefined || (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
+const isModelCapabilities = (value) => {
+    if (!isObject(value) ||
+        !hasBooleanFields(value, requiredCapabilityBooleans) ||
+        !hasOptionalBooleanFields(value, optionalCapabilityBooleans) ||
+        !isStringArrayOrUndefined(value.reasoningEfforts) ||
+        !isStringArrayOrUndefined(value.reasoningModes) ||
+        !isStringArrayOrUndefined(value.reasoningContexts)) {
+        return false;
+    }
+    if (value.realtime !== undefined &&
+        (!isObject(value.realtime) ||
+            !hasBooleanFields(value.realtime, [
+                "sessions",
+                "audioInput",
+                "audioOutput",
+                "imageInput",
+                "tools",
+                "browserTokens"
+            ]))) {
+        return false;
+    }
+    if (value.agentCapabilities !== undefined) {
+        const agent = value.agentCapabilities;
+        if (!isObject(agent) ||
+            (agent.supportTier !== "tier-a" && agent.supportTier !== "tier-b" && agent.supportTier !== "tier-c") ||
+            !hasBooleanFields(agent, [
+                "toolChoiceNone",
+                "approvalRequests",
+                "hostedWebSearch",
+                "hostedFileSearch",
+                "remoteMcp",
+                "computerUse",
+                "codeExecution",
+                "toolsets"
+            ]) ||
+            !hasOptionalBooleanFields(agent, [
+                "shell",
+                "applyPatch",
+                "toolSearch",
+                "webExtraction",
+                "skills",
+                "programmaticToolCalling",
+                "multiAgent"
+            ])) {
+            return false;
+        }
+    }
+    return true;
+};
+const cloneCatalogEntry = (entry) => {
+    const clone = {
+        provider: entry.provider,
+        modelId: entry.modelId,
+        ...(entry.aliases === undefined ? {} : { aliases: Object.freeze([...entry.aliases]) }),
+        ...(entry.inputCostPer1kTokens === undefined ? {} : { inputCostPer1kTokens: entry.inputCostPer1kTokens }),
+        ...(entry.cachedInputCostPer1kTokens === undefined
+            ? {}
+            : { cachedInputCostPer1kTokens: entry.cachedInputCostPer1kTokens }),
+        ...(entry.cacheWriteCostPer1kTokens === undefined
+            ? {}
+            : { cacheWriteCostPer1kTokens: entry.cacheWriteCostPer1kTokens }),
+        ...(entry.outputCostPer1kTokens === undefined ? {} : { outputCostPer1kTokens: entry.outputCostPer1kTokens }),
+        ...(entry.costPer1kTokens === undefined ? {} : { costPer1kTokens: entry.costPer1kTokens }),
+        ...(entry.longContextPricing === undefined
+            ? {}
+            : { longContextPricing: Object.freeze({ ...entry.longContextPricing }) }),
+        ...(entry.recommendedFor === undefined
+            ? {}
+            : { recommendedFor: Object.freeze([...entry.recommendedFor]) })
+    };
+    return Object.freeze(clone);
+};
+const cloneCapabilities = (capabilities) => {
+    const clone = {
+        streaming: capabilities.streaming,
+        tools: capabilities.tools,
+        structuredOutput: capabilities.structuredOutput,
+        jsonMode: capabilities.jsonMode,
+        toolChoice: capabilities.toolChoice,
+        parallelToolCalls: capabilities.parallelToolCalls,
+        vision: capabilities.vision,
+        files: capabilities.files,
+        audioInput: capabilities.audioInput,
+        audioOutput: capabilities.audioOutput,
+        embeddings: capabilities.embeddings,
+        reasoning: capabilities.reasoning,
+        webSearch: capabilities.webSearch,
+        ...(capabilities.imageGeneration === undefined ? {} : { imageGeneration: capabilities.imageGeneration }),
+        ...(capabilities.videoGeneration === undefined ? {} : { videoGeneration: capabilities.videoGeneration }),
+        ...(capabilities.musicGeneration === undefined ? {} : { musicGeneration: capabilities.musicGeneration }),
+        ...(capabilities.fileSearch === undefined ? {} : { fileSearch: capabilities.fileSearch }),
+        ...(capabilities.urlContext === undefined ? {} : { urlContext: capabilities.urlContext }),
+        ...(capabilities.contextCaching === undefined ? {} : { contextCaching: capabilities.contextCaching }),
+        ...(capabilities.explicitPromptCaching === undefined
+            ? {}
+            : { explicitPromptCaching: capabilities.explicitPromptCaching }),
+        ...(capabilities.batch === undefined ? {} : { batch: capabilities.batch }),
+        ...(capabilities.interactions === undefined ? {} : { interactions: capabilities.interactions }),
+        ...(capabilities.rawPrediction === undefined ? {} : { rawPrediction: capabilities.rawPrediction }),
+        ...(capabilities.computerUse === undefined ? {} : { computerUse: capabilities.computerUse }),
+        ...(capabilities.reasoningEfforts === undefined
+            ? {}
+            : { reasoningEfforts: Object.freeze([...capabilities.reasoningEfforts]) }),
+        ...(capabilities.reasoningModes === undefined
+            ? {}
+            : { reasoningModes: Object.freeze([...capabilities.reasoningModes]) }),
+        ...(capabilities.reasoningContexts === undefined
+            ? {}
+            : { reasoningContexts: Object.freeze([...capabilities.reasoningContexts]) }),
+        ...(capabilities.realtime === undefined
+            ? {}
+            : {
+                realtime: Object.freeze({
+                    sessions: capabilities.realtime.sessions,
+                    audioInput: capabilities.realtime.audioInput,
+                    audioOutput: capabilities.realtime.audioOutput,
+                    imageInput: capabilities.realtime.imageInput,
+                    tools: capabilities.realtime.tools,
+                    browserTokens: capabilities.realtime.browserTokens
+                })
+            }),
+        ...(capabilities.agentCapabilities === undefined
+            ? {}
+            : {
+                agentCapabilities: Object.freeze({
+                    supportTier: capabilities.agentCapabilities.supportTier,
+                    toolChoiceNone: capabilities.agentCapabilities.toolChoiceNone,
+                    approvalRequests: capabilities.agentCapabilities.approvalRequests,
+                    hostedWebSearch: capabilities.agentCapabilities.hostedWebSearch,
+                    hostedFileSearch: capabilities.agentCapabilities.hostedFileSearch,
+                    remoteMcp: capabilities.agentCapabilities.remoteMcp,
+                    computerUse: capabilities.agentCapabilities.computerUse,
+                    codeExecution: capabilities.agentCapabilities.codeExecution,
+                    toolsets: capabilities.agentCapabilities.toolsets,
+                    ...(capabilities.agentCapabilities.shell === undefined
+                        ? {}
+                        : { shell: capabilities.agentCapabilities.shell }),
+                    ...(capabilities.agentCapabilities.applyPatch === undefined
+                        ? {}
+                        : { applyPatch: capabilities.agentCapabilities.applyPatch }),
+                    ...(capabilities.agentCapabilities.toolSearch === undefined
+                        ? {}
+                        : { toolSearch: capabilities.agentCapabilities.toolSearch }),
+                    ...(capabilities.agentCapabilities.webExtraction === undefined
+                        ? {}
+                        : { webExtraction: capabilities.agentCapabilities.webExtraction }),
+                    ...(capabilities.agentCapabilities.skills === undefined
+                        ? {}
+                        : { skills: capabilities.agentCapabilities.skills }),
+                    ...(capabilities.agentCapabilities.programmaticToolCalling === undefined
+                        ? {}
+                        : { programmaticToolCalling: capabilities.agentCapabilities.programmaticToolCalling }),
+                    ...(capabilities.agentCapabilities.multiAgent === undefined
+                        ? {}
+                        : { multiAgent: capabilities.agentCapabilities.multiAgent })
+                })
+            })
+    };
+    return Object.freeze(clone);
+};
+const assertResolvedModel = (model) => {
+    if (!isObject(model) ||
+        !validateProvider(model.provider) ||
+        !validateModelId(model.modelId) ||
+        !isModelCapabilities(model.capabilities) ||
+        typeof model.generate !== "function") {
+        throw new ModelResolutionError("invalid_resolved_model", "The configured adapter or backend returned an invalid language model before any model call was made.");
+    }
+    return model;
+};
+const assertCatalog = (catalog) => {
+    if (!isObject(catalog) || typeof catalog.find !== "function" || typeof catalog.list !== "function") {
+        throw new ModelResolutionError("invalid_configuration", "createModelResolver requires an explicit ModelCatalog instance.");
+    }
+};
+/**
+ * Creates an instance-local, immutable Beta registry for optional provider/model identifiers.
+ * Direct provider factories remain the canonical low-level path.
+ */
+export const createModelResolver = (options) => {
+    if (!isObject(options)) {
+        throw new ModelResolutionError("invalid_configuration", "createModelResolver options must be an object.");
+    }
+    assertCatalog(options.catalog);
+    const catalog = options.catalog;
+    const onResolve = options.onResolve;
+    const hasAdapters = options.adapters !== undefined;
+    const hasBackend = options.backend !== undefined;
+    if (hasAdapters === hasBackend) {
+        throw new ModelResolutionError("invalid_configuration", "createModelResolver requires exactly one explicit source: adapters or backend.");
+    }
+    if (options.onResolve !== undefined && typeof options.onResolve !== "function") {
+        throw new ModelResolutionError("invalid_configuration", "createModelResolver onResolve must be a function.");
+    }
+    const catalogEntries = catalog.list();
+    const catalogProviders = new Set(catalogEntries.map((entry) => entry.provider));
+    const catalogMetadata = catalog.metadata;
+    const catalogTraceMetadata = Object.freeze({
+        schemaVersion: catalogMetadata.schemaVersion,
+        contractVersion: catalogMetadata.contractVersion,
+        snapshotVersion: catalogMetadata.snapshotVersion,
+        ...(catalogMetadata.pricing?.version === undefined
+            ? {}
+            : { pricingVersion: catalogMetadata.pricing.version }),
+        ...(catalogMetadata.pricing?.currency === undefined ? {} : { currency: catalogMetadata.pricing.currency })
+    });
+    let adapters;
+    let backend;
+    if (hasAdapters) {
+        if (!isObject(options.adapters)) {
+            throw new ModelResolutionError("invalid_configuration", "createModelResolver adapters must be an object.");
+        }
+        const adapterSnapshot = {};
+        for (const [provider, adapter] of Object.entries(options.adapters)) {
+            if (!validateProvider(provider) || !isObjectOrFunction(adapter) || typeof adapter.languageModel !== "function") {
+                throw new ModelResolutionError("invalid_configuration", "Every model resolver adapter requires a safe provider key and a languageModel factory.");
+            }
+            adapterSnapshot[provider] = adapter;
+        }
+        adapters = Object.freeze(adapterSnapshot);
+    }
+    else {
+        if (!isObject(options.backend) ||
+            !validateProvider(options.backend.name) ||
+            typeof options.backend.languageModel !== "function") {
+            throw new ModelResolutionError("invalid_configuration", "A model resolver backend requires a safe name and a languageModel factory.");
+        }
+        backend = options.backend;
+    }
+    const findCatalogEntry = (reference) => {
+        if (!catalogProviders.has(reference.provider)) {
+            throw new ModelResolutionError("unknown_provider", "The requested model provider is not present in the configured catalog.");
+        }
+        if (adapters !== undefined && !Object.prototype.hasOwnProperty.call(adapters, reference.provider)) {
+            throw new ModelResolutionError("unknown_provider", "The requested model provider is not configured in this resolver.");
+        }
+        const entry = catalog.find(reference.provider, reference.modelId);
+        if (entry === undefined) {
+            throw new ModelResolutionError("unknown_model", "The requested model is not present for its provider in the configured catalog.");
+        }
+        return entry;
+    };
+    const aliases = new Map();
+    if (options.aliases !== undefined) {
+        if (!Array.isArray(options.aliases)) {
+            throw new ModelResolutionError("invalid_configuration", "createModelResolver aliases must be an array.");
+        }
+        for (const aliasDefinition of options.aliases) {
+            if (!isObject(aliasDefinition)) {
+                throw new ModelResolutionError("invalid_configuration", "Every model resolver alias must be an object.");
+            }
+            const alias = normalizeAlias(aliasDefinition.alias);
+            if (aliases.has(alias)) {
+                throw new ModelResolutionError("alias_collision", "A model alias is configured more than once.");
+            }
+            const rawTarget = aliasDefinition.target;
+            if (typeof rawTarget !== "string" && !isObject(rawTarget)) {
+                throw new ModelResolutionError("invalid_configuration", "Every model resolver alias target must be an explicit provider/model string or reference.");
+            }
+            const target = normalizeReference(rawTarget);
+            findCatalogEntry(target);
+            aliases.set(alias, target);
+        }
+    }
+    const resolve = (identifier) => {
+        if (typeof identifier !== "string") {
+            return invalidIdentifier("Model identifiers must be strings.");
+        }
+        const aliasTarget = aliases.get(identifier);
+        if (!identifier.includes("/") && aliasTarget === undefined) {
+            const alias = normalizeAlias(identifier);
+            throw new ModelResolutionError("unknown_alias", "The requested model alias is not configured in this resolver.");
+        }
+        const requested = aliasTarget ?? normalizeReference(identifier);
+        const entry = findCatalogEntry(requested);
+        const canonical = Object.freeze({ provider: entry.provider, modelId: entry.modelId });
+        const source = adapters === undefined
+            ? Object.freeze({ kind: "backend", name: backend.name })
+            : Object.freeze({ kind: "adapter", name: canonical.provider });
+        const model = assertResolvedModel(adapters === undefined
+            ? backend.languageModel(canonical)
+            : adapters[canonical.provider].languageModel(canonical.modelId));
+        const metadata = Object.freeze({
+            schemaVersion: 1,
+            identifier,
+            requested: Object.freeze({ ...requested }),
+            resolved: canonical,
+            ...(aliasTarget === undefined ? {} : { alias: identifier }),
+            source,
+            catalog: catalogTraceMetadata,
+            catalogEntry: cloneCatalogEntry(entry),
+            capabilities: cloneCapabilities(model.capabilities)
+        });
+        onResolve?.(metadata);
+        return Object.freeze({ model, metadata });
+    };
+    return Object.freeze({
+        resolve,
+        model(identifier) {
+            return resolve(identifier).model;
+        }
+    });
+};
+//# sourceMappingURL=model-resolver.js.map

package/dist/model-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../src/model-resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAW7B,2EAA2E;AAC3E,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;IAE/C;IAEA;IAHX,YACW,IAA8B,EACvC,OAAe,EACN,UAKL,EAAE,EACN,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAVf,SAAI,GAAJ,IAAI,CAA0B;QAE9B,YAAO,GAAP,OAAO,CAKV;IAIR,CAAC;CACF;AAsGD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC9E,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;AAE/E,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAE9F,MAAM,gBAAgB,GAAG,CAAC,QAAiB,EAAsB,EAAE,CACjE,OAAO,QAAQ,KAAK,QAAQ;IAC5B,QAAQ,CAAC,MAAM,GAAG,CAAC;IACnB,QAAQ,CAAC,MAAM,IAAI,mBAAmB;IACtC,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE;IAC5B,+BAA+B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAEjD,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAqB,EAAE,CAC9D,OAAO,OAAO,KAAK,QAAQ;IAC3B,OAAO,CAAC,MAAM,GAAG,CAAC;IAClB,OAAO,CAAC,MAAM,IAAI,mBAAmB;IACrC,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE;IAC1B,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAEjC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAS,EAAE;IACnD,MAAM,IAAI,oBAAoB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAA8B,EAAkB,EAAE;IAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,OAAO,iBAAiB,CACtB,wGAAwG,CACzG,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,iBAAiB,CAAC,kEAAkE,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,kBAAkB,CAAC;YACxB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YACnC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7F,OAAO,iBAAiB,CACtB,kDAAkD,mBAAmB,6CAA6C,mBAAmB,cAAc,CACpJ,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE;IAChD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,gBAAgB;QAC/B,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE;QACtB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnB,oBAAoB,CAAC,KAAK,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,qEAAqE,gBAAgB,cAAc,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG;IACjC,WAAW;IACX,OAAO;IACP,kBAAkB;IAClB,UAAU;IACV,YAAY;IACZ,mBAAmB;IACnB,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,WAAW;IACX,WAAW;CACH,CAAC;AAEX,MAAM,0BAA0B,GAAG;IACjC,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,gBAAgB;IAChB,uBAAuB;IACvB,OAAO;IACP,cAAc;IACd,eAAe;IACf,aAAa;CACL,CAAC;AAEX,MAAM,gBAAgB,GAAG,CAAC,KAA8B,EAAE,MAAyB,EAAW,EAAE,CAC9F,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;AAE7D,MAAM,wBAAwB,GAAG,CAAC,KAA8B,EAAE,MAAyB,EAAW,EAAE,CACtG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;AAE3F,MAAM,wBAAwB,GAAG,CAAC,KAAc,EAAW,EAAE,CAC3D,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC;AAErG,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA8B,EAAE;IACzE,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,gBAAgB,CAAC,KAAK,EAAE,0BAA0B,CAAC;QACpD,CAAC,wBAAwB,CAAC,KAAK,EAAE,0BAA0B,CAAC;QAC5D,CAAC,wBAAwB,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACjD,CAAC,wBAAwB,CAAC,KAAK,CAAC,cAAc,CAAC;QAC/C,CAAC,wBAAwB,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAClD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE;gBAChC,UAAU;gBACV,YAAY;gBACZ,aAAa;gBACb,YAAY;gBACZ,OAAO;gBACP,eAAe;aAChB,CAAC,CAAC,EACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,iBAAiB,CAAC;QACtC,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;YAChB,CAAC,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC;YACpG,CAAC,gBAAgB,CAAC,KAAK,EAAE;gBACvB,gBAAgB;gBAChB,kBAAkB;gBAClB,iBAAiB;gBACjB,kBAAkB;gBAClB,WAAW;gBACX,aAAa;gBACb,eAAe;gBACf,UAAU;aACX,CAAC;YACF,CAAC,wBAAwB,CAAC,KAAK,EAAE;gBAC/B,OAAO;gBACP,YAAY;gBACZ,YAAY;gBACZ,eAAe;gBACf,QAAQ;gBACR,yBAAyB;gBACzB,YAAY;aACb,CAAC,EACF,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAwB,EAA+B,EAAE;IAClF,MAAM,KAAK,GAAsB;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAa,EAAE,CAAC;QAClG,GAAG,CAAC,KAAK,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACzG,GAAG,CAAC,KAAK,CAAC,0BAA0B,KAAK,SAAS;YAChD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,0BAA0B,EAAE,KAAK,CAAC,0BAA0B,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,yBAAyB,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,yBAAyB,EAAE,KAAK,CAAC,yBAAyB,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAC5G,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1F,GAAG,CAAC,KAAK,CAAC,kBAAkB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAwC,EAAE,CAAC;KACzG,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAgC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,YAA+B,EAA+B,EAAE;IACzF,MAAM,KAAK,GAAsB;QAC/B,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;QAC/C,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,iBAAiB,EAAE,YAAY,CAAC,iBAAiB;QACjD,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,GAAG,CAAC,YAAY,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,eAAe,EAAE,CAAC;QACxG,GAAG,CAAC,YAAY,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,eAAe,EAAE,CAAC;QACxG,GAAG,CAAC,YAAY,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,eAAe,EAAE,CAAC;QACxG,GAAG,CAAC,YAAY,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,CAAC;QACzF,GAAG,CAAC,YAAY,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,CAAC;QACzF,GAAG,CAAC,YAAY,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,cAAc,EAAE,CAAC;QACrG,GAAG,CAAC,YAAY,CAAC,qBAAqB,KAAK,SAAS;YAClD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,qBAAqB,EAAE,YAAY,CAAC,qBAAqB,EAAE,CAAC;QAClE,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1E,GAAG,CAAC,YAAY,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,YAAY,EAAE,CAAC;QAC/F,GAAG,CAAC,YAAY,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,CAAC,aAAa,EAAE,CAAC;QAClG,GAAG,CAAC,YAAY,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,WAAW,EAAE,CAAC;QAC5F,GAAG,CAAC,YAAY,CAAC,gBAAgB,KAAK,SAAS;YAC7C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAA0C,EAAE,CAAC;QACrH,GAAG,CAAC,YAAY,CAAC,cAAc,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAwC,EAAE,CAAC;QAC/G,GAAG,CAAC,YAAY,CAAC,iBAAiB,KAAK,SAAS;YAC9C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAA2C,EAAE,CAAC;QACxH,GAAG,CAAC,YAAY,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;oBACtB,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,QAAQ;oBACxC,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,UAAU;oBAC5C,WAAW,EAAE,YAAY,CAAC,QAAQ,CAAC,WAAW;oBAC9C,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,UAAU;oBAC5C,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK;oBAClC,aAAa,EAAE,YAAY,CAAC,QAAQ,CAAC,aAAa;iBACnD,CAAC;aACH,CAAC;QACN,GAAG,CAAC,YAAY,CAAC,iBAAiB,KAAK,SAAS;YAC9C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;oBAC/B,WAAW,EAAE,YAAY,CAAC,iBAAiB,CAAC,WAAW;oBACvD,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,cAAc;oBAC7D,gBAAgB,EAAE,YAAY,CAAC,iBAAiB,CAAC,gBAAgB;oBACjE,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,eAAe;oBAC/D,gBAAgB,EAAE,YAAY,CAAC,iBAAiB,CAAC,gBAAgB;oBACjE,SAAS,EAAE,YAAY,CAAC,iBAAiB,CAAC,SAAS;oBACnD,WAAW,EAAE,YAAY,CAAC,iBAAiB,CAAC,WAAW;oBACvD,aAAa,EAAE,YAAY,CAAC,iBAAiB,CAAC,aAAa;oBAC3D,QAAQ,EAAE,YAAY,CAAC,iBAAiB,CAAC,QAAQ;oBACjD,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,KAAK,SAAS;wBACpD,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;oBACpD,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,UAAU,KAAK,SAAS;wBACzD,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAC;oBAC9D,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,UAAU,KAAK,SAAS;wBACzD,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAC;oBAC9D,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,aAAa,KAAK,SAAS;wBAC5D,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC;oBACpE,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,MAAM,KAAK,SAAS;wBACrD,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;oBACtD,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,uBAAuB,KAAK,SAAS;wBACtE,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,uBAAuB,EAAE,YAAY,CAAC,iBAAiB,CAAC,uBAAuB,EAAE,CAAC;oBACxF,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,UAAU,KAAK,SAAS;wBACzD,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAC;iBAC/D,CAAC;aACH,CAAC;KACP,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAgC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAuC,KAAqB,EAAkB,EAAE;IAC1G,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/B,CAAC,mBAAmB,CAAC,KAAK,CAAC,YAAY,CAAC;QACxC,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,EACpC,CAAC;QACD,MAAM,IAAI,oBAAoB,CAC5B,wBAAwB,EACxB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,aAAa,GAA0D,CAAC,OAAO,EAAE,EAAE;IACvF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACnG,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,iEAAiE,CAClE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAAmD,EACpB,EAAE;IACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,EAAE,gDAAgD,CAAC,CAAC;IAC5G,CAAC;IACD,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAEpC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;IACjD,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/E,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,EAAE,mDAAmD,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChF,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IACzC,MAAM,oBAAoB,GAA6C,MAAM,CAAC,MAAM,CAAC;QACnF,aAAa,EAAE,eAAe,CAAC,aAAa;QAC5C,eAAe,EAAE,eAAe,CAAC,eAAe;QAChD,eAAe,EAAE,eAAe,CAAC,eAAe;QAChD,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS;YAChD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACxD,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;KAC3G,CAAC,CAAC;IAEH,IAAI,QAA+E,CAAC;IACpF,IAAI,OAAyD,CAAC;IAC9D,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,EAAE,iDAAiD,CAAC,CAAC;QAC7G,CAAC;QACD,MAAM,eAAe,GAAoD,EAAE,CAAC;QAC5E,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;gBAC/G,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,wFAAwF,CACzF,CAAC;YACJ,CAAC;YACD,eAAe,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QACtC,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,IACE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;YAC1B,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,KAAK,UAAU,EACnD,CAAC;YACD,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,SAAyB,EAAqB,EAAE;QACxE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,oBAAoB,CAC5B,kBAAkB,EAClB,wEAAwE,CACzE,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClG,MAAM,IAAI,oBAAoB,CAC5B,kBAAkB,EAClB,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QAClE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,oBAAoB,CAC5B,eAAe,EACf,gFAAgF,CACjF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,EAAE,+CAA+C,CAAC,CAAC;QAC3G,CAAC;QACD,KAAK,MAAM,eAAe,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,EAAE,+CAA+C,CAAC,CAAC;YAC3G,CAAC;YACD,MAAM,KAAK,GAAG,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,oBAAoB,CAC5B,iBAAiB,EACjB,6CAA6C,CAC9C,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC;YACzC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,2FAA2F,CAC5F,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAoC,CAAC,CAAC;YACxE,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,UAAkB,EAAmC,EAAE;QACtE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,IAAI,oBAAoB,CAC5B,eAAe,EACf,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS;YACnC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,IAAI,EAAE,OAAQ,CAAC,IAAI,EAAE,CAAC;YAClE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,mBAAmB,CAC/B,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,OAAQ,CAAC,aAAa,CAAC,SAAS,CAAC;YACnC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAE,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CACnE,CAAC;QACF,MAAM,QAAQ,GAA4B,MAAM,CAAC,MAAM,CAAC;YACtD,aAAa,EAAE,CAAU;YACzB,UAAU;YACV,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC;YAC1C,QAAQ,EAAE,SAAS;YACnB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YAC3D,MAAM;YACN,OAAO,EAAE,oBAAoB;YAC7B,YAAY,EAAE,iBAAiB,CAAC,KAAK,CAAC;YACtC,YAAY,EAAE,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC;SACpD,CAAC,CAAC;QACH,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,KAAK,CAAC,UAAkB;YACtB,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC;QACnC,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/raw-provider-options.d.ts

@@ -0,0 +1,20 @@
+declare const experimentalRawProviderOptionsBrand: unique symbol;
+type DeepReadonly<T> = T extends readonly (infer TItem)[] ? readonly DeepReadonly<TItem>[] : T extends object ? {
+    readonly [TKey in keyof T]: DeepReadonly<T[TKey]>;
+} : T;
+/**
+ * Explicitly branded provider passthrough options.
+ *
+ * The SDK validates that the input is a plain JSON-like record, but the
+ * provider remains responsible for deciding which fields are accepted.
+ */
+export type ExperimentalRawProviderOptions<T extends Record<string, unknown> = Record<string, unknown>> = DeepReadonly<T> & {
+    readonly [experimentalRawProviderOptionsBrand]: true;
+};
+/**
+ * Marks arbitrary provider request fields as an intentional Experimental
+ * dependency and returns an immutable, JSON-compatible copy.
+ */
+export declare const experimentalRawProviderOptions: <T extends Record<string, unknown>>(options: T) => ExperimentalRawProviderOptions<T>;
+export {};
+//# sourceMappingURL=raw-provider-options.d.ts.map

package/dist/raw-provider-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-provider-options.d.ts","sourceRoot":"","sources":["../src/raw-provider-options.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,mCAAmC,EAAE,OAAO,MAAM,CAAC;AAEjE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACrD,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,GAC9B,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;CAAE,GACrD,CAAC,CAAC;AAER;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACpG,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,mCAAmC,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAsD7E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9E,SAAS,CAAC,KACT,8BAA8B,CAAC,CAAC,CAKlC,CAAC"}

package/dist/raw-provider-options.js

@@ -0,0 +1,63 @@
+import { ValidationError } from "./errors.js";
+const cloneRawValue = (value, path, seen) => {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new ValidationError(`${path} must contain only finite JSON numbers.`);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value)) {
+            throw new ValidationError(`${path} must not contain circular references.`);
+        }
+        seen.add(value);
+        const cloned = value.map((item, index) => cloneRawValue(item, `${path}[${index}]`, seen));
+        seen.delete(value);
+        return Object.freeze(cloned);
+    }
+    if (typeof value !== "object" || value === null) {
+        throw new ValidationError(`${path} must contain JSON-compatible values.`);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw new ValidationError(`${path} must contain plain objects only.`);
+    }
+    if (Object.getOwnPropertySymbols(value).length > 0) {
+        throw new ValidationError(`${path} must not contain symbol properties.`);
+    }
+    if (seen.has(value)) {
+        throw new ValidationError(`${path} must not contain circular references.`);
+    }
+    seen.add(value);
+    const cloned = {};
+    for (const key of Object.keys(value)) {
+        if (!key || /[\u0000-\u001f\u007f]/u.test(key)) {
+            throw new ValidationError(`${path} contains an invalid property name.`);
+        }
+        if (key === "__proto__" || key === "prototype" || key === "constructor") {
+            throw new ValidationError(`${path}.${key} is not allowed.`);
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor || !("value" in descriptor)) {
+            throw new ValidationError(`${path}.${key} must be a data property.`);
+        }
+        const item = descriptor.value;
+        cloned[key] = cloneRawValue(item, `${path}.${key}`, seen);
+    }
+    seen.delete(value);
+    return Object.freeze(cloned);
+};
+/**
+ * Marks arbitrary provider request fields as an intentional Experimental
+ * dependency and returns an immutable, JSON-compatible copy.
+ */
+export const experimentalRawProviderOptions = (options) => {
+    if (typeof options !== "object" || options === null || Array.isArray(options)) {
+        throw new ValidationError("Raw provider options must be a plain object.");
+    }
+    return cloneRawValue(options, "providerOptions", new Set());
+};
+//# sourceMappingURL=raw-provider-options.js.map

package/dist/raw-provider-options.js.map

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

package/dist/types.d.ts

@@ -559,6 +559,11 @@ export type GenerateInputSource = {
     prompt?: undefined;
     messages?: undefined;
 };
+/**
+ * Provider-specific request fields. Known provider adapters expose narrower
+ * generic option types. Arbitrary passthrough fields are Experimental; wrap
+ * them with `experimentalRawProviderOptions()` so the dependency is explicit.
+ */
 export type ProviderOptions = Record<string, unknown>;
 export interface ModelGenerateInput<TProviderOptions extends ProviderOptions = ProviderOptions> extends RetryOptions {
     messages: ModelMessage[];