@livekit/agents-plugin-livekit 0.1.3 → 1.0.0-next.1

package/dist/hf_utils.cjs

@@ -0,0 +1,272 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var hf_utils_exports = {};
+__export(hf_utils_exports, {
+  REGEX_COMMIT_HASH: () => REGEX_COMMIT_HASH,
+  downloadFileToCacheDir: () => downloadFileToCacheDir
+});
+module.exports = __toCommonJS(hf_utils_exports);
+var import_hub = require("@huggingface/hub");
+var import_agents = require("@livekit/agents");
+var import_node_fs = require("node:fs");
+var import_promises = require("node:fs/promises");
+var import_node_os = require("node:os");
+var import_node_path = require("node:path");
+var import_node_stream = require("node:stream");
+var import_promises2 = require("node:stream/promises");
+const REGEX_COMMIT_HASH = new RegExp("^[0-9a-f]{40}$");
+function getHFHubCachePath(customCacheDir) {
+  return customCacheDir || (0, import_node_path.join)((0, import_node_os.homedir)(), ".cache", "huggingface", "hub");
+}
+function getRepoFolderName(repoId) {
+  return `models--${repoId.replace(/\//g, "--")}`;
+}
+function toRepoId(repo) {
+  if (typeof repo === "string") {
+    return repo;
+  }
+  return `${repo.name}`;
+}
+async function getBranchHeadCommit(repo, revision, params) {
+  const logger = (0, import_agents.log)();
+  try {
+    if (REGEX_COMMIT_HASH.test(revision)) {
+      return revision;
+    }
+    for await (const commit of (0, import_hub.listCommits)({
+      repo,
+      revision,
+      ...params
+    })) {
+      const commitHash = commit.oid || commit.id || commit.commitId;
+      if (commitHash) {
+        return commitHash;
+      }
+      break;
+    }
+    logger.error({ repo: toRepoId(repo), revision }, "No commits found for revision");
+    return null;
+  } catch (error) {
+    logger.error(
+      { error: error.message, repo: toRepoId(repo), revision },
+      "Error getting HEAD commit"
+    );
+    throw error;
+  }
+}
+async function createSymlink(sourcePath, targetPath) {
+  const logger = (0, import_agents.log)();
+  const { symlink, rm, copyFile } = await import("node:fs/promises");
+  function expandUser(path) {
+    if (path.startsWith("~")) {
+      return path.replace("~", (0, import_node_os.homedir)());
+    }
+    return path;
+  }
+  const absSrc = (0, import_node_path.resolve)(expandUser(sourcePath));
+  const absDst = (0, import_node_path.resolve)(expandUser(targetPath));
+  try {
+    await rm(absDst);
+  } catch {
+  }
+  try {
+    const relativePath = (0, import_node_path.relative)((0, import_node_path.dirname)(absDst), absSrc);
+    await symlink(relativePath, absDst);
+    logger.debug({ source: absSrc, target: absDst, relative: relativePath }, "Created symlink");
+  } catch (symlinkError) {
+    logger.warn({ source: absSrc, target: absDst }, "Symlink not supported, falling back to copy");
+    try {
+      await copyFile(absSrc, absDst);
+      logger.debug({ source: absSrc, target: absDst }, "File copied successfully");
+    } catch (copyError) {
+      logger.error(
+        { error: copyError.message, source: absSrc, target: absDst },
+        "Failed to copy file"
+      );
+      throw symlinkError;
+    }
+  }
+}
+function getFilePointer(storageFolder, revision, relativeFilename) {
+  const snapshotPath = (0, import_node_path.join)(storageFolder, "snapshots");
+  return (0, import_node_path.join)(snapshotPath, revision, relativeFilename);
+}
+async function exists(path, followSymlinks) {
+  try {
+    if (followSymlinks) {
+      await (0, import_promises.stat)(path);
+    } else {
+      await (0, import_promises.lstat)(path);
+    }
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+async function saveRevisionMapping({
+  storageFolder,
+  revision,
+  commitHash
+}) {
+  if (!REGEX_COMMIT_HASH.test(revision) && revision !== commitHash) {
+    const refsPath = (0, import_node_path.join)(storageFolder, "refs");
+    await (0, import_promises.mkdir)(refsPath, { recursive: true });
+    (0, import_node_fs.writeFileSync)((0, import_node_path.join)(refsPath, revision), commitHash);
+  }
+}
+async function downloadFileToCacheDir(params) {
+  const logger = (0, import_agents.log)();
+  const revision = params.revision ?? "main";
+  const cacheDir = params.cacheDir ?? getHFHubCachePath();
+  const repoId = toRepoId(params.repo);
+  const storageFolder = (0, import_node_path.join)(cacheDir, getRepoFolderName(repoId));
+  let branchHeadCommit;
+  if (REGEX_COMMIT_HASH.test(revision)) {
+    branchHeadCommit = revision;
+    const pointerPath2 = getFilePointer(storageFolder, revision, params.path);
+    if (await exists(pointerPath2, true)) {
+      logger.debug(
+        { pointerPath: pointerPath2, commitHash: branchHeadCommit },
+        "File found in cache (commit hash)"
+      );
+      return pointerPath2;
+    }
+  }
+  if (params.localFileOnly) {
+    logger.debug({ repoId, path: params.path, revision }, "Local file only mode - checking cache");
+    const directPath = getFilePointer(storageFolder, revision, params.path);
+    if (await exists(directPath, true)) {
+      logger.debug({ directPath }, "File found in cache (direct path)");
+      return directPath;
+    }
+    if (!REGEX_COMMIT_HASH.test(revision)) {
+      const refsPath = (0, import_node_path.join)(storageFolder, "refs", revision);
+      try {
+        const { readFileSync } = await import("fs");
+        const resolvedHash = readFileSync(refsPath, "utf-8").trim();
+        const resolvedPath = getFilePointer(storageFolder, resolvedHash, params.path);
+        if (await exists(resolvedPath, true)) {
+          logger.debug({ resolvedPath, resolvedHash }, "File found in cache (via refs)");
+          return resolvedPath;
+        }
+      } catch {
+        logger.debug({ revision }, "No ref mapping found for revision");
+      }
+    }
+    const error = `File not found in cache: ${repoId}/${params.path} (revision: ${revision}). Make sure to run the download-files command before running the agent worker.`;
+    logger.error({ repoId, path: params.path, revision }, error);
+    throw new Error(error);
+  }
+  if (!branchHeadCommit) {
+    const headCommit = await getBranchHeadCommit(params.repo, revision, params);
+    if (!headCommit) {
+      throw new Error(`Failed to resolve revision ${revision} to commit hash`);
+    }
+    branchHeadCommit = headCommit;
+  }
+  const pointerPath = getFilePointer(storageFolder, branchHeadCommit, params.path);
+  if (await exists(pointerPath, true)) {
+    logger.debug({ pointerPath, branchHeadCommit }, "File found in cache (branch HEAD)");
+    await saveRevisionMapping({
+      storageFolder,
+      revision,
+      commitHash: branchHeadCommit
+    });
+    return pointerPath;
+  }
+  logger.debug(
+    { repoId, path: params.path, revision: branchHeadCommit },
+    "Fetching path info from HF API"
+  );
+  const pathsInformation = await (0, import_hub.pathsInfo)({
+    ...params,
+    paths: [params.path],
+    revision: branchHeadCommit,
+    // Use HEAD commit for consistency
+    expand: true
+  });
+  if (!pathsInformation || pathsInformation.length !== 1) {
+    const error = `cannot get path info for ${params.path}`;
+    logger.error({ repoId, path: params.path, pathsInfoLength: pathsInformation == null ? void 0 : pathsInformation.length }, error);
+    throw new Error(error);
+  }
+  const pathInfo = pathsInformation[0];
+  if (!pathInfo) {
+    const error = `No path info returned for ${params.path}`;
+    logger.error({ repoId, path: params.path }, error);
+    throw new Error(error);
+  }
+  let etag;
+  if (pathInfo.lfs) {
+    etag = pathInfo.lfs.oid;
+    logger.debug({ etag, path: params.path }, "File is LFS pointer");
+  } else {
+    etag = pathInfo.oid;
+    logger.debug({ etag, path: params.path }, "File is regular git object");
+  }
+  const blobPath = (0, import_node_path.join)(storageFolder, "blobs", etag);
+  logger.debug({ branchHeadCommit, pointerPath, blobPath }, "Computed cache paths");
+  await (0, import_promises.mkdir)((0, import_node_path.dirname)(blobPath), { recursive: true });
+  await (0, import_promises.mkdir)((0, import_node_path.dirname)(pointerPath), { recursive: true });
+  if (await exists(blobPath)) {
+    logger.debug({ blobPath, etag }, "Blob already exists in cache, creating symlink only");
+    await createSymlink(blobPath, pointerPath);
+    return pointerPath;
+  }
+  const incomplete = `${blobPath}.incomplete`;
+  logger.debug({ path: params.path, incomplete }, "Starting file download");
+  const blob = await (0, import_hub.downloadFile)({
+    ...params,
+    revision: branchHeadCommit
+  });
+  if (!blob) {
+    const error = `invalid response for file ${params.path}`;
+    logger.error({ path: params.path }, error);
+    throw new Error(error);
+  }
+  logger.debug({ size: blob.size }, "Writing blob to disk");
+  await (0, import_promises2.pipeline)(import_node_stream.Readable.fromWeb(blob.stream()), (0, import_node_fs.createWriteStream)(incomplete));
+  await (0, import_promises.rename)(incomplete, blobPath);
+  logger.debug({ blobPath }, "Renamed incomplete file to final blob");
+  await createSymlink(blobPath, pointerPath);
+  logger.debug({ blobPath, pointerPath }, "Created symlink from snapshot to blob");
+  await saveRevisionMapping({
+    storageFolder,
+    revision,
+    commitHash: branchHeadCommit
+  });
+  logger.debug({ pointerPath, size: blob.size }, "File download completed successfully");
+  return pointerPath;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  REGEX_COMMIT_HASH,
+  downloadFileToCacheDir
+});
+//# sourceMappingURL=hf_utils.cjs.map

package/dist/hf_utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hf_utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Fixed version of HuggingFace's downloadFileToCacheDir that matches Python's behavior\n *\n * Key fix: Uses branch/tag HEAD commit for snapshot paths, not file's last commit\n * This ensures all files from the same revision end up in the same snapshot folder\n */\nimport type { CommitInfo, PathInfo, RepoDesignation } from '@huggingface/hub';\nimport { downloadFile, listCommits, pathsInfo } from '@huggingface/hub';\nimport { log } from '@livekit/agents';\nimport { createWriteStream, writeFileSync } from 'node:fs';\nimport { lstat, mkdir, rename, stat } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\nimport type { ReadableStream } from 'node:stream/web';\n\n// Define CredentialsParams if not exported\ninterface CredentialsParams {\n  accessToken?: string;\n}\n\nexport const REGEX_COMMIT_HASH: RegExp = new RegExp('^[0-9a-f]{40}$');\n\n// Helper functions from HuggingFace's cache-management\nfunction getHFHubCachePath(customCacheDir?: string): string {\n  return customCacheDir || join(homedir(), '.cache', 'huggingface', 'hub');\n}\n\nfunction getRepoFolderName(repoId: string): string {\n  return `models--${repoId.replace(/\\//g, '--')}`;\n}\n\nfunction toRepoId(repo: RepoDesignation | string): string {\n  if (typeof repo === 'string') {\n    return repo;\n  }\n  return `${repo.name}`;\n}\n\n/**\n * Get the HEAD commit hash for a branch/tag (matching Python's behavior)\n */\nasync function getBranchHeadCommit(\n  repo: RepoDesignation,\n  revision: string,\n  params: { accessToken?: string; hubUrl?: string; fetch?: typeof fetch },\n): Promise<string | null> {\n  const logger = log();\n\n  try {\n    // If already a commit hash, return it\n    if (REGEX_COMMIT_HASH.test(revision)) {\n      return revision;\n    }\n\n    // Get the first commit from listCommits - this is the HEAD\n    for await (const commit of listCommits({\n      repo,\n      revision,\n      ...params,\n    })) {\n      // The commit object structure varies, so we check multiple possible properties\n      const commitHash = (commit as any).oid || (commit as any).id || (commit as any).commitId;\n      if (commitHash) {\n        return commitHash;\n      }\n      break; // Only need the first one\n    }\n\n    logger.error({ repo: toRepoId(repo), revision }, 'No commits found for revision');\n    return null;\n  } catch (error) {\n    logger.error(\n      { error: (error as Error).message, repo: toRepoId(repo), revision },\n      'Error getting HEAD commit',\n    );\n    throw error;\n  }\n}\n\n/**\n * Create a symbolic link following HuggingFace's implementation\n */\nasync function createSymlink(sourcePath: string, targetPath: string): Promise<void> {\n  const logger = log();\n  const { symlink, rm, copyFile } = await import('node:fs/promises');\n\n  // Expand ~ to home directory\n  function expandUser(path: string): string {\n    if (path.startsWith('~')) {\n      return path.replace('~', homedir());\n    }\n    return path;\n  }\n\n  const absSrc = resolve(expandUser(sourcePath));\n  const absDst = resolve(expandUser(targetPath));\n\n  // Remove existing file/symlink if it exists\n  try {\n    await rm(absDst);\n  } catch {\n    // Ignore - file might not exist\n  }\n\n  try {\n    // Create relative symlink (better for portability)\n    const relativePath = relative(dirname(absDst), absSrc);\n    await symlink(relativePath, absDst);\n    logger.debug({ source: absSrc, target: absDst, relative: relativePath }, 'Created symlink');\n  } catch (symlinkError) {\n    // Symlink failed (common on Windows without admin rights)\n    // Fall back to copying the file\n    logger.warn({ source: absSrc, target: absDst }, 'Symlink not supported, falling back to copy');\n    try {\n      await copyFile(absSrc, absDst);\n      logger.debug({ source: absSrc, target: absDst }, 'File copied successfully');\n    } catch (copyError) {\n      logger.error(\n        { error: (copyError as Error).message, source: absSrc, target: absDst },\n        'Failed to copy file',\n      );\n      // If copy also fails, throw the original symlink error\n      throw symlinkError;\n    }\n  }\n}\n\nfunction getFilePointer(storageFolder: string, revision: string, relativeFilename: string): string {\n  const snapshotPath = join(storageFolder, 'snapshots');\n  return join(snapshotPath, revision, relativeFilename);\n}\n\n/**\n * handy method to check if a file exists, or the pointer of a symlinks exists\n */\nasync function exists(path: string, followSymlinks?: boolean): Promise<boolean> {\n  try {\n    if (followSymlinks) {\n      await stat(path);\n    } else {\n      await lstat(path);\n    }\n    return true;\n  } catch (err: unknown) {\n    return false;\n  }\n}\n\nasync function saveRevisionMapping({\n  storageFolder,\n  revision,\n  commitHash,\n}: {\n  storageFolder: string;\n  revision: string;\n  commitHash: string;\n}): Promise<void> {\n  if (!REGEX_COMMIT_HASH.test(revision) && revision !== commitHash) {\n    const refsPath = join(storageFolder, 'refs');\n    await mkdir(refsPath, { recursive: true });\n    writeFileSync(join(refsPath, revision), commitHash);\n  }\n}\n\n/**\n * Download a given file if it's not already present in the local cache.\n * Matches Python's hf_hub_download behavior by using branch HEAD commits.\n */\nexport async function downloadFileToCacheDir(\n  params: {\n    repo: RepoDesignation;\n    path: string;\n    /**\n     * If true, will download the raw git file.\n     */\n    raw?: boolean;\n    /**\n     * An optional Git revision id which can be a branch name, a tag, or a commit hash.\n     * @default \"main\"\n     */\n    revision?: string;\n    hubUrl?: string;\n    cacheDir?: string;\n    /**\n     * Custom fetch function to use instead of the default one\n     */\n    fetch?: typeof fetch;\n    /**\n     * If true, only return cached files, don't download\n     */\n    localFileOnly?: boolean;\n  } & Partial<CredentialsParams>,\n): Promise<string> {\n  const logger = log();\n\n  // get revision provided or default to main\n  const revision = params.revision ?? 'main';\n  const cacheDir = params.cacheDir ?? getHFHubCachePath();\n  // get repo id\n  const repoId = toRepoId(params.repo);\n  // get storage folder\n  const storageFolder = join(cacheDir, getRepoFolderName(repoId));\n\n  let branchHeadCommit: string | undefined;\n\n  // if user provides a commitHash as revision, use it directly\n  if (REGEX_COMMIT_HASH.test(revision)) {\n    branchHeadCommit = revision;\n    const pointerPath = getFilePointer(storageFolder, revision, params.path);\n    if (await exists(pointerPath, true)) {\n      logger.debug(\n        { pointerPath, commitHash: branchHeadCommit },\n        'File found in cache (commit hash)',\n      );\n      return pointerPath;\n    }\n  }\n\n  // If localFileOnly, check cache without making API calls\n  if (params.localFileOnly) {\n    logger.debug({ repoId, path: params.path, revision }, 'Local file only mode - checking cache');\n\n    // Check with revision as-is (in case it's a commit hash)\n    const directPath = getFilePointer(storageFolder, revision, params.path);\n    if (await exists(directPath, true)) {\n      logger.debug({ directPath }, 'File found in cache (direct path)');\n      return directPath;\n    }\n\n    // If revision is not a commit hash, try to resolve from refs\n    if (!REGEX_COMMIT_HASH.test(revision)) {\n      const refsPath = join(storageFolder, 'refs', revision);\n      try {\n        const { readFileSync } = await import('fs');\n        const resolvedHash = readFileSync(refsPath, 'utf-8').trim();\n        const resolvedPath = getFilePointer(storageFolder, resolvedHash, params.path);\n        if (await exists(resolvedPath, true)) {\n          logger.debug({ resolvedPath, resolvedHash }, 'File found in cache (via refs)');\n          return resolvedPath;\n        }\n      } catch {\n        logger.debug({ revision }, 'No ref mapping found for revision');\n      }\n    }\n\n    const error = `File not found in cache: ${repoId}/${params.path} (revision: ${revision}). Make sure to run the download-files command before running the agent worker.`;\n    logger.error({ repoId, path: params.path, revision }, error);\n    throw new Error(error);\n  }\n\n  // Get the branch HEAD commit if not already a commit hash\n  if (!branchHeadCommit) {\n    const headCommit = await getBranchHeadCommit(params.repo, revision, params);\n    if (!headCommit) {\n      throw new Error(`Failed to resolve revision ${revision} to commit hash`);\n    }\n    branchHeadCommit = headCommit;\n  }\n\n  // Check if file exists with the branch HEAD commit\n  const pointerPath = getFilePointer(storageFolder, branchHeadCommit, params.path);\n  if (await exists(pointerPath, true)) {\n    logger.debug({ pointerPath, branchHeadCommit }, 'File found in cache (branch HEAD)');\n\n    await saveRevisionMapping({\n      storageFolder,\n      revision,\n      commitHash: branchHeadCommit,\n    });\n\n    return pointerPath;\n  }\n\n  // Now get file metadata to download it\n  logger.debug(\n    { repoId, path: params.path, revision: branchHeadCommit },\n    'Fetching path info from HF API',\n  );\n  const pathsInformation: (PathInfo & { lastCommit: CommitInfo })[] = await pathsInfo({\n    ...params,\n    paths: [params.path],\n    revision: branchHeadCommit, // Use HEAD commit for consistency\n    expand: true,\n  });\n\n  if (!pathsInformation || pathsInformation.length !== 1) {\n    const error = `cannot get path info for ${params.path}`;\n    logger.error({ repoId, path: params.path, pathsInfoLength: pathsInformation?.length }, error);\n    throw new Error(error);\n  }\n\n  const pathInfo = pathsInformation[0];\n  if (!pathInfo) {\n    const error = `No path info returned for ${params.path}`;\n    logger.error({ repoId, path: params.path }, error);\n    throw new Error(error);\n  }\n\n  let etag: string;\n  if (pathInfo.lfs) {\n    etag = pathInfo.lfs.oid; // get the LFS pointed file oid\n    logger.debug({ etag, path: params.path }, 'File is LFS pointer');\n  } else {\n    etag = pathInfo.oid; // get the repo file if not a LFS pointer\n    logger.debug({ etag, path: params.path }, 'File is regular git object');\n  }\n\n  const blobPath = join(storageFolder, 'blobs', etag);\n\n  logger.debug({ branchHeadCommit, pointerPath, blobPath }, 'Computed cache paths');\n\n  // mkdir blob and pointer path parent directory\n  await mkdir(dirname(blobPath), { recursive: true });\n  await mkdir(dirname(pointerPath), { recursive: true });\n\n  // We might already have the blob but not the pointer\n  // shortcut the download if needed\n  if (await exists(blobPath)) {\n    logger.debug({ blobPath, etag }, 'Blob already exists in cache, creating symlink only');\n    // create symlinks in snapshot folder to blob object\n    await createSymlink(blobPath, pointerPath);\n    return pointerPath;\n  }\n\n  const incomplete = `${blobPath}.incomplete`;\n  logger.debug({ path: params.path, incomplete }, 'Starting file download');\n\n  // Use enhanced download with retry - use branch HEAD commit for download\n  const blob: Blob | null = await downloadFile({\n    ...params,\n    revision: branchHeadCommit,\n  });\n\n  if (!blob) {\n    const error = `invalid response for file ${params.path}`;\n    logger.error({ path: params.path }, error);\n    throw new Error(error);\n  }\n\n  logger.debug({ size: blob.size }, 'Writing blob to disk');\n  await pipeline(Readable.fromWeb(blob.stream() as ReadableStream), createWriteStream(incomplete));\n\n  // rename .incomplete file to expected blob\n  await rename(incomplete, blobPath);\n  logger.debug({ blobPath }, 'Renamed incomplete file to final blob');\n\n  // create symlinks in snapshot folder to blob object\n  await createSymlink(blobPath, pointerPath);\n  logger.debug({ blobPath, pointerPath }, 'Created symlink from snapshot to blob');\n\n  await saveRevisionMapping({\n    storageFolder,\n    revision,\n    commitHash: branchHeadCommit,\n  });\n\n  logger.debug({ pointerPath, size: blob.size }, 'File download completed successfully');\n  return pointerPath;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,iBAAqD;AACrD,oBAAoB;AACpB,qBAAiD;AACjD,sBAA2C;AAC3C,qBAAwB;AACxB,uBAAiD;AACjD,yBAAyB;AACzB,IAAAA,mBAAyB;AAQlB,MAAM,oBAA4B,IAAI,OAAO,gBAAgB;AAGpE,SAAS,kBAAkB,gBAAiC;AAC1D,SAAO,sBAAkB,2BAAK,wBAAQ,GAAG,UAAU,eAAe,KAAK;AACzE;AAEA,SAAS,kBAAkB,QAAwB;AACjD,SAAO,WAAW,OAAO,QAAQ,OAAO,IAAI,CAAC;AAC/C;AAEA,SAAS,SAAS,MAAwC;AACxD,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,GAAG,KAAK,IAAI;AACrB;AAKA,eAAe,oBACb,MACA,UACA,QACwB;AACxB,QAAM,aAAS,mBAAI;AAEnB,MAAI;AAEF,QAAI,kBAAkB,KAAK,QAAQ,GAAG;AACpC,aAAO;AAAA,IACT;AAGA,qBAAiB,cAAU,wBAAY;AAAA,MACrC;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL,CAAC,GAAG;AAEF,YAAM,aAAc,OAAe,OAAQ,OAAe,MAAO,OAAe;AAChF,UAAI,YAAY;AACd,eAAO;AAAA,MACT;AACA;AAAA,IACF;AAEA,WAAO,MAAM,EAAE,MAAM,SAAS,IAAI,GAAG,SAAS,GAAG,+BAA+B;AAChF,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO;AAAA,MACL,EAAE,OAAQ,MAAgB,SAAS,MAAM,SAAS,IAAI,GAAG,SAAS;AAAA,MAClE;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACF;AAKA,eAAe,cAAc,YAAoB,YAAmC;AAClF,QAAM,aAAS,mBAAI;AACnB,QAAM,EAAE,SAAS,IAAI,SAAS,IAAI,MAAM,OAAO,kBAAkB;AAGjE,WAAS,WAAW,MAAsB;AACxC,QAAI,KAAK,WAAW,GAAG,GAAG;AACxB,aAAO,KAAK,QAAQ,SAAK,wBAAQ,CAAC;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AAEA,QAAM,aAAS,0BAAQ,WAAW,UAAU,CAAC;AAC7C,QAAM,aAAS,0BAAQ,WAAW,UAAU,CAAC;AAG7C,MAAI;AACF,UAAM,GAAG,MAAM;AAAA,EACjB,QAAQ;AAAA,EAER;AAEA,MAAI;AAEF,UAAM,mBAAe,+BAAS,0BAAQ,MAAM,GAAG,MAAM;AACrD,UAAM,QAAQ,cAAc,MAAM;AAClC,WAAO,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,UAAU,aAAa,GAAG,iBAAiB;AAAA,EAC5F,SAAS,cAAc;AAGrB,WAAO,KAAK,EAAE,QAAQ,QAAQ,QAAQ,OAAO,GAAG,6CAA6C;AAC7F,QAAI;AACF,YAAM,SAAS,QAAQ,MAAM;AAC7B,aAAO,MAAM,EAAE,QAAQ,QAAQ,QAAQ,OAAO,GAAG,0BAA0B;AAAA,IAC7E,SAAS,WAAW;AAClB,aAAO;AAAA,QACL,EAAE,OAAQ,UAAoB,SAAS,QAAQ,QAAQ,QAAQ,OAAO;AAAA,QACtE;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,eAAe,eAAuB,UAAkB,kBAAkC;AACjG,QAAM,mBAAe,uBAAK,eAAe,WAAW;AACpD,aAAO,uBAAK,cAAc,UAAU,gBAAgB;AACtD;AAKA,eAAe,OAAO,MAAc,gBAA4C;AAC9E,MAAI;AACF,QAAI,gBAAgB;AAClB,gBAAM,sBAAK,IAAI;AAAA,IACjB,OAAO;AACL,gBAAM,uBAAM,IAAI;AAAA,IAClB;AACA,WAAO;AAAA,EACT,SAAS,KAAc;AACrB,WAAO;AAAA,EACT;AACF;AAEA,eAAe,oBAAoB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF,GAIkB;AAChB,MAAI,CAAC,kBAAkB,KAAK,QAAQ,KAAK,aAAa,YAAY;AAChE,UAAM,eAAW,uBAAK,eAAe,MAAM;AAC3C,cAAM,uBAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AACzC,0CAAc,uBAAK,UAAU,QAAQ,GAAG,UAAU;AAAA,EACpD;AACF;AAMA,eAAsB,uBACpB,QAuBiB;AACjB,QAAM,aAAS,mBAAI;AAGnB,QAAM,WAAW,OAAO,YAAY;AACpC,QAAM,WAAW,OAAO,YAAY,kBAAkB;AAEtD,QAAM,SAAS,SAAS,OAAO,IAAI;AAEnC,QAAM,oBAAgB,uBAAK,UAAU,kBAAkB,MAAM,CAAC;AAE9D,MAAI;AAGJ,MAAI,kBAAkB,KAAK,QAAQ,GAAG;AACpC,uBAAmB;AACnB,UAAMC,eAAc,eAAe,eAAe,UAAU,OAAO,IAAI;AACvE,QAAI,MAAM,OAAOA,cAAa,IAAI,GAAG;AACnC,aAAO;AAAA,QACL,EAAE,aAAAA,cAAa,YAAY,iBAAiB;AAAA,QAC5C;AAAA,MACF;AACA,aAAOA;AAAA,IACT;AAAA,EACF;AAGA,MAAI,OAAO,eAAe;AACxB,WAAO,MAAM,EAAE,QAAQ,MAAM,OAAO,MAAM,SAAS,GAAG,uCAAuC;AAG7F,UAAM,aAAa,eAAe,eAAe,UAAU,OAAO,IAAI;AACtE,QAAI,MAAM,OAAO,YAAY,IAAI,GAAG;AAClC,aAAO,MAAM,EAAE,WAAW,GAAG,mCAAmC;AAChE,aAAO;AAAA,IACT;AAGA,QAAI,CAAC,kBAAkB,KAAK,QAAQ,GAAG;AACrC,YAAM,eAAW,uBAAK,eAAe,QAAQ,QAAQ;AACrD,UAAI;AACF,cAAM,EAAE,aAAa,IAAI,MAAM,OAAO,IAAI;AAC1C,cAAM,eAAe,aAAa,UAAU,OAAO,EAAE,KAAK;AAC1D,cAAM,eAAe,eAAe,eAAe,cAAc,OAAO,IAAI;AAC5E,YAAI,MAAM,OAAO,cAAc,IAAI,GAAG;AACpC,iBAAO,MAAM,EAAE,cAAc,aAAa,GAAG,gCAAgC;AAC7E,iBAAO;AAAA,QACT;AAAA,MACF,QAAQ;AACN,eAAO,MAAM,EAAE,SAAS,GAAG,mCAAmC;AAAA,MAChE;AAAA,IACF;AAEA,UAAM,QAAQ,4BAA4B,MAAM,IAAI,OAAO,IAAI,eAAe,QAAQ;AACtF,WAAO,MAAM,EAAE,QAAQ,MAAM,OAAO,MAAM,SAAS,GAAG,KAAK;AAC3D,UAAM,IAAI,MAAM,KAAK;AAAA,EACvB;AAGA,MAAI,CAAC,kBAAkB;AACrB,UAAM,aAAa,MAAM,oBAAoB,OAAO,MAAM,UAAU,MAAM;AAC1E,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,8BAA8B,QAAQ,iBAAiB;AAAA,IACzE;AACA,uBAAmB;AAAA,EACrB;AAGA,QAAM,cAAc,eAAe,eAAe,kBAAkB,OAAO,IAAI;AAC/E,MAAI,MAAM,OAAO,aAAa,IAAI,GAAG;AACnC,WAAO,MAAM,EAAE,aAAa,iBAAiB,GAAG,mCAAmC;AAEnF,UAAM,oBAAoB;AAAA,MACxB;AAAA,MACA;AAAA,MACA,YAAY;AAAA,IACd,CAAC;AAED,WAAO;AAAA,EACT;AAGA,SAAO;AAAA,IACL,EAAE,QAAQ,MAAM,OAAO,MAAM,UAAU,iBAAiB;AAAA,IACxD;AAAA,EACF;AACA,QAAM,mBAA8D,UAAM,sBAAU;AAAA,IAClF,GAAG;AAAA,IACH,OAAO,CAAC,OAAO,IAAI;AAAA,IACnB,UAAU;AAAA;AAAA,IACV,QAAQ;AAAA,EACV,CAAC;AAED,MAAI,CAAC,oBAAoB,iBAAiB,WAAW,GAAG;AACtD,UAAM,QAAQ,4BAA4B,OAAO,IAAI;AACrD,WAAO,MAAM,EAAE,QAAQ,MAAM,OAAO,MAAM,iBAAiB,qDAAkB,OAAO,GAAG,KAAK;AAC5F,UAAM,IAAI,MAAM,KAAK;AAAA,EACvB;AAEA,QAAM,WAAW,iBAAiB,CAAC;AACnC,MAAI,CAAC,UAAU;AACb,UAAM,QAAQ,6BAA6B,OAAO,IAAI;AACtD,WAAO,MAAM,EAAE,QAAQ,MAAM,OAAO,KAAK,GAAG,KAAK;AACjD,UAAM,IAAI,MAAM,KAAK;AAAA,EACvB;AAEA,MAAI;AACJ,MAAI,SAAS,KAAK;AAChB,WAAO,SAAS,IAAI;AACpB,WAAO,MAAM,EAAE,MAAM,MAAM,OAAO,KAAK,GAAG,qBAAqB;AAAA,EACjE,OAAO;AACL,WAAO,SAAS;AAChB,WAAO,MAAM,EAAE,MAAM,MAAM,OAAO,KAAK,GAAG,4BAA4B;AAAA,EACxE;AAEA,QAAM,eAAW,uBAAK,eAAe,SAAS,IAAI;AAElD,SAAO,MAAM,EAAE,kBAAkB,aAAa,SAAS,GAAG,sBAAsB;AAGhF,YAAM,2BAAM,0BAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAClD,YAAM,2BAAM,0BAAQ,WAAW,GAAG,EAAE,WAAW,KAAK,CAAC;AAIrD,MAAI,MAAM,OAAO,QAAQ,GAAG;AAC1B,WAAO,MAAM,EAAE,UAAU,KAAK,GAAG,qDAAqD;AAEtF,UAAM,cAAc,UAAU,WAAW;AACzC,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,GAAG,QAAQ;AAC9B,SAAO,MAAM,EAAE,MAAM,OAAO,MAAM,WAAW,GAAG,wBAAwB;AAGxE,QAAM,OAAoB,UAAM,yBAAa;AAAA,IAC3C,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,CAAC;AAED,MAAI,CAAC,MAAM;AACT,UAAM,QAAQ,6BAA6B,OAAO,IAAI;AACtD,WAAO,MAAM,EAAE,MAAM,OAAO,KAAK,GAAG,KAAK;AACzC,UAAM,IAAI,MAAM,KAAK;AAAA,EACvB;AAEA,SAAO,MAAM,EAAE,MAAM,KAAK,KAAK,GAAG,sBAAsB;AACxD,YAAM,2BAAS,4BAAS,QAAQ,KAAK,OAAO,CAAmB,OAAG,kCAAkB,UAAU,CAAC;AAG/F,YAAM,wBAAO,YAAY,QAAQ;AACjC,SAAO,MAAM,EAAE,SAAS,GAAG,uCAAuC;AAGlE,QAAM,cAAc,UAAU,WAAW;AACzC,SAAO,MAAM,EAAE,UAAU,YAAY,GAAG,uCAAuC;AAE/E,QAAM,oBAAoB;AAAA,IACxB;AAAA,IACA;AAAA,IACA,YAAY;AAAA,EACd,CAAC;AAED,SAAO,MAAM,EAAE,aAAa,MAAM,KAAK,KAAK,GAAG,sCAAsC;AACrF,SAAO;AACT;","names":["import_promises","pointerPath"]}

package/dist/hf_utils.d.cts

@@ -0,0 +1,40 @@
+/**
+ * Fixed version of HuggingFace's downloadFileToCacheDir that matches Python's behavior
+ *
+ * Key fix: Uses branch/tag HEAD commit for snapshot paths, not file's last commit
+ * This ensures all files from the same revision end up in the same snapshot folder
+ */
+import type { RepoDesignation } from '@huggingface/hub';
+interface CredentialsParams {
+    accessToken?: string;
+}
+export declare const REGEX_COMMIT_HASH: RegExp;
+/**
+ * Download a given file if it's not already present in the local cache.
+ * Matches Python's hf_hub_download behavior by using branch HEAD commits.
+ */
+export declare function downloadFileToCacheDir(params: {
+    repo: RepoDesignation;
+    path: string;
+    /**
+     * If true, will download the raw git file.
+     */
+    raw?: boolean;
+    /**
+     * An optional Git revision id which can be a branch name, a tag, or a commit hash.
+     * @default "main"
+     */
+    revision?: string;
+    hubUrl?: string;
+    cacheDir?: string;
+    /**
+     * Custom fetch function to use instead of the default one
+     */
+    fetch?: typeof fetch;
+    /**
+     * If true, only return cached files, don't download
+     */
+    localFileOnly?: boolean;
+} & Partial<CredentialsParams>): Promise<string>;
+export {};
+//# sourceMappingURL=hf_utils.d.ts.map

package/dist/hf_utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Fixed version of HuggingFace's downloadFileToCacheDir that matches Python's behavior
+ *
+ * Key fix: Uses branch/tag HEAD commit for snapshot paths, not file's last commit
+ * This ensures all files from the same revision end up in the same snapshot folder
+ */
+import type { RepoDesignation } from '@huggingface/hub';
+interface CredentialsParams {
+    accessToken?: string;
+}
+export declare const REGEX_COMMIT_HASH: RegExp;
+/**
+ * Download a given file if it's not already present in the local cache.
+ * Matches Python's hf_hub_download behavior by using branch HEAD commits.
+ */
+export declare function downloadFileToCacheDir(params: {
+    repo: RepoDesignation;
+    path: string;
+    /**
+     * If true, will download the raw git file.
+     */
+    raw?: boolean;
+    /**
+     * An optional Git revision id which can be a branch name, a tag, or a commit hash.
+     * @default "main"
+     */
+    revision?: string;
+    hubUrl?: string;
+    cacheDir?: string;
+    /**
+     * Custom fetch function to use instead of the default one
+     */
+    fetch?: typeof fetch;
+    /**
+     * If true, only return cached files, don't download
+     */
+    localFileOnly?: boolean;
+} & Partial<CredentialsParams>): Promise<string>;
+export {};
+//# sourceMappingURL=hf_utils.d.ts.map

package/dist/hf_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf_utils.d.ts","sourceRoot":"","sources":["../src/hf_utils.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,OAAO,KAAK,EAAwB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAY9E,UAAU,iBAAiB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAqC,CAAC;AAgJtE;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE;IACN,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,CAsKjB"}

package/dist/hf_utils.js

@@ -0,0 +1,237 @@
+import { downloadFile, listCommits, pathsInfo } from "@huggingface/hub";
+import { log } from "@livekit/agents";
+import { createWriteStream, writeFileSync } from "node:fs";
+import { lstat, mkdir, rename, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, relative, resolve } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+const REGEX_COMMIT_HASH = new RegExp("^[0-9a-f]{40}$");
+function getHFHubCachePath(customCacheDir) {
+  return customCacheDir || join(homedir(), ".cache", "huggingface", "hub");
+}
+function getRepoFolderName(repoId) {
+  return `models--${repoId.replace(/\//g, "--")}`;
+}
+function toRepoId(repo) {
+  if (typeof repo === "string") {
+    return repo;
+  }
+  return `${repo.name}`;
+}
+async function getBranchHeadCommit(repo, revision, params) {
+  const logger = log();
+  try {
+    if (REGEX_COMMIT_HASH.test(revision)) {
+      return revision;
+    }
+    for await (const commit of listCommits({
+      repo,
+      revision,
+      ...params
+    })) {
+      const commitHash = commit.oid || commit.id || commit.commitId;
+      if (commitHash) {
+        return commitHash;
+      }
+      break;
+    }
+    logger.error({ repo: toRepoId(repo), revision }, "No commits found for revision");
+    return null;
+  } catch (error) {
+    logger.error(
+      { error: error.message, repo: toRepoId(repo), revision },
+      "Error getting HEAD commit"
+    );
+    throw error;
+  }
+}
+async function createSymlink(sourcePath, targetPath) {
+  const logger = log();
+  const { symlink, rm, copyFile } = await import("node:fs/promises");
+  function expandUser(path) {
+    if (path.startsWith("~")) {
+      return path.replace("~", homedir());
+    }
+    return path;
+  }
+  const absSrc = resolve(expandUser(sourcePath));
+  const absDst = resolve(expandUser(targetPath));
+  try {
+    await rm(absDst);
+  } catch {
+  }
+  try {
+    const relativePath = relative(dirname(absDst), absSrc);
+    await symlink(relativePath, absDst);
+    logger.debug({ source: absSrc, target: absDst, relative: relativePath }, "Created symlink");
+  } catch (symlinkError) {
+    logger.warn({ source: absSrc, target: absDst }, "Symlink not supported, falling back to copy");
+    try {
+      await copyFile(absSrc, absDst);
+      logger.debug({ source: absSrc, target: absDst }, "File copied successfully");
+    } catch (copyError) {
+      logger.error(
+        { error: copyError.message, source: absSrc, target: absDst },
+        "Failed to copy file"
+      );
+      throw symlinkError;
+    }
+  }
+}
+function getFilePointer(storageFolder, revision, relativeFilename) {
+  const snapshotPath = join(storageFolder, "snapshots");
+  return join(snapshotPath, revision, relativeFilename);
+}
+async function exists(path, followSymlinks) {
+  try {
+    if (followSymlinks) {
+      await stat(path);
+    } else {
+      await lstat(path);
+    }
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+async function saveRevisionMapping({
+  storageFolder,
+  revision,
+  commitHash
+}) {
+  if (!REGEX_COMMIT_HASH.test(revision) && revision !== commitHash) {
+    const refsPath = join(storageFolder, "refs");
+    await mkdir(refsPath, { recursive: true });
+    writeFileSync(join(refsPath, revision), commitHash);
+  }
+}
+async function downloadFileToCacheDir(params) {
+  const logger = log();
+  const revision = params.revision ?? "main";
+  const cacheDir = params.cacheDir ?? getHFHubCachePath();
+  const repoId = toRepoId(params.repo);
+  const storageFolder = join(cacheDir, getRepoFolderName(repoId));
+  let branchHeadCommit;
+  if (REGEX_COMMIT_HASH.test(revision)) {
+    branchHeadCommit = revision;
+    const pointerPath2 = getFilePointer(storageFolder, revision, params.path);
+    if (await exists(pointerPath2, true)) {
+      logger.debug(
+        { pointerPath: pointerPath2, commitHash: branchHeadCommit },
+        "File found in cache (commit hash)"
+      );
+      return pointerPath2;
+    }
+  }
+  if (params.localFileOnly) {
+    logger.debug({ repoId, path: params.path, revision }, "Local file only mode - checking cache");
+    const directPath = getFilePointer(storageFolder, revision, params.path);
+    if (await exists(directPath, true)) {
+      logger.debug({ directPath }, "File found in cache (direct path)");
+      return directPath;
+    }
+    if (!REGEX_COMMIT_HASH.test(revision)) {
+      const refsPath = join(storageFolder, "refs", revision);
+      try {
+        const { readFileSync } = await import("fs");
+        const resolvedHash = readFileSync(refsPath, "utf-8").trim();
+        const resolvedPath = getFilePointer(storageFolder, resolvedHash, params.path);
+        if (await exists(resolvedPath, true)) {
+          logger.debug({ resolvedPath, resolvedHash }, "File found in cache (via refs)");
+          return resolvedPath;
+        }
+      } catch {
+        logger.debug({ revision }, "No ref mapping found for revision");
+      }
+    }
+    const error = `File not found in cache: ${repoId}/${params.path} (revision: ${revision}). Make sure to run the download-files command before running the agent worker.`;
+    logger.error({ repoId, path: params.path, revision }, error);
+    throw new Error(error);
+  }
+  if (!branchHeadCommit) {
+    const headCommit = await getBranchHeadCommit(params.repo, revision, params);
+    if (!headCommit) {
+      throw new Error(`Failed to resolve revision ${revision} to commit hash`);
+    }
+    branchHeadCommit = headCommit;
+  }
+  const pointerPath = getFilePointer(storageFolder, branchHeadCommit, params.path);
+  if (await exists(pointerPath, true)) {
+    logger.debug({ pointerPath, branchHeadCommit }, "File found in cache (branch HEAD)");
+    await saveRevisionMapping({
+      storageFolder,
+      revision,
+      commitHash: branchHeadCommit
+    });
+    return pointerPath;
+  }
+  logger.debug(
+    { repoId, path: params.path, revision: branchHeadCommit },
+    "Fetching path info from HF API"
+  );
+  const pathsInformation = await pathsInfo({
+    ...params,
+    paths: [params.path],
+    revision: branchHeadCommit,
+    // Use HEAD commit for consistency
+    expand: true
+  });
+  if (!pathsInformation || pathsInformation.length !== 1) {
+    const error = `cannot get path info for ${params.path}`;
+    logger.error({ repoId, path: params.path, pathsInfoLength: pathsInformation == null ? void 0 : pathsInformation.length }, error);
+    throw new Error(error);
+  }
+  const pathInfo = pathsInformation[0];
+  if (!pathInfo) {
+    const error = `No path info returned for ${params.path}`;
+    logger.error({ repoId, path: params.path }, error);
+    throw new Error(error);
+  }
+  let etag;
+  if (pathInfo.lfs) {
+    etag = pathInfo.lfs.oid;
+    logger.debug({ etag, path: params.path }, "File is LFS pointer");
+  } else {
+    etag = pathInfo.oid;
+    logger.debug({ etag, path: params.path }, "File is regular git object");
+  }
+  const blobPath = join(storageFolder, "blobs", etag);
+  logger.debug({ branchHeadCommit, pointerPath, blobPath }, "Computed cache paths");
+  await mkdir(dirname(blobPath), { recursive: true });
+  await mkdir(dirname(pointerPath), { recursive: true });
+  if (await exists(blobPath)) {
+    logger.debug({ blobPath, etag }, "Blob already exists in cache, creating symlink only");
+    await createSymlink(blobPath, pointerPath);
+    return pointerPath;
+  }
+  const incomplete = `${blobPath}.incomplete`;
+  logger.debug({ path: params.path, incomplete }, "Starting file download");
+  const blob = await downloadFile({
+    ...params,
+    revision: branchHeadCommit
+  });
+  if (!blob) {
+    const error = `invalid response for file ${params.path}`;
+    logger.error({ path: params.path }, error);
+    throw new Error(error);
+  }
+  logger.debug({ size: blob.size }, "Writing blob to disk");
+  await pipeline(Readable.fromWeb(blob.stream()), createWriteStream(incomplete));
+  await rename(incomplete, blobPath);
+  logger.debug({ blobPath }, "Renamed incomplete file to final blob");
+  await createSymlink(blobPath, pointerPath);
+  logger.debug({ blobPath, pointerPath }, "Created symlink from snapshot to blob");
+  await saveRevisionMapping({
+    storageFolder,
+    revision,
+    commitHash: branchHeadCommit
+  });
+  logger.debug({ pointerPath, size: blob.size }, "File download completed successfully");
+  return pointerPath;
+}
+export {
+  REGEX_COMMIT_HASH,
+  downloadFileToCacheDir
+};
+//# sourceMappingURL=hf_utils.js.map