@vectorize-io/hindsight-coding-agents 0.5.3 → 0.5.5
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/README.md +5 -2
- package/dist/antigravity-hook.js +185 -41
- package/dist/antigravity-stop-hook.js +114 -36
- package/dist/claude-hook.js +185 -41
- package/dist/claude-sessionstart-hook.js +292 -76
- package/dist/claude-stop-hook.js +114 -36
- package/dist/cline.js +331 -58
- package/dist/codex-hook.js +185 -41
- package/dist/codex-sessionstart-hook.js +292 -76
- package/dist/codex-stop-hook.js +114 -36
- package/dist/copilot-hook.js +185 -41
- package/dist/copilot-sessionstart-hook.js +292 -76
- package/dist/copilot-stop-hook.js +114 -36
- package/dist/cursor-hook.js +185 -41
- package/dist/cursor-sessionstart-hook.js +292 -76
- package/dist/cursor-stop-hook.js +114 -36
- package/dist/dcode-hook.js +185 -41
- package/dist/dcode-sessionstart-hook.js +292 -76
- package/dist/dcode-stop-hook.js +114 -36
- package/dist/deepen.js +93 -18
- package/dist/devin-hook.js +185 -41
- package/dist/devin-sessionstart-hook.js +292 -76
- package/dist/devin-stop-hook.js +114 -36
- package/dist/droid-hook.js +185 -41
- package/dist/droid-sessionstart-hook.js +292 -76
- package/dist/droid-stop-hook.js +114 -36
- package/dist/dsh.js +333 -60
- package/dist/grok-hook.js +185 -41
- package/dist/grok-sessionstart-hook.js +292 -76
- package/dist/grok-stop-hook.js +114 -36
- package/dist/index.js +333 -60
- package/dist/installer.js +1030 -268
- package/dist/kilo.js +333 -60
- package/dist/mcp-server.js +86 -11
- package/dist/opencode2.js +333 -60
- package/dist/pi.js +332 -59
- package/dist/prime-agent.js +332 -59
- package/dist/qwen-hook.js +185 -41
- package/dist/qwen-sessionstart-hook.js +292 -76
- package/dist/qwen-stop-hook.js +114 -36
- package/dist/status.js +84 -9
- package/dist/survey-supervisor.js +81 -0
- package/dist/zcode-hook.js +185 -41
- package/dist/zcode-sessionstart-hook.js +292 -76
- package/dist/zcode-stop-hook.js +114 -36
- package/package.json +2 -1
- package/plugin.json +1 -1
- package/skill/SKILL.md +5 -2
package/dist/qwen-stop-hook.js
CHANGED
|
@@ -629,6 +629,22 @@ var KnowledgePagesUnavailableError = class extends Error {
|
|
|
629
629
|
}
|
|
630
630
|
};
|
|
631
631
|
var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "cancelled", "error"]);
|
|
632
|
+
var ReflectError = class extends Error {
|
|
633
|
+
constructor(message, status, timedOut, options) {
|
|
634
|
+
super(message, options);
|
|
635
|
+
this.status = status;
|
|
636
|
+
this.timedOut = timedOut;
|
|
637
|
+
this.name = "ReflectError";
|
|
638
|
+
}
|
|
639
|
+
status;
|
|
640
|
+
timedOut;
|
|
641
|
+
/** A timeout or a 5xx means reflect's synthesis (the slow LLM path) broke, while the cheap
|
|
642
|
+
* retrieval endpoints may still answer — worth falling back. A 4xx will fail the same way on
|
|
643
|
+
* every endpoint (auth, missing bank), so it is not. */
|
|
644
|
+
get fallbackEligible() {
|
|
645
|
+
return this.timedOut || this.status !== void 0 && this.status >= 500;
|
|
646
|
+
}
|
|
647
|
+
};
|
|
632
648
|
var DEFAULT_MAX_PARALLEL_RETAINS = 10;
|
|
633
649
|
var POLL_CYCLE_MS = 5e3;
|
|
634
650
|
var RETRY_AFTER_FLOOR_MS = 10 * 1e3;
|
|
@@ -712,11 +728,11 @@ var HindsightClient = class {
|
|
|
712
728
|
return `${this.apiUrl}/v1/default/banks/${encodeURIComponent(this.bank)}${suffix}`;
|
|
713
729
|
}
|
|
714
730
|
/** `tolerate` adds statuses that are returned to the caller instead of thrown (404 always is). */
|
|
715
|
-
async req(method, url, body, tolerate = []) {
|
|
731
|
+
async req(method, url, body, tolerate = [], timeoutMs = 15e3) {
|
|
716
732
|
const r = await this.fetchWithAuth(url, {
|
|
717
733
|
method,
|
|
718
734
|
body: body ? JSON.stringify(body) : void 0,
|
|
719
|
-
signal: AbortSignal.timeout(
|
|
735
|
+
signal: AbortSignal.timeout(timeoutMs)
|
|
720
736
|
});
|
|
721
737
|
if (r.status === 429 && !tolerate.includes(429))
|
|
722
738
|
throw new RateLimitedError(retryAfterMs(r.headers.get("retry-after")));
|
|
@@ -909,7 +925,7 @@ var HindsightClient = class {
|
|
|
909
925
|
/**
|
|
910
926
|
* Reflect: synthesized, root-cause answer over the bank. Bounded so a slow server never hangs a
|
|
911
927
|
* caller — but `timeoutMs` is REQUIRED, deliberately: the right deadline differs by an order of
|
|
912
|
-
* magnitude between the automatic hook (
|
|
928
|
+
* magnitude between the automatic hook (20s, to fit the host's window) and the agent-invoked
|
|
913
929
|
* tool (minutes, on a populated bank). This used to default to 120s, which silently overrode the
|
|
914
930
|
* tool's configured window and aborted every high-budget synthesis mid-flight (#3590).
|
|
915
931
|
*/
|
|
@@ -922,13 +938,46 @@ var HindsightClient = class {
|
|
|
922
938
|
body: JSON.stringify({ query, budget: opts.budget ?? "high" }),
|
|
923
939
|
signal: ctrl.signal
|
|
924
940
|
});
|
|
925
|
-
if (!resp.ok)
|
|
941
|
+
if (!resp.ok)
|
|
942
|
+
throw new ReflectError(
|
|
943
|
+
`reflect ${resp.status} ${(await resp.text()).slice(0, 1e3)}${this.authHint(resp.status)}`,
|
|
944
|
+
resp.status,
|
|
945
|
+
false
|
|
946
|
+
);
|
|
926
947
|
const data = await resp.json();
|
|
927
948
|
return (data.text || "").trim();
|
|
949
|
+
} catch (e) {
|
|
950
|
+
if (ctrl.signal.aborted)
|
|
951
|
+
throw new ReflectError(`reflect timed out after ${opts.timeoutMs}ms`, void 0, true, {
|
|
952
|
+
cause: e
|
|
953
|
+
});
|
|
954
|
+
throw e;
|
|
928
955
|
} finally {
|
|
929
956
|
clearTimeout(timer);
|
|
930
957
|
}
|
|
931
958
|
}
|
|
959
|
+
/**
|
|
960
|
+
* Raw recall restricted to consolidated observations — no LLM in the loop, so it still answers
|
|
961
|
+
* when reflect's synthesis times out or 5xxs. Returns the observation texts in rank order.
|
|
962
|
+
*/
|
|
963
|
+
async recallObservations(query, opts) {
|
|
964
|
+
const r = await this.req(
|
|
965
|
+
"POST",
|
|
966
|
+
this.bankUrl("/memories/recall"),
|
|
967
|
+
{
|
|
968
|
+
query,
|
|
969
|
+
types: ["observation"],
|
|
970
|
+
budget: "low",
|
|
971
|
+
max_tokens: opts.maxTokens,
|
|
972
|
+
include: { entities: null }
|
|
973
|
+
},
|
|
974
|
+
[],
|
|
975
|
+
opts.timeoutMs
|
|
976
|
+
);
|
|
977
|
+
if (r.status === 404) return [];
|
|
978
|
+
const j = await r.json();
|
|
979
|
+
return (j.results ?? []).map((x) => (x.text ?? "").trim()).filter(Boolean);
|
|
980
|
+
}
|
|
932
981
|
/**
|
|
933
982
|
* The bank's knowledge-base tree (folders + pages, nested). The tree carries names, source
|
|
934
983
|
* queries and staleness but NOT synthesized content, so it is cheap enough to poll.
|
|
@@ -993,10 +1042,16 @@ var HindsightClient = class {
|
|
|
993
1042
|
/** Hybrid (BM25 + vector, RRF-fused) server-side search over the bank's knowledge pages.
|
|
994
1043
|
* Returns page-level hits with a relevance snippet — the real search behind
|
|
995
1044
|
* hindsight_search_knowledge_pages. */
|
|
996
|
-
async searchKnowledgePages(query, limit = 3) {
|
|
1045
|
+
async searchKnowledgePages(query, limit = 3, timeoutMs) {
|
|
997
1046
|
if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
|
|
998
1047
|
const q = `?q=${encodeURIComponent(query)}&limit=${limit}`;
|
|
999
|
-
const r = await this.req(
|
|
1048
|
+
const r = await this.req(
|
|
1049
|
+
"GET",
|
|
1050
|
+
this.bankUrl(`/knowledge-base/search${q}`),
|
|
1051
|
+
void 0,
|
|
1052
|
+
[],
|
|
1053
|
+
timeoutMs
|
|
1054
|
+
);
|
|
1000
1055
|
const j = await r.json();
|
|
1001
1056
|
return (j.results ?? []).map((x) => ({
|
|
1002
1057
|
id: x.id,
|
|
@@ -2173,7 +2228,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
|
2173
2228
|
}
|
|
2174
2229
|
|
|
2175
2230
|
// src/core/session-start.ts
|
|
2176
|
-
import { readFileSync as
|
|
2231
|
+
import { readFileSync as readFileSync10 } from "fs";
|
|
2177
2232
|
|
|
2178
2233
|
// src/core/git.ts
|
|
2179
2234
|
import { execFileSync as execFileSync2 } from "child_process";
|
|
@@ -2183,24 +2238,42 @@ import { resolve as resolve2 } from "path";
|
|
|
2183
2238
|
import { execFileSync as execFileSync3 } from "child_process";
|
|
2184
2239
|
|
|
2185
2240
|
// src/core/survey.ts
|
|
2186
|
-
import { spawn as
|
|
2241
|
+
import { spawn as realSpawn4 } from "child_process";
|
|
2242
|
+
import { createHash as createHash4 } from "crypto";
|
|
2187
2243
|
import { existsSync as existsSync3 } from "fs";
|
|
2188
|
-
import { homedir as homedir3 } from "os";
|
|
2189
|
-
import { dirname as dirname8, join as
|
|
2244
|
+
import { homedir as homedir3, tmpdir as tmpdir4 } from "os";
|
|
2245
|
+
import { dirname as dirname8, join as join11 } from "path";
|
|
2190
2246
|
import { fileURLToPath as fileURLToPath3 } from "url";
|
|
2191
2247
|
|
|
2248
|
+
// src/core/survey-lease.ts
|
|
2249
|
+
import { spawn as realSpawn3 } from "child_process";
|
|
2250
|
+
import { randomUUID } from "crypto";
|
|
2251
|
+
import {
|
|
2252
|
+
mkdirSync as mkdirSync4,
|
|
2253
|
+
mkdtempSync,
|
|
2254
|
+
readdirSync,
|
|
2255
|
+
renameSync as renameSync2,
|
|
2256
|
+
rmdirSync,
|
|
2257
|
+
rmSync as rmSync2,
|
|
2258
|
+
statSync as statSync3,
|
|
2259
|
+
unlinkSync,
|
|
2260
|
+
utimesSync,
|
|
2261
|
+
writeFileSync as writeFileSync2
|
|
2262
|
+
} from "fs";
|
|
2263
|
+
import { join as join10 } from "path";
|
|
2264
|
+
|
|
2192
2265
|
// src/core/auto-update.ts
|
|
2193
|
-
import { spawn as
|
|
2266
|
+
import { spawn as realSpawn5 } from "child_process";
|
|
2194
2267
|
import {
|
|
2195
2268
|
existsSync as existsSync4,
|
|
2196
|
-
mkdirSync as
|
|
2269
|
+
mkdirSync as mkdirSync5,
|
|
2197
2270
|
readFileSync as readFileSync7,
|
|
2198
2271
|
realpathSync as realpathSync2,
|
|
2199
|
-
unlinkSync,
|
|
2200
|
-
writeFileSync as
|
|
2272
|
+
unlinkSync as unlinkSync2,
|
|
2273
|
+
writeFileSync as writeFileSync3
|
|
2201
2274
|
} from "fs";
|
|
2202
|
-
import { homedir as homedir4, tmpdir as
|
|
2203
|
-
import { dirname as dirname9, join as
|
|
2275
|
+
import { homedir as homedir4, tmpdir as tmpdir5 } from "os";
|
|
2276
|
+
import { dirname as dirname9, join as join12 } from "path";
|
|
2204
2277
|
import { fileURLToPath as fileURLToPath4 } from "url";
|
|
2205
2278
|
var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
|
|
2206
2279
|
var LOCK_STALE_MS = 10 * 60 * 1e3;
|
|
@@ -2208,9 +2281,14 @@ var LOCK_STALE_MS = 10 * 60 * 1e3;
|
|
|
2208
2281
|
// src/core/skill-sync.ts
|
|
2209
2282
|
import { cpSync, existsSync as existsSync5, readFileSync as readFileSync8 } from "fs";
|
|
2210
2283
|
import { homedir as homedir5 } from "os";
|
|
2211
|
-
import { dirname as dirname10, join as
|
|
2284
|
+
import { dirname as dirname10, join as join13 } from "path";
|
|
2212
2285
|
import { fileURLToPath as fileURLToPath5 } from "url";
|
|
2213
2286
|
|
|
2287
|
+
// src/core/legacy.ts
|
|
2288
|
+
import { existsSync as existsSync6, readFileSync as readFileSync9 } from "fs";
|
|
2289
|
+
import { homedir as homedir6 } from "os";
|
|
2290
|
+
import { join as join14, relative, isAbsolute as isAbsolute2 } from "path";
|
|
2291
|
+
|
|
2214
2292
|
// src/core/transcript-codex.ts
|
|
2215
2293
|
function isSyntheticUserText(text) {
|
|
2216
2294
|
const s = text.trimStart();
|
|
@@ -2341,19 +2419,19 @@ function readCopilotTranscript(path) {
|
|
|
2341
2419
|
}
|
|
2342
2420
|
|
|
2343
2421
|
// src/core/transcript-grok.ts
|
|
2344
|
-
import { existsSync as
|
|
2345
|
-
import { homedir as
|
|
2346
|
-
import { join as
|
|
2422
|
+
import { existsSync as existsSync7, readFileSync as readFileSync11, readdirSync as readdirSync2 } from "fs";
|
|
2423
|
+
import { homedir as homedir7 } from "os";
|
|
2424
|
+
import { join as join15 } from "path";
|
|
2347
2425
|
var CHAT_HISTORY = "chat_history.jsonl";
|
|
2348
|
-
function grokTranscriptPath(cwd, sessionId, grokHome = process.env.GROK_HOME ||
|
|
2349
|
-
const sessionsDir =
|
|
2350
|
-
const direct =
|
|
2351
|
-
if (
|
|
2426
|
+
function grokTranscriptPath(cwd, sessionId, grokHome = process.env.GROK_HOME || join15(homedir7(), ".grok")) {
|
|
2427
|
+
const sessionsDir = join15(grokHome, "sessions");
|
|
2428
|
+
const direct = join15(sessionsDir, encodeURIComponent(cwd), sessionId, CHAT_HISTORY);
|
|
2429
|
+
if (existsSync7(direct)) return direct;
|
|
2352
2430
|
try {
|
|
2353
|
-
for (const candidate of
|
|
2354
|
-
const directory =
|
|
2355
|
-
if (
|
|
2356
|
-
return
|
|
2431
|
+
for (const candidate of readdirSync2(sessionsDir)) {
|
|
2432
|
+
const directory = join15(sessionsDir, candidate);
|
|
2433
|
+
if (readFileSync11(join15(directory, ".cwd"), "utf8").trim() === cwd) {
|
|
2434
|
+
return join15(directory, sessionId, CHAT_HISTORY);
|
|
2357
2435
|
}
|
|
2358
2436
|
}
|
|
2359
2437
|
} catch {
|
|
@@ -2388,12 +2466,12 @@ function readGrokTranscript(path) {
|
|
|
2388
2466
|
}
|
|
2389
2467
|
|
|
2390
2468
|
// src/core/transcript-devin.ts
|
|
2391
|
-
import { existsSync as
|
|
2469
|
+
import { existsSync as existsSync8 } from "fs";
|
|
2392
2470
|
import { createRequire } from "module";
|
|
2393
|
-
import { homedir as
|
|
2394
|
-
import { join as
|
|
2395
|
-
function devinSessionDb(home =
|
|
2396
|
-
return
|
|
2471
|
+
import { homedir as homedir8 } from "os";
|
|
2472
|
+
import { join as join16 } from "path";
|
|
2473
|
+
function devinSessionDb(home = homedir8()) {
|
|
2474
|
+
return join16(home, ".local", "share", "devin", "cli", "sessions.db");
|
|
2397
2475
|
}
|
|
2398
2476
|
function parseDevinMessages(nodes) {
|
|
2399
2477
|
const messages = /* @__PURE__ */ new Map();
|
|
@@ -2430,7 +2508,7 @@ function readDevinTranscript(sessionId, dbPath = devinSessionDb()) {
|
|
|
2430
2508
|
diag("devin-cli", "sqlite_unavailable", { node: process.version, dbPath });
|
|
2431
2509
|
return [];
|
|
2432
2510
|
}
|
|
2433
|
-
if (!
|
|
2511
|
+
if (!existsSync8(dbPath)) {
|
|
2434
2512
|
diag("devin-cli", "session_db_missing", { dbPath });
|
|
2435
2513
|
return [];
|
|
2436
2514
|
}
|
|
@@ -2703,7 +2781,7 @@ function readDroidTranscript(path) {
|
|
|
2703
2781
|
}
|
|
2704
2782
|
|
|
2705
2783
|
// src/core/transcript-zcode.ts
|
|
2706
|
-
import { readFileSync as
|
|
2784
|
+
import { readFileSync as readFileSync12 } from "fs";
|
|
2707
2785
|
function messageText2(content) {
|
|
2708
2786
|
if (typeof content === "string") return content.trim();
|
|
2709
2787
|
if (!Array.isArray(content)) return "";
|
|
@@ -2713,7 +2791,7 @@ function readZcodeTranscript(path) {
|
|
|
2713
2791
|
if (!path) return [];
|
|
2714
2792
|
let body;
|
|
2715
2793
|
try {
|
|
2716
|
-
body =
|
|
2794
|
+
body = readFileSync12(path, "utf8");
|
|
2717
2795
|
} catch {
|
|
2718
2796
|
return [];
|
|
2719
2797
|
}
|
package/dist/status.js
CHANGED
|
@@ -609,6 +609,22 @@ var KnowledgePagesUnavailableError = class extends Error {
|
|
|
609
609
|
}
|
|
610
610
|
};
|
|
611
611
|
var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "cancelled", "error"]);
|
|
612
|
+
var ReflectError = class extends Error {
|
|
613
|
+
constructor(message, status, timedOut, options) {
|
|
614
|
+
super(message, options);
|
|
615
|
+
this.status = status;
|
|
616
|
+
this.timedOut = timedOut;
|
|
617
|
+
this.name = "ReflectError";
|
|
618
|
+
}
|
|
619
|
+
status;
|
|
620
|
+
timedOut;
|
|
621
|
+
/** A timeout or a 5xx means reflect's synthesis (the slow LLM path) broke, while the cheap
|
|
622
|
+
* retrieval endpoints may still answer — worth falling back. A 4xx will fail the same way on
|
|
623
|
+
* every endpoint (auth, missing bank), so it is not. */
|
|
624
|
+
get fallbackEligible() {
|
|
625
|
+
return this.timedOut || this.status !== void 0 && this.status >= 500;
|
|
626
|
+
}
|
|
627
|
+
};
|
|
612
628
|
var DEFAULT_MAX_PARALLEL_RETAINS = 10;
|
|
613
629
|
var POLL_CYCLE_MS = 5e3;
|
|
614
630
|
var RETRY_AFTER_FLOOR_MS = 10 * 1e3;
|
|
@@ -692,11 +708,11 @@ var HindsightClient = class {
|
|
|
692
708
|
return `${this.apiUrl}/v1/default/banks/${encodeURIComponent(this.bank)}${suffix}`;
|
|
693
709
|
}
|
|
694
710
|
/** `tolerate` adds statuses that are returned to the caller instead of thrown (404 always is). */
|
|
695
|
-
async req(method, url, body, tolerate = []) {
|
|
711
|
+
async req(method, url, body, tolerate = [], timeoutMs = 15e3) {
|
|
696
712
|
const r = await this.fetchWithAuth(url, {
|
|
697
713
|
method,
|
|
698
714
|
body: body ? JSON.stringify(body) : void 0,
|
|
699
|
-
signal: AbortSignal.timeout(
|
|
715
|
+
signal: AbortSignal.timeout(timeoutMs)
|
|
700
716
|
});
|
|
701
717
|
if (r.status === 429 && !tolerate.includes(429))
|
|
702
718
|
throw new RateLimitedError(retryAfterMs(r.headers.get("retry-after")));
|
|
@@ -889,7 +905,7 @@ var HindsightClient = class {
|
|
|
889
905
|
/**
|
|
890
906
|
* Reflect: synthesized, root-cause answer over the bank. Bounded so a slow server never hangs a
|
|
891
907
|
* caller — but `timeoutMs` is REQUIRED, deliberately: the right deadline differs by an order of
|
|
892
|
-
* magnitude between the automatic hook (
|
|
908
|
+
* magnitude between the automatic hook (20s, to fit the host's window) and the agent-invoked
|
|
893
909
|
* tool (minutes, on a populated bank). This used to default to 120s, which silently overrode the
|
|
894
910
|
* tool's configured window and aborted every high-budget synthesis mid-flight (#3590).
|
|
895
911
|
*/
|
|
@@ -902,13 +918,46 @@ var HindsightClient = class {
|
|
|
902
918
|
body: JSON.stringify({ query, budget: opts.budget ?? "high" }),
|
|
903
919
|
signal: ctrl.signal
|
|
904
920
|
});
|
|
905
|
-
if (!resp.ok)
|
|
921
|
+
if (!resp.ok)
|
|
922
|
+
throw new ReflectError(
|
|
923
|
+
`reflect ${resp.status} ${(await resp.text()).slice(0, 1e3)}${this.authHint(resp.status)}`,
|
|
924
|
+
resp.status,
|
|
925
|
+
false
|
|
926
|
+
);
|
|
906
927
|
const data = await resp.json();
|
|
907
928
|
return (data.text || "").trim();
|
|
929
|
+
} catch (e) {
|
|
930
|
+
if (ctrl.signal.aborted)
|
|
931
|
+
throw new ReflectError(`reflect timed out after ${opts.timeoutMs}ms`, void 0, true, {
|
|
932
|
+
cause: e
|
|
933
|
+
});
|
|
934
|
+
throw e;
|
|
908
935
|
} finally {
|
|
909
936
|
clearTimeout(timer);
|
|
910
937
|
}
|
|
911
938
|
}
|
|
939
|
+
/**
|
|
940
|
+
* Raw recall restricted to consolidated observations — no LLM in the loop, so it still answers
|
|
941
|
+
* when reflect's synthesis times out or 5xxs. Returns the observation texts in rank order.
|
|
942
|
+
*/
|
|
943
|
+
async recallObservations(query, opts) {
|
|
944
|
+
const r = await this.req(
|
|
945
|
+
"POST",
|
|
946
|
+
this.bankUrl("/memories/recall"),
|
|
947
|
+
{
|
|
948
|
+
query,
|
|
949
|
+
types: ["observation"],
|
|
950
|
+
budget: "low",
|
|
951
|
+
max_tokens: opts.maxTokens,
|
|
952
|
+
include: { entities: null }
|
|
953
|
+
},
|
|
954
|
+
[],
|
|
955
|
+
opts.timeoutMs
|
|
956
|
+
);
|
|
957
|
+
if (r.status === 404) return [];
|
|
958
|
+
const j = await r.json();
|
|
959
|
+
return (j.results ?? []).map((x) => (x.text ?? "").trim()).filter(Boolean);
|
|
960
|
+
}
|
|
912
961
|
/**
|
|
913
962
|
* The bank's knowledge-base tree (folders + pages, nested). The tree carries names, source
|
|
914
963
|
* queries and staleness but NOT synthesized content, so it is cheap enough to poll.
|
|
@@ -973,10 +1022,16 @@ var HindsightClient = class {
|
|
|
973
1022
|
/** Hybrid (BM25 + vector, RRF-fused) server-side search over the bank's knowledge pages.
|
|
974
1023
|
* Returns page-level hits with a relevance snippet — the real search behind
|
|
975
1024
|
* hindsight_search_knowledge_pages. */
|
|
976
|
-
async searchKnowledgePages(query, limit = 3) {
|
|
1025
|
+
async searchKnowledgePages(query, limit = 3, timeoutMs) {
|
|
977
1026
|
if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
|
|
978
1027
|
const q = `?q=${encodeURIComponent(query)}&limit=${limit}`;
|
|
979
|
-
const r = await this.req(
|
|
1028
|
+
const r = await this.req(
|
|
1029
|
+
"GET",
|
|
1030
|
+
this.bankUrl(`/knowledge-base/search${q}`),
|
|
1031
|
+
void 0,
|
|
1032
|
+
[],
|
|
1033
|
+
timeoutMs
|
|
1034
|
+
);
|
|
980
1035
|
const j = await r.json();
|
|
981
1036
|
return (j.results ?? []).map((x) => ({
|
|
982
1037
|
id: x.id,
|
|
@@ -1458,11 +1513,31 @@ function parsePageList(raw) {
|
|
|
1458
1513
|
}
|
|
1459
1514
|
|
|
1460
1515
|
// src/core/survey.ts
|
|
1461
|
-
import { spawn as
|
|
1516
|
+
import { spawn as realSpawn3 } from "child_process";
|
|
1517
|
+
import { createHash as createHash2 } from "crypto";
|
|
1462
1518
|
import { existsSync as existsSync2 } from "fs";
|
|
1463
|
-
import { homedir as homedir3 } from "os";
|
|
1464
|
-
import { dirname as dirname5, join as
|
|
1519
|
+
import { homedir as homedir3, tmpdir as tmpdir2 } from "os";
|
|
1520
|
+
import { dirname as dirname5, join as join8 } from "path";
|
|
1465
1521
|
import { fileURLToPath as fileURLToPath2 } from "url";
|
|
1522
|
+
|
|
1523
|
+
// src/core/survey-lease.ts
|
|
1524
|
+
import { spawn as realSpawn2 } from "child_process";
|
|
1525
|
+
import { randomUUID } from "crypto";
|
|
1526
|
+
import {
|
|
1527
|
+
mkdirSync as mkdirSync2,
|
|
1528
|
+
mkdtempSync,
|
|
1529
|
+
readdirSync,
|
|
1530
|
+
renameSync,
|
|
1531
|
+
rmdirSync,
|
|
1532
|
+
rmSync,
|
|
1533
|
+
statSync,
|
|
1534
|
+
unlinkSync,
|
|
1535
|
+
utimesSync,
|
|
1536
|
+
writeFileSync
|
|
1537
|
+
} from "fs";
|
|
1538
|
+
import { join as join7 } from "path";
|
|
1539
|
+
|
|
1540
|
+
// src/core/survey.ts
|
|
1466
1541
|
var SURVEY_DOC_IDS = [
|
|
1467
1542
|
"repository-component-map",
|
|
1468
1543
|
"repository-core-concepts",
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// src/core/survey-lease.ts
|
|
4
|
+
import { spawn as realSpawn } from "child_process";
|
|
5
|
+
import { randomUUID } from "crypto";
|
|
6
|
+
import {
|
|
7
|
+
mkdirSync,
|
|
8
|
+
mkdtempSync,
|
|
9
|
+
readdirSync,
|
|
10
|
+
renameSync,
|
|
11
|
+
rmdirSync,
|
|
12
|
+
rmSync,
|
|
13
|
+
statSync,
|
|
14
|
+
unlinkSync,
|
|
15
|
+
utimesSync,
|
|
16
|
+
writeFileSync
|
|
17
|
+
} from "fs";
|
|
18
|
+
import { join } from "path";
|
|
19
|
+
var LEASE_HEARTBEAT_MS = 5e3;
|
|
20
|
+
var SURVEY_SPEC_ENV = "HINDSIGHT_SURVEY_SPEC";
|
|
21
|
+
function releaseLease(lease) {
|
|
22
|
+
try {
|
|
23
|
+
unlinkSync(join(lease.directory, lease.owner));
|
|
24
|
+
} catch {
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
try {
|
|
28
|
+
rmdirSync(lease.directory);
|
|
29
|
+
} catch {
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
function heartbeatLease(lease) {
|
|
33
|
+
try {
|
|
34
|
+
const now = /* @__PURE__ */ new Date();
|
|
35
|
+
utimesSync(join(lease.directory, lease.owner), now, now);
|
|
36
|
+
return true;
|
|
37
|
+
} catch (error) {
|
|
38
|
+
return error.code !== "ENOENT";
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
function superviseSurvey(spec2, spawnFn = realSpawn) {
|
|
42
|
+
let stop = () => {
|
|
43
|
+
};
|
|
44
|
+
const done = new Promise((resolve) => {
|
|
45
|
+
if (!heartbeatLease(spec2.lease)) return resolve();
|
|
46
|
+
let child;
|
|
47
|
+
try {
|
|
48
|
+
child = spawnFn(spec2.bin, spec2.args, { stdio: "ignore", windowsHide: true });
|
|
49
|
+
} catch {
|
|
50
|
+
releaseLease(spec2.lease);
|
|
51
|
+
return resolve();
|
|
52
|
+
}
|
|
53
|
+
let finished = false;
|
|
54
|
+
const finish = (release) => {
|
|
55
|
+
if (finished) return;
|
|
56
|
+
finished = true;
|
|
57
|
+
clearInterval(timer);
|
|
58
|
+
if (release) releaseLease(spec2.lease);
|
|
59
|
+
resolve();
|
|
60
|
+
};
|
|
61
|
+
const timer = setInterval(() => {
|
|
62
|
+
if (heartbeatLease(spec2.lease)) return;
|
|
63
|
+
child.kill();
|
|
64
|
+
finish(false);
|
|
65
|
+
}, spec2.heartbeatMs ?? LEASE_HEARTBEAT_MS);
|
|
66
|
+
child.on("error", () => finish(true));
|
|
67
|
+
child.once("exit", () => finish(true));
|
|
68
|
+
stop = () => {
|
|
69
|
+
child.kill();
|
|
70
|
+
finish(true);
|
|
71
|
+
};
|
|
72
|
+
});
|
|
73
|
+
return { done, stop: () => stop() };
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
// src/survey-supervisor.ts
|
|
77
|
+
var spec = JSON.parse(process.env[SURVEY_SPEC_ENV] ?? "");
|
|
78
|
+
delete process.env[SURVEY_SPEC_ENV];
|
|
79
|
+
var run = superviseSurvey(spec);
|
|
80
|
+
for (const signal of ["SIGTERM", "SIGINT", "SIGHUP"]) process.once(signal, run.stop);
|
|
81
|
+
void run.done;
|