paperclipai/paperclip · error · Error

Plugin issue originKind must be a string

Error message

Plugin issue originKind must be a string

What it means

normalizePluginOriginKind received a non-string originKind value from the plugin (a number, object, etc.). The default plugin:<pluginKey> kind applies only for null/empty; any other value must be a string so it can be namespaced and validated.

Source

Thrown at server/src/services/plugin-host-services.ts:1040

    return {
      ...(details ?? {}),
      sourcePluginId: pluginId,
      sourcePluginKey: pluginKey,
      initiatingActorType,
      initiatingActorId,
      initiatingAgentId: actor?.actorAgentId ?? null,
      initiatingUserId: actor?.actorUserId ?? null,
      initiatingRunId: actor?.actorRunId ?? null,
      pluginId,
      pluginKey,
    };
  };

  const defaultPluginOriginKind = `plugin:${pluginKey}`;
  const normalizePluginOriginKind = (originKind: unknown = defaultPluginOriginKind) => {
    if (originKind == null || originKind === "") return defaultPluginOriginKind;
    if (typeof originKind !== "string") {
      throw new Error("Plugin issue originKind must be a string");
    }
    if (originKind === defaultPluginOriginKind || originKind.startsWith(`${defaultPluginOriginKind}:`)) {
      return originKind;
    }
    throw new Error(`Plugin may only use originKind values under ${defaultPluginOriginKind}`);
  };

  const assertReadableOriginFilter = (originKind: unknown) => {
    if (typeof originKind !== "string" || !originKind.startsWith("plugin:")) return;
    normalizePluginOriginKind(originKind);
  };

  const logPluginActivity = async (input: {
    companyId: string;
    action: string;
    entityType: string;
    entityId: string;
    details?: Record<string, unknown> | null;

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Pass issue originKind as a string value in the plugin host call; remove non-string (number/object/null) values from the request payload.

When it happens

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

Common situations: See trigger scenarios.

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