Hare/yoi
1
1
Fork 0
Code Actions Packages Releases Activity

ticket: make plugin lifecycle instance-oriented

Browse Source
This commit is contained in:
Keisuke Hirata 2026-06-20 22:18:53 +09:00
parent aadc0329d2
commit 70b8ed628d
No known key found for this signature in database
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
.yoi/tickets/00001KVJHYP4Q/item.md
View File

@ -22,15 +22,15 @@ Ingress は外部から Yoi に入る event boundary として扱う。Discord m
## 設計方針 ## 設計方針
- Service は Tool call の延長ではなく、host-managed lifecycle を持つ separate surface とする。 - Plugin は原則として host-managed instance として扱い、Tool / Service / Ingress はその instance が提供する surface とする。
- ただし stateful Plugin では、Service instance が Plugin の機能上の主 instance であり、同じ Plugin package が提供する Tool はその instance にアクセスできる必要がある。 - mutable state を持たない Plugin でも、instance として構造化された lifecycle / configuration / grants / diagnostics / exports を持つ方が authoring と host 管理が単純になる。
- Minecraft Plugin 的に、Plugin instance とその state は Tool/Service/Ingress から不可分な場合がある。 - Minecraft Plugin 的に、Plugin instance は command handler / event listener / lifecycle hook をまとめる単位であり、Tool/Service/Ingress から不可分な実行対象である。
- Tool は transient worker state ではなく、host が保持する Plugin/Service instance へ command/query として dispatch される。 - Tool は transient worker state ではなく、host が保持する Plugin instance へ command/query として dispatch される。
- Tool schema/model-visible registration と Service lifecycle は別 surface だが、実行先 instance は同一であり得る。 - Tool schema/model-visible registration と Service lifecycle は別 surface だが、実行先 instance は同一である。
- Wasm component は Service interface の export を実装する。 - Wasm component は Plugin instance interface の export を実装する。
- 例: `start(config)`, `handle_event(event)`, `handle_tool(tool, input)`, `status()`, `stop(reason)` 相当。 - 例: `start(config)`, `handle_event(event)`, `handle_tool(tool, input)`, `status()`, `stop(reason)` 相当。
- exact schema / naming は実装時に詰めるが、Tool-only handler と stateful Service-backed Tool dispatch は区別する。 - exact schema / naming は実装時に詰めるが、Tool export も instance lifecycle 配下の dispatch として扱う。
- Yoi host は Plugin/Service instance を保持し、lifecycle / restart / diagnostics / resource bounds / call serialization を管理する。 - Yoi host は Plugin instance を保持し、lifecycle / restart / diagnostics / resource bounds / call serialization を管理する。
- 長寿命 network/socket/process ownership は原則 host 側に置く。 - 長寿命 network/socket/process ownership は原則 host 側に置く。
- Wasm に raw ambient network/WASI socket を渡して unmanaged runtime loop を作らせない。 - Wasm に raw ambient network/WASI socket を渡して unmanaged runtime loop を作らせない。
- 必要な outbound/inbound は host API と grant で明示する。 - 必要な outbound/inbound は host API と grant で明示する。
@ -48,14 +48,14 @@ Ingress は外部から Yoi に入る event boundary として扱う。Discord m
- Plugin manifest / static inspection が Service / Ingress contribution を表現できる。 - Plugin manifest / static inspection が Service / Ingress contribution を表現できる。
- `surfaces = ["service", "ingress"]` または同等の明示 surface。 - `surfaces = ["service", "ingress"]` または同等の明示 surface。
- service id/version, ingress event kinds, required host APIs, side effects, secrets/network requirements を reviewable にする。 - service id/version, ingress event kinds, required host APIs, side effects, secrets/network requirements を reviewable にする。
- Component Service runtime が Tool runtime と分離される。 - Component Plugin runtime が Tool surface registration と instance lifecycle を分離して扱う。
- Tool schema/model-visible registration と Service lifecycle registration を混同しない。 - Tool schema/model-visible registration と Plugin instance lifecycle registration を混同しない。
- Tool-only Plugin は従来通り bounded Tool execution でよい。 - Tool-only package でも host-managed Plugin instance として起動し、Tool execution はその instance の command/query export へ dispatch できる。
- Service-backed Plugin では、Tool execution が host-managed Plugin/Service instance の command/query export へ dispatch できる。 - mutable state を持たない場合の lightweight instantiation / pooling / per-call optimization は実装詳細として許すが、意味論上は instance-oriented model を保つ。
- Service component artifact / interface compatibility を static check できる。 - Service component artifact / interface compatibility を static check できる。
- Host-managed Service instance registry を追加する。 - Host-managed Plugin instance registry を追加する。
- enabled Service を start/stop/status できる。 - enabled Plugin instance を start/stop/status できる。
- 同一 Plugin package の Tool / Ingress / Service 呼び出しが同じ stateful instance を参照できる。 - 同一 Plugin package の Tool / Ingress / Service 呼び出しが同じ Plugin instance を参照できる。
- instance への同時呼び出し、reentrancy、timeout、crash isolation の方針を定義する。 - instance への同時呼び出し、reentrancy、timeout、crash isolation の方針を定義する。
- failure/restart/backoff/diagnostics を bounded に記録/表示できる。 - failure/restart/backoff/diagnostics を bounded に記録/表示できる。
- Pod shutdown / restore / config change 時の lifecycle を明確化する。 - Pod shutdown / restore / config change 時の lifecycle を明確化する。
@ -80,10 +80,10 @@ Ingress は外部から Yoi に入る event boundary として扱う。Discord m
## 受け入れ条件 ## 受け入れ条件
- Service/Ingress surface の design record または implementation design が repository 内に追加され、Tool surface との違い、host-managed instance lifecycle、Ingress event boundary、permission/grant model が明文化されている。 - Service/Ingress surface の design record または implementation design が repository 内に追加され、Tool surface との違い、host-managed Plugin instance lifecycle、Ingress event boundary、permission/grant model が明文化されている。
- `plugin.toml` / package inspection / enablement model に Service/Ingress contribution をどう表現するかが決まっている。 - `plugin.toml` / package inspection / enablement model に Service/Ingress contribution をどう表現するかが決まっている。
- Wasm 側が実装する Service interface と、host が保持・呼び出す lifecycle の責務境界が決まっている。 - Wasm 側が実装する Plugin instance interface と、host が保持・呼び出す lifecycle の責務境界が決まっている。
- Service-backed Tool が同じ stateful Plugin/Service instance に command/query としてアクセスする方式が決まっている。 - Tool が同じ Plugin instance に command/query としてアクセスする方式が決まっている。
- Ingress event がどの durable/visible Yoi path に変換され得るか、どの path が禁止かが決まっている。 - Ingress event がどの durable/visible Yoi path に変換され得るか、どの path が禁止かが決まっている。
- 既存 Tool Plugin runtime/docs が「現時点では Tool surface」であることを誤解なく示す。 - 既存 Tool Plugin runtime/docs が「現時点では Tool surface」であることを誤解なく示す。
- 実装を一度に詰め込まず、必要なら follow-up Ticket に分割できる状態になっている。 - 実装を一度に詰め込まず、必要なら follow-up Ticket に分割できる状態になっている。