From 2d1c7d0757ded95c77da0e805979514a845c44ef Mon Sep 17 00:00:00 2001 From: Duy Nguyen Date: Thu, 8 Oct 2026 10:23:16 +0700 Subject: [PATCH] docs(api): say a widget dev rebuild waits for a folder being made again --- docs/api.html | 2 +- vi/docs/api.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api.html b/docs/api.html index 3133cfa..c0ab067 100644 --- a/docs/api.html +++ b/docs/api.html @@ -535,7 +535,7 @@

Widget dev sessions

GET/widget-dev/sessions–{ sessions: [...] } GET/widget-dev/sessions/{id}–One session: latest (newest good build), running, activation (active, awaiting-approval with approvalId, refused with code and message, or none), lastBuild (with diagnostics when it failed), showingLastKnownGood, placed, and for a stopped session stopReason (requested, watch-failed, folder-gone, capacity or root-refused). Reading changes nothing. DELETE/widget-dev/sessions/{id}–Stops watching. The running generation stays installed and keeps rendering where it was placed. - POST/widget-dev/sessions/{id}/rebuild–Builds the folder now. 409 SESSION_STOPPED for a stopped session. Person-only. + POST/widget-dev/sessions/{id}/rebuild–Builds the folder as soon as no other build is running; while the folder is being made again, the build waits for it to come back. 409 SESSION_STOPPED for a stopped session. Person-only. POST/widget-dev/sessions/{id}/place{ conversationId, widgetId? }Places the running widget in a conversation. Person-only. POST/widget-dev/chosen-folders/forget{ root }Takes back your choice of a folder: it no longer lets Clark start sessions in it, or in the folders inside it. Answers { root, forgotten, stillCoveredBy? }; forgotten is false when the folder was not chosen, so a second press is harmless. stillCoveredBy names a folder Clark may still develop in that holds this one (another folder you chose, or a workspace.roots value you recorded), so Clark keeps access there until that one goes too. Running sessions stay as they are. Person-only. diff --git a/vi/docs/api.html b/vi/docs/api.html index d2ec27d..828a3ad 100644 --- a/vi/docs/api.html +++ b/vi/docs/api.html @@ -535,7 +535,7 @@

Phiên phát triển widget

GET/widget-dev/sessions–{ sessions: [...] } GET/widget-dev/sessions/{id}–Một phiên: latest (bản dựng tốt mới nhất), running, activation (active, awaiting-approval kèm approvalId, refused kèm code và message, hoặc none), lastBuild (kèm diagnostics khi lỗi), showingLastKnownGood, placed, và với phiên đã dừng là stopReason (requested, watch-failed, folder-gone, capacity hoặc root-refused). Việc đọc không thay đổi gì. DELETE/widget-dev/sessions/{id}–Ngừng theo dõi. Thế hệ đang chạy vẫn được cài và tiếp tục hiển thị ở nơi nó đã được đặt. - POST/widget-dev/sessions/{id}/rebuild–Dựng thư mục ngay. 409 SESSION_STOPPED với phiên đã dừng. Chỉ người dùng. + POST/widget-dev/sessions/{id}/rebuild–Dựng thư mục ngay khi không còn lần dựng nào khác đang chạy; nếu thư mục đang được tạo lại, lần dựng sẽ chờ thư mục xuất hiện trở lại. 409 SESSION_STOPPED với phiên đã dừng. Chỉ người dùng. POST/widget-dev/sessions/{id}/place{ conversationId, widgetId? }Đặt widget đang chạy vào một hội thoại. Chỉ người dùng. POST/widget-dev/chosen-folders/forget{ root }Thu hồi lựa chọn một thư mục của bạn: lựa chọn đó không còn cho Clark bắt đầu phiên trong thư mục đó, hay trong các thư mục bên trong nó, nữa. Trả { root, forgotten, stillCoveredBy? }; forgotten là false khi thư mục chưa được chọn, nên bấm lần hai cũng không sao. stillCoveredBy nêu một thư mục Clark vẫn được phát triển và chứa thư mục này (một thư mục khác bạn đã chọn, hoặc một giá trị workspace.roots bạn đã ghi), nên Clark vẫn có quyền ở đó cho tới khi thư mục đó cũng bị thu hồi. Các phiên đang chạy vẫn giữ nguyên. Chỉ người dùng.