@sriinnu/kosha-discovery 0.5.0

package/dist/registry-delta.js

@@ -0,0 +1,74 @@
+/**
+ * kosha-discovery — Snapshot diff helpers for the discovery plane.
+ *
+ * I keep delta construction separate so the snapshot/health file stays small
+ * and the diff semantics remain easy to test in isolation.
+ * @module
+ */
+import { DISCOVERY_SCHEMA_VERSION } from "./discovery-contract.js";
+/**
+ * Expand a snapshot into full upsert changes for bootstrap consumers.
+ */
+export function fullSnapshotChanges(snapshot) {
+    return [
+        ...snapshot.providers.map((provider) => ({
+            entity: "provider",
+            action: "upsert",
+            key: provider.providerId,
+            value: provider,
+        })),
+        ...snapshot.models.map((model) => ({
+            entity: "model",
+            action: "upsert",
+            key: model.key,
+            value: model,
+        })),
+        ...snapshot.health.map((health) => ({
+            entity: "health",
+            action: "upsert",
+            key: health.providerId,
+            value: health,
+        })),
+        ...snapshot.credentialPrompts.map((prompt) => ({
+            entity: "credential_prompt",
+            action: "upsert",
+            key: prompt.providerId,
+            value: prompt,
+        })),
+    ];
+}
+/**
+ * Diff two snapshots into a single delta batch.
+ */
+export function diffSnapshots(previous, next) {
+    const changes = [];
+    collectSectionChanges("provider", previous.providers, next.providers, (item) => item.providerId, changes);
+    collectSectionChanges("model", previous.models, next.models, (item) => item.key, changes);
+    collectSectionChanges("health", previous.health, next.health, (item) => item.providerId, changes);
+    collectSectionChanges("credential_prompt", previous.credentialPrompts, next.credentialPrompts, (item) => item.providerId, changes);
+    return {
+        schemaVersion: DISCOVERY_SCHEMA_VERSION,
+        sinceCursor: previous.cursor,
+        cursor: next.cursor,
+        changedAt: next.discoveredAt,
+        resetRequired: false,
+        changes,
+    };
+}
+function collectSectionChanges(entity, previous, next, keyOf, target) {
+    const previousMap = new Map(previous.map((item) => [keyOf(item), item]));
+    const nextMap = new Map(next.map((item) => [keyOf(item), item]));
+    for (const [key, item] of nextMap) {
+        const prev = previousMap.get(key);
+        // I use value-level JSON equality here because the schema objects are small and stable.
+        if (!prev || JSON.stringify(prev) !== JSON.stringify(item)) {
+            target.push({ entity, action: "upsert", key, value: item });
+        }
+    }
+    for (const key of previousMap.keys()) {
+        if (!nextMap.has(key)) {
+            target.push({ entity, action: "remove", key, value: null });
+        }
+    }
+}
+//# sourceMappingURL=registry-delta.js.map

package/dist/registry-delta.js.map

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

package/dist/registry-discovery.d.ts

@@ -0,0 +1,66 @@
+/**
+ * kosha-discovery — Discovery snapshot, delta, and health helpers.
+ *
+ * I keep the versioned discovery-plane projection here so `ModelRegistry`
+ * itself can stay focused on API shape and orchestration.
+ * @module
+ */
+import type { DiscoveryDeltaV1, DiscoveryHealthRecord, DiscoveryModelV1, DiscoveryProviderV1, DiscoverySnapshotV1 } from "./discovery-contract.js";
+import type { ModelCard } from "./types.js";
+import type { ProviderObservation, RegistryState } from "./registry-state.js";
+/**
+ * Return the cached snapshot when it is still valid for diff generation.
+ */
+export declare function registrySnapshotForDelta(state: RegistryState): DiscoverySnapshotV1 | null;
+/**
+ * Build and cache the stable v1 discovery snapshot.
+ */
+export declare function registryDiscoverySnapshot(state: RegistryState): DiscoverySnapshotV1;
+/**
+ * Return discovery deltas since a previous cursor.
+ */
+export declare function registryDiscoveryDelta(state: RegistryState, options?: {
+    sinceCursor?: string | null;
+}): DiscoveryDeltaV1;
+/**
+ * Stream live deltas through the shared registry event bus.
+ */
+export declare function registryWatchDiscovery(state: RegistryState, options?: {
+    sinceCursor?: string | null;
+}): AsyncGenerator<DiscoveryDeltaV1, void, void>;
+/**
+ * Advance the discovery cursor and emit a delta when the snapshot changes.
+ */
+export declare function registryRecordDiscoveryMutation(state: RegistryState, previousSnapshot: DiscoverySnapshotV1 | null): void;
+/**
+ * Build a monotonic cursor for snapshot and delta consumers.
+ */
+export declare function registryMakeCursor(state: RegistryState): string;
+/**
+ * Build the stable v1 discovery snapshot from in-memory state.
+ */
+export declare function registryBuildSnapshot(state: RegistryState, cursor: string): DiscoverySnapshotV1;
+/**
+ * Serialize one provider entry into the stable v1 schema.
+ */
+export declare function registrySerializeProvider(state: RegistryState, providerId: string): DiscoveryProviderV1;
+/**
+ * Serialize one model route into the stable v1 schema.
+ */
+export declare function registrySerializeModel(state: RegistryState, model: ModelCard): DiscoveryModelV1;
+/**
+ * Build the normalized provider-health projection for the v1 schema.
+ */
+export declare function registryBuildHealthRecord(state: RegistryState, providerId: string): DiscoveryHealthRecord;
+/**
+ * Store one provider observation for later health normalization.
+ */
+export declare function registryRecordObservation(state: RegistryState, providerId: string, entry: {
+    latencyMs: number;
+    errorType: ProviderObservation["lastErrorType"];
+}): void;
+/**
+ * Normalize a provider error message into a stable health class.
+ */
+export declare function registryClassifyError(errorMessage: string): ProviderObservation["lastErrorType"];
+//# sourceMappingURL=registry-discovery.d.ts.map

package/dist/registry-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-discovery.d.ts","sourceRoot":"","sources":["../src/registry-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EAAE,SAAS,EAA4B,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,GAAG,IAAI,CAIzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAInF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACvC,gBAAgB,CAiDlB;AAED;;GAEG;AACH,wBAAuB,sBAAsB,CAC5C,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACvC,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,CA6B9C;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,mBAAmB,GAAG,IAAI,GAC1C,IAAI,CAoBN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAuB/F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAsBvG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAgC/F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAmCzG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAA;CAAE,GAC3E,IAAI,CAkBN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAehG"}

package/dist/registry-discovery.js

@@ -0,0 +1,339 @@
+/**
+ * kosha-discovery — Discovery snapshot, delta, and health helpers.
+ *
+ * I keep the versioned discovery-plane projection here so `ModelRegistry`
+ * itself can stay focused on API shape and orchestration.
+ * @module
+ */
+import { DISCOVERY_SCHEMA_VERSION, discoveryRoles, makeModelKey, rawCapabilitiesForModel, trustedCapabilitiesForModel, } from "./discovery-contract.js";
+import { getProviderConfig, listProviderDescriptors, normalizeProviderId } from "./provider-catalog.js";
+import { diffSnapshots, fullSnapshotChanges } from "./registry-delta.js";
+import { registryModels, registryProviderDescriptor } from "./registry-query.js";
+/**
+ * Return the cached snapshot when it is still valid for diff generation.
+ */
+export function registrySnapshotForDelta(state) {
+    if (state.lastSnapshotCache)
+        return state.lastSnapshotCache;
+    if (state.providerMap.size === 0 && state.discoveredAt === 0)
+        return null;
+    return registryBuildSnapshot(state, state.currentCursor);
+}
+/**
+ * Build and cache the stable v1 discovery snapshot.
+ */
+export function registryDiscoverySnapshot(state) {
+    const snapshot = registryBuildSnapshot(state, state.currentCursor);
+    state.lastSnapshotCache = snapshot;
+    return snapshot;
+}
+/**
+ * Return discovery deltas since a previous cursor.
+ */
+export function registryDiscoveryDelta(state, options) {
+    const snapshot = registryDiscoverySnapshot(state);
+    const sinceCursor = options?.sinceCursor ?? null;
+    if (!sinceCursor) {
+        return {
+            schemaVersion: DISCOVERY_SCHEMA_VERSION,
+            sinceCursor,
+            cursor: snapshot.cursor,
+            changedAt: snapshot.discoveredAt,
+            resetRequired: false,
+            changes: fullSnapshotChanges(snapshot),
+        };
+    }
+    if (sinceCursor === snapshot.cursor) {
+        return {
+            schemaVersion: DISCOVERY_SCHEMA_VERSION,
+            sinceCursor,
+            cursor: snapshot.cursor,
+            changedAt: snapshot.discoveredAt,
+            resetRequired: false,
+            changes: [],
+        };
+    }
+    const sinceIndex = state.deltaHistory.findIndex((delta) => delta.sinceCursor === sinceCursor || delta.cursor === sinceCursor);
+    if (sinceIndex === -1) {
+        return {
+            schemaVersion: DISCOVERY_SCHEMA_VERSION,
+            sinceCursor,
+            cursor: snapshot.cursor,
+            changedAt: snapshot.discoveredAt,
+            resetRequired: true,
+            changes: [],
+        };
+    }
+    const deltas = state.deltaHistory.slice(sinceIndex);
+    return {
+        schemaVersion: DISCOVERY_SCHEMA_VERSION,
+        sinceCursor,
+        cursor: snapshot.cursor,
+        changedAt: deltas.at(-1)?.changedAt ?? snapshot.discoveredAt,
+        resetRequired: false,
+        changes: deltas.flatMap((delta) => delta.changes),
+    };
+}
+/**
+ * Stream live deltas through the shared registry event bus.
+ */
+export async function* registryWatchDiscovery(state, options) {
+    const backlog = registryDiscoveryDelta(state, { sinceCursor: options?.sinceCursor ?? null });
+    if (backlog.resetRequired || backlog.changes.length > 0) {
+        // I replay backlog first so watch clients can bootstrap and then switch to live deltas.
+        yield backlog;
+    }
+    const queue = [];
+    let notify;
+    const listener = (delta) => {
+        queue.push(delta);
+        notify?.();
+        notify = undefined;
+    };
+    state.discoveryEventBus.on("delta", listener);
+    try {
+        while (true) {
+            if (queue.length === 0) {
+                await new Promise((resolve) => {
+                    notify = resolve;
+                });
+            }
+            const next = queue.shift();
+            if (next)
+                yield next;
+        }
+    }
+    finally {
+        state.discoveryEventBus.off("delta", listener);
+    }
+}
+/**
+ * Advance the discovery cursor and emit a delta when the snapshot changes.
+ */
+export function registryRecordDiscoveryMutation(state, previousSnapshot) {
+    state.discoveryRevision += 1;
+    state.currentCursor = registryMakeCursor(state);
+    const nextSnapshot = registryBuildSnapshot(state, state.currentCursor);
+    state.lastSnapshotCache = nextSnapshot;
+    if (!previousSnapshot) {
+        return;
+    }
+    const delta = diffSnapshots(previousSnapshot, nextSnapshot);
+    if (delta.changes.length === 0) {
+        return;
+    }
+    state.deltaHistory.push(delta);
+    if (state.deltaHistory.length > 50) {
+        state.deltaHistory.shift();
+    }
+    state.discoveryEventBus.emit("delta", delta);
+}
+/**
+ * Build a monotonic cursor for snapshot and delta consumers.
+ */
+export function registryMakeCursor(state) {
+    return `discovery-${state.discoveryRevision}-${state.discoveredAt || Date.now()}`;
+}
+/**
+ * Build the stable v1 discovery snapshot from in-memory state.
+ */
+export function registryBuildSnapshot(state, cursor) {
+    return {
+        schemaVersion: DISCOVERY_SCHEMA_VERSION,
+        discoveredAt: state.discoveredAt || null,
+        cursor,
+        providers: listProviderDescriptors()
+            .map((descriptor) => registrySerializeProvider(state, descriptor.providerId))
+            .sort((a, b) => a.providerId.localeCompare(b.providerId)),
+        models: registryModels(state)
+            .map((model) => registrySerializeModel(state, model))
+            .sort((a, b) => a.key.localeCompare(b.key)),
+        roles: discoveryRoles(),
+        health: listProviderDescriptors()
+            .map((descriptor) => registryBuildHealthRecord(state, descriptor.providerId))
+            .sort((a, b) => a.providerId.localeCompare(b.providerId)),
+        credentialPrompts: catalogCredentialPrompts(state).map((prompt) => ({
+            providerId: prompt.providerId,
+            providerName: prompt.providerName,
+            required: prompt.required,
+            envVars: [...prompt.envVars],
+            message: prompt.message,
+        })),
+    };
+}
+/**
+ * Serialize one provider entry into the stable v1 schema.
+ */
+export function registrySerializeProvider(state, providerId) {
+    const provider = state.providerMap.get(providerId);
+    const descriptor = registryProviderDescriptor(state, providerId, provider);
+    const config = getProviderConfig(state.config, providerId);
+    return {
+        providerId: descriptor.providerId,
+        canonicalProviderId: descriptor.canonicalProviderId,
+        aliases: [...descriptor.aliases],
+        name: descriptor.name,
+        origin: descriptor.origin,
+        isLocal: descriptor.isLocal,
+        transport: descriptor.transport,
+        authenticated: provider?.authenticated ?? false,
+        credentialSource: provider?.credentialSource ?? null,
+        credentialsPresent: provider?.authenticated ?? false,
+        credentialsRequired: descriptor.credentialRequired,
+        credentialEnvVars: [...descriptor.credentialEnvVars],
+        modelCount: provider?.models.length ?? 0,
+        lastRefreshed: provider?.lastRefreshed ?? null,
+        baseUrl: provider?.baseUrl ?? config?.baseUrl ?? descriptor.defaultBaseUrl,
+    };
+}
+/**
+ * Serialize one model route into the stable v1 schema.
+ */
+export function registrySerializeModel(state, model) {
+    const descriptor = registryProviderDescriptor(state, model.provider, state.providerMap.get(model.provider));
+    const runtime = model.localRuntime;
+    return {
+        key: makeModelKey(model, descriptor),
+        modelId: model.id,
+        name: model.name,
+        providerId: model.provider,
+        canonicalProviderId: descriptor.canonicalProviderId,
+        originProviderId: normalizeProviderId(model.originProvider) ?? model.originProvider ?? descriptor.canonicalProviderId,
+        mode: model.mode,
+        capabilities: trustedCapabilitiesForModel(model, descriptor),
+        rawCapabilities: rawCapabilitiesForModel(model),
+        contextWindow: model.contextWindow > 0 ? model.contextWindow : null,
+        maxOutputTokens: model.maxOutputTokens > 0 ? model.maxOutputTokens : null,
+        pricing: model.pricing ?? null,
+        dimensions: model.dimensions ?? null,
+        maxInputTokens: model.maxInputTokens ?? null,
+        discoveredAt: model.discoveredAt,
+        source: model.source,
+        aliases: [...model.aliases],
+        region: model.region ?? null,
+        projectId: model.projectId ?? null,
+        runtimeFamily: runtime?.runtimeFamily ?? (descriptor.isLocal ? descriptor.canonicalProviderId : null),
+        tokenizerFamily: runtime?.tokenizerFamily ?? null,
+        quantization: runtime?.quantization ?? null,
+        memoryFootprintBytes: runtime?.memoryFootprintBytes ?? null,
+        computeTarget: runtime?.computeTarget ?? null,
+        supportsStructuredOutput: runtime?.supportsStructuredOutput ?? null,
+        supportsStreaming: runtime?.supportsStreaming ?? null,
+    };
+}
+/**
+ * Build the normalized provider-health projection for the v1 schema.
+ */
+export function registryBuildHealthRecord(state, providerId) {
+    const breaker = state.healthTracker.breaker(providerId).health();
+    const observation = state.providerObservations.get(providerId);
+    const provider = state.providerMap.get(providerId);
+    const timeoutRate = observation && observation.attemptCount > 0
+        ? observation.timeoutCount / observation.attemptCount
+        : 0;
+    const latencyClass = computeLatencyClass(observation);
+    let stateLabel = "unknown";
+    // I keep auth and throttle failures distinct because they imply different downstream actions.
+    if (observation?.lastErrorType === "auth_error") {
+        stateLabel = "auth_error";
+    }
+    else if (observation?.lastErrorType === "throttled") {
+        stateLabel = "throttled";
+    }
+    else if (breaker.state === "open" && observation?.attemptCount) {
+        stateLabel = "down";
+    }
+    else if (provider?.lastRefreshed && (breaker.failureCount > 0 || timeoutRate >= 0.25 || latencyClass === "high")) {
+        stateLabel = "degraded";
+    }
+    else if (breaker.lastSuccessTime > 0 || provider?.lastRefreshed) {
+        stateLabel = "healthy";
+    }
+    return {
+        providerId,
+        state: stateLabel,
+        failureCount: breaker.failureCount,
+        lastError: breaker.lastError ?? null,
+        lastSuccessAt: breaker.lastSuccessTime || provider?.lastRefreshed || null,
+        lastFailureAt: breaker.lastFailureTime || null,
+        latencyClass,
+        timeoutRate: Number(timeoutRate.toFixed(3)),
+        rateLimitState: observation?.lastErrorType === "throttled" ? "throttled" : observation?.attemptCount ? "ok" : "unknown",
+        circuitState: breaker.state,
+    };
+}
+/**
+ * Store one provider observation for later health normalization.
+ */
+export function registryRecordObservation(state, providerId, entry) {
+    const observation = state.providerObservations.get(providerId) ?? {
+        latenciesMs: [],
+        timeoutCount: 0,
+        attemptCount: 0,
+        lastErrorType: null,
+    };
+    observation.attemptCount += 1;
+    observation.latenciesMs.push(entry.latencyMs);
+    if (observation.latenciesMs.length > 20) {
+        observation.latenciesMs.shift();
+    }
+    if (entry.errorType === "timeout") {
+        observation.timeoutCount += 1;
+    }
+    observation.lastErrorType = entry.errorType;
+    state.providerObservations.set(providerId, observation);
+}
+/**
+ * Normalize a provider error message into a stable health class.
+ */
+export function registryClassifyError(errorMessage) {
+    const lower = errorMessage.toLowerCase();
+    if (lower.includes("401") || lower.includes("403") || lower.includes("unauthorized") || lower.includes("forbidden")) {
+        return "auth_error";
+    }
+    if (lower.includes("429") || lower.includes("rate limit") || lower.includes("quota")) {
+        return "throttled";
+    }
+    if (lower.includes("timed out") || lower.includes("timeout") || lower.includes("abort")) {
+        return "timeout";
+    }
+    if (lower.includes("network") || lower.includes("econn") || lower.includes("fetch failed") || lower.includes("5")) {
+        return "transport";
+    }
+    return "unknown";
+}
+function catalogCredentialPrompts(state) {
+    const prompts = [];
+    for (const descriptor of listProviderDescriptors()) {
+        const provider = state.providerMap.get(descriptor.providerId);
+        if (!descriptor.credentialRequired || provider?.authenticated) {
+            continue;
+        }
+        const envHint = descriptor.credentialEnvVars.length > 0
+            ? `Set ${descriptor.credentialEnvVars.join(" or ")}`
+            : "Configure credentials";
+        prompts.push({
+            providerId: descriptor.providerId,
+            providerName: descriptor.name,
+            required: true,
+            envVars: descriptor.credentialEnvVars,
+            message: `${envHint} to enable ${descriptor.name} model discovery.`,
+        });
+    }
+    return prompts.sort((a, b) => a.providerId.localeCompare(b.providerId));
+}
+function computeLatencyClass(observation) {
+    if (!observation || observation.attemptCount === 0 || observation.latenciesMs.length === 0) {
+        return "unknown";
+    }
+    if (observation.lastErrorType === "timeout") {
+        return "timeout";
+    }
+    const average = observation.latenciesMs.reduce((sum, value) => sum + value, 0) / observation.latenciesMs.length;
+    if (average <= 1_000)
+        return "low";
+    if (average <= 4_000)
+        return "medium";
+    return "high";
+}
+//# sourceMappingURL=registry-discovery.js.map

package/dist/registry-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-discovery.js","sourceRoot":"","sources":["../src/registry-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAIjF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoB;IAC5D,IAAI,KAAK,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC,iBAAiB,CAAC;IAC5D,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,OAAO,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAoB;IAC7D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACnE,KAAK,CAAC,iBAAiB,GAAG,QAAQ,CAAC;IACnC,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,KAAoB,EACpB,OAAyC;IAEzC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IAEjD,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO;YACN,aAAa,EAAE,wBAAwB;YACvC,WAAW;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,QAAQ,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK;YACpB,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC;SACtC,CAAC;IACH,CAAC;IAED,IAAI,WAAW,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO;YACN,aAAa,EAAE,wBAAwB;YACvC,WAAW;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,QAAQ,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK;YACpB,OAAO,EAAE,EAAE;SACX,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CACzD,KAAK,CAAC,WAAW,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,CACjE,CAAC;IACF,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO;YACN,aAAa,EAAE,wBAAwB;YACvC,WAAW;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,QAAQ,CAAC,YAAY;YAChC,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE,EAAE;SACX,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpD,OAAO;QACN,aAAa,EAAE,wBAAwB;QACvC,WAAW;QACX,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,QAAQ,CAAC,YAAY;QAC5D,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;KACjD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAC5C,KAAoB,EACpB,OAAyC;IAEzC,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,wFAAwF;QACxF,MAAM,OAAO,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,IAAI,MAAgC,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,KAAuB,EAAE,EAAE;QAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,EAAE,EAAE,CAAC;QACX,MAAM,GAAG,SAAS,CAAC;IACpB,CAAC,CAAC;IAEF,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC;QACJ,OAAO,IAAI,EAAE,CAAC;YACb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBACnC,MAAM,GAAG,OAAO,CAAC;gBAClB,CAAC,CAAC,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,IAAI;gBAAE,MAAM,IAAI,CAAC;QACtB,CAAC;IACF,CAAC;YAAS,CAAC;QACV,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC9C,KAAoB,EACpB,gBAA4C;IAE5C,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC;IAC7B,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvE,KAAK,CAAC,iBAAiB,GAAG,YAAY,CAAC;IAEvC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,OAAO;IACR,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;IACR,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACtD,OAAO,aAAa,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAoB,EAAE,MAAc;IACzE,OAAO;QACN,aAAa,EAAE,wBAAwB;QACvC,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACxC,MAAM;QACN,SAAS,EAAE,uBAAuB,EAAE;aAClC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;aAC5E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC;aAC3B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;aACpD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5C,KAAK,EAAE,cAAc,EAAE;QACvB,MAAM,EAAE,uBAAuB,EAAE;aAC/B,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;aAC5E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1D,iBAAiB,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACnE,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC,CAAC;KACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAoB,EAAE,UAAkB;IACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE3D,OAAO;QACN,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,mBAAmB,EAAE,UAAU,CAAC,mBAAmB;QACnD,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,KAAK;QAC/C,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,IAAI,IAAI;QACpD,kBAAkB,EAAE,QAAQ,EAAE,aAAa,IAAI,KAAK;QACpD,mBAAmB,EAAE,UAAU,CAAC,kBAAkB;QAClD,iBAAiB,EAAE,CAAC,GAAG,UAAU,CAAC,iBAAiB,CAAC;QACpD,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;QACxC,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,IAAI;QAC9C,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,UAAU,CAAC,cAAc;KAC1E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAoB,EAAE,KAAgB;IAC5E,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5G,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC;IAEnC,OAAO;QACN,GAAG,EAAE,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC;QACpC,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,QAAQ;QAC1B,mBAAmB,EAAE,UAAU,CAAC,mBAAmB;QACnD,gBAAgB,EAAE,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,UAAU,CAAC,mBAAmB;QACrH,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,2BAA2B,CAAC,KAAK,EAAE,UAAU,CAAC;QAC5D,eAAe,EAAE,uBAAuB,CAAC,KAAK,CAAC;QAC/C,aAAa,EAAE,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;QACnE,eAAe,EAAE,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;QACzE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACpC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;QAC5C,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;QACrG,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,IAAI;QACjD,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI;QAC3C,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,IAAI,IAAI;QAC3D,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,IAAI;QAC7C,wBAAwB,EAAE,OAAO,EAAE,wBAAwB,IAAI,IAAI;QACnE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,IAAI;KACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAoB,EAAE,UAAkB;IACjF,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;IACjE,MAAM,WAAW,GAAG,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,WAAW,IAAI,WAAW,CAAC,YAAY,GAAG,CAAC;QAC9D,CAAC,CAAC,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC,YAAY;QACrD,CAAC,CAAC,CAAC,CAAC;IACL,MAAM,YAAY,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,UAAU,GAAmC,SAAS,CAAC;IAE3D,8FAA8F;IAC9F,IAAI,WAAW,EAAE,aAAa,KAAK,YAAY,EAAE,CAAC;QACjD,UAAU,GAAG,YAAY,CAAC;IAC3B,CAAC;SAAM,IAAI,WAAW,EAAE,aAAa,KAAK,WAAW,EAAE,CAAC;QACvD,UAAU,GAAG,WAAW,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,IAAI,WAAW,EAAE,YAAY,EAAE,CAAC;QAClE,UAAU,GAAG,MAAM,CAAC;IACrB,CAAC;SAAM,IAAI,QAAQ,EAAE,aAAa,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,CAAC,IAAI,WAAW,IAAI,IAAI,IAAI,YAAY,KAAK,MAAM,CAAC,EAAE,CAAC;QACpH,UAAU,GAAG,UAAU,CAAC;IACzB,CAAC;SAAM,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC,IAAI,QAAQ,EAAE,aAAa,EAAE,CAAC;QACnE,UAAU,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,OAAO;QACN,UAAU;QACV,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,aAAa,EAAE,OAAO,CAAC,eAAe,IAAI,QAAQ,EAAE,aAAa,IAAI,IAAI;QACzE,aAAa,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAC9C,YAAY;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3C,cAAc,EAAE,WAAW,EAAE,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvH,YAAY,EAAE,OAAO,CAAC,KAAK;KAC3B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACxC,KAAoB,EACpB,UAAkB,EAClB,KAA6E;IAE7E,MAAM,WAAW,GAAG,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI;QACjE,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,IAAI;KACnB,CAAC;IAEF,WAAW,CAAC,YAAY,IAAI,CAAC,CAAC;IAC9B,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACzC,WAAW,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,WAAW,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,WAAW,CAAC,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC;IAC5C,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACzD,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACrH,OAAO,YAAY,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtF,OAAO,WAAW,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnH,OAAO,WAAW,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAoB;IACrD,MAAM,OAAO,GAA+B,EAAE,CAAC;IAE/C,KAAK,MAAM,UAAU,IAAI,uBAAuB,EAAE,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,kBAAkB,IAAI,QAAQ,EAAE,aAAa,EAAE,CAAC;YAC/D,SAAS;QACV,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;YACtD,CAAC,CAAC,OAAO,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YACpD,CAAC,CAAC,uBAAuB,CAAC;QAE3B,OAAO,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,YAAY,EAAE,UAAU,CAAC,IAAI;YAC7B,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,UAAU,CAAC,iBAAiB;YACrC,OAAO,EAAE,GAAG,OAAO,cAAc,UAAU,CAAC,IAAI,mBAAmB;SACnE,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,mBAAmB,CAC3B,WAA4C;IAE5C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,YAAY,KAAK,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5F,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC;IAChH,IAAI,OAAO,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,OAAO,IAAI,KAAK;QAAE,OAAO,QAAQ,CAAC;IACtC,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/registry-query.d.ts

@@ -0,0 +1,74 @@
+/**
+ * kosha-discovery — Core query helpers for ModelRegistry.
+ *
+ * I keep model lookup, role filtering, capability aggregation, and cheapest
+ * route selection here so the registry façade can stay under the file-size
+ * policy while preserving the public API.
+ * @module
+ */
+import type { CapabilitySummary, CheapestModelOptions, CheapestModelResult, ModelCard, ModelMode, ModelRouteInfo, PricingMetric, ProviderCredentialPrompt, ProviderInfo, ProviderRoleInfo, RoleQueryOptions } from "./types.js";
+import type { RegistryState } from "./registry-state.js";
+/**
+ * Return a stable provider descriptor, even for synthetic test providers.
+ */
+export declare function registryProviderDescriptor(state: RegistryState, providerId: string, providerInfo?: ProviderInfo): import("./provider-catalog.js").ProviderDescriptor;
+/**
+ * Normalize a role or capability token for routing and filtering.
+ */
+export declare function normalizeRoleToken(value: string): string;
+/**
+ * Return the deduplicated role list for a single model.
+ */
+export declare function modelRoles(model: ModelCard): string[];
+/**
+ * Check whether a model satisfies a role or capability query.
+ */
+export declare function modelSupportsRole(model: ModelCard, roleOrCapability: string): boolean;
+/**
+ * List models with provider-aware deduplication and optional filters.
+ */
+export declare function registryModels(state: RegistryState, filter?: {
+    provider?: string;
+    originProvider?: string;
+    mode?: ModelMode;
+    capability?: string;
+}): ModelCard[];
+/**
+ * Build the provider -> model -> roles matrix used by the legacy API.
+ */
+export declare function registryProviderRoles(state: RegistryState, filter?: RoleQueryOptions): ProviderRoleInfo[];
+/**
+ * Return prompts for currently discovered providers missing required credentials.
+ */
+export declare function registryMissingCredentialPrompts(state: RegistryState, providerIds?: string[]): ProviderCredentialPrompt[];
+/**
+ * Rank the cheapest models for a normalized role/mode query.
+ */
+export declare function registryCheapestModels(state: RegistryState, options?: CheapestModelOptions): CheapestModelResult;
+/**
+ * Find every provider route for a normalized model identifier.
+ */
+export declare function registryModelRoutes(state: RegistryState, modelId: string): ModelCard[];
+/**
+ * Enrich raw routes with preferred/direct metadata for legacy consumers.
+ */
+export declare function registryModelRouteInfo(state: RegistryState, modelId: string): ModelRouteInfo[];
+/**
+ * Aggregate capability statistics across all discovered models.
+ */
+export declare function registryCapabilities(state: RegistryState, filter?: {
+    provider?: string;
+}): CapabilitySummary[];
+/**
+ * Pick the default pricing metric for a cheapest-model query.
+ */
+export declare function defaultPricingMetric(options?: CheapestModelOptions): PricingMetric;
+/**
+ * Compute a comparable score for a model/pricing metric combination.
+ */
+export declare function computeModelScore(model: ModelCard, metric: PricingMetric, inputWeight: number, outputWeight: number): number | undefined;
+/**
+ * Normalize a user-supplied result limit into a safe positive integer.
+ */
+export declare function normalizeLimit(limit: number | undefined): number;
+//# sourceMappingURL=registry-query.d.ts.map

package/dist/registry-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-query.d.ts","sourceRoot":"","sources":["../src/registry-query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,iBAAiB,EAEjB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoCzD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,sDAa/G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAOrF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F,SAAS,EAAE,CAuBb;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAoCzG;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,wBAAwB,EAAE,CAwBzH;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAgChH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAItF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAyB9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,EAAE,CAqB9G;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAKlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxI;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGhE"}