paperclipai/paperclip · error

Unknown adapter type: ${adapterType}

Error message

Unknown adapter type: ${adapterType}

What it means

Error "Unknown adapter type: ${adapterType}" thrown in paperclipai/paperclip.

Source

Thrown at packages/plugins/sandbox-providers/kubernetes/src/adapter-defaults.ts:90

/**
 * Resolve the runtime defaults for an adapter. When a `registry` is supplied it
 * is authoritative (replace semantics): the type MUST be present and complete,
 * else this throws. With no registry, falls back to the built-in REGISTRY.
 */
export function getAdapterDefaults(
  adapterType: string,
  registry?: readonly AdapterRegistryEntry[],
): AdapterDefaults {
  if (registry && registry.length > 0) {
    const entry = registry.find((e) => e.adapterType === adapterType);
    if (!entry) {
      throw new Error(`Adapter "${adapterType}" is not in the configured adapter registry`);
    }
    return fromRegistryEntry(entry);
  }
  const defaults = REGISTRY[adapterType];
  if (!defaults) {
    throw new Error(`Unknown adapter type: ${adapterType}`);
  }
  return defaults;
}

/**
 * Resolve the adapter type for a single run: prefer the run's adapter (the agent's,
 * from the lease params) so one environment can serve mixed harnesses; fall back to
 * the environment's configured default adapter when the run does not specify one.
 */
export function resolveRunAdapterType(
  runAdapterType: string | null | undefined,
  configAdapterType: string,
): string {
  const trimmed = typeof runAdapterType === "string" ? runAdapterType.trim() : "";
  return trimmed.length > 0 ? trimmed : configAdapterType;
}

/**

View on GitHub (pinned to 120ae5428f)

Solutions

1. Use a known adapter type; check available adapters.

When it happens

Trigger: Thrown at packages/plugins/sandbox-providers/kubernetes/src/adapter-defaults.ts:90 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/61c09ec9a32f4144. Report an issue: GitHub.