paperclipai/paperclip · error · Error

No handler registered for job "${params.job.jobKey}"

Error message

No handler registered for job "${params.job.jobKey}"

What it means

Dispatch guard in the worker RPC host (startWorkerRpcHost / handleRunJob): the host asked the plugin worker to run a job whose jobKey was never registered via the job-handler registration API. The requested background job simply has no implementation in this plugin, so the RPC call fails rather than silently no-oping.

Source

Thrown at packages/plugins/sdk/src/worker-rpc-host.ts:1861

    }

    if (plugin.definition.onConfigChanged) {
      await plugin.definition.onConfigChanged(params.config, {
        companyId: incomingCompanyId,
      });
    }
  }

  async function handleOnEvent(params: OnEventParams): Promise<void> {
    const event = params.event;

    for (const registration of eventHandlers) {
      // Check event type match
      const exactMatch = registration.name === event.eventType;
      const wildcardPluginAll =
        registration.name === "plugin.*" &&
        event.eventType.startsWith("plugin.");
      const wildcardPluginOne =
        registration.name.endsWith(".*") &&
        event.eventType.startsWith(registration.name.slice(0, -1));

      if (!exactMatch && !wildcardPluginAll && !wildcardPluginOne) continue;

      // Check filter
      if (registration.filter && !allowsEvent(registration.filter, event)) continue;

      try {
        await registration.fn(event);
      } catch (err) {
        // Log error but continue processing other handlers so one failing
        // handler doesn't prevent the rest from running.
        notifyHost("log", {
          level: "error",
          message: `Event handler for "${registration.name}" failed: ${
            err instanceof Error ? err.message : String(err)
          }`,

View on GitHub (pinned to 01ad858492)

Solutions

1. Register a job handler for the job key, or use a registered job key.

When it happens

Trigger: Thrown at packages/plugins/sdk/src/worker-rpc-host.ts:1810 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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