> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vendo.run/llms.txt
> Use this file to discover all available pages before exploring further.

# E-DEP-001

> Doctor found an installed ai package outside the major versions @vendoai/vendo supports.

Vendo speaks **both** live AI SDK majors — `ai@6` and `ai@7` — so this check
only fires outside that pair. Above it:

```text deps/ai-sdk-major theme={null}
broken: installed ai@<version> is a major Vendo has never been run against —
Vendo speaks ai@6 and ai@7; pin one (npm install ai@^7 @ai-sdk/anthropic@^4
@ai-sdk/react@^4) or track github.com/runvendo/vendo/issues/478
```

Below it, an older-than-6 install gets a different message:

```text deps/ai-sdk-major theme={null}
broken: installed ai@<version> predates the ai@6 peer contract — every turn
fails at runtime; upgrade: <bump command>
```

`check: deps/ai-sdk-major` · `error_code: E-DEP-001` · `doctor exits: 1`

## What you're seeing

Every static check passes. Then every internal Vendo turn fails, because
`@vendoai/vendo` drives your `ai` package with call shapes that major does not
accept — and npm installs the peer conflict without failing on its own.

## Why

Vendo's peer range is `ai >=6 <8`, and its suites run against both majors. A
major above that pair has never been run at all; a pre-v6 `ai` predates the
call shapes entirely. The pre-v6 case is usually a hoisted copy: another
package in the workspace depends on `ai@5`, the workspace root hoists it, and
your app resolves that copy because it never declared its own.

## The fix

Pin `ai` to either supported major, with the `@ai-sdk/*` majors that pair with
it — 4 with `ai@7`, 3 with `ai@6`.

```bash theme={null}
npm install ai@^7 @ai-sdk/anthropic@^4 @ai-sdk/react@^4
```

For a pre-v6 `ai`, giving the app its own copy is enough.

```bash theme={null}
npm install ai@^6
```

In a workspace whose root pins another package's `ai@5`, an override or
packageExtension (`resolutions`, pnpm `overrides`, yarn `packageExtensions`)
also works. Re-run `npx vendo doctor` once the resolved version is in range.

## Related errors

* [E-DEP-003](/production/troubleshooting/e-dep-003): the same peer-floor problem, for `zod` instead of `ai`
* [E-DEP-002](/production/troubleshooting/e-dep-002): a version mismatch between the CLI and the running wire, not a dependency floor