Could not load instance settings to determine which environm

Error message

Could not load instance settings to determine which environment to test in. Retry the test.

What it means

The adapter environment test needs instance settings to decide which environment to probe, and the settings fetch failed (or had not settled) when the test ran. The test fails honestly with this diagnostic instead of silently probing the wrong (host) environment.

Source

Thrown at ui/src/components/AgentConfigForm.tsx:868

      // never hit. The raw id is sent even for a local environment — the
      // server resolves the driver and probes the host in that case.
      //
      // Test can be clicked before the settings query settles (or after it
      // failed with retry:false), so when the agent relies on the instance
      // default, resolve the settings here rather than trusting the
      // render-time cache. A fetch that still fails FAILS the test with an
      // honest diagnostic — silently probing the host instead would report
      // the exact false command-not-found failure this resolution exists to
      // fix. Agents with their own environment never need the settings.
      let settings = instanceSettings;
      if (!rawCurrentDefaultEnvironmentId && settings === undefined) {
        try {
          settings = await queryClient.ensureQueryData({
            queryKey: queryKeys.instance.settings,
            queryFn: () => instanceSettingsApi.get(),
          });
        } catch {
          throw new Error(
            "Could not load instance settings to determine which environment to test in. Retry the test.",
          );
        }
      }
      const environmentId = resolveAdapterTestEnvironmentId({
        agentDefaultEnvironmentId: rawCurrentDefaultEnvironmentId || null,
        instanceDefaultEnvironmentId: settings?.defaultEnvironmentId ?? null,
      });
      const testResults: Array<{ label: string; model: string | null; result: AdapterEnvironmentTestResult }> = [
        {
          label: "Primary model",
          model: primaryModel,
          result: await runEnvironmentTestCase(
            "Primary model",
            primaryModel,
            buildAdapterConfigForTest(adapterConfigPatch),
            environmentId,
          ),

View on GitHub (pinned to a7e689b3c3)

Solutions

Retry the environment test; if it persists, reload the page so instance settings load, then test again.

Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at ui/src/components/AgentConfigForm.tsx:856 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/1a7e6e989dfa92e9. Report an issue: GitHub.