{"record":{"id":"cafdb2306e0549ee","repo":"paperclipai/paperclip","slug":"plugin-manifest-id-requires-host-version-mini","errorCode":null,"errorMessage":"Plugin ${manifest.id} requires host version ${minimumHostVersion} or newer, but this server is running ${hostVersion}","messagePattern":"Plugin (.+?) requires host version (.+?) or newer, but this server is running (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"server/src/services/plugin-loader.ts","lineNumber":1311,"sourceCode":"      );\n    }\n\n    // Step 5: Validate manifest capabilities are consistent\n    const capResult = capabilityValidator.validateManifestCapabilities(manifest);\n    if (!capResult.allowed) {\n      throw new Error(\n        `Plugin ${manifest.id} manifest has inconsistent capabilities. ` +\n          `Missing required capabilities for declared features: ${capResult.missing.join(\", \")}`,\n      );\n    }\n\n    await assertPageRoutePathsAvailable(manifest);\n\n    // Step 6: Reject plugins that require a newer host than the running server\n    const minimumHostVersion = getMinimumHostVersion(manifest);\n    if (minimumHostVersion && hostVersion) {\n      if (compareSemver(hostVersion, minimumHostVersion) < 0) {\n        throw new Error(\n          `Plugin ${manifest.id} requires host version ${minimumHostVersion} or newer, ` +\n            `but this server is running ${hostVersion}`,\n        );\n      }\n    }\n\n    // Use the version declared in the manifest (required field per the spec)\n    const resolvedVersion = manifest.version;\n\n    return {\n      packagePath: resolvedPackagePath,\n      packageName: resolvedPackageName,\n      version: resolvedVersion,\n      source: localPath ? \"local-filesystem\" : \"npm\",\n      manifest,\n    };\n  }\n","sourceCodeStart":1293,"sourceCodeEnd":1329,"githubUrl":"https://github.com/paperclipai/paperclip/blob/120ae5428fa29bee300bcf806491cd4d965fbb7c/server/src/services/plugin-loader.ts#L1293-L1329","documentation":"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.","triggerScenarios":"Thrown at server/src/services/plugin-loader.ts:1311 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade the Paperclip server to at least the required host version, or install an older plugin version compatible with this host."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"120ae5428fa29bee300bcf806491cd4d965fbb7c","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}