[embeddings] agentic-flow neural extras unavailable — skippi

Error message

[embeddings] agentic-flow neural extras unavailable — skipping eager model download. Models will be fetched lazily by @xenova/transformers on first generate. Reason: ${msg}

What it means

Error "[embeddings] agentic-flow neural extras unavailable — skipping eager model download. Models will be fetched lazily by @xenova/transformers on first generate. Reason: ${msg}" thrown in ruvnet/ruflo.

Source

Thrown at v3/@claude-flow/embeddings/src/neural-integration.ts:333

    return await (downloadFn as (id: string, dir: string, cb?: typeof onProgress) => Promise<string>)(
      modelId, targetDir ?? '.models', onProgress
    );
  } catch (err) {
    const msg = err instanceof Error ? err.message : String(err);
    // Distinguish "package missing" / "subpath unsupported" from real
    // download errors so callers can surface the right hint to users.
    // #1468: Windows + Node strict-ESM raises
    //   `Package subpath './embeddings' is not defined by "exports"`
    // when the bundled agentic-flow's package.json doesn't declare the
    // ./embeddings entry. WSL/Linux is more permissive on the same code,
    // so the bug only surfaces on Windows. Treat both shapes as
    // "agentic-flow neural extras unavailable, fall back to lazy fetch".
    if (
      /Cannot find package 'agentic-flow'|Cannot find module/.test(msg)
      || /Package subpath ['"]\.\/embeddings['"] is not defined/.test(msg)
      || /ERR_PACKAGE_PATH_NOT_EXPORTED/.test(msg)
    ) {
      console.warn('[embeddings] agentic-flow neural extras unavailable — skipping eager model download. ' +
        'Models will be fetched lazily by @xenova/transformers on first generate. ' +
        `Reason: ${msg}`);
      return targetDir ?? '.models';
    }
    throw err;
  }
}

View on GitHub (pinned to fa13ee4ad6)

Solutions

No action needed; models are fetched lazily on first generate. Install agentic-flow neural extras to enable eager download.

When it happens

Trigger: Thrown at v3/@claude-flow/embeddings/src/neural-integration.ts:333 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/ee8d0b49997da559. Report an issue: GitHub.