paperclipai/paperclip · error

Plugin ${manifest.id} requires host version ${minimumHostVer

Error message

Plugin ${manifest.id} requires host version ${minimumHostVersion} or newer, but this server is running ${hostVersion}

What it means

Host-compatibility guard in fetchAndValidate: the plugin's minimumHostVersion exceeds the running server's hostVersion. The plugin requires features/fixes this host lacks and must not be loaded; the version mismatch between manifest and host is at fault.

Source

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

      );
    }

    // Step 5: Validate manifest capabilities are consistent
    const capResult = capabilityValidator.validateManifestCapabilities(manifest);
    if (!capResult.allowed) {
      throw new Error(
        `Plugin ${manifest.id} manifest has inconsistent capabilities. ` +
          `Missing required capabilities for declared features: ${capResult.missing.join(", ")}`,
      );
    }

    await assertPageRoutePathsAvailable(manifest);

    // Step 6: Reject plugins that require a newer host than the running server
    const minimumHostVersion = getMinimumHostVersion(manifest);
    if (minimumHostVersion && hostVersion) {
      if (compareSemver(hostVersion, minimumHostVersion) < 0) {
        throw new Error(
          `Plugin ${manifest.id} requires host version ${minimumHostVersion} or newer, ` +
            `but this server is running ${hostVersion}`,
        );
      }
    }

    // Use the version declared in the manifest (required field per the spec)
    const resolvedVersion = manifest.version;

    return {
      packagePath: resolvedPackagePath,
      packageName: resolvedPackageName,
      version: resolvedVersion,
      source: localPath ? "local-filesystem" : "npm",
      manifest,
    };
  }

View on GitHub (pinned to 120ae5428f)

Solutions

1. Upgrade the Paperclip server to at least the required host version, or install an older plugin version compatible with this host.

When it happens

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

Common situations: See trigger scenarios.

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