@aura3d/asset-index 1.0.5

package/dist/adapters/sketchfab.js

@@ -0,0 +1,183 @@
+import { normalizeLicense } from "../CanonicalAsset.js";
+/**
+ * Sketchfab Data API v3 adapter.
+ *
+ * Verified live (https://api.sketchfab.com/v3):
+ *
+ *   GET /v3/search?type=models&downloadable=true[&license=<slug>][&q=<text>]
+ *     -> { results: [{
+ *            uid, name, viewerUrl, isDownloadable,
+ *            faceCount, vertexCount,
+ *            license: { uid, label },        // e.g. label "CC0 Public Domain", "CC Attribution"
+ *            thumbnails: { images: [{ uid, size, width, height, url }] },
+ *            tags: [{ name, slug, uri }],
+ *            archives: { glb?: {...}, gltf?: {...}, ... }
+ *          }, ...], next, previous, cursors }
+ *
+ *   GET /v3/models/{uid}/download   (Authorization: Token <token>)
+ *     -> { gltf?: { url, size, expires }, usdz?: { url, size, expires }, ... }
+ *        where `url` is a SHORT-LIVED (expires ~300s) archive link. It cannot be
+ *        embedded in the index; it must be exchanged at PULL time.
+ *
+ * License model: Sketchfab's search `license` object only exposes `{ uid, label }`
+ * (no SPDX/slug), so we map the human label onto a license slug and normalize it
+ * via `normalizeLicense`. Only CC0 / CC-BY families become verified +
+ * redistributable; everything else (and any model with no/unknown license)
+ * resolves to UNVERIFIED and is never auto-pulled.
+ *
+ * Because the file URL is a token exchange resolved at pull time, the canonical
+ * `url` points at the per-model download-resolve API endpoint
+ * (`/v3/models/{uid}/download`). The CLI pull bridge must perform the
+ * `Authorization: Token <SKETCHFAB_API_TOKEN>` exchange and follow the returned
+ * temporary `gltf.url` (see integrationNotes). We mark `access:'direct-download'`
+ * ONLY when a token is present AND the license is verified/redistributable;
+ * otherwise `access:'deep-link-only'` with the Sketchfab model page as sourcePage.
+ */
+const API_BASE = "https://api.sketchfab.com/v3";
+/** Default page size for a search fan-out. */
+const SEARCH_COUNT = 24;
+/**
+ * Map a Sketchfab license LABEL (the only stable text the search API exposes)
+ * onto a string `normalizeLicense` recognizes. Anything outside the CC0 / CC-BY
+ * families is left as the raw label so it normalizes to UNVERIFIED.
+ */
+function licenseKeyFromLabel(label) {
+    if (!label)
+        return undefined;
+    const l = label.toLowerCase();
+    if (l.includes("cc0") || l.includes("public domain"))
+        return "CC0";
+    // "CC Attribution" (and only Attribution) maps to plain CC-BY; the
+    // ShareAlike / NoDerivs / NonCommercial variants intentionally fall through
+    // to their raw label and become UNVERIFIED (not freely redistributable here).
+    if (l === "cc attribution" || l === "cc-by" || l === "cc by")
+        return "CC-BY";
+    return label;
+}
+function tokenize(text) {
+    return text
+        .replace(/[_-]+/g, " ")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+/** Map our constraint license families to Sketchfab `license` query slugs. */
+function licenseSlugs(constraints) {
+    const fams = constraints?.license;
+    if (!fams || fams.length === 0)
+        return [];
+    const slugs = [];
+    for (const fam of fams) {
+        if (fam === "CC0")
+            slugs.push("cc0");
+        else if (fam === "CC-BY")
+            slugs.push("by");
+    }
+    return slugs;
+}
+function buildSearchUrl(query) {
+    const params = new URLSearchParams();
+    params.set("type", "models");
+    params.set("downloadable", "true");
+    params.set("count", String(SEARCH_COUNT));
+    const text = query.text.trim();
+    if (text)
+        params.set("q", text);
+    // Sketchfab accepts repeated `license` params; restrict server-side when the
+    // caller already constrained to specific redistributable families.
+    for (const slug of licenseSlugs(query.constraints)) {
+        params.append("license", slug);
+    }
+    return `${API_BASE}/search?${params.toString()}`;
+}
+function bestThumbnail(thumbs) {
+    const images = thumbs?.images;
+    if (!images || images.length === 0)
+        return undefined;
+    let best;
+    for (const img of images) {
+        if (!img?.url)
+            continue;
+        if (!best || (img.size ?? 0) > (best.size ?? 0))
+            best = img;
+    }
+    return best?.url;
+}
+function toCanonical(model, hasToken) {
+    if (!model.uid || model.isDownloadable === false)
+        return null;
+    const sourcePage = model.viewerUrl ?? `https://sketchfab.com/3d-models/${model.uid}`;
+    const license = normalizeLicense(licenseKeyFromLabel(model.license?.label), sourcePage);
+    // The file URL is a short-lived token exchange resolved at PULL time, so the
+    // canonical url is the download-resolve API endpoint. It is only a real
+    // "direct-download" when we actually hold a token AND the license permits it.
+    const canResolve = hasToken && license.verified && license.redistributable;
+    const access = canResolve ? "direct-download" : "deep-link-only";
+    const url = canResolve
+        ? `${API_BASE}/models/${model.uid}/download`
+        : sourcePage;
+    const title = model.name ?? model.uid;
+    const tagNames = (model.tags ?? [])
+        .map((t) => t?.name)
+        .filter((n) => typeof n === "string" && n.length > 0)
+        .flatMap((n) => tokenize(n));
+    const tags = Array.from(new Set([...tokenize(title), ...tagNames]));
+    return {
+        id: `sketchfab:${model.uid}`,
+        source: "sketchfab",
+        title,
+        description: model.description,
+        url,
+        access,
+        // glTF-archive downloads default to .glb when resolved by the bridge.
+        format: "glb",
+        license,
+        thumbnailUrl: bestThumbnail(model.thumbnails),
+        likeCount: typeof model.likeCount === "number" ? model.likeCount : undefined,
+        viewCount: typeof model.viewCount === "number" ? model.viewCount : undefined,
+        triangles: typeof model.faceCount === "number" ? model.faceCount : undefined,
+        tags,
+        sourcePage,
+        attribution: model.user?.displayName ?? model.user?.username,
+    };
+}
+export function createSketchfabAdapter(options = {}) {
+    // Resolve token presence once at construction. Absent token => degrade
+    // gracefully: search() returns [] without throwing. Present token only
+    // upgrades redistributable models to direct-download (the actual exchange
+    // happens later in the CLI pull bridge). An explicit option lets the Cloudflare
+    // Worker pass its secret binding without depending on `process.env`.
+    const envToken = typeof process !== "undefined" ? process.env?.SKETCHFAB_API_TOKEN : undefined;
+    const token = (options.token ?? envToken)?.trim();
+    const hasToken = typeof token === "string" && token.length > 0;
+    const maxPages = Math.max(1, options.maxPages ?? 1);
+    const throttleMs = Math.max(0, options.throttleMs ?? 0);
+    return {
+        id: "sketchfab",
+        label: "Sketchfab (downloadable, CC-licensed)",
+        async search(query, ctx) {
+            if (!hasToken) {
+                // No API token: cannot resolve downloads, so contribute nothing rather
+                // than surfacing deep-links we can never auto-pull.
+                return [];
+            }
+            const assets = [];
+            let url = buildSearchUrl(query);
+            for (let page = 0; page < maxPages && url; page++) {
+                if (page > 0 && throttleMs)
+                    await new Promise((r) => setTimeout(r, throttleMs));
+                const raw = (await ctx.fetchJson(url));
+                for (const model of raw?.results ?? []) {
+                    if (model && typeof model.uid === "string") {
+                        const canonical = toCanonical(model, hasToken);
+                        if (canonical)
+                            assets.push(canonical);
+                    }
+                }
+                url = raw?.next; // cursor to the next page
+            }
+            return assets;
+        },
+    };
+}
+//# sourceMappingURL=sketchfab.js.map

package/dist/adapters/sketchfab.js.map

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

package/dist/embedding.d.ts

@@ -0,0 +1,56 @@
+import type { AuraCanonicalAsset } from "./CanonicalAsset.js";
+/**
+ * Semantic-search upgrade seam over the keyword baseline in `ranking.ts`.
+ *
+ * The federation layer scores assets through a single seam (`scoreAsset`); this
+ * module provides the vector-embedding alternative the comment there promises.
+ * Everything here is dependency-free and fully deterministic: the default
+ * provider hashes tokens into a fixed-size vector, so the same text always
+ * yields the same embedding with no network, keys, randomness, or wall-clock
+ * time involved.
+ */
+/** Pluggable text embedder. Implementations must be deterministic per input. */
+export interface EmbeddingProvider {
+    /** Embed each input string into a numeric vector of uniform dimension. */
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+/** Default embedding dimensionality for {@link LocalHashEmbedding}. */
+export declare const DEFAULT_EMBEDDING_DIMS = 256;
+/**
+ * Deterministic, dependency-free bag-of-words embedding.
+ *
+ * Each token is hashed into one of `dims` buckets and summed (sign derived from
+ * a second hash bit so unrelated tokens do not all push in the same direction),
+ * then the vector is L2-normalized. Identical text -> identical vector; cosine
+ * similarity of identical text is exactly 1.
+ */
+export declare class LocalHashEmbedding implements EmbeddingProvider {
+    readonly dims: number;
+    constructor(dims?: number);
+    private embedOne;
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+/**
+ * Cosine similarity of two equal-length vectors. Returns 0 when either vector
+ * is all zeros or lengths differ. For L2-normalized vectors this equals the dot
+ * product, but we recompute norms so it is correct for any input.
+ */
+export declare function cosineSimilarity(a: readonly number[], b: readonly number[]): number;
+/**
+ * Canonical text used to embed an asset: title, tags, then description. This is
+ * the same field set the ranking baseline scores against, concatenated so a
+ * bag-of-words embedding can capture all of them.
+ */
+export declare function assetEmbeddingText(asset: AuraCanonicalAsset): string;
+/**
+ * Rank assets against a query by cosine similarity of their embeddings.
+ *
+ * Embeds the query and every asset's {@link assetEmbeddingText} in one batched
+ * call to the provider, then sorts descending by score. Ties break by asset id
+ * so the ordering is stable and deterministic.
+ */
+export declare function embeddingRanker(provider: EmbeddingProvider, query: string, assets: readonly AuraCanonicalAsset[]): Promise<{
+    asset: AuraCanonicalAsset;
+    score: number;
+}[]>;
+//# sourceMappingURL=embedding.d.ts.map

package/dist/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../../../packages/asset-index/src/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACtD;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AA4B1C;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,GAAE,MAA+B;IAIjD,OAAO,CAAC,QAAQ;IAYV,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAG3D;AAWD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAanF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAIpE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,OAAO,CAAC;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAiBzD"}

package/dist/embedding.js

@@ -0,0 +1,121 @@
+/** Default embedding dimensionality for {@link LocalHashEmbedding}. */
+export const DEFAULT_EMBEDDING_DIMS = 256;
+/**
+ * Lowercase a string and split it into alphanumeric tokens, dropping single
+ * characters (matching the keyword baseline's `queryTerms`).
+ */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+/**
+ * Deterministic 32-bit FNV-1a hash of a string. Pure function of its input;
+ * no randomness or platform-dependent behavior.
+ */
+function fnv1a(token) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < token.length; i++) {
+        hash ^= token.charCodeAt(i);
+        // FNV prime multiply via shifts to stay in 32-bit unsigned range.
+        hash = Math.imul(hash, 0x01000193);
+    }
+    // Coerce to unsigned 32-bit.
+    return hash >>> 0;
+}
+/**
+ * Deterministic, dependency-free bag-of-words embedding.
+ *
+ * Each token is hashed into one of `dims` buckets and summed (sign derived from
+ * a second hash bit so unrelated tokens do not all push in the same direction),
+ * then the vector is L2-normalized. Identical text -> identical vector; cosine
+ * similarity of identical text is exactly 1.
+ */
+export class LocalHashEmbedding {
+    dims;
+    constructor(dims = DEFAULT_EMBEDDING_DIMS) {
+        this.dims = dims > 0 ? Math.floor(dims) : DEFAULT_EMBEDDING_DIMS;
+    }
+    embedOne(text) {
+        const vec = new Array(this.dims).fill(0);
+        for (const token of tokenize(text)) {
+            const h = fnv1a(token);
+            const bucket = h % this.dims;
+            // Use a high bit as a stable sign so collisions are less likely to align.
+            const sign = (h & 0x80000000) !== 0 ? -1 : 1;
+            vec[bucket] += sign;
+        }
+        return l2Normalize(vec);
+    }
+    async embed(texts) {
+        return texts.map((t) => this.embedOne(t));
+    }
+}
+/** L2-normalize a vector in place-safe fashion; zero vectors stay zero. */
+function l2Normalize(vec) {
+    let sumSq = 0;
+    for (const v of vec)
+        sumSq += v * v;
+    const norm = Math.sqrt(sumSq);
+    if (norm === 0)
+        return vec;
+    return vec.map((v) => v / norm);
+}
+/**
+ * Cosine similarity of two equal-length vectors. Returns 0 when either vector
+ * is all zeros or lengths differ. For L2-normalized vectors this equals the dot
+ * product, but we recompute norms so it is correct for any input.
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0)
+        return 0;
+    return dot / denom;
+}
+/**
+ * Canonical text used to embed an asset: title, tags, then description. This is
+ * the same field set the ranking baseline scores against, concatenated so a
+ * bag-of-words embedding can capture all of them.
+ */
+export function assetEmbeddingText(asset) {
+    const parts = [asset.title, asset.tags.join(" ")];
+    if (asset.description)
+        parts.push(asset.description);
+    return parts.join(" ");
+}
+/**
+ * Rank assets against a query by cosine similarity of their embeddings.
+ *
+ * Embeds the query and every asset's {@link assetEmbeddingText} in one batched
+ * call to the provider, then sorts descending by score. Ties break by asset id
+ * so the ordering is stable and deterministic.
+ */
+export async function embeddingRanker(provider, query, assets) {
+    if (assets.length === 0)
+        return [];
+    const texts = [query, ...assets.map((a) => assetEmbeddingText(a))];
+    const vectors = await provider.embed(texts);
+    const queryVec = vectors[0];
+    const scored = assets.map((asset, i) => ({
+        asset,
+        score: cosineSimilarity(queryVec, vectors[i + 1]),
+    }));
+    scored.sort((x, y) => {
+        if (y.score !== x.score)
+            return y.score - x.score;
+        return x.asset.id < y.asset.id ? -1 : x.asset.id > y.asset.id ? 1 : 0;
+    });
+    return scored;
+}
+//# sourceMappingURL=embedding.js.map

package/dist/embedding.js.map

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

package/dist/federate.d.ts

@@ -0,0 +1,56 @@
+import type { AuraCanonicalAsset } from "./CanonicalAsset.js";
+import type { FetchJson, ResolveQuery, SourceAdapter } from "./SourceAdapter.js";
+export interface ResolveCandidate {
+    readonly asset: AuraCanonicalAsset;
+    readonly score: number;
+}
+export interface ResolveResult {
+    readonly query: ResolveQuery;
+    readonly candidates: readonly ResolveCandidate[];
+    /** Non-fatal per-source failures, so a dead source is visible, not silent. */
+    readonly warnings: readonly string[];
+}
+/**
+ * Optional ranking seam. When provided, it replaces the default keyword
+ * `scoreAsset` ordering with a custom (e.g. semantic-embedding) ranker. It
+ * receives the constraint-filtered candidate pool and returns each asset paired
+ * with a score, already ordered best-first. The resolver consumes that order
+ * directly. See `embeddingRanker` in `embedding.ts` for the default semantic
+ * implementation (partially apply its `provider` to match this signature).
+ */
+export type Ranker = (query: string, assets: readonly AuraCanonicalAsset[]) => Promise<{
+    asset: AuraCanonicalAsset;
+    score: number;
+}[]>;
+export interface FederatedResolverOptions {
+    readonly adapters: readonly SourceAdapter[];
+    readonly fetchJson?: FetchJson;
+    /** Max candidates returned after ranking. Default 10. */
+    readonly limit?: number;
+    /**
+     * Optional ranking override. Defaults to the keyword `scoreAsset` path when
+     * undefined, preserving existing behavior exactly.
+     */
+    readonly ranker?: Ranker;
+}
+/**
+ * Federates a query across every configured source adapter in parallel,
+ * normalizes + constraint-filters + ranks the merged pool, and returns the top
+ * candidates. A source that throws contributes a warning instead of failing the
+ * whole resolve — federation degrades, it does not collapse.
+ */
+export declare class FederatedResolver {
+    private readonly adapters;
+    private readonly ctx;
+    private readonly limit;
+    private readonly ranker?;
+    constructor(options: FederatedResolverOptions);
+    resolve(query: ResolveQuery): Promise<ResolveResult>;
+    /**
+     * Rank the filtered pool through an injected ranker, consuming its returned
+     * order directly. Ties are re-broken by id so the ordering stays stable and
+     * deterministic even if the ranker leaves equal scores unordered.
+     */
+    private rankWith;
+}
+//# sourceMappingURL=federate.d.ts.map

package/dist/federate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federate.d.ts","sourceRoot":"","sources":["../../../../packages/asset-index/src/federate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAEV,SAAS,EACT,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,GAAG,CACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,kBAAkB,EAAE,KAClC,OAAO,CAAC;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,OAAO,EAAE,wBAAwB;IAOvC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAoC1D;;;;OAIG;YACW,QAAQ;CAYvB"}

package/dist/federate.js

@@ -0,0 +1,80 @@
+import { defaultFetchJson } from "./SourceAdapter.js";
+import { matchesConstraints, scoreAsset } from "./ranking.js";
+/**
+ * Federates a query across every configured source adapter in parallel,
+ * normalizes + constraint-filters + ranks the merged pool, and returns the top
+ * candidates. A source that throws contributes a warning instead of failing the
+ * whole resolve — federation degrades, it does not collapse.
+ */
+export class FederatedResolver {
+    adapters;
+    ctx;
+    limit;
+    ranker;
+    constructor(options) {
+        this.adapters = options.adapters;
+        this.ctx = { fetchJson: options.fetchJson ?? defaultFetchJson };
+        this.limit = options.limit ?? 10;
+        this.ranker = options.ranker;
+    }
+    async resolve(query) {
+        const warnings = [];
+        const perAdapter = await Promise.all(this.adapters.map(async (adapter) => {
+            try {
+                return await adapter.search(query, this.ctx);
+            }
+            catch (err) {
+                warnings.push(`${adapter.id}: ${err.message}`);
+                return [];
+            }
+        }));
+        // Dedupe by id and apply constraint filtering once; both the keyword and the
+        // injected-ranker paths rank over this same filtered pool.
+        const seen = new Set();
+        const pool = [];
+        for (const asset of perAdapter.flat()) {
+            if (seen.has(asset.id))
+                continue;
+            seen.add(asset.id);
+            if (!matchesConstraints(asset, query.constraints))
+                continue;
+            pool.push(asset);
+        }
+        const candidates = this.ranker
+            ? await this.rankWith(this.ranker, query.text, pool)
+            : rankByKeyword(query.text, pool);
+        return {
+            query,
+            candidates: candidates.slice(0, this.limit),
+            warnings,
+        };
+    }
+    /**
+     * Rank the filtered pool through an injected ranker, consuming its returned
+     * order directly. Ties are re-broken by id so the ordering stays stable and
+     * deterministic even if the ranker leaves equal scores unordered.
+     */
+    async rankWith(ranker, text, pool) {
+        const ranked = await ranker(text, pool);
+        const candidates = ranked.map(({ asset, score }) => ({ asset, score }));
+        candidates.sort((a, b) => b.score - a.score || a.asset.id.localeCompare(b.asset.id));
+        return candidates;
+    }
+}
+/**
+ * Default keyword ranking: score via `scoreAsset`, drop zero-score assets, and
+ * order by score descending with an id tie-break for determinism. This preserves
+ * the resolver's pre-seam behavior exactly.
+ */
+function rankByKeyword(text, pool) {
+    const candidates = [];
+    for (const asset of pool) {
+        const score = scoreAsset(asset, text);
+        if (score <= 0)
+            continue;
+        candidates.push({ asset, score });
+    }
+    candidates.sort((a, b) => b.score - a.score || a.asset.id.localeCompare(b.asset.id));
+    return candidates;
+}
+//# sourceMappingURL=federate.js.map

package/dist/federate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @aura3d/asset-index
+ *
+ * Live federated search over the free GLB/glTF universe. Source adapters
+ * normalize each library's native catalog into one {@link AuraCanonicalAsset}
+ * shape; the {@link FederatedResolver} fans a natural-language query across them,
+ * constraint-filters, ranks, and returns auto-pullable candidates.
+ *
+ * This package is the catalog. It is intentionally separate from `@aura3d/engine`
+ * (which stays a pipeline): the engine's prompt-plan `subject.intent` seam calls
+ * a resolver from here, and the CLI pulls a chosen candidate through the normal
+ * `assets add` flow.
+ */
+export type { AuraCanonicalAsset, AuraAssetLicense, AuraAssetLicenseSpdx, AuraAssetFormat, AuraAssetAccess, AuraAssetBounds, } from "./CanonicalAsset.js";
+export { isAutoPullable, normalizeLicense } from "./CanonicalAsset.js";
+export type { SourceAdapter, AdapterContext, AdapterRefreshResult, FetchJson, ResolveQuery, ResolveConstraints, } from "./SourceAdapter.js";
+export { defaultFetchJson } from "./SourceAdapter.js";
+export { scoreAsset, matchesConstraints } from "./ranking.js";
+export type { ResolveCandidate, ResolveResult, FederatedResolverOptions, } from "./federate.js";
+export { FederatedResolver } from "./federate.js";
+export { createKhronosAdapter } from "./adapters/khronos.js";
+export { createOS3AAdapter } from "./adapters/os3a.js";
+export { createPolyHavenAdapter } from "./adapters/poly-haven.js";
+export { createPolyPizzaAdapter } from "./adapters/poly-pizza.js";
+export type { PolyPizzaAdapterOptions } from "./adapters/poly-pizza.js";
+export { createSketchfabAdapter } from "./adapters/sketchfab.js";
+export type { SketchfabAdapterOptions } from "./adapters/sketchfab.js";
+export { createMarketplaceDeepLinkAdapter } from "./adapters/marketplace.js";
+export { createJsDelivrMirrorAdapter } from "./adapters/jsdelivr-mirror.js";
+export type { JsDelivrMirrorOptions } from "./adapters/jsdelivr-mirror.js";
+export { createAuraIndexAdapter } from "./adapters/aura-index.js";
+export type { AuraIndexAdapterOptions } from "./adapters/aura-index.js";
+export { IndexStore, INDEX_STORE_SCHEMA } from "./IndexStore.js";
+export type { IndexStoreFile } from "./IndexStore.js";
+export { refreshIndex } from "./refresh.js";
+export type { RefreshResult, RefreshOptions, WritableAssetIndex } from "./refresh.js";
+export { LocalHashEmbedding, cosineSimilarity, assetEmbeddingText, embeddingRanker, DEFAULT_EMBEDDING_DIMS, } from "./embedding.js";
+export type { EmbeddingProvider } from "./embedding.js";
+import type { SourceAdapter } from "./SourceAdapter.js";
+/**
+ * The zero-auth, verified source adapters available today.
+ *
+ * These are the no-key, redistributable-by-default sources safe to run in the
+ * auto-pull federation pass. Key-gated sources (Sketchfab, Poly Pizza) and the
+ * discovery-only marketplace deep-link adapter are intentionally excluded — they
+ * are opt-in, not auto-pull sources.
+ *
+ * `createJsDelivrMirrorAdapter` surfaces CC0 GLBs that the extraction pipeline
+ * mirrored from ZIP-pack sources (Kenney, Quaternius, curated OpenGameArt) into
+ * the public mirror repo, served free via jsDelivr.
+ */
+export declare function defaultAdapters(): SourceAdapter[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/asset-index/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,YAAY,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE9D,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAOjD"}

package/dist/index.js

@@ -0,0 +1,53 @@
+/**
+ * @aura3d/asset-index
+ *
+ * Live federated search over the free GLB/glTF universe. Source adapters
+ * normalize each library's native catalog into one {@link AuraCanonicalAsset}
+ * shape; the {@link FederatedResolver} fans a natural-language query across them,
+ * constraint-filters, ranks, and returns auto-pullable candidates.
+ *
+ * This package is the catalog. It is intentionally separate from `@aura3d/engine`
+ * (which stays a pipeline): the engine's prompt-plan `subject.intent` seam calls
+ * a resolver from here, and the CLI pulls a chosen candidate through the normal
+ * `assets add` flow.
+ */
+export { isAutoPullable, normalizeLicense } from "./CanonicalAsset.js";
+export { defaultFetchJson } from "./SourceAdapter.js";
+export { scoreAsset, matchesConstraints } from "./ranking.js";
+export { FederatedResolver } from "./federate.js";
+export { createKhronosAdapter } from "./adapters/khronos.js";
+export { createOS3AAdapter } from "./adapters/os3a.js";
+export { createPolyHavenAdapter } from "./adapters/poly-haven.js";
+export { createPolyPizzaAdapter } from "./adapters/poly-pizza.js";
+export { createSketchfabAdapter } from "./adapters/sketchfab.js";
+export { createMarketplaceDeepLinkAdapter } from "./adapters/marketplace.js";
+export { createJsDelivrMirrorAdapter } from "./adapters/jsdelivr-mirror.js";
+export { createAuraIndexAdapter } from "./adapters/aura-index.js";
+export { IndexStore, INDEX_STORE_SCHEMA } from "./IndexStore.js";
+export { refreshIndex } from "./refresh.js";
+export { LocalHashEmbedding, cosineSimilarity, assetEmbeddingText, embeddingRanker, DEFAULT_EMBEDDING_DIMS, } from "./embedding.js";
+import { createKhronosAdapter } from "./adapters/khronos.js";
+import { createOS3AAdapter } from "./adapters/os3a.js";
+import { createPolyHavenAdapter } from "./adapters/poly-haven.js";
+import { createJsDelivrMirrorAdapter } from "./adapters/jsdelivr-mirror.js";
+/**
+ * The zero-auth, verified source adapters available today.
+ *
+ * These are the no-key, redistributable-by-default sources safe to run in the
+ * auto-pull federation pass. Key-gated sources (Sketchfab, Poly Pizza) and the
+ * discovery-only marketplace deep-link adapter are intentionally excluded — they
+ * are opt-in, not auto-pull sources.
+ *
+ * `createJsDelivrMirrorAdapter` surfaces CC0 GLBs that the extraction pipeline
+ * mirrored from ZIP-pack sources (Kenney, Quaternius, curated OpenGameArt) into
+ * the public mirror repo, served free via jsDelivr.
+ */
+export function defaultAdapters() {
+    return [
+        createKhronosAdapter(),
+        createOS3AAdapter(),
+        createPolyHavenAdapter(),
+        createJsDelivrMirrorAdapter(),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/asset-index/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAUvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAO9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,oBAAoB,EAAE;QACtB,iBAAiB,EAAE;QACnB,sBAAsB,EAAE;QACxB,2BAA2B,EAAE;KAC9B,CAAC;AACJ,CAAC"}