samagotchi 0.133.0 → 0.135.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +116 -1
- data/bin/chi +2 -3
- data/docs/architecture.md +6 -3
- data/docs/cli.md +50 -34
- data/docs/configuration.md +9 -6
- data/docs/guardrails.md +146 -13
- data/docs/internals/background-tasks.md +1 -0
- data/docs/internals/engine.md +6 -3
- data/docs/internals/participants.md +7 -6
- data/docs/internals/tool-guardrails.md +2 -0
- data/docs/internals/web-frontend.md +262 -0
- data/docs/plugins.md +2 -1
- data/docs/sessions.md +5 -2
- data/docs/testing.md +34 -4
- data/lib/samagotchi/bridge.rb +11 -6
- data/lib/samagotchi/bridge_client.rb +8 -5
- data/lib/samagotchi/bundles/system/manifest.yml +1 -1
- data/lib/samagotchi/chi_home.rb +12 -2
- data/lib/samagotchi/config.rb +0 -2
- data/lib/samagotchi/desktop/macos.rb +19 -4
- data/lib/samagotchi/engine.rb +82 -12
- data/lib/samagotchi/guardrail_wiring.rb +8 -6
- data/lib/samagotchi/guardrails/approval.rb +41 -5
- data/lib/samagotchi/guardrails/implicit_writers.rb +158 -0
- data/lib/samagotchi/guardrails/pair_boundary.rb +11 -5
- data/lib/samagotchi/guardrails/pair_command.rb +828 -86
- data/lib/samagotchi/guardrails/parent_approvals.rb +13 -16
- data/lib/samagotchi/guardrails/read_only_shell.rb +58 -4
- data/lib/samagotchi/guardrails/shared_git.rb +1 -1
- data/lib/samagotchi/guardrails/shell_git_dirs.rb +7 -2
- data/lib/samagotchi/guardrails/shell_lex.rb +45 -0
- data/lib/samagotchi/guardrails/shell_paths.rb +3 -2
- data/lib/samagotchi/guardrails/targets.rb +8 -3
- data/lib/samagotchi/guardrails_command.rb +13 -10
- data/lib/samagotchi/home_command.rb +22 -6
- data/lib/samagotchi/home_doctor.rb +36 -3
- data/lib/samagotchi/home_notice.rb +8 -1
- data/lib/samagotchi/hooks/loader.rb +5 -0
- data/lib/samagotchi/llm/chat_loop.rb +4 -3
- data/lib/samagotchi/log_line.rb +12 -0
- data/lib/samagotchi/message_parts.rb +1 -1
- data/lib/samagotchi/project_env.rb +3 -11
- data/lib/samagotchi/revise_anchor.rb +33 -0
- data/lib/samagotchi/self_report.rb +3 -1
- data/lib/samagotchi/session_inbox.rb +20 -12
- data/lib/samagotchi/session_manager.rb +13 -11
- data/lib/samagotchi/system_one/approval_question.rb +21 -16
- data/lib/samagotchi/system_one/self_protect.rb +70 -16
- data/lib/samagotchi/testing/waiting.rb +13 -0
- data/lib/samagotchi/toolkit_binding.rb +16 -0
- data/lib/samagotchi/tools/delegate_relay.rb +6 -5
- data/lib/samagotchi/tools/delegate_wait.rb +5 -5
- data/lib/samagotchi/tools/execute.rb +6 -6
- data/lib/samagotchi/tools/output_guardrails.rb +9 -2
- data/lib/samagotchi/tools/read.rb +5 -5
- data/lib/samagotchi/turn_anchors.rb +49 -0
- data/lib/samagotchi/update_command.rb +7 -3
- data/lib/samagotchi/update_hint.rb +6 -1
- data/lib/samagotchi/verify_anchor.rb +5 -5
- data/lib/samagotchi/version.rb +1 -1
- data/lib/samagotchi/web/app.rb +2 -14
- data/lib/samagotchi/web/message_display.rb +17 -1
- data/lib/samagotchi/web/participant_access.rb +2 -2
- data/lib/samagotchi/web/participant_view.rb +8 -0
- data/lib/samagotchi/web/public/activity.js +1 -1
- data/lib/samagotchi/web/public/annotations.js +1 -1
- data/lib/samagotchi/web/public/answer_fold.js +262 -0
- data/lib/samagotchi/web/public/answer_refs.js +2 -0
- data/lib/samagotchi/web/public/app.js +462 -338
- data/lib/samagotchi/web/public/bubbles.js +3 -3
- data/lib/samagotchi/web/public/cards_place.js +9 -4
- data/lib/samagotchi/web/public/chip_popover.js +73 -11
- data/lib/samagotchi/web/public/claim_link.js +4 -2
- data/lib/samagotchi/web/public/composer.css +11 -1
- data/lib/samagotchi/web/public/context_chips.js +9 -6
- data/lib/samagotchi/web/public/data.js +4 -2
- data/lib/samagotchi/web/public/dock_reserve.js +13 -15
- data/lib/samagotchi/web/public/feature_gates.js +33 -0
- data/lib/samagotchi/web/public/history_reveal.js +27 -0
- data/lib/samagotchi/web/public/index.html +82 -37
- data/lib/samagotchi/web/public/latest.js +46 -0
- data/lib/samagotchi/web/public/lists_view.js +15 -13
- data/lib/samagotchi/web/public/live_timing.js +2 -0
- data/lib/samagotchi/web/public/llm_context_chip.js +5 -13
- data/lib/samagotchi/web/public/markdown_place.js +1 -1
- data/lib/samagotchi/web/public/method_api.js +14 -0
- data/lib/samagotchi/web/public/notifications.js +4 -11
- data/lib/samagotchi/web/public/participant.js +11 -6
- data/lib/samagotchi/web/public/participant_names.js +1 -1
- data/lib/samagotchi/web/public/participants_panel.js +4 -2
- data/lib/samagotchi/web/public/project_picker.js +18 -22
- data/lib/samagotchi/web/public/question_cards.js +2 -2
- data/lib/samagotchi/web/public/refs.js +6 -7
- data/lib/samagotchi/web/public/restore.js +2 -0
- data/lib/samagotchi/web/public/review_start.js +1 -1
- data/lib/samagotchi/web/public/revise_stack.js +372 -0
- data/lib/samagotchi/web/public/scope.js +12 -20
- data/lib/samagotchi/web/public/send_turn.js +29 -16
- data/lib/samagotchi/web/public/session_actions.js +15 -14
- data/lib/samagotchi/web/public/session_fields.js +152 -0
- data/lib/samagotchi/web/public/session_payload.js +35 -0
- data/lib/samagotchi/web/public/session_state.js +2 -0
- data/lib/samagotchi/web/public/session_store.js +191 -0
- data/lib/samagotchi/web/public/stage_model.js +4 -4
- data/lib/samagotchi/web/public/stage_view.js +11 -16
- data/lib/samagotchi/web/public/start_page.js +4 -4
- data/lib/samagotchi/web/public/start_settings.js +29 -18
- data/lib/samagotchi/web/public/start_toolkit.js +5 -4
- data/lib/samagotchi/web/public/stream_handlers.js +88 -90
- data/lib/samagotchi/web/public/task_stop.js +1 -1
- data/lib/samagotchi/web/public/timing.js +7 -3
- data/lib/samagotchi/web/public/{turn_view.js → turn_block.js} +46 -101
- data/lib/samagotchi/web/public/turn_events.js +2 -2
- data/lib/samagotchi/web/public/turn_html.js +17 -9
- data/lib/samagotchi/web/public/turn_model.js +6 -6
- data/lib/samagotchi/web/public/turn_range.js +32 -0
- data/lib/samagotchi/web/public/verdict_card.js +5 -13
- data/lib/samagotchi/web/public/verdict_fresh.js +2 -0
- data/lib/samagotchi/web/public/verify_target.js +7 -10
- data/lib/samagotchi/web/public/working_set_view.js +3 -1
- data/lib/samagotchi/web/server.rb +4 -4
- data/lib/samagotchi/web/session_control.rb +2 -2
- data/lib/samagotchi/worker.rb +9 -9
- data/lib/samagotchi/worker_inbound.rb +6 -5
- metadata +16 -3
- data/lib/samagotchi/web/public/hold.js +0 -78
|
@@ -11,8 +11,9 @@ import { composerAfterAck, dropEarlyRestores, restoreOnAck } from "./restore.js"
|
|
|
11
11
|
// /turn and its ack, a fast failure's restore (restore.js) and the error's
|
|
12
12
|
// words.
|
|
13
13
|
//
|
|
14
|
-
// Hooks: +session()+ the open session's id or null; +
|
|
15
|
-
// (
|
|
14
|
+
// Hooks: +session()+ the open session's id or null; +store+ the page's
|
|
15
|
+
// session store (session_store.js; store.current: owner, commands,
|
|
16
|
+
// firstPreview, written through store.update); +running()+ a turn
|
|
16
17
|
// runs; +clientId+; +sentIds+ / +earlyRestores+ (restore.js' bookkeeping);
|
|
17
18
|
// +api+: {createIdleSession, uploadImage, sendTurn} (data.js); +dir+: the
|
|
18
19
|
// page's scope folder (new sessions start there); +startPage+
|
|
@@ -23,15 +24,16 @@ import { composerAfterAck, dropEarlyRestores, restoreOnAck } from "./restore.js"
|
|
|
23
24
|
// text was written in session id)}; +historyEl+,
|
|
24
25
|
// +turnDom+; +makeUserBubble(prompt, opts)+, +bubbleById(id)+,
|
|
25
26
|
// +addCommandBubble(view)+; +addCreatedSession(created)+, +select(id)+,
|
|
26
|
-
// +showNotice(text)+,
|
|
27
|
+
// +showNotice(text)+,
|
|
27
28
|
// +followWokenWorker()+, +refreshHistory()+, +leaveGoneSession(id, why)+,
|
|
28
29
|
// +runCommand(command)+ (composer.js send), +toast(text, action, options)+;
|
|
29
30
|
// +alert+: the browser's.
|
|
30
31
|
export function createSendTurn({
|
|
31
|
-
session,
|
|
32
|
+
session, store, running, clientId, sentIds, earlyRestores, api, dir, startPage, takeDelivery, composer,
|
|
32
33
|
verify = () => null, clearVerify = () => {}, restoreVerify = () => {},
|
|
34
|
+
revise = () => null, clearRevise = () => {}, restoreRevise = () => {},
|
|
33
35
|
historyEl, turnDom, makeUserBubble, bubbleById, addCommandBubble,
|
|
34
|
-
addCreatedSession, select, showNotice,
|
|
36
|
+
addCreatedSession, select, showNotice, followWokenWorker, refreshHistory,
|
|
35
37
|
leaveGoneSession, runCommand, toast, alert = (text) => globalThis.alert(text),
|
|
36
38
|
}) {
|
|
37
39
|
const promptEl = composer.el;
|
|
@@ -63,7 +65,7 @@ export function createSendTurn({
|
|
|
63
65
|
}
|
|
64
66
|
|
|
65
67
|
async function send({ delivery: chosen = null } = {}) {
|
|
66
|
-
if (
|
|
68
|
+
if (store.current.owner === "tui") return;
|
|
67
69
|
// A fresh link's pick first: its /model is queued in the worker once
|
|
68
70
|
// acked, and the worker runs queued commands before a turn's input.
|
|
69
71
|
const pick = startPage.pendingPick();
|
|
@@ -81,7 +83,7 @@ export function createSendTurn({
|
|
|
81
83
|
// Where the line goes (composer.js): the page's own reply, a session to
|
|
82
84
|
// make first (the start page), a command, or a turn.
|
|
83
85
|
let route = routeComposerLine(prompt, {
|
|
84
|
-
session: !!session(), running: running(), commands:
|
|
86
|
+
session: !!session(), running: running(), commands: store.current.commands, images: composer.chips().length,
|
|
85
87
|
});
|
|
86
88
|
if (route.create) {
|
|
87
89
|
actionBtn.disabled = true;
|
|
@@ -99,7 +101,7 @@ export function createSendTurn({
|
|
|
99
101
|
actionBtn.disabled = false;
|
|
100
102
|
}
|
|
101
103
|
// In the new session, by its command list (select read it).
|
|
102
|
-
route = routeSessionLine(route.send, { commands:
|
|
104
|
+
route = routeSessionLine(route.send, { commands: store.current.commands, images: composer.chips().length, delivery: route.delivery });
|
|
103
105
|
}
|
|
104
106
|
if (route.reply) {
|
|
105
107
|
// The start page's reply is a notice: no session is made for it (2.29).
|
|
@@ -116,16 +118,15 @@ export function createSendTurn({
|
|
|
116
118
|
if (hint) hint.remove();
|
|
117
119
|
// Sending moves a finished turn out of the stage at once (else the echo
|
|
118
120
|
// would land among its rows); into a running one it is a queued row there.
|
|
119
|
-
turnDom.handOff
|
|
121
|
+
turnDom.handOff({ immediate: true });
|
|
120
122
|
const sending = composer.chips().slice();
|
|
121
123
|
// Into a running turn the echo says what it waits for (its delivery); a
|
|
122
124
|
// line with images always waits for the turn's end (the worker queues it).
|
|
123
125
|
const shownDelivery = isRunning ? (sending.length ? "queue" : delivery || "next_step") : null;
|
|
124
126
|
const echo = makeUserBubble(prompt, { state: "queued", own: true, images: sending, delivery: shownDelivery });
|
|
125
|
-
if (!turnDom.holds
|
|
126
|
-
if (!
|
|
127
|
-
|
|
128
|
-
updateInfoBar();
|
|
127
|
+
if (!turnDom.holds()) historyEl.scrollTop = historyEl.scrollHeight;
|
|
128
|
+
if (!store.current.firstPreview || store.current.firstPreview === "—") {
|
|
129
|
+
store.update({ current: { firstPreview: firstPreview(prompt) } });
|
|
129
130
|
}
|
|
130
131
|
actionBtn.disabled = true;
|
|
131
132
|
// The session the line goes to: the page may switch to another while an
|
|
@@ -134,8 +135,14 @@ export function createSendTurn({
|
|
|
134
135
|
try {
|
|
135
136
|
await uploadChips(sending, sentTo, { upload: api.uploadImage });
|
|
136
137
|
const verifyAnchor = verify();
|
|
138
|
+
// The armed Revise ({turn_id, label}; null while its gate refuses).
|
|
139
|
+
const reviseAnchor = revise();
|
|
140
|
+
// A Verify turn's prompt: no Revise on its answer (revise_stack.js),
|
|
141
|
+
// as a reload's data-verify says.
|
|
142
|
+
if (verifyAnchor) echo.dataset.verify = "1";
|
|
137
143
|
const ack = await api.sendTurn(sentTo, prompt, {
|
|
138
144
|
clientId, images: turnRefs(sending), history: typed, delivery, ...(verifyAnchor ? { verify: verifyAnchor } : {}),
|
|
145
|
+
...(reviseAnchor ? { revises: { turn_id: reviseAnchor.turn_id } } : {}),
|
|
139
146
|
});
|
|
140
147
|
if (ack?.command_id) {
|
|
141
148
|
// The worker knew it as a command (its list was newer than ours):
|
|
@@ -146,6 +153,7 @@ export function createSendTurn({
|
|
|
146
153
|
return;
|
|
147
154
|
}
|
|
148
155
|
if (verifyAnchor) clearVerify(verifyAnchor);
|
|
156
|
+
if (reviseAnchor) clearRevise(reviseAnchor);
|
|
149
157
|
if (ack?.enqueued_id) sentIds.add(ack.enqueued_id);
|
|
150
158
|
// A cut the worker didn't take (no thinking-only step: cut off) goes in
|
|
151
159
|
// at the next step; a queue whose turn ended meanwhile is the next turn.
|
|
@@ -161,6 +169,8 @@ export function createSendTurn({
|
|
|
161
169
|
if (restored?.refill && sentTo === session()) composer.openForVisit();
|
|
162
170
|
// Its Verify claim too, so the resend still records a verdict.
|
|
163
171
|
if (restored?.refill && restored.verify && sentTo === session()) restoreVerify(restored.verify);
|
|
172
|
+
// And its Revise draft, so the resend still stacks.
|
|
173
|
+
if (restored?.refill && restored.revises && sentTo === session()) restoreRevise(restored.revises);
|
|
164
174
|
const before = promptEl.value;
|
|
165
175
|
promptEl.value = composerAfterAck({ sent: line, current: before, refill: restored?.refill || "" });
|
|
166
176
|
// A line back from sentTo is a draft of that session, wherever the page is now.
|
|
@@ -189,8 +199,8 @@ export function createSendTurn({
|
|
|
189
199
|
// image refused (bad_image, too_large, bad_images) says why below.
|
|
190
200
|
if (e.code === "owned_by_tui") {
|
|
191
201
|
if (sentTo !== session()) return toast(cantText(`send to ${sentTo.slice(0, 8)}`, e), null, { sticky: true });
|
|
192
|
-
|
|
193
|
-
|
|
202
|
+
// The composer and the bar (its continue and stop, the title's ✎) follow.
|
|
203
|
+
store.update({ current: { owner: "tui" } });
|
|
194
204
|
return;
|
|
195
205
|
}
|
|
196
206
|
// A stale tab sent into a session deleted meanwhile: the start page
|
|
@@ -198,9 +208,12 @@ export function createSendTurn({
|
|
|
198
208
|
if (e.code === "not_found") return leaveGoneSession(sentTo, "not_found");
|
|
199
209
|
// A /queue to a worker that can't queue (it would steer): its words, the text kept.
|
|
200
210
|
if (e.code === "delivery_unavailable" && sentTo === session()) return addCommandBubble({ label: null, line, text: e.body?.detail || e.message, failed: true });
|
|
211
|
+
// A Revise to a worker from before Revise turns (the page's gate saw
|
|
212
|
+
// none yet): its words, the text and the chip kept.
|
|
213
|
+
if (e.code === "revise_unavailable" && sentTo === session()) return addCommandBubble({ label: null, line, text: e.body?.detail || e.message, failed: true });
|
|
201
214
|
toast(cantText("send", e), null, { sticky: true });
|
|
202
215
|
} finally {
|
|
203
|
-
actionBtn.disabled =
|
|
216
|
+
actionBtn.disabled = store.current.owner === "tui";
|
|
204
217
|
composer.focus();
|
|
205
218
|
}
|
|
206
219
|
}
|
|
@@ -7,13 +7,16 @@ import { inTree } from "./sessions_list.js";
|
|
|
7
7
|
// and Unarchive, Delete and Stop, from the info bar's buttons, a card's or a
|
|
8
8
|
// batch; and the start page when the open session is gone.
|
|
9
9
|
//
|
|
10
|
-
// Hooks: +selected()+ the open session's id or null; +
|
|
11
|
-
// (
|
|
10
|
+
// Hooks: +selected()+ the open session's id or null; +store+ the page's
|
|
11
|
+
// session store (session_store.js: Stop's status; touch("infoBar") for the
|
|
12
|
+
// continue and review in-flight sets, which it doesn't hold); +sessions()+ /
|
|
13
|
+
// +setSessions(list)+ the page's list (the store's: a new list redraws the
|
|
14
|
+
// lists and the bar);
|
|
12
15
|
// +api+: {continueSession, startReview, archiveSession, unarchiveSession,
|
|
13
16
|
// deleteSession, stopSession, sessionHolds, stopSessionHolds} (data.js);
|
|
14
17
|
// +eventsLive()+ the hub's stream is open (else
|
|
15
|
-
// +refresh()+ fetches the list);
|
|
16
|
-
// +select(id)+, +clearSelection()+, +showNotice(text)+,
|
|
18
|
+
// +refresh()+ fetches the list);
|
|
19
|
+
// +select(id)+, +clearSelection()+, +showNotice(text)+,
|
|
17
20
|
// +toast(text, action, options)+, +addCreatedSession(created)+,
|
|
18
21
|
// +fillOpener(created, continuedId)+ (the new link's composer; returns a draft
|
|
19
22
|
// from another session it displaced, or null), +restoreDraft(draft, opener)+
|
|
@@ -28,8 +31,8 @@ export function reviewStartedText(id, created) {
|
|
|
28
31
|
}
|
|
29
32
|
|
|
30
33
|
export function createSessionActions({
|
|
31
|
-
selected,
|
|
32
|
-
select, clearSelection, showNotice,
|
|
34
|
+
selected, store, sessions, setSessions, api, eventsLive, refresh,
|
|
35
|
+
select, clearSelection, showNotice, toast, addCreatedSession, fillOpener, restoreDraft, closeLiveStream, workerGone,
|
|
33
36
|
alert = (text) => globalThis.alert(text), confirm = (text) => globalThis.confirm(text),
|
|
34
37
|
// The Stop sheet (stop_sheet.js): +open(id, holds)+ shows it and answers
|
|
35
38
|
// true; nothing to stop (or no sheet wired) is false, and Stop is the
|
|
@@ -59,7 +62,6 @@ export function createSessionActions({
|
|
|
59
62
|
}
|
|
60
63
|
setSessions(sessions().filter((s) => s.id !== id));
|
|
61
64
|
if (selected() === id) clearSelection();
|
|
62
|
-
lists.render();
|
|
63
65
|
}
|
|
64
66
|
|
|
65
67
|
// The open session no longer exists: back to the start page, saying why.
|
|
@@ -146,7 +148,7 @@ export function createSessionActions({
|
|
|
146
148
|
const id = selected();
|
|
147
149
|
const short = id.slice(0, 8);
|
|
148
150
|
continuingIds.add(id);
|
|
149
|
-
|
|
151
|
+
store.touch("infoBar");
|
|
150
152
|
try {
|
|
151
153
|
const created = await api.continueSession(id);
|
|
152
154
|
markArchived([id], true);
|
|
@@ -176,7 +178,7 @@ export function createSessionActions({
|
|
|
176
178
|
}
|
|
177
179
|
} finally {
|
|
178
180
|
continuingIds.delete(id);
|
|
179
|
-
|
|
181
|
+
store.touch("infoBar");
|
|
180
182
|
}
|
|
181
183
|
}
|
|
182
184
|
|
|
@@ -192,7 +194,7 @@ export function createSessionActions({
|
|
|
192
194
|
if (!selected() || reviewingIds.has(selected())) return null;
|
|
193
195
|
const id = selected();
|
|
194
196
|
reviewingIds.add(id);
|
|
195
|
-
|
|
197
|
+
store.touch("infoBar");
|
|
196
198
|
try {
|
|
197
199
|
const created = await api.startReview(id);
|
|
198
200
|
addCreatedSession(created);
|
|
@@ -210,7 +212,7 @@ export function createSessionActions({
|
|
|
210
212
|
return null;
|
|
211
213
|
} finally {
|
|
212
214
|
reviewingIds.delete(id);
|
|
213
|
-
|
|
215
|
+
store.touch("infoBar");
|
|
214
216
|
}
|
|
215
217
|
}
|
|
216
218
|
|
|
@@ -235,7 +237,7 @@ export function createSessionActions({
|
|
|
235
237
|
// archive): don't wait for its stream to notice.
|
|
236
238
|
function stoppedWorker(id) {
|
|
237
239
|
closeLiveStream();
|
|
238
|
-
|
|
240
|
+
store.setStatus("stopped", "stop");
|
|
239
241
|
workerGone(id);
|
|
240
242
|
}
|
|
241
243
|
|
|
@@ -270,8 +272,7 @@ export function createSessionActions({
|
|
|
270
272
|
alert(`Could not ${archive ? "archive" : "unarchive"} session ${short}: ${answer.error.message}`);
|
|
271
273
|
return;
|
|
272
274
|
}
|
|
273
|
-
lists.
|
|
274
|
-
updateInfoBar();
|
|
275
|
+
// markArchived's list redrew the lists and the bar already.
|
|
275
276
|
if (!eventsLive()) refresh();
|
|
276
277
|
const what = archive ? "Archived" : "Unarchived";
|
|
277
278
|
toast(`${what} ${short}`, undo ? { label: "Undo", run: () => setArchived(id, !archive, { undo: false }) } : null);
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
// The open session's fields (session_state.js emptySessionState), one entry
|
|
2
|
+
// each: where a payload (GET /sessions/:id) and a hub card carry it, what
|
|
3
|
+
// redraws it (session_store.js ORDER names) and who writes it. The table a
|
|
4
|
+
// new field or a new writer starts from (docs/internals/web-frontend.md,
|
|
5
|
+
// "The session store").
|
|
6
|
+
//
|
|
7
|
+
// Every write goes through the store (app.js `store`: update, setStatus,
|
|
8
|
+
// replaceCurrent), never `current.X = …` (the lint rule in
|
|
9
|
+
// eslint.config.js). Two writers stay outside, on purpose (D8):
|
|
10
|
+
// - live_timing.js sets `timing().activeTurn` in place (start, finish,
|
|
11
|
+
// finishLine): the running turn's own clock, which mergeTurnTiming keeps.
|
|
12
|
+
// - verdict_fresh.js `startFresh` pushes onto `fresh.running`, which is
|
|
13
|
+
// `verifyFresh` (verifyFreshState hands the array out): returning the
|
|
14
|
+
// entry for an update would leave the card holding the old array.
|
|
15
|
+
//
|
|
16
|
+
// A new module: the page's modules are cached at unversioned URLs, and a
|
|
17
|
+
// new export of an old module would leave a cached copy without it.
|
|
18
|
+
|
|
19
|
+
import { withLiveStatus } from "./format.js";
|
|
20
|
+
|
|
21
|
+
const isList = (v) => Array.isArray(v);
|
|
22
|
+
const list = (v) => (isList(v) ? v : undefined);
|
|
23
|
+
|
|
24
|
+
// Per field:
|
|
25
|
+
// source(payload) the payload carries it (not undefined): a partial
|
|
26
|
+
// re-read takes it (session_payload.js sessionFieldsFrom).
|
|
27
|
+
// No source: a payload always sets it (sessionStateFrom),
|
|
28
|
+
// or never does (the page's own fields).
|
|
29
|
+
// card(sess) its value on a hub card (followSelectedSession)
|
|
30
|
+
// redraws what reads it (session_store.js ORDER)
|
|
31
|
+
// writers who writes it (besides renderSessionView's payload and
|
|
32
|
+
// forgetSession's reset, which write every field)
|
|
33
|
+
export const FIELDS = {
|
|
34
|
+
firstPreview: { redraws: ["infoBar"], writers: "send_turn.js (the first prompt)" },
|
|
35
|
+
usedMemories: {
|
|
36
|
+
source: (d) => list(d.session?.used_memory_names),
|
|
37
|
+
redraws: ["infoBar"],
|
|
38
|
+
writers: "setUsedMemories (stream), readTurnEnd; both replace the card too",
|
|
39
|
+
},
|
|
40
|
+
preloadedMemories: { source: (d) => list(d.session?.preloaded_memory_names), redraws: ["infoBar"], writers: "the payload" },
|
|
41
|
+
mutedMemories: { source: (d) => list(d.session?.muted_memory_names), redraws: ["infoBar"], writers: "the payload" },
|
|
42
|
+
promptNotes: { source: (d) => list(d.session?.prompt_notes), redraws: ["infoBar"], writers: "readTurnEnd" },
|
|
43
|
+
parentId: { redraws: ["infoBar"], writers: "the payload" },
|
|
44
|
+
continues: { redraws: ["infoBar"], writers: "the payload" },
|
|
45
|
+
review: { redraws: ["infoBar"], writers: "the payload" },
|
|
46
|
+
verdicts: {
|
|
47
|
+
source: (d) => list(d.session?.verdicts),
|
|
48
|
+
redraws: [],
|
|
49
|
+
writers: "placeVerdict (its card draws itself: placeVerdictWithFresh)",
|
|
50
|
+
},
|
|
51
|
+
verifyFresh: {
|
|
52
|
+
source: (d) => list(d.session?.verify_fresh),
|
|
53
|
+
redraws: [],
|
|
54
|
+
writers: "placeVerdict (settleRunning); verdict_fresh.js startFresh pushes in place (D8)",
|
|
55
|
+
},
|
|
56
|
+
createdAt: { redraws: ["infoBar"], writers: "the payload" },
|
|
57
|
+
ctxPct: { redraws: ["infoBar"], writers: "stream_handlers.js (generation_chunk, context_status)" },
|
|
58
|
+
ctxWindow: { redraws: ["infoBar"], writers: "stream_handlers.js (generation_started, context_status)" },
|
|
59
|
+
ctxWindowSource: { redraws: ["infoBar"], writers: "stream_handlers.js (generation_started, context_status)" },
|
|
60
|
+
ctxUnknownAfterSwitch: { redraws: ["infoBar"], writers: "stream_handlers.js (generation_started, context_status)" },
|
|
61
|
+
status: {
|
|
62
|
+
source: (d) => d.session?.status || undefined,
|
|
63
|
+
card: (sess) => sess.status,
|
|
64
|
+
redraws: ["infoBar"],
|
|
65
|
+
writers: "store.setStatus only (statusWrite below): the hub, the stream, a turn end's re-read, Stop, the payload",
|
|
66
|
+
},
|
|
67
|
+
thinking: { redraws: ["thinkingChip", "infoBar"], writers: "stream_handlers.js command_ran" },
|
|
68
|
+
model: {
|
|
69
|
+
source: (d) => d.session?.model_name,
|
|
70
|
+
redraws: ["infoBar"],
|
|
71
|
+
writers: "stream_handlers.js command_ran (a new model also syncModelPick: an event, D9)",
|
|
72
|
+
},
|
|
73
|
+
served: { redraws: ["infoBar"], writers: "stream_handlers.js (command_ran, generation_completed)" },
|
|
74
|
+
dir: { source: (d) => d.session?.working_directory, redraws: ["infoBar"], writers: "the payload" },
|
|
75
|
+
owner: {
|
|
76
|
+
card: (sess) => sess.owner || null,
|
|
77
|
+
redraws: ["composer", "infoBar"],
|
|
78
|
+
writers: "followSelectedSession, workerGone (worker → null), send_turn.js and composerCommands.ownedByTui (\"tui\")",
|
|
79
|
+
},
|
|
80
|
+
commands: {
|
|
81
|
+
source: (d) => list(d.commands),
|
|
82
|
+
redraws: ["infoBar"],
|
|
83
|
+
writers: "the payload (the / list and the annotate bar read it at use; the bar refreshes the annotate bar)",
|
|
84
|
+
},
|
|
85
|
+
workerVersion: { card: (sess) => sess.worker_version || null, redraws: ["infoBar"], writers: "followSelectedSession" },
|
|
86
|
+
workerFeatures: {
|
|
87
|
+
card: (sess) => (isList(sess.worker_features) ? sess.worker_features : []),
|
|
88
|
+
redraws: ["featureGates", "infoBar"],
|
|
89
|
+
writers: "followSelectedSession",
|
|
90
|
+
},
|
|
91
|
+
bridgeUp: {
|
|
92
|
+
card: (sess) => sess.bridge_up === true,
|
|
93
|
+
redraws: ["featureGates", "infoBar"],
|
|
94
|
+
writers: "followSelectedSession, workerGone",
|
|
95
|
+
},
|
|
96
|
+
llmContext: {
|
|
97
|
+
redraws: ["llmContextChip", "workingSetStrategy", "infoBar"],
|
|
98
|
+
writers: "stream_handlers.js command_ran",
|
|
99
|
+
},
|
|
100
|
+
reasoningHistory: { redraws: ["reasoningChip", "infoBar"], writers: "stream_handlers.js command_ran" },
|
|
101
|
+
toolkit: { redraws: ["infoBar"], writers: "stream_handlers.js (command_ran, hook_notice)" },
|
|
102
|
+
timing: {
|
|
103
|
+
source: (d) => d.timing,
|
|
104
|
+
redraws: ["infoBar"],
|
|
105
|
+
writers: "mergeTurnTiming; stream_handlers.js (generation_completed: tokens, modelSegments; side_usage: side), " +
|
|
106
|
+
"always a new object; live_timing.js sets activeTurn in place (D8)",
|
|
107
|
+
},
|
|
108
|
+
turnStarted: { redraws: ["composer", "infoBar"], writers: "setTurnRunning" },
|
|
109
|
+
streamSeq: { redraws: [], writers: "resync" },
|
|
110
|
+
streamFromGuess: { redraws: [], writers: "followWokenWorker, startStream, the stream's takeGuess" },
|
|
111
|
+
attachCopiedAt: { redraws: ["infoBar"], writers: "the info bar's copy button" },
|
|
112
|
+
};
|
|
113
|
+
|
|
114
|
+
// The fields a hub card brings for the open session (followSelectedSession):
|
|
115
|
+
// its owner and worker. Never its status: that goes through setStatus, so
|
|
116
|
+
// "the hub's status only while not streaming" can't be bypassed.
|
|
117
|
+
const CARD_FIELDS = ["owner", "workerVersion", "workerFeatures", "bridgeUp"];
|
|
118
|
+
|
|
119
|
+
// @param sess a hub card (the open session's)
|
|
120
|
+
// @return {owner, workerVersion, workerFeatures, bridgeUp}
|
|
121
|
+
export function fieldsFromCard(sess) {
|
|
122
|
+
return Object.fromEntries(CARD_FIELDS.map((key) => [key, FIELDS[key].card(sess)]));
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// Whether a status write from +source+ applies, and what it does to the
|
|
126
|
+
// open session's card (null: the card is left alone).
|
|
127
|
+
// payload renderSessionView: always
|
|
128
|
+
// hub followSelectedSession: only while the stream isn't live
|
|
129
|
+
// stream setLiveStatus (turn_*, workerGone's idle): always; the card
|
|
130
|
+
// takes it too (withLiveStatus: status, owner, updated_at)
|
|
131
|
+
// turnEnd readTurnEnd, the turn_canceled re-read: only while no turn
|
|
132
|
+
// runs (a re-read landing after the next queued turn's
|
|
133
|
+
// turn_started doesn't write its stored "idle" over "running";
|
|
134
|
+
// mergeTurnTiming keeps activeTurn by the same test); the caller
|
|
135
|
+
// skips a payload without one; readTurnEnd writes its card
|
|
136
|
+
// itself, after its timing merge
|
|
137
|
+
// stop session_actions.js stoppedWorker: always; workerGone's
|
|
138
|
+
// withoutWorker takes care of the card
|
|
139
|
+
// @param source one of the above
|
|
140
|
+
// @param streaming whether the open session's stream is live
|
|
141
|
+
// @param running whether a turn runs on the page (liveTurn.running)
|
|
142
|
+
// @return {apply, card: (sess, status) => sess | null}
|
|
143
|
+
export function statusWrite(source, { streaming = false, running = false } = {}) {
|
|
144
|
+
switch (source) {
|
|
145
|
+
case "payload": return { apply: true, card: null };
|
|
146
|
+
case "hub": return { apply: !streaming, card: null };
|
|
147
|
+
case "stream": return { apply: true, card: withLiveStatus };
|
|
148
|
+
case "turnEnd": return { apply: !running, card: null };
|
|
149
|
+
case "stop": return { apply: true, card: null };
|
|
150
|
+
default: throw new Error(`statusWrite: no source ${source}`);
|
|
151
|
+
}
|
|
152
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
// A partial re-read of the open session (GET /sessions/:id with ?tail,
|
|
2
|
+
// ?recent…): the fields of the page's session state it brings, read as a
|
|
3
|
+
// full load reads them (session_state.js sessionStateFrom), so a field's
|
|
4
|
+
// rule lives in one place. app.js applySessionPayload writes them through
|
|
5
|
+
// the store; the caller then calls the field's redraw
|
|
6
|
+
// (docs/internals/web-frontend.md, "The session store").
|
|
7
|
+
//
|
|
8
|
+
// A new module, not an export of session_state.js: the page's modules are
|
|
9
|
+
// cached at unversioned URLs, and a new export of an old module would
|
|
10
|
+
// leave a cached copy without it.
|
|
11
|
+
|
|
12
|
+
import { sessionStateFrom } from "./session_state.js";
|
|
13
|
+
import { FIELDS } from "./session_fields.js";
|
|
14
|
+
|
|
15
|
+
// Where each field comes from in the payload (session_fields.js FIELDS
|
|
16
|
+
// sources): a field whose source the payload doesn't carry (a partial read
|
|
17
|
+
// leaves it out, or an older chi web never sent it) is not touched. Fields
|
|
18
|
+
// without one are always taken.
|
|
19
|
+
//
|
|
20
|
+
// The named +fields+ of the session state +data+ sets (sessionStateFrom's
|
|
21
|
+
// values), those whose source it carries.
|
|
22
|
+
// @param data a GET /sessions/:id answer (it has a session)
|
|
23
|
+
// @param fields the state's keys (emptySessionState's), e.g. ["status"]
|
|
24
|
+
// @return {field: value} for the fields it brings
|
|
25
|
+
export function sessionFieldsFrom(data, fields) {
|
|
26
|
+
if (!data?.session) return {};
|
|
27
|
+
const all = sessionStateFrom(data);
|
|
28
|
+
const out = {};
|
|
29
|
+
for (const field of fields) {
|
|
30
|
+
const source = FIELDS[field]?.source;
|
|
31
|
+
if (source && source(data) === undefined) continue;
|
|
32
|
+
if (field in all) out[field] = all[field];
|
|
33
|
+
}
|
|
34
|
+
return out;
|
|
35
|
+
}
|
|
@@ -40,6 +40,8 @@ export function emptySessionState() {
|
|
|
40
40
|
// (stream_handlers.js context_status): the ctx tooltip says it waits.
|
|
41
41
|
ctxUnknownAfterSwitch: false,
|
|
42
42
|
status: "",
|
|
43
|
+
// The level the next turn thinks at ({level, source, own}: the thinking chip), or null.
|
|
44
|
+
thinking: null,
|
|
43
45
|
model: "",
|
|
44
46
|
// What the worker's server said it served for a model name: [served, asked].
|
|
45
47
|
served: null,
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
// The owner page's session state in one place: the open session's id
|
|
2
|
+
// (selected), its fields (current, session_state.js) and every card
|
|
3
|
+
// (sessions, the hub's projection). Writes go through update() (and
|
|
4
|
+
// replaceCurrent() for forgetSession's reset); a write marks the redraws
|
|
5
|
+
// that read what changed, and they run synchronously at the end of the
|
|
6
|
+
// outermost batch(), or at once for a bare write.
|
|
7
|
+
// See docs/internals/web-frontend.md ("The session store").
|
|
8
|
+
//
|
|
9
|
+
// A new module: the page's modules are cached at unversioned URLs, and a
|
|
10
|
+
// new export of an old module would leave a cached copy without it.
|
|
11
|
+
|
|
12
|
+
import { FIELDS, statusWrite } from "./session_fields.js";
|
|
13
|
+
|
|
14
|
+
// The redraws, by name, in the one order a flush runs them: the lists
|
|
15
|
+
// before the bar (updateSessionTitle reads the strip's active card), the
|
|
16
|
+
// composer before the bar (as setTurnRunning runs them).
|
|
17
|
+
export const ORDER = [
|
|
18
|
+
"lists",
|
|
19
|
+
"paintActive",
|
|
20
|
+
"llmContextChip", "thinkingChip", "reasoningChip", "workingSetStrategy",
|
|
21
|
+
"featureGates",
|
|
22
|
+
"composer",
|
|
23
|
+
"infoBar",
|
|
24
|
+
];
|
|
25
|
+
|
|
26
|
+
// What a change of the list or of the open session's id redraws: the bar
|
|
27
|
+
// reads the list too (the chain's ← → links, the children chip, the
|
|
28
|
+
// archived button, the card's title, the fresh link's picker).
|
|
29
|
+
const SESSIONS_REDRAWS = ["lists", "infoBar"];
|
|
30
|
+
const SELECTED_REDRAWS = ["paintActive", "composer", "infoBar"];
|
|
31
|
+
|
|
32
|
+
// A flush whose redraws keep writing stops after this many passes.
|
|
33
|
+
export const MAX_PASSES = 3;
|
|
34
|
+
|
|
35
|
+
// @param initial the open session's fields to start from (emptySessionState())
|
|
36
|
+
// @param fields {key: {redraws: [name]}} what each field of `current` redraws
|
|
37
|
+
// (session_fields.js FIELDS by default); a field it doesn't list redraws nothing
|
|
38
|
+
// @param log where a refused batch, a capped flush and a redraw error that
|
|
39
|
+
// can't be thrown go (console by default)
|
|
40
|
+
export function createSessionStore({ initial = {}, fields = FIELDS, log = console } = {}) {
|
|
41
|
+
let selected = null;
|
|
42
|
+
let current = initial;
|
|
43
|
+
let sessions = [];
|
|
44
|
+
const redraws = new Map(ORDER.map((name) => [name, []]));
|
|
45
|
+
const pending = new Set();
|
|
46
|
+
let depth = 0;
|
|
47
|
+
let flushing = false;
|
|
48
|
+
|
|
49
|
+
const enqueue = (names) => names.forEach((name) => pending.add(name));
|
|
50
|
+
const fieldRedraws = (key) => fields[key]?.redraws || [];
|
|
51
|
+
|
|
52
|
+
// Run the pending redraws in ORDER, a pass at a time: a write made during
|
|
53
|
+
// a redraw only enqueues (the flushing flag), and the next pass takes it.
|
|
54
|
+
// A redraw that throws doesn't stop the others; the first error is thrown
|
|
55
|
+
// once the flush is over.
|
|
56
|
+
function flush() {
|
|
57
|
+
if (flushing || depth > 0) return;
|
|
58
|
+
flushing = true;
|
|
59
|
+
let error = null;
|
|
60
|
+
try {
|
|
61
|
+
for (let pass = 0; pending.size > 0; pass += 1) {
|
|
62
|
+
if (pass === MAX_PASSES) {
|
|
63
|
+
log.error(`session store: still redrawing after ${MAX_PASSES} passes: ${[...pending].join(", ")}`);
|
|
64
|
+
pending.clear();
|
|
65
|
+
break;
|
|
66
|
+
}
|
|
67
|
+
const names = ORDER.filter((name) => pending.has(name));
|
|
68
|
+
pending.clear();
|
|
69
|
+
for (const name of names) {
|
|
70
|
+
for (const fn of redraws.get(name)) {
|
|
71
|
+
try {
|
|
72
|
+
fn();
|
|
73
|
+
} catch (e) {
|
|
74
|
+
error ??= e;
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
} finally {
|
|
80
|
+
flushing = false;
|
|
81
|
+
}
|
|
82
|
+
if (error) throw error;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
const store = {
|
|
86
|
+
get selected() { return selected; },
|
|
87
|
+
get current() { return current; },
|
|
88
|
+
get sessions() { return sessions; },
|
|
89
|
+
|
|
90
|
+
// Write the given parts: +selected+ (an id or null), +current+ (fields
|
|
91
|
+
// written into the open session's object, which stays the same object),
|
|
92
|
+
// +sessions+ (a new list: one changed in place isn't seen). A changed
|
|
93
|
+
// value (!==) marks its redraws.
|
|
94
|
+
update(patch = {}) {
|
|
95
|
+
if ("selected" in patch && patch.selected !== selected) {
|
|
96
|
+
selected = patch.selected;
|
|
97
|
+
enqueue(SELECTED_REDRAWS);
|
|
98
|
+
}
|
|
99
|
+
if (patch.current) {
|
|
100
|
+
for (const [key, value] of Object.entries(patch.current)) {
|
|
101
|
+
if (current[key] === value) continue;
|
|
102
|
+
current[key] = value;
|
|
103
|
+
enqueue(fieldRedraws(key));
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
if ("sessions" in patch && patch.sessions !== sessions) {
|
|
107
|
+
sessions = patch.sessions;
|
|
108
|
+
enqueue(SESSIONS_REDRAWS);
|
|
109
|
+
}
|
|
110
|
+
flush();
|
|
111
|
+
},
|
|
112
|
+
|
|
113
|
+
// The open session's status from +source+ (session_fields.js statusWrite:
|
|
114
|
+
// payload, hub, stream, turnEnd, stop), under that source's rule; a
|
|
115
|
+
// source with a card rule replaces the open session's card too.
|
|
116
|
+
// @param streaming whether the open session's stream is live (the hub's rule)
|
|
117
|
+
// @param running whether a turn runs on the page
|
|
118
|
+
// @return whether the open session's card was replaced (the caller redraws the lists)
|
|
119
|
+
setStatus(value, source, { streaming = false, running = false } = {}) {
|
|
120
|
+
const { apply, card } = statusWrite(source, { streaming, running });
|
|
121
|
+
if (!apply) return false;
|
|
122
|
+
let carded = false;
|
|
123
|
+
store.batch(() => {
|
|
124
|
+
store.update({ current: { status: value } });
|
|
125
|
+
if (!card) return;
|
|
126
|
+
const i = sessions.findIndex((s) => s.id === selected);
|
|
127
|
+
if (i < 0) return;
|
|
128
|
+
const next = sessions.slice();
|
|
129
|
+
next[i] = card(sessions[i], value);
|
|
130
|
+
store.update({ sessions: next });
|
|
131
|
+
carded = true;
|
|
132
|
+
});
|
|
133
|
+
return carded;
|
|
134
|
+
},
|
|
135
|
+
|
|
136
|
+
// A new open session's fields (forgetSession only): always a new object,
|
|
137
|
+
// so a stale async writer still holding the old one writes into it alone.
|
|
138
|
+
replaceCurrent(state) {
|
|
139
|
+
current = { ...state };
|
|
140
|
+
enqueue(Object.keys(current).flatMap(fieldRedraws));
|
|
141
|
+
flush();
|
|
142
|
+
},
|
|
143
|
+
|
|
144
|
+
// Run +fn+ (synchronous) with its writes' redraws held to its end; nested
|
|
145
|
+
// batches join the outermost. The redraws run even when +fn+ throws (the
|
|
146
|
+
// page shows what was written), then its error is rethrown. An +fn+ that
|
|
147
|
+
// returns a promise is refused: its writes after an await would land
|
|
148
|
+
// outside the batch, so batch only an async function's synchronous parts.
|
|
149
|
+
batch(fn) {
|
|
150
|
+
depth += 1;
|
|
151
|
+
let result;
|
|
152
|
+
let failed = false;
|
|
153
|
+
let error;
|
|
154
|
+
try {
|
|
155
|
+
result = fn();
|
|
156
|
+
} catch (e) {
|
|
157
|
+
failed = true;
|
|
158
|
+
error = e;
|
|
159
|
+
} finally {
|
|
160
|
+
depth -= 1;
|
|
161
|
+
}
|
|
162
|
+
if (result && typeof result.then === "function") {
|
|
163
|
+
log.error("session store: batch() takes a synchronous function; batch an async one's synchronous parts");
|
|
164
|
+
}
|
|
165
|
+
if (failed) {
|
|
166
|
+
try {
|
|
167
|
+
flush();
|
|
168
|
+
} catch (e) {
|
|
169
|
+
log.error(e);
|
|
170
|
+
}
|
|
171
|
+
throw error;
|
|
172
|
+
}
|
|
173
|
+
flush();
|
|
174
|
+
return result;
|
|
175
|
+
},
|
|
176
|
+
|
|
177
|
+
// Something the store doesn't hold changed (the clock, versions, the
|
|
178
|
+
// stream): +name+'s redraw runs.
|
|
179
|
+
touch(name) {
|
|
180
|
+
enqueue([name]);
|
|
181
|
+
flush();
|
|
182
|
+
},
|
|
183
|
+
|
|
184
|
+
// Register +fn+ as (one of) the redraw(s) called +name+ (one of ORDER).
|
|
185
|
+
on(name, fn) {
|
|
186
|
+
if (!redraws.has(name)) throw new Error(`session store: no redraw called ${name}`);
|
|
187
|
+
redraws.get(name).push(fn);
|
|
188
|
+
},
|
|
189
|
+
};
|
|
190
|
+
return store;
|
|
191
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// The stage
|
|
1
|
+
// The stage's pure parts (stage_view.js): what the live slots show
|
|
2
2
|
// for a turn (turn_model.js's), when a finished turn hands off into the
|
|
3
3
|
// history, and in what order its pieces go there. No DOM, so `node --test`
|
|
4
4
|
// covers the rules; stage_view.js draws them.
|
|
@@ -128,7 +128,7 @@ export function miniToolText({ collapsed, tool }) {
|
|
|
128
128
|
}
|
|
129
129
|
|
|
130
130
|
// While the first step has no thinking and no tool rows the turn is plain:
|
|
131
|
-
// its text streams in the stage's answer slot, as the turn
|
|
131
|
+
// its text streams in the stage's answer slot, as the turn block's
|
|
132
132
|
// chrome-less block streams like a bubble.
|
|
133
133
|
export function isPlain(turn) {
|
|
134
134
|
if (!turn || turn.ended || turn.gens.length > 1) return false;
|
|
@@ -137,7 +137,7 @@ export function isPlain(turn) {
|
|
|
137
137
|
}
|
|
138
138
|
|
|
139
139
|
const END_PHASES = { completed: "answered", canceled: "canceled" };
|
|
140
|
-
// A completed turn whose model returned nothing (the turn
|
|
140
|
+
// A completed turn whose model returned nothing (the turn block's notice).
|
|
141
141
|
const NO_ANSWER = "no answer";
|
|
142
142
|
|
|
143
143
|
// What the live slots show for +turn+:
|
|
@@ -224,7 +224,7 @@ export function handOffDue({ ended, pending, inUse, quietSinceMs, nowMs }) {
|
|
|
224
224
|
return { due: nowMs - since >= QUIET_MS, quietSinceMs: since };
|
|
225
225
|
}
|
|
226
226
|
|
|
227
|
-
// A handed-off turn's nodes in the order the turn
|
|
227
|
+
// A handed-off turn's nodes in the order the turn block leaves them: the
|
|
228
228
|
// prompt bubble (none for a reminder turn), the block, its working set's
|
|
229
229
|
// footprint line (web.working_set), the extras in arrival order, the
|
|
230
230
|
// answer's pieces, the timing line, the end line, the kept cards, then the
|