vercel/ai · error · Error

ACP lifecycle state is incompatible with the configured auth

Error message

ACP lifecycle state is incompatible with the configured authentication profile.

What it means

Error "ACP lifecycle state is incompatible with the configured authentication profile." thrown in vercel/ai.

Source

Thrown at packages/harness-acp/src/v1/acp-v1-lifecycle.ts:79

  lifecycleData: ACPLifecycleData;
  sandboxId: string | undefined;
}): void {
  if (lifecycleHarnessId !== harnessId) {
    throw new Error(
      `ACP lifecycle state was produced by harness ${JSON.stringify(
        lifecycleHarnessId,
      )}, but this harness is ${JSON.stringify(harnessId)}.`,
    );
  }
  if (lifecycleData.implementationIdentity !== implementationIdentity) {
    throw new Error(
      'ACP lifecycle state is incompatible with the configured implementation.',
    );
  }
  if (
    lifecycleData.authenticationProfile?.digest !== authenticationProfile.digest
  ) {
    throw new Error(
      'ACP lifecycle state is incompatible with the configured authentication profile.',
    );
  }
  const expectedSandboxId = lifecycleData.bridge?.sandboxId;
  if (
    expectedSandboxId != null &&
    sandboxId != null &&
    expectedSandboxId !== sandboxId
  ) {
    throw new Error(
      `ACP lifecycle state belongs to sandbox ${JSON.stringify(
        expectedSandboxId,
      )}, not ${JSON.stringify(sandboxId)}.`,
    );
  }
}

View on GitHub (pinned to 69428b1f8b)

When it happens

Trigger: Thrown at packages/harness-acp/src/v1/acp-v1-lifecycle.ts:79 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.

AI-assisted analysis of vercel/ai@69428b1f8b (2026-08-30). Data as JSON: /api/errors/2c90f10e2a840ef6. Report an issue: GitHub.