# v0.7.0 Release Notes

> v0.6.1 -> v0.7.0

## Summary

Renames the shared contract package so its identifier matches the library, a breaking change for every caller. Extends OpenRouter into a full multimodal provider covering image generation, speech-to-text, and text-to-speech, with model listings drawn from the vendor's own catalogs.

<details>
<summary>翻譯</summary>

將共用契約套件更名，使識別字與函式庫名稱一致，所有呼叫端皆需調整。OpenRouter 擴充為完整多模態供應商，涵蓋圖片生成、語音轉文字與文字轉語音，模型清單改取自供應商自身目錄。

</details>

## ⚠️ Breaking Changes

### `package core` renamed to `package llmrouter`

The import path is unchanged; only the package identifier differs, so every unaliased `core.X` reference stops compiling.

**Before:**

```go
import "github.com/pardnchiu/go-llm-router/core"

var agent core.Agent
messages := []core.Message{{Role: "user", Content: "hi"}}
```

**After:**

```go
import llmrouter "github.com/pardnchiu/go-llm-router/core"

var agent llmrouter.Agent
messages := []llmrouter.Message{{Role: "user", Content: "hi"}}
```

**Migration:**

```go
// Option 1 — rename references (recommended)
// sed -i '' 's/\bcore\./llmrouter./g' on files importing .../core
import llmrouter "github.com/pardnchiu/go-llm-router/core"

// Option 2 — keep existing references with an explicit alias
import core "github.com/pardnchiu/go-llm-router/core"
```

<details>
<summary>翻譯</summary>

import 路徑不變，但套件識別字由 `core` 改為 `llmrouter`，所有未加別名的 `core.X` 引用都會編譯失敗。可將引用改寫為 `llmrouter.X`（建議），或在 import 加上 `core` 別名以維持既有寫法。

</details>

## Changes

### BREAKING

- Rename package core to llmrouter while keeping the import path (@pardnchiu) [30dbf48]

<details>
<summary>翻譯</summary>

- 將 package core 更名為 llmrouter，import 路徑維持不變 

</details>

### FEAT

- Add OpenRouter image generation through the dedicated images endpoint (@pardnchiu) [89d735b]
- Add OpenRouter speech-to-text and text-to-speech, resolving voices from the model catalog and returning WAV for every format except mp3 (@pardnchiu) [89d735b]

<details>
<summary>翻譯</summary>

- 新增 OpenRouter 圖片生成，改走專用 images 端點 
- 新增 OpenRouter 語音轉文字與文字轉語音，voice 由模型目錄解析，除 mp3 外一律輸出 WAV 

</details>

### UPDATE

- Honor ImageOnly, STTOnly, and TTSOnly in OpenRouter model listings via the vendor catalogs (@pardnchiu) [89d735b]

<details>
<summary>翻譯</summary>

- OpenRouter 模型清單改依供應商目錄支援 ImageOnly、STTOnly 與 TTSOnly 

</details>

### DOC

- Document the new package name, OpenRouter media support, and per-provider filter support (@pardnchiu) [30dbf48, 1c083ca]

<details>
<summary>翻譯</summary>

- 補充新套件名稱、OpenRouter 多媒體能力與各供應商模型篩選支援說明 

</details>

## Scope

- `core/*.go` — BREAKING (package clause)
- `core/router/`, `core/*/` — BREAKING (identifier rename across all providers)
- `core/openRouter/` — FEAT, UPDATE (`image.go`, `audio.go`, `models.go`)
- `README.md`, `doc/` — DOC

---

Generated by [SKILL](https://github.com/pardnchiu/skill-version-generate)
