@aura3d/cli 1.3.3 → 1.4.0

package/dist/pull-bridge/scoring.js

@@ -0,0 +1,177 @@
+import { isPositiveVector3 } from "./vector3.js";
+export function scoreResolveCandidate(candidate, options = {}) {
+    const asset = candidate.asset;
+    const reasons = [];
+    const penalties = [];
+    const query = options.query ?? "";
+    const semantic = scoreSignal(candidate.score, 12) +
+        scoreSignal(asset.semanticScore, 8) +
+        scoreSignal(asset.workerScore, 4) +
+        scoreSignal(asset.qualityScore, 4);
+    if (semantic > 0)
+        reasons.push(`semantic/source score ${roundScore(semantic)}`);
+    let sourceQuality = 0;
+    if (asset.sourcePage) {
+        sourceQuality += 6;
+        reasons.push("source page preserved");
+    }
+    else {
+        penalties.push("missing source page");
+    }
+    if (asset.downloadUrl ?? asset.url) {
+        sourceQuality += 5;
+        reasons.push("download URL preserved");
+    }
+    else {
+        penalties.push("missing download URL");
+    }
+    if (asset.author ?? asset.attribution) {
+        sourceQuality += 4;
+        reasons.push("author/attribution preserved");
+    }
+    else {
+        penalties.push("missing author/attribution");
+    }
+    if (asset.sourceFamily ?? asset.source)
+        sourceQuality += 3;
+    if (asset.retrievedAt)
+        sourceQuality += 2;
+    if (asset.rawCatalogMetadata)
+        sourceQuality += 2;
+    let license = 0;
+    if (asset.license.verified && asset.license.redistributable) {
+        license += 10;
+        reasons.push(`verified ${asset.license.spdx} license`);
+    }
+    else {
+        penalties.push("license is not verified redistributable");
+    }
+    if (asset.licenseName ?? asset.license.raw)
+        license += 3;
+    if (asset.licenseUrl ?? asset.license.sourcePage)
+        license += 4;
+    else
+        penalties.push("missing license URL/source evidence");
+    let inspection = 0;
+    const boundsSize = asset.bounds?.size ?? asset.dimensions;
+    if (isPositiveVector3(boundsSize)) {
+        inspection += 6;
+        reasons.push("bounds/dimensions metadata preserved");
+    }
+    else {
+        penalties.push("missing bounds/dimensions metadata");
+    }
+    const triangles = asset.triangleCount ?? asset.triangles;
+    if (typeof triangles === "number" && Number.isFinite(triangles) && triangles > 0)
+        inspection += 3;
+    if (typeof asset.meshCount === "number" && asset.meshCount > 0)
+        inspection += 3;
+    if (typeof asset.materialCount === "number" && asset.materialCount > 0)
+        inspection += 4;
+    else if (expectsVisualMaterials(asset, query))
+        penalties.push("missing material metadata for visual model role");
+    if (typeof asset.textureCount === "number" && asset.textureCount > 0)
+        inspection += 4;
+    else if (expectsTextureEvidence(asset, query))
+        penalties.push("missing texture metadata for visual model role");
+    const clipCount = asset.animationClipCount ?? asset.animationClips?.length;
+    if (typeof clipCount === "number" && clipCount > 0)
+        inspection += 2;
+    if (typeof asset.skinCount === "number" && asset.skinCount > 0)
+        inspection += 2;
+    if (typeof asset.morphTargetCount === "number" && asset.morphTargetCount > 0)
+        inspection += 1;
+    let roleFit = 0;
+    if (asset.intendedRole && asset.intendedRole !== "unknown") {
+        roleFit += 4;
+        reasons.push(`intended role ${asset.intendedRole}`);
+    }
+    const queryRole = inferQueryRole(query, options.profile);
+    if (queryRole && asset.intendedRole === queryRole) {
+        roleFit += 8;
+        reasons.push(`role matches query (${queryRole})`);
+    }
+    else if (queryRole && asset.intendedRole && asset.intendedRole !== "unknown") {
+        penalties.push(`role mismatch: wanted ${queryRole}, got ${asset.intendedRole}`);
+    }
+    if (asset.roleSuitability && asset.roleSuitability.trim().length >= 16)
+        roleFit += 3;
+    else if (asset.intendedRole && asset.intendedRole !== "abstract")
+        penalties.push("missing role suitability explanation");
+    if (asset.qualityWarnings && asset.qualityWarnings.length > 0) {
+        for (const warning of asset.qualityWarnings)
+            penalties.push(`catalog warning: ${warning}`);
+    }
+    if (asset.duplicateHash && !asset.duplicateOkReason)
+        penalties.push(`duplicate hash ${asset.duplicateHash} lacks allowlist reason`);
+    const penaltyCost = penalties.reduce((total, penalty) => {
+        if (penalty.includes("duplicate hash"))
+            return total + 40;
+        if (penalty.includes("license"))
+            return total + 20;
+        if (penalty.includes("missing source page"))
+            return total + 8;
+        if (penalty.includes("missing material") || penalty.includes("missing texture"))
+            return total + 6;
+        if (penalty.includes("role mismatch"))
+            return total + 6;
+        return total + 3;
+    }, 0);
+    const total = Math.max(0, semantic + sourceQuality + license + inspection + roleFit - penaltyCost);
+    return {
+        total: roundScore(total),
+        semantic: roundScore(semantic),
+        sourceQuality: roundScore(sourceQuality),
+        license: roundScore(license),
+        inspection: roundScore(inspection),
+        roleFit: roundScore(roleFit),
+        penalties,
+        reasons,
+    };
+}
+export function rankResolveCandidates(candidates, options = {}) {
+    return [...candidates].sort((a, b) => {
+        const aScore = scoreResolveCandidate(a, options);
+        const bScore = scoreResolveCandidate(b, options);
+        return bScore.total - aScore.total || b.score - a.score || a.asset.id.localeCompare(b.asset.id);
+    });
+}
+function scoreSignal(value, scale) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0)
+        return 0;
+    if (value <= 1)
+        return value * scale;
+    if (value <= 100)
+        return (value / 100) * scale;
+    return scale;
+}
+function roundScore(value) {
+    return Math.round(value * 100) / 100;
+}
+function expectsVisualMaterials(asset, query) {
+    const role = asset.intendedRole ?? inferQueryRole(query);
+    return role !== "abstract" && role !== "debug";
+}
+function expectsTextureEvidence(asset, query) {
+    const role = asset.intendedRole ?? inferQueryRole(query);
+    return role === "character" || role === "vehicle" || role === "track" || role === "world" || role === "environment" || role === "product" || role === "weapon";
+}
+function inferQueryRole(query, profile) {
+    if (profile === "fighting-character" || profile === "animation-character")
+        return "character";
+    const text = query.toLowerCase();
+    if (/\b(character|avatar|runner|humanoid|person|hero|fighter|enemy|npc)\b/.test(text))
+        return "character";
+    if (/\b(car|vehicle|truck|ship|plane|drone|kart|race)\b/.test(text))
+        return "vehicle";
+    if (/\b(track|circuit|road|raceway)\b/.test(text))
+        return "track";
+    if (/\b(world|level|map|environment|scene|arena)\b/.test(text))
+        return "world";
+    if (/\b(product|phone|shoe|sneaker|watch|commerce)\b/.test(text))
+        return "product";
+    if (/\b(weapon|gun|sword|blade)\b/.test(text))
+        return "weapon";
+    return undefined;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/pull-bridge/scoring.js.map

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

package/dist/pull-bridge/search.d.ts

@@ -0,0 +1,39 @@
+import type { AuraCanonicalAsset, FederatedResolver as FederatedResolverType, ResolveCandidate, SourceAdapter } from "@aura3d/asset-index";
+import type { CliAssetSearchProfile, CliResolveConstraints } from "./types.js";
+export interface SearchOptions {
+    readonly query: string;
+    readonly constraints?: CliResolveConstraints;
+    readonly limit?: number;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly makeResolver?: (adapters: readonly SourceAdapter[]) => FederatedResolverType;
+}
+export interface SearchCandidateLine {
+    readonly id: string;
+    readonly source: string;
+    readonly title: string;
+    readonly license: string;
+    readonly autoPullable: boolean;
+    readonly access: AuraCanonicalAsset["access"];
+    readonly sourcePage?: string;
+    readonly profile?: {
+        readonly name: Exclude<CliAssetSearchProfile, "general">;
+        readonly suitable: boolean;
+        readonly rejectionReasons: readonly string[];
+        readonly warnings: readonly string[];
+        readonly validationHooks: readonly string[];
+    };
+}
+export interface SearchReport {
+    readonly ok: boolean;
+    readonly query: string;
+    readonly profile: CliAssetSearchProfile;
+    readonly candidates: readonly SearchCandidateLine[];
+    readonly rejectedCandidates: readonly SearchCandidateLine[];
+    readonly deepLinks: readonly SearchCandidateLine[];
+    readonly warnings: readonly string[];
+    readonly messages: readonly string[];
+}
+export declare function toLine(candidate: ResolveCandidate, profile?: CliAssetSearchProfile): SearchCandidateLine;
+export declare function makeDefaultResolver(adapters: readonly SourceAdapter[], limit: number): FederatedResolverType;
+export declare function runSearch(options: SearchOptions): Promise<SearchReport>;
+//# sourceMappingURL=search.d.ts.map

package/dist/pull-bridge/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,IAAI,qBAAqB,EAC1C,gBAAgB,EAEhB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAW7B,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,KAAK,qBAAqB,CAAC;CACvF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;QACzD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QACrC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,MAAM,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,GAAE,qBAAiC,GAAG,mBAAmB,CA+BnH;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,KAAK,EAAE,MAAM,GACZ,qBAAqB,CAEvB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA6F7E"}

package/dist/pull-bridge/search.js

@@ -0,0 +1,114 @@
+import * as assetIndex from "@aura3d/asset-index";
+import { buildDeepLinkAdapter, buildSearchAdapters, } from "./adapters.js";
+import { evaluateAssetProfile, rankForProfile, toResolveConstraints, } from "./profiles.js";
+import { rankResolveCandidates } from "./scoring.js";
+const { FederatedResolver, isAutoPullable } = assetIndex;
+export function toLine(candidate, profile = "general") {
+    const { asset } = candidate;
+    const line = {
+        id: asset.id,
+        source: asset.source,
+        title: asset.title,
+        license: asset.license.spdx,
+        autoPullable: isAutoPullable(asset),
+        access: asset.access,
+    };
+    if (asset.sourcePage)
+        line.sourcePage = asset.sourcePage;
+    if (profile !== "general") {
+        const evaluation = evaluateAssetProfile(asset, profile);
+        line.profile = {
+            name: profile,
+            suitable: evaluation.suitable,
+            rejectionReasons: evaluation.rejectionReasons,
+            warnings: evaluation.warnings,
+            validationHooks: evaluation.validationHooks ?? [],
+        };
+    }
+    return line;
+}
+export function makeDefaultResolver(adapters, limit) {
+    return new FederatedResolver({ adapters, limit });
+}
+export async function runSearch(options) {
+    const env = options.env ?? process.env;
+    const limit = options.limit ?? 10;
+    const adapters = buildSearchAdapters(env);
+    const resolver = options.makeResolver
+        ? options.makeResolver(adapters)
+        : makeDefaultResolver(adapters, limit);
+    const constraints = toResolveConstraints(options.constraints ?? {}, false);
+    const profile = options.constraints?.profile ?? "general";
+    const result = await resolver.resolve({
+        text: options.query,
+        constraints,
+    });
+    const rankedCandidates = rankResolveCandidates(rankForProfile(result.candidates, profile), {
+        query: options.query,
+        profile,
+    });
+    const candidateLines = rankedCandidates.map((candidate) => toLine(candidate, profile));
+    const candidates = profile !== "general"
+        ? candidateLines.filter((candidate) => candidate.profile?.suitable === true)
+        : candidateLines;
+    const rejectedCandidates = profile !== "general"
+        ? candidateLines.filter((candidate) => candidate.profile?.suitable !== true)
+        : [];
+    const anyPullable = candidates.some((c) => c.autoPullable);
+    const anyProfileSuitable = profile === "general" || candidates.some((c) => c.profile?.suitable);
+    const anyProfilePullable = profile === "general" || candidates.some((c) => c.autoPullable && c.profile?.suitable);
+    const warnings = [...result.warnings];
+    if (profile !== "general") {
+        for (const candidate of candidateLines) {
+            for (const warning of candidate.profile?.warnings ?? []) {
+                warnings.push(`${candidate.id}: ${warning}`);
+            }
+        }
+    }
+    let deepLinks = [];
+    if (!anyPullable) {
+        const deepLinkAdapter = buildDeepLinkAdapter();
+        if (deepLinkAdapter) {
+            try {
+                const records = await deepLinkAdapter.search({ text: options.query, constraints: {} }, { fetchJson: assetIndex.defaultFetchJson });
+                deepLinks = records.map((asset) => toLine({ asset, score: 0 }));
+            }
+            catch (err) {
+                warnings.push(`${deepLinkAdapter.id}: ${err.message}`);
+            }
+        }
+    }
+    const messages = [];
+    if (candidateLines.length === 0) {
+        messages.push(`No candidates found for "${options.query}".`);
+    }
+    else {
+        messages.push(`${candidates.length} candidate(s) for "${options.query}" using ${profile} profile.`);
+        if (rejectedCandidates.length > 0) {
+            messages.push(`${rejectedCandidates.length} rejected candidate(s) moved to rejectedCandidates by the ${profile} profile.`);
+        }
+        if (!anyPullable) {
+            messages.push("No auto-pullable candidate. Listed assets need a manual license check before use.");
+        }
+        if (profile !== "general" && !anyProfileSuitable) {
+            messages.push(`No ${profile}-ready candidate. Listed candidates were rejected by the asset profile; inspect rejectionReasons before resolving.`);
+        }
+        else if (profile !== "general" && !anyProfilePullable) {
+            messages.push(`No auto-pullable ${profile}-ready candidate. Resolve will refuse until a downloadable licensed candidate also passes the profile.`);
+        }
+    }
+    if (deepLinks.length > 0) {
+        messages.push(`${deepLinks.length} marketplace deep-link(s) - manual download (license check required).`);
+    }
+    return {
+        ok: true,
+        query: options.query,
+        profile,
+        candidates,
+        rejectedCandidates,
+        deepLinks,
+        warnings,
+        messages,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/pull-bridge/search.js.map

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

package/dist/pull-bridge/types.d.ts

@@ -0,0 +1,9 @@
+import type { AnimationAssetProfile } from "@aura3d/asset-index";
+export type CliAssetSearchProfile = "general" | "fighting-character" | AnimationAssetProfile;
+export interface CliResolveConstraints {
+    readonly license?: readonly ("CC0" | "CC-BY")[];
+    readonly maxTriangles?: number;
+    readonly animated?: boolean;
+    readonly profile?: CliAssetSearchProfile;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pull-bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAC1C"}

package/dist/pull-bridge/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pull-bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/types.ts"],"names":[],"mappings":""}

package/dist/pull-bridge/vector3.d.ts

@@ -0,0 +1,2 @@
+export declare function isPositiveVector3(value: readonly [number, number, number] | undefined): boolean;
+//# sourceMappingURL=vector3.d.ts.map

package/dist/pull-bridge/vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/vector3.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACnD,OAAO,CAET"}

package/dist/pull-bridge/vector3.js

@@ -0,0 +1,4 @@
+export function isPositiveVector3(value) {
+    return Boolean(value && value.every((entry) => Number.isFinite(entry) && entry > 0));
+}
+//# sourceMappingURL=vector3.js.map

package/dist/pull-bridge/vector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/vector3.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAC/B,KAAoD;IAEpD,OAAO,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/pull-bridge.d.ts

@@ -1,104 +1,21 @@
-import type { AuraCanonicalAsset, AnimationAssetProfile, FederatedResolver as FederatedResolverType, ResolveCandidate, ResolveConstraints, SourceAdapter } from "@aura3d/asset-index";
-import { addAsset } from "./index.js";
+import type { FederatedResolver as FederatedResolverType, SourceAdapter } from "@aura3d/asset-index";
+import { addAsset, inspectAsset } from "./index.js";
 import type { AssetCliResult } from "./index.js";
-/**
- * Assemble the live source adapters for the CLI:
- *   - the zero-auth verified defaults (Khronos, OS3A, + Poly Haven when present),
- *   - key-gated sources only when their API key env var is set,
- * Each optional factory degrades to "absent" rather than throwing.
- */
-export declare function buildSearchAdapters(env?: NodeJS.ProcessEnv): SourceAdapter[];
-/** Marketplace deep-link adapter, when the concurrently-authored factory exists. */
-export declare function buildDeepLinkAdapter(): SourceAdapter | undefined;
-export type CliAssetSearchProfile = "general" | "fighting-character" | AnimationAssetProfile;
-export interface CliResolveConstraints {
-    readonly license?: readonly ("CC0" | "CC-BY")[];
-    readonly maxTriangles?: number;
-    readonly animated?: boolean;
-    readonly profile?: CliAssetSearchProfile;
-}
-/** Translate CLI flags into the index's ResolveConstraints shape. */
-export declare function toResolveConstraints(cli: CliResolveConstraints, redistributableOnly: boolean): ResolveConstraints;
-/**
- * Pure selection seam: choose the top candidate Aura may legally auto-pull.
- *
- * Returns the first candidate that is downloadable under a verified,
- * redistributable license (`isAutoPullable`). When none qualifies it returns a
- * structured refusal explaining why, so the caller never silently pulls an
- * UNVERIFIED or deep-link-only asset.
- */
-export interface PullableSelection {
-    readonly ok: true;
-    readonly candidate: ResolveCandidate;
-}
-export interface PullableRefusal {
-    readonly ok: false;
-    readonly reason: string;
-}
-export declare function selectPullable(candidates: readonly ResolveCandidate[], options?: {
-    readonly profile?: CliAssetSearchProfile;
-}): PullableSelection | PullableRefusal;
-/**
- * Result of a download. A downloader normally writes to the requested
- * `destPath`; when the payload was a ZIP it unpacks into the same directory and
- * returns the assembled artifact's path via `path`. Returning nothing keeps the
- * legacy `(url, destPath) => void` contract (tests rely on this).
- */
-export interface DownloadResult {
-    /** Final on-disk file to feed the add pipeline (defaults to the requested dest). */
-    readonly path?: string;
-}
-/** Injected file downloader (overridable for tests). */
-export type DownloadFile = (url: string, destPath: string) => Promise<DownloadResult | void>;
-/**
- * Default downloader backed by global fetch.
- *
- * Objaverse URLs are direct `.glb`; Poly Pizza / Sketchfab artifacts can arrive
- * as a ZIP (gltf + bin + textures, or a packaged .glb). We sniff the leading
- * bytes: a GLB/gltf body is written through as-is; a `PK` body is unpacked next
- * to `destPath` and the assembled .glb/.gltf path is returned. Auth-gated
- * Sketchfab `download` endpoints return JSON (a signed-URL envelope, or a 401);
- * we surface a clear, non-fatal-to-the-tool error instead of writing garbage.
- */
-export declare const defaultDownloadFile: DownloadFile;
-export interface SearchOptions {
-    readonly query: string;
-    readonly constraints?: CliResolveConstraints;
-    readonly limit?: number;
-    readonly env?: NodeJS.ProcessEnv;
-    /** Test seam: override resolver construction. */
-    readonly makeResolver?: (adapters: readonly SourceAdapter[]) => FederatedResolverType;
-}
-export interface SearchCandidateLine {
-    readonly id: string;
-    readonly source: string;
-    readonly title: string;
-    readonly license: string;
-    readonly autoPullable: boolean;
-    readonly access: AuraCanonicalAsset["access"];
-    readonly sourcePage?: string;
-    readonly profile?: {
-        readonly name: Exclude<CliAssetSearchProfile, "general">;
-        readonly suitable: boolean;
-        readonly rejectionReasons: readonly string[];
-        readonly warnings: readonly string[];
-        /** Post-download checks deferred by pre-download ranking (animation profiles). */
-        readonly validationHooks: readonly string[];
-    };
-}
-export interface SearchReport {
-    readonly ok: boolean;
-    readonly query: string;
-    readonly profile: CliAssetSearchProfile;
-    readonly candidates: readonly SearchCandidateLine[];
-    readonly rejectedCandidates: readonly SearchCandidateLine[];
-    /** Deep-link discovery suggestions shown only when nothing is auto-pullable. */
-    readonly deepLinks: readonly SearchCandidateLine[];
-    readonly warnings: readonly string[];
-    readonly messages: readonly string[];
-}
-/** Run a federated search and produce a printable report. */
-export declare function runSearch(options: SearchOptions): Promise<SearchReport>;
+import { defaultDownloadFile } from "./pull-bridge/download.js";
+import type { DownloadFile } from "./pull-bridge/download.js";
+import { toResolveConstraints } from "./pull-bridge/profiles.js";
+import { selectPullable } from "./pull-bridge/pullable.js";
+import { rankResolveCandidates, scoreResolveCandidate } from "./pull-bridge/scoring.js";
+import { runSearch } from "./pull-bridge/search.js";
+import type { SearchCandidateLine } from "./pull-bridge/search.js";
+import type { CliAssetSearchProfile, CliResolveConstraints } from "./pull-bridge/types.js";
+export { defaultDownloadFile, rankResolveCandidates, runSearch, selectPullable, scoreResolveCandidate, toResolveConstraints, };
+export type { DownloadFile, DownloadResult } from "./pull-bridge/download.js";
+export type { PullableRefusal, PullableSelection } from "./pull-bridge/pullable.js";
+export type { AssetResolveCandidateScore } from "./pull-bridge/scoring.js";
+export type { SearchCandidateLine, SearchOptions, SearchReport, } from "./pull-bridge/search.js";
+export type { CliAssetSearchProfile, CliResolveConstraints, } from "./pull-bridge/types.js";
+export { buildDeepLinkAdapter, buildSearchAdapters } from "./pull-bridge/adapters.js";
 export interface ResolveOptions {
     readonly query: string;
     readonly name: string;
@@ -109,6 +26,7 @@ export interface ResolveOptions {
     readonly makeResolver?: (adapters: readonly SourceAdapter[]) => FederatedResolverType;
     readonly download?: DownloadFile;
     readonly addAssetFn?: typeof addAsset;
+    readonly inspectAssetFn?: typeof inspectAsset;
     readonly tmpRoot?: string;
     /**
      * Retrieval timestamp recorded in provenance. Injectable so deterministic

package/dist/pull-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull-bridge.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/pull-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pull-bridge.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/pull-bridge.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,iBAAiB,IAAI,qBAAqB,EAC1C,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAGL,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,SAAS,EAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,kBAAkB;IAClB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,KAAK,qBAAqB,CAAC;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,QAAQ,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAoJhF"}