git:20260730.bdaaac4 to git:20260731.250ac8d

17 added, 8 removed. Audit A to A.

# clients/ — Agent Guidance

Applies to all code under `clients/`. Subordinate to root [`AGENTS.md`](../AGENTS.md).

## Conventions

- - JavaScript client packages are members of the root Bun workspace and use the

- root `bun.lock`. Native shell directories such as `ios/` and `android/`

- consume Capacitor dependencies from `web/` and do not need package manifests.

+ - `clients/web/`, `clients/macos/`, and `clients/docs/` are members of the

+ root bun workspace: the single root `bun.lock` covers them, and

+ `bun install` anywhere in the tree resolves to the workspace root (scope

+ with `--filter=@vellumai/<name>` when needed). Each keeps its own

+ `package.json`, `tsconfig.json`, and lint config.

+ - `clients/chrome-extension/` is the one standalone package, with its own

+ `bun.lock` and per-package `bun install`. Native shell directories

+ (`clients/ios/`, `clients/android/`) are Capacitor shells built from

+ `clients/web/` and have no package manifests of their own.

- Exact version pinning is enforced repo-wide; see root `AGENTS.md` for the

dependency, license, and tool-version rules.

- All current client apps use bundlers (`clients/web/` via Vite,

- `clients/macos/` via electron-vite) and therefore use

- `moduleResolution: "Bundler"` with `module: "ESNext"`. Bundler-mode apps

- omit `.js` extensions on imports. If a future client compiles without a

- bundler, use NodeNext with `.js` extensions (matching `assistant/`,

- `gateway/`, `cli/`).

+ `clients/macos/` via electron-vite, `clients/docs/` via Next.js) and

+ therefore use `moduleResolution: "Bundler"` with `module: "ESNext"`.

+ Bundler-mode apps omit `.js` extensions on imports. If a future client

+ compiles without a bundler, use NodeNext with `.js` extensions (matching

+ `assistant/`, `gateway/`, `cli/`).

+ - `clients/docs/` is the public docs site: an SSR Next.js app serving

+ www.vellum.ai/docs. See [`clients/docs/AGENTS.md`](docs/AGENTS.md) for its

+ URL, theme, and attribution contracts.

## Adding a new client

When adding a new subdirectory under `clients/`, add a corresponding `paths:`

glob to relevant PR/CI workflows in `.github/workflows/`, and add an

appropriate ignore pattern to `.gitignore` if the client produces build

artifacts.