paperclipai/paperclip · error · EnvironmentRunError

environment_inactive

environment_inactive

Error message

Environment "${environment.name}" is not active (status: ${environment.status}).

What it means

EnvironmentRunError from resolveEnvironment: the environment row exists but its status is not active (e.g. archived or paused). Runs may only target active environments, so orchestration aborts with the environment's name and current status.

Source

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

    companyId: string;
    selectedEnvironmentId: string;
    localEnvironmentId: string;
  }): Promise<Environment> {
    const environmentId = input.selectedEnvironmentId || input.localEnvironmentId;

    const environment =
      environmentId === input.localEnvironmentId
        ? await environmentsSvc.ensureLocalEnvironment(input.companyId)
        : await environmentsSvc.getById(environmentId);

    if (!environment) {
      throw new EnvironmentRunError("environment_not_found", `Environment "${environmentId}" not found.`, {
        environmentId,
      });
    }

    if (environment.status !== "active") {
      throw new EnvironmentRunError("environment_inactive", `Environment "${environment.name}" is not active (status: ${environment.status}).`, {
        environmentId: environment.id,
        driver: environment.driver,
      });
    }

    return environment;
  }

  /**
   * Acquire an environment lease for a heartbeat run.
   * Wraps the runtime driver's acquire call with standardized error handling.
   */
  async function acquireLease(input: {
    companyId: string;
    environment: Environment;
    issueId: string | null;
    agentId: string;
    heartbeatRunId: string;

View on GitHub (pinned to 120ae5428f)

Solutions

1. Reactivate the environment (or wait for activation) before running; check its status in the environments list.

When it happens

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