@camstack/system 1.2.364 → 1.2.365

package/dist/{dist-DiScyAO6.js → dist-B22ObVxi.js}

@@ -7917,12 +7917,15 @@ var ModelFormatEntrySchema = zod.z.object({
 	/** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
 	runtimes: zod.z.array(zod.z.enum(["python"])).readonly().optional(),
 	/**
-	* Content revision of the hosted artefact. Set it, or change it, whenever
-	* the bytes at `url` are replaced in place (same path, new content). A node
-	* records the revision it downloaded next to the file
+	* Content revision of the artefact, for one hosted OFF the CamStack mirror.
+	* A format on the mirror leaves it unset: its revision (the sha256 of its
+	* weight file) comes from the downloader's generated table, kept in step
+	* with the mirror by `scripts/check-hosted-model-revisions.ts` (D744). A
+	* node records the revision it downloaded next to the file
 	* (`<file>.revision`); a copy with no record or a different one is stale
-	* and is downloaded again, the old copy serving until the new one is
-	* complete. Omitted ⇒ a file on disk is current, whatever it holds (D743).
+	* unless its weight file hashes to the revision, and a stale copy is
+	* downloaded again, the old one serving until the new one is complete. No
+	* revision at all ⇒ a file on disk is current, whatever it holds (D743).
 	*/
 	revision: zod.z.string().min(1).optional()
 });
@@ -45922,6 +45925,8 @@ Object.freeze({
 	vehicle: .65,
 	animal: .65
 });
+var HF_REPO = "camstack/camstack-models";
+`${HF_REPO}`;
 /**
 * Runtime defaults -- used by ConfigManager.get() for backward compatibility
 * until Plan B wires all runtime settings to the system_settings SQL table.
@@ -60200,6 +60205,9 @@ var ADDON_ID_PREFIX = "addon:";
 function bareAddonId(id) {
 	return id.startsWith(ADDON_ID_PREFIX) ? id.slice(6) : id;
 }
+function hfModelUrl(repo, path) {
+	return `https://huggingface.co/${repo}/resolve/main/${path}`;
+}
 var MB = 1024 * 1024;
 1024 * MB, 3072 * MB;
 /**
@@ -60532,6 +60540,12 @@ Object.defineProperty(exports, "FieldClaimSchema", {
 		return FieldClaimSchema;
 	}
 });
+Object.defineProperty(exports, "HF_REPO", {
+	enumerable: true,
+	get: function() {
+		return HF_REPO;
+	}
+});
 Object.defineProperty(exports, "LOG_LEVEL_RANK", {
 	enumerable: true,
 	get: function() {
@@ -60562,6 +60576,12 @@ Object.defineProperty(exports, "MINUTES_PER_DAY", {
 		return MINUTES_PER_DAY;
 	}
 });
+Object.defineProperty(exports, "MODEL_FORMATS", {
+	enumerable: true,
+	get: function() {
+		return MODEL_FORMATS;
+	}
+});
 Object.defineProperty(exports, "MOTION_CLOSE_AFTER_MS", {
 	enumerable: true,
 	get: function() {
@@ -61042,6 +61062,12 @@ Object.defineProperty(exports, "gbToBytes", {
 		return gbToBytes;
 	}
 });
+Object.defineProperty(exports, "hfModelUrl", {
+	enumerable: true,
+	get: function() {
+		return hfModelUrl;
+	}
+});
 Object.defineProperty(exports, "hydrateSchema", {
 	enumerable: true,
 	get: function() {

package/dist/{dist-C-IdBSWx.mjs → dist-BIGk6VLF.mjs}

@@ -7917,12 +7917,15 @@ var ModelFormatEntrySchema = z.object({
 	/** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
 	runtimes: z.array(z.enum(["python"])).readonly().optional(),
 	/**
-	* Content revision of the hosted artefact. Set it, or change it, whenever
-	* the bytes at `url` are replaced in place (same path, new content). A node
-	* records the revision it downloaded next to the file
+	* Content revision of the artefact, for one hosted OFF the CamStack mirror.
+	* A format on the mirror leaves it unset: its revision (the sha256 of its
+	* weight file) comes from the downloader's generated table, kept in step
+	* with the mirror by `scripts/check-hosted-model-revisions.ts` (D744). A
+	* node records the revision it downloaded next to the file
 	* (`<file>.revision`); a copy with no record or a different one is stale
-	* and is downloaded again, the old copy serving until the new one is
-	* complete. Omitted ⇒ a file on disk is current, whatever it holds (D743).
+	* unless its weight file hashes to the revision, and a stale copy is
+	* downloaded again, the old one serving until the new one is complete. No
+	* revision at all ⇒ a file on disk is current, whatever it holds (D743).
 	*/
 	revision: z.string().min(1).optional()
 });
@@ -45922,6 +45925,8 @@ Object.freeze({
 	vehicle: .65,
 	animal: .65
 });
+var HF_REPO = "camstack/camstack-models";
+`${HF_REPO}`;
 /**
 * Runtime defaults -- used by ConfigManager.get() for backward compatibility
 * until Plan B wires all runtime settings to the system_settings SQL table.
@@ -60200,6 +60205,9 @@ var ADDON_ID_PREFIX = "addon:";
 function bareAddonId(id) {
 	return id.startsWith(ADDON_ID_PREFIX) ? id.slice(6) : id;
 }
+function hfModelUrl(repo, path) {
+	return `https://huggingface.co/${repo}/resolve/main/${path}`;
+}
 var MB = 1024 * 1024;
 1024 * MB, 3072 * MB;
 /**
@@ -60334,4 +60342,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { calendarsCapability as $, disarmRoseMemory as $n, memoizePinnedFfmpeg as $t, MOTION_CLOSE_AFTER_MS as A, storageCapability as An, EventCategory as Ar, extractNestedAddonId as At, StorageLocationTypeSchema as B, vectorIndexDimConflictError as Bn, isObjectInput as Bt, FieldClaimModeSchema as C, runtimeStatePolicyFor as Cn, parseJsonObject as Cr, enumerateInferenceDevices as Ct, LocationIconIdSchema as D, settingsStoreCapability as Dn, scopeKey as Dr, evictionPolicyOfLocation as Dt, LegacyStorageLocationDefaultSchema as E, scoreRuntimes as En, resolveCapMount as Er, evaluateCompositionField as Et, STORAGE_ACCESS_FALLBACK as F, streamQualityLabel as Fn, isAppLinkBase as Ft, addonWidgetsCapability as G, cloneStatefulExpressionMemory as Gn, lifecycleJobSchema as Gt, UserRecordSchema as H, withLocationMode as Hn, kebabToCamel as Ht, STREAM_PROFILE_META as I, userManagementCapability as In, isArrayOutputSchema as It, backupCapability as J, compositionFeatureEnabled as Jn, logDestinationCapability as Jt, alertsCapability as K, composedDeviceRef as Kn, localNetworkCapability as Kt, ScopedTokenSchema as L, validateComposition as Ln, isCollectionArrayMethod as Lt, REDACTED_SECRET as M, storageOccupancyCapability as Mn, foldSnapshotByFunction as Mt, RUNTIME_DEFAULTS as N, storageProviderCapability as Nn, formatMinutes as Nt, METHOD_ACCESS_MAP as O, siteZoneKey as On, sleep as Or, expandContainer as Ot, RecordingStatusSchema as P, streamCatalogCapability as Pn, gbToBytes as Pt, buildStreamParamsConfigSchema as Q, createStatefulExpressionMemory as Qn, mayWriteToLocation as Qt, StorageCleanupJobSchema as R, validateCustomAddress as Rn, isDefaultAppConnectionEndpoint as Rt, FIRST_LEVEL_MACRO_CLASSES as S, resolveNotificationTapAddress as Sn, nodePin as Sr, deviceStatusCapability as St, LOG_LEVEL_RANK as T, scopesAllowDeviceCap as Tn, readinessKey as Tr, enumerateSchemaFields as Tt, addonPagesCapability as U, COMPOSER_ADDON_ID as Un, legacyAutoLinkIds as Ut, StorageMigrationJobSchema as V, vectorStoreCapability as Vn, isVoidInput as Vt, addonSettingsCapability as W, buildFfmpegArgs as Wn, legacyModeOf as Wt, batteryCapability as X, compositionSliceKey as Xn, looseSchema as Xt, bareAddonId as Y, compositionItemFieldPath as Yn, logLevelAtMost as Yt, buildCapabilityLookup as Z, compositionSourceKey as Zn, mayReadLocation as Zt, DATABASE_SNAPSHOT_TIMEOUT_MS as _, resolveCoreBlockEntry as _n, emitReadiness as _r, deriveBatteryPresence as _t, BatteryStatusSchema as a, objectInputDeclaresAddonId as an, BaseAddon as ar, compositionSourceRefs as at, DeclaredDevices as b, resolveLocationMode as bn, isDeviceConfigCap as br, deviceManagerCapability as bt, CAP_NAMES_WITH_STATUS as c, pickAppLinkHub as cn, DEVICE_STATUS_METHOD as cr, coreBlockIdFromAddonId as ct, CORE_BLOCKS_ADDON_ID as d, procedureAuthKey as dn, WELL_KNOWN_TAB_MAP as dr, createDeviceExtensionProvider as dt, metricsProviderCapability as en, toExpressionValue as er, cameraGridLayoutCapability as et, CORE_BLOCK_ADDON_PREFIX as f, ptzAutotrackCapability as fn, asJsonObject as fr, dataStoreProviderCapability as ft, DATABASE_SNAPSHOT_SUFFIX as g, resolveBucketMs as gn, emitDownForOwnedCaps as gr, defineExtensionSlotProvider as gt, DATABASE_SNAPSHOT_PARTIAL_SUFFIX as h, resolveAppConnections as hn, createEvent as hr, decodeVectorBase64 as ht, BaseDevice as i, normalizeUnit as in, errMsg as ir, compositionFieldKey as it, RECORDING_SOURCE_CAMSTACK_ADDON as j, storageMigrationCapability as jn, filesystemBrowseCapability as jt, MINUTES_PER_DAY as k, snapshotCapability as kn, toNodeId as kr, expressionContainsBuiltinCall as kt, COMPOSED_ITEM_FIXED_FIELDS as l, planComposition as ln, ReadinessRegistry as lr, coreBlockSourceKind as lt, CoreBlockSchema as m, replacedFieldKeys as mn, asString$1 as mr, declarationOwnerNodeId as mt, AlertSchema as n, motionCapability as nn, DeviceRole as nr, collectSecretConfigKeys as nt, CAMERA_SWITCH_ORDER as o, objectInputDeclaresRequiredDeviceId as on, DATAPLANE_SECRET_HEADER as or, coreBlockAddonId as ot, CalendarPreferencesSchema as p, reducePoints as pn, asNumber as pr, databaseSnapshotCapability as pt, authProviderCapability as q, composedDeviceStableId as qn, locationIconKey as qt, ApiKeyRecordSchema as r, normalizeCoreBlockWrite as rn, DeviceType as rr, composerCapability as rt, CAMSTACK_APP_LINK_ORIGIN as s, parseStreamParamsFormPatch as sn, DEVICE_SETTINGS_CONTRIBUTION_METHODS as sr, coreBlockComposition as st, ALL_CAPABILITY_DEFINITIONS as t, modeMayWrite as tn, DeviceFeature as tr, checkRoleAddress as tt, COMPOSER_RUNNER_ID as u, platformProbeCapability as un, ReadinessTimeoutError as ur, coreBlocksCapability as ut, DAY_NAMES as v, resolveCoreBlockFiles as vn, expandCapMethods as vr, describeComposableCaps as vt, FieldClaimSchema as w, scopesAllowAddon as wn, parseJsonUnknown as wr, enumerateItemArrayFields as wt, DeviceStatusSchema as x, resolveMethodAuth as xn, isEvent as xr, deviceStateCapability as xt, DERIVED_CAMERA_SILENCED_CAP_NAMES as y, resolveHubAddressRoles as yn, hydrateSchema as yr, deviceExtensionCapability as yt, StorageLocationModeSchema as z, vectorDimFromBase64 as zn, isLocationEnabled as zt };
+export { buildCapabilityLookup as $, compositionSliceKey as $n, looseSchema as $t, MINUTES_PER_DAY as A, settingsStoreCapability as An, scopeKey as Ar, expandContainer as At, StorageCleanupJobSchema as B, validateComposition as Bn, isCollectionArrayMethod as Bt, FieldClaimModeSchema as C, resolveLocationMode as Cn, isDeviceConfigCap as Cr, deviceStateCapability as Ct, LegacyStorageLocationDefaultSchema as D, scopesAllowAddon as Dn, parseJsonUnknown as Dr, enumerateSchemaFields as Dt, LOG_LEVEL_RANK as E, runtimeStatePolicyFor as En, parseJsonObject as Er, enumerateItemArrayFields as Et, RUNTIME_DEFAULTS as F, storageOccupancyCapability as Fn, formatMinutes as Ft, addonPagesCapability as G, withLocationMode as Gn, kebabToCamel as Gt, StorageLocationTypeSchema as H, vectorDimFromBase64 as Hn, isLocationEnabled as Ht, RecordingStatusSchema as I, storageProviderCapability as In, gbToBytes as It, alertsCapability as J, cloneStatefulExpressionMemory as Jn, lifecycleJobSchema as Jt, addonSettingsCapability as K, COMPOSER_ADDON_ID as Kn, legacyAutoLinkIds as Kt, STORAGE_ACCESS_FALLBACK as L, streamCatalogCapability as Ln, hfModelUrl as Lt, MOTION_CLOSE_AFTER_MS as M, snapshotCapability as Mn, toNodeId as Mr, extractNestedAddonId as Mt, RECORDING_SOURCE_CAMSTACK_ADDON as N, storageCapability as Nn, EventCategory as Nr, filesystemBrowseCapability as Nt, LocationIconIdSchema as O, scopesAllowDeviceCap as On, readinessKey as Or, evaluateCompositionField as Ot, REDACTED_SECRET as P, storageMigrationCapability as Pn, foldSnapshotByFunction as Pt, batteryCapability as Q, compositionItemFieldPath as Qn, logLevelAtMost as Qt, STREAM_PROFILE_META as R, streamQualityLabel as Rn, isAppLinkBase as Rt, FIRST_LEVEL_MACRO_CLASSES as S, resolveHubAddressRoles as Sn, hydrateSchema as Sr, deviceManagerCapability as St, HF_REPO as T, resolveNotificationTapAddress as Tn, nodePin as Tr, enumerateInferenceDevices as Tt, StorageMigrationJobSchema as U, vectorIndexDimConflictError as Un, isObjectInput as Ut, StorageLocationModeSchema as V, validateCustomAddress as Vn, isDefaultAppConnectionEndpoint as Vt, UserRecordSchema as W, vectorStoreCapability as Wn, isVoidInput as Wt, backupCapability as X, composedDeviceStableId as Xn, locationIconKey as Xt, authProviderCapability as Y, composedDeviceRef as Yn, localNetworkCapability as Yt, bareAddonId as Z, compositionFeatureEnabled as Zn, logDestinationCapability as Zt, DATABASE_SNAPSHOT_TIMEOUT_MS as _, replacedFieldKeys as _n, asString$1 as _r, decodeVectorBase64 as _t, BatteryStatusSchema as a, motionCapability as an, DeviceRole as ar, composerCapability as at, DeclaredDevices as b, resolveCoreBlockEntry as bn, emitReadiness as br, describeComposableCaps as bt, CAP_NAMES_WITH_STATUS as c, objectInputDeclaresAddonId as cn, BaseAddon as cr, coreBlockAddonId as ct, CORE_BLOCKS_ADDON_ID as d, pickAppLinkHub as dn, DEVICE_STATUS_METHOD as dr, coreBlockSourceKind as dt, mayReadLocation as en, compositionSourceKey as er, buildStreamParamsConfigSchema as et, CORE_BLOCK_ADDON_PREFIX as f, planComposition as fn, ReadinessRegistry as fr, coreBlocksCapability as ft, DATABASE_SNAPSHOT_SUFFIX as g, reducePoints as gn, asNumber as gr, declarationOwnerNodeId as gt, DATABASE_SNAPSHOT_PARTIAL_SUFFIX as h, ptzAutotrackCapability as hn, asJsonObject as hr, databaseSnapshotCapability as ht, BaseDevice as i, modeMayWrite as in, DeviceFeature as ir, collectSecretConfigKeys as it, MODEL_FORMATS as j, siteZoneKey as jn, sleep as jr, expressionContainsBuiltinCall as jt, METHOD_ACCESS_MAP as k, scoreRuntimes as kn, resolveCapMount as kr, evictionPolicyOfLocation as kt, COMPOSED_ITEM_FIXED_FIELDS as l, objectInputDeclaresRequiredDeviceId as ln, DATAPLANE_SECRET_HEADER as lr, coreBlockComposition as lt, CoreBlockSchema as m, procedureAuthKey as mn, WELL_KNOWN_TAB_MAP as mr, dataStoreProviderCapability as mt, AlertSchema as n, memoizePinnedFfmpeg as nn, disarmRoseMemory as nr, cameraGridLayoutCapability as nt, CAMERA_SWITCH_ORDER as o, normalizeCoreBlockWrite as on, DeviceType as or, compositionFieldKey as ot, CalendarPreferencesSchema as p, platformProbeCapability as pn, ReadinessTimeoutError as pr, createDeviceExtensionProvider as pt, addonWidgetsCapability as q, buildFfmpegArgs as qn, legacyModeOf as qt, ApiKeyRecordSchema as r, metricsProviderCapability as rn, toExpressionValue as rr, checkRoleAddress as rt, CAMSTACK_APP_LINK_ORIGIN as s, normalizeUnit as sn, errMsg as sr, compositionSourceRefs as st, ALL_CAPABILITY_DEFINITIONS as t, mayWriteToLocation as tn, createStatefulExpressionMemory as tr, calendarsCapability as tt, COMPOSER_RUNNER_ID as u, parseStreamParamsFormPatch as un, DEVICE_SETTINGS_CONTRIBUTION_METHODS as ur, coreBlockIdFromAddonId as ut, DAY_NAMES as v, resolveAppConnections as vn, createEvent as vr, defineExtensionSlotProvider as vt, FieldClaimSchema as w, resolveMethodAuth as wn, isEvent as wr, deviceStatusCapability as wt, DeviceStatusSchema as x, resolveCoreBlockFiles as xn, expandCapMethods as xr, deviceExtensionCapability as xt, DERIVED_CAMERA_SILENCED_CAP_NAMES as y, resolveBucketMs as yn, emitDownForOwnedCaps as yr, deriveBatteryPresence as yt, ScopedTokenSchema as z, userManagementCapability as zn, isArrayOutputSchema as zt };

package/dist/download/hosted-model-revisions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GENERATED by `scripts/check-hosted-model-revisions.ts --write` — DO NOT EDIT.
+ *
+ * The revision of every artefact on the CamStack model mirror, keyed by its
+ * path under `https://huggingface.co/camstack/camstack-models/resolve/main/`: the sha256 (`lfs.oid`)
+ * of its weight file (`revisionWeightUrl`). `resolveFormatRevision` reads
+ * it for every catalog format hosted there (D743, D744). Regenerate after
+ * any upload to the mirror; the script without `--write` says when it is due.
+ */
+export declare const HOSTED_MODEL_REVISIONS: Readonly<Record<string, string>>;

package/dist/download/model-download-service.d.ts

@@ -1,10 +1,12 @@
 import { ModelCatalogEntry, ModelFormat, IAddonModelManager } from '@camstack/types';
 /**
- * Unified model download service.
+ * A catalog-bound face over the shared downloader.
  *
- * Handles downloading model files and extra files (labels, dicts) from a
- * catalog of ModelCatalogEntry items. Supports single-file models and
- * directory bundles (e.g., .mlpackage for CoreML).
+ * Downloading, completeness and the revision contract (D743) are
+ * `ensureModel` / `isModelDownloaded`'s — this class only resolves a model id
+ * (and a default format) against its catalog and keys progress by model id.
+ * It used to carry its own copy of the download loop, which never learnt the
+ * revision; one rule now lives in one place.
  *
  * Addons use this via `context.models.ensure(modelId, format)`.
  */
@@ -14,7 +16,7 @@ export declare class ModelDownloadService implements IAddonModelManager {
     private readonly catalog;
     constructor(modelsDir: string, catalog: readonly ModelCatalogEntry[], onProgress?: ((modelId: string, downloaded: number, total: number) => void) | undefined);
     /**
-     * Ensure a model (and its extra files) is downloaded.
+     * Ensure a model (and its extra files) is downloaded and current.
      * Returns the local filesystem path to the model file/directory.
      */
     ensure(modelId: string, format?: ModelFormat): Promise<string>;
@@ -25,17 +27,9 @@ export declare class ModelDownloadService implements IAddonModelManager {
     ensureExtraFiles(modelId: string): Promise<readonly string[]>;
     /** Absolute path to the shared models directory. */
     getModelsDir(): string;
-    /** Check if a model file is already present on disk. */
+    /** True when the model is on disk, complete, and at its revision (D743). */
     isDownloaded(modelId: string, format?: ModelFormat): boolean;
     /** Get the catalog entry for a model by ID. */
     getEntry(modelId: string): ModelCatalogEntry | undefined;
     private pickDefaultFormat;
-    private modelFilePath;
-    /**
-     * Download a directory bundle (e.g., .mlpackage) from HuggingFace.
-     * ATOMIC: downloads to temp dir, renames only on complete success.
-     */
-    private downloadDirectory;
-    /** Recursively list all files in a HuggingFace directory via API. */
-    private listHfFiles;
 }

package/dist/download/model-downloader.d.ts

@@ -79,18 +79,60 @@ export type DownloadProgressCallback = (downloaded: number, total: number | unde
  * bundle, so a `.mlpackage` keeps exactly the hosted files.
  */
 export declare function revisionRecordPath(modelPath: string): string;
+/** The CamStack model mirror. Every artefact under it has a generated revision. */
+export declare const HOSTED_MODEL_MIRROR_PREFIX: string;
+/**
+ * The revision a format must be at — the ONE rule every model download path
+ * reads (D743, D744). An inline `revision` wins; otherwise a format hosted on
+ * the CamStack mirror takes the revision generated for its path from the
+ * mirror's LFS metadata (`hosted-model-revisions.ts`); anything else has none.
+ */
+export declare function resolveFormatRevision(formatEntry: ModelFormatEntry): string | undefined;
+/**
+ * The file whose sha256 IS a format's revision: a Core ML package's
+ * `weight.bin`, an OpenVINO IR's `.bin` sibling, otherwise the file itself.
+ * `null` for a bundle that is not a Core ML package (nothing to hash).
+ */
+export type RevisionWeightFile = {
+    readonly in: 'bundle';
+    readonly member: string;
+} | {
+    readonly in: 'sibling';
+    readonly name: string;
+} | {
+    readonly in: 'main';
+};
+export declare function revisionWeightFile(formatEntry: ModelFormatEntry): RevisionWeightFile | null;
+/** Where the revision's weight file is hosted — what the mirror's `lfs.oid` describes. */
+export declare function revisionWeightUrl(formatEntry: ModelFormatEntry): string | null;
 /**
  * Resolve a `ModelCatalogEntry` against `modelsDir`: download model file
  * (or directory bundle) + extra files (labels JSON, charset dict, …),
  * skip if already on disk. Returns the local model path.
  */
 export declare function ensureModel(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat, onProgress?: DownloadProgressCallback): Promise<string>;
+/** What {@link adoptModelRevisions} found: `<modelId>/<format>` keys. */
+export interface ModelRevisionAdoption {
+    /** Copies proven current by hash and recorded — no download needed. */
+    readonly adopted: readonly string[];
+    /** Complete copies holding other bytes — `ensureModel` fetches them again. */
+    readonly stale: readonly string[];
+}
+/**
+ * Walk `entries` and record the revision of every complete copy on disk that
+ * hashes to it, so a node's listing reports present models as downloaded
+ * without waiting for something to `ensureModel` them. Offline: it reads
+ * files and never fetches. A copy already recorded current is not re-hashed.
+ */
+export declare function adoptModelRevisions(modelsDir: string, entries: readonly ModelCatalogEntry[]): Promise<ModelRevisionAdoption>;
 /** Compute the on-disk path for a given model + format, even when not yet downloaded. */
 export declare function getModelFilePath(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat): string | null;
 /**
  * True iff the model file (or `Manifest.json` for directory bundles) exists and
- * is non-empty, and — when the catalog names a `revision` — the node recorded
- * that same revision for it (D743).
+ * is non-empty, and — when the format has a revision ({@link
+ * resolveFormatRevision}) — the node recorded that same revision for it
+ * (D743). Synchronous, so it never hashes: a copy not yet proven current
+ * answers false until `ensureModel` or {@link adoptModelRevisions} records it.
  */
 export declare function isModelDownloaded(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat): boolean;
 /** Remove the on-disk model file/directory. Returns true if something was deleted. */