ticket: ready manual coding worker launch
This commit is contained in:
parent
578ea261a4
commit
d276e27e81
0
.yoi/tickets/00001KWHEM8YJ/artifacts/.gitkeep
Normal file
0
.yoi/tickets/00001KWHEM8YJ/artifacts/.gitkeep
Normal file
186
.yoi/tickets/00001KWHEM8YJ/item.md
Normal file
186
.yoi/tickets/00001KWHEM8YJ/item.md
Normal file
|
|
@ -0,0 +1,186 @@
|
|||
---
|
||||
title: 'Workspace Browserから手動Coding Workerを作成する導線を追加する'
|
||||
state: 'ready'
|
||||
created_at: '2026-07-02T12:59:57Z'
|
||||
updated_at: '2026-07-02T15:39:49Z'
|
||||
assignee: null
|
||||
---
|
||||
|
||||
## 背景
|
||||
|
||||
Workspace Browser には Runtime / Worker catalog と Worker Console はあるが、ユーザーが Browser から「普通に読み書きできる coding agent Worker」を明示作成する導線がまだ無い。
|
||||
|
||||
現状の `workspace-server` には Runtime worker spawn の backend 経路があり、Browser-facing API としても `/api/runtimes/{runtime_id}/workers` が存在する。ただし、この既存 endpoint は Runtime create に近い field を受け取り得るため、Browser UI から `ConfigBundleRef`、requested capabilities、raw workspace path、cwd、secret、runtime store path などを直接渡す導線にしてはいけない。
|
||||
|
||||
この Ticket では、Workspace sidebar の WORKER セクションから明示的に New form を開き、Backend が coding preset を解決して Worker を作成し、作成後に Worker Console へ遷移する導線を作る。
|
||||
|
||||
## 目的
|
||||
|
||||
- Workspace Browser から手動で Coding Worker を作成できるようにする。
|
||||
- Sidebar の WORKER 見出し横に `New` button を置く。
|
||||
- Browser-facing request は product-level launch request とし、Runtime internal create request を直接露出しない。
|
||||
- Backend が coding preset から Profile / ConfigBundle / execution backend / workspace scope を解決する。
|
||||
- 作成成功後は Worker Console に遷移する。
|
||||
- 作成失敗時は sanitized diagnostic を form に表示する。
|
||||
|
||||
## UI 設計
|
||||
|
||||
### Sidebar entry point
|
||||
|
||||
`web/workspace/src/lib/workspace-sidebar/WorkersNavSection.svelte` の WORKER section heading 横に `New` button を追加する。
|
||||
|
||||
```text
|
||||
WORKER New
|
||||
```
|
||||
|
||||
`New` を押すと Worker 作成 form を開く。v0 は sidebar 内の inline panel でも modal/dialog でもよいが、既存 sidebar UX を壊さないこと。
|
||||
|
||||
### Form fields
|
||||
|
||||
v0 の form は次の 4 field に限定する。
|
||||
|
||||
- `display_name`
|
||||
- optional。
|
||||
- Worker identity ではなく表示名だけに使う。
|
||||
- `runtime_id`
|
||||
- 対象 Runtime。
|
||||
- default: embedded Runtime。
|
||||
- 候補は `/api/workspace` など既存 projection から `can_spawn_worker=true` の Runtime を使うか、v0 は embedded Runtime 固定でもよい。
|
||||
- `profile`
|
||||
- Worker の振る舞いを選ぶ Profile。
|
||||
- default: coding 用 Profile。
|
||||
- Browser の自由入力ではなく、Backend が公開する候補から選ぶ。
|
||||
- `initial_text`
|
||||
- optional。
|
||||
- 作成直後の user input として Worker に渡す。
|
||||
|
||||
`kind = coding` はこの endpoint の launch mode として Backend が持ってよいが、form の入力 field にはしない。
|
||||
|
||||
自由入力にしないもの:
|
||||
|
||||
- raw workspace path。
|
||||
- cwd。
|
||||
- tool scope。
|
||||
- `ConfigBundleRef`。
|
||||
- `requested_capabilities`。
|
||||
- secret / token。
|
||||
- Runtime endpoint / socket path / session path / store path。
|
||||
|
||||
### Success behavior
|
||||
|
||||
Worker 作成成功後:
|
||||
|
||||
1. Worker list を refresh する。
|
||||
2. 作成された Worker の Console に遷移する。
|
||||
|
||||
```text
|
||||
/runtimes/{runtime_id}/workers/{worker_id}/console
|
||||
```
|
||||
|
||||
### Error behavior
|
||||
|
||||
Worker 作成失敗時:
|
||||
|
||||
- form 内に sanitized diagnostic を表示する。
|
||||
- raw path、secret、Runtime endpoint、internal store path を表示しない。
|
||||
- form の入力値は保持する。
|
||||
|
||||
## Backend API 設計
|
||||
|
||||
Browser から既存 Runtime create payload を直接叩かせず、Workspace Backend に product-level endpoint を追加する。
|
||||
|
||||
候補:
|
||||
|
||||
```http
|
||||
POST /api/workers
|
||||
```
|
||||
|
||||
request v0:
|
||||
|
||||
```json
|
||||
{
|
||||
"runtime_id": "embedded-worker-runtime",
|
||||
"display_name": "scratch worker",
|
||||
"profile": "builtin:coder",
|
||||
"initial_text": "このリポジトリを確認して"
|
||||
}
|
||||
```
|
||||
|
||||
response:
|
||||
|
||||
```json
|
||||
{
|
||||
"runtime_id": "embedded-worker-runtime",
|
||||
"worker_id": "...",
|
||||
"worker": { ... existing WorkerSummary or WorkerDetail projection ... }
|
||||
}
|
||||
```
|
||||
|
||||
### Backend resolution
|
||||
|
||||
Backend は manual Coding Worker launch endpoint として、request の `profile` を次へ解決する。
|
||||
|
||||
- Profile 候補に存在するか検証する。
|
||||
- Profile から default ConfigBundle を解決 / sync / check する。
|
||||
- embedded / selected Runtime spawn を行う。
|
||||
- normal workspace read/write capable Worker execution path に接続する。
|
||||
- initial text を Worker input / initial input として送る。
|
||||
|
||||
Browser-facing request に `kind`、ConfigBundle identity、requested capabilities を持たせない。
|
||||
|
||||
### 既存 endpoint との関係
|
||||
|
||||
- `/api/runtimes/{runtime_id}/workers` は internal-ish Runtime spawn endpoint として残ってよい。
|
||||
- Browser の New Worker UI は新しい `/api/workers` product-level endpoint を使う。
|
||||
- 将来的に `/api/runtimes/{runtime_id}/workers` を debug/admin/internal に寄せるかは別 Ticket で扱う。
|
||||
|
||||
## Coding Worker の意味
|
||||
|
||||
この Ticket の Coding Worker は、一般的な coding agent と同様に workspace 内のファイルを読み書きできる Worker を指す。
|
||||
|
||||
ただし Browser が file path / scope / tool grant を直接指定するのではなく、Backend が現在の Workspace Backend 実行環境に基づいて既存 execution backend / tool host の範囲へ接続する。
|
||||
|
||||
v0 では embedded Runtime / local execution backend を対象にする。remote Runtime で workspace provisioning が未対応の場合は typed diagnostic で拒否してよい。
|
||||
|
||||
## 実装要件
|
||||
|
||||
- `WorkersNavSection.svelte` の heading 横に `New` button を追加する。
|
||||
- New form を追加し、display name / runtime / profile / initial text を入力できる。
|
||||
- Form submit で Browser-facing `/api/workers` launch endpoint を呼ぶ。
|
||||
- Backend に `/api/workers` POST endpoint を追加する。
|
||||
- Backend request type は product-level launch request とし、Runtime create request をそのまま deserialize しない。
|
||||
- Backend が request の `profile` を default coding Worker launch に解決する。
|
||||
- Browser-facing request/response に raw workspace path、cwd、ConfigBundleRef、requested capabilities、secret、Runtime endpoint、store path を含めない。
|
||||
- 作成成功後に Worker Console へ遷移する。
|
||||
- 作成失敗時に sanitized diagnostic を表示する。
|
||||
- Worker list refresh を行う。
|
||||
|
||||
## 受け入れ条件
|
||||
|
||||
- Sidebar WORKER heading 横に `New` button がある。
|
||||
- `New` で Worker 作成 form が開く。
|
||||
- Form には display name / runtime / profile / initial text だけがある。
|
||||
- Form から coding Worker を作成できる。
|
||||
- Form request は `/api/workers` product-level endpoint を使う。
|
||||
- Browser-facing payload に raw path / cwd / `ConfigBundleRef` / requested capabilities / secret / Runtime endpoint / store path が含まれない。
|
||||
- Backend が request の `profile` から Profile / ConfigBundle / execution backend を解決する。
|
||||
- 作成成功後、作成された Worker の Console に遷移する。
|
||||
- 作成失敗時、sanitized diagnostic が表示される。
|
||||
- remote Runtime など未対応対象では typed diagnostic で拒否される。
|
||||
- Focused tests が Backend launch endpoint、payload sanitization、success projection、unsupported runtime diagnostic、UI form rendering / submit path を確認する。
|
||||
- `cd web/workspace && deno task test` が通る。
|
||||
- `cd web/workspace && deno task check` が通る。
|
||||
- `cargo test -p yoi-workspace-server` が通る。
|
||||
- `cargo check -p yoi` が通る。
|
||||
- `git diff --check` が通る。
|
||||
- `nix build .#yoi --no-link` が通る。
|
||||
|
||||
## 対象外
|
||||
|
||||
- Remote Runtime workspace provisioning の完成。
|
||||
- per-worker cwd / tool scope の新 UI。
|
||||
- ConfigBundle editor UI。
|
||||
- Profile picker の本格実装。
|
||||
- multi-agent Ticket role launch UI。
|
||||
- Worker reconnect / stale recovery UI。
|
||||
- `/api/runtimes/{runtime_id}/workers` の削除。
|
||||
56
.yoi/tickets/00001KWHEM8YJ/thread.md
Normal file
56
.yoi/tickets/00001KWHEM8YJ/thread.md
Normal file
|
|
@ -0,0 +1,56 @@
|
|||
<!-- event: create author: "yoi ticket" at: 2026-07-02T12:59:57Z -->
|
||||
|
||||
## 作成
|
||||
|
||||
LocalTicketBackend によって作成されました。
|
||||
|
||||
---
|
||||
|
||||
<!-- event: plan author: hare at: 2026-07-02T13:00:58Z -->
|
||||
|
||||
## Plan
|
||||
|
||||
Workspace Browser から手動 Coding Worker を作成する導線として Ticket を詳細化した。
|
||||
|
||||
方針:
|
||||
- Sidebar WORKER heading 横に `New` button を追加する。
|
||||
- New form は runtime / display name / initial text の最小入力にする。
|
||||
- Browser は Runtime create request を直接送らず、product-level `/api/workers` endpoint を使う。
|
||||
- Backend が `kind=coding` を default coding Worker launch に解決する。
|
||||
- Browser-facing payload に raw path / cwd / ConfigBundleRef / requested capabilities / secret / Runtime endpoint / store path を含めない。
|
||||
- 成功後は作成 Worker の Console に遷移し、失敗時は sanitized diagnostic を form に表示する。
|
||||
|
||||
|
||||
---
|
||||
|
||||
<!-- event: decision author: hare at: 2026-07-02T13:06:46Z -->
|
||||
|
||||
## Decision
|
||||
|
||||
Manual Coding Worker create form fields を明確化した。
|
||||
|
||||
決定:
|
||||
- v0 form は `display_name`、`runtime_id`、`profile`、`initial_text` の 4 field に限定する。
|
||||
- `kind = coding` は endpoint / Backend 側 launch mode として扱い、form input や Browser-facing payload field にはしない。
|
||||
- `profile` は Browser 自由入力ではなく、Backend が公開する候補から選ぶ。
|
||||
- Browser-facing request は `runtime_id` / `display_name` / `profile` / `initial_text` にし、`ConfigBundleRef`、requested capabilities、raw path、cwd、secret、Runtime endpoint、store path は含めない。
|
||||
|
||||
|
||||
---
|
||||
|
||||
<!-- event: intake_summary author: hare at: 2026-07-02T15:39:49Z -->
|
||||
|
||||
## Intake summary
|
||||
|
||||
Marked ready by `yoi ticket state`.
|
||||
|
||||
---
|
||||
|
||||
<!-- event: state_changed author: "yoi ticket" at: 2026-07-02T15:39:49Z from: planning to: ready reason: cli_state field: state -->
|
||||
|
||||
## State changed
|
||||
|
||||
Marked ready by `yoi ticket state`.
|
||||
|
||||
|
||||
---
|
||||
Loading…
Reference in New Issue
Block a user