@vectorize-io/hindsight-coding-agents 0.3.0 → 0.3.2

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.
@@ -71,18 +71,32 @@ function gitProjectName(directory, resolveWorktrees) {
71
71
  }
72
72
  return dirName(directory);
73
73
  }
74
+ function configuredDir(dir) {
75
+ const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
76
+ return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
77
+ }
78
+ function isWithin(directory, configured) {
79
+ return directory === configured || directory.startsWith(configured + sep);
80
+ }
74
81
  function mapLookup(map, directory) {
75
82
  const cwd = normalize(directory);
76
83
  let best;
77
84
  for (const [dir, bank] of Object.entries(map)) {
78
- const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
79
- const p = normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
80
- if (cwd === p || cwd.startsWith(p + sep)) {
85
+ const p = configuredDir(dir);
86
+ if (isWithin(cwd, p)) {
81
87
  if (!best || p.length > best.len) best = { len: p.length, bank };
82
88
  }
83
89
  }
84
90
  return best?.bank;
85
91
  }
92
+ function isOptedIn(config, directory) {
93
+ if (!config.optInOnly) return true;
94
+ if (!directory) return false;
95
+ const cwd = normalize(directory);
96
+ if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
97
+ return true;
98
+ return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
99
+ }
86
100
  function deriveBankId(config, directory, harness = "coding") {
87
101
  const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
88
102
  if (mapped) return mapped;
@@ -134,6 +148,9 @@ function resolveConfig(raw = {}) {
134
148
  bankIdTemplate: raw.bankIdTemplate,
135
149
  mapPathToBank: raw.mapPathToBank,
136
150
  resolveWorktrees: raw.resolveWorktrees,
151
+ optInOnly: raw.optInOnly ?? false,
152
+ // Same shape as retainTags: a config typo must not become a path that silently approves nothing.
153
+ optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
137
154
  harness: raw.harness ?? "opencode",
138
155
  disabled: raw.disabled ?? false,
139
156
  retainSessions: raw.retainSessions ?? true,
@@ -194,6 +211,8 @@ var ENV_KEYS = {
194
211
  dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
195
212
  bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
196
213
  resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
214
+ optInOnly: "HINDSIGHT_OPT_IN_ONLY",
215
+ optInPaths: "HINDSIGHT_OPT_IN_PATHS",
197
216
  harness: "HINDSIGHT_HARNESS",
198
217
  disabled: "HINDSIGHT_DISABLED",
199
218
  retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
@@ -216,13 +235,14 @@ var ENV_KEYS = {
216
235
  var ENV_BOOLEANS = /* @__PURE__ */ new Set([
217
236
  "dynamicBankId",
218
237
  "resolveWorktrees",
238
+ "optInOnly",
219
239
  "disabled",
220
240
  "retainSessions",
221
241
  "autoReflect",
222
242
  "autoSeed",
223
243
  "codebaseSurvey"
224
244
  ]);
225
- var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
245
+ var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
226
246
  var ENV_NUMBERS = /* @__PURE__ */ new Set([
227
247
  "apiPort",
228
248
  "daemonIdleTimeout",
@@ -266,9 +286,15 @@ var BANK_OVERRIDE_EXCLUDED = [
266
286
  "mapPathToBank",
267
287
  "dynamicBankId",
268
288
  "resolveWorktrees",
289
+ // Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
290
+ // only ever arrive too late to matter — strip them rather than let them read as effective.
291
+ "optInOnly",
292
+ "optInPaths",
269
293
  "harness"
270
294
  ];
271
- function applyBankConfig(cfg, resolvedId) {
295
+ function applyBankConfig(cfg, resolvedId, directory) {
296
+ if (directory !== void 0 && !isOptedIn(cfg, directory))
297
+ return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
272
298
  const section = cfg.banks[resolvedId];
273
299
  if (!section) return { cfg, bankId: resolvedId };
274
300
  const safe = { ...section };
@@ -1062,10 +1088,10 @@ async function supportsAppend(client) {
1062
1088
  return false;
1063
1089
  }
1064
1090
  }
1091
+ var DEFAULT_RETRY_WINDOW_MS = 6e4;
1065
1092
  var RETAIN_RETRY_ATTEMPTS = 2;
1066
- var RETAIN_RETRY_BUDGET_MS = 6e3;
1067
- async function submitWithRetry(send, isStillNewest) {
1068
- let spent = 0;
1093
+ var REQUEST_BUDGET_MS = 15e3;
1094
+ async function submitWithRetry(send, isStillNewest, retryUntil) {
1069
1095
  for (let attempt = 0; ; attempt++) {
1070
1096
  try {
1071
1097
  return await send();
@@ -1073,8 +1099,7 @@ async function submitWithRetry(send, isStillNewest) {
1073
1099
  const limited = e instanceof RateLimitedError;
1074
1100
  if (!limited || attempt >= RETAIN_RETRY_ATTEMPTS || !isStillNewest()) throw e;
1075
1101
  const wait = e.retryAfterMs || 1e3;
1076
- if (wait > RETAIN_RETRY_BUDGET_MS - spent) throw e;
1077
- spent += wait;
1102
+ if (Date.now() + wait + REQUEST_BUDGET_MS > retryUntil) throw e;
1078
1103
  await sleep(wait);
1079
1104
  }
1080
1105
  }
@@ -1094,14 +1119,24 @@ function serialize(cursors, sessionId, write2) {
1094
1119
  }
1095
1120
  async function retainLiveSession(client, sessionId, turns, startTs, harness, opts = {}) {
1096
1121
  const cursors = opts.cursors;
1097
- if (!cursors) return writeSession(client, sessionId, turns, startTs, harness, opts.stamp);
1122
+ if (!cursors)
1123
+ return writeSession(
1124
+ client,
1125
+ sessionId,
1126
+ turns,
1127
+ startTs,
1128
+ harness,
1129
+ opts.stamp,
1130
+ void 0,
1131
+ opts.retryUntil
1132
+ );
1098
1133
  return serialize(
1099
1134
  cursors,
1100
1135
  sessionId,
1101
- () => writeSession(client, sessionId, turns, startTs, harness, opts.stamp, cursors)
1136
+ () => writeSession(client, sessionId, turns, startTs, harness, opts.stamp, cursors, opts.retryUntil)
1102
1137
  );
1103
1138
  }
1104
- async function writeSession(client, sessionId, turns, startTs, harness, stamp, cursors) {
1139
+ async function writeSession(client, sessionId, turns, startTs, harness, stamp, cursors, retryUntil = Date.now() + DEFAULT_RETRY_WINDOW_MS) {
1105
1140
  const refId = `conversation:${sessionId}`;
1106
1141
  const appendSupported = Boolean(cursors) && await supportsAppend(client);
1107
1142
  const plan = planRetain(turns, cursors?.read(sessionId), { appendSupported, bank: client.bank });
@@ -1153,7 +1188,8 @@ ${content}`),
1153
1188
  if (!cursors) return true;
1154
1189
  const now = cursors.read(sessionId);
1155
1190
  return now?.turns === claimed.turns && now?.fingerprint === claimed.fingerprint;
1156
- }
1191
+ },
1192
+ retryUntil
1157
1193
  );
1158
1194
  cursors?.write(sessionId, next);
1159
1195
  }
@@ -1469,6 +1505,7 @@ function readClaudeTranscript(path) {
1469
1505
  }
1470
1506
 
1471
1507
  // src/core/retain-hook.ts
1508
+ var HOST_DEADLINE_MARGIN_MS = 2e3;
1472
1509
  async function buildRetain(args) {
1473
1510
  const { harness, sessionId, transcriptPath, client } = args;
1474
1511
  const readTranscript = args.readTranscript ?? readClaudeTranscript;
@@ -1479,7 +1516,8 @@ async function buildRetain(args) {
1479
1516
  try {
1480
1517
  await retainLiveSession(client, sessionId, turns, startTs, harness, {
1481
1518
  cursors: args.cursors ?? fileCursorStore(harness),
1482
- stamp: args.stamp
1519
+ stamp: args.stamp,
1520
+ retryUntil: args.retryUntil
1483
1521
  });
1484
1522
  diag(harness, "retain_ok", { ms: Date.now() - t0, turns: turns.length, session: sessionId });
1485
1523
  } catch (e) {
@@ -1495,6 +1533,7 @@ async function buildRetain(args) {
1495
1533
  }
1496
1534
  async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
1497
1535
  if (process.env.HINDSIGHT_DISABLE_HOOKS) return;
1536
+ const hostDeadline = Date.now() + spec.hostTimeoutSec * 1e3 - HOST_DEADLINE_MARGIN_MS;
1498
1537
  let ev = {};
1499
1538
  try {
1500
1539
  ev = JSON.parse(readFileSync4(0, "utf8"));
@@ -1507,7 +1546,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
1507
1546
  setLogLevel(cfg.logLevel);
1508
1547
  if (cfg.disabled) return;
1509
1548
  if (!transcriptPath) return;
1510
- const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness));
1549
+ const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness), cwd);
1511
1550
  cfg = resolved.cfg;
1512
1551
  const bankId = resolved.bankId;
1513
1552
  if (cfg.disabled) return;
@@ -1524,6 +1563,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
1524
1563
  transcriptPath,
1525
1564
  client,
1526
1565
  readTranscript: spec.readTranscript,
1566
+ retryUntil: hostDeadline,
1527
1567
  stamp: buildRetainStamp(cfg, {
1528
1568
  directory: cwd,
1529
1569
  harness: spec.harness,
@@ -1895,6 +1935,7 @@ var HOOK_HARNESSES = {
1895
1935
  sessionStart: standardSessionStart("claude-code"),
1896
1936
  prompt: claudePrompt,
1897
1937
  retain: {
1938
+ hostTimeoutSec: 60,
1898
1939
  harness: "claude-code",
1899
1940
  parse: (ev) => ({
1900
1941
  sessionId: ev.session_id,
@@ -1913,6 +1954,7 @@ var HOOK_HARNESSES = {
1913
1954
  sessionStart: standardSessionStart("codex"),
1914
1955
  prompt: codexPrompt,
1915
1956
  retain: {
1957
+ hostTimeoutSec: 60,
1916
1958
  harness: "codex",
1917
1959
  parse: (ev) => ({
1918
1960
  sessionId: ev.session_id,
@@ -1941,6 +1983,7 @@ var HOOK_HARNESSES = {
1941
1983
  },
1942
1984
  prompt: antigravityPrompt,
1943
1985
  retain: {
1986
+ hostTimeoutSec: 30,
1944
1987
  harness: "antigravity-cli",
1945
1988
  parse: (ev) => ({
1946
1989
  sessionId: ev.conversationId,
@@ -1969,6 +2012,7 @@ var HOOK_HARNESSES = {
1969
2012
  },
1970
2013
  prompt: cursorPrompt,
1971
2014
  retain: {
2015
+ hostTimeoutSec: 30,
1972
2016
  harness: "cursor-cli",
1973
2017
  parse: (ev) => ({
1974
2018
  sessionId: ev.conversation_id ?? ev.session_id,
@@ -2002,6 +2046,7 @@ var HOOK_HARNESSES = {
2002
2046
  },
2003
2047
  prompt: copilotPrompt,
2004
2048
  retain: {
2049
+ hostTimeoutSec: 60,
2005
2050
  harness: "copilot-cli",
2006
2051
  parse: (ev) => ({
2007
2052
  sessionId: ev.sessionId,
@@ -2030,6 +2075,7 @@ var HOOK_HARNESSES = {
2030
2075
  },
2031
2076
  prompt: devinPrompt,
2032
2077
  retain: {
2078
+ hostTimeoutSec: 60,
2033
2079
  harness: "devin-cli",
2034
2080
  parse: (ev) => {
2035
2081
  const sessionId = ev.session_id;
@@ -2069,6 +2115,7 @@ var HOOK_HARNESSES = {
2069
2115
  })
2070
2116
  },
2071
2117
  retain: {
2118
+ hostTimeoutSec: 60,
2072
2119
  harness: "grok-build",
2073
2120
  parse: (ev) => ({
2074
2121
  sessionId: ev.sessionId,
@@ -68,18 +68,32 @@ function gitProjectName(directory, resolveWorktrees) {
68
68
  }
69
69
  return dirName(directory);
70
70
  }
71
+ function configuredDir(dir) {
72
+ const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
73
+ return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
74
+ }
75
+ function isWithin(directory, configured) {
76
+ return directory === configured || directory.startsWith(configured + sep);
77
+ }
71
78
  function mapLookup(map, directory) {
72
79
  const cwd = normalize(directory);
73
80
  let best;
74
81
  for (const [dir, bank] of Object.entries(map)) {
75
- const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
76
- const p = normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
77
- if (cwd === p || cwd.startsWith(p + sep)) {
82
+ const p = configuredDir(dir);
83
+ if (isWithin(cwd, p)) {
78
84
  if (!best || p.length > best.len) best = { len: p.length, bank };
79
85
  }
80
86
  }
81
87
  return best?.bank;
82
88
  }
89
+ function isOptedIn(config, directory) {
90
+ if (!config.optInOnly) return true;
91
+ if (!directory) return false;
92
+ const cwd = normalize(directory);
93
+ if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
94
+ return true;
95
+ return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
96
+ }
83
97
  function deriveBankId(config, directory, harness = "coding") {
84
98
  const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
85
99
  if (mapped) return mapped;
@@ -157,6 +171,9 @@ function resolveConfig(raw = {}) {
157
171
  bankIdTemplate: raw.bankIdTemplate,
158
172
  mapPathToBank: raw.mapPathToBank,
159
173
  resolveWorktrees: raw.resolveWorktrees,
174
+ optInOnly: raw.optInOnly ?? false,
175
+ // Same shape as retainTags: a config typo must not become a path that silently approves nothing.
176
+ optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
160
177
  harness: raw.harness ?? "opencode",
161
178
  disabled: raw.disabled ?? false,
162
179
  retainSessions: raw.retainSessions ?? true,
@@ -217,6 +234,8 @@ var ENV_KEYS = {
217
234
  dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
218
235
  bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
219
236
  resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
237
+ optInOnly: "HINDSIGHT_OPT_IN_ONLY",
238
+ optInPaths: "HINDSIGHT_OPT_IN_PATHS",
220
239
  harness: "HINDSIGHT_HARNESS",
221
240
  disabled: "HINDSIGHT_DISABLED",
222
241
  retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
@@ -239,13 +258,14 @@ var ENV_KEYS = {
239
258
  var ENV_BOOLEANS = /* @__PURE__ */ new Set([
240
259
  "dynamicBankId",
241
260
  "resolveWorktrees",
261
+ "optInOnly",
242
262
  "disabled",
243
263
  "retainSessions",
244
264
  "autoReflect",
245
265
  "autoSeed",
246
266
  "codebaseSurvey"
247
267
  ]);
248
- var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
268
+ var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
249
269
  var ENV_NUMBERS = /* @__PURE__ */ new Set([
250
270
  "apiPort",
251
271
  "daemonIdleTimeout",
@@ -289,9 +309,15 @@ var BANK_OVERRIDE_EXCLUDED = [
289
309
  "mapPathToBank",
290
310
  "dynamicBankId",
291
311
  "resolveWorktrees",
312
+ // Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
313
+ // only ever arrive too late to matter — strip them rather than let them read as effective.
314
+ "optInOnly",
315
+ "optInPaths",
292
316
  "harness"
293
317
  ];
294
- function applyBankConfig(cfg, resolvedId) {
318
+ function applyBankConfig(cfg, resolvedId, directory) {
319
+ if (directory !== void 0 && !isOptedIn(cfg, directory))
320
+ return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
295
321
  const section = cfg.banks[resolvedId];
296
322
  if (!section) return { cfg, bankId: resolvedId };
297
323
  const safe = { ...section };
@@ -1204,7 +1230,7 @@ async function runHook(spec, makeClient = (o) => new HindsightClient(o)) {
1204
1230
  return;
1205
1231
  }
1206
1232
  const out = (context, notice) => process.stdout.write(JSON.stringify(spec.emit(context ?? "", notice, ev)));
1207
- const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness));
1233
+ const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness), cwd);
1208
1234
  cfg = resolved.cfg;
1209
1235
  const bankId = resolved.bankId;
1210
1236
  if (cfg.disabled) {
@@ -1703,6 +1729,7 @@ var HOOK_HARNESSES = {
1703
1729
  sessionStart: standardSessionStart("claude-code"),
1704
1730
  prompt: claudePrompt,
1705
1731
  retain: {
1732
+ hostTimeoutSec: 60,
1706
1733
  harness: "claude-code",
1707
1734
  parse: (ev) => ({
1708
1735
  sessionId: ev.session_id,
@@ -1721,6 +1748,7 @@ var HOOK_HARNESSES = {
1721
1748
  sessionStart: standardSessionStart("codex"),
1722
1749
  prompt: codexPrompt,
1723
1750
  retain: {
1751
+ hostTimeoutSec: 60,
1724
1752
  harness: "codex",
1725
1753
  parse: (ev) => ({
1726
1754
  sessionId: ev.session_id,
@@ -1749,6 +1777,7 @@ var HOOK_HARNESSES = {
1749
1777
  },
1750
1778
  prompt: antigravityPrompt,
1751
1779
  retain: {
1780
+ hostTimeoutSec: 30,
1752
1781
  harness: "antigravity-cli",
1753
1782
  parse: (ev) => ({
1754
1783
  sessionId: ev.conversationId,
@@ -1777,6 +1806,7 @@ var HOOK_HARNESSES = {
1777
1806
  },
1778
1807
  prompt: cursorPrompt,
1779
1808
  retain: {
1809
+ hostTimeoutSec: 30,
1780
1810
  harness: "cursor-cli",
1781
1811
  parse: (ev) => ({
1782
1812
  sessionId: ev.conversation_id ?? ev.session_id,
@@ -1810,6 +1840,7 @@ var HOOK_HARNESSES = {
1810
1840
  },
1811
1841
  prompt: copilotPrompt,
1812
1842
  retain: {
1843
+ hostTimeoutSec: 60,
1813
1844
  harness: "copilot-cli",
1814
1845
  parse: (ev) => ({
1815
1846
  sessionId: ev.sessionId,
@@ -1838,6 +1869,7 @@ var HOOK_HARNESSES = {
1838
1869
  },
1839
1870
  prompt: devinPrompt,
1840
1871
  retain: {
1872
+ hostTimeoutSec: 60,
1841
1873
  harness: "devin-cli",
1842
1874
  parse: (ev) => {
1843
1875
  const sessionId = ev.session_id;
@@ -1877,6 +1909,7 @@ var HOOK_HARNESSES = {
1877
1909
  })
1878
1910
  },
1879
1911
  retain: {
1912
+ hostTimeoutSec: 60,
1880
1913
  harness: "grok-build",
1881
1914
  parse: (ev) => ({
1882
1915
  sessionId: ev.sessionId,
@@ -71,18 +71,32 @@ function gitProjectName(directory, resolveWorktrees) {
71
71
  }
72
72
  return dirName(directory);
73
73
  }
74
+ function configuredDir(dir) {
75
+ const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
76
+ return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
77
+ }
78
+ function isWithin(directory, configured) {
79
+ return directory === configured || directory.startsWith(configured + sep);
80
+ }
74
81
  function mapLookup(map, directory) {
75
82
  const cwd = normalize(directory);
76
83
  let best;
77
84
  for (const [dir, bank] of Object.entries(map)) {
78
- const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
79
- const p = normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
80
- if (cwd === p || cwd.startsWith(p + sep)) {
85
+ const p = configuredDir(dir);
86
+ if (isWithin(cwd, p)) {
81
87
  if (!best || p.length > best.len) best = { len: p.length, bank };
82
88
  }
83
89
  }
84
90
  return best?.bank;
85
91
  }
92
+ function isOptedIn(config, directory) {
93
+ if (!config.optInOnly) return true;
94
+ if (!directory) return false;
95
+ const cwd = normalize(directory);
96
+ if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
97
+ return true;
98
+ return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
99
+ }
86
100
  function deriveBankId(config, directory, harness = "coding") {
87
101
  const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
88
102
  if (mapped) return mapped;
@@ -160,6 +174,9 @@ function resolveConfig(raw = {}) {
160
174
  bankIdTemplate: raw.bankIdTemplate,
161
175
  mapPathToBank: raw.mapPathToBank,
162
176
  resolveWorktrees: raw.resolveWorktrees,
177
+ optInOnly: raw.optInOnly ?? false,
178
+ // Same shape as retainTags: a config typo must not become a path that silently approves nothing.
179
+ optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
163
180
  harness: raw.harness ?? "opencode",
164
181
  disabled: raw.disabled ?? false,
165
182
  retainSessions: raw.retainSessions ?? true,
@@ -220,6 +237,8 @@ var ENV_KEYS = {
220
237
  dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
221
238
  bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
222
239
  resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
240
+ optInOnly: "HINDSIGHT_OPT_IN_ONLY",
241
+ optInPaths: "HINDSIGHT_OPT_IN_PATHS",
223
242
  harness: "HINDSIGHT_HARNESS",
224
243
  disabled: "HINDSIGHT_DISABLED",
225
244
  retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
@@ -242,13 +261,14 @@ var ENV_KEYS = {
242
261
  var ENV_BOOLEANS = /* @__PURE__ */ new Set([
243
262
  "dynamicBankId",
244
263
  "resolveWorktrees",
264
+ "optInOnly",
245
265
  "disabled",
246
266
  "retainSessions",
247
267
  "autoReflect",
248
268
  "autoSeed",
249
269
  "codebaseSurvey"
250
270
  ]);
251
- var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
271
+ var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
252
272
  var ENV_NUMBERS = /* @__PURE__ */ new Set([
253
273
  "apiPort",
254
274
  "daemonIdleTimeout",
@@ -292,9 +312,15 @@ var BANK_OVERRIDE_EXCLUDED = [
292
312
  "mapPathToBank",
293
313
  "dynamicBankId",
294
314
  "resolveWorktrees",
315
+ // Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
316
+ // only ever arrive too late to matter — strip them rather than let them read as effective.
317
+ "optInOnly",
318
+ "optInPaths",
295
319
  "harness"
296
320
  ];
297
- function applyBankConfig(cfg, resolvedId) {
321
+ function applyBankConfig(cfg, resolvedId, directory) {
322
+ if (directory !== void 0 && !isOptedIn(cfg, directory))
323
+ return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
298
324
  const section = cfg.banks[resolvedId];
299
325
  if (!section) return { cfg, bankId: resolvedId };
300
326
  const safe = { ...section };
@@ -1759,7 +1785,7 @@ async function runSessionStartHook(spec, makeClient = (o) => new HindsightClient
1759
1785
  setLogLevel(cfg.logLevel);
1760
1786
  syncCompanionSkill(harness);
1761
1787
  if (cfg.disabled) return;
1762
- const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, harness));
1788
+ const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, harness), cwd);
1763
1789
  cfg = resolved.cfg;
1764
1790
  const bankId = resolved.bankId;
1765
1791
  if (cfg.disabled) return;
@@ -2121,6 +2147,7 @@ var HOOK_HARNESSES = {
2121
2147
  sessionStart: standardSessionStart("claude-code"),
2122
2148
  prompt: claudePrompt,
2123
2149
  retain: {
2150
+ hostTimeoutSec: 60,
2124
2151
  harness: "claude-code",
2125
2152
  parse: (ev) => ({
2126
2153
  sessionId: ev.session_id,
@@ -2139,6 +2166,7 @@ var HOOK_HARNESSES = {
2139
2166
  sessionStart: standardSessionStart("codex"),
2140
2167
  prompt: codexPrompt,
2141
2168
  retain: {
2169
+ hostTimeoutSec: 60,
2142
2170
  harness: "codex",
2143
2171
  parse: (ev) => ({
2144
2172
  sessionId: ev.session_id,
@@ -2167,6 +2195,7 @@ var HOOK_HARNESSES = {
2167
2195
  },
2168
2196
  prompt: antigravityPrompt,
2169
2197
  retain: {
2198
+ hostTimeoutSec: 30,
2170
2199
  harness: "antigravity-cli",
2171
2200
  parse: (ev) => ({
2172
2201
  sessionId: ev.conversationId,
@@ -2195,6 +2224,7 @@ var HOOK_HARNESSES = {
2195
2224
  },
2196
2225
  prompt: cursorPrompt,
2197
2226
  retain: {
2227
+ hostTimeoutSec: 30,
2198
2228
  harness: "cursor-cli",
2199
2229
  parse: (ev) => ({
2200
2230
  sessionId: ev.conversation_id ?? ev.session_id,
@@ -2228,6 +2258,7 @@ var HOOK_HARNESSES = {
2228
2258
  },
2229
2259
  prompt: copilotPrompt,
2230
2260
  retain: {
2261
+ hostTimeoutSec: 60,
2231
2262
  harness: "copilot-cli",
2232
2263
  parse: (ev) => ({
2233
2264
  sessionId: ev.sessionId,
@@ -2256,6 +2287,7 @@ var HOOK_HARNESSES = {
2256
2287
  },
2257
2288
  prompt: devinPrompt,
2258
2289
  retain: {
2290
+ hostTimeoutSec: 60,
2259
2291
  harness: "devin-cli",
2260
2292
  parse: (ev) => {
2261
2293
  const sessionId = ev.session_id;
@@ -2295,6 +2327,7 @@ var HOOK_HARNESSES = {
2295
2327
  })
2296
2328
  },
2297
2329
  retain: {
2330
+ hostTimeoutSec: 60,
2298
2331
  harness: "grok-build",
2299
2332
  parse: (ev) => ({
2300
2333
  sessionId: ev.sessionId,