@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.
- package/.env.example +6 -0
- package/CHANGELOG.md +39 -0
- package/README.md +5 -1
- package/bin/cli.cjs +50 -3
- package/bin/hooks/cos-cursor-observer.cjs +11 -4
- package/bin/hooks/cos-session-hook +46 -11
- package/docs/provider-parity.md +43 -0
- package/managed-runtime-contract.json +1 -0
- package/package.json +4 -2
- package/server/index.ts +141 -17
- package/server/lib/agent-session-binding-store.ts +9 -3
- package/server/lib/agent-session-store.ts +7 -4
- package/server/lib/attached-provider-adapter.ts +158 -45
- package/server/lib/banned-permission-args.ts +42 -1
- package/server/lib/claude-bridge.ts +17 -8
- package/server/lib/claude-hooks-installer.ts +22 -2
- package/server/lib/codex-bridge.ts +17 -2
- package/server/lib/codex-hooks-installer.ts +538 -0
- package/server/lib/codex-live-queue.ts +1 -1
- package/server/lib/codex-model-catalog.ts +49 -2
- package/server/lib/codex-rollout-state.ts +90 -0
- package/server/lib/codex-session-posture.ts +528 -0
- package/server/lib/continue-plan.ts +180 -0
- package/server/lib/continue-read-health.ts +26 -0
- package/server/lib/cursor-bridge.ts +26 -6
- package/server/lib/cursor-fork-context.ts +140 -0
- package/server/lib/cursor-model-catalog.ts +62 -5
- package/server/lib/cursor-observer-installer.ts +48 -7
- package/server/lib/cursor-session-model.ts +339 -0
- package/server/lib/cursor-spawn-env.ts +210 -0
- package/server/lib/fork-job-ledger.ts +194 -0
- package/server/lib/fork-thread.ts +169 -25
- package/server/lib/health-static-probes.ts +21 -11
- package/server/lib/lens-gist-engines.ts +15 -4
- package/server/lib/lens-gist.ts +1 -1
- package/server/lib/live-cues-cursor.ts +16 -6
- package/server/lib/occupancy-probes.ts +45 -1
- package/server/lib/permission-broker.ts +24 -9
- package/server/lib/provider-actions.ts +149 -0
- package/server/lib/provider-failure-text.ts +27 -0
- package/server/lib/provider-observe.ts +212 -0
- package/server/lib/provider-proof.ts +23 -14
- package/server/lib/query-job-runtime.ts +16 -1
- package/server/lib/query-job-types.ts +2 -1
- package/server/lib/session-act-fields.ts +61 -0
- package/server/lib/session-cancel.ts +95 -4
- package/server/lib/session-continue-facts-real.ts +74 -0
- package/server/lib/session-continue-facts.ts +267 -0
- package/server/lib/session-halt.ts +67 -6
- package/server/lib/session-hook-events.ts +57 -0
- package/server/lib/session-hook-ledger.ts +21 -3
- package/server/lib/session-hook-spool.ts +68 -6
- package/server/lib/session-hooks-runtime.ts +32 -2
- package/server/lib/session-peer-inbox-deps.ts +7 -6
- package/server/lib/session-recommendation.ts +3 -2
- package/server/lib/session-signal-store.ts +74 -5
- package/server/lib/session-stream-events.ts +32 -1
- package/server/lib/thread-attach-capability.ts +15 -1
- package/server/lib/thread-drain-kick.ts +4 -2
- package/server/lib/thread-occupancy.ts +44 -0
- package/server/lib/thread-turn-queue-deliver.ts +6 -1
- package/server/lib/thread-turn-queue.ts +6 -0
- package/server/lib/turn-request.ts +274 -0
- package/server/routes/agent-session-bindings.ts +349 -26
- package/server/routes/agent-session-stream.ts +26 -7
- package/server/routes/agent-sessions.ts +155 -10
- package/server/routes/health.ts +27 -2
- package/server/routes/session-hooks.ts +56 -5
- package/server/routes/thread-turn-queue.ts +37 -9
- 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
|
-
|
|
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({
|
|
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
|
-
|
|
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`)) ;
|
|
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
|
-
|
|
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
|
-
|
|
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: () =>
|
|
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
|
-
|
|
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`.
|
|
22
|
+
* `COS_CONTINUE_LIVE`. ON unless exactly '0' (6.62.0, D3).
|
|
23
23
|
*
|
|
24
|
-
*
|
|
25
|
-
* contract, and the first days
|
|
26
|
-
*
|
|
27
|
-
*
|
|
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
|
|
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
|
-
*
|
|
31
|
-
|
|
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
|
|