instar 1.3.856 → 1.3.858
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/.claude/skills/autonomous/hooks/autonomous-stop-hook.sh +32 -6
- package/dist/cli.js +72 -0
- package/dist/cli.js.map +1 -1
- package/dist/core/CodexTaskContinuationStore.d.ts +75 -0
- package/dist/core/CodexTaskContinuationStore.d.ts.map +1 -0
- package/dist/core/CodexTaskContinuationStore.js +369 -0
- package/dist/core/CodexTaskContinuationStore.js.map +1 -0
- package/dist/core/IdentityRenderer.d.ts.map +1 -1
- package/dist/core/IdentityRenderer.js +13 -1
- package/dist/core/IdentityRenderer.js.map +1 -1
- package/dist/core/PlaywrightSeatLease.d.ts +16 -0
- package/dist/core/PlaywrightSeatLease.d.ts.map +1 -1
- package/dist/core/PlaywrightSeatLease.js +24 -0
- package/dist/core/PlaywrightSeatLease.js.map +1 -1
- package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
- package/dist/core/PostUpdateMigrator.js +4 -1
- package/dist/core/PostUpdateMigrator.js.map +1 -1
- package/dist/core/WriteDomainRegistry.d.ts.map +1 -1
- package/dist/core/WriteDomainRegistry.js +23 -0
- package/dist/core/WriteDomainRegistry.js.map +1 -1
- package/dist/core/types.d.ts +11 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js.map +1 -1
- package/dist/server/CapabilityIndex.d.ts.map +1 -1
- package/dist/server/CapabilityIndex.js +16 -0
- package/dist/server/CapabilityIndex.js.map +1 -1
- package/dist/server/routes.d.ts.map +1 -1
- package/dist/server/routes.js +99 -0
- package/dist/server/routes.js.map +1 -1
- package/package.json +1 -1
- package/src/data/builtin-manifest.json +95 -95
- package/src/data/state-coherence-registry.json +19 -0
- package/upgrades/1.3.857.md +27 -0
- package/upgrades/1.3.858.md +23 -0
- package/upgrades/eli16/playwright-standalone-seat-lease.eli16.md +7 -0
- package/upgrades/side-effects/codex-task-continuation.md +64 -0
- package/upgrades/side-effects/playwright-standalone-seat-lease.md +66 -0
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
export interface CodexTaskContinuationConfig {
|
|
2
|
+
enabled?: boolean;
|
|
3
|
+
maxDurationSeconds?: number;
|
|
4
|
+
maxContinuations?: number;
|
|
5
|
+
auditRetentionDays?: number;
|
|
6
|
+
auditMaxRows?: number;
|
|
7
|
+
}
|
|
8
|
+
export interface ContinuationLedger {
|
|
9
|
+
version: 1;
|
|
10
|
+
active: boolean;
|
|
11
|
+
topicId: string;
|
|
12
|
+
sessionId: string;
|
|
13
|
+
generation: number;
|
|
14
|
+
generationId: string;
|
|
15
|
+
startedAt: string;
|
|
16
|
+
durationSeconds: number;
|
|
17
|
+
continuationCount: number;
|
|
18
|
+
maxContinuations: number;
|
|
19
|
+
updatedAt: string;
|
|
20
|
+
bodyDigest: string;
|
|
21
|
+
body: string;
|
|
22
|
+
}
|
|
23
|
+
export type ContinuationReason = 'disabled' | 'operator-stop' | 'no-ledger' | 'ownership-mismatch' | 'invalid-state' | 'duration-expired' | 'continuation-ceiling' | 'no-task-structure' | 'all-tasks-complete' | 'open-tasks' | 'audit-failed' | 'lock-unavailable';
|
|
24
|
+
export interface ContinuationDecision {
|
|
25
|
+
decision: 'continue' | 'allow' | 'deactivate';
|
|
26
|
+
reason: ContinuationReason;
|
|
27
|
+
openTaskCount: number | null;
|
|
28
|
+
continuationCount: number | null;
|
|
29
|
+
reasonText?: string;
|
|
30
|
+
}
|
|
31
|
+
export declare function normalizeTaskBody(body: string): string;
|
|
32
|
+
/** Exact v1 authority grammar from the approved spec. */
|
|
33
|
+
export declare function parseContinuationTasks(body: string): Array<{
|
|
34
|
+
open: boolean;
|
|
35
|
+
line: number;
|
|
36
|
+
}>;
|
|
37
|
+
export declare class CodexTaskContinuationStore {
|
|
38
|
+
private readonly cfg;
|
|
39
|
+
private readonly root;
|
|
40
|
+
constructor(stateDir: string, config?: CodexTaskContinuationConfig);
|
|
41
|
+
get enabled(): boolean;
|
|
42
|
+
start(input: {
|
|
43
|
+
topicId: string;
|
|
44
|
+
sessionId?: string;
|
|
45
|
+
tasks: string[];
|
|
46
|
+
durationSeconds?: number;
|
|
47
|
+
maxContinuations?: number;
|
|
48
|
+
}): ContinuationLedger;
|
|
49
|
+
read(topicId: string): ContinuationLedger | null;
|
|
50
|
+
complete(topicId: string, ordinal: number): ContinuationLedger;
|
|
51
|
+
stop(topicId: string): boolean;
|
|
52
|
+
stopAll(): number;
|
|
53
|
+
decide(topicId: string, sessionId: string): ContinuationDecision;
|
|
54
|
+
list(): ContinuationLedger[];
|
|
55
|
+
private deactivate;
|
|
56
|
+
private recordAllow;
|
|
57
|
+
private requireValid;
|
|
58
|
+
/** Enumeration consumers drive global generation/capacity decisions, so a
|
|
59
|
+
* discovered file must never be silently omitted on read, parse, or schema
|
|
60
|
+
* failure. Direct point reads remain tolerant for fail-open Stop decisions. */
|
|
61
|
+
private readStrict;
|
|
62
|
+
private isStructurallyValid;
|
|
63
|
+
private audit;
|
|
64
|
+
private pruneAudit;
|
|
65
|
+
private pruneInactiveLedgers;
|
|
66
|
+
private withLock;
|
|
67
|
+
private withNamedLock;
|
|
68
|
+
private write;
|
|
69
|
+
private ledgerPath;
|
|
70
|
+
private tombstonePath;
|
|
71
|
+
private readTombstone;
|
|
72
|
+
private readGlobalTombstone;
|
|
73
|
+
private readGeneration;
|
|
74
|
+
}
|
|
75
|
+
//# sourceMappingURL=CodexTaskContinuationStore.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CodexTaskContinuationStore.d.ts","sourceRoot":"","sources":["../../src/core/CodexTaskContinuationStore.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,369 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { createHash, randomUUID } from 'node:crypto';
|
|
4
|
+
import { SafeFsExecutor } from './SafeFsExecutor.js';
|
|
5
|
+
const FIRST_STOP_BIND = '__bind_on_first_stop__';
|
|
6
|
+
const DEFAULTS = {
|
|
7
|
+
enabled: false,
|
|
8
|
+
maxDurationSeconds: 14_400,
|
|
9
|
+
maxContinuations: 40,
|
|
10
|
+
auditRetentionDays: 14,
|
|
11
|
+
auditMaxRows: 5_000,
|
|
12
|
+
};
|
|
13
|
+
const MAX_BODY_BYTES = 64 * 1024;
|
|
14
|
+
const MAX_LEDGER_FILES = 1_000;
|
|
15
|
+
function atomicWrite(file, content) {
|
|
16
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
17
|
+
const tmp = `${file}.${process.pid}.${randomUUID()}.tmp`;
|
|
18
|
+
fs.writeFileSync(tmp, content, { mode: 0o600 });
|
|
19
|
+
fs.renameSync(tmp, file);
|
|
20
|
+
}
|
|
21
|
+
function digest(body) {
|
|
22
|
+
return createHash('sha256').update(body).digest('hex');
|
|
23
|
+
}
|
|
24
|
+
export function normalizeTaskBody(body) {
|
|
25
|
+
return body.replace(/\r\n?/g, '\n');
|
|
26
|
+
}
|
|
27
|
+
/** Exact v1 authority grammar from the approved spec. */
|
|
28
|
+
export function parseContinuationTasks(body) {
|
|
29
|
+
const normalized = normalizeTaskBody(body);
|
|
30
|
+
if (Buffer.byteLength(normalized, 'utf8') > MAX_BODY_BYTES)
|
|
31
|
+
return [];
|
|
32
|
+
const tasks = [];
|
|
33
|
+
let fenced = false;
|
|
34
|
+
let inComment = false;
|
|
35
|
+
normalized.split('\n').forEach((line, index) => {
|
|
36
|
+
if (/^[ ]{0,3}(```|~~~)/.test(line)) {
|
|
37
|
+
fenced = !fenced;
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
if (fenced)
|
|
41
|
+
return;
|
|
42
|
+
let visible = line;
|
|
43
|
+
if (inComment) {
|
|
44
|
+
const end = visible.indexOf('-->');
|
|
45
|
+
if (end < 0)
|
|
46
|
+
return;
|
|
47
|
+
visible = visible.slice(end + 3);
|
|
48
|
+
inComment = false;
|
|
49
|
+
}
|
|
50
|
+
const comment = visible.indexOf('<!--');
|
|
51
|
+
if (comment >= 0) {
|
|
52
|
+
const end = visible.indexOf('-->', comment + 4);
|
|
53
|
+
if (end < 0)
|
|
54
|
+
inComment = true;
|
|
55
|
+
visible = visible.slice(0, comment);
|
|
56
|
+
}
|
|
57
|
+
if (/^[ ]{0,3}>/.test(visible))
|
|
58
|
+
return;
|
|
59
|
+
const match = visible.match(/^[ ]{0,3}- \[([ xX])\] \S/);
|
|
60
|
+
if (match)
|
|
61
|
+
tasks.push({ open: match[1] === ' ', line: index });
|
|
62
|
+
});
|
|
63
|
+
return tasks;
|
|
64
|
+
}
|
|
65
|
+
export class CodexTaskContinuationStore {
|
|
66
|
+
cfg;
|
|
67
|
+
root;
|
|
68
|
+
constructor(stateDir, config = {}) {
|
|
69
|
+
this.root = path.join(stateDir, 'continuation');
|
|
70
|
+
this.cfg = { ...DEFAULTS, ...config };
|
|
71
|
+
}
|
|
72
|
+
get enabled() { return this.cfg.enabled; }
|
|
73
|
+
start(input) {
|
|
74
|
+
if (!this.cfg.enabled)
|
|
75
|
+
throw new Error('continuation-disabled');
|
|
76
|
+
if (!/^\d+$/.test(input.topicId))
|
|
77
|
+
throw new Error('invalid-owner');
|
|
78
|
+
return this.withNamedLock('maintenance', () => {
|
|
79
|
+
this.pruneInactiveLedgers();
|
|
80
|
+
return this.withLock(input.topicId, () => {
|
|
81
|
+
if (!this.read(input.topicId) && this.list().length >= MAX_LEDGER_FILES)
|
|
82
|
+
throw new Error('continuation-capacity');
|
|
83
|
+
const taskLines = input.tasks.map((t) => `- [ ] ${String(t).replace(/[\r\n]+/g, ' ').trim()}`).filter((t) => t.length > 6);
|
|
84
|
+
if (taskLines.length === 0)
|
|
85
|
+
throw new Error('empty-task-list');
|
|
86
|
+
const body = normalizeTaskBody(`${taskLines.join('\n')}\n`);
|
|
87
|
+
if (Buffer.byteLength(body, 'utf8') > MAX_BODY_BYTES)
|
|
88
|
+
throw new Error('task-list-too-large');
|
|
89
|
+
const prior = this.read(input.topicId);
|
|
90
|
+
const tombstone = this.readTombstone(input.topicId);
|
|
91
|
+
const generationBase = Math.max(prior?.generation ?? 0, tombstone, this.readGlobalTombstone());
|
|
92
|
+
if (!Number.isSafeInteger(generationBase) || generationBase >= Number.MAX_SAFE_INTEGER)
|
|
93
|
+
throw new Error('operator-stop');
|
|
94
|
+
const generation = generationBase + 1;
|
|
95
|
+
const now = new Date().toISOString();
|
|
96
|
+
const ledger = {
|
|
97
|
+
version: 1, active: true, topicId: input.topicId,
|
|
98
|
+
sessionId: input.sessionId?.trim() || FIRST_STOP_BIND,
|
|
99
|
+
generation, generationId: randomUUID(), startedAt: now,
|
|
100
|
+
durationSeconds: Math.max(1, Math.min(input.durationSeconds ?? this.cfg.maxDurationSeconds, this.cfg.maxDurationSeconds)),
|
|
101
|
+
continuationCount: 0,
|
|
102
|
+
maxContinuations: Math.max(1, Math.min(input.maxContinuations ?? this.cfg.maxContinuations, this.cfg.maxContinuations)),
|
|
103
|
+
updatedAt: now, bodyDigest: digest(body), body,
|
|
104
|
+
};
|
|
105
|
+
this.write(ledger);
|
|
106
|
+
try {
|
|
107
|
+
this.audit(ledger, 'allow', 'open-tasks', parseContinuationTasks(body).length, 0);
|
|
108
|
+
}
|
|
109
|
+
catch (err) {
|
|
110
|
+
ledger.active = false;
|
|
111
|
+
this.write(ledger);
|
|
112
|
+
throw err;
|
|
113
|
+
}
|
|
114
|
+
return ledger;
|
|
115
|
+
});
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
read(topicId) {
|
|
119
|
+
try {
|
|
120
|
+
const parsed = JSON.parse(fs.readFileSync(this.ledgerPath(topicId), 'utf8'));
|
|
121
|
+
return parsed;
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
return null;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
complete(topicId, ordinal) {
|
|
128
|
+
return this.withLock(topicId, () => {
|
|
129
|
+
const ledger = this.requireValid(topicId);
|
|
130
|
+
if (!ledger.active || this.readTombstone(topicId) > ledger.generation || this.readGlobalTombstone() > ledger.generation) {
|
|
131
|
+
throw new Error('operator-stop');
|
|
132
|
+
}
|
|
133
|
+
const tasks = parseContinuationTasks(ledger.body);
|
|
134
|
+
const task = tasks[ordinal - 1];
|
|
135
|
+
if (!task)
|
|
136
|
+
throw new Error('task-not-found');
|
|
137
|
+
const lines = ledger.body.split('\n');
|
|
138
|
+
lines[task.line] = lines[task.line].replace('- [ ] ', '- [x] ');
|
|
139
|
+
ledger.body = normalizeTaskBody(lines.join('\n'));
|
|
140
|
+
ledger.bodyDigest = digest(ledger.body);
|
|
141
|
+
ledger.updatedAt = new Date().toISOString();
|
|
142
|
+
this.write(ledger);
|
|
143
|
+
return ledger;
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
stop(topicId) {
|
|
147
|
+
return this.withLock(topicId, () => {
|
|
148
|
+
const ledger = this.read(topicId);
|
|
149
|
+
const generation = Math.max(ledger?.generation ?? 0, this.readTombstone(topicId)) + 1;
|
|
150
|
+
atomicWrite(this.tombstonePath(topicId), `${generation}\n`);
|
|
151
|
+
if (ledger) {
|
|
152
|
+
ledger.active = false;
|
|
153
|
+
ledger.updatedAt = new Date().toISOString();
|
|
154
|
+
this.write(ledger);
|
|
155
|
+
this.audit(ledger, 'deactivate', 'operator-stop', null, ledger.continuationCount);
|
|
156
|
+
}
|
|
157
|
+
return !!ledger;
|
|
158
|
+
});
|
|
159
|
+
}
|
|
160
|
+
stopAll() {
|
|
161
|
+
return this.withNamedLock('maintenance', () => {
|
|
162
|
+
const ledgers = this.list();
|
|
163
|
+
const next = Math.max(this.readGlobalTombstone(), ...ledgers.map((l) => l.generation), 0) + 1;
|
|
164
|
+
atomicWrite(path.join(this.root, 'operator-stop-all.local'), `${next}\n`);
|
|
165
|
+
let stopped = 0;
|
|
166
|
+
for (const ledger of ledgers)
|
|
167
|
+
if (this.stop(ledger.topicId))
|
|
168
|
+
stopped++;
|
|
169
|
+
return stopped;
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
decide(topicId, sessionId) {
|
|
173
|
+
if (!this.cfg.enabled)
|
|
174
|
+
return this.recordAllow(null, topicId, sessionId, 'disabled');
|
|
175
|
+
try {
|
|
176
|
+
// Share the maintenance ordering lock with stopAll(): once a global
|
|
177
|
+
// tombstone is published, no decision that observed the prior
|
|
178
|
+
// generation can commit a continuation afterward.
|
|
179
|
+
return this.withNamedLock('maintenance', () => this.withLock(topicId, () => {
|
|
180
|
+
const ledger = this.read(topicId);
|
|
181
|
+
if (!ledger)
|
|
182
|
+
return this.recordAllow(null, topicId, sessionId, 'no-ledger');
|
|
183
|
+
if (!this.isStructurallyValid(ledger))
|
|
184
|
+
return this.deactivate(ledger, 'invalid-state');
|
|
185
|
+
if (this.readTombstone(topicId) > ledger.generation || this.readGlobalTombstone() > ledger.generation) {
|
|
186
|
+
return this.deactivate(ledger, 'operator-stop');
|
|
187
|
+
}
|
|
188
|
+
if (!ledger.active)
|
|
189
|
+
return this.recordAllow(ledger, topicId, sessionId, 'no-ledger');
|
|
190
|
+
// Initial binding only: the explicit start created this fresh generation,
|
|
191
|
+
// and the first Stop hook serving the same topic claims it. This is not
|
|
192
|
+
// restart adoption; once bound, every mismatch fails open.
|
|
193
|
+
if (ledger.sessionId === FIRST_STOP_BIND && ledger.topicId === topicId && sessionId) {
|
|
194
|
+
ledger.sessionId = sessionId;
|
|
195
|
+
ledger.updatedAt = new Date().toISOString();
|
|
196
|
+
this.write(ledger);
|
|
197
|
+
}
|
|
198
|
+
if (ledger.topicId !== topicId || ledger.sessionId !== sessionId)
|
|
199
|
+
return this.recordAllow(ledger, topicId, sessionId, 'ownership-mismatch');
|
|
200
|
+
const elapsed = Date.now() - Date.parse(ledger.startedAt);
|
|
201
|
+
if (!Number.isFinite(elapsed) || elapsed >= ledger.durationSeconds * 1000)
|
|
202
|
+
return this.deactivate(ledger, 'duration-expired');
|
|
203
|
+
if (ledger.continuationCount >= ledger.maxContinuations)
|
|
204
|
+
return this.deactivate(ledger, 'continuation-ceiling');
|
|
205
|
+
const tasks = parseContinuationTasks(ledger.body);
|
|
206
|
+
if (tasks.length === 0)
|
|
207
|
+
return this.deactivate(ledger, 'no-task-structure');
|
|
208
|
+
const open = tasks.filter((t) => t.open).length;
|
|
209
|
+
if (open === 0)
|
|
210
|
+
return this.deactivate(ledger, 'all-tasks-complete');
|
|
211
|
+
ledger.continuationCount++;
|
|
212
|
+
ledger.updatedAt = new Date().toISOString();
|
|
213
|
+
this.write(ledger);
|
|
214
|
+
try {
|
|
215
|
+
this.audit(ledger, 'continue', 'open-tasks', open, ledger.continuationCount);
|
|
216
|
+
}
|
|
217
|
+
catch { /* @silent-fallback-ok: audit failure is a typed fail-open stop decision, never an unreported continuation */
|
|
218
|
+
return this.deactivate(ledger, 'audit-failed', false);
|
|
219
|
+
}
|
|
220
|
+
return {
|
|
221
|
+
decision: 'continue', reason: 'open-tasks', openTaskCount: open,
|
|
222
|
+
continuationCount: ledger.continuationCount,
|
|
223
|
+
reasonText: `Continue the current assignment. ${open} explicit task(s) remain. Re-read the continuation ledger and proceed with the first open item; do not invent additional work.`,
|
|
224
|
+
};
|
|
225
|
+
}));
|
|
226
|
+
}
|
|
227
|
+
catch (err) { // @silent-fallback-ok: every failure becomes an enumerated allow reason; self-continuation must fail open
|
|
228
|
+
if (err instanceof Error && err.message === 'lock-unavailable')
|
|
229
|
+
return this.recordAllow(null, topicId, sessionId, 'lock-unavailable');
|
|
230
|
+
return this.recordAllow(null, topicId, sessionId, 'invalid-state');
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
list() {
|
|
234
|
+
try {
|
|
235
|
+
return fs.readdirSync(this.root).filter((f) => /^\d+\.local\.json$/.test(f))
|
|
236
|
+
.map((f) => this.readStrict(f.replace(/\.local\.json$/, '')));
|
|
237
|
+
}
|
|
238
|
+
catch (err) {
|
|
239
|
+
// @silent-fallback-ok: an absent directory is the legitimate fresh-store
|
|
240
|
+
// state. Other enumeration failures must stay loud: treating EACCES/I/O
|
|
241
|
+
// as empty could weaken stopAll generation ordering or the capacity cap.
|
|
242
|
+
if (err.code === 'ENOENT')
|
|
243
|
+
return [];
|
|
244
|
+
throw err;
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
deactivate(ledger, reason, writeAudit = true) {
|
|
248
|
+
ledger.active = false;
|
|
249
|
+
ledger.updatedAt = new Date().toISOString();
|
|
250
|
+
this.write(ledger);
|
|
251
|
+
if (writeAudit) {
|
|
252
|
+
try {
|
|
253
|
+
this.audit(ledger, 'deactivate', reason, null, ledger.continuationCount);
|
|
254
|
+
}
|
|
255
|
+
catch { /* already stopping */ }
|
|
256
|
+
}
|
|
257
|
+
return { decision: 'deactivate', reason, openTaskCount: null, continuationCount: ledger.continuationCount };
|
|
258
|
+
}
|
|
259
|
+
recordAllow(ledger, topicId, sessionId, reason) {
|
|
260
|
+
try {
|
|
261
|
+
this.audit(ledger ?? { topicId, sessionId, generationId: '', continuationCount: 0 }, 'allow', reason, null, ledger?.continuationCount ?? null);
|
|
262
|
+
}
|
|
263
|
+
catch { /* allow remains safe */ }
|
|
264
|
+
return { decision: 'allow', reason, openTaskCount: null, continuationCount: ledger?.continuationCount ?? null };
|
|
265
|
+
}
|
|
266
|
+
requireValid(topicId) {
|
|
267
|
+
const ledger = this.read(topicId);
|
|
268
|
+
if (!ledger || !this.isStructurallyValid(ledger))
|
|
269
|
+
throw new Error('invalid-state');
|
|
270
|
+
return ledger;
|
|
271
|
+
}
|
|
272
|
+
/** Enumeration consumers drive global generation/capacity decisions, so a
|
|
273
|
+
* discovered file must never be silently omitted on read, parse, or schema
|
|
274
|
+
* failure. Direct point reads remain tolerant for fail-open Stop decisions. */
|
|
275
|
+
readStrict(topicId) {
|
|
276
|
+
const parsed = JSON.parse(fs.readFileSync(this.ledgerPath(topicId), 'utf8'));
|
|
277
|
+
if (!this.isStructurallyValid(parsed))
|
|
278
|
+
throw new Error('invalid-state');
|
|
279
|
+
return parsed;
|
|
280
|
+
}
|
|
281
|
+
isStructurallyValid(v) {
|
|
282
|
+
return v.version === 1 && /^\d+$/.test(v.topicId) && !!v.sessionId && Number.isInteger(v.generation) && v.generation > 0
|
|
283
|
+
&& Number.isInteger(v.continuationCount) && v.continuationCount >= 0
|
|
284
|
+
&& Number.isInteger(v.maxContinuations) && v.maxContinuations > 0 && v.maxContinuations <= this.cfg.maxContinuations
|
|
285
|
+
&& Number.isInteger(v.durationSeconds) && v.durationSeconds > 0 && v.durationSeconds <= this.cfg.maxDurationSeconds
|
|
286
|
+
&& Buffer.byteLength(v.body, 'utf8') <= MAX_BODY_BYTES && digest(normalizeTaskBody(v.body)) === v.bodyDigest;
|
|
287
|
+
}
|
|
288
|
+
audit(ledger, decision, reason, openTaskCount, continuationCount) {
|
|
289
|
+
this.withNamedLock('audit', () => {
|
|
290
|
+
fs.mkdirSync(this.root, { recursive: true });
|
|
291
|
+
const file = path.join(this.root, 'audit.local.jsonl');
|
|
292
|
+
const row = JSON.stringify({
|
|
293
|
+
ts: new Date().toISOString(), topicId: ledger.topicId ?? null,
|
|
294
|
+
sessionIdHash: ledger.sessionId ? digest(ledger.sessionId).slice(0, 16) : null,
|
|
295
|
+
ledgerGeneration: ledger.generationId || null, decision, reason, openTaskCount, continuationCount,
|
|
296
|
+
});
|
|
297
|
+
fs.appendFileSync(file, `${row}\n`, { mode: 0o600 });
|
|
298
|
+
this.pruneAudit(file);
|
|
299
|
+
});
|
|
300
|
+
}
|
|
301
|
+
pruneAudit(file) {
|
|
302
|
+
const rows = fs.readFileSync(file, 'utf8').trim().split('\n').filter(Boolean);
|
|
303
|
+
const cutoff = Date.now() - this.cfg.auditRetentionDays * 86_400_000;
|
|
304
|
+
const kept = rows.filter((row) => {
|
|
305
|
+
try {
|
|
306
|
+
return Date.parse(JSON.parse(row).ts) >= cutoff;
|
|
307
|
+
}
|
|
308
|
+
catch { /* @silent-fallback-ok: malformed audit rows are rejected during bounded retention compaction */
|
|
309
|
+
return false;
|
|
310
|
+
}
|
|
311
|
+
}).slice(-this.cfg.auditMaxRows);
|
|
312
|
+
atomicWrite(file, kept.length ? `${kept.join('\n')}\n` : '');
|
|
313
|
+
}
|
|
314
|
+
pruneInactiveLedgers() {
|
|
315
|
+
const cutoff = Date.now() - this.cfg.auditRetentionDays * 86_400_000;
|
|
316
|
+
for (const ledger of this.list()) {
|
|
317
|
+
if (ledger.active || Date.parse(ledger.updatedAt) >= cutoff)
|
|
318
|
+
continue;
|
|
319
|
+
try {
|
|
320
|
+
SafeFsExecutor.safeUnlinkSync(this.ledgerPath(ledger.topicId), { operation: 'CodexTaskContinuationStore.pruneInactiveLedger' });
|
|
321
|
+
}
|
|
322
|
+
catch { /* best effort; capacity gate remains */ }
|
|
323
|
+
try {
|
|
324
|
+
SafeFsExecutor.safeUnlinkSync(this.tombstonePath(ledger.topicId), { operation: 'CodexTaskContinuationStore.pruneInactiveTombstone' });
|
|
325
|
+
}
|
|
326
|
+
catch { /* absent is fine after ledger removal */ }
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
withLock(topicId, fn) {
|
|
330
|
+
return this.withNamedLock(topicId, fn);
|
|
331
|
+
}
|
|
332
|
+
withNamedLock(name, fn) {
|
|
333
|
+
fs.mkdirSync(this.root, { recursive: true });
|
|
334
|
+
const lock = path.join(this.root, `${name}.lock`);
|
|
335
|
+
try {
|
|
336
|
+
fs.mkdirSync(lock);
|
|
337
|
+
}
|
|
338
|
+
catch {
|
|
339
|
+
throw new Error('lock-unavailable');
|
|
340
|
+
}
|
|
341
|
+
try {
|
|
342
|
+
return fn();
|
|
343
|
+
}
|
|
344
|
+
finally {
|
|
345
|
+
try {
|
|
346
|
+
SafeFsExecutor.safeRmSync(lock, { recursive: true, force: true, operation: 'CodexTaskContinuationStore.releaseLock' });
|
|
347
|
+
}
|
|
348
|
+
catch { /* next call fails open */ }
|
|
349
|
+
}
|
|
350
|
+
}
|
|
351
|
+
write(ledger) { atomicWrite(this.ledgerPath(ledger.topicId), `${JSON.stringify(ledger, null, 2)}\n`); }
|
|
352
|
+
ledgerPath(topicId) { return path.join(this.root, `${topicId}.local.json`); }
|
|
353
|
+
tombstonePath(topicId) { return path.join(this.root, `${topicId}.operator-stop.local`); }
|
|
354
|
+
readTombstone(topicId) { return this.readGeneration(this.tombstonePath(topicId)); }
|
|
355
|
+
readGlobalTombstone() { return this.readGeneration(path.join(this.root, 'operator-stop-all.local')); }
|
|
356
|
+
readGeneration(file) {
|
|
357
|
+
try {
|
|
358
|
+
const raw = fs.readFileSync(file, 'utf8').trim();
|
|
359
|
+
const n = Number(raw);
|
|
360
|
+
// A present marker is operator authority. Corruption or an unreadable
|
|
361
|
+
// marker must outrank every ledger rather than silently erasing a stop.
|
|
362
|
+
return raw !== '' && Number.isSafeInteger(n) && n >= 0 ? n : Number.MAX_SAFE_INTEGER;
|
|
363
|
+
}
|
|
364
|
+
catch (err) {
|
|
365
|
+
return err.code === 'ENOENT' ? 0 : Number.MAX_SAFE_INTEGER;
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
//# sourceMappingURL=CodexTaskContinuationStore.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CodexTaskContinuationStore.js","sourceRoot":"","sources":["../../src/core/CodexTaskContinuationStore.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"IdentityRenderer.d.ts","sourceRoot":"","sources":["../../src/core/IdentityRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIzD,CAAC;AAwBF,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,2EAA2E;IAC3E,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,
|
|
1
|
+
{"version":3,"file":"IdentityRenderer.d.ts","sourceRoot":"","sources":["../../src/core/IdentityRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIzD,CAAC;AAwBF,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,2EAA2E;IAC3E,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAoCnF;AAyED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,MAAM,GAAG,IAAI,CA4Cf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,aAAa,CAAC,MAAM,CAAC,CAqBvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,MAAM,GAAG,IAAI,CAkBf"}
|
|
@@ -92,11 +92,23 @@ export function renderIdentity(options) {
|
|
|
92
92
|
const relayAppendix = options.appendTelegramRelayBlock
|
|
93
93
|
? '\n\n' + buildPersistentRelayAppendix(framework)
|
|
94
94
|
: '';
|
|
95
|
-
|
|
95
|
+
const continuationAppendix = framework === 'codex-cli'
|
|
96
|
+
? '\n\n' + buildCodexContinuationAppendix()
|
|
97
|
+
: '';
|
|
98
|
+
fs.writeFileSync(target, banner + content + relayAppendix + continuationAppendix, 'utf-8');
|
|
96
99
|
shadowsWritten.push(target);
|
|
97
100
|
}
|
|
98
101
|
return { source, shadowsWritten, skipped };
|
|
99
102
|
}
|
|
103
|
+
function buildCodexContinuationAppendix() {
|
|
104
|
+
return [
|
|
105
|
+
`## Multi-step Work Continuation`,
|
|
106
|
+
``,
|
|
107
|
+
`When you accept a multi-step assignment, check the local continuation capability before beginning. If it is enabled, start a bounded per-topic checklist through the authenticated local continuation API. Keep the checklist honest as work completes. The existing Codex Stop hook will continue turns only while explicit unchecked tasks remain; an empty or fully checked list ends normally.`,
|
|
108
|
+
``,
|
|
109
|
+
`Do not create filler tasks. Never restart a stopped ledger. An operator stop, the hard off-switch, the duration ceiling, and the continuation-count ceiling always win. The user should never be asked to run commands or maintain the checklist—you own this lifecycle as part of accepting the work.`,
|
|
110
|
+
].join('\n');
|
|
111
|
+
}
|
|
100
112
|
/**
|
|
101
113
|
* Markdown appendix that lives at the bottom of AGENTS.md / CLAUDE.md when
|
|
102
114
|
* Telegram is configured. The wording mirrors the bootstrap-message helper
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"IdentityRenderer.js","sourceRoot":"","sources":["../../src/core/IdentityRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D,aAAa,EAAE,WAAW;IAC1B,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,WAAW;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,SAAS,SAAS,CAAC,SAAiB,EAAE,aAAqB;IACzD,OAAO;QACL,MAAM;QACN,gDAAgD;QAChD,sBAAsB,aAAa,EAAE;QACrC,gBAAgB,SAAS,EAAE;QAC3B,EAAE;QACF,qEAAqE;QACrE,kDAAkD;QAClD,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AA0CD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,qBAAqB,CAC7B,+CAA+C;cAC7C,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM;cAC7D,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAEtF,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,wBAAwB;YACpD,CAAC,CAAC,MAAM,GAAG,4BAA4B,CAAC,SAAS,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,EAAE,OAAO,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"IdentityRenderer.js","sourceRoot":"","sources":["../../src/core/IdentityRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D,aAAa,EAAE,WAAW;IAC1B,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,WAAW;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,SAAS,SAAS,CAAC,SAAiB,EAAE,aAAqB;IACzD,OAAO;QACL,MAAM;QACN,gDAAgD;QAChD,sBAAsB,aAAa,EAAE;QACrC,gBAAgB,SAAS,EAAE;QAC3B,EAAE;QACF,qEAAqE;QACrE,kDAAkD;QAClD,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AA0CD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,qBAAqB,CAC7B,+CAA+C;cAC7C,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM;cAC7D,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAEtF,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,wBAAwB;YACpD,CAAC,CAAC,MAAM,GAAG,4BAA4B,CAAC,SAAS,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,oBAAoB,GAAG,SAAS,KAAK,WAAW;YACpD,CAAC,CAAC,MAAM,GAAG,8BAA8B,EAAE;YAC3C,CAAC,CAAC,EAAE,CAAC;QACP,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC3F,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,8BAA8B;IACrC,OAAO;QACL,iCAAiC;QACjC,EAAE;QACF,oYAAoY;QACpY,EAAE;QACF,wSAAwS;KACzS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,4BAA4B,CAAC,SAAiB;IACrD,wEAAwE;IACxE,sEAAsE;IACtE,oEAAoE;IACpE,MAAM,mBAAmB,GAAG,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,YAAY,CAAC;IACpF,OAAO;QACL,+BAA+B;QAC/B,EAAE;QACF,iQAAiQ;QACjQ,EAAE;QACF,SAAS;QACT,mDAAmD;QACnD,yCAAyC;QACzC,KAAK;QACL,KAAK;QACL,EAAE;QACF,iLAAiL;QACjL,uOAAuO;QACvO,EAAE;QACF,QAAQ;QACR,sEAAsE;QACtE,sFAAsF;QACtF,sGAAsG;QACtG,mBAAmB;YACjB,CAAC,CAAC,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,oLAAoL;YAClP,CAAC,CAAC,yHAAyH;KAC9H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,UAAkB,EAAE,QAAiB;IAC1D,MAAM,UAAU,GAAG;QACjB,QAAQ;QACR,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;KAClC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAE9C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC3E,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAkB,EAClB,SAAiB,EACjB,UAAqE,EAAE;IAEvE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEnD,uEAAuE;IACvE,oEAAoE;IACpE,uEAAuE;IACvE,gEAAgE;IAChE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACtD,IAAI,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;oBACvD,OAAO,IAAI,CAAC,CAAC,qBAAqB;gBACpC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;YACD,+BAA+B;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,gEAAgE;IAChE,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ;QAC3D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;QACzC,CAAC,CAAC,SAAS,CAAC,CAAC;IACf,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,0BAA0B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,UAAU;QACV,UAAU,EAAE,CAAC,SAAS,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC,QAAQ;YAC1B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;YACzC,CAAC,CAAC,SAAS;QACb,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;KAC3D,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAAkB,EAClB,UAAqE,EAAE;IAEvE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAC1D,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,aAAa,CAC7B,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ;QACjC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;QACzC,CAAC,CAAC,SAAS,CAAC;IACd,sEAAsE;IACtE,IAAI,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC;YAC5B,UAAU;YACV,UAAU,EAAE,SAAS;YACrB,UAAU;YACV,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;SAC3D,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,cAAc,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAkB,EAClB,UAAiC,EAAE;IAEnC,MAAM,SAAS,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,cAAc,GAAG,sBAAsB,CAAC,SAAS,CAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAEzD,IAAI,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,qEAAqE;IACrE,4BAA4B;IAC5B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC;AACrB,CAAC"}
|
|
@@ -15,6 +15,17 @@ export type PlaywrightSeatLeaseResult = {
|
|
|
15
15
|
retryAfterMs: number;
|
|
16
16
|
expiresAt: string;
|
|
17
17
|
};
|
|
18
|
+
export type PlaywrightSeatReleaseResult = {
|
|
19
|
+
released: true;
|
|
20
|
+
} | {
|
|
21
|
+
released: false;
|
|
22
|
+
reason: 'not-held';
|
|
23
|
+
} | {
|
|
24
|
+
released: false;
|
|
25
|
+
reason: 'ownership-mismatch';
|
|
26
|
+
holderLabel: string;
|
|
27
|
+
expiresAt: string;
|
|
28
|
+
};
|
|
18
29
|
export interface PlaywrightSeatLeaseOptions {
|
|
19
30
|
filePath?: string;
|
|
20
31
|
now?: () => number;
|
|
@@ -32,6 +43,11 @@ export declare class PlaywrightSeatLease {
|
|
|
32
43
|
private readonly ttlMs;
|
|
33
44
|
constructor(options?: PlaywrightSeatLeaseOptions);
|
|
34
45
|
acquire(holderId: string, holderLabel: string): PlaywrightSeatLeaseResult;
|
|
46
|
+
/**
|
|
47
|
+
* Voluntary release for standalone browser drives. Only the current holder
|
|
48
|
+
* can release; a stale script can never clear a successor's live lease.
|
|
49
|
+
*/
|
|
50
|
+
release(holderId: string): PlaywrightSeatReleaseResult;
|
|
35
51
|
private read;
|
|
36
52
|
private persist;
|
|
37
53
|
private withLock;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PlaywrightSeatLease.d.ts","sourceRoot":"","sources":["../../src/core/PlaywrightSeatLease.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,4BAA4B,QAAc,CAAC;AAGxD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,yBAAyB,CAAA;CAAE,GACpD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,0BAA+B;IAOpD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,yBAAyB;IA+BzE,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,QAAQ;CA4BjB"}
|
|
1
|
+
{"version":3,"file":"PlaywrightSeatLease.d.ts","sourceRoot":"","sources":["../../src/core/PlaywrightSeatLease.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,4BAA4B,QAAc,CAAC;AAGxD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,yBAAyB,CAAA;CAAE,GACpD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAClB;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACvC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,0BAA+B;IAOpD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,yBAAyB;IA+BzE;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,2BAA2B;IAmBtD,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,QAAQ;CA4BjB"}
|
|
@@ -58,6 +58,30 @@ export class PlaywrightSeatLease {
|
|
|
58
58
|
return { acquired: true, lease };
|
|
59
59
|
});
|
|
60
60
|
}
|
|
61
|
+
/**
|
|
62
|
+
* Voluntary release for standalone browser drives. Only the current holder
|
|
63
|
+
* can release; a stale script can never clear a successor's live lease.
|
|
64
|
+
*/
|
|
65
|
+
release(holderId) {
|
|
66
|
+
const id = clamp(holderId, 256);
|
|
67
|
+
if (!id)
|
|
68
|
+
throw new Error('holderId is required');
|
|
69
|
+
return this.withLock(() => {
|
|
70
|
+
const current = this.read();
|
|
71
|
+
if (!current)
|
|
72
|
+
return { released: false, reason: 'not-held' };
|
|
73
|
+
if (current.holderId !== id) {
|
|
74
|
+
return {
|
|
75
|
+
released: false,
|
|
76
|
+
reason: 'ownership-mismatch',
|
|
77
|
+
holderLabel: current.holderLabel,
|
|
78
|
+
expiresAt: current.expiresAt,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
SafeFsExecutor.safeUnlinkSync(this.filePath, { operation: 'PlaywrightSeatLease voluntary release' });
|
|
82
|
+
return { released: true };
|
|
83
|
+
});
|
|
84
|
+
}
|
|
61
85
|
read() {
|
|
62
86
|
if (!fs.existsSync(this.filePath))
|
|
63
87
|
return null;
|