E_PLUGIN_NOT_FOUND

— · Resolution

How to recover

Run `npm install <package>` from the workspace root. Verify the package name matches workspace.json exactly.

— · The shape

What an instance looks like

throw new AgentryError({
  code: 'E_PLUGIN_NOT_FOUND',
  phase: 'init',
  message: '…contextual message…',
  context: { /* adapter-specific */ },
  suggestedFix: 'Run `npm install <package>` from the workspace root. Verify the package name matches workspace.json exactly.',
  docs: 'https://openagentry.dev/errors/E_PLUGIN_NOT_FOUND',
});

The context field carries adapter-specific detail (HTTP status, missing env-var names, validation issues). It never contains secret values.

— · See also

Related codes from @openagentry/cli

• E_PLUGIN_BAD_EXPORT Plugin module is missing an adapter shape on its default export.
• E_PLUGIN_CATEGORY_MISMATCH Manifest declares one category but the runtime adapter exports a different one.
• E_PLUGIN_LAYOUT Could not locate the plugin's `package.json` near its resolved entry point.
• E_PLUGIN_PACKAGE_JSON A plugin's package.json is not valid JSON.
• E_PLUGIN_NO_MANIFEST Plugin's package.json is missing the `openagentry` manifest block.
• E_WORKSPACE_EXISTS agentry init refused to overwrite an existing `.agentry/workspace.json`.
• E_WORKSPACE_CONFIG_READ Could not read `.agentry/workspace.json`.
• E_WORKSPACE_CONFIG_INVALID `.agentry/workspace.json` failed schema validation.