Documentation v0.28.16
Home GitHub

v0.28.15 -> v0.28.16

Summary

Reshapes the provider layer so construction and model listing share one config path as the router split continues. Improves task resumption so models keep full context while history stays compact, and tightens usage reporting in the TUI.

翻譯

延續 router 拆分，重塑 provider 建構與模型清單共用同一設定路徑。改善任務續跑，讓模型保留完整上下文、歷史保持精簡，並收斂 TUI 用量顯示。

⚠️ Breaking Changes

Agent.Execute removed from the agent interface

Providers no longer implement skill execution. Runtime owns the execution path; agents only implement Send.

Before:

type Agent interface {
    Name() string
    Send(ctx context.Context, messages []Message, toolDefs []toolTypes.Tool) (*Output, error)
    Execute(ctx context.Context, skill *skill.Skill, userInput string, events chan<- Event, allowAll bool) error
}

After:

type Agent interface {
    Name() string
    Send(ctx context.Context, messages []Message, toolDefs []toolTypes.Tool) (*Output, error)
}

Migration:

// Old — provider-side skill execution
agent.Execute(ctx, skill, userInput, events, allowAll)

// New — runtime owns execution; agents only implement Send
// Construct via router.New(...), then call exec.Execute / exec.GetSession
// from the application runtime path.
翻譯

Agent.Execute 已從介面移除。Provider 不再承載 skill 執行；執行路徑改由 runtime 負責，agent 只實作 Send。

Provider constructors take provider.Config

All provider New functions no longer accept model-name varargs or read keychain themselves. Callers pass a unified config struct.

Before:

func New(model ...string) (*Agent, error)
// e.g. claude.New("claude@claude-sonnet-4")

After:

func New(config provider.Config) (*Agent, error)
// provider.Config{Model, APIKey, Token, BaseURL, AccountID, GatewayID}

Migration:

// Old
agent, err := claude.New("claude@claude-sonnet-4")

// New
agent, err := claude.New(provider.Config{
    Model:  "claude-sonnet-4",
    APIKey: apiKey,
})
// Prefer router.New(router.Config{Name: "claude@claude-sonnet-4", APIKey: apiKey})
翻譯

所有 provider 建構子改收統一的 provider.Config，不再自行讀 keychain 或接受 model 變參。建議改走 router.New。

RateLimit moved to agentTypes

The 429 rate-limit error type left the exec package so oauth and providers can share one definition.

Before:

// package exec
type RateLimit struct {
    Agent    string
    ResetsAt int64
    Body     string
}

After:

// package agentTypes
type RateLimit struct {
    Agent    string
    ResetsAt int64
    Body     string
}

Migration:

// Old
var rl *exec.RateLimit
errors.As(err, &rl)

// New
var rl *agentTypes.RateLimit
errors.As(err, &rl)
翻譯

RateLimit 從 exec 搬到 agentTypes，oauth 與 provider 共用同一型別。請更新 import 與型別參照。

Model listing APIs take provider.Config

Per-provider model listing is no longer zero-arg. Callers pass credentials through the shared config.

Before:

// typical prior shape (package-local credentials)
ids, err := claude.Models(ctx)

After:

ids, err := claude.Models(ctx, provider.Config{APIKey: apiKey})

Migration:

// Old
ids, err := claude.Models(ctx)

// New
ids, err := claude.Models(ctx, provider.Config{APIKey: apiKey})
// Token / AccountID / GatewayID as required by the provider
翻譯

各 provider 的模型清單 API 改收 provider.Config，需由呼叫端傳入憑證，不再假設 package 內部 keychain 狀態。

Image and STT tools relocated under internal/tools

generate_image and speech-to-text registration moved out of provider packages into first-class tool packages.

Before:

internal/agents/provider/openaiCodex/image2/
internal/agents/provider/gemini/stt/

After:

internal/tools/image2/
internal/tools/stt/

Migration:

// Old
import image2 "github.com/pardnchiu/agenvoy/internal/agents/provider/openaiCodex/image2"
import stt "github.com/pardnchiu/agenvoy/internal/agents/provider/gemini/stt"

// New
import "github.com/pardnchiu/agenvoy/internal/tools/image2"
import "github.com/pardnchiu/agenvoy/internal/tools/stt"

// Registration remains image2.Register() / stt.Register() at app bootstrap.
翻譯

影像生成與語音轉文字工具從 provider 套件搬到 internal/tools。請更新 import 路徑；註冊方式仍為 bootstrap 時呼叫 Register()。

Changes

BREAKING

翻譯
  • 從所有 provider 移除 Agent.Execute，介面只保留 Send
  • 將 rate-limit 錯誤移入共用 agent types，並把影像生成工具遷到 tools
  • 統一以共用 config 建構 provider，並把語音轉文字工具遷到 tools
  • 模型清單 API 改需 provider config，延續 router 拆分

FEAT

翻譯
  • 改善任務續跑：模型保留完整上下文、歷史保持精簡，並收斂用量回報

Scope

Generated by SKILL