Failed to auto-build bundled local plugin ${packageName}${ti

Error message

Failed to auto-build bundled local plugin ${packageName}${timeoutMessage}. Run `${manualBuildCommand}` from the repo root and retry.${stderrMessage}

What it means

Auto-build failure in ensureLocalPluginBuilt: running the build commands for a bundled local plugin failed (non-zero exit or timeout at LOCAL_PLUGIN_AUTOBUILD_TIMEOUT_MS). Message includes stderr and the manual build command; the local plugin's build (missing toolchain/deps) is at fault.

Source

Thrown at server/src/services/plugin-loader.ts:914

  });

  try {
    for (const command of buildCommands) {
      await runExecFileAsync(
        command.file,
        command.args,
        { cwd: command.cwd, timeout: LOCAL_PLUGIN_AUTOBUILD_TIMEOUT_MS },
      );
    }
  } catch (error) {
    const stderr = typeof (error as { stderr?: unknown }).stderr === "string"
      ? (error as { stderr: string }).stderr.trim()
      : "";
    const timeoutMessage = (error as { killed?: unknown }).killed === true
      ? ` after timing out at ${LOCAL_PLUGIN_AUTOBUILD_TIMEOUT_MS}ms`
      : "";
    const stderrMessage = stderr.length > 0 ? ` stderr: ${stderr}` : "";
    throw new Error(
      `Failed to auto-build bundled local plugin ${packageName}${timeoutMessage}. ` +
        `Run \`${manualBuildCommand}\` from the repo root and retry.${stderrMessage}`,
    );
  }

  const stillMissingEntrypoints = listMissingDeclaredPluginEntrypoints(packageRoot, pkgJson);
  const stillMissingStandaloneRuntimeDeps = isStandaloneBundledPluginPath(packageRoot, { repoRoot: options.repoRoot })
    ? listMissingStandaloneBundledPluginRuntimeDependencies(packageRoot, pkgJson)
    : [];
  if (stillMissingEntrypoints.length > 0 || stillMissingStandaloneRuntimeDeps.length > 0) {
    const missingDetails: string[] = [];
    if (stillMissingEntrypoints.length > 0) {
      missingDetails.push(`built entrypoints: ${stillMissingEntrypoints.map((entrypoint) => entrypoint.key).join(", ")}`);
    }
    if (stillMissingStandaloneRuntimeDeps.length > 0) {
      missingDetails.push(`runtime dependencies: ${stillMissingStandaloneRuntimeDeps.join(", ")}`);
    }
    throw new Error(

View on GitHub (pinned to 120ae5428f)

Solutions

Run the printed manual build command from the repo root (e.g. pnpm --filter <package> build), resolve any build errors shown in stderr, then retry loading the plugin.

Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at server/src/services/plugin-loader.ts:914 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/53ed657e108348a4. Report an issue: GitHub.