@gotcos/glasses-server 6.61.7 → 6.63.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.
Files changed (70) hide show
  1. package/.env.example +6 -0
  2. package/CHANGELOG.md +39 -0
  3. package/README.md +5 -1
  4. package/bin/cli.cjs +50 -3
  5. package/bin/hooks/cos-cursor-observer.cjs +11 -4
  6. package/bin/hooks/cos-session-hook +46 -11
  7. package/docs/provider-parity.md +43 -0
  8. package/managed-runtime-contract.json +1 -0
  9. package/package.json +4 -2
  10. package/server/index.ts +141 -17
  11. package/server/lib/agent-session-binding-store.ts +9 -3
  12. package/server/lib/agent-session-store.ts +7 -4
  13. package/server/lib/attached-provider-adapter.ts +158 -45
  14. package/server/lib/banned-permission-args.ts +42 -1
  15. package/server/lib/claude-bridge.ts +17 -8
  16. package/server/lib/claude-hooks-installer.ts +22 -2
  17. package/server/lib/codex-bridge.ts +17 -2
  18. package/server/lib/codex-hooks-installer.ts +538 -0
  19. package/server/lib/codex-live-queue.ts +1 -1
  20. package/server/lib/codex-model-catalog.ts +49 -2
  21. package/server/lib/codex-rollout-state.ts +90 -0
  22. package/server/lib/codex-session-posture.ts +528 -0
  23. package/server/lib/continue-plan.ts +180 -0
  24. package/server/lib/continue-read-health.ts +26 -0
  25. package/server/lib/cursor-bridge.ts +26 -6
  26. package/server/lib/cursor-fork-context.ts +140 -0
  27. package/server/lib/cursor-model-catalog.ts +62 -5
  28. package/server/lib/cursor-observer-installer.ts +48 -7
  29. package/server/lib/cursor-session-model.ts +339 -0
  30. package/server/lib/cursor-spawn-env.ts +210 -0
  31. package/server/lib/fork-job-ledger.ts +194 -0
  32. package/server/lib/fork-thread.ts +169 -25
  33. package/server/lib/health-static-probes.ts +21 -11
  34. package/server/lib/lens-gist-engines.ts +15 -4
  35. package/server/lib/lens-gist.ts +1 -1
  36. package/server/lib/live-cues-cursor.ts +16 -6
  37. package/server/lib/occupancy-probes.ts +45 -1
  38. package/server/lib/permission-broker.ts +24 -9
  39. package/server/lib/provider-actions.ts +149 -0
  40. package/server/lib/provider-failure-text.ts +27 -0
  41. package/server/lib/provider-observe.ts +212 -0
  42. package/server/lib/provider-proof.ts +23 -14
  43. package/server/lib/query-job-runtime.ts +16 -1
  44. package/server/lib/query-job-types.ts +2 -1
  45. package/server/lib/session-act-fields.ts +61 -0
  46. package/server/lib/session-cancel.ts +95 -4
  47. package/server/lib/session-continue-facts-real.ts +74 -0
  48. package/server/lib/session-continue-facts.ts +267 -0
  49. package/server/lib/session-halt.ts +67 -6
  50. package/server/lib/session-hook-events.ts +57 -0
  51. package/server/lib/session-hook-ledger.ts +21 -3
  52. package/server/lib/session-hook-spool.ts +68 -6
  53. package/server/lib/session-hooks-runtime.ts +32 -2
  54. package/server/lib/session-peer-inbox-deps.ts +7 -6
  55. package/server/lib/session-recommendation.ts +3 -2
  56. package/server/lib/session-signal-store.ts +74 -5
  57. package/server/lib/session-stream-events.ts +32 -1
  58. package/server/lib/thread-attach-capability.ts +15 -1
  59. package/server/lib/thread-drain-kick.ts +4 -2
  60. package/server/lib/thread-occupancy.ts +44 -0
  61. package/server/lib/thread-turn-queue-deliver.ts +6 -1
  62. package/server/lib/thread-turn-queue.ts +6 -0
  63. package/server/lib/turn-request.ts +274 -0
  64. package/server/routes/agent-session-bindings.ts +349 -26
  65. package/server/routes/agent-session-stream.ts +26 -7
  66. package/server/routes/agent-sessions.ts +155 -10
  67. package/server/routes/health.ts +27 -2
  68. package/server/routes/session-hooks.ts +56 -5
  69. package/server/routes/thread-turn-queue.ts +37 -9
  70. package/server/scripts/hooks-cli.ts +33 -7
@@ -100,6 +100,44 @@ export function clearHaltMarker(sessionId: string, dir = haltDir()): boolean {
100
100
  }
101
101
  }
102
102
 
103
+ /**
104
+ * 6.62.0 /qa (Q4): COS is about to start its OWN child on this thread (a Continue, a queue
105
+ * drain, or a fork). A marker left by an earlier desk cancel must not deny it: Cursor `-p`
106
+ * fires neither UserPromptSubmit nor SessionEnd, so until this a cancelled Cursor CLI chat
107
+ * refused every Continue for the marker's hour. The callers only reach here once the
108
+ * occupancy gate (Continue, drain) or an explicit probe (fork) says no desk run is working,
109
+ * so no live desk cancel is undone. True when a marker was removed.
110
+ */
111
+ export function clearHaltForCosChild(sessionId: string, why: 'continue' | 'fork', dir = haltDir()): boolean {
112
+ const cleared = clearHaltMarker(sessionId, dir)
113
+ if (cleared) console.log(`[session-halt] marker cleared: COS starts its own ${why} child session=${String(sessionId).slice(0, 8)}`)
114
+ return cleared
115
+ }
116
+
117
+ /**
118
+ * The same deps with `spawn` clearing the thread's marker first, at the moment the child is
119
+ * created (after every gate and ban check), and only when `mayClear` says no desk run is
120
+ * working. A throwing `mayClear` clears nothing.
121
+ */
122
+ export function clearingHaltOnSpawn<T extends { spawn: (request: never) => unknown }>(
123
+ deps: T,
124
+ sessionId: string,
125
+ why: 'continue' | 'fork',
126
+ mayClear: () => boolean = () => true,
127
+ dir = haltDir(),
128
+ ): T {
129
+ const spawn = deps.spawn as (request: unknown) => unknown
130
+ return {
131
+ ...deps,
132
+ spawn: ((request: unknown) => {
133
+ let clear = false
134
+ try { clear = mayClear() === true } catch { clear = false }
135
+ if (clear) clearHaltForCosChild(sessionId, why, dir)
136
+ return spawn(request)
137
+ }) as T['spawn'],
138
+ }
139
+ }
140
+
103
141
  /**
104
142
  * Clear the marker because the SESSION ended, but only a marker written at or before the
105
143
  * event. A SessionEnd drained late from the spool must not remove a cancel written after
@@ -149,6 +187,11 @@ export function clearHaltMarkerOnSessionEnd(sessionId: string, endedAt: number,
149
187
  // a halted desk run is the worse error, and the lens already said "at its next step".
150
188
  // - LIMIT, stated: a desk prompt with exactly the delivered words, typed after the send and
151
189
  // taken first, is indistinguishable from the delivered turn and re-arms.
190
+ //
191
+ // 6.62.0 (plan 3.6, W8): a Codex turn queued into the Codex app (`codex queue`, from the busy
192
+ // fast path or the idle hop) is re-armed too. Codex hands the queued text to its own
193
+ // UserPromptSubmit unchanged, with no peer wrapper, so that comparison is VERBATIM (only the
194
+ // ends trimmed): no wrapper is taken off and no inner whitespace is collapsed.
152
195
 
153
196
  interface PendingRearm {
154
197
  marker: HaltMarker
@@ -157,6 +200,10 @@ interface PendingRearm {
157
200
  /** Prompts submitted before this are someone else's. */
158
201
  after: number
159
202
  until: number
203
+ /** 6.62.0: a Codex queued turn, compared verbatim (no peer unwrap). */
204
+ verbatim: boolean
205
+ /** The delivered text as sent, for the verbatim comparison. */
206
+ text: string
160
207
  }
161
208
 
162
209
  const pendingRearms = new Map<string, PendingRearm>()
@@ -171,12 +218,21 @@ const MAX_PENDING_REARMS = 64
171
218
  export function haltDeliveredTurn(
172
219
  sessionId: string,
173
220
  marker: HaltMarker,
174
- turn: { prompt: string; after: number; rearm: boolean; now?: number; windowMs?: number },
221
+ turn: { prompt: string; after: number; rearm: boolean; now?: number; windowMs?: number; verbatim?: boolean; deferMarker?: boolean },
175
222
  dir = haltDir(),
176
223
  ): boolean {
177
- if (!writeHaltMarker(sessionId, marker, dir)) return false
178
- const id = sessionId.toLowerCase()
224
+ const id = typeof sessionId === 'string' ? sessionId.toLowerCase() : ''
179
225
  const words = normalizePromptWords(turn.prompt)
226
+ // 6.62.0 /qa (W3): `deferMarker` (a busy hop) writes NOTHING now: the session is still on
227
+ // the person's own turn, and a marker would stop it. Only the re-arm is registered, and it
228
+ // writes the marker when the delivered turn's own prompt arrives. A delivered turn that has
229
+ // already started (`rearm` false) is ours, so it is written at once as before.
230
+ const deferred = turn.deferMarker === true && turn.rearm && words.length > 0
231
+ if (deferred) {
232
+ if (haltMarkerPath(id, dir) === null) return false
233
+ } else if (!writeHaltMarker(sessionId, marker, dir)) {
234
+ return false
235
+ }
180
236
  if (!turn.rearm || words.length === 0) {
181
237
  pendingRearms.delete(id)
182
238
  return true
@@ -186,7 +242,7 @@ export function haltDeliveredTurn(
186
242
  ? Math.min(turn.windowMs, HALT_MARKER_TTL_MS)
187
243
  : HALT_MARKER_TTL_MS
188
244
  pendingRearms.delete(id)
189
- pendingRearms.set(id, { marker, words, after: turn.after, until: now + windowMs })
245
+ pendingRearms.set(id, { marker, words, after: turn.after, until: now + windowMs, verbatim: turn.verbatim === true, text: turn.prompt })
190
246
  while (pendingRearms.size > MAX_PENDING_REARMS) {
191
247
  const oldest = pendingRearms.keys().next()
192
248
  if (oldest.done) break
@@ -204,7 +260,12 @@ export function normalizePromptWords(text: unknown): string {
204
260
  * Is `prompt` (a UserPromptSubmit's `prompt`) the delivered prompt? Equal words, compared
205
261
  * whole, after taking off Claude Code's peer wrapper when the prompt arrived in one.
206
262
  */
207
- export function isDeliveredPrompt(prompt: unknown, delivered: string): boolean {
263
+ export function isDeliveredPrompt(prompt: unknown, delivered: string, options: { verbatim?: boolean } = {}): boolean {
264
+ if (options.verbatim === true) {
265
+ // 6.62.0: Codex's queued turn arrives as its own text. No wrapper to take off.
266
+ const want = typeof delivered === 'string' ? delivered.trim() : ''
267
+ return want.length > 0 && typeof prompt === 'string' && prompt.trim() === want
268
+ }
208
269
  const want = normalizePromptWords(delivered)
209
270
  if (want.length === 0 || typeof prompt !== 'string') return false
210
271
  return normalizePromptWords(unwrapPeerMessage(prompt) ?? prompt) === want
@@ -226,7 +287,7 @@ export function rearmHaltOnPrompt(sessionId: string, promptAt: number, prompt: u
226
287
  }
227
288
  if (!Number.isFinite(promptAt) || promptAt < pending.after) return false
228
289
  pendingRearms.delete(id)
229
- if (!isDeliveredPrompt(prompt, pending.words)) {
290
+ if (!(pending.verbatim ? isDeliveredPrompt(prompt, pending.text, { verbatim: true }) : isDeliveredPrompt(prompt, pending.words))) {
230
291
  console.warn(`[session-halt] re-arm dropped: the first prompt after the hand-off was not the delivered turn session=${id.slice(0, 8)} clientCancelId=${pending.marker.clientCancelId}`)
231
292
  return false
232
293
  }
@@ -33,10 +33,50 @@ export const HOOK_EVENT_NAMES = [
33
33
  'PreCompact',
34
34
  'PostCompact',
35
35
  'PostModelSwitch',
36
+ // 6.62.0: Codex fires this when a turn is interrupted (Esc). It closes the turn, as a Stop
37
+ // does. Never in Claude's subscription list: Claude Code has no such hook.
38
+ 'Interrupt',
39
+ // 6.62.0: the Cursor observer's `afterAgentThought`. Display only, like every observer
40
+ // event: its text lives in memory and on the live feed, never in the ledger.
41
+ 'AgentThought',
36
42
  ] as const
37
43
 
38
44
  export type HookEventName = typeof HOOK_EVENT_NAMES[number]
39
45
 
46
+ /**
47
+ * 6.62.0: events the reducer understands that no Claude Code hook fires. They stay OUT of
48
+ * Claude's `HOOK_SUBSCRIPTIONS` (a new Claude block would turn every install into `drift`):
49
+ * `Interrupt` is Codex's, and `AgentThought` is the Cursor observer's.
50
+ */
51
+ export const NON_CLAUDE_HOOK_EVENTS: readonly HookEventName[] = ['Interrupt', 'AgentThought']
52
+
53
+ /**
54
+ * 6.62.0: which engine ran the hook. The Codex command carries `COS_HOOK_PROVIDER=codex`,
55
+ * which the script writes into the envelope; Claude Code and Cursor share the
56
+ * `~/.claude/settings.json` command and are told apart by the payload (`inferHookProvider`).
57
+ */
58
+ export type HookProvider = 'claude' | 'codex' | 'cursor'
59
+
60
+ export function isHookProvider(value: unknown): value is HookProvider {
61
+ return value === 'claude' || value === 'codex' || value === 'cursor'
62
+ }
63
+
64
+ /**
65
+ * The provider of one envelope, in this order (plan 2.1): the envelope's own stamp (the Codex
66
+ * command and the Cursor observer write one); else Cursor's `cursor_version`, which every
67
+ * Cursor payload carries and no other engine's does; else a transcript under
68
+ * `/.codex/sessions/` (a COS Claude block Codex imported runs without the stamp); else Claude.
69
+ */
70
+ export function inferHookProvider(stamped: unknown, payload: Record<string, unknown>): HookProvider {
71
+ if (isHookProvider(stamped)) return stamped
72
+ if ('cursor_version' in payload) return 'cursor'
73
+ if (typeof payload.transcript_path === 'string' && payload.transcript_path.includes('/.codex/sessions/')) return 'codex'
74
+ return 'claude'
75
+ }
76
+
77
+ /** 6.62.0: the cap on an agent thought kept in memory and sent on the live feed. */
78
+ export const AGENT_THOUGHT_MAX = 280
79
+
40
80
  const EVENT_SET: ReadonlySet<string> = new Set(HOOK_EVENT_NAMES)
41
81
 
42
82
  export function isHookEventName(value: unknown): value is HookEventName {
@@ -57,6 +97,13 @@ export interface HookEnvelope {
57
97
  event: HookEventName
58
98
  sessionId: string
59
99
  payload: Record<string, unknown>
100
+ /** 6.62.0: set by `parseHookEnvelope` and a 6.62 ledger row; absent on older rows and hand-built envelopes. */
101
+ provider?: HookProvider
102
+ /**
103
+ * 6.62.0 (QA W2): the envelope itself named the provider: a 6.62 hook script (from the Codex
104
+ * command, or from a Codex payload) or the Cursor observer wrote it. Inferred is not stamped.
105
+ */
106
+ stamped?: true
60
107
  }
61
108
 
62
109
  /**
@@ -111,6 +158,8 @@ export function parseHookEnvelope(text: string): ParsedHookEnvelope {
111
158
  event: r.event,
112
159
  sessionId,
113
160
  payload: p,
161
+ provider: inferHookProvider(r.provider, p),
162
+ ...(isHookProvider(r.provider) ? { stamped: true as const } : {}),
114
163
  },
115
164
  }
116
165
  }
@@ -160,6 +209,9 @@ export function projectHookPayload(event: HookEventName, payload: Record<string,
160
209
  ...(str('cwd') ? { cwd: str('cwd') } : {}),
161
210
  ...(str('permission_mode') ? { permission_mode: str('permission_mode') } : {}),
162
211
  ...(str('prompt_id') ? { prompt_id: str('prompt_id') } : {}),
212
+ // 6.62.0: Codex stamps every turn-scoped event with its turn id and model.
213
+ ...(str('turn_id') ? { turn_id: str('turn_id') } : {}),
214
+ ...(event !== 'SessionStart' && str('model') ? { model: clipText(payload.model, 100) } : {}),
163
215
  }
164
216
  switch (event) {
165
217
  case 'SessionStart':
@@ -203,6 +255,11 @@ export function projectHookPayload(event: HookEventName, payload: Record<string,
203
255
  return { ...base, from_model: str('from_model'), to_model: str('to_model') }
204
256
  case 'PreCompact':
205
257
  case 'PostCompact':
258
+ case 'Interrupt':
259
+ return base
260
+ // The thought's TEXT is never kept: the ledger is a 10 MB ring replayed at boot, and a
261
+ // thought can quote anything the agent read. A replayed AgentThought carries nothing.
262
+ case 'AgentThought':
206
263
  return base
207
264
  }
208
265
  }
@@ -7,8 +7,8 @@
7
7
  // applying the same event twice.
8
8
 
9
9
  import { appendFileSync, existsSync, readFileSync, renameSync, statSync } from 'node:fs'
10
- import type { HookEnvelope, HookEventName } from './session-hook-events.js'
11
- import { projectHookPayload, isHookEventName, SESSION_ID_RE } from './session-hook-events.js'
10
+ import type { HookEnvelope, HookEventName, HookProvider } from './session-hook-events.js'
11
+ import { projectHookPayload, isHookEventName, isHookProvider, SESSION_ID_RE } from './session-hook-events.js'
12
12
 
13
13
  export const LEDGER_ROTATE_BYTES = 10 * 1024 * 1024
14
14
 
@@ -22,6 +22,14 @@ export interface LedgerRow {
22
22
  child?: boolean
23
23
  /** The registry's `entrypoint` for the session, once read (6.48.1); a replay restores it. */
24
24
  entrypoint?: string
25
+ /**
26
+ * 6.62.0: the engine, decided at ingest from the full payload (`inferHookProvider`). The
27
+ * projection drops `cursor_version`, so a replay could not tell a Cursor row again without
28
+ * it. A row from an older server has none and replays exactly as it did.
29
+ */
30
+ provider?: HookProvider
31
+ /** 6.62.0 (QA W2): the envelope carried the provider stamp; a replay keeps the evidence. */
32
+ stamped?: true
25
33
  payload: Record<string, unknown>
26
34
  }
27
35
 
@@ -67,6 +75,8 @@ export class SessionHookLedger {
67
75
  session_id: env.sessionId,
68
76
  ...(child ? { child: true } : {}),
69
77
  ...(entrypoint ? { entrypoint } : {}),
78
+ ...(env.provider ? { provider: env.provider } : {}),
79
+ ...(env.stamped ? { stamped: true as const } : {}),
70
80
  payload: projectHookPayload(env.event, env.payload),
71
81
  }
72
82
  } catch (error) {
@@ -119,7 +129,15 @@ export class SessionHookLedger {
119
129
  if (r.ts < sinceMs) continue
120
130
  const payload = r.payload && typeof r.payload === 'object' ? r.payload as Record<string, unknown> : {}
121
131
  const entrypoint = typeof r.entrypoint === 'string' && r.entrypoint ? r.entrypoint : null
122
- apply({ ts: r.ts, ppid: typeof r.ppid === 'number' ? r.ppid : null, event: r.event, sessionId: r.session_id.toLowerCase(), payload: { session_id: r.session_id, ...payload } }, r.key, r.child === true, entrypoint)
132
+ apply({
133
+ ts: r.ts,
134
+ ppid: typeof r.ppid === 'number' ? r.ppid : null,
135
+ event: r.event,
136
+ sessionId: r.session_id.toLowerCase(),
137
+ payload: { session_id: r.session_id, ...payload },
138
+ ...(isHookProvider(r.provider) ? { provider: r.provider } : {}),
139
+ ...(r.stamped === true && isHookProvider(r.provider) ? { stamped: true as const } : {}),
140
+ }, r.key, r.child === true, entrypoint)
123
141
  applied++
124
142
  }
125
143
  return { rows, applied, keys }
@@ -27,7 +27,13 @@ export const REJECTED_KEEP = 1_000
27
27
  export const REJECTED_MAX_AGE_MS = 7 * 24 * 60 * 60_000
28
28
  export const LAST_DRAIN_STAMP = '.last-drain'
29
29
 
30
- const SPOOL_FILE_RE = /^(\d{10,16})-(\d+)-([A-Za-z]+)\.json$/
30
+ /**
31
+ * `<ms>-<pid>-<Event>.json` from the hook script; 6.62.0: also `<ms>-<pid>-<12 hex>-<Event>.json`,
32
+ * the Cursor observer's name since it shipped (6.61.7). The nonce keeps two observer runs in one
33
+ * millisecond apart; until 6.62.0 every one of its files was moved aside as unrecognized.
34
+ * Ordering reads groups 1 and 2 only.
35
+ */
36
+ export const SPOOL_FILE_RE = /^(\d{10,16})-(\d+)(?:-[0-9a-f]{12})?-([A-Za-z]+)\.json$/
31
37
 
32
38
  /** A code, never a message: raw fs messages carry the home path and health is public. */
33
39
  export function errorCode(error: unknown): string {
@@ -38,6 +44,17 @@ export function errorCode(error: unknown): string {
38
44
 
39
45
  /** A hook killed mid-write leaves `.tmp.*`; reap those older than this. */
40
46
  export const TMP_MAX_AGE_MS = 10 * 60_000
47
+ /** 6.62.0: the observer's `.<name>` temp file, left by a run killed between write and rename. */
48
+ export const DOT_TEMP_MAX_AGE_MS = 60 * 60_000
49
+ /**
50
+ * 6.62.0: observer files 6.61.x moved aside as `.unrecognized` are put back ONCE, and only those
51
+ * from the last hour: older ones describe sub-agents and compactions long over (and canary
52
+ * throwaways), and age out with the rest of `rejected/` as before.
53
+ */
54
+ export const REINGEST_MAX_AGE_MS = 60 * 60_000
55
+ export const REINGEST_MARKER = '.reingested-6.62.0'
56
+ /** The window `rejected24h` counts over. */
57
+ export const REJECTED_WINDOW_MS = 24 * 60 * 60_000
41
58
  /** The startup drain never loops more times than a full spool needs. */
42
59
  export const STARTUP_MAX_PASSES = Math.ceil(2_000 / SPOOL_BATCH) + 1
43
60
 
@@ -63,7 +80,12 @@ export interface SpoolIngesterOptions {
63
80
 
64
81
  export interface SpoolStats {
65
82
  ingested: number
83
+ /** Since the process started (cumulative). */
66
84
  rejected: number
85
+ /** 6.62.0: in the last 24 hours, so a fixed cause reads as fixed without a restart. */
86
+ rejected24h: number
87
+ /** 6.62.0: rejected observer files put back into the spool at boot (once per Mac). */
88
+ reingested: number
67
89
  salvaged: number
68
90
  duplicates: number
69
91
  /** Files a sweep visited and could not remove (ledger refused, unreadable). */
@@ -90,7 +112,13 @@ export function startSpoolIngester(options: SpoolIngesterOptions): SpoolIngester
90
112
  const batch = options.batch ?? SPOOL_BATCH
91
113
  const seen = options.seenKeys ?? new Set<string>()
92
114
  const rejectedDir = join(dir, 'rejected')
93
- const stats: SpoolStats = { ingested: 0, rejected: 0, salvaged: 0, duplicates: 0, stuck: 0, foreign: 0, applyErrors: 0, backlog: 0, lastSweepAt: null, lastEventAt: null, lastError: null }
115
+ const stats: SpoolStats = { ingested: 0, rejected: 0, rejected24h: 0, reingested: 0, salvaged: 0, duplicates: 0, stuck: 0, foreign: 0, applyErrors: 0, backlog: 0, lastSweepAt: null, lastEventAt: null, lastError: null }
116
+ const rejectedAt: number[] = []
117
+ const countRejected = () => {
118
+ stats.rejected++
119
+ rejectedAt.push(now())
120
+ if (rejectedAt.length > 10_000) rejectedAt.splice(0, rejectedAt.length - 10_000)
121
+ }
94
122
  let ticking = false
95
123
  let stopped = false
96
124
  let watcher: FSWatcher | null = null
@@ -134,16 +162,22 @@ export function startSpoolIngester(options: SpoolIngesterOptions): SpoolIngester
134
162
  try { if (now() - statSync(join(dir, n)).mtimeMs > TMP_MAX_AGE_MS) unlinkSync(join(dir, n)) } catch { /* fine */ }
135
163
  continue
136
164
  }
165
+ // 6.62.0: the observer writes `.<spool name>` and renames it; one killed in between left
166
+ // it here for good. Only that exact shape, and only once it is an hour old.
167
+ if (n.startsWith('.') && SPOOL_FILE_RE.test(n.slice(1))) {
168
+ try { if (now() - statSync(join(dir, n)).mtimeMs > DOT_TEMP_MAX_AGE_MS) unlinkSync(join(dir, n)) } catch { /* fine */ }
169
+ continue
170
+ }
137
171
  if (n.startsWith('.')) continue
138
172
  if (!n.endsWith('.json')) { foreign++; continue }
139
- try { renameSync(join(dir, n), join(rejectedDir, `${n}.unrecognized`)) ; stats.rejected++ } catch { /* fine */ }
173
+ try { renameSync(join(dir, n), join(rejectedDir, `${n}.unrecognized`)) ; countRejected() } catch { /* fine */ }
140
174
  }
141
175
  stats.foreign = foreign
142
176
  return names.filter(n => SPOOL_FILE_RE.test(n)).sort(spoolOrder)
143
177
  }
144
178
 
145
179
  const reject = (name: string, reason: string) => {
146
- stats.rejected++
180
+ countRejected()
147
181
  try { renameSync(join(dir, name), join(rejectedDir, `${name}.${reason}`)) } catch {
148
182
  try { unlinkSync(join(dir, name)) } catch { /* gone already */ }
149
183
  }
@@ -203,7 +237,8 @@ export function startSpoolIngester(options: SpoolIngesterOptions): SpoolIngester
203
237
 
204
238
  const pruneRejected = () => {
205
239
  let names: string[]
206
- try { names = readdirSync(rejectedDir).sort() } catch { return }
240
+ // The re-ingest marker is not a rejected file: it is never pruned, so the re-ingest stays once.
241
+ try { names = readdirSync(rejectedDir).filter(n => n !== REINGEST_MARKER).sort() } catch { return }
207
242
  const cutoff = now() - REJECTED_MAX_AGE_MS
208
243
  const excess = Math.max(0, names.length - REJECTED_KEEP)
209
244
  names.forEach((n, index) => {
@@ -242,6 +277,29 @@ export function startSpoolIngester(options: SpoolIngesterOptions): SpoolIngester
242
277
  return removed
243
278
  }
244
279
 
280
+ // 6.62.0: put back the observer files 6.61.x could not read (see REINGEST_MAX_AGE_MS), once.
281
+ // Moved, never copied: the normal drain below ingests and deletes them like any other file.
282
+ const reingest = () => {
283
+ const marker = join(rejectedDir, REINGEST_MARKER)
284
+ if (existsSync(marker)) return
285
+ let names: string[] = []
286
+ try { names = readdirSync(rejectedDir) } catch { return }
287
+ const suffix = '.unrecognized'
288
+ for (const n of names) {
289
+ if (!n.endsWith(suffix)) continue
290
+ const original = n.slice(0, -suffix.length)
291
+ if (!SPOOL_FILE_RE.test(original)) continue
292
+ try {
293
+ if (now() - statSync(join(rejectedDir, n)).mtimeMs > REINGEST_MAX_AGE_MS) continue
294
+ if (existsSync(join(dir, original))) continue
295
+ renameSync(join(rejectedDir, n), join(dir, original))
296
+ stats.reingested++
297
+ } catch { /* left where it is; it ages out */ }
298
+ }
299
+ try { writeFileSync(marker, `${new Date(now()).toISOString()} ${stats.reingested}\n`, { mode: 0o600 }) } catch { /* the next boot tries once more */ }
300
+ }
301
+ reingest()
302
+
245
303
  // Startup drain: the backlog, in bounded passes, before anyone asks. Bounded twice: a pass
246
304
  // that removed nothing ends it (a refusing ledger must never spin the boot), and no
247
305
  // backlog needs more passes than a full spool.
@@ -267,6 +325,10 @@ export function startSpoolIngester(options: SpoolIngesterOptions): SpoolIngester
267
325
  clearInterval(timer)
268
326
  try { watcher?.close() } catch { /* fine */ }
269
327
  },
270
- stats: () => ({ ...stats }),
328
+ stats: () => {
329
+ const since = now() - REJECTED_WINDOW_MS
330
+ while (rejectedAt.length > 0 && rejectedAt[0]! < since) rejectedAt.shift()
331
+ return { ...stats, rejected24h: rejectedAt.length }
332
+ },
271
333
  }
272
334
  }
@@ -20,6 +20,7 @@ import { OPEN_TURN_CEILING_MS, deriveSessionState, type DerivedSessionState, typ
20
20
  import { HALT_MARKER_TTL_MS, HALT_REARM_UNVERIFIED_MS, clearHaltMarkerOnSessionEnd, dropHaltRearm, haltDeliveredTurn, rearmHaltOnPrompt, sweepHaltMarkers, type HaltMarker } from './session-halt.js'
21
21
  import { cancelVoidsOpenTurn, threadCancel } from './session-cancel.js'
22
22
  import { ensureHookRuntimeFiles, ensureStableHookScript, hookSpoolDir, hookStatus, type HookStatus } from './claude-hooks-installer.js'
23
+ import { codexHooksHealthField, cursorObserverHealthField, type CodexHooksHealth, type CursorObserverHealth } from './provider-observe.js'
23
24
 
24
25
  export function sessionHooksEnabled(): boolean {
25
26
  const raw = process.env.COS_SESSION_HOOKS
@@ -235,7 +236,7 @@ export function claudeDeskRunning(sessionId: string, now = Date.now(), dir = cla
235
236
  * hooks do not yet show the turn started (its UserPromptSubmit at or after `sentAt`), it is
236
237
  * re-armed once when that prompt's own UserPromptSubmit deletes it (`haltDeliveredTurn`).
237
238
  */
238
- export function haltHandedOffTurn(sessionId: string, marker: HaltMarker, turn: { prompt: string; sentAt: number; unverified?: boolean }, now = Date.now()): boolean {
239
+ export function haltHandedOffTurn(sessionId: string, marker: HaltMarker, turn: { prompt: string; sentAt: number; unverified?: boolean; verbatim?: boolean; deferMarker?: boolean }, now = Date.now()): boolean {
239
240
  const signal = signalFor(sessionId)
240
241
  const started = !!signal && typeof signal.turnStartedAt === 'number' && signal.turnStartedAt >= turn.sentAt
241
242
  return haltDeliveredTurn(sessionId, marker, {
@@ -245,6 +246,10 @@ export function haltHandedOffTurn(sessionId: string, marker: HaltMarker, turn: {
245
246
  now,
246
247
  // 6.53.3 /qa: an unverified hand-off (`maybe`) holds its re-arm two minutes, not an hour.
247
248
  windowMs: turn.unverified === true ? HALT_REARM_UNVERIFIED_MS : HALT_MARKER_TTL_MS,
249
+ // 6.62.0 (plan 3.6): a Codex turn queued into the app is matched verbatim.
250
+ verbatim: turn.verbatim === true,
251
+ // 6.62.0 /qa (W3): a busy hop's marker waits for the delivered turn's own prompt.
252
+ deferMarker: turn.deferMarker === true,
248
253
  })
249
254
  }
250
255
 
@@ -277,7 +282,8 @@ export function startSessionHooksRuntime(options: { port: number }): SessionHook
277
282
  ledger,
278
283
  seenKeys: replay.keys,
279
284
  isChild: env => isCosSpawnedPid(env.ppid),
280
- entrypointOf: enabled ? (env, child) => entrypointFor(env.sessionId, child) : undefined,
285
+ // 6.62.0: only a Claude session has a `~/.claude/sessions` record to read.
286
+ entrypointOf: enabled ? (env, child) => (env.provider === undefined || env.provider === 'claude' ? entrypointFor(env.sessionId, child) : null) : undefined,
281
287
  apply: enabled ? (env, child, entrypoint) => {
282
288
  sessionSignalStore.apply(env, child)
283
289
  if (entrypoint) sessionSignalStore.setEntrypoint(env.sessionId, entrypoint)
@@ -354,6 +360,14 @@ export interface SessionHooksHealth {
354
360
  signals: number
355
361
  replayed: { rows: number; applied: number } | null
356
362
  spool: SpoolStats | null
363
+ /**
364
+ * 6.62.0: the Codex hooks, APART from the Claude fields above (B2): `state`, `installed` and
365
+ * `hookHaltReady` stay Claude's alone, because Control 0.5.254 keys its banner and its
366
+ * Install check off them. No Codex banner this release.
367
+ */
368
+ codex: CodexHooksHealth
369
+ /** 6.62.0: the native Cursor observer (`~/.cursor/hooks.json`). */
370
+ cursorObserver: CursorObserverHealth
357
371
  }
358
372
 
359
373
  // Health is polled by three clients every few seconds; the status read (settings parse,
@@ -397,6 +411,8 @@ export function sessionHooksHealthFields(): { sessionHooks: SessionHooksHealth }
397
411
  signals: sessionSignalStore.size(),
398
412
  replayed,
399
413
  spool,
414
+ codex: codexHooksHealthField(),
415
+ cursorObserver: cursorObserverHealthField(),
400
416
  },
401
417
  }
402
418
  }
@@ -408,6 +424,20 @@ export function signalFor(sessionId: string): SessionSignal | undefined {
408
424
  return signal?.observationOnly ? undefined : signal
409
425
  }
410
426
 
427
+ /**
428
+ * 6.62.0 (QA W2): has a hook event of this engine reached COS for this thread? The positive
429
+ * evidence a desk cancel needs before it may be offered for Codex or Cursor. Never an observer
430
+ * event (those prove the observer runs, not the halt check):
431
+ * codex an event the Codex command's script STAMPED (a 6.62 script, whose halt reply Codex
432
+ * honours; an inferred-only Codex event came from an older script that fails open)
433
+ * cursor an event from the Claude-compatible hook Cursor runs (its own `cursor_version`)
434
+ */
435
+ export function providerHookSeen(provider: 'codex' | 'cursor', threadId: string): boolean {
436
+ const signal = signalFor(threadId)
437
+ if (!signal || signal.provider !== provider) return false
438
+ return provider === 'codex' ? typeof signal.stampedAt === 'number' : true
439
+ }
440
+
411
441
  /** Display observers do not create hook occupancy or permission evidence. */
412
442
  export function workObservationFor(sessionId: string) {
413
443
  if (!sessionHooksEnabled()) return undefined
@@ -19,12 +19,13 @@ import {
19
19
  } from './session-peer-inbox.js'
20
20
 
21
21
  /**
22
- * `COS_CONTINUE_LIVE`. OFF by default in 6.49.0.
22
+ * `COS_CONTINUE_LIVE`. ON unless exactly '0' (6.62.0, D3).
23
23
  *
24
- * The transport rides a protocol Claude Code documents in a help string, not a
25
- * contract, and the first days are for reading the health row on one Mac. A literal
26
- * '1' turns it on; anything else, including absence, keeps every Continue on the
27
- * 6.48.2 path.
24
+ * 6.49.0 shipped it off: the transport rides a protocol Claude Code documents in a help
25
+ * string, not a contract, and the first days were for reading the health row on one Mac.
26
+ * Those days are behind it (Miles's Mac has run it on since 6.49; measured on Claude Code
27
+ * 2.1.289), and a Continue that lands in the open session is the desk behaviour. '0' keeps
28
+ * every Continue on the 6.48.2 spawn path; every refusal still falls back there anyway.
28
29
  *
29
30
  * WHERE TO SET IT. `~/.cos-glasses/.env` (read at boot by `env.ts`, the plist wins
30
31
  * when both carry it). Control's `providerEnvironmentKeys` allowlist does NOT carry
@@ -32,7 +33,7 @@ import {
32
33
  * by the next Install/Repair/Update Server; Control 0.5.234 is to add it.
33
34
  */
34
35
  export function continueLiveEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
35
- return env.COS_CONTINUE_LIVE === '1'
36
+ return env.COS_CONTINUE_LIVE !== '0'
36
37
  }
37
38
 
38
39
  /** Registry files are small; anything larger is not one. */
@@ -27,8 +27,9 @@ const EXACT = "Which one of the user's agent sessions is already doing this exac
27
27
  + 'A session on the same project doing different work does not count. Choose none if no session is doing this task.'
28
28
 
29
29
  /** Providers a Work handoff can fork natively (Control 0.5.243 applies a Fork suggestion as a same-platform fork).
30
- * One list with the fork route (agent-session-binding-store FORKABLE_PROVIDERS). */
31
- export const FORKABLE = new Set<string>(FORKABLE_PROVIDERS)
30
+ * 6.62.0 (W9): the fork route also serves Cursor ("New session with this context"), but Control 0.5.254 has no
31
+ * Cursor fork plan, so the recommender keeps to Claude and Codex until the Control release. */
32
+ export const FORKABLE = new Set<string>(FORKABLE_PROVIDERS.filter(provider => provider !== 'cursor'))
32
33
  const clip = (text: string | undefined, max: number) => (text ?? '').replace(/\s+/g, ' ').trim().slice(0, max)
33
34
  const round = (n: number) => Math.round(n * 100) / 100
34
35