vercel/ai · error

Invalid ACP implementation descriptor.

Error message

Invalid ACP implementation descriptor.

What it means

Error "Invalid ACP implementation descriptor." thrown in vercel/ai.

Source

Thrown at packages/harness-acp/src/v1/bridge/index.ts:868

async function readImplementationDescriptor({
  path,
}: {
  path: string;
}): Promise<ImplementationDescriptor> {
  const text = await readFile(path, 'utf8');
  const value = await new Response(text, {
    headers: { 'content-type': 'application/json' },
  }).json();
  if (
    !isRecord(value) ||
    typeof value.executablePath !== 'string' ||
    typeof value.privateHome !== 'boolean' ||
    !Array.isArray(value.args) ||
    !value.args.every(item => typeof item === 'string') ||
    !Array.isArray(value.envKeys) ||
    !value.envKeys.every(item => typeof item === 'string')
  ) {
    throw new Error('Invalid ACP implementation descriptor.');
  }
  return {
    executablePath: value.executablePath,
    privateHome: value.privateHome,
    args: value.args as string[],
    envKeys: value.envKeys as string[],
  };
}

function parseArgs({ args }: { args: ReadonlyArray<string> }): {
  workDir?: string;
  bridgeStateDir?: string;
  implementationDir?: string;
  bridgeType?: string;
} {
  const result: {
    workDir?: string;
    bridgeStateDir?: string;

View on GitHub (pinned to 69428b1f8b)

When it happens

Trigger: Thrown at packages/harness-acp/src/v1/bridge/index.ts:868 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/f2d2d567478c03fc. Report an issue: GitHub.