diff --git a/docs/writing-a-plugin.md b/docs/writing-a-plugin.md index 302e7a9..036ceda 100644 --- a/docs/writing-a-plugin.md +++ b/docs/writing-a-plugin.md @@ -83,7 +83,7 @@ Write the numbers on the provider page, as `providers/vercel.md` does for its sp | Kind | Reads | Add a source by | |---|---|---| | `plugins/openapi` | An OpenAPI spec per release, diffed with `core/diff/` and turned into events by `core/normalize/` | An `adapter.Adapter` in `plugins/openapi/adapter/` (latest tag, fetch a tag's spec; `Versions` to list every release) and a `plugin.RegisterProvider` block | -| `plugins/notices` | A live page of dated notices: a model provider's deprecations page (a table of date, model, replacement: Markdown or Markdoc), a vendor's RSS or Atom feed, a vendor's table of whole API version ranges and their support status | A `retire.Page` in `plugins/notices/retire/providers.go`, a `feed.Feed` with a reader for that vendor's entries in `plugins/notices/feed/`, or an `eol.Page` in `plugins/notices/eol/` (`new-plugin` doesn't scaffold this reader yet) | +| `plugins/notices` | A live page of dated notices: a model provider's deprecations page (a table of date, model, replacement: Markdown, Markdoc or HTML), a vendor's RSS or Atom feed, a vendor's table of whole API version ranges and their support status | A `retire.Page` in `plugins/notices/retire/providers.go`, a `feed.Feed` with a reader for that vendor's entries in `plugins/notices/feed/`, or an `eol.Page` in `plugins/notices/eol/` (`new-plugin` doesn't scaffold this reader yet) | | `plugins/migrationguide` | A guide that lists what a release removed, at the release's tag: an SDK's migration guide per new major (removed request parameters), or a package's table of removed members (an RST simple table or a Markdown pipe table) | A `sdkguide.Guide` in `plugins/migrationguide/sdkguide/`, or a `members.Guide` in `plugins/migrationguide/members/` | | `plugins/changelog` | A changelog: a `CHANGELOG.md` / `CHANGES.rst` / `HISTORY.rst`, each release's section at its tag (releases from PyPI or npm), or a vendor's machine-readable API changelog in JSON (per day, endpoint and API version, oasdiff change codes), commit by commit | A `changelog.File` with its `TagPrefix`, or a `changelog.Log` | | `plugins/catalog` | A provider's own structured list of what it offers: a command catalog kept as one JSON file per command in its repo, read at each release tag and compared for commands that disappeared entirely | A `catalog.Commands` (repo, directory, release tag pattern); a catalog of another shape is a new reader type in the package | diff --git a/plugins/notices/google_test.go b/plugins/notices/google_test.go index c8d72f2..7ea3e49 100644 --- a/plugins/notices/google_test.go +++ b/plugins/notices/google_test.go @@ -66,8 +66,24 @@ func TestGeminiDropsModelsWithNoDateAndAgents(t *testing.T) { } } +// The pinned drop test for Vertex AI: a GA model's "June 28, 2027 or +// later" is how long it's kept at least, not a retirement. The Gemini image +// models' table has four such rows and one dated retirement +// (gemini-2.5-flash-image, March 15, 2027): one event. The same table with +// the dates plain would give five. +func TestVertexDropsAMinimumLifetime(t *testing.T) { + ga := section(t, "retire/testdata/vertex-model-versions.html", `

]*>(.*?)|]*>(.*?)`) + htmlRow = regexp.MustCompile(`(?is)]*>(.*?)`) + htmlCell = regexp.MustCompile(`(?is)]*>(.*?)`) + htmlCode = regexp.MustCompile(`(?is)]*>(.*?)`) + htmlTag = regexp.MustCompile(`<[^>]+>`) + htmlNewline = regexp.MustCompile(`\s+`) +) + +// htmlPipes reads an HTML page's tables into pipe tables, each under the +// heading above it; becomes a code span, every other tag goes. +func htmlPipes(page []byte) []byte { + var out []string + for _, m := range htmlTable.FindAllStringSubmatch(string(page), -1) { + if m[1] != "" { + level, _ := strconv.Atoi(m[1]) + out = append(out, strings.Repeat("#", level)+" "+htmlText(m[2])) + continue + } + var rows [][]string + for _, r := range htmlRow.FindAllStringSubmatch(m[3], -1) { + var row []string + for _, c := range htmlCell.FindAllStringSubmatch(r[1], -1) { + row = append(row, htmlText(htmlCode.ReplaceAllString(c[1], "`$1`"))) + } + if len(row) > 0 { + rows = append(rows, row) + } + } + out = append(out, pipeTable(rows)...) + } + return []byte(strings.Join(out, "\n") + "\n") +} + +func htmlText(s string) string { + return strings.TrimSpace(htmlNewline.ReplaceAllString(html.UnescapeString(htmlTag.ReplaceAllString(s, " ")), " ")) +} + // pipeTable writes rows (the first the header) as a Markdown pipe table, // escaping a pipe inside a cell. func pipeTable(rows [][]string) []string { diff --git a/plugins/notices/retire/providers.go b/plugins/notices/retire/providers.go index d25a9b5..882cdf0 100644 --- a/plugins/notices/retire/providers.go +++ b/plugins/notices/retire/providers.go @@ -71,3 +71,18 @@ var Gemini = Page{ Keep: googleModel.MatchString, Earliest: true, } + +// Vertex is Google Cloud's Vertex AI model versions page (checked +// 2026-11-21): HTML tables of | Model ID | Release date | Retirement date | +// Replacement model ID | (or Recommended upgrade). A GA model's date is a +// minimum lifetime ("October 13, 2027 or later", "No sooner than May 20, +// 2028"), not a notice, and isn't read as a date; a retired or retiring +// model's is a plain date ("June 30, 2026"). +var Vertex = Page{ + API: "google/vertex-model-retirements", + Provider: "google", + Vendor: "Google", + URL: "https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + Format: FormatHTML, + Keep: googleModel.MatchString, +} diff --git a/plugins/notices/retire/retire.go b/plugins/notices/retire/retire.go index e7e7646..16d383a 100644 --- a/plugins/notices/retire/retire.go +++ b/plugins/notices/retire/retire.go @@ -6,8 +6,9 @@ // A page is a Markdown pipe table (OpenAI's and Anthropic's pages, served as // markdown at their URL plus ".md", checked 2026-10-13), a Markdoc table // (Google's Gemini API page, {% table %} with one "* cell" per line, checked -// 2026-11-21), read into pipe rows first, with its headings, so one parser -// reads every page. A table is a retirement +// 2026-11-21), or an HTML table (Google Cloud's Vertex AI model versions, +// checked 2026-11-21). The last two are read into pipe rows first, with +// their headings, so one parser reads every page. A table is a retirement // table when it has a shutdown or retirement date column, a model column and // a replacement column, in any order. The event cites a Wayback Machine // snapshot of the page (kit/), never the live page: the contract requires a @@ -29,7 +30,7 @@ type Page struct { API string // the source id the events carry: "openai/models" Provider string // the model subject's provider: "openai" Vendor string // for sentences: "OpenAI" - URL string // the page, as markdown + URL string // the page, as markdown or HTML // Format is how the page writes its tables: Markdown pipe tables (the // default), Markdoc or HTML. Format Format @@ -48,6 +49,7 @@ type Format string const ( FormatMarkdown Format = "" FormatMarkdoc Format = "markdoc" + FormatHTML Format = "html" ) // Retirement is one model name the provider stops serving on Date, with the @@ -72,6 +74,8 @@ func (f Format) Pipes(page []byte) []byte { switch f { case FormatMarkdoc: return markdocPipes(page) + case FormatHTML: + return htmlPipes(page) } return page } diff --git a/plugins/notices/retire/testdata/README.md b/plugins/notices/retire/testdata/README.md index 23e2600..05a2b3c 100644 --- a/plugins/notices/retire/testdata/README.md +++ b/plugins/notices/retire/testdata/README.md @@ -2,7 +2,7 @@ The two providers' deprecations pages, as markdown (each page's URL plus `.md`). `retire`'s tests and the `openai-models` / `anthropic-models` golden tests (`plugins/notices`) read them. -**License:** excerpts for testing; © OpenAI and © Anthropic respectively. Not covered by this repo's license. Google's page is © Google, CC BY 4.0 (Google's developer documentation). +**License:** excerpts for testing; © OpenAI and © Anthropic respectively. Not covered by this repo's license. Google's two pages are © Google, CC BY 4.0 (Google's developer documentation). **Trimmed.** Each file keeps the page title and, for every retirement table that names at least one model the plugin keeps (text models code sends), the section heading above it and the whole table, copied unchanged. Prose, notice-period policy, endpoint tables and tables of only image, audio or embedding models were left out. `retire.Parse` returns exactly the same retirements from the trimmed and the full pages, so the golden files didn't change. @@ -11,3 +11,4 @@ The two providers' deprecations pages, as markdown (each page's URL plus `.md`). | `openai-deprecations.md` | https://developers.openai.com/api/docs/deprecations.md | 2026-10-13 | "\| October 23, 2026 \| `gpt-4-0613` \\\| `gpt-4`, … \| `gpt-5.6-sol` \|" | | `anthropic-deprecations.md` | https://platform.claude.com/docs/en/about-claude/model-deprecations.md | 2026-10-13 | "\| November 30, 2026 \| `claude-sonnet-4-5-20250929` \| `claude-sonnet-5-5` \|" | | `gemini-deprecations.md` | https://aistudio.google.com/docs/deprecations (where https://ai.google.dev/gemini-api/docs/deprecations redirects; served as Markdown). Kept whole, byte for byte | 2026-11-21 | "\| `gemini-2.0-flash` \| February 5, 2025 \| June 1, 2026 \| `gemini-3.6-flash` \|", as Markdoc `* cell` lines | +| `vertex-model-versions.html` | https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions. Excerpt: every `

`/`

` line and every line of every `` (982 of 10,074 lines), unchanged; scripts, navigation and prose left out. `retire.Parse` finds the same 39 retirements in the excerpt as in the full page | 2026-11-21 | "<td>June 30, 2026</td>" in the "Retired models" table | diff --git a/plugins/notices/retire/testdata/vertex-model-versions.html b/plugins/notices/retire/testdata/vertex-model-versions.html new file mode 100644 index 0000000..ff7398c --- /dev/null +++ b/plugins/notices/retire/testdata/vertex-model-versions.html @@ -0,0 +1,982 @@ +

Latest available models

+

Models available for at least 12 months after release

+

Gemini models

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateReplacement model ID
+ + gemini-4-argon + + October 13, 2026 + + October 13, 2027 or later + + + +
+ + gemini-3.8-live + + September 24, 2026 + + September 25, 2027 or later + + + +
+ + gemini-3.8-flash + + September 2, 2026 + + September 2, 2027 or later + + + +
+ + gemini-3.5-flash-lite + + July 21, 2026 + + July 21, 2027 or later + + + +
+ + gemini-3.5-flash + + May 19, 2026 + + May 19, 2027 or later + + + +
+ + gemini-3.1-flash-lite + + May 7, 2026 + + May 7, 2027 or later + + + +
+ + gemini-2.5-pro + + June 17, 2025 + + October 20, 2026 + + + + + gemini-3.8-flash or + gemini-3.5-flash + +
+ + gemini-2.5-flash + + June 17, 2025 + + October 20, 2026 + + + + + gemini-3.8-flash or + gemini-3.5-flash-lite + +
+ + gemini-2.5-flash-lite + + July 22, 2025 + + October 20, 2026 + + + + + gemini-3.8-flash or + gemini-3.5-flash-lite or Gemma 4 + +
+ + gemini-live-2.5-flash-native-audio + + December 12, 2025 + + December 13, 2026 + + + + + gemini-3.8-live + +
+

Gemini image models

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateReplacement model ID
+ + gemini-3.1-flash-lite-image + + June 23, 2026 + + June 28, 2027 or later + + + +
+ + gemini-3-pro-image + + May 28, 2026 + + May 28, 2027 or later + + + +
+ + gemini-3.1-flash-image + + May 28, 2026 + + May 28, 2027 or later + + + +
+ + gemini-2.5-flash-image + + October 2, 2025 + + March 15, 2027 + + + + + gemini-3.1-flash-lite-image + +
+

Gemini Omni models

+ + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateReplacement model ID
+ + gemini-omni-1.2-flash + + November 5, 2026 + + November 5, 2027 or later + + + +
+

Veo models

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateReplacement model ID
+ + veo-3.1-generate-001 + + November 17, 2025 + + May 4, 2027 or later + + + + + gemini-omni-1.2-flash + +
+ + veo-3.1-fast-generate-001 + + November 17, 2025 + + May 4, 2027 or later + + + + + gemini-omni-1.2-flash + +
+

Embeddings models

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateReplacement model ID
gemini-embedding-2April 22, 2026
gemini-embedding-001May 20, 2025No sooner than May 20, 2028
text-embedding-005November 18, 2024April 1, 2027
text-embedding-004May 14, 2024April 1, 2027
text-multilingual-embedding-002May 14, 2024April 1, 2027
multimodalembedding@001February 12, 2024April 1, 2027

+

Models available for shorter availability periods

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateReplacement model ID
+ + gemini-4-neon + + November 18, 2026 + + No retirement date announced + + + +
+ + gemini-4-hydrogen + + November 12, 2026 + + No retirement date announced + + + +
+ + gemini-4-carbon + + November 10, 2026 + + No retirement date announced + + + +
+ + gemini-4-carbon-cyber-permissive + + November 10, 2026 + + No retirement date announced + + + +
+ + gemini-4-argon-cyber-permissive + + October 13, 2026 + + No retirement date announced + + + +
+ + gemini-3.8-flash-cyber + + September 16, 2026 + + No retirement date announced + + + +
+ + gemini-3.7-flash + + August 13, 2026 + + January 28, 2027 + + + + + gemini-4-hydrogen + +
+ + gemini-3.6-flash + + July 21, 2026 + + January 28, 2027 + + + + + gemini-4-hydrogen + +
+ + gemini-nano-banana-2.1 + + October 6, 2026 + + No retirement date announced + + + +
+

Retired models

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model IDRelease dateRetirement dateRecommended upgrade
veo-3.0-generate-001July 29, 2025June 30, 2026veo-3.1-generate-001
veo-3.0-fast-generate-001July 29, 2025June 30, 2026veo-3.1-fast-generate-001
veo-2.0-generate-001May 27, 2025June 30, 2026veo-3.1-generate-001
imagen-4.0-generate-001August 14, 2025June 30, 2026gemini-2.5-flash-image
imagen-4.0-ultra-generate-001August 14, 2025June 30, 2026gemini-2.5-flash-image
imagen-3.0-generate-002January 29, 2025June 30, 2026gemini-2.5-flash-image
imagen-3.0-generate-001December 10, 2024June 30, 2026gemini-2.5-flash-image
imagegeneration@006March 27, 2024June 30, 2026gemini-2.5-flash-image
imagegeneration@005November 22, 2023June 30, 2026gemini-2.5-flash-image
imagegeneration@004June 30, 2026gemini-2.5-flash-image
imagegeneration@003June 30, 2026gemini-2.5-flash-image
imagegeneration@002August 17, 2023June 30, 2026gemini-2.5-flash-image
gemini-2.0-flashFebruary 5, 2025June 1, 2026gemini-3.5-flash-lite
gemini-2.0-flash-liteFebruary 25, 2025June 1, 2026gemini-3.5-flash-lite
gemini-1.5-pro-001May 24, 2024May 24, 2025gemini-2.5-flash
gemini-1.5-pro-002September 24, 2024September 24, 2025gemini-2.5-flash
gemini-1.5-flash-001May 24, 2024May 24, 2025gemini-2.5-flash-lite
gemini-1.5-flash-002September 24, 2024September 24, 2025gemini-2.5-flash-lite
textembedding-gecko@003*December 12, 2023May 24, 2025gemini-embedding-001
textembedding-gecko-multilingual@001November 2, 2023May 24, 2025gemini-embedding-001
gemini-1.0-pro-001February 15, 2024April 21, 2025gemini-2.5-flash
gemini-1.0-pro-002April 9, 2024April 21, 2025gemini-2.5-flash
gemini-1.0-pro-vision-001February 15, 2024April 21, 2025gemini-2.5-flash
text-bisonMay 2023April 21, 2025gemini-2.5-flash-lite
chat-bisonMay 2023April 21, 2025gemini-2.5-flash-lite
code-geckoMay 2023April 21, 2025gemini-2.5-flash-lite
textembedding-gecko@002November 2, 2023April 21, 2025gemini-embedding-001
textembedding-gecko@001June 7, 2023April 21, 2025gemini-embedding-001
imagetextJune 7, 2023September 24, 2025gemini-2.5-flash-image
+

Migrate to a latest available model

+

What's next

+ + + + diff --git a/plugins/notices/retirements_golden_test.go b/plugins/notices/retirements_golden_test.go index 1949d70..28b3d25 100644 --- a/plugins/notices/retirements_golden_test.go +++ b/plugins/notices/retirements_golden_test.go @@ -14,9 +14,10 @@ import ( // of the unchanged page asks for no snapshot. func TestRetirementsGolden(t *testing.T) { for file, page := range map[string]retire.Page{ - "openai-deprecations.md": retire.OpenAI, - "anthropic-deprecations.md": retire.Anthropic, - "gemini-deprecations.md": retire.Gemini, + "openai-deprecations.md": retire.OpenAI, + "anthropic-deprecations.md": retire.Anthropic, + "gemini-deprecations.md": retire.Gemini, + "vertex-model-versions.html": retire.Vertex, } { t.Run(page.API, func(t *testing.T) { saved := kittest.Pages{page.URL: "retire/testdata/" + file} diff --git a/plugins/notices/retirements_registered_test.go b/plugins/notices/retirements_registered_test.go index 99f0f28..7d020eb 100644 --- a/plugins/notices/retirements_registered_test.go +++ b/plugins/notices/retirements_registered_test.go @@ -8,7 +8,7 @@ import ( ) func TestRetirementsRegisterThemselves(t *testing.T) { - for _, p := range []retire.Page{retire.OpenAI, retire.Anthropic, retire.Gemini} { + for _, p := range []retire.Page{retire.OpenAI, retire.Anthropic, retire.Gemini, retire.Vertex} { kittest.Registered(t, Plugin{Page: p}) } } diff --git a/plugins/notices/testdata/golden/google-vertex-model-retirements.json b/plugins/notices/testdata/golden/google-vertex-model-retirements.json new file mode 100644 index 0000000..6f6fc8d --- /dev/null +++ b/plugins/notices/testdata/golden/google-vertex-model-retirements.json @@ -0,0 +1,765 @@ +[ + { + "id": 1, + "fingerprint": "sha256:ef43ad5bf96238c1c0f4c9e81332efaa8e9e859831388779052f805d89d4babb", + "api": "google/vertex-model-retirements", + "version": "2026-10-20", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-pro" + }, + "description": "Model \"gemini-2.5-pro\" is shut down on 2026-10-20: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Gemini models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-2.5-pro` | June 17, 2025 | October 20, 2026 | `gemini-3.8-flash` or `gemini-3.5-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 2, + "fingerprint": "sha256:599e4f28d4387bf45611fdd8781d9a46b553fd4e8607eb1212b4bd9684f88982", + "api": "google/vertex-model-retirements", + "version": "2026-10-20", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash" + }, + "description": "Model \"gemini-2.5-flash\" is shut down on 2026-10-20: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Gemini models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-2.5-flash` | June 17, 2025 | October 20, 2026 | `gemini-3.8-flash` or `gemini-3.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 3, + "fingerprint": "sha256:8627eb166cc0481d849b3f4a6a41df8dcacfb3cfb780b78907421cbc9916a8ce", + "api": "google/vertex-model-retirements", + "version": "2026-10-20", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-lite" + }, + "description": "Model \"gemini-2.5-flash-lite\" is shut down on 2026-10-20: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Gemini models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-2.5-flash-lite` | July 22, 2025 | October 20, 2026 | `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 4, + "fingerprint": "sha256:616b469e2bd6dee6f2a2a02d7e8e575e7bb1bc940ff8ed740a0c092be3ca3bf1", + "api": "google/vertex-model-retirements", + "version": "2026-12-13", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-live-2.5-flash-native-audio", + "replacement": "gemini-3.8-live" + }, + "description": "Model \"gemini-live-2.5-flash-native-audio\" is shut down on 2026-12-13: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-live` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Gemini models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-live-2.5-flash-native-audio` | December 12, 2025 | December 13, 2026 | `gemini-3.8-live` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 5, + "fingerprint": "sha256:925571477afb104ac207094b15e93155a25d6f98baf62c651aedf0801415ad39", + "api": "google/vertex-model-retirements", + "version": "2027-03-15", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-image", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"gemini-2.5-flash-image\" is shut down on 2027-03-15: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Gemini image models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-2.5-flash-image` | October 2, 2025 | March 15, 2027 | `gemini-3.1-flash-lite-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 6, + "fingerprint": "sha256:fd4cc7a2c302199b382abe71f33cf4c81a018d9489eec9194a0bfc6151351791", + "api": "google/vertex-model-retirements", + "version": "2027-04-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "text-embedding-005" + }, + "description": "Model \"text-embedding-005\" is shut down on 2027-04-01: Google requests naming it fail from that date.", + "migration_hint": "Google names no replacement model.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Embeddings models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `text-embedding-005` | November 18, 2024 | April 1, 2027 | |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 7, + "fingerprint": "sha256:174bced505f842a3e620a58fc0cb37092aa503454ab1dbdf37f74a6e2d3294e9", + "api": "google/vertex-model-retirements", + "version": "2027-04-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "text-embedding-004" + }, + "description": "Model \"text-embedding-004\" is shut down on 2027-04-01: Google requests naming it fail from that date.", + "migration_hint": "Google names no replacement model.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Embeddings models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `text-embedding-004` | May 14, 2024 | April 1, 2027 | |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 8, + "fingerprint": "sha256:25ba7181945e0eacf132a86af6f7b1f52ad9c0284173544164e064fe3d27eb2b", + "api": "google/vertex-model-retirements", + "version": "2027-04-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "text-multilingual-embedding-002" + }, + "description": "Model \"text-multilingual-embedding-002\" is shut down on 2027-04-01: Google requests naming it fail from that date.", + "migration_hint": "Google names no replacement model.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Embeddings models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `text-multilingual-embedding-002` | May 14, 2024 | April 1, 2027 | |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 9, + "fingerprint": "sha256:f82b985b94b11005f52d4ea0e58d68759bd90f1d175405558677772deed5f7cf", + "api": "google/vertex-model-retirements", + "version": "2027-04-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "multimodalembedding@001" + }, + "description": "Model \"multimodalembedding@001\" is shut down on 2027-04-01: Google requests naming it fail from that date.", + "migration_hint": "Google names no replacement model.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Embeddings models\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `multimodalembedding@001` | February 12, 2024 | April 1, 2027 | |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 10, + "fingerprint": "sha256:cdcfd1e991b4ace4ae24b878b08f912cc8c8c94d0e92ee797fb7c5ebb205266b", + "api": "google/vertex-model-retirements", + "version": "2027-01-28", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3.7-flash", + "replacement": "gemini-4-hydrogen" + }, + "description": "Model \"gemini-3.7-flash\" is shut down on 2027-01-28: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-4-hydrogen` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Models available for shorter availability periods\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-3.7-flash` | August 13, 2026 | January 28, 2027 | `gemini-4-hydrogen` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 11, + "fingerprint": "sha256:6d64ac7272ecbadb5aa9226e29334db0d4d06aae6edd1f60e12c971f901570c1", + "api": "google/vertex-model-retirements", + "version": "2027-01-28", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3.6-flash", + "replacement": "gemini-4-hydrogen" + }, + "description": "Model \"gemini-3.6-flash\" is shut down on 2027-01-28: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-4-hydrogen` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Models available for shorter availability periods\n| Model ID | Release date | Retirement date | Replacement model ID |\n| `gemini-3.6-flash` | July 21, 2026 | January 28, 2027 | `gemini-4-hydrogen` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 12, + "fingerprint": "sha256:1bb244ddd4fb2ba43a99d295282f8dc123f8c8a010aa81bfcc0076bf3952b456", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.0-generate-001", + "replacement": "veo-3.1-generate-001" + }, + "description": "Model \"veo-3.0-generate-001\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `veo-3.1-generate-001` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `veo-3.0-generate-001` | July 29, 2025 | June 30, 2026 | `veo-3.1-generate-001` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 13, + "fingerprint": "sha256:a2bfd320cabd411f16c081f877c3cffc6a1569a66dc65d75e948d8fc0661bf35", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.0-fast-generate-001", + "replacement": "veo-3.1-fast-generate-001" + }, + "description": "Model \"veo-3.0-fast-generate-001\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `veo-3.1-fast-generate-001` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `veo-3.0-fast-generate-001` | July 29, 2025 | June 30, 2026 | `veo-3.1-fast-generate-001` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 14, + "fingerprint": "sha256:27b0426581ee7f389c1da65c919535f0bf24c0cae3fc0d87c5aed8d34b7a306c", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-2.0-generate-001", + "replacement": "veo-3.1-generate-001" + }, + "description": "Model \"veo-2.0-generate-001\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `veo-3.1-generate-001` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `veo-2.0-generate-001` | May 27, 2025 | June 30, 2026 | `veo-3.1-generate-001` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 15, + "fingerprint": "sha256:09e4fe7cdc44387c7264a44d655992bd5a27288d6773fd8250a95c12f1d15660", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-generate-001", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagen-4.0-generate-001\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagen-4.0-generate-001` | August 14, 2025 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 16, + "fingerprint": "sha256:01e19784f716e18e6de20e5d29b92dc5f693a218ac80a85a6f7faed847df05b2", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-ultra-generate-001", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagen-4.0-ultra-generate-001\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagen-4.0-ultra-generate-001` | August 14, 2025 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 17, + "fingerprint": "sha256:457cfeb1eeb477b6ccd703bf5f2aeaa2d50853ec7dece2bd73dae2cb640cb233", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-3.0-generate-002", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagen-3.0-generate-002\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagen-3.0-generate-002` | January 29, 2025 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 18, + "fingerprint": "sha256:cabfde9da3d23eefa156b740e713fd626a53db013a21c3e1b1bc1a4c318c4e17", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-3.0-generate-001", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagen-3.0-generate-001\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagen-3.0-generate-001` | December 10, 2024 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 19, + "fingerprint": "sha256:f41ec12b39318c08224fe8faebc6867cfb378bf16e064d9eff2c136d2eaf7020", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagegeneration@006", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagegeneration@006\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagegeneration@006` | March 27, 2024 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 20, + "fingerprint": "sha256:856947b84587c850754d47d7f80372527e166991d16dd24de3f80699f89d4ce7", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagegeneration@005", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagegeneration@005\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagegeneration@005` | November 22, 2023 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 21, + "fingerprint": "sha256:0ab8d6f6b400873d7eac52fc6f8227a0c46060458d768d10856b0a51e83f30c9", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagegeneration@004", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagegeneration@004\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagegeneration@004` | | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 22, + "fingerprint": "sha256:fe51a0b57bf9d769cc3d90777822bb63cd7d09aab044be8d8509a9ccb22c3362", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagegeneration@003", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagegeneration@003\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagegeneration@003` | | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 23, + "fingerprint": "sha256:1310723d3a98db1fb0e54de57834d0a34d98d0f40919b1de6eee68400ffe34d0", + "api": "google/vertex-model-retirements", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagegeneration@002", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagegeneration@002\" is shut down on 2026-06-30: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagegeneration@002` | August 17, 2023 | June 30, 2026 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 24, + "fingerprint": "sha256:3fb712cf39ecd4e39fadd64006be677c77fa26c1b0290c0ef1fdbe3c75f77432", + "api": "google/vertex-model-retirements", + "version": "2026-06-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.0-flash\" is shut down on 2026-06-01: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-2.0-flash` | February 5, 2025 | June 1, 2026 | `gemini-3.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 25, + "fingerprint": "sha256:a296a4a21570b7f914e1b77779b91aa200915f8a53a92cc1330e916c6b8ff664", + "api": "google/vertex-model-retirements", + "version": "2026-06-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-lite", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.0-flash-lite\" is shut down on 2026-06-01: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-2.0-flash-lite` | February 25, 2025 | June 1, 2026 | `gemini-3.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 26, + "fingerprint": "sha256:28254077d822afb2858f2d40445980c945755d305b5506cde2524c2639c4c52f", + "api": "google/vertex-model-retirements", + "version": "2025-05-24", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.5-pro-001" + }, + "description": "Model \"gemini-1.5-pro-001\" is shut down on 2025-05-24: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-2.5-flash, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.5-pro-001` | May 24, 2024 | May 24, 2025 | `gemini-2.5-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 27, + "fingerprint": "sha256:236a1810846de81794735a1b9c73a40d4a4d0ccdccbb77db09a320f53f25f052", + "api": "google/vertex-model-retirements", + "version": "2025-09-24", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.5-pro-002" + }, + "description": "Model \"gemini-1.5-pro-002\" is shut down on 2025-09-24: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-2.5-flash, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.5-pro-002` | September 24, 2024 | September 24, 2025 | `gemini-2.5-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 28, + "fingerprint": "sha256:3a54f4a8eb835367ab091e3c8b4fd3cb3b4ab61e713716affbf05adcf18e5648", + "api": "google/vertex-model-retirements", + "version": "2025-05-24", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.5-flash-001" + }, + "description": "Model \"gemini-1.5-flash-001\" is shut down on 2025-05-24: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 instead: Google's recommended replacement. (Google first named gemini-2.5-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.5-flash-001` | May 24, 2024 | May 24, 2025 | `gemini-2.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 29, + "fingerprint": "sha256:64da17ec012eb0d5d98ad9abec413d450998e11e2dcd25823d67d8c3a791a389", + "api": "google/vertex-model-retirements", + "version": "2025-09-24", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.5-flash-002" + }, + "description": "Model \"gemini-1.5-flash-002\" is shut down on 2025-09-24: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 instead: Google's recommended replacement. (Google first named gemini-2.5-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.5-flash-002` | September 24, 2024 | September 24, 2025 | `gemini-2.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 30, + "fingerprint": "sha256:ae5f88ca2317ecabd2ac01b82f6f931deb5adf0015c376b4499f6ea739caf66f", + "api": "google/vertex-model-retirements", + "version": "2025-05-24", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "textembedding-gecko-multilingual@001", + "replacement": "gemini-embedding-001" + }, + "description": "Model \"textembedding-gecko-multilingual@001\" is shut down on 2025-05-24: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-embedding-001` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `textembedding-gecko-multilingual@001` | November 2, 2023 | May 24, 2025 | `gemini-embedding-001` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 31, + "fingerprint": "sha256:643b42a3e2f9609a6a6c922e875cbe1a505c24c98e14f984fff4661dd1c4326a", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.0-pro-001" + }, + "description": "Model \"gemini-1.0-pro-001\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-2.5-flash, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.0-pro-001` | February 15, 2024 | April 21, 2025 | `gemini-2.5-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 32, + "fingerprint": "sha256:de0b474847a57fa37c32bcd2dc877d5ee8d701e04da3021ffbd5a4c0e6cc133b", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.0-pro-002" + }, + "description": "Model \"gemini-1.0-pro-002\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-2.5-flash, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.0-pro-002` | April 9, 2024 | April 21, 2025 | `gemini-2.5-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 33, + "fingerprint": "sha256:71a047e6aa5973d29fb5c14cbad6f3d6d867b44ca1c23708001571ff2defe05f", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-1.0-pro-vision-001" + }, + "description": "Model \"gemini-1.0-pro-vision-001\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-2.5-flash, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `gemini-1.0-pro-vision-001` | February 15, 2024 | April 21, 2025 | `gemini-2.5-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 34, + "fingerprint": "sha256:6ccf6a6ea1e5e02053b07007fd71bc07e2aa55ec01bba21a480316faae823278", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "text-bison" + }, + "description": "Model \"text-bison\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 instead: Google's recommended replacement. (Google first named gemini-2.5-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `text-bison` | May 2023 | April 21, 2025 | `gemini-2.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 35, + "fingerprint": "sha256:02b2b6b0d29d49017b545b77d4907cbd03136b1b77d1c8eb7337e9e1eb738607", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "chat-bison" + }, + "description": "Model \"chat-bison\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 instead: Google's recommended replacement. (Google first named gemini-2.5-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `chat-bison` | May 2023 | April 21, 2025 | `gemini-2.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 36, + "fingerprint": "sha256:2fc76102654a56b32be0dd835a9d862cfa95f2cafd0afff75334f99cace0db82", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "code-gecko" + }, + "description": "Model \"code-gecko\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.8-flash` or `gemini-3.5-flash-lite` or Gemma 4 instead: Google's recommended replacement. (Google first named gemini-2.5-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `code-gecko` | May 2023 | April 21, 2025 | `gemini-2.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 37, + "fingerprint": "sha256:a9a0bfbedd63c0022a969ca211e7db7045ff9f305110511f22e8a96edb2d809e", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "textembedding-gecko@002", + "replacement": "gemini-embedding-001" + }, + "description": "Model \"textembedding-gecko@002\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-embedding-001` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `textembedding-gecko@002` | November 2, 2023 | April 21, 2025 | `gemini-embedding-001` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 38, + "fingerprint": "sha256:5ab1b9bb58a2e1bc39a07e87308bfd8b616dab5514f50826beebad3619341215", + "api": "google/vertex-model-retirements", + "version": "2025-04-21", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "textembedding-gecko@001", + "replacement": "gemini-embedding-001" + }, + "description": "Model \"textembedding-gecko@001\" is shut down on 2025-04-21: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-embedding-001` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `textembedding-gecko@001` | June 7, 2023 | April 21, 2025 | `gemini-embedding-001` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 39, + "fingerprint": "sha256:e78fa1f0b47b02780b33bdb22a95a9cff1a7635f3e5de8c61bd1d3fc87f7b239", + "api": "google/vertex-model-retirements", + "version": "2025-09-24", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagetext", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"imagetext\" is shut down on 2025-09-24: Google requests naming it fail from that date.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement. (Google first named gemini-2.5-flash-image, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions", + "source_excerpt": "### Retired models\n| Model ID | Release date | Retirement date | Recommended upgrade |\n| `imagetext` | June 7, 2023 | September 24, 2025 | `gemini-2.5-flash-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + } +] diff --git a/providers/google-gemini-models.md b/providers/google-gemini-models.md index db38479..4f002dd 100644 --- a/providers/google-gemini-models.md +++ b/providers/google-gemini-models.md @@ -12,7 +12,7 @@ Kind: `notices` (`plugins/notices`), with the deprecations-table reader (`plugin - **Why this one:** it's Google's own table of every Gemini API model with its release date, its shutdown date and the recommended replacement, one table per model family, the shut-down ones kept under "Deprecated models". It's where Google says deprecation dates are tracked: "Deprecation announcements are made on the Release notes page, and the announced earliest shutdown dates are tracked on this page." - **Alternatives considered:** - **The Gemini API release notes** (`https://aistudio.google.com/docs/changelog`): the same deprecations, announced in prose, one entry per day. The table is the same facts, already structured. - - **Vertex AI's model versions page**: the same models on Google Cloud, with Google Cloud's own retirement dates, which differ from the Gemini API's (gemini-2.5-pro: 2026-10-20 on Vertex AI, 2026-12-01 here). A separate source: a repo reaches one or the other. + - **Vertex AI's model versions page** (`google/vertex-model-retirements`): the same models on Google Cloud, with Google Cloud's own retirement dates, which differ from the Gemini API's (gemini-2.5-pro: 2026-10-20 on Vertex AI, 2026-12-01 here). A separate source: a repo reaches one or the other. - **The Gemini API's models list** (`GET /v1beta/models`): what's served now, with no dates. - **Quote:** "| `gemini-2.0-flash` | February 5, 2025 | June 1, 2026 | `gemini-3.6-flash` |" (Gemini 2.0 models, Deprecated models), and above the tables: "The shutdown dates listed in the table indicate the earliest possible dates on which a model might be retired". diff --git a/providers/google-vertex-model-retirements.md b/providers/google-vertex-model-retirements.md new file mode 100644 index 0000000..a9ab1f2 --- /dev/null +++ b/providers/google-vertex-model-retirements.md @@ -0,0 +1,32 @@ +# Google Vertex AI model retirements (`google/vertex-model-retirements`) + +## What it watches + +Generative AI models Google Cloud retires on Vertex AI (now called Gemini Enterprise Agent Platform): every model on Google Cloud's model versions page with a plain retirement date, one `model` event per model id, with the replacement Google names. + +Kind: `notices` (`plugins/notices`), with the deprecations-table reader (`plugins/notices/retire`, `retire.Vertex`), reading HTML tables. + +## Why this source + +- **Source:** [Model versions and lifecycle](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions) (the old `cloud.google.com/vertex-ai/generative-ai/docs/learn/model-versions` redirects there). Checked on 2026-11-21. +- **Why this one:** it's Google Cloud's own table of every model id with its release date, its retirement date and its replacement, including the "Retired models" table. The release-notes feed (`google/vertex-ai-models`) only announces some deprecations, in prose; this page is where the dates are kept. +- **Alternatives considered:** + - **The Vertex AI release notes feed**: already a source (`google/vertex-ai-models`), for announcements; not every retirement is announced there with a table of ids. + - **The deprecations page** (`docs.cloud.google.com/vertex-ai/generative-ai/docs/deprecations`): SDK modules and features, not model dates. + - **The Gemini API deprecations page** (`google/gemini-models`): the Gemini API's own dates, which differ. +- **Quote:** "| `veo-3.0-generate-001` | July 29, 2025 | June 30, 2026 | `veo-3.1-generate-001` |" (Retired models). + +## How the provider announces changes + +- A GA model is kept for at least a year, written as a minimum ("October 13, 2027 or later", "No sooner than May 20, 2028"); when Google decides to retire it, the cell becomes a plain date, and the model later moves to "Retired models". + +## What the plugin reads and ignores + +- Reads every table with a "Retirement date", a "Model ID" and a "Replacement model ID" (or "Recommended upgrade") column: one `breaking` `model` event per model id with a plain date, `version` the date. `replacement` is set when the cell names exactly one model. +- Ignores a minimum lifetime ("… or later", "No sooner than …", "No retirement date announced"): it isn't a retirement notice. The pinned drop test: the Gemini image models' table, four rows with such dates and one dated retirement, gives one event. +- Ignores a cell that isn't a plain model id ("textembedding-gecko@003 *", with a footnote mark). + +## Known gaps + +- The page is about 430 KB of HTML; only its headings and tables are read, so a date given only in prose beside a table is missed. +- Partner models (Claude, Llama…) on Vertex AI are on other pages.