paperclipai/paperclip · error · EnvironmentRunError

transport_resolution_failed

transport_resolution_failed

Error message

Failed to resolve execution transport for "${input.environment.name}": ${err instanceof Error ? err.message : String(err)}

What it means

EnvironmentRunError wrapper around resolveEnvironmentExecutionTransport: resolving the execution transport for the adapter/environment combination threw. The cause's message is embedded; the run cannot continue without a transport to execute on.

Source

Thrown at server/src/services/environment-run-orchestrator.ts:244

  /**
   * Resolve the execution transport for an adapter based on the acquired lease.
   */
  async function resolveTransport(input: {
    companyId: string;
    adapterType: string;
    environment: Environment;
    leaseMetadata: Record<string, unknown> | null;
  }): Promise<Record<string, unknown> | null> {
    try {
      return await resolveEnvironmentExecutionTransport({
        db,
        companyId: input.companyId,
        adapterType: input.adapterType,
        environment: input.environment,
        leaseMetadata: input.leaseMetadata,
      });
    } catch (err) {
      throw new EnvironmentRunError(
        "transport_resolution_failed",
        `Failed to resolve execution transport for "${input.environment.name}": ${err instanceof Error ? err.message : String(err)}`,
        {
          environmentId: input.environment.id,
          driver: input.environment.driver,
          cause: err,
        },
      );
    }
  }

  /**
   * Full acquisition flow: resolve environment, acquire lease, resolve transport.
   * This is the primary entry point for heartbeat run setup.
   */
  async function acquireForRun(input: {
    companyId: string;
    selectedEnvironmentId: string;

View on GitHub (pinned to 120ae5428f)

Solutions

1. Check the environment driver/transport configuration and the error detail in the message, then retry.

When it happens

Trigger: Thrown at server/src/services/environment-run-orchestrator.ts:244 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/e70e544a28cbcb98. Report an issue: GitHub.