paperclipai/paperclip · error · Error

Plugin not found: ${pluginId}

Error message

Plugin not found: ${pluginId}

What it means

Lookup guard in getPluginRecord: no plugin row exists for the given pluginId in the registry. Generic sentinel for any plugin-scoped database operation (migrations, namespace, runtime) targeting an unknown or already-uninstalled plugin; the bad pluginId is at fault.

Source

Thrown at server/src/services/plugin-database.ts:362

}

type PluginDatabaseClient = Pick<Db, "select" | "insert" | "update" | "execute">;
type PluginDatabaseRootClient = PluginDatabaseClient & Partial<Pick<Db, "transaction">>;

export interface ApplyPluginMigrationsOptions {
  /**
   * Persist failed migration ledger rows. Fresh install uses false because the
   * caller owns a larger transaction and must roll back the plugin row and
   * namespace together.
   */
  persistFailure?: boolean;
}

export function pluginDatabaseService(db: PluginDatabaseRootClient) {
  async function getPluginRecord(pluginId: string) {
    const rows = await db.select().from(plugins).where(eq(plugins.id, pluginId)).limit(1);
    const plugin = rows[0];
    if (!plugin) throw new Error(`Plugin not found: ${pluginId}`);
    return plugin;
  }

  async function ensureNamespaceWithClient(
    client: PluginDatabaseClient,
    pluginId: string,
    manifest: PaperclipPluginManifestV1,
  ) {
    if (!manifest.database) return null;
    const namespaceName = derivePluginDatabaseNamespace(
      manifest.id,
      manifest.database.namespaceSlug,
    );
    await client.execute(sql.raw(`CREATE SCHEMA IF NOT EXISTS ${quoteIdentifier(namespaceName)}`));
    const rows = await client
      .insert(pluginDatabaseNamespaces)
      .values({
        pluginId,

View on GitHub (pinned to 120ae5428f)

Solutions

1. Verify the plugin id is installed for the company; install the plugin first if needed.

When it happens

Trigger: Thrown at server/src/services/plugin-database.ts:362 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/4f59fad9d777eb6c. Report an issue: GitHub.