@gotcos/glasses-server 6.99.33 → 7.0.18

package/.env.example

@@ -209,6 +209,25 @@ BIND_HOST=0.0.0.0
 # Per-hook rollback without reinstall: echo 0 > ~/.cos-glasses/hook-ask-hold
 # COS_PERMISSION_BROKER_DESK_IDLE_S=90     # never below 30
 # COS_PERMISSION_BROKER_TIMEOUT_S=110      # clamped to 5..120 (under the hook's 125 s)
+# 7.0.16: a waiting session question's first 80 characters show on Today and the session rows
+# (glasses, phone, COS Control, Control Web). Question text only, never options or answers. It is
+# also written to the session-hook ledger on disk. Default ON; 0 restores 7.0.13's empty line.
+# COS_WAITING_QUESTION_WORDS=0
+# 7.0.16, both OFF by default: hold a session question (QUESTION) or a tool approval (APPROVAL) for
+# the whole hook wait, about an hour, so the glasses, the phone or Control Web can answer it even if
+# none was connected when it was asked. Only on engines proven to keep their own dialog up meanwhile
+# (Claude Code CLI 2.1.321+ in a terminal, Claude Desktop 2.1.317+); the Mac's dialog still shows at
+# once and the first answer wins. To turn on: set it here, restart the server, then COS Control >
+# Settings > Reinstall hooks. To turn off: remove it and restart (every held item goes back to the Mac).
+# Keep APPROVAL off for now: a signed-in Control Web browser could allow a tool for about an hour.
+# COS_QUESTION_FULL_HOLD=1
+# COS_APPROVAL_FULL_HOLD=1
+# 7.0.18, default ON (named by Miles 11/10): a Claude desktop session that ends its turn with a
+# question and reply buttons shows as waiting on the glasses, phone, Control Web and COS Control once
+# the desk has been idle 90 s. Only an ask with reply buttons (or marked blocked); gone on any reply,
+# a new turn, the session ending, or after 8 hours. Never print runs, COS-started runs or sub-agents.
+# Words follow COS_WAITING_QUESTION_WORDS. 0 turns it off (restart the server); nothing to reinstall.
+# COS_TURN_END_ASKS=0
 
 # ── THE LLM (chat) ──────────────────────────────────────────────────────
 # Chat runs through your LOCAL agent CLI — NOT an API key:
@@ -514,6 +533,7 @@ COS_CONTINUE_FULL_PERMISSIONS=1
 # COS_PIN_BOOT_REAP=1     # free a thread a crashed run held, 31 min after the restart and once its child is gone (default on; 0 = the 24 h reap)
 # COS_QUEUE_RESEND=1      # Send again on a refused or expired queued turn (default on)
 # COS_SESSION_STEER=0     # steer a busy Claude session through its peer inbox (default off)
+# COS_STEER_MIDTURN=1     # a message parked at a busy Claude desk session lands at its next tool step through the peer inbox (default on; 0 = waits for the turn to end)
 
 
 # ── Answer with your own key (6.80.0, opt in) ──────────────────────────────────
@@ -523,3 +543,20 @@ COS_CONTINUE_FULL_PERMISSIONS=1
 # in data/key-secrets/ (0700). Your key is saved on this Mac: apps and agents that run on this
 # Mac as you can read it, so your provider's own spending limit is the real stop.
 # COS_KEY_LANES=0
+
+
+# ── Files and images sessions make, on the web (6.99.35) ───────────────────────
+# Control Web shows images and files a session saved in its project folder (Markdown images,
+# and files a Claude session sent with SendUserFile). On by default; the switch is
+# "Show files and images your sessions make" in Control Web Settings, Privacy (saved in
+# data/web-session-files-settings.json). 0 / false / off forces it off and wins over Settings;
+# no value forces it on.
+# COS_WEB_SESSION_FILES=0
+
+
+# ── Live state for Control Web (7.0.1) ──────────────────────────────────────────
+# GET /api/events: one change feed per open Control Web page, so the pet, session rows, Today's
+# counts and running clocks follow what is running now (docs/live-events-contract.md). Ids,
+# states, counts and times only, never titles, words, file names or paths. On by default; read
+# at start. 0 / false / off registers no route, and the page polls exactly as before.
+# COS_WEB_LIVE_EVENTS=0