fix(vscode): improve autocomplete error messages to cover BYOK and credits scenarios

[markijbema]

Summary

• Improves the autocomplete paused notification messages to clearly explain all possible causes for authentication and payment errors
• 402 (payment required): Now mentions both exhausted Kilo credits and BYOK API key quota limits, so users with their own keys understand the error applies to them too
• 401/403 (auth error): Now mentions both not being signed in to Kilo and an invalid/missing API key (BYOK), so users with BYOK configurations know to check their API key settings

Context

When autocomplete fails with a 402, 401, or 403 error, a VS Code warning popup is shown. Previously:

• The 402 message only mentioned Kilo account credits, but 402s also occur when a BYOK provider's API key has reached its quota
• The 401/403 message said "Please sign in again" but gave no hint that an invalid BYOK API key is a common cause

The gateway (kilo-gateway.ts) returns 401 for both missing Kilo auth and BYOK key resolution failures. It passes through 402 from upstream providers when quota is exhausted — whether that's Kilo's gateway or a BYOK provider. The VS Code client (AutocompleteServiceManager.ts) maps these to user-visible messages without knowing which underlying cause triggered them, so both causes must be described.

Changes

Only packages/kilo-vscode/src/services/autocomplete/i18n/en.ts is changed — this is the sole source of autocomplete error strings (the autocomplete i18n system only has an English file; no other language files exist for these keys).

Built for Mark IJbema by Kilo for Slack

[kilo-code-bot]

Code Review Summary

Status: 1 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	1
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-vscode/src/services/autocomplete/i18n/en.ts	45	The updated 402 popup now mentions BYOK quota exhaustion, but the only available action still routes users to the Kilo credits page.

Fix these issues in Kilo Cloud

Files Reviewed (2 files)

• .changeset/fix-autocomplete-error-messages.md
• packages/kilo-vscode/src/services/autocomplete/i18n/en.ts - 1 issue

Previous Review Summaries (3 snapshots, latest commit 3f3b8a4)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 3f3b8a4)

Status: 1 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	1
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-vscode/src/services/autocomplete/shims/i18n.ts	8	Delegating these autocomplete strings through the shared CLI-backend resolver reintroduces the br locale collision, so Breton (br, br-FR) users will get Brazilian Portuguese warnings instead of the English fallback.

Fix these issues in Kilo Cloud

Files Reviewed (42 files)

• packages/kilo-vscode/src/services/autocomplete/i18n/ar.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/br.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/bs.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/da.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/de.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/es.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/fr.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/index.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/it.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/ja.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/ko.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/nl.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/no.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/pl.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/ru.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/th.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/tr.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/uk.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/zh.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/zht.ts
• packages/kilo-vscode/src/services/autocomplete/shims/i18n.ts - 1 issue
• packages/kilo-vscode/src/services/cli-backend/i18n/ar.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/br.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/bs.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/da.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/de.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/en.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/es.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/fr.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/it.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/ja.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/ko.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/nl.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/no.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/pl.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/ru.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/th.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/tr.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/uk.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/zh.ts
• packages/kilo-vscode/src/services/cli-backend/i18n/zht.ts
• packages/kilo-vscode/tests/unit/i18n-shim.test.ts

Previous review (commit ad830ab)

Status: 1 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	1
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-vscode/src/services/autocomplete/i18n/index.ts	55	The generic locale prefix scan also maps the valid BCP 47 br locale to the Brazilian Portuguese bundle.

Fix these issues in Kilo Cloud

Files Reviewed (22 files)

• packages/kilo-vscode/src/services/autocomplete/i18n/ar.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/br.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/bs.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/da.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/de.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/es.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/fr.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/index.ts - 1 issue
• packages/kilo-vscode/src/services/autocomplete/i18n/it.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/ja.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/ko.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/nl.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/no.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/pl.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/ru.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/th.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/tr.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/uk.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/zh.ts
• packages/kilo-vscode/src/services/autocomplete/i18n/zht.ts
• packages/kilo-vscode/src/services/autocomplete/shims/i18n.ts
• packages/kilo-vscode/tests/unit/i18n-shim.test.ts

Previous review (commit 17d00b6)

Status: 1 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	1
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-vscode/src/services/autocomplete/i18n/en.ts	45	The 402 popup now mentions BYOK quota exhaustion, but the only action still routes users to the Kilo credits page.

Fix these issues in Kilo Cloud

Files Reviewed (2 files)

• .changeset/fix-autocomplete-error-messages.md
• packages/kilo-vscode/src/services/autocomplete/i18n/en.ts - 1 issue

---

_{Reviewed by gpt-5.4-20260305 · Input: 50.7K · Output: 5.4K · Cached: 209.4K}

_{Review guidance: REVIEW.md from base branch main}