vercel/ai · error · Error

ACP lifecycle state is incompatible with the configured impl

Error message

ACP lifecycle state is incompatible with the configured implementation.

What it means

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

Source

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

  lifecycleData,
  sandboxId,
}: {
  harnessId: string;
  lifecycleHarnessId: string;
  implementationIdentity: string;
  authenticationProfile: ACPAuthenticationProfileIdentity;
  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(

View on GitHub (pinned to 69428b1f8b)

When it happens

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

Common situations: See trigger scenarios.

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