88 lines
4.0 KiB
Markdown
88 lines
4.0 KiB
Markdown
---
|
|
title: 'Plugin: register enabled Tool surface from packages'
|
|
state: 'closed'
|
|
created_at: '2026-06-15T14:48:59Z'
|
|
updated_at: '2026-06-17T05:44:04Z'
|
|
assignee: null
|
|
readiness: 'implementation_ready'
|
|
risk_flags: ['plugin', 'tool-registry', 'model-visible-schema', 'capability-boundary', 'profile-config']
|
|
queued_by: 'workspace-panel'
|
|
queued_at: '2026-06-15T15:53:32Z'
|
|
---
|
|
|
|
## Background
|
|
|
|
Plugin package discovery / explicit enablement resolver の次に、enabled Plugin package から Tool surface を読み取り、通常の `ToolRegistry` に登録できるようにする。
|
|
|
|
この Ticket の目的は、Plugin package 由来の Tool 定義が Yoi の既存 Tool 経路に安全に乗る境界を作ること。Plugin code execution / WASM runtime はまだ行わない。Tool が model-visible schema として見えるか、enablement なしでは出ないか、invalid / duplicate な Tool 定義が fail closed になるかを先に固める。
|
|
|
|
## Requirements
|
|
|
|
- `00001KV5R5V2S` の resolved Plugin metadata を入力として扱う。
|
|
- Enabled Plugin package の manifest から Tool surface 定義を読み取る。
|
|
- tool name
|
|
- description
|
|
- input schema
|
|
- effect / side-effect metadata
|
|
- plugin origin metadata
|
|
- Plugin Tool definition を既存 `ToolRegistry` 登録経路に載せる。
|
|
- model-visible schema は通常 Tool と同じ原則に従う。
|
|
- feature/profile config で disabled なら schema surface から消える。
|
|
- Tool metadata に Plugin origin を保持する。
|
|
- plugin id / ref
|
|
- package source: user / project / builtin
|
|
- package digest
|
|
- package version / api version
|
|
- surface: tool
|
|
- Duplicate Tool name は fail closed にする。
|
|
- builtin Tool / other Plugin Tool との衝突を検出する。
|
|
- どちらが勝つかを曖昧にしない。
|
|
- Invalid input schema / unsupported schema shape は fail closed にする。
|
|
- Package が discovered されただけでは Tool を登録しない。
|
|
- explicit enablement が必要。
|
|
- Tool call / result は後続 runtime Ticket で実装する。
|
|
- この Ticket では未実行 Tool として registration boundary を作る。
|
|
- 実行できない状態を user-visible diagnostic として安全に扱う。
|
|
- Diagnostics は bounded にする。
|
|
- registered
|
|
- skipped: not enabled
|
|
- rejected: duplicate name
|
|
- rejected: invalid schema
|
|
- rejected: unsupported surface/api
|
|
- rejected: missing runtime executor
|
|
|
|
## Acceptance criteria
|
|
|
|
- Enabled Plugin package の Tool definition が `ToolRegistry` に登録され、model-visible tools に現れる。
|
|
- Enablement がない Plugin package の Tool は model-visible tools に現れない。
|
|
- Duplicate Tool name は登録されず、diagnostic で理由が分かる。
|
|
- Invalid input schema は登録されず、diagnostic で理由が分かる。
|
|
- Registered Plugin Tool の metadata から plugin origin / digest / source が追跡できる。
|
|
- Feature/profile flag により Plugin Tool surface を非表示にできる。
|
|
- Tool call がまだ実行できない場合も panic せず、安全な unavailable/runtime-missing error になる。
|
|
- Tests cover:
|
|
- enabled package Tool registration
|
|
- package without enablement does not register
|
|
- duplicate Plugin Tool name rejected
|
|
- builtin Tool name collision rejected
|
|
- invalid schema rejected
|
|
- plugin origin metadata retained
|
|
- disabled feature/profile removes schema surface
|
|
- Validation: focused plugin/tool-registry tests, `cargo fmt --check`, relevant `cargo check` / `cargo test`, `git diff --check`.
|
|
|
|
## Non-goals
|
|
|
|
- Plugin code execution.
|
|
- WASM runtime.
|
|
- `https` / `fs` host API.
|
|
- Service / Ingress surface.
|
|
- External side effects.
|
|
- Permission grant enforcement beyond registration-time shape checks.
|
|
|
|
## Related work
|
|
|
|
- `00001KV5R5V2S` — Plugin package discovery and explicit enablement resolver.
|
|
- `00001KV5W3PHW` — Plugin Tool execution with minimal WASM runtime.
|
|
- `00001KV5W3PJ3` — Plugin permission grant enforcement.
|
|
- `00001KSXRQ4G8` — Plugin runtime / surface / host API model design.
|