Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/api.html
Original file line number Diff line number Diff line change
Expand Up @@ -535,7 +535,7 @@ <h2 id="widget-dev-sessions">Widget dev sessions</h2>
<tr><td>GET</td><td><code>/widget-dev/sessions</code></td><td>–</td><td><code>{ sessions: [...] }</code></td></tr>
<tr><td>GET</td><td><code>/widget-dev/sessions/{id}</code></td><td>–</td><td>One session: <code>latest</code> (newest good build), <code>running</code>, <code>activation</code> (<code>active</code>, <code>awaiting-approval</code> with <code>approvalId</code>, <code>refused</code> with <code>code</code> and <code>message</code>, or <code>none</code>), <code>lastBuild</code> (with <code>diagnostics</code> when it failed), <code>showingLastKnownGood</code>, <code>placed</code>, and for a stopped session <code>stopReason</code> (<code>requested</code>, <code>watch-failed</code>, <code>folder-gone</code>, <code>capacity</code> or <code>root-refused</code>). Reading changes nothing.</td></tr>
<tr><td>DELETE</td><td><code>/widget-dev/sessions/{id}</code></td><td>–</td><td>Stops watching. The running generation stays installed and keeps rendering where it was placed.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/sessions/{id}/rebuild</code></td><td>–</td><td>Builds the folder now. <code>409 SESSION_STOPPED</code> for a stopped session. Person-only.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/sessions/{id}/rebuild</code></td><td>–</td><td>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. <code>409 SESSION_STOPPED</code> for a stopped session. Person-only.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/sessions/{id}/place</code></td><td><code>{ conversationId, widgetId? }</code></td><td>Places the running widget in a conversation. Person-only.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/chosen-folders/forget</code></td><td><code>{ root }</code></td><td>Takes back your choice of a folder: it no longer lets Clark start sessions in it, or in the folders inside it. Answers <code>{ root, forgotten, stillCoveredBy? }</code>; <code>forgotten</code> is <code>false</code> when the folder was not chosen, so a second press is harmless. <code>stillCoveredBy</code> names a folder Clark may still develop in that holds this one (another folder you chose, or a <code>workspace.roots</code> value you recorded), so Clark keeps access there until that one goes too. Running sessions stay as they are. Person-only.</td></tr>
</tbody>
Expand Down
2 changes: 1 addition & 1 deletion vi/docs/api.html
Original file line number Diff line number Diff line change
Expand Up @@ -535,7 +535,7 @@ <h2 id="widget-dev-sessions">Phiên phát triển widget</h2>
<tr><td>GET</td><td><code>/widget-dev/sessions</code></td><td>–</td><td><code>{ sessions: [...] }</code></td></tr>
<tr><td>GET</td><td><code>/widget-dev/sessions/{id}</code></td><td>–</td><td>Một phiên: <code>latest</code> (bản dựng tốt mới nhất), <code>running</code>, <code>activation</code> (<code>active</code>, <code>awaiting-approval</code> kèm <code>approvalId</code>, <code>refused</code> kèm <code>code</code> và <code>message</code>, hoặc <code>none</code>), <code>lastBuild</code> (kèm <code>diagnostics</code> khi lỗi), <code>showingLastKnownGood</code>, <code>placed</code>, và với phiên đã dừng là <code>stopReason</code> (<code>requested</code>, <code>watch-failed</code>, <code>folder-gone</code>, <code>capacity</code> hoặc <code>root-refused</code>). Việc đọc không thay đổi gì.</td></tr>
<tr><td>DELETE</td><td><code>/widget-dev/sessions/{id}</code></td><td>–</td><td>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.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/sessions/{id}/rebuild</code></td><td>–</td><td>Dựng thư mục ngay. <code>409 SESSION_STOPPED</code> với phiên đã dừng. Chỉ người dùng.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/sessions/{id}/rebuild</code></td><td>–</td><td>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. <code>409 SESSION_STOPPED</code> với phiên đã dừng. Chỉ người dùng.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/sessions/{id}/place</code></td><td><code>{ conversationId, widgetId? }</code></td><td>Đặt widget đang chạy vào một hội thoại. Chỉ người dùng.</td></tr>
<tr><td>POST</td><td><code>/widget-dev/chosen-folders/forget</code></td><td><code>{ root }</code></td><td>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ả <code>{ root, forgotten, stillCoveredBy? }</code>; <code>forgotten</code> là <code>false</code> khi thư mục chưa được chọn, nên bấm lần hai cũng không sao. <code>stillCoveredBy</code> 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ị <code>workspace.roots</code> 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.</td></tr>
</tbody>
Expand Down
Loading