{"record":{"id":"e70e544a28cbcb98","repo":"paperclipai/paperclip","slug":"transport-resolution-failed","errorCode":"transport_resolution_failed","errorMessage":"Failed to resolve execution transport for \"${input.environment.name}\": ${err instanceof Error ? err.message : String(err)}","messagePattern":"Failed to resolve execution transport for \"(.+?)\": (.+?)","errorType":"exception","errorClass":"EnvironmentRunError","httpStatus":null,"severity":"error","filePath":"server/src/services/environment-run-orchestrator.ts","lineNumber":244,"sourceCode":"  /**\n   * Resolve the execution transport for an adapter based on the acquired lease.\n   */\n  async function resolveTransport(input: {\n    companyId: string;\n    adapterType: string;\n    environment: Environment;\n    leaseMetadata: Record<string, unknown> | null;\n  }): Promise<Record<string, unknown> | null> {\n    try {\n      return await resolveEnvironmentExecutionTransport({\n        db,\n        companyId: input.companyId,\n        adapterType: input.adapterType,\n        environment: input.environment,\n        leaseMetadata: input.leaseMetadata,\n      });\n    } catch (err) {\n      throw new EnvironmentRunError(\n        \"transport_resolution_failed\",\n        `Failed to resolve execution transport for \"${input.environment.name}\": ${err instanceof Error ? err.message : String(err)}`,\n        {\n          environmentId: input.environment.id,\n          driver: input.environment.driver,\n          cause: err,\n        },\n      );\n    }\n  }\n\n  /**\n   * Full acquisition flow: resolve environment, acquire lease, resolve transport.\n   * This is the primary entry point for heartbeat run setup.\n   */\n  async function acquireForRun(input: {\n    companyId: string;\n    selectedEnvironmentId: string;","sourceCodeStart":226,"sourceCodeEnd":262,"githubUrl":"https://github.com/paperclipai/paperclip/blob/120ae5428fa29bee300bcf806491cd4d965fbb7c/server/src/services/environment-run-orchestrator.ts#L226-L262","documentation":"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.","triggerScenarios":"Thrown at server/src/services/environment-run-orchestrator.ts:244 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the environment driver/transport configuration and the error detail in the message, then retry."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"120ae5428fa29bee300bcf806491cd4d965fbb7c","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}