Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

2.4 KB
Raw Blame
// Shared parsing of huggingface_hub gated-access error text. Both the image
// runner (server/services/imageGen/local.js) and the LoRA trainer
// (server/services/loraTraining/failure.js) hit gated-repo failures and want
// to deep-link the user to the model's license page — so the `owner/name`
// extraction lives here once instead of being re-regexed per subsystem.
//
// Pure, no side effects.

// Matches the gated-access message shapes every runner emits:
//   "Access to model <repo> is restricted …"   (mflux wrapper / hub GatedRepoError prose)
//   "Access to <repo> is restricted. Visit …"   (torch _runner_common, no "model")
//   "Cannot access gated repo for url https://huggingface.co/<repo>/…"
//   any "…huggingface.co/<owner>/<repo>…" URL  (the torch message's "Visit <url>")
// `model` is optional; the bare `huggingface.co/` branch catches the URL forms.
// The optional backtick tolerates markdown-wrapped repo ids; the trailing
// `.git` strip normalizes clone-style refs. extractGatedRepo is only called
// once a failure is already classified as gated, so matching a HF URL here is
// the gated repo by construction (no false-positive risk on benign output).
export const GATED_REPO_RE = /(?:Access to (?:model )?|huggingface\.co\/)`?([\w.-]+\/[\w.-]+)/i;

export function extractGatedRepo(text = '') {
  const match = String(text).match(GATED_REPO_RE);
  return match ? match[1].replace(/\.git$/, '') : null;
}

// Classifies a huggingface_hub failure as a *gated-access* error (a 403 on a
// restricted repo the user hasn't been granted) — distinct from a benign
// download hiccup. Shared by the image runner's prose fallback
// (server/services/imageGen/local.js) and the MIDI transcription classifier
// (server/services/audioMidiTranscription.js). Deliberately narrow (no bare
// "403 Client Error", which also fires on unrelated auth failures) so
// extractGatedRepo is only invoked once the error is genuinely gated. The LoRA
// trainer (server/services/loraTraining/failure.js) keeps its own HF_AUTH_RE
// because it also matches bare "401 Client Error", which this regex omits to
// stay false-positive-free for the download paths.
export const GATED_ERROR_RE = /GatedRepoError|Access to (?:model )?[\w.@/-]+ is restricted|Cannot access gated repo|Repo.*is gated/i;

export function isGatedRepoError(text = '') {
  return GATED_ERROR_RE.test(String(text));
}