@vectorize-io/hindsight-coding-agents 0.5.1 → 0.5.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.
- package/README.md +44 -3
- package/dist/antigravity-hook.js +142 -9
- package/dist/antigravity-statusline.js +42 -4
- package/dist/antigravity-stop-hook.js +222 -59
- package/dist/claude-hook.js +142 -9
- package/dist/claude-sessionstart-hook.js +144 -9
- package/dist/claude-stop-hook.js +222 -59
- package/dist/cline.js +148 -59
- package/dist/codex-hook.js +142 -9
- package/dist/codex-sessionstart-hook.js +144 -9
- package/dist/codex-stop-hook.js +222 -59
- package/dist/copilot-hook.js +142 -9
- package/dist/copilot-sessionstart-hook.js +144 -9
- package/dist/copilot-stop-hook.js +222 -59
- package/dist/cursor-hook.js +142 -9
- package/dist/cursor-sessionstart-hook.js +144 -9
- package/dist/cursor-stop-hook.js +222 -59
- package/dist/daemon-start.js +36 -2
- package/dist/dcode-hook.js +142 -9
- package/dist/dcode-sessionstart-hook.js +144 -9
- package/dist/dcode-stop-hook.js +222 -59
- package/dist/deepen.js +97 -14
- package/dist/devin-hook.js +142 -9
- package/dist/devin-sessionstart-hook.js +144 -9
- package/dist/devin-stop-hook.js +222 -59
- package/dist/droid-hook.js +2710 -0
- package/dist/droid-sessionstart-hook.js +3328 -0
- package/dist/droid-stop-hook.js +2970 -0
- package/dist/dsh.js +153 -60
- package/dist/grok-hook.js +142 -9
- package/dist/grok-sessionstart-hook.js +144 -9
- package/dist/grok-stop-hook.js +222 -59
- package/dist/hindsight-seed.js +42 -4
- package/dist/index.js +148 -59
- package/dist/installer.js +155 -13
- package/dist/kilo.js +148 -59
- package/dist/mcp-server.js +474 -133
- package/dist/opencode2.js +148 -59
- package/dist/pi.js +148 -59
- package/dist/prime-agent.js +148 -59
- package/dist/qwen-hook.js +142 -9
- package/dist/qwen-sessionstart-hook.js +144 -9
- package/dist/qwen-stop-hook.js +222 -59
- package/dist/status.js +65 -7
- package/package.json +6 -3
- package/plugin.json +1 -1
- package/skill/SKILL.md +26 -2
package/dist/kilo.js
CHANGED
|
@@ -332,9 +332,13 @@ function isOptedIn(config3, directory) {
|
|
|
332
332
|
const pathMap = config3.mapPathToBank;
|
|
333
333
|
return Boolean(pathMap && directories.some((candidate) => mapLookup(pathMap, candidate)));
|
|
334
334
|
}
|
|
335
|
-
function
|
|
335
|
+
function mappedBank(config3, directory, sessionRoot) {
|
|
336
336
|
const pathMap = config3.mapPathToBank;
|
|
337
|
-
|
|
337
|
+
if (!directory || !pathMap) return void 0;
|
|
338
|
+
return lookupDirectories(config3, directory, sessionRoot).map((candidate) => mapLookup(pathMap, candidate)).find((bank) => bank !== void 0);
|
|
339
|
+
}
|
|
340
|
+
function deriveBankId(config3, directory, harness = "coding", sessionRoot) {
|
|
341
|
+
const mapped = mappedBank(config3, directory, sessionRoot);
|
|
338
342
|
if (mapped) return mapped;
|
|
339
343
|
const dynamic = config3.dynamicBankId ?? !config3.bankId;
|
|
340
344
|
if (!dynamic) return config3.bankId || DEFAULT_BANK_NAME;
|
|
@@ -362,6 +366,7 @@ function deriveBankIdOrSkip(config3, directory, harness = "coding", sessionRoot)
|
|
|
362
366
|
}
|
|
363
367
|
|
|
364
368
|
// src/core/missions.ts
|
|
369
|
+
import { createHash } from "crypto";
|
|
365
370
|
var GIT_MISSION = "You are ingesting a single git commit: its message and its full diff. Extract the concrete technical DECISION and the CAUSE/INVARIANT it encodes, bound to the specific code entities (functions, methods, files) and behaviors it changes. Preserve exact identifiers, paths, and literal values verbatim. Preserve the 'REF-ID: <token>' marker verbatim in every fact. Capture both WHAT changed and WHY. Issue/PR references (#123, GH-123, PROJ-123) are load-bearing: keep them VERBATIM in the fact text and emit each as an ENTITY, so a later question about that issue or PR retrieves this decision.";
|
|
366
371
|
var GITLOG_MISSION = "You are ingesting an aggregated block of git commit MESSAGES ONLY (no diffs) \u2014 the project's recent commit-message history, newest first. Extract the project's INITIATIVES, FEATURES, ENHANCEMENTS, and notable changes or THEMES over time \u2014 what the project has been working on and how it has evolved. Do NOT extract per-line code detail (there is no diff to draw it from). Group related commits into a coherent initiative/theme where the messages make that clear; preserve exact identifiers and literal values verbatim when quoting a subject line. Keep issue/PR references (#123, GH-123) VERBATIM and emit each as an ENTITY \u2014 they are how future sessions will ask about this work.";
|
|
367
372
|
var CONVERSATION_MISSION = `You are ingesting a developer conversation as a JSONL transcript (one {role, content} turn per line): the user's requests, the assistant's narration, and compact 'action' turns naming each tool use and its target (e.g. "Edit boltons/strutils.py") with no arguments or outputs. It may be a SHORT decision chat or a LONG working session \u2014 scale the facts to the substance, never to the message count. Extract the FEWEST facts that capture the OUTCOME: the settled DECISIONS and their exact rules/values (quote literals VERBATIM); concrete CHANGES to specific code entities; problems and how they were resolved; conventions or invariants established; at most one fact for a notable REJECTED alternative ('initially proposed X, changed to Y because Z'). A short decision chat usually yields 1-2 facts; a substantial working session several. CRITICAL: a conversation REVISES itself \u2014 record ONLY the FINAL state as what is in effect; a superseded proposal appears ONLY inside the rejected fact, NEVER as its own 'decided' fact; if the same setting changes several times keep only the LAST, and make unmistakably clear which choice WON. Do NOT emit one fact per message, per intermediate proposal, or per action turn. Keep issue/PR references (#123, GH-123) VERBATIM and emit each as an ENTITY. Preserve the 'REF-ID: <token>' marker verbatim in every fact. Do not invent; capture only what was actually settled.`;
|
|
@@ -473,6 +478,56 @@ function pagesFor(project) {
|
|
|
473
478
|
var PAGE_MAX_TOKENS = 4096;
|
|
474
479
|
var PAGE_TAGS_MATCH = "all";
|
|
475
480
|
var PAGE_FACT_TYPES = ["world", "experience", "observation"];
|
|
481
|
+
var CRON_FIELD_RANGES = [
|
|
482
|
+
[0, 59],
|
|
483
|
+
// minute
|
|
484
|
+
[0, 23],
|
|
485
|
+
// hour
|
|
486
|
+
[1, 31],
|
|
487
|
+
// day of month
|
|
488
|
+
[1, 12],
|
|
489
|
+
// month
|
|
490
|
+
[0, 6]
|
|
491
|
+
// day of week
|
|
492
|
+
];
|
|
493
|
+
var HASHED_FIELD = /^H(?:\((\d+)-(\d+)\))?$/;
|
|
494
|
+
function isHashedCron(cron) {
|
|
495
|
+
return /(^|\s)H/.test(cron);
|
|
496
|
+
}
|
|
497
|
+
function parseHashedCron(cron) {
|
|
498
|
+
const fields = cron.trim().split(/\s+/);
|
|
499
|
+
if (fields.length !== CRON_FIELD_RANGES.length) return void 0;
|
|
500
|
+
for (const [i, field] of fields.entries()) {
|
|
501
|
+
if (!field.startsWith("H")) continue;
|
|
502
|
+
const m = HASHED_FIELD.exec(field);
|
|
503
|
+
if (!m) return void 0;
|
|
504
|
+
if (m[1] === void 0) continue;
|
|
505
|
+
const [lo, hi] = [Number(m[1]), Number(m[2])];
|
|
506
|
+
const [min, max] = CRON_FIELD_RANGES[i];
|
|
507
|
+
if (lo > hi || lo < min || hi > max) return void 0;
|
|
508
|
+
}
|
|
509
|
+
return fields;
|
|
510
|
+
}
|
|
511
|
+
function hashedValue(seed, field, lo, hi) {
|
|
512
|
+
const digest = createHash("sha256").update(`${seed}\0${field}`).digest();
|
|
513
|
+
return lo + digest.readUInt32BE(0) % (hi - lo + 1);
|
|
514
|
+
}
|
|
515
|
+
function expandCronHash(cron, seed) {
|
|
516
|
+
if (!isHashedCron(cron)) return cron;
|
|
517
|
+
const fields = parseHashedCron(cron);
|
|
518
|
+
if (!fields) return cron;
|
|
519
|
+
return fields.map((field, i) => {
|
|
520
|
+
const m = HASHED_FIELD.exec(field);
|
|
521
|
+
if (!m) return field;
|
|
522
|
+
const [lo, hi] = m[1] === void 0 ? CRON_FIELD_RANGES[i] : [Number(m[1]), Number(m[2])];
|
|
523
|
+
return String(hashedValue(seed, i, lo, hi));
|
|
524
|
+
}).join(" ");
|
|
525
|
+
}
|
|
526
|
+
function pageTriggerFor(trigger, bank, page) {
|
|
527
|
+
const cron = trigger.refresh_cron;
|
|
528
|
+
if (!cron || !isHashedCron(cron)) return trigger;
|
|
529
|
+
return { ...trigger, refresh_cron: expandCronHash(cron, `${bank}\0${page}`) };
|
|
530
|
+
}
|
|
476
531
|
function buildPageTrigger(cfg = {}) {
|
|
477
532
|
const base = { fact_types: PAGE_FACT_TYPES, tags_match: PAGE_TAGS_MATCH };
|
|
478
533
|
switch (cfg.pageTriggerType) {
|
|
@@ -1026,7 +1081,9 @@ var HindsightClient = class {
|
|
|
1026
1081
|
source_query: page.source_query,
|
|
1027
1082
|
tags: page.tags,
|
|
1028
1083
|
max_tokens: PAGE_MAX_TOKENS,
|
|
1029
|
-
|
|
1084
|
+
// Resolved HERE, not in `buildPageTrigger`: a hashed cron (`H`) needs the page's identity,
|
|
1085
|
+
// and one trigger is built per session for all of them.
|
|
1086
|
+
trigger: pageTriggerFor(pageTrigger, this.bank, page.name)
|
|
1030
1087
|
};
|
|
1031
1088
|
if (!hit) {
|
|
1032
1089
|
const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), body, [409]);
|
|
@@ -1064,7 +1121,7 @@ var HindsightClient = class {
|
|
|
1064
1121
|
}
|
|
1065
1122
|
}
|
|
1066
1123
|
this.log(
|
|
1067
|
-
`[bank] knowledge pages seeded on ${this.bank}: ${created} created, ${updated} re-synced, ${pages.length - created - updated} unchanged`
|
|
1124
|
+
`[bank] knowledge pages seeded on ${this.bank} (scoped to ${this.project ?? this.bank}): ${created} created, ${updated} re-synced, ${pages.length - created - updated} unchanged`
|
|
1068
1125
|
);
|
|
1069
1126
|
}
|
|
1070
1127
|
/** URL/id-safe slug: lowercase, non-alphanumerics → "-", trim dashes, cap length; fallback "initiative". */
|
|
@@ -1093,7 +1150,7 @@ var HindsightClient = class {
|
|
|
1093
1150
|
source_query: `Summarize the "${args.title}" initiative: what is being built or changed and why, and its current state \u2014 drawn from the project's memory.`,
|
|
1094
1151
|
parent_id: folderId,
|
|
1095
1152
|
tags: ["knowledge:feature-work"],
|
|
1096
|
-
trigger: args.pageTrigger ?? buildPageTrigger()
|
|
1153
|
+
trigger: pageTriggerFor(args.pageTrigger ?? buildPageTrigger(), this.bank, args.title)
|
|
1097
1154
|
});
|
|
1098
1155
|
try {
|
|
1099
1156
|
const j = await r.json();
|
|
@@ -1138,10 +1195,11 @@ var DEFAULT_DAEMON_PROFILE = "coding-agent";
|
|
|
1138
1195
|
function resolvePageTriggerType(raw) {
|
|
1139
1196
|
if (raw.pageTriggerType === "manual") return "manual";
|
|
1140
1197
|
if (raw.pageTriggerType === "cron") {
|
|
1141
|
-
|
|
1198
|
+
const cron = raw.pageTriggerCron?.trim();
|
|
1199
|
+
if (cron && (!isHashedCron(cron) || parseHashedCron(cron))) return "cron";
|
|
1142
1200
|
log.warn(
|
|
1143
1201
|
"config",
|
|
1144
|
-
'pageTriggerType "cron" needs pageTriggerCron (UTC 5-field, e.g. "
|
|
1202
|
+
cron ? `pageTriggerCron ${JSON.stringify(cron)} has a malformed hashed field \u2014 write \`H\` or \`H(<lo>-<hi>)\` within the field's own range, e.g. "H H(0-5) * * *" \u2014 falling back to "auto-refresh"` : 'pageTriggerType "cron" needs pageTriggerCron (UTC 5-field, e.g. "H H * * *") \u2014 falling back to "auto-refresh"'
|
|
1145
1203
|
);
|
|
1146
1204
|
}
|
|
1147
1205
|
return "auto-refresh";
|
|
@@ -16759,15 +16817,24 @@ function buildKnowledgeTools(client, bankId, opts = {}) {
|
|
|
16759
16817
|
}
|
|
16760
16818
|
|
|
16761
16819
|
// src/core/retain-cursor.ts
|
|
16762
|
-
import { createHash } from "crypto";
|
|
16820
|
+
import { createHash as createHash2 } from "crypto";
|
|
16821
|
+
var PENDING_MAX_AGE_MS = 12 * 60 * 60 * 1e3;
|
|
16822
|
+
var PENDING_MAX_BYTES = 256 * 1024;
|
|
16823
|
+
function pendingReplayable(cursor, now) {
|
|
16824
|
+
const pending = cursor.pending ?? [];
|
|
16825
|
+
if (!pending.length) return true;
|
|
16826
|
+
if (pending.some((p) => now - p.at > PENDING_MAX_AGE_MS)) return false;
|
|
16827
|
+
return pending.reduce((n, p) => n + p.content.length, 0) <= PENDING_MAX_BYTES;
|
|
16828
|
+
}
|
|
16763
16829
|
function fingerprintTurns(turns, count) {
|
|
16764
|
-
const h =
|
|
16830
|
+
const h = createHash2("sha1").update(String(count));
|
|
16765
16831
|
for (let i = 0; i < count; i++) h.update("\n" + JSON.stringify(turns[i]));
|
|
16766
16832
|
return h.digest("hex");
|
|
16767
16833
|
}
|
|
16768
16834
|
function planRetain(turns, cursor, opts) {
|
|
16769
16835
|
if (!turns.length) return { mode: "skip" };
|
|
16770
16836
|
if (!opts.appendSupported || !cursor || cursor.dirty) return { mode: "replace" };
|
|
16837
|
+
if (!pendingReplayable(cursor, opts.now ?? Date.now())) return { mode: "replace" };
|
|
16771
16838
|
if (cursor.bank !== opts.bank) return { mode: "replace" };
|
|
16772
16839
|
if (cursor.turns > turns.length) return { mode: "replace" };
|
|
16773
16840
|
if (fingerprintTurns(turns, cursor.turns) !== cursor.fingerprint) return { mode: "replace" };
|
|
@@ -16783,13 +16850,13 @@ function memoryCursorStore() {
|
|
|
16783
16850
|
}
|
|
16784
16851
|
|
|
16785
16852
|
// src/core/uuid.ts
|
|
16786
|
-
import { createHash as
|
|
16853
|
+
import { createHash as createHash3 } from "crypto";
|
|
16787
16854
|
var HINDSIGHT_NAMESPACE = "e75686a4-e923-4326-a0d1-358f1c6c3eb4";
|
|
16788
16855
|
function uuidV5(name, namespace = HINDSIGHT_NAMESPACE) {
|
|
16789
16856
|
const ns = Buffer.from(namespace.replace(/-/g, ""), "hex");
|
|
16790
16857
|
if (ns.length !== 16) throw new Error(`invalid UUID namespace: ${namespace}`);
|
|
16791
16858
|
const bytes = Buffer.from(
|
|
16792
|
-
|
|
16859
|
+
createHash3("sha1").update(ns).update(Buffer.from(name, "utf8")).digest().subarray(0, 16)
|
|
16793
16860
|
);
|
|
16794
16861
|
bytes[6] = bytes[6] & 15 | 80;
|
|
16795
16862
|
bytes[8] = bytes[8] & 63 | 128;
|
|
@@ -16866,61 +16933,83 @@ async function retainLiveSession(client, sessionId, turns, startTs, harness, opt
|
|
|
16866
16933
|
);
|
|
16867
16934
|
}
|
|
16868
16935
|
async function writeSession(client, sessionId, turns, startTs, harness, stamp, cursors, retryUntil = Date.now() + DEFAULT_RETRY_WINDOW_MS) {
|
|
16936
|
+
if (!turns.length) return;
|
|
16869
16937
|
const refId = `conversation:${sessionId}`;
|
|
16870
16938
|
const appendSupported = Boolean(cursors) && await supportsAppend(client);
|
|
16871
|
-
const
|
|
16872
|
-
|
|
16873
|
-
const
|
|
16939
|
+
const cursor = cursors?.read(sessionId);
|
|
16940
|
+
const plan = planRetain(turns, cursor, { appendSupported, bank: client.bank });
|
|
16941
|
+
const outbox = plan.mode === "replace" ? [] : cursor?.pending ?? [];
|
|
16942
|
+
if (plan.mode === "skip" && !outbox.length) return;
|
|
16943
|
+
const opId = (mode, content) => uuidV5(`${client.bank}
|
|
16944
|
+
${refId}
|
|
16945
|
+
${mode}
|
|
16946
|
+
${content}`);
|
|
16947
|
+
const submit = (content, operationId, append) => client.retain(
|
|
16948
|
+
content,
|
|
16949
|
+
"coding agent session",
|
|
16950
|
+
refId,
|
|
16951
|
+
// Configured tags first, built-ins last and deduped: `source:chat` and `harness:<id>` are what
|
|
16952
|
+
// the documents list filters and draws its agent logo from, so a template cannot displace them.
|
|
16953
|
+
[
|
|
16954
|
+
.../* @__PURE__ */ new Set([
|
|
16955
|
+
...stamp?.tags ?? [],
|
|
16956
|
+
"source:chat",
|
|
16957
|
+
...harness ? [`harness:${harness}`] : []
|
|
16958
|
+
])
|
|
16959
|
+
],
|
|
16960
|
+
"conversation",
|
|
16961
|
+
{
|
|
16962
|
+
timestamp: startTs,
|
|
16963
|
+
updateMode: append ? "append" : void 0,
|
|
16964
|
+
operationId,
|
|
16965
|
+
metadata: {
|
|
16966
|
+
...stamp?.metadata,
|
|
16967
|
+
// configured first: the built-ins below win on any key collision
|
|
16968
|
+
source: "chat",
|
|
16969
|
+
session_id: sessionId,
|
|
16970
|
+
ref_id: refId,
|
|
16971
|
+
...harness ? { harness } : {}
|
|
16972
|
+
}
|
|
16973
|
+
}
|
|
16974
|
+
);
|
|
16874
16975
|
const next = {
|
|
16875
16976
|
turns: turns.length,
|
|
16876
16977
|
fingerprint: fingerprintTurns(turns, turns.length),
|
|
16877
16978
|
bank: client.bank
|
|
16878
16979
|
};
|
|
16879
|
-
|
|
16880
|
-
|
|
16881
|
-
|
|
16882
|
-
|
|
16883
|
-
|
|
16884
|
-
|
|
16885
|
-
|
|
16886
|
-
|
|
16887
|
-
|
|
16888
|
-
|
|
16889
|
-
|
|
16890
|
-
|
|
16891
|
-
|
|
16892
|
-
|
|
16893
|
-
|
|
16894
|
-
|
|
16895
|
-
|
|
16896
|
-
|
|
16897
|
-
|
|
16898
|
-
|
|
16899
|
-
|
|
16900
|
-
|
|
16901
|
-
|
|
16902
|
-
|
|
16903
|
-
|
|
16904
|
-
|
|
16905
|
-
|
|
16906
|
-
|
|
16907
|
-
|
|
16908
|
-
|
|
16909
|
-
|
|
16910
|
-
|
|
16911
|
-
|
|
16912
|
-
}
|
|
16913
|
-
}
|
|
16914
|
-
),
|
|
16915
|
-
// Still ours to retry only while the cursor holds the claim we wrote above.
|
|
16916
|
-
() => {
|
|
16917
|
-
if (!cursors) return true;
|
|
16918
|
-
const now = cursors.read(sessionId);
|
|
16919
|
-
return now?.turns === claimed.turns && now?.fingerprint === claimed.fingerprint;
|
|
16920
|
-
},
|
|
16921
|
-
retryUntil
|
|
16922
|
-
);
|
|
16923
|
-
cursors?.write(sessionId, next);
|
|
16980
|
+
const stillOurs = () => {
|
|
16981
|
+
if (!cursors) return true;
|
|
16982
|
+
const now = cursors.read(sessionId);
|
|
16983
|
+
return now?.turns === next.turns && now?.fingerprint === next.fingerprint;
|
|
16984
|
+
};
|
|
16985
|
+
if (plan.mode === "replace") {
|
|
16986
|
+
const content = renderSessionJsonl(refId, turns, startTs);
|
|
16987
|
+
cursors?.write(sessionId, { ...next, dirty: true });
|
|
16988
|
+
await submitWithRetry(
|
|
16989
|
+
() => submit(content, opId("replace", content), false),
|
|
16990
|
+
stillOurs,
|
|
16991
|
+
retryUntil
|
|
16992
|
+
);
|
|
16993
|
+
cursors?.write(sessionId, next);
|
|
16994
|
+
return;
|
|
16995
|
+
}
|
|
16996
|
+
const queue = [...outbox];
|
|
16997
|
+
if (plan.mode === "append") {
|
|
16998
|
+
const content = turns.slice(plan.fromTurn).map((t) => JSON.stringify(t)).join("\n");
|
|
16999
|
+
queue.push({ content, operationId: opId("append", content), at: Date.now() });
|
|
17000
|
+
}
|
|
17001
|
+
cursors?.write(sessionId, { ...next, pending: queue });
|
|
17002
|
+
for (let i = 0; i < queue.length; i++) {
|
|
17003
|
+
if (i > 0 && Date.now() + REQUEST_BUDGET_MS > retryUntil) return;
|
|
17004
|
+
const entry = queue[i];
|
|
17005
|
+
await submitWithRetry(
|
|
17006
|
+
() => submit(entry.content, entry.operationId, true),
|
|
17007
|
+
stillOurs,
|
|
17008
|
+
retryUntil
|
|
17009
|
+
);
|
|
17010
|
+
const remaining = queue.slice(i + 1);
|
|
17011
|
+
cursors?.write(sessionId, remaining.length ? { ...next, pending: remaining } : next);
|
|
17012
|
+
}
|
|
16924
17013
|
}
|
|
16925
17014
|
|
|
16926
17015
|
// src/core/retain-stamp.ts
|