@dbx-tools/model 0.9.21 → 0.9.29

package/lib/src/resolve.js

@@ -1,215 +1,30 @@
-/**
- * Workspace-aware model selection.
- *
- * Given a caller's intent - a search string, a capability {@link ModelClass}
- * ceiling, both, or nothing - the toolkit returns matching endpoints ranked by
- * match quality then class, or collapses to the single best id the workspace
- * actually has, degrading from "best in range" down to the static fallback
- * floor. Selection is chat-only: embedding endpoints surface only when
- * `modelClass` is explicitly {@link ModelClass.Embedding}.
- *
- * Two shapes of selection, each in a pure form (over an endpoint list the
- * caller already holds) and an I/O wrapper (that lists `/serving-endpoints`
- * first): ranking, which returns a match- then class-ordered list, and
- * single-selection, which collapses to one id plus how it was reached and
- * layers the operator-pinned fallback / static-floor safety net on top. A chat
- * `modelClass` acts as a ceiling: that band and the less-capable chat bands
- * below it are eligible (see {@link classesAtOrBelow}), so a `chat-balanced`
- * ask can fall to `chat-fast` but never escalate to `chat-thinking`.
- *
- * @module
- */
-import { object } from "@dbx-tools/shared-core";
-import { rankEndpoints } from "./_native.js";
-import { FALLBACK_MODEL_IDS, modelsForClass } from "./fallback.js";
+import { lookupModels, rankModelId, resolveModel, } from "./_selection.js";
 import { listServingEndpoints, } from "./model-catalog.js";
-import { endpointSupportsTools } from "./policy.js";
-/** Preferred live family for an unconfigured general-purpose chat default. */
-const DEFAULT_MODEL_FAMILY_SEARCH = "gpt";
-/**
- * Rank the live catalogue against a {@link ModelQuery}, best-first.
- *
- * Rust owns classification, fuzzy scoring, family-version ordering, preferred
- * variants, class ceilings, tool filtering, and result limiting. Node retains
- * the caller's endpoint objects so fields outside the ranking contract remain
- * available unchanged.
- */
-export function lookupModels(endpoints, query = {}) {
-    return rankEndpoints(endpoints, query);
-}
-/**
- * Collapse {@link lookupModels} to a single id: the closest endpoint to `search`
- * in a catalogue snapshot, or the input verbatim when nothing scores within the
- * threshold.
- *
- * The ranked counterpart to {@link resolveModelId}: equal
- * match scores are broken by class and then within-class version, so a loose
- * `"opus"` prefers `opus-5` over `opus-4-7` instead of picking whichever
- * sibling appeared first. Returning the input unmatched (rather
- * than a near neighbour) is deliberate - a deliberate endpoint id is never
- * silently rewritten, and Databricks surfaces a clean 404.
- */
-export function rankModelId(endpoints, search, options = {}) {
-    const [top] = lookupModels(endpoints, {
-        search,
-        limit: 1,
-        ...(options.threshold !== undefined ? { threshold: options.threshold } : {}),
-        ...(options.requiresTools !== undefined ? { requiresTools: options.requiresTools } : {}),
-    });
-    if (!top)
-        return { modelId: search, matched: false };
-    return { modelId: top.endpoint.name, matched: true, score: top.score };
-}
-/**
- * {@link rankModelId} against a catalogue the caller may be holding stale:
- * match the loaded snapshot, and on a miss reload once with `force` and match
- * again. That way a model deployed after the catalogue was cached still
- * resolves on first use, without a restart and without giving up caching.
- *
- * The catalogue arrives as a loader rather than a client so the caller keeps
- * ownership of *how* it is cached - {@link listServingEndpoints} and its
- * `CacheManager`, a plain process-lifetime field in a CLI, or a test double.
- * Only one reload is attempted: a genuinely unknown name should fail fast
- * rather than re-list on every request.
- *
- * @param load - Returns the catalogue; `force` asks it to bypass its cache.
- */
+export { lookupModels, rankModelId, resolveModel } from "./_selection.js";
+/** Resolve against a potentially stale catalogue, refreshing once on a miss. */
 export async function rankModelIdLive(load, search, options = {}) {
     const resolved = rankModelId(await load(false), search, options);
     if (resolved.matched)
         return resolved;
     return rankModelId(await load(true), search, options);
 }
-/**
- * Rank a workspace's catalogue in one call: list its `/serving-endpoints`
- * (cached) and run {@link lookupModels} over the result. The list counterpart to
- * {@link selectModel}, for a consumer that wants the full ranked set (a model
- * picker, a CLI) rather than a single id. Catalogue fetches fail loud: network
- * / auth errors propagate so the caller sees the real SDK message.
- *
- * @param host - Workspace host used as the cache key. Pass the value resolved
- *   from `client.config.getHost()`.
- */
+/** List and rank a workspace model catalogue. */
 export async function searchModels(client, host, input = {}) {
-    const endpoints = await listServingEndpoints(client, host, {
-        ...(input.ttlMs !== undefined ? { ttlMs: input.ttlMs } : {}),
-        ...(input.cacheIdentity !== undefined ? { cacheIdentity: input.cacheIdentity } : {}),
-    });
+    const endpoints = await listServingEndpoints(client, host, catalogueOptions(input));
     return lookupModels(endpoints, input);
 }
-/**
- * Resolve a model id for a workspace in one call: list its `/serving-endpoints`
- * (cached) and run {@link resolveModel} over the result. This is the entry
- * point for any consumer that holds a `WorkspaceClient` and just wants a usable
- * model name - a Lakeflow job, a one-off script, or the Mastra plugin alike.
- *
- * Cheap exit: when an `explicit` name is given, `fuzzy` is off, and tool
- * capability is not required, the catalogue is never fetched. Catalogue
- * fetches otherwise fail loud: network / auth errors propagate so the caller
- * sees the real SDK message instead of a silent fallback.
- *
- * @param host - Workspace host used as the cache key. Pass the value resolved
- *   from `client.config.getHost()`.
- */
+/** List a workspace catalogue and resolve one model. */
 export async function selectModel(client, host, input = {}) {
     if (input.explicit !== undefined && input.fuzzy === false && !input.requiresTools) {
         return { modelId: input.explicit, source: "explicit" };
     }
-    const endpoints = await listServingEndpoints(client, host, {
-        ...(input.ttlMs !== undefined ? { ttlMs: input.ttlMs } : {}),
-        ...(input.cacheIdentity !== undefined ? { cacheIdentity: input.cacheIdentity } : {}),
-    });
+    const endpoints = await listServingEndpoints(client, host, catalogueOptions(input));
     return resolveModel(endpoints, input);
 }
-/**
- * Resolve a single model id from the live catalogue and caller intent,
- * delegating the live selection to {@link lookupModels} with `limit: 1`.
- *
- * 1. **Explicit ask**: with `fuzzy` off, returned verbatim; otherwise
- *    fuzzy-ranked within the (optional) class ceiling and the best taken,
- *    falling back to the input verbatim when nothing matches.
- * 2. **No explicit ask**: an operator-pinned `fallback` that exists in the live
- *    catalogue wins first. A class request ranks within that ceiling. A
- *    general request prefers the highest-ranked live GPT, then any ranked live
- *    chat model. The static {@link FALLBACK_MODEL_IDS} floor is used only when
- *    the catalogue yields nothing in range.
- */
-export function resolveModel(endpoints, input = {}) {
-    if (input.explicit !== undefined) {
-        if (input.fuzzy === false) {
-            if (input.requiresTools)
-                assertToolSupport(endpoints, input.explicit);
-            return { modelId: input.explicit, source: "explicit" };
-        }
-        const [top] = lookupModels(endpoints, buildQuery(input, input.explicit));
-        if (input.requiresTools && !top) {
-            throw new Error(`No tool-capable model matches "${input.explicit}"`);
-        }
-        return { modelId: top?.endpoint.name ?? input.explicit, source: "fuzzy-match" };
-    }
-    // Operator-pinned fallbacks win when present and live (e.g. a regulated
-    // workspace restricted to an approved subset).
-    if (input.modelClass === undefined && input.fallbacks && input.fallbacks.length > 0) {
-        const present = new Set(endpoints
-            .filter((endpoint) => !input.requiresTools || endpointSupportsTools(endpoint))
-            .map((endpoint) => endpoint.name));
-        const pinned = input.fallbacks.find((id) => present.has(id));
-        if (pinned)
-            return { modelId: pinned, source: "fallback" };
-    }
-    const source = input.modelClass !== undefined ? "class" : "fallback";
-    if (input.modelClass === undefined) {
-        const [preferred] = lookupModels(endpoints, buildQuery(input, DEFAULT_MODEL_FAMILY_SEARCH));
-        if (preferred)
-            return { modelId: preferred.endpoint.name, source };
-    }
-    const [top] = lookupModels(endpoints, buildQuery(input, undefined));
-    if (top)
-        return { modelId: top.endpoint.name, source };
-    if (input.liveOnly) {
-        throw new Error("No matching live Model Serving endpoint is available");
-    }
-    // Live catalogue yielded nothing in range: walk the static floor.
-    const floorSource = input.modelClass !== undefined ? modelsForClass(input.modelClass) : (input.fallbacks ?? []);
-    const floor = object.sequence(floorSource).concat(FALLBACK_MODEL_IDS).distinct().toArray();
-    if (input.requiresTools) {
-        const available = new Set(endpoints.filter(endpointSupportsTools).map((endpoint) => endpoint.name));
-        const selected = floor.find((id) => available.has(id));
-        if (!selected)
-            throw new Error("No tool-capable model is available");
-        return { modelId: selected, source };
-    }
-    return { modelId: pickFirstAvailable(floor, endpoints), source };
-}
-/** Build a {@link ModelQuery} from {@link ResolveModelInput} for the `limit: 1` delegation. */
-function buildQuery(input, search) {
+function catalogueOptions(input) {
     return {
-        ...(search !== undefined ? { search } : {}),
-        ...(input.modelClass !== undefined ? { modelClass: input.modelClass } : {}),
-        ...(input.requiresTools !== undefined ? { requiresTools: input.requiresTools } : {}),
-        ...(input.threshold !== undefined ? { threshold: input.threshold } : {}),
-        limit: 1,
+        ...(input.ttlMs !== undefined ? { ttlMs: input.ttlMs } : {}),
+        ...(input.cacheIdentity !== undefined ? { cacheIdentity: input.cacheIdentity } : {}),
     };
 }
-/** Throw when an explicit id is absent or not verified for function tools. */
-function assertToolSupport(endpoints, modelId) {
-    const endpoint = endpoints.find((candidate) => candidate.name === modelId);
-    if (!endpoint || !endpointSupportsTools(endpoint)) {
-        throw new Error(`Model "${modelId}" does not support function tools`);
-    }
-}
-/**
- * Find the first id in `candidates` whose endpoint is present in `endpoints`.
- * Returns the top candidate when the workspace has none of them so callers
- * always get a string; an offline workspace then receives a clean 404 from
- * Databricks instead of a malformed config.
- */
-function pickFirstAvailable(candidates, endpoints) {
-    const present = new Set(endpoints.map((e) => e.name));
-    for (const candidate of candidates) {
-        if (present.has(candidate))
-            return candidate;
-    }
-    return candidates[0] ?? FALLBACK_MODEL_IDS[0];
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb2x2ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9yZXNvbHZlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW9CRztBQUVILE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQVFoRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQzdDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxjQUFjLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkUsT0FBTyxFQUNMLG9CQUFvQixHQUlyQixNQUFNLG9CQUFvQixDQUFDO0FBQzVCLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUlwRCw4RUFBOEU7QUFDOUUsTUFBTSwyQkFBMkIsR0FBRyxLQUFLLENBQUM7QUErRDFDOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsWUFBWSxDQUMxQixTQUE0QyxFQUM1QyxRQUFvQixFQUFFO0lBRXRCLE9BQU8sYUFBYSxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQztBQUN6QyxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLFVBQVUsV0FBVyxDQUN6QixTQUE0QyxFQUM1QyxNQUFjLEVBQ2QsVUFBK0IsRUFBRTtJQUVqQyxNQUFNLENBQUMsR0FBRyxDQUFDLEdBQUcsWUFBWSxDQUFDLFNBQVMsRUFBRTtRQUNwQyxNQUFNO1FBQ04sS0FBSyxFQUFFLENBQUM7UUFDUixHQUFHLENBQUMsT0FBTyxDQUFDLFNBQVMsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsU0FBUyxFQUFFLE9BQU8sQ0FBQyxTQUFTLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQzVFLEdBQUcsQ0FBQyxPQUFPLENBQUMsYUFBYSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxhQUFhLEVBQUUsT0FBTyxDQUFDLGFBQWEsRUFBRSxD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cGFjZS1hd2FyZSBtb2RlbCBzZWxlY3Rpb24uXG4gKlxuICogR2l2ZW4gYSBjYWxsZXIncyBpbnRlbnQgLSBhIHNlYXJjaCBzdHJpbmcsIGEgY2FwYWJpbGl0eSB7QGxpbmsgTW9kZWxDbGFzc31cbiAqIGNlaWxpbmcsIGJvdGgsIG9yIG5vdGhpbmcgLSB0aGUgdG9vbGtpdCByZXR1cm5zIG1hdGNoaW5nIGVuZHBvaW50cyByYW5rZWQgYnlcbiAqIG1hdGNoIHF1YWxpdHkgdGhlbiBjbGFzcywgb3IgY29sbGFwc2VzIHRvIHRoZSBzaW5nbGUgYmVzdCBpZCB0aGUgd29ya3NwYWNlXG4gKiBhY3R1YWxseSBoYXMsIGRlZ3JhZGluZyBmcm9tIFwiYmVzdCBpbiByYW5nZVwiIGRvd24gdG8gdGhlIHN0YXRpYyBmYWxsYmFja1xuICogZmxvb3IuIFNlbGVjdGlvbiBpcyBjaGF0LW9ubHk6IGVtYmVkZGluZyBlbmRwb2ludHMgc3VyZmFjZSBvbmx5IHdoZW5cbiAqIGBtb2RlbENsYXNzYCBpcyBleHBsaWNpdGx5IHtAbGluayBNb2RlbENsYXNzLkVtYmVkZGluZ30uXG4gKlxuICogVHdvIHNoYXBlcyBvZiBzZWxlY3Rpb24sIGVhY2ggaW4gYSBwdXJlIGZvcm0gKG92ZXIgYW4gZW5kcG9pbnQgbGlzdCB0aGVcbiAqIGNhbGxlciBhbHJlYWR5IGhvbGRzKSBhbmQgYW4gSS9PIHdyYXBwZXIgKHRoYXQgbGlzdHMgYC9zZXJ2aW5nLWVuZHBvaW50c2BcbiAqIGZpcnN0KTogcmFua2luZywgd2hpY2ggcmV0dXJucyBhIG1hdGNoLSB0aGVuIGNsYXNzLW9yZGVyZWQgbGlzdCwgYW5kXG4gKiBzaW5nbGUtc2VsZWN0aW9uLCB3aGljaCBjb2xsYXBzZXMgdG8gb25lIGlkIHBsdXMgaG93IGl0IHdhcyByZWFjaGVkIGFuZFxuICogbGF5ZXJzIHRoZSBvcGVyYXRvci1waW5uZWQgZmFsbGJhY2sgLyBzdGF0aWMtZmxvb3Igc2FmZXR5IG5ldCBvbiB0b3AuIEEgY2hhdFxuICogYG1vZGVsQ2xhc3NgIGFjdHMgYXMgYSBjZWlsaW5nOiB0aGF0IGJhbmQgYW5kIHRoZSBsZXNzLWNhcGFibGUgY2hhdCBiYW5kc1xuICogYmVsb3cgaXQgYXJlIGVsaWdpYmxlIChzZWUge0BsaW5rIGNsYXNzZXNBdE9yQmVsb3d9KSwgc28gYSBgY2hhdC1iYWxhbmNlZGBcbiAqIGFzayBjYW4gZmFsbCB0byBgY2hhdC1mYXN0YCBidXQgbmV2ZXIgZXNjYWxhdGUgdG8gYGNoYXQtdGhpbmtpbmdgLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuXG5pbXBvcnQgeyBvYmplY3QgfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtY29yZVwiO1xuaW1wb3J0IHtcbiAgbW9kZWwsXG4gIHR5cGUgTW9kZWxRdWVyeSxcbiAgdHlwZSBSYW5rZWRNb2RlbCxcbiAgdHlwZSBTZXJ2aW5nRW5kcG9pbnRTdW1tYXJ5LFxufSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtbW9kZWxcIjtcblxuaW1wb3J0IHsgcmFua0VuZHBvaW50cyB9IGZyb20gXCIuL19uYXRpdmUudHNcIjtcbmltcG9ydCB7IEZBTExCQUNLX01PREVMX0lEUywgbW9kZWxzRm9yQ2xhc3MgfSBmcm9tIFwiLi9mYWxsYmFjay50c1wiO1xuaW1wb3J0IHtcbiAgbGlzdFNlcnZpbmdFbmRwb2ludHMsXG4gIHR5cGUgUmVzb2x2ZWRNb2RlbCxcbiAgdHlwZSBSZXNvbHZlTW9kZWxPcHRpb25zLFxuICB0eXBlIFdvcmtzcGFjZUNsaWVudExpa2UsXG59IGZyb20gXCIuL21vZGVsLWNhdGFsb2cudHNcIjtcbmltcG9ydCB7IGVuZHBvaW50U3VwcG9ydHNUb29scyB9IGZyb20gXCIuL3BvbGljeS50c1wiO1xuXG50eXBlIE1vZGVsQ2xhc3MgPSBtb2RlbC5Nb2RlbENsYXNzO1xuXG4vKiogUHJlZmVycmVkIGxpdmUgZmFtaWx5IGZvciBhbiB1bmNvbmZpZ3VyZWQgZ2VuZXJhbC1wdXJwb3NlIGNoYXQgZGVmYXVsdC4gKi9cbmNvbnN0IERFRkFVTFRfTU9ERUxfRkFNSUxZX1NFQVJDSCA9IFwiZ3B0XCI7XG5cbi8qKiBDYWxsZXIgaW50ZW50IHBhc3NlZCB0byB7QGxpbmsgcmVzb2x2ZU1vZGVsfS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzb2x2ZU1vZGVsSW5wdXQge1xuICAvKipcbiAgICogRXhwbGljaXQgbW9kZWwgaWQgLyBsb29zZSBuYW1lIChwZXItcmVxdWVzdCBvdmVycmlkZSwgYWdlbnQgLyBwbHVnaW5cbiAgICogZGVmYXVsdCwgb3IgZW52IHZhcikuIFdoZW4gc2V0IGl0IHdpbnMgb3ZlciBgbW9kZWxDbGFzc2AgYW5kIGBmYWxsYmFja3NgLlxuICAgKi9cbiAgZXhwbGljaXQ/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiBGdXp6eS1tYXRjaCBhbiBgZXhwbGljaXRgIG5hbWUgYWdhaW5zdCB0aGUgbGl2ZSBjYXRhbG9ndWUgc28gbG9vc2UgbmFtZXNcbiAgICogbGlrZSBgXCJjbGF1ZGUgc29ubmV0XCJgIHJlc29sdmUuIERlZmF1bHQgYHRydWVgLiBXaGVuIGBmYWxzZWAgdGhlIGV4cGxpY2l0XG4gICAqIGlucHV0IGlzIHJldHVybmVkIHZlcmJhdGltIChEYXRhYnJpY2tzIHN1cmZhY2VzIHRoZSBjYW5vbmljYWwgNDA0IGlmIGl0XG4gICAqIGRvZXNuJ3QgZXhpc3QpLlxuICAgKi9cbiAgZnV6enk/OiBib29sZWFuO1xuICAvKiogUnVzdCBmdXp6eS1kaXN0YW5jZSB0aHJlc2hvbGQgZm9yd2FyZGVkIHRvIHRoZSBzZWFyY2ggbWF0Y2guICovXG4gIHRocmVzaG9sZD86IG51bWJlcjtcbiAgLyoqIFJlcXVpcmUgYSBtb2RlbCB0aGF0IHN1cHBvcnRzIGEgY29tcGxldGUgZnVuY3Rpb24tdG9vbCByb3VuZC10cmlwLiAqL1xuICByZXF1aXJlc1Rvb2xzPzogYm9vbGVhbjtcbiAgLyoqXG4gICAqIENoYXQgY2FwYWJpbGl0eSBjbGFzcyB0byByZXNvbHZlIHdoZW4gbm8gYGV4cGxpY2l0YCBpZCBpcyBnaXZlbi4gVGhlIGxpdmVcbiAgICogY2F0YWxvZ3VlIGlzIGNsYXNzaWZpZWQgYnkgaXRzIEZvdW5kYXRpb24gTW9kZWwgQVBJIHNjb3JlcyBhbmQgdGhlIHRvcFxuICAgKiBhdmFpbGFibGUgbW9kZWwgaW4gdGhlIGNsYXNzIChhbmQgdGhlIGNoYXQgYmFuZHMgYmVsb3cgaXQpIHdpbnMsIGZhbGxpbmdcbiAgICogYmFjayB0byB0aGUgY2xhc3MncyBzbWFsbCBzdGF0aWMgbGlzdC5cbiAgICovXG4gIG1vZGVsQ2xhc3M/OiBNb2RlbENsYXNzO1xuICAvKipcbiAgICogT3BlcmF0b3Itc3VwcGxpZWQgZmFsbGJhY2sgaWRzIHRyaWVkICpmaXJzdCogaW4gdGhlIG5vLWV4cGxpY2l0LCBuby1jbGFzc1xuICAgKiBwYXRoIChlLmcuIGEgcmVndWxhdGVkIHdvcmtzcGFjZSBwaW5uZWQgdG8gYW4gYXBwcm92ZWQgc3Vic2V0KSwgYWhlYWQgb2ZcbiAgICogdGhlIGF1dG8tY2xhc3NpZmllZCBjYXRhbG9ndWUuXG4gICAqL1xuICBmYWxsYmFja3M/OiByZWFkb25seSBzdHJpbmdbXTtcbiAgLyoqXG4gICAqIFJlZnVzZSB0aGUgc3RhdGljIG9mZmxpbmUgZmxvb3Igd2hlbiB0aGUgbGl2ZSBjYXRhbG9ndWUgaGFzIG5vIG1hdGNoLlxuICAgKiBVc2UgZm9yIHVucGlubmVkIGRlZmF1bHRzIHRoYXQgbXVzdCBhbHdheXMgbmFtZSBhIGN1cnJlbnRseSBhdmFpbGFibGVcbiAgICogZW5kcG9pbnQuXG4gICAqL1xuICBsaXZlT25seT86IGJvb2xlYW47XG59XG5cbi8qKiBPdXRjb21lIG9mIHtAbGluayByZXNvbHZlTW9kZWx9OiB0aGUgY2hvc2VuIGlkIHBsdXMgaG93IGl0IHdhcyByZWFjaGVkLiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXNvbHZlZE1vZGVsU2VsZWN0aW9uIHtcbiAgbW9kZWxJZDogc3RyaW5nO1xuICBzb3VyY2U6IFwiZXhwbGljaXRcIiB8IFwiZnV6enktbWF0Y2hcIiB8IFwiY2xhc3NcIiB8IFwiZmFsbGJhY2tcIjtcbn1cblxuLyoqIEludGVudCArIGNhdGFsb2d1ZSBrbm9icyBwYXNzZWQgdG8ge0BsaW5rIHNlbGVjdE1vZGVsfS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2VsZWN0TW9kZWxJbnB1dCBleHRlbmRzIFJlc29sdmVNb2RlbElucHV0IHtcbiAgLyoqIFRUTCBvdmVycmlkZSBmb3IgdGhlIGNhY2hlZCBgL3NlcnZpbmctZW5kcG9pbnRzYCBsaXN0aW5nLCBpbiBtcy4gKi9cbiAgdHRsTXM/OiBudW1iZXI7XG4gIC8qKiBUcnVzdGVkIG9wYXF1ZSBpZGVudGl0eSBvZiB0aGUgY3JlZGVudGlhbCB1c2VkIGJ5IHRoZSB3b3Jrc3BhY2UgY2xpZW50LiAqL1xuICBjYWNoZUlkZW50aXR5Pzogc3RyaW5nO1xufVxuXG4vKiogVFRMIG92ZXJyaWRlIG1lcmdlZCBpbnRvIGEge0BsaW5rIE1vZGVsUXVlcnl9IGZvciB7QGxpbmsgc2VhcmNoTW9kZWxzfS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2VhcmNoTW9kZWxzSW5wdXQgZXh0ZW5kcyBNb2RlbFF1ZXJ5IHtcbiAgLyoqIFRUTCBvdmVycmlkZSBmb3IgdGhlIGNhY2hlZCBgL3NlcnZpbmctZW5kcG9pbnRzYCBsaXN0aW5nLCBpbiBtcy4gKi9cbiAgdHRsTXM/OiBudW1iZXI7XG4gIC8qKiBUcnVzdGVkIG9wYXF1ZSBpZGVudGl0eSBvZiB0aGUgY3JlZGVudGlhbCB1c2VkIGJ5IHRoZSB3b3Jrc3BhY2UgY2xpZW50LiAqL1xuICBjYWNoZUlkZW50aXR5Pzogc3RyaW5nO1xufVxuXG4vKipcbiAqIFJhbmsgdGhlIGxpdmUgY2F0YWxvZ3VlIGFnYWluc3QgYSB7QGxpbmsgTW9kZWxRdWVyeX0sIGJlc3QtZmlyc3QuXG4gKlxuICogUnVzdCBvd25zIGNsYXNzaWZpY2F0aW9uLCBmdXp6eSBzY29yaW5nLCBmYW1pbHktdmVyc2lvbiBvcmRlcmluZywgcHJlZmVycmVkXG4gKiB2YXJpYW50cywgY2xhc3MgY2VpbGluZ3MsIHRvb2wgZmlsdGVyaW5nLCBhbmQgcmVzdWx0IGxpbWl0aW5nLiBOb2RlIHJldGFpbnNcbiAqIHRoZSBjYWxsZXIncyBlbmRwb2ludCBvYmplY3RzIHNvIGZpZWxkcyBvdXRzaWRlIHRoZSByYW5raW5nIGNvbnRyYWN0IHJlbWFpblxuICogYXZhaWxhYmxlIHVuY2hhbmdlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGxvb2t1cE1vZGVscyhcbiAgZW5kcG9pbnRzOiByZWFkb25seSBTZXJ2aW5nRW5kcG9pbnRTdW1tYXJ5W10sXG4gIHF1ZXJ5OiBNb2RlbFF1ZXJ5ID0ge30sXG4pOiBSYW5rZWRNb2RlbFtdIHtcbiAgcmV0dXJuIHJhbmtFbmRwb2ludHMoZW5kcG9pbnRzLCBxdWVyeSk7XG59XG5cbi8qKlxuICogQ29sbGFwc2Uge0BsaW5rIGxvb2t1cE1vZGVsc30gdG8gYSBzaW5nbGUgaWQ6IHRoZSBjbG9zZXN0IGVuZHBvaW50IHRvIGBzZWFyY2hgXG4gKiBpbiBhIGNhdGFsb2d1ZSBzbmFwc2hvdCwgb3IgdGhlIGlucHV0IHZlcmJhdGltIHdoZW4gbm90aGluZyBzY29yZXMgd2l0aGluIHRoZVxuICogdGhyZXNob2xkLlxuICpcbiAqIFRoZSByYW5rZWQgY291bnRlcnBhcnQgdG8ge0BsaW5rIHJlc29sdmVNb2RlbElkfTogZXF1YWxcbiAqIG1hdGNoIHNjb3JlcyBhcmUgYnJva2VuIGJ5IGNsYXNzIGFuZCB0aGVuIHdpdGhpbi1jbGFzcyB2ZXJzaW9uLCBzbyBhIGxvb3NlXG4gKiBgXCJvcHVzXCJgIHByZWZlcnMgYG9wdXMtNWAgb3ZlciBgb3B1cy00LTdgIGluc3RlYWQgb2YgcGlja2luZyB3aGljaGV2ZXJcbiAqIHNpYmxpbmcgYXBwZWFyZWQgZmlyc3QuIFJldHVybmluZyB0aGUgaW5wdXQgdW5tYXRjaGVkIChyYXRoZXJcbiAqIHRoYW4gYSBuZWFyIG5laWdoYm91cikgaXMgZGVsaWJlcmF0ZSAtIGEgZGVsaWJlcmF0ZSBlbmRwb2ludCBpZCBpcyBuZXZlclxuICogc2lsZW50bHkgcmV3cml0dGVuLCBhbmQgRGF0YWJyaWNrcyBzdXJmYWNlcyBhIGNsZWFuIDQwNC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJhbmtNb2RlbElkKFxuICBlbmRwb2ludHM6IHJlYWRvbmx5IFNlcnZpbmdFbmRwb2ludFN1bW1hcnlbXSxcbiAgc2VhcmNoOiBzdHJpbmcsXG4gIG9wdGlvbnM6IFJlc29sdmVNb2RlbE9wdGlvbnMgPSB7fSxcbik6IFJlc29sdmVkTW9kZWwge1xuICBjb25zdCBbdG9wXSA9IGxvb2t1cE1vZGVscyhlbmRwb2ludHMsIHtcbiAgICBzZWFyY2gsXG4gICAgbGltaXQ6IDEsXG4gICAgLi4uKG9wdGlvbnMudGhyZXNob2xkICE9PSB1bmRlZmluZWQgPyB7IHRocmVzaG9sZDogb3B0aW9ucy50aHJlc2hvbGQgfSA6IHt9KSxcbiAgICAuLi4ob3B0aW9ucy5yZXF1aXJlc1Rvb2xzICE9PSB1bmRlZmluZWQgPyB7IHJlcXVpcmVzVG9vbHM6IG9wdGlvbnMucmVxdWlyZXNUb29scyB9IDoge30pLFxuICB9KTtcbiAgaWYgKCF0b3ApIHJldHVybiB7IG1vZGVsSWQ6IHNlYXJjaCwgbWF0Y2hlZDogZmFsc2UgfTtcbiAgcmV0dXJuIHsgbW9kZWxJZDogdG9wLmVuZHBvaW50Lm5hbWUsIG1hdGNoZWQ6IHRydWUsIHNjb3JlOiB0b3Auc2NvcmUgfTtcbn1cblxuLyoqXG4gKiB7QGxpbmsgcmFua01vZGVsSWR9IGFnYWluc3QgYSBjYXRhbG9ndWUgdGhlIGNhbGxlciBtYXkgYmUgaG9sZGluZyBzdGFsZTpcbiAqIG1hdGNoIHRoZSBsb2FkZWQgc25hcHNob3QsIGFuZCBvbiBhIG1pc3MgcmVsb2FkIG9uY2Ugd2l0aCBgZm9yY2VgIGFuZCBtYXRjaFxuICogYWdhaW4uIFRoYXQgd2F5IGEgbW9kZWwgZGVwbG95ZWQgYWZ0ZXIgdGhlIGNhdGFsb2d1ZSB3YXMgY2FjaGVkIHN0aWxsXG4gKiByZXNvbHZlcyBvbiBmaXJzdCB1c2UsIHdpdGhvdXQgYSByZXN0YXJ0IGFuZCB3aXRob3V0IGdpdmluZyB1cCBjYWNoaW5nLlxuICpcbiAqIFRoZSBjYXRhbG9ndWUgYXJyaXZlcyBhcyBhIGxvYWRlciByYXRoZXIgdGhhbiBhIGNsaWVudCBzbyB0aGUgY2FsbGVyIGtlZXBzXG4gKiBvd25lcnNoaXAgb2YgKmhvdyogaXQgaXMgY2FjaGVkIC0ge0BsaW5rIGxpc3RTZXJ2aW5nRW5kcG9pbnRzfSBhbmQgaXRzXG4gKiBgQ2FjaGVNYW5hZ2VyYCwgYSBwbGFpbiBwcm9jZXNzLWxpZmV0aW1lIGZpZWxkIGluIGEgQ0xJLCBvciBhIHRlc3QgZG91YmxlLlxuICogT25seSBvbmUgcmVsb2FkIGlzIGF0dGVtcHRlZDogYSBnZW51aW5lbHkgdW5rbm93biBuYW1lIHNob3VsZCBmYWlsIGZhc3RcbiAqIHJhdGhlciB0aGFuIHJlLWxpc3Qgb24gZXZlcnkgcmVxdWVzdC5cbiAqXG4gKiBAcGFyYW0gbG9hZCAtIFJldHVybnMgdGhlIGNhdGFsb2d1ZTsgYGZvcmNlYCBhc2tzIGl0IHRvIGJ5cGFzcyBpdHMgY2FjaGUuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiByYW5rTW9kZWxJZExpdmUoXG4gIGxvYWQ6IChmb3JjZTogYm9vbGVhbikgPT4gUHJvbWlzZTxyZWFkb25seSBTZXJ2aW5nRW5kcG9pbnRTdW1tYXJ5W10+LFxuICBzZWFyY2g6IHN0cmluZyxcbiAgb3B0aW9uczogUmVzb2x2ZU1vZGVsT3B0aW9ucyA9IHt9LFxuKTogUHJvbWlzZTxSZXNvbHZlZE1vZGVsPiB7XG4gIGNvbnN0IHJlc29sdmVkID0gcmFua01vZGVsSWQoYXdhaXQgbG9hZChmYWxzZSksIHNlYXJjaCwgb3B0aW9ucyk7XG4gIGlmIChyZXNvbHZlZC5tYXRjaGVkKSByZXR1cm4gcmVzb2x2ZWQ7XG4gIHJldHVybiByYW5rTW9kZWxJZChhd2FpdCBsb2FkKHRydWUpLCBzZWFyY2gsIG9wdGlvbnMpO1xufVxuXG4vKipcbiAqIFJhbmsgYSB3b3Jrc3BhY2UncyBjYXRhbG9ndWUgaW4gb25lIGNhbGw6IGxpc3QgaXRzIGAvc2VydmluZy1lbmRwb2ludHNgXG4gKiAoY2FjaGVkKSBhbmQgcnVuIHtAbGluayBsb29rdXBNb2RlbHN9IG92ZXIgdGhlIHJlc3VsdC4gVGhlIGxpc3QgY291bnRlcnBhcnQgdG9cbiAqIHtAbGluayBzZWxlY3RNb2RlbH0sIGZvciBhIGNvbnN1bWVyIHRoYXQgd2FudHMgdGhlIGZ1bGwgcmFua2VkIHNldCAoYSBtb2RlbFxuICogcGlja2VyLCBhIENMSSkgcmF0aGVyIHRoYW4gYSBzaW5nbGUgaWQuIENhdGFsb2d1ZSBmZXRjaGVzIGZhaWwgbG91ZDogbmV0d29ya1xuICogLyBhdXRoIGVycm9ycyBwcm9wYWdhdGUgc28gdGhlIGNhbGxlciBzZWVzIHRoZSByZWFsIFNESyBtZXNzYWdlLlxuICpcbiAqIEBwYXJhbSBob3N0IC0gV29ya3NwYWNlIGhvc3QgdXNlZCBhcyB0aGUgY2FjaGUga2V5LiBQYXNzIHRoZSB2YWx1ZSByZXNvbHZlZFxuICogICBmcm9tIGBjbGllbnQuY29uZmlnLmdldEhvc3QoKWAuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBzZWFyY2hNb2RlbHMoXG4gIGNsaWVudDogV29ya3NwYWNlQ2xpZW50TGlrZSxcbiAgaG9zdDogc3RyaW5nLFxuICBpbnB1dDogU2VhcmNoTW9kZWxzSW5wdXQgPSB7fSxcbik6IFByb21pc2U8UmFua2VkTW9kZWxbXT4ge1xuICBjb25zdCBlbmRwb2ludHMgPSBhd2FpdCBsaXN0U2VydmluZ0VuZHBvaW50cyhjbGllbnQsIGhvc3QsIHtcbiAgICAuLi4oaW5wdXQudHRsTXMgIT09IHVuZGVmaW5lZCA/IHsgdHRsTXM6IGlucHV0LnR0bE1zIH0gOiB7fSksXG4gICAgLi4uKGlucHV0LmNhY2hlSWRlbnRpdHkgIT09IHVuZGVmaW5lZCA/IHsgY2FjaGVJZGVudGl0eTogaW5wdXQuY2FjaGVJZGVudGl0eSB9IDoge30pLFxuICB9KTtcbiAgcmV0dXJuIGxvb2t1cE1vZGVscyhlbmRwb2ludHMsIGlucHV0KTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlIGEgbW9kZWwgaWQgZm9yIGEgd29ya3NwYWNlIGluIG9uZSBjYWxsOiBsaXN0IGl0cyBgL3NlcnZpbmctZW5kcG9pbnRzYFxuICogKGNhY2hlZCkgYW5kIHJ1biB7QGxpbmsgcmVzb2x2ZU1vZGVsfSBvdmVyIHRoZSByZXN1bHQuIFRoaXMgaXMgdGhlIGVudHJ5XG4gKiBwb2ludCBmb3IgYW55IGNvbnN1bWVyIHRoYXQgaG9sZHMgYSBgV29ya3NwYWNlQ2xpZW50YCBhbmQganVzdCB3YW50cyBhIHVzYWJsZVxuICogbW9kZWwgbmFtZSAtIGEgTGFrZWZsb3cgam9iLCBhIG9uZS1vZmYgc2NyaXB0LCBvciB0aGUgTWFzdHJhIHBsdWdpbiBhbGlrZS5cbiAqXG4gKiBDaGVhcCBleGl0OiB3aGVuIGFuIGBleHBsaWNpdGAgbmFtZSBpcyBnaXZlbiwgYGZ1enp5YCBpcyBvZmYsIGFuZCB0b29sXG4gKiBjYXBhYmlsaXR5IGlzIG5vdCByZXF1aXJlZCwgdGhlIGNhdGFsb2d1ZSBpcyBuZXZlciBmZXRjaGVkLiBDYXRhbG9ndWVcbiAqIGZldGNoZXMgb3RoZXJ3aXNlIGZhaWwgbG91ZDogbmV0d29yayAvIGF1dGggZXJyb3JzIHByb3BhZ2F0ZSBzbyB0aGUgY2FsbGVyXG4gKiBzZWVzIHRoZSByZWFsIFNESyBtZXNzYWdlIGluc3RlYWQgb2YgYSBzaWxlbnQgZmFsbGJhY2suXG4gKlxuICogQHBhcmFtIGhvc3QgLSBXb3Jrc3BhY2UgaG9zdCB1c2VkIGFzIHRoZSBjYWNoZSBrZXkuIFBhc3MgdGhlIHZhbHVlIHJlc29sdmVkXG4gKiAgIGZyb20gYGNsaWVudC5jb25maWcuZ2V0SG9zdCgpYC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHNlbGVjdE1vZGVsKFxuICBjbGllbnQ6IFdvcmtzcGFjZUNsaWVudExpa2UsXG4gIGhvc3Q6IHN0cmluZyxcbiAgaW5wdXQ6IFNlbGVjdE1vZGVsSW5wdXQgPSB7fSxcbik6IFByb21pc2U8UmVzb2x2ZWRNb2RlbFNlbGVjdGlvbj4ge1xuICBpZiAoaW5wdXQuZXhwbGljaXQgIT09IHVuZGVmaW5lZCAmJiBpbnB1dC5mdXp6eSA9PT0gZmFsc2UgJiYgIWlucHV0LnJlcXVpcmVzVG9vbHMpIHtcbiAgICByZXR1cm4geyBtb2RlbElkOiBpbnB1dC5leHBsaWNpdCwgc291cmNlOiBcImV4cGxpY2l0XCIgfTtcbiAgfVxuICBjb25zdCBlbmRwb2ludHMgPSBhd2FpdCBsaXN0U2VydmluZ0VuZHBvaW50cyhjbGllbnQsIGhvc3QsIHtcbiAgICAuLi4oaW5wdXQudHRsTXMgIT09IHVuZGVmaW5lZCA/IHsgdHRsTXM6IGlucHV0LnR0bE1zIH0gOiB7fSksXG4gICAgLi4uKGlucHV0LmNhY2hlSWRlbnRpdHkgIT09IHVuZGVmaW5lZCA/IHsgY2FjaGVJZGVudGl0eTogaW5wdXQuY2FjaGVJZGVudGl0eSB9IDoge30pLFxuICB9KTtcbiAgcmV0dXJuIHJlc29sdmVNb2RlbChlbmRwb2ludHMsIGlucHV0KTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlIGEgc2luZ2xlIG1vZGVsIGlkIGZyb20gdGhlIGxpdmUgY2F0YWxvZ3VlIGFuZCBjYWxsZXIgaW50ZW50LFxuICogZGVsZWdhdGluZyB0aGUgbGl2ZSBzZWxlY3Rpb24gdG8ge0BsaW5rIGxvb2t1cE1vZGVsc30gd2l0aCBgbGltaXQ6IDFgLlxuICpcbiAqIDEuICoqRXhwbGljaXQgYXNrKio6IHdpdGggYGZ1enp5YCBvZmYsIHJldHVybmVkIHZlcmJhdGltOyBvdGhlcndpc2VcbiAqICAgIGZ1enp5LXJhbmtlZCB3aXRoaW4gdGhlIChvcHRpb25hbCkgY2xhc3MgY2VpbGluZyBhbmQgdGhlIGJlc3QgdGFrZW4sXG4gKiAgICBmYWxsaW5nIGJhY2sgdG8gdGhlIGlucHV0IHZlcmJhdGltIHdoZW4gbm90aGluZyBtYXRjaGVzLlxuICogMi4gKipObyBleHBsaWNpdCBhc2sqKjogYW4gb3BlcmF0b3ItcGlubmVkIGBmYWxsYmFja2AgdGhhdCBleGlzdHMgaW4gdGhlIGxpdmVcbiAqICAgIGNhdGFsb2d1ZSB3aW5zIGZpcnN0LiBBIGNsYXNzIHJlcXVlc3QgcmFua3Mgd2l0aGluIHRoYXQgY2VpbGluZy4gQVxuICogICAgZ2VuZXJhbCByZXF1ZXN0IHByZWZlcnMgdGhlIGhpZ2hlc3QtcmFua2VkIGxpdmUgR1BULCB0aGVuIGFueSByYW5rZWQgbGl2ZVxuICogICAgY2hhdCBtb2RlbC4gVGhlIHN0YXRpYyB7QGxpbmsgRkFMTEJBQ0tfTU9ERUxfSURTfSBmbG9vciBpcyB1c2VkIG9ubHkgd2hlblxuICogICAgdGhlIGNhdGFsb2d1ZSB5aWVsZHMgbm90aGluZyBpbiByYW5nZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVNb2RlbChcbiAgZW5kcG9pbnRzOiByZWFkb25seSBTZXJ2aW5nRW5kcG9pbnRTdW1tYXJ5W10sXG4gIGlucHV0OiBSZXNvbHZlTW9kZWxJbnB1dCA9IHt9LFxuKTogUmVzb2x2ZWRNb2RlbFNlbGVjdGlvbiB7XG4gIGlmIChpbnB1dC5leHBsaWNpdCAhPT0gdW5kZWZpbmVkKSB7XG4gICAgaWYgKGlucHV0LmZ1enp5ID09PSBmYWxzZSkge1xuICAgICAgaWYgKGlucHV0LnJlcXVpcmVzVG9vbHMpIGFzc2VydFRvb2xTdXBwb3J0KGVuZHBvaW50cywgaW5wdXQuZXhwbGljaXQpO1xuICAgICAgcmV0dXJuIHsgbW9kZWxJZDogaW5wdXQuZXhwbGljaXQsIHNvdXJjZTogXCJleHBsaWNpdFwiIH07XG4gICAgfVxuICAgIGNvbnN0IFt0b3BdID0gbG9va3VwTW9kZWxzKGVuZHBvaW50cywgYnVpbGRRdWVyeShpbnB1dCwgaW5wdXQuZXhwbGljaXQpKTtcbiAgICBpZiAoaW5wdXQucmVxdWlyZXNUb29scyAmJiAhdG9wKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYE5vIHRvb2wtY2FwYWJsZSBtb2RlbCBtYXRjaGVzIFwiJHtpbnB1dC5leHBsaWNpdH1cImApO1xuICAgIH1cbiAgICByZXR1cm4geyBtb2RlbElkOiB0b3A/LmVuZHBvaW50Lm5hbWUgPz8gaW5wdXQuZXhwbGljaXQsIHNvdXJjZTogXCJmdXp6eS1tYXRjaFwiIH07XG4gIH1cblxuICAvLyBPcGVyYXRvci1waW5uZWQgZmFsbGJhY2tzIHdpbiB3aGVuIHByZXNlbnQgYW5kIGxpdmUgKGUuZy4gYSByZWd1bGF0ZWRcbiAgLy8gd29ya3NwYWNlIHJlc3RyaWN0ZWQgdG8gYW4gYXBwcm92ZWQgc3Vic2V0KS5cbiAgaWYgKGlucHV0Lm1vZGVsQ2xhc3MgPT09IHVuZGVmaW5lZCAmJiBpbnB1dC5mYWxsYmFja3MgJiYgaW5wdXQuZmFsbGJhY2tzLmxlbmd0aCA+IDApIHtcbiAgICBjb25zdCBwcmVzZW50ID0gbmV3IFNldChcbiAgICAgIGVuZHBvaW50c1xuICAgICAgICAuZmlsdGVyKChlbmRwb2ludCkgPT4gIWlucHV0LnJlcXVpcmVzVG9vbHMgfHwgZW5kcG9pbnRTdXBwb3J0c1Rvb2xzKGVuZHBvaW50KSlcbiAgICAgICAgLm1hcCgoZW5kcG9pbnQpID0+IGVuZHBvaW50Lm5hbWUpLFxuICAgICk7XG4gICAgY29uc3QgcGlubmVkID0gaW5wdXQuZmFsbGJhY2tzLmZpbmQoKGlkKSA9PiBwcmVzZW50LmhhcyhpZCkpO1xuICAgIGlmIChwaW5uZWQpIHJldHVybiB7IG1vZGVsSWQ6IHBpbm5lZCwgc291cmNlOiBcImZhbGxiYWNrXCIgfTtcbiAgfVxuXG4gIGNvbnN0IHNvdXJjZSA9IGlucHV0Lm1vZGVsQ2xhc3MgIT09IHVuZGVmaW5lZCA/IFwiY2xhc3NcIiA6IFwiZmFsbGJhY2tcIjtcbiAgaWYgKGlucHV0Lm1vZGVsQ2xhc3MgPT09IHVuZGVmaW5lZCkge1xuICAgIGNvbnN0IFtwcmVmZXJyZWRdID0gbG9va3VwTW9kZWxzKGVuZHBvaW50cywgYnVpbGRRdWVyeShpbnB1dCwgREVGQVVMVF9NT0RFTF9GQU1JTFlfU0VBUkNIKSk7XG4gICAgaWYgKHByZWZlcnJlZCkgcmV0dXJuIHsgbW9kZWxJZDogcHJlZmVycmVkLmVuZHBvaW50Lm5hbWUsIHNvdXJjZSB9O1xuICB9XG4gIGNvbnN0IFt0b3BdID0gbG9va3VwTW9kZWxzKGVuZHBvaW50cywgYnVpbGRRdWVyeShpbnB1dCwgdW5kZWZpbmVkKSk7XG4gIGlmICh0b3ApIHJldHVybiB7IG1vZGVsSWQ6IHRvcC5lbmRwb2ludC5uYW1lLCBzb3VyY2UgfTtcblxuICBpZiAoaW5wdXQubGl2ZU9ubHkpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoXCJObyBtYXRjaGluZyBsaXZlIE1vZGVsIFNlcnZpbmcgZW5kcG9pbnQgaXMgYXZhaWxhYmxlXCIpO1xuICB9XG5cbiAgLy8gTGl2ZSBjYXRhbG9ndWUgeWllbGRlZCBub3RoaW5nIGluIHJhbmdlOiB3YWxrIHRoZSBzdGF0aWMgZmxvb3IuXG4gIGNvbnN0IGZsb29yU291cmNlID1cbiAgICBpbnB1dC5tb2RlbENsYXNzICE9PSB1bmRlZmluZWQgPyBtb2RlbHNGb3JDbGFzcyhpbnB1dC5tb2RlbENsYXNzKSA6IChpbnB1dC5mYWxsYmFja3MgPz8gW10pO1xuICBjb25zdCBmbG9vciA9IG9iamVjdC5zZXF1ZW5jZShmbG9vclNvdXJjZSkuY29uY2F0KEZBTExCQUNLX01PREVMX0lEUykuZGlzdGluY3QoKS50b0FycmF5KCk7XG4gIGlmIChpbnB1dC5yZXF1aXJlc1Rvb2xzKSB7XG4gICAgY29uc3QgYXZhaWxhYmxlID0gbmV3IFNldChcbiAgICAgIGVuZHBvaW50cy5maWx0ZXIoZW5kcG9pbnRTdXBwb3J0c1Rvb2xzKS5tYXAoKGVuZHBvaW50KSA9PiBlbmRwb2ludC5uYW1lKSxcbiAgICApO1xuICAgIGNvbnN0IHNlbGVjdGVkID0gZmxvb3IuZmluZCgoaWQpID0+IGF2YWlsYWJsZS5oYXMoaWQpKTtcbiAgICBpZiAoIXNlbGVjdGVkKSB0aHJvdyBuZXcgRXJyb3IoXCJObyB0b29sLWNhcGFibGUgbW9kZWwgaXMgYXZhaWxhYmxlXCIpO1xuICAgIHJldHVybiB7IG1vZGVsSWQ6IHNlbGVjdGVkLCBzb3VyY2UgfTtcbiAgfVxuICByZXR1cm4geyBtb2RlbElkOiBwaWNrRmlyc3RBdmFpbGFibGUoZmxvb3IsIGVuZHBvaW50cyksIHNvdXJjZSB9O1xufVxuXG4vKiogQnVpbGQgYSB7QGxpbmsgTW9kZWxRdWVyeX0gZnJvbSB7QGxpbmsgUmVzb2x2ZU1vZGVsSW5wdXR9IGZvciB0aGUgYGxpbWl0OiAxYCBkZWxlZ2F0aW9uLiAqL1xuZnVuY3Rpb24gYnVpbGRRdWVyeShpbnB1dDogUmVzb2x2ZU1vZGVsSW5wdXQsIHNlYXJjaDogc3RyaW5nIHwgdW5kZWZpbmVkKTogTW9kZWxRdWVyeSB7XG4gIHJldHVybiB7XG4gICAgLi4uKHNlYXJjaCAhPT0gdW5kZWZpbmVkID8geyBzZWFyY2ggfSA6IHt9KSxcbiAgICAuLi4oaW5wdXQubW9kZWxDbGFzcyAhPT0gdW5kZWZpbmVkID8geyBtb2RlbENsYXNzOiBpbnB1dC5tb2RlbENsYXNzIH0gOiB7fSksXG4gICAgLi4uKGlucHV0LnJlcXVpcmVzVG9vbHMgIT09IHVuZGVmaW5lZCA/IHsgcmVxdWlyZXNUb29sczogaW5wdXQucmVxdWlyZXNUb29scyB9IDoge30pLFxuICAgIC4uLihpbnB1dC50aHJlc2hvbGQgIT09IHVuZGVmaW5lZCA/IHsgdGhyZXNob2xkOiBpbnB1dC50aHJlc2hvbGQgfSA6IHt9KSxcbiAgICBsaW1pdDogMSxcbiAgfTtcbn1cblxuLyoqIFRocm93IHdoZW4gYW4gZXhwbGljaXQgaWQgaXMgYWJzZW50IG9yIG5vdCB2ZXJpZmllZCBmb3IgZnVuY3Rpb24gdG9vbHMuICovXG5mdW5jdGlvbiBhc3NlcnRUb29sU3VwcG9ydChlbmRwb2ludHM6IHJlYWRvbmx5IFNlcnZpbmdFbmRwb2ludFN1bW1hcnlbXSwgbW9kZWxJZDogc3RyaW5nKTogdm9pZCB7XG4gIGNvbnN0IGVuZHBvaW50ID0gZW5kcG9pbnRzLmZpbmQoKGNhbmRpZGF0ZSkgPT4gY2FuZGlkYXRlLm5hbWUgPT09IG1vZGVsSWQpO1xuICBpZiAoIWVuZHBvaW50IHx8ICFlbmRwb2ludFN1cHBvcnRzVG9vbHMoZW5kcG9pbnQpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBNb2RlbCBcIiR7bW9kZWxJZH1cIiBkb2VzIG5vdCBzdXBwb3J0IGZ1bmN0aW9uIHRvb2xzYCk7XG4gIH1cbn1cblxuLyoqXG4gKiBGaW5kIHRoZSBmaXJzdCBpZCBpbiBgY2FuZGlkYXRlc2Agd2hvc2UgZW5kcG9pbnQgaXMgcHJlc2VudCBpbiBgZW5kcG9pbnRzYC5cbiAqIFJldHVybnMgdGhlIHRvcCBjYW5kaWRhdGUgd2hlbiB0aGUgd29ya3NwYWNlIGhhcyBub25lIG9mIHRoZW0gc28gY2FsbGVyc1xuICogYWx3YXlzIGdldCBhIHN0cmluZzsgYW4gb2ZmbGluZSB3b3Jrc3BhY2UgdGhlbiByZWNlaXZlcyBhIGNsZWFuIDQwNCBmcm9tXG4gKiBEYXRhYnJpY2tzIGluc3RlYWQgb2YgYSBtYWxmb3JtZWQgY29uZmlnLlxuICovXG5mdW5jdGlvbiBwaWNrRmlyc3RBdmFpbGFibGUoXG4gIGNhbmRpZGF0ZXM6IHJlYWRvbmx5IHN0cmluZ1tdLFxuICBlbmRwb2ludHM6IHJlYWRvbmx5IFNlcnZpbmdFbmRwb2ludFN1bW1hcnlbXSxcbik6IHN0cmluZyB7XG4gIGNvbnN0IHByZXNlbnQgPSBuZXcgU2V0KGVuZHBvaW50cy5tYXAoKGUpID0+IGUubmFtZSkpO1xuICBmb3IgKGNvbnN0IGNhbmRpZGF0ZSBvZiBjYW5kaWRhdGVzKSB7XG4gICAgaWYgKHByZXNlbnQuaGFzKGNhbmRpZGF0ZSkpIHJldHVybiBjYW5kaWRhdGU7XG4gIH1cbiAgcmV0dXJuIGNhbmRpZGF0ZXNbMF0gPz8gRkFMTEJBQ0tfTU9ERUxfSURTWzBdITtcbn1cbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb2x2ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9yZXNvbHZlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU9BLE9BQU8sRUFDTCxZQUFZLEVBQ1osV0FBVyxFQUdYLFlBQVksR0FDYixNQUFNLGlCQUFpQixDQUFDO0FBQ3pCLE9BQU8sRUFDTCxvQkFBb0IsR0FLckIsTUFBTSxvQkFBb0IsQ0FBQztBQUU1QixPQUFPLEVBQUUsWUFBWSxFQUFFLFdBQVcsRUFBRSxZQUFZLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQWUxRSxnRkFBZ0Y7QUFDaEYsTUFBTSxDQUFDLEtBQUssVUFBVSxlQUFlLENBQ25DLElBQW9FLEVBQ3BFLE1BQWMsRUFDZCxVQUErQixFQUFFO0lBRWpDLE1BQU0sUUFBUSxHQUFHLFdBQVcsQ0FBQyxNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBRSxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDakUsSUFBSSxRQUFRLENBQUMsT0FBTztRQUFFLE9BQU8sUUFBUSxDQUFDO0lBQ3RDLE9BQU8sV0FBVyxDQUFDLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLE1BQU0sRUFBRSxPQUFPLENBQUMsQ0FBQztBQUN4RCxDQUFDO0FBRUQsaURBQWlEO0FBQ2pELE1BQU0sQ0FBQyxLQUFLLFVBQVUsWUFBWSxDQUNoQyxNQUEyQixFQUMzQixJQUFZLEVBQ1osUUFBMkIsRUFBRTtJQUU3QixNQUFNLFNBQVMsR0FBRyxNQUFNLG9CQUFvQixDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsZ0JBQWdCLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztJQUNwRixPQUFPLFlBQVksQ0FBQyxTQUFTLEVBQUUsS0FBSyxDQUFDLENBQUM7QUFDeEMsQ0FBQztBQUVELHdEQUF3RDtBQUN4RCxNQUFNLENBQUMsS0FBSyxVQUFVLFdBQVcsQ0FDL0IsTUFBMkIsRUFDM0IsSUFBWSxFQUNaLFFBQTBCLEVBQUU7SUFFNUIsSUFBSSxLQUFLLENBQUMsUUFBUSxLQUFLLFNBQVMsSUFBSSxLQUFLLENBQUMsS0FBSyxLQUFLLEtBQUssSUFBSSxDQUFDLEtBQUssQ0FBQyxhQUFhLEVBQUUsQ0FBQztRQUNsRixPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLFVBQVUsRUFBRSxDQUFDO0lBQ3pELENBQUM7SUFDRCxNQUFNLFNBQVMsR0FBRyxNQUFNLG9CQUFvQixDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsZ0JBQWdCLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztJQUNwRixPQUFPLFlBQVksQ0FBQyxTQUFTLEVBQUUsS0FBSyxDQUFDLENBQUM7QUFDeEMsQ0FBQztBQUVELFNBQVMsZ0JBQWdCLENBQUMsS0FHekI7SUFDQyxPQUFPO1FBQ0wsR0FBRyxDQUFDLEtBQUssQ0FBQyxLQUFLLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssRUFBRSxLQUFLLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUM1RCxHQUFHLENBQUMsS0FBSyxDQUFDLGFBQWEsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsYUFBYSxFQUFFLEtBQUssQ0FBQyxhQUFhLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO0tBQ3JGLENBQUM7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBXb3Jrc3BhY2UtYXdhcmUgbW9kZWwgc2VsZWN0aW9uIHdyYXBwZXJzLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuaW1wb3J0IHR5cGUgeyBNb2RlbFF1ZXJ5LCBSYW5rZWRNb2RlbCwgU2VydmluZ0VuZHBvaW50U3VtbWFyeSB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1tb2RlbFwiO1xuXG5pbXBvcnQge1xuICBsb29rdXBNb2RlbHMsXG4gIHJhbmtNb2RlbElkLFxuICB0eXBlIFJlc29sdmVNb2RlbElucHV0LFxuICB0eXBlIFJlc29sdmVkTW9kZWxTZWxlY3Rpb24sXG4gIHJlc29sdmVNb2RlbCxcbn0gZnJvbSBcIi4vX3NlbGVjdGlvbi50c1wiO1xuaW1wb3J0IHtcbiAgbGlzdFNlcnZpbmdFbmRwb2ludHMsXG4gIHR5cGUgTGlzdFNlcnZpbmdFbmRwb2ludHNPcHRpb25zLFxuICB0eXBlIFJlc29sdmVkTW9kZWwsXG4gIHR5cGUgUmVzb2x2ZU1vZGVsT3B0aW9ucyxcbiAgdHlwZSBXb3Jrc3BhY2VDbGllbnRMaWtlLFxufSBmcm9tIFwiLi9tb2RlbC1jYXRhbG9nLnRzXCI7XG5cbmV4cG9ydCB7IGxvb2t1cE1vZGVscywgcmFua01vZGVsSWQsIHJlc29sdmVNb2RlbCB9IGZyb20gXCIuL19zZWxlY3Rpb24udHNcIjtcbmV4cG9ydCB0eXBlIHsgUmVzb2x2ZU1vZGVsSW5wdXQsIFJlc29sdmVkTW9kZWxTZWxlY3Rpb24gfSBmcm9tIFwiLi9fc2VsZWN0aW9uLnRzXCI7XG5cbi8qKiBJbnRlbnQgcGx1cyBjYXRhbG9ndWUgY2FjaGUgY29udHJvbHMgcGFzc2VkIHRvIHtAbGluayBzZWxlY3RNb2RlbH0uICovXG5leHBvcnQgaW50ZXJmYWNlIFNlbGVjdE1vZGVsSW5wdXQgZXh0ZW5kcyBSZXNvbHZlTW9kZWxJbnB1dCB7XG4gIHR0bE1zPzogbnVtYmVyO1xuICBjYWNoZUlkZW50aXR5Pzogc3RyaW5nO1xufVxuXG4vKiogUXVlcnkgcGx1cyBjYXRhbG9ndWUgY2FjaGUgY29udHJvbHMgcGFzc2VkIHRvIHtAbGluayBzZWFyY2hNb2RlbHN9LiAqL1xuZXhwb3J0IGludGVyZmFjZSBTZWFyY2hNb2RlbHNJbnB1dCBleHRlbmRzIE1vZGVsUXVlcnkge1xuICB0dGxNcz86IG51bWJlcjtcbiAgY2FjaGVJZGVudGl0eT86IHN0cmluZztcbn1cblxuLyoqIFJlc29sdmUgYWdhaW5zdCBhIHBvdGVudGlhbGx5IHN0YWxlIGNhdGFsb2d1ZSwgcmVmcmVzaGluZyBvbmNlIG9uIGEgbWlzcy4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiByYW5rTW9kZWxJZExpdmUoXG4gIGxvYWQ6IChmb3JjZTogYm9vbGVhbikgPT4gUHJvbWlzZTxyZWFkb25seSBTZXJ2aW5nRW5kcG9pbnRTdW1tYXJ5W10+LFxuICBzZWFyY2g6IHN0cmluZyxcbiAgb3B0aW9uczogUmVzb2x2ZU1vZGVsT3B0aW9ucyA9IHt9LFxuKTogUHJvbWlzZTxSZXNvbHZlZE1vZGVsPiB7XG4gIGNvbnN0IHJlc29sdmVkID0gcmFua01vZGVsSWQoYXdhaXQgbG9hZChmYWxzZSksIHNlYXJjaCwgb3B0aW9ucyk7XG4gIGlmIChyZXNvbHZlZC5tYXRjaGVkKSByZXR1cm4gcmVzb2x2ZWQ7XG4gIHJldHVybiByYW5rTW9kZWxJZChhd2FpdCBsb2FkKHRydWUpLCBzZWFyY2gsIG9wdGlvbnMpO1xufVxuXG4vKiogTGlzdCBhbmQgcmFuayBhIHdvcmtzcGFjZSBtb2RlbCBjYXRhbG9ndWUuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gc2VhcmNoTW9kZWxzKFxuICBjbGllbnQ6IFdvcmtzcGFjZUNsaWVudExpa2UsXG4gIGhvc3Q6IHN0cmluZyxcbiAgaW5wdXQ6IFNlYXJjaE1vZGVsc0lucHV0ID0ge30sXG4pOiBQcm9taXNlPFJhbmtlZE1vZGVsW10+IHtcbiAgY29uc3QgZW5kcG9pbnRzID0gYXdhaXQgbGlzdFNlcnZpbmdFbmRwb2ludHMoY2xpZW50LCBob3N0LCBjYXRhbG9ndWVPcHRpb25zKGlucHV0KSk7XG4gIHJldHVybiBsb29rdXBNb2RlbHMoZW5kcG9pbnRzLCBpbnB1dCk7XG59XG5cbi8qKiBMaXN0IGEgd29ya3NwYWNlIGNhdGFsb2d1ZSBhbmQgcmVzb2x2ZSBvbmUgbW9kZWwuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gc2VsZWN0TW9kZWwoXG4gIGNsaWVudDogV29ya3NwYWNlQ2xpZW50TGlrZSxcbiAgaG9zdDogc3RyaW5nLFxuICBpbnB1dDogU2VsZWN0TW9kZWxJbnB1dCA9IHt9LFxuKTogUHJvbWlzZTxSZXNvbHZlZE1vZGVsU2VsZWN0aW9uPiB7XG4gIGlmIChpbnB1dC5leHBsaWNpdCAhPT0gdW5kZWZpbmVkICYmIGlucHV0LmZ1enp5ID09PSBmYWxzZSAmJiAhaW5wdXQucmVxdWlyZXNUb29scykge1xuICAgIHJldHVybiB7IG1vZGVsSWQ6IGlucHV0LmV4cGxpY2l0LCBzb3VyY2U6IFwiZXhwbGljaXRcIiB9O1xuICB9XG4gIGNvbnN0IGVuZHBvaW50cyA9IGF3YWl0IGxpc3RTZXJ2aW5nRW5kcG9pbnRzKGNsaWVudCwgaG9zdCwgY2F0YWxvZ3VlT3B0aW9ucyhpbnB1dCkpO1xuICByZXR1cm4gcmVzb2x2ZU1vZGVsKGVuZHBvaW50cywgaW5wdXQpO1xufVxuXG5mdW5jdGlvbiBjYXRhbG9ndWVPcHRpb25zKGlucHV0OiB7XG4gIHJlYWRvbmx5IHR0bE1zPzogbnVtYmVyO1xuICByZWFkb25seSBjYWNoZUlkZW50aXR5Pzogc3RyaW5nO1xufSk6IExpc3RTZXJ2aW5nRW5kcG9pbnRzT3B0aW9ucyB7XG4gIHJldHVybiB7XG4gICAgLi4uKGlucHV0LnR0bE1zICE9PSB1bmRlZmluZWQgPyB7IHR0bE1zOiBpbnB1dC50dGxNcyB9IDoge30pLFxuICAgIC4uLihpbnB1dC5jYWNoZUlkZW50aXR5ICE9PSB1bmRlZmluZWQgPyB7IGNhY2hlSWRlbnRpdHk6IGlucHV0LmNhY2hlSWRlbnRpdHkgfSA6IHt9KSxcbiAgfTtcbn1cbiJdfQ==

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/_native.ts","../src/classes.ts","../src/fallback.ts","../src/invoke.ts","../src/model-catalog.ts","../src/policy.ts","../src/resolve.ts","../index.ts"],"version":"5.9.3"}
+{"root":["../src/_metadata-contract.ts","../src/_metadata-generator.ts","../src/_ranking.ts","../src/_selection.ts","../src/classes.ts","../src/classify.ts","../src/fallback.ts","../src/invoke.ts","../src/metadata.ts","../src/model-catalog.ts","../src/model-client.ts","../src/policy.ts","../src/python.ts","../src/resolve.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -21,14 +21,16 @@
   "devDependencies": {
     "@types/bun": "1.3.14",
     "@types/node": "^24.6.0",
+    "cheerio": "^1.2.0",
     "typescript": "^5.9.3"
   },
   "dependencies": {
     "@databricks/appkit": "0.81.0",
-    "@dbx-tools/appkit": "^0.9.21",
-    "@dbx-tools/model-rs": "^0.9.21",
-    "@dbx-tools/shared-core": "^0.9.21",
-    "@dbx-tools/shared-model": "^0.9.21"
+    "@dbx-tools/appkit": "^0.9.29",
+    "@dbx-tools/auth": "^0.9.29",
+    "@dbx-tools/shared-core": "^0.9.29",
+    "@dbx-tools/shared-model": "^0.9.29",
+    "fuse.js": "^7.4.2"
   },
   "main": "./lib/index.js",
   "license": "Apache-2.0",
@@ -41,10 +43,14 @@
         "types": "./lib/index.d.ts",
         "default": "./lib/index.js"
       },
+      "./python": {
+        "types": "./lib/src/python.d.ts",
+        "default": "./lib/src/python.js"
+      },
       "./package.json": "./package.json"
     }
   },
-  "version": "0.9.21",
+  "version": "0.9.29",
   "types": "./lib/index.d.ts",
   "type": "module",
   "exports": {
@@ -52,6 +58,10 @@
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
+    "./python": {
+      "types": "./lib/src/python.d.ts",
+      "default": "./lib/src/python.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [

package/src/_metadata-contract.ts

@@ -0,0 +1,56 @@
+/** One day, matching the refresh cadence of Databricks model documentation. */
+export const MODEL_METADATA_TTL_MS = 24 * 60 * 60 * 1000;
+
+/** Databricks documentation URL for retired foundation models. */
+export const RETIRED_MODELS_URL =
+  "https://docs.databricks.com/aws/en/machine-learning/retired-models-policy";
+
+/** Databricks documentation URL for OpenAI Responses model support. */
+export const OPENAI_RESPONSES_MODELS_URL =
+  "https://docs.databricks.com/aws/en/machine-learning/model-serving/query-openai-responses";
+
+/** Databricks documentation URL for native web-search model support. */
+export const WEB_SEARCH_MODELS_URL =
+  "https://docs.databricks.com/aws/en/machine-learning/model-serving/web-search";
+
+/** Databricks documentation URL for Foundation Model API limits. */
+export const MODEL_RATE_LIMITS_URL =
+  "https://docs.databricks.com/aws/en/machine-learning/foundation-model-apis/limits";
+
+/** Build-generated retired-model snapshot. */
+export interface RetiredModelsSnapshot {
+  readonly generatedAt: number;
+  readonly models: readonly string[];
+}
+
+/** Normalized model identities grouped by documented capability. */
+export interface ModelCapabilityCatalogue {
+  readonly responses: readonly string[];
+  readonly imageInput: readonly string[];
+  readonly applyPatch: readonly string[];
+  readonly webSearch: readonly string[];
+}
+
+/** Build-generated model-capability snapshot. */
+export interface ModelCapabilitiesSnapshot {
+  readonly generatedAt: number;
+  readonly capabilities: ModelCapabilityCatalogue;
+}
+
+/** Published pay-per-token limits for one model. */
+export interface ModelRateLimits {
+  readonly inputTokensPerMinute: number | null;
+  readonly outputTokensPerMinute: number | null;
+  readonly queriesPerHour: number | null;
+}
+
+/** Model limits keyed by normalized Databricks model identity. */
+export interface ModelRateLimitCatalogue {
+  readonly models: Readonly<Record<string, ModelRateLimits>>;
+}
+
+/** Build-generated model-rate-limit snapshot. */
+export interface ModelRateLimitsSnapshot {
+  readonly generatedAt: number;
+  readonly catalogue: ModelRateLimitCatalogue;
+}

package/src/_metadata-generator.ts

@@ -0,0 +1,199 @@
+import { load, type CheerioAPI } from "cheerio";
+
+import type {
+  ModelCapabilitiesSnapshot,
+  ModelRateLimitCatalogue,
+  ModelRateLimitsSnapshot,
+  RetiredModelsSnapshot,
+} from "./_metadata-contract.ts";
+import { modelSearchQuery } from "./policy.ts";
+
+type Selection = ReturnType<CheerioAPI>;
+
+/** Parse retired model names from Databricks retirement-policy HTML. */
+export function parseRetiredModels(html: string, generatedAt: number): RetiredModelsSnapshot {
+  const $ = load(html);
+  const models = new Set<string>();
+  $("table").each((_, table) => {
+    const rows = $(table).find("tr");
+    const header = collapseText($(rows.get(0)).find("th, td").first()).toLowerCase();
+    if (header !== "open model" && header !== "partner model") return;
+    rows.slice(1).each((__, row) => {
+      for (const name of collapseText($(row).find("th, td").first()).split("/")) {
+        const trimmed = name.trim();
+        if (trimmed) models.add(trimmed);
+      }
+    });
+  });
+  if (models.size === 0) throw new Error("Databricks retirement tables contained no model names");
+  return {
+    generatedAt,
+    models: [...models].sort((left, right) =>
+      left.localeCompare(right, "en", { sensitivity: "base" }),
+    ),
+  };
+}
+
+/** Parse Responses and web-search documentation into model capability sets. */
+export function parseModelCapabilities(
+  responsesHtml: string,
+  webSearchHtml: string,
+  generatedAt: number,
+): ModelCapabilitiesSnapshot {
+  const responsesDocument = load(responsesHtml);
+  const responses = modelsAfterHeading(responsesDocument, "databricks-hosted-foundation-models");
+  if (responses.length === 0) {
+    throw new Error("Databricks documentation contained no OpenAI Responses models");
+  }
+  const inputTypes = sectionElements(responsesDocument, "supported-input-types")
+    .map((element) => collapseText(element))
+    .join(" ")
+    .toLowerCase();
+  const inputTypeWords = new Set(inputTypes.split(/[^a-z0-9]+/).filter(Boolean));
+  const imageInput = inputTypeWords.has("text") && inputTypeWords.has("image") ? responses : [];
+  const applyPatch = codeValuesAfterHeading(responsesDocument, "limitations").includes(
+    "apply_patch",
+  )
+    ? responses
+    : [];
+  const webSearch = nativeWebSearchModels(load(webSearchHtml), responses);
+  if (webSearch.length === 0) {
+    throw new Error("Databricks documentation contained no native web-search models");
+  }
+  return {
+    generatedAt,
+    capabilities: { responses, imageInput, applyPatch, webSearch },
+  };
+}
+
+/** Parse pay-per-token limits from Databricks Foundation Model API HTML. */
+export function parseModelRateLimits(html: string, generatedAt: number): ModelRateLimitsSnapshot {
+  const $ = load(html);
+  const models: Record<string, ModelRateLimitCatalogue["models"][string]> = {};
+  $("table").each((_, table) => {
+    const rows = $(table).find("tr");
+    const headers = $(rows.get(0))
+      .find("th, td")
+      .toArray()
+      .map((cell) => collapseText($(cell)).toLowerCase());
+    const modelIndex = headers.findIndex((value) => value.includes("model"));
+    const inputIndex = headers.findIndex((value) => value.includes("itpm"));
+    const outputIndex = headers.findIndex((value) => value.includes("otpm"));
+    const queryIndex = headers.findIndex((value) => value.includes("qph"));
+    if (modelIndex < 0 || inputIndex < 0 || outputIndex < 0) return;
+    rows.slice(1).each((__, row) => {
+      const cells = $(row)
+        .find("th, td")
+        .toArray()
+        .map((cell) => collapseText($(cell)));
+      const key = modelKey(cells[modelIndex]);
+      if (!key) return;
+      models[key] = {
+        inputTokensPerMinute: number(cells[inputIndex]),
+        outputTokensPerMinute: number(cells[outputIndex]),
+        queriesPerHour: queryIndex < 0 ? null : number(cells[queryIndex]),
+      };
+    });
+  });
+  if (Object.keys(models).length === 0) {
+    throw new Error("Databricks model-limit documentation contained no models");
+  }
+  return { generatedAt, catalogue: { models: sortRecord(models) } };
+}
+
+function modelsAfterHeading($: CheerioAPI, headingId: string): string[] {
+  return [
+    ...new Set(codeValuesAfterHeading($, headingId).flatMap((value) => modelKey(value) ?? [])),
+  ].sort();
+}
+
+function nativeWebSearchModels($: CheerioAPI, responses: readonly string[]): string[] {
+  const families = new Set<string>();
+  const models = new Set<string>();
+  let nativeSection = false;
+  for (const element of sectionElements($, "supported-models")) {
+    if (headingLevel(nodeTagName(element.get(0))) !== undefined) {
+      nativeSection = !collapseText(element).toLowerCase().includes("via mcp");
+      continue;
+    }
+    if (!nativeSection) continue;
+    const values = nodeTagName(element.get(0)) === "code" ? [collapseText(element)] : [];
+    element.find("code").each((_, code) => {
+      values.push(collapseText($(code)));
+    });
+    for (const value of values) {
+      const model = modelKey(value);
+      if (!model) continue;
+      models.add(model);
+      families.add(model.split("-", 1)[0]);
+    }
+  }
+  for (const model of responses) {
+    if (families.has(model.split("-", 1)[0])) models.add(model);
+  }
+  return [...models].sort();
+}
+
+function codeValuesAfterHeading($: CheerioAPI, headingId: string): string[] {
+  const values: string[] = [];
+  for (const element of sectionElements($, headingId)) {
+    if (nodeTagName(element.get(0)) === "code") values.push(collapseText(element));
+    element.find("code").each((_, code) => {
+      values.push(collapseText($(code)));
+    });
+  }
+  return values;
+}
+
+function sectionElements($: CheerioAPI, headingId: string): Selection[] {
+  const heading = $(`#${headingId}`).first();
+  if (heading.length === 0)
+    throw new Error(`Databricks capability page is missing section ${headingId}`);
+  const level = headingLevel(nodeTagName(heading.get(0)));
+  if (level === undefined)
+    throw new Error(`Databricks capability section ${headingId} is not a heading`);
+  const elements: Selection[] = [];
+  let sibling = heading.next();
+  while (sibling.length > 0) {
+    const siblingLevel = headingLevel(nodeTagName(sibling.get(0)));
+    if (siblingLevel !== undefined && siblingLevel <= level) break;
+    elements.push(sibling);
+    sibling = sibling.next();
+  }
+  return elements;
+}
+
+function headingLevel(name: string | undefined): number | undefined {
+  const match = /^h([1-6])$/.exec(name ?? "");
+  return match ? Number(match[1]) : undefined;
+}
+
+function collapseText(element: Selection): string {
+  return element.text().split(/\s+/).filter(Boolean).join(" ");
+}
+
+function nodeTagName(node: unknown): string | undefined {
+  if (!node || typeof node !== "object" || !("tagName" in node)) return undefined;
+  return typeof node.tagName === "string" ? node.tagName : undefined;
+}
+
+function modelKey(value: string | undefined): string | undefined {
+  if (!value) return undefined;
+  let name = value.trim().replace(/\*+$/, "").trim();
+  for (const suffix of ["(Public Preview)", "(Beta)", "(Preview)"]) {
+    if (name.endsWith(suffix)) name = name.slice(0, -suffix.length).trim();
+  }
+  return modelSearchQuery(name)?.replaceAll(" ", "-");
+}
+
+function number(value: string | undefined): number | null {
+  if (!value) return null;
+  const parsed = Number(value.replaceAll(",", "").trim());
+  return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : null;
+}
+
+function sortRecord<T>(record: Readonly<Record<string, T>>): Record<string, T> {
+  return Object.fromEntries(
+    Object.entries(record).sort(([left], [right]) => left.localeCompare(right)),
+  );
+}