@farmslot/agent-runtime 0.39.18 → 0.39.20

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/CHANGELOG.md CHANGED
@@ -4,6 +4,15 @@
4
4
 
5
5
  - Active-development baseline; add user-facing changes here before release or package publication.
6
6
 
7
+ ## 0.39.20 - 2026-11-01
8
+
9
+ - Publishes against `@farmslot/protocol` 0.74.10.
10
+ - Task retention takes an optional `pinSelection` hook. Once the inputs are copied into the task pin, the host can rebind its recorded selection (`inputs/recipe-binding.json` and the receipt's `bindingIdentity`) to the retained copies. A rerun of task init verifies the recorded pin first, then requires the same pinned selection. `retainedPathFor` and `retainedSourceFor` map between a retained source and its copy.
11
+
12
+ ## 0.39.19 - 2026-11-01
13
+
14
+ - The native host checkpoints a session's Git working tree before and after each turn, as commits under `refs/farmslot/native/<sessionId>/` built in the session's own index (the worktree, its index, `HEAD` and branches are untouched), and appends `turn.changes` after the turn; a queued message is journaled after the previous turn's changes. Delivery waits for the checkpoints at most 3 s in all. A session keeps its last 100 checkpoints, and its refs are deleted at close, also after a failure or host restart. The node service answers `native.session.turn.diff` for a file a `turn.changes` event lists while its checkpoints are retained. Read-only reviewer sessions take no checkpoints.
15
+
7
16
  ## 0.39.18 - 2026-11-01
8
17
 
9
18
  - The native host steers: `steer` (and `native.worker.steer` under the worker's lease) adds a message to the running turn when the adapter declares `capabilities.steer`, the session runs and no request is pending; otherwise it is an ordinary send. The intent is journaled first; a runner's error reply fails the command without a resend, while a lost reply (exit, timeout) stays unknown; and a steered command settles with its turn. Worker reads keep `steered` on receipts. Codex declares `steer` and uses `turn/steer`. A host started before the upgrade refuses the method as unknown.
@@ -0,0 +1,62 @@
1
+ import type { NativeTurnChanges, NativeTurnFile } from '@farmslot/protocol';
2
+ /** Checkpoints a session keeps; older refs are deleted, so their diffs are no longer retained. */
3
+ export declare const NATIVE_CHECKPOINTS_KEPT = 100;
4
+ /** Untracked files larger than this stay out of checkpoints, so build output is never hashed. */
5
+ export declare const NATIVE_CHECKPOINT_UNTRACKED_LIMIT: number;
6
+ /**
7
+ * A session's checkpoints: commits of its Git working tree's content, untracked files Git does not
8
+ * ignore included, with `HEAD` as parent. They are built in the session's own index, seeded from
9
+ * the worktree's index and reseeded only when that changes, so Git's stat cache hashes only files
10
+ * changed since the previous checkpoint, tracked or not. The worktree, its index, `HEAD` and every
11
+ * branch stay untouched. One Git call per step, never one per file; steps run one at a time.
12
+ */
13
+ export declare class NativeCheckpoints {
14
+ private readonly root;
15
+ private readonly gitDir;
16
+ private readonly prefix;
17
+ private refs;
18
+ private readonly kept;
19
+ private readonly indexDir;
20
+ private last?;
21
+ /** The worktree index the session's index was seeded from. */
22
+ private seeded?;
23
+ private queue;
24
+ private constructor();
25
+ /**
26
+ * Checkpoints for a session whose working directory is in a Git working tree, or none.
27
+ * `indexDir` holds the session's index; `remove` deletes it with the refs.
28
+ */
29
+ static open(cwd: string, sessionId: string, options: {
30
+ indexDir: string;
31
+ kept?: number;
32
+ }): Promise<NativeCheckpoints | undefined>;
33
+ private serial;
34
+ /** The working tree now; the previous checkpoint when nothing changed since it. */
35
+ take(): Promise<string>;
36
+ private snapshot;
37
+ /**
38
+ * Seeds the session's index from the worktree's when that changed (a commit, a staged file, a
39
+ * checkout) or none exists yet. The copy keeps the original's timestamp, so Git still re-checks
40
+ * entries written in the same second as that index.
41
+ */
42
+ private seed;
43
+ /** Files the session's index lacks that Git does not ignore, up to the size limit each. */
44
+ private untracked;
45
+ /** The files that differ between two checkpoints, from one tree-to-tree diff. */
46
+ changes(from: string, to: string): Promise<NativeTurnChanges>;
47
+ /** Deletes the session's checkpoint refs and index; their diffs are no longer retained. */
48
+ remove(): Promise<void>;
49
+ private updateRefs;
50
+ }
51
+ /** `diff-tree -z --raw --numstat`: raw records first (`:modes shas status\0path\0`), then counts. */
52
+ export declare function parseTurnFiles(output: string): NativeTurnFile[];
53
+ /**
54
+ * One file's diff between two checkpoints of the session's repository; `file` is relative to its
55
+ * root. `undefined` once either checkpoint is no longer retained under the session's refs.
56
+ */
57
+ export declare function nativeTurnDiff(cwd: string, sessionId: string, from: string, to: string, file: string): Promise<string | undefined>;
58
+ /** How long a turn's delivery waits, in all, for the previous turn's checkpoint and its own. */
59
+ export declare const NATIVE_CHECKPOINT_WAIT_MS = 3000;
60
+ /** The value, or `undefined` once `ms` passed first. */
61
+ export declare function withinMs<T>(work: Promise<T>, ms: number): Promise<T | undefined>;
62
+ //# sourceMappingURL=checkpoint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/native/checkpoint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAM5E,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAG3C,iGAAiG;AACjG,eAAO,MAAM,iCAAiC,QAAmB,CAAC;AAUlE;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAO1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,OAAO,CAAC,IAAI,CAAC,CAAmC;IAChD,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,KAAK,CAAuC;IAEpD,OAAO;IASP;;;OAGG;WACU,IAAI,CACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAuBzC,OAAO,CAAC,MAAM;IAMd,mFAAmF;IACnF,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;YAIT,QAAQ;IAkCtB;;;;OAIG;YACW,IAAI;IAYlB,2FAA2F;YAC7E,SAAS;IAoBvB,iFAAiF;IAC3E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBnE,2FAA2F;IAC3F,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAUT,UAAU;CASzB;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAuB/D;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B;AAED,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,wDAAwD;AACxD,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAUtF"}
@@ -0,0 +1,206 @@
1
+ import { copyFile, lstat, mkdir, rm, stat, utimes } from 'node:fs/promises';
2
+ import path from 'node:path';
3
+ import { git } from './workspace.js';
4
+ /** Hidden refs under which a session's checkpoints stay reachable, one ref per checkpoint. */
5
+ const REF_ROOT = 'refs/farmslot/native';
6
+ /** Checkpoints a session keeps; older refs are deleted, so their diffs are no longer retained. */
7
+ export const NATIVE_CHECKPOINTS_KEPT = 100;
8
+ /** Files a turn lists; more set `truncated`. */
9
+ const TURN_FILES_LIMIT = 500;
10
+ /** Untracked files larger than this stay out of checkpoints, so build output is never hashed. */
11
+ export const NATIVE_CHECKPOINT_UNTRACKED_LIMIT = 10 * 1024 * 1024;
12
+ const IDENTITY = {
13
+ GIT_AUTHOR_NAME: 'Farmslot',
14
+ GIT_AUTHOR_EMAIL: 'farmslot@localhost',
15
+ GIT_COMMITTER_NAME: 'Farmslot',
16
+ GIT_COMMITTER_EMAIL: 'farmslot@localhost',
17
+ };
18
+ const refPrefix = (sessionId) => `${REF_ROOT}/${sessionId}`;
19
+ /**
20
+ * A session's checkpoints: commits of its Git working tree's content, untracked files Git does not
21
+ * ignore included, with `HEAD` as parent. They are built in the session's own index, seeded from
22
+ * the worktree's index and reseeded only when that changes, so Git's stat cache hashes only files
23
+ * changed since the previous checkpoint, tracked or not. The worktree, its index, `HEAD` and every
24
+ * branch stay untouched. One Git call per step, never one per file; steps run one at a time.
25
+ */
26
+ export class NativeCheckpoints {
27
+ constructor(root, gitDir, prefix, refs, kept, indexDir) {
28
+ this.root = root;
29
+ this.gitDir = gitDir;
30
+ this.prefix = prefix;
31
+ this.refs = refs;
32
+ this.kept = kept;
33
+ this.indexDir = indexDir;
34
+ this.queue = Promise.resolve();
35
+ }
36
+ /**
37
+ * Checkpoints for a session whose working directory is in a Git working tree, or none.
38
+ * `indexDir` holds the session's index; `remove` deletes it with the refs.
39
+ */
40
+ static async open(cwd, sessionId, options) {
41
+ const located = await git(cwd, ['rev-parse', '--show-toplevel', '--absolute-git-dir']).catch(() => undefined);
42
+ if (!located)
43
+ return undefined;
44
+ const [root, gitDir] = located.trim().split('\n');
45
+ const prefix = refPrefix(sessionId);
46
+ const refs = (await git(root, ['for-each-ref', '--format=%(refname)', `${prefix}/`]))
47
+ .split('\n')
48
+ .filter(Boolean)
49
+ .sort();
50
+ const { indexDir } = options;
51
+ await mkdir(indexDir, { recursive: true, mode: 0o700 });
52
+ return new NativeCheckpoints(root, gitDir, prefix, refs, options.kept ?? NATIVE_CHECKPOINTS_KEPT, indexDir);
53
+ }
54
+ serial(step) {
55
+ const done = this.queue.then(step);
56
+ this.queue = done.catch(() => undefined);
57
+ return done;
58
+ }
59
+ /** The working tree now; the previous checkpoint when nothing changed since it. */
60
+ take() {
61
+ return this.serial(() => this.snapshot());
62
+ }
63
+ async snapshot() {
64
+ const index = path.join(this.indexDir, 'index');
65
+ await this.seed(index);
66
+ const env = { GIT_INDEX_FILE: index };
67
+ // Entries the session's index holds: changed ones are hashed, deleted ones dropped.
68
+ await git(this.root, ['add', '--update', '--', '.'], undefined, env);
69
+ const untracked = await this.untracked(env);
70
+ // A file removed since it was listed is skipped, not an error.
71
+ if (untracked.length)
72
+ await git(this.root, ['update-index', '--add', '--remove', '-z', '--stdin'], undefined, env, `${untracked.join('\0')}\0`);
73
+ const tree = (await git(this.root, ['write-tree'], undefined, env)).trim();
74
+ if (this.last?.tree === tree)
75
+ return this.last.commit;
76
+ const message = ['-m', 'Farmslot native checkpoint'];
77
+ const commit = (await git(this.root, ['commit-tree', tree, '-p', 'HEAD', ...message], undefined, IDENTITY)
78
+ // An unborn branch has no HEAD to descend from.
79
+ .catch(() => git(this.root, ['commit-tree', tree, ...message], undefined, IDENTITY))).trim();
80
+ const ref = `${this.prefix}/${Date.now().toString(36).padStart(9, '0')}-${commit.slice(0, 12)}`;
81
+ const stale = this.refs.length + 1 - this.kept;
82
+ const expired = stale > 0 ? this.refs.slice(0, stale) : [];
83
+ // One transaction: the new ref, and the oldest beyond those kept.
84
+ await this.updateRefs([`create ${ref} ${commit}`, ...expired.map((old) => `delete ${old}`)]);
85
+ this.refs = [...this.refs.slice(expired.length), ref];
86
+ this.last = { commit, tree };
87
+ return commit;
88
+ }
89
+ /**
90
+ * Seeds the session's index from the worktree's when that changed (a commit, a staged file, a
91
+ * checkout) or none exists yet. The copy keeps the original's timestamp, so Git still re-checks
92
+ * entries written in the same second as that index.
93
+ */
94
+ async seed(index) {
95
+ const source = path.join(this.gitDir, 'index');
96
+ const current = await stat(source).catch(() => undefined);
97
+ const key = current && `${current.ino}:${current.size}:${current.mtimeMs}`;
98
+ if (key === this.seeded && (await stat(index).catch(() => undefined)))
99
+ return;
100
+ if (current) {
101
+ await copyFile(source, index);
102
+ await utimes(index, current.atime, current.mtime);
103
+ }
104
+ else
105
+ await rm(index, { force: true });
106
+ this.seeded = key;
107
+ }
108
+ /** Files the session's index lacks that Git does not ignore, up to the size limit each. */
109
+ async untracked(env) {
110
+ const listed = await git(this.root, ['ls-files', '--others', '--exclude-standard', '-z'], 8 * 1024 * 1024, env);
111
+ const files = [];
112
+ for (const file of listed.split('\0')) {
113
+ if (!file || file.endsWith('/'))
114
+ continue;
115
+ const entry = await lstat(path.join(this.root, file)).catch(() => undefined);
116
+ if (entry?.isSymbolicLink() ||
117
+ (entry?.isFile() && entry.size <= NATIVE_CHECKPOINT_UNTRACKED_LIMIT))
118
+ files.push(file);
119
+ }
120
+ return files;
121
+ }
122
+ /** The files that differ between two checkpoints, from one tree-to-tree diff. */
123
+ async changes(from, to) {
124
+ if (from === to)
125
+ return { from, to, files: [] };
126
+ const output = await git(this.root, ['diff-tree', '-r', '-z', '--no-renames', '--no-ext-diff', '--raw', '--numstat', from, to], 8 * 1024 * 1024);
127
+ const files = parseTurnFiles(output);
128
+ return {
129
+ from,
130
+ to,
131
+ files: files.slice(0, TURN_FILES_LIMIT),
132
+ ...(files.length > TURN_FILES_LIMIT ? { truncated: true } : {}),
133
+ };
134
+ }
135
+ /** Deletes the session's checkpoint refs and index; their diffs are no longer retained. */
136
+ remove() {
137
+ return this.serial(async () => {
138
+ if (this.refs.length)
139
+ await this.updateRefs(this.refs.map((ref) => `delete ${ref}`));
140
+ this.refs = [];
141
+ this.last = undefined;
142
+ this.seeded = undefined;
143
+ await rm(this.indexDir, { recursive: true, force: true });
144
+ });
145
+ }
146
+ async updateRefs(lines) {
147
+ await git(this.root, ['update-ref', '--stdin'], undefined, {}, `start\n${lines.join('\n')}\nprepare\ncommit\n`);
148
+ }
149
+ }
150
+ /** `diff-tree -z --raw --numstat`: raw records first (`:modes shas status\0path\0`), then counts. */
151
+ export function parseTurnFiles(output) {
152
+ const tokens = output.split('\0');
153
+ const files = new Map();
154
+ for (let i = 0; i < tokens.length; i++) {
155
+ const token = tokens[i];
156
+ if (token.startsWith(':')) {
157
+ const status = token.split(' ').at(-1);
158
+ const file = tokens[++i];
159
+ files.set(file, {
160
+ path: file,
161
+ status: status === 'A' ? 'added' : status === 'D' ? 'deleted' : 'modified',
162
+ });
163
+ }
164
+ else if (token.includes('\t')) {
165
+ // A path may itself hold tabs.
166
+ const [additions, deletions, ...name] = token.split('\t');
167
+ const entry = files.get(name.join('\t'));
168
+ if (entry && additions !== '-') {
169
+ entry.additions = Number(additions);
170
+ entry.deletions = Number(deletions);
171
+ }
172
+ }
173
+ }
174
+ return [...files.values()];
175
+ }
176
+ /**
177
+ * One file's diff between two checkpoints of the session's repository; `file` is relative to its
178
+ * root. `undefined` once either checkpoint is no longer retained under the session's refs.
179
+ */
180
+ export async function nativeTurnDiff(cwd, sessionId, from, to, file) {
181
+ const [root, retained] = await Promise.all([
182
+ git(cwd, ['rev-parse', '--show-toplevel']),
183
+ git(cwd, ['for-each-ref', '--format=%(objectname)', `${refPrefix(sessionId)}/`]),
184
+ ]);
185
+ const kept = new Set(retained.split('\n'));
186
+ if (!kept.has(from) || !kept.has(to))
187
+ return undefined;
188
+ // Pathspecs are literal and relative to where Git runs, so run at the root.
189
+ return git(root.trim(), ['diff', '--no-renames', from, to, '--', file]);
190
+ }
191
+ /** How long a turn's delivery waits, in all, for the previous turn's checkpoint and its own. */
192
+ export const NATIVE_CHECKPOINT_WAIT_MS = 3_000;
193
+ /** The value, or `undefined` once `ms` passed first. */
194
+ export async function withinMs(work, ms) {
195
+ let timer;
196
+ try {
197
+ return await Promise.race([
198
+ work,
199
+ new Promise((resolve) => (timer = setTimeout(() => resolve(undefined), ms))),
200
+ ]);
201
+ }
202
+ finally {
203
+ clearTimeout(timer);
204
+ }
205
+ }
206
+ //# sourceMappingURL=checkpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/native/checkpoint.ts"],"names":[],"mappings":"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"}
@@ -85,5 +85,22 @@ export declare class NativeSessionManager {
85
85
  respond(owner: string, id: string, requestId: string, response: NativeSessionResponse): Promise<void>;
86
86
  interrupt(owner: string, id: string): Promise<void>;
87
87
  close(owner: string, id: string): Promise<void>;
88
+ /**
89
+ * The session's checkpoints, opened once and found again after a host restart (they are kept
90
+ * under the session's refs). A failure to open is not kept: the next use tries again.
91
+ */
92
+ private checkpointsOf;
93
+ private checkpointDirectory;
94
+ /** Waits until `deadline` for the last turn's `turn.changes`; later, reports it unavailable. */
95
+ private finishTurnChanges;
96
+ /**
97
+ * The checkpoint a turn starts from, before the runner write. Delivery waits for it until
98
+ * `deadline`; slower, the turn reports its changes unavailable and the late result is unused.
99
+ */
100
+ private checkpointBefore;
101
+ /** The turn's checkpoint after it, and `turn.changes` between the two, once. */
102
+ private checkpointAfter;
103
+ /** Deletes the session's checkpoints; a failure is shown and the next close tries again. */
104
+ private dropCheckpoints;
88
105
  }
89
106
  //# sourceMappingURL=manager.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/native/manager.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/native/manager.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,7 @@ import { basename, delimiter, dirname, isAbsolute, join, resolve } from 'node:pa
7
7
  import { promisify } from 'node:util';
8
8
  import { nativeStructuredResult, } from '@farmslot/protocol';
9
9
  import { assertNativeProfileCurrent, nativeProfileEnvironment, requireNativeProfile, } from './account-profiles.js';
10
+ import { NATIVE_CHECKPOINT_WAIT_MS, NativeCheckpoints, withinMs } from './checkpoint.js';
10
11
  import { NativeRequestRefused } from './process.js';
11
12
  import { journalProcesses } from './process-tree.js';
12
13
  import { nativeRunnerDefinitions as adapters } from './registry.js';
@@ -483,6 +484,8 @@ export class NativeSessionManager {
483
484
  throw error;
484
485
  }
485
486
  try {
487
+ // A read-only checkout is never written, so its turns change nothing to checkpoint.
488
+ record.readOnlyCheckout = !!filesystemPolicy;
486
489
  record.startupAbort = new AbortController();
487
490
  record.startup = transport.adapter.start({
488
491
  ...params,
@@ -901,8 +904,14 @@ export class NativeSessionManager {
901
904
  }
902
905
  }
903
906
  this.persist(record, enriched);
904
- if (event.type === 'turn.completed')
907
+ if (event.type === 'turn.completed') {
908
+ const start = record.turnStart;
909
+ record.turnStart = undefined;
910
+ // Only once turn.completed is durable: its changes follow it in the journal.
911
+ if (start)
912
+ this.checkpointAfter(record, start);
905
913
  this.scheduleQueuedInput(record);
914
+ }
906
915
  }
907
916
  owned(owner, id, observations) {
908
917
  const record = this.sessions.get(id);
@@ -1125,8 +1134,13 @@ export class NativeSessionManager {
1125
1134
  command.submitted = true;
1126
1135
  record.commands.set(commandId, command);
1127
1136
  try {
1137
+ // The previous turn's changes come first, and nothing this turn writes can reach them.
1138
+ const deadline = Date.now() + NATIVE_CHECKPOINT_WAIT_MS;
1139
+ if (record.turnEnd)
1140
+ await this.finishTurnChanges(record, deadline);
1128
1141
  // A crash after this durable reservation must never trigger a resend.
1129
1142
  this.append(record, { type: 'command.submitted', commandId, text });
1143
+ await this.checkpointBefore(record, commandId, deadline);
1130
1144
  await record.adapter.send(text, commandId);
1131
1145
  return {
1132
1146
  submitted: command.submitted,
@@ -1264,10 +1278,14 @@ export class NativeSessionManager {
1264
1278
  if (record.info.processPid && !record.info.processStopped)
1265
1279
  throw new Error('Native process cleanup is unconfirmed; close outcome is unknown');
1266
1280
  cancelQueued();
1281
+ await this.dropCheckpoints(record);
1267
1282
  return;
1268
1283
  }
1269
1284
  record.info.state = 'closing';
1270
1285
  this.persist(record);
1286
+ // The last turn's changes are reported before the session closes.
1287
+ if (record.turnEnd)
1288
+ await this.finishTurnChanges(record, Date.now() + NATIVE_CHECKPOINT_WAIT_MS);
1271
1289
  if (!record.adapter && record.startup) {
1272
1290
  record.startupAbort?.abort();
1273
1291
  try {
@@ -1278,6 +1296,7 @@ export class NativeSessionManager {
1278
1296
  // adapter has independently confirmed that its entire owned tree stopped.
1279
1297
  if (record.info.processStopped && ['closed', 'failed'].includes(record.info.state)) {
1280
1298
  cancelQueued();
1299
+ await this.dropCheckpoints(record);
1281
1300
  return;
1282
1301
  }
1283
1302
  throw error;
@@ -1290,6 +1309,114 @@ export class NativeSessionManager {
1290
1309
  cancelQueued();
1291
1310
  if (!['closed', 'failed'].includes(this.owned(owner, id).info.state))
1292
1311
  this.append(record, { type: 'session.closed' });
1312
+ await this.dropCheckpoints(record);
1313
+ }
1314
+ /**
1315
+ * The session's checkpoints, opened once and found again after a host restart (they are kept
1316
+ * under the session's refs). A failure to open is not kept: the next use tries again.
1317
+ */
1318
+ checkpointsOf(record) {
1319
+ if (!record.checkpoints) {
1320
+ const opened = NativeCheckpoints.open(record.info.cwd, record.info.id, {
1321
+ indexDir: this.checkpointDirectory(record),
1322
+ });
1323
+ record.checkpoints = opened;
1324
+ opened.catch(() => {
1325
+ if (record.checkpoints === opened)
1326
+ record.checkpoints = undefined;
1327
+ });
1328
+ }
1329
+ return record.checkpoints;
1330
+ }
1331
+ checkpointDirectory(record) {
1332
+ return join(this.root, 'checkpoints', record.info.id);
1333
+ }
1334
+ /** Waits until `deadline` for the last turn's `turn.changes`; later, reports it unavailable. */
1335
+ async finishTurnChanges(record, deadline) {
1336
+ const end = record.turnEnd;
1337
+ if (!end)
1338
+ return;
1339
+ const left = Math.max(0, deadline - Date.now());
1340
+ if ((await withinMs(end.done.then(() => true), left)) === undefined)
1341
+ end.abandon(`The checkpoint after this turn took longer than ${NATIVE_CHECKPOINT_WAIT_MS / 1000} s`);
1342
+ }
1343
+ /**
1344
+ * The checkpoint a turn starts from, before the runner write. Delivery waits for it until
1345
+ * `deadline`; slower, the turn reports its changes unavailable and the late result is unused.
1346
+ */
1347
+ async checkpointBefore(record, commandId, deadline) {
1348
+ record.turnStart = undefined;
1349
+ // A read-only checkout is never written, so its turns change nothing to checkpoint.
1350
+ if (record.readOnlyCheckout)
1351
+ return;
1352
+ const late = {
1353
+ commandId,
1354
+ unavailable: `The checkpoint before this turn took longer than ${NATIVE_CHECKPOINT_WAIT_MS / 1000} s`,
1355
+ };
1356
+ // The previous turn's checkpoint used the whole wait: none is started that would go unused.
1357
+ if (Date.now() >= deadline) {
1358
+ if (record.checkpoints)
1359
+ record.turnStart = late;
1360
+ return;
1361
+ }
1362
+ // `null`: the working directory is not in a Git working tree, so its turns report nothing.
1363
+ const taken = (async () => {
1364
+ const checkpoints = await this.checkpointsOf(record);
1365
+ return checkpoints ? { from: await checkpoints.take() } : null;
1366
+ })().catch((error) => ({
1367
+ unavailable: `The checkpoint before this turn failed: ${error.message}`,
1368
+ }));
1369
+ const start = await withinMs(taken, Math.max(0, deadline - Date.now()));
1370
+ if (start === undefined)
1371
+ record.turnStart = late;
1372
+ else if (start)
1373
+ record.turnStart = { commandId, ...start };
1374
+ }
1375
+ /** The turn's checkpoint after it, and `turn.changes` between the two, once. */
1376
+ checkpointAfter(record, start) {
1377
+ let reported = false;
1378
+ const report = (changes) => {
1379
+ if (reported || this.sessions.get(record.info.id) !== record)
1380
+ return;
1381
+ reported = true;
1382
+ if (record.turnEnd === end)
1383
+ record.turnEnd = undefined;
1384
+ this.append(record, { type: 'turn.changes', commandId: start.commandId, changes });
1385
+ };
1386
+ const end = {
1387
+ done: Promise.resolve(),
1388
+ abandon: (reason) => report({ files: [], unavailable: reason }),
1389
+ };
1390
+ record.turnEnd = end;
1391
+ end.done = (async () => {
1392
+ try {
1393
+ const checkpoints = start.from && (await record.checkpoints);
1394
+ report(start.from && checkpoints
1395
+ ? await checkpoints.changes(start.from, await checkpoints.take())
1396
+ : { files: [], unavailable: start.unavailable ?? 'No checkpoint before this turn' });
1397
+ }
1398
+ catch (error) {
1399
+ report({
1400
+ files: [],
1401
+ unavailable: `The checkpoint after this turn failed: ${error.message}`,
1402
+ });
1403
+ }
1404
+ })();
1405
+ }
1406
+ /** Deletes the session's checkpoints; a failure is shown and the next close tries again. */
1407
+ async dropCheckpoints(record) {
1408
+ // A session that never took one (outside Git, read-only, no turn) has no index directory.
1409
+ if (!record.checkpoints && !existsSync(this.checkpointDirectory(record)))
1410
+ return;
1411
+ try {
1412
+ await (await this.checkpointsOf(record))?.remove();
1413
+ }
1414
+ catch (error) {
1415
+ this.append(record, {
1416
+ type: 'error',
1417
+ text: `This session's checkpoints were not deleted: ${error.message}. Close it again to retry.`,
1418
+ });
1419
+ }
1293
1420
  }
1294
1421
  }
1295
1422
  //# sourceMappingURL=manager.js.map