@mickey-kras/hindsight-memory-router-coding-agents 0.8.9 → 0.8.14

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.
Files changed (59) hide show
  1. package/dist/antigravity-hook.js +70 -24
  2. package/dist/antigravity-statusline.js +60 -14
  3. package/dist/antigravity-stop-hook.js +70 -24
  4. package/dist/claude-hook.js +70 -24
  5. package/dist/claude-sessionstart-hook.js +70 -24
  6. package/dist/claude-stop-hook.js +70 -24
  7. package/dist/cline.js +70 -24
  8. package/dist/codebuddy-hook.js +70 -24
  9. package/dist/codebuddy-sessionstart-hook.js +70 -24
  10. package/dist/codebuddy-stop-hook.js +70 -24
  11. package/dist/codex-hook.js +70 -24
  12. package/dist/codex-sessionstart-hook.js +70 -24
  13. package/dist/codex-stop-hook.js +70 -24
  14. package/dist/copilot-hook.js +70 -24
  15. package/dist/copilot-sessionstart-hook.js +70 -24
  16. package/dist/copilot-stop-hook.js +70 -24
  17. package/dist/cursor-hook.js +70 -24
  18. package/dist/cursor-sessionstart-hook.js +70 -24
  19. package/dist/cursor-stop-hook.js +70 -24
  20. package/dist/dcode-hook.js +70 -24
  21. package/dist/dcode-sessionstart-hook.js +70 -24
  22. package/dist/dcode-stop-hook.js +70 -24
  23. package/dist/deepen.js +70 -68
  24. package/dist/devin-hook.js +70 -24
  25. package/dist/devin-sessionstart-hook.js +70 -24
  26. package/dist/devin-stop-hook.js +70 -24
  27. package/dist/droid-hook.js +70 -24
  28. package/dist/droid-sessionstart-hook.js +70 -24
  29. package/dist/droid-stop-hook.js +70 -24
  30. package/dist/dsh.js +70 -24
  31. package/dist/grok-hook.js +70 -24
  32. package/dist/grok-sessionstart-hook.js +70 -24
  33. package/dist/grok-stop-hook.js +70 -24
  34. package/dist/hindsight-seed.js +60 -14
  35. package/dist/index.js +70 -24
  36. package/dist/installer.js +70 -21
  37. package/dist/kilo.js +70 -24
  38. package/dist/kimi-hook.js +70 -24
  39. package/dist/kimi-sessionstart-hook.js +70 -24
  40. package/dist/kimi-stop-hook.js +70 -24
  41. package/dist/mcp-server.js +79 -24
  42. package/dist/opencode2.js +70 -24
  43. package/dist/pi.js +70 -24
  44. package/dist/prime-agent.js +70 -24
  45. package/dist/qwen-hook.js +70 -24
  46. package/dist/qwen-sessionstart-hook.js +70 -24
  47. package/dist/qwen-stop-hook.js +70 -24
  48. package/dist/status.js +70 -24
  49. package/dist/traecode-hook.js +70 -24
  50. package/dist/traecode-sessionstart-hook.js +70 -24
  51. package/dist/traecode-stop-hook.js +70 -24
  52. package/dist/workbuddy-hook.js +70 -24
  53. package/dist/workbuddy-sessionstart-hook.js +70 -24
  54. package/dist/workbuddy-stop-hook.js +70 -24
  55. package/dist/zcode-hook.js +70 -24
  56. package/dist/zcode-sessionstart-hook.js +70 -24
  57. package/dist/zcode-stop-hook.js +70 -24
  58. package/npm-shrinkwrap.json +257 -711
  59. package/package.json +8 -5
@@ -36,12 +36,10 @@ function requireBank(access, bank, operation) {
36
36
  }
37
37
  function classifyOperation(method, suffix) {
38
38
  if (method === "POST" && ["/memories/recall", "/reflect"].includes(suffix)) return "read";
39
- if (method === "GET" && /^\/(?:config|stats|tags|graph|documents|operations|memories|mental-models|knowledge-base)(?:\/[^/]+)*$/.test(
40
- suffix
41
- ))
39
+ if (method === "GET" && /^\/(?:config|stats|tags|graph|documents|operations|memories|mental-models|pages)(?:\/[^/]+)*$/.test(suffix))
42
40
  return "read";
43
41
  if (method === "GET" && suffix === "") return "read";
44
- if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && /^(?:\/(?:config|import|memories|documents|mental-models|knowledge-base|consolidate|consolidation)(?:\/[^/]+)*)?$/.test(
42
+ if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && /^(?:\/(?:config|import|memories|documents|mental-models|pages|consolidate|consolidation)(?:\/[^/]+)*)?$/.test(
45
43
  suffix
46
44
  ))
47
45
  return "write";
@@ -393,6 +391,54 @@ var RouterTransport = class {
393
391
  // ../../coding-agents/human-session.ts
394
392
  import { createHash as createHash2 } from "crypto";
395
393
  import { createRequire } from "module";
394
+
395
+ // src/harness/names.ts
396
+ var HARNESS_NAMES = [
397
+ "opencode",
398
+ // opencode v2 (binary `opencode2`) — a ground-up rewrite of the plugin API, loaded from the
399
+ // package's root index.js (src/opencode2.ts). Like opencode it has NO hook binary.
400
+ "opencode2",
401
+ // Kilo CLI is an opencode fork loaded as a persistent plugin (src/kilo.ts), so like opencode it
402
+ // has NO hook binary — deliberately absent from HOOK_BINS below.
403
+ "kilo",
404
+ // Cline CLI loads dist/cline.js through its native plugin manager; file hooks cannot inject.
405
+ "cline-cli",
406
+ // DeepSeek Harness loads dist/dsh.js as a native Cordis plugin (src/dsh.ts). Its Claude Code /
407
+ // Codex hook bridges are optional packages, so there is no hook binary to install either.
408
+ "dsh",
409
+ // pi loads dist/pi.js as an extension (src/pi.ts), and Prime Agent — a fork of pi — loads
410
+ // dist/prime-agent.js the same way (src/prime-agent.ts). Neither has a hook binary.
411
+ "pi",
412
+ "prime-agent",
413
+ "claude-code",
414
+ "cursor-cli",
415
+ "codex",
416
+ "dcode",
417
+ "antigravity-cli",
418
+ "devin-cli",
419
+ "copilot-cli",
420
+ "grok-build",
421
+ "qwen-code",
422
+ // Factory Droid is a per-prompt HOOK host: the installer wires ~/.factory/hooks.json and the
423
+ // stdio MCP registration in ~/.factory/mcp.json (see src/installer.ts).
424
+ "factory-droid",
425
+ // ZCode is a per-prompt HOOK host too, registered in its own CLI config
426
+ // (~/.zcode/cli/config.json) under `hooks.events` — never the user's real Claude Code settings.
427
+ "zcode",
428
+ // TraeCode is a per-prompt HOOK host registered in ~/.trae-cn/hooks.json (see src/installer.ts).
429
+ "traecode",
430
+ "kimi-code",
431
+ // WorkBuddy is a per-prompt HOOK host too: the installer wires ~/.workbuddy/settings.json and
432
+ // the stdio MCP registration in ~/.workbuddy/mcp.json (see src/installer.ts).
433
+ "workbuddy",
434
+ // CodeBuddy Code is the SAME @genie/agent-cli HOOK host, one product config apart (WorkBuddy only
435
+ // renames the home folder): the installer wires ~/.codebuddy/settings.json and the stdio MCP
436
+ // registration in CodeBuddy's priority-chained MCP file (see src/installer.ts). The CLI
437
+ // writes WorkBuddy's transcript format; the CodeBuddy IDE has a reader of its own.
438
+ "codebuddy"
439
+ ];
440
+
441
+ // ../../coding-agents/human-session.ts
396
442
  var HUMAN_TOKEN_PATTERN = /^mrh_[0-9a-f]{32}_[0-9a-f]{64}$/;
397
443
  var HumanLoginRequiredError = class extends AccessDeniedError {
398
444
  constructor() {
@@ -418,14 +464,14 @@ function humanRouterUrl(value) {
418
464
  if (url.search || url.hash) throw new HumanLoginRequiredError();
419
465
  return canonical2;
420
466
  }
421
- function secureEntry(routerUrl, credentialRef) {
467
+ function secureEntry(routerUrl, credentialRef, harness) {
422
468
  try {
423
- if (!["darwin", "win32", "linux"].includes(process.platform) || !/^[A-Za-z0-9._-]{1,64}$/.test(credentialRef)) {
469
+ if (!["darwin", "win32", "linux"].includes(process.platform) || !/^[A-Za-z0-9._-]{1,64}$/.test(credentialRef) || !HARNESS_NAMES.includes(harness)) {
424
470
  throw new HumanLoginRequiredError();
425
471
  }
426
472
  const { Entry: NativeEntry } = createRequire(import.meta.url)("@napi-rs/keyring");
427
- const service = `hindsight-memory-router:${createHash2("sha256").update(humanRouterUrl(routerUrl)).digest("hex")}`;
428
- return new NativeEntry(service, credentialRef, { linux: { store: "secret-service" } });
473
+ const service = `hindsight-memory-router:human-v2:${createHash2("sha256").update(humanRouterUrl(routerUrl)).digest("hex")}`;
474
+ return new NativeEntry(service, `${harness}:${credentialRef}`, { linux: { store: "secret-service" } });
429
475
  } catch {
430
476
  throw new HumanLoginRequiredError();
431
477
  }
@@ -443,9 +489,9 @@ function validateHumanSession(value, routerUrl, allowExpired = false) {
443
489
  routerUrl: session.routerUrl
444
490
  };
445
491
  }
446
- function readHumanSession(routerUrl, credentialRef) {
492
+ function readHumanSession(routerUrl, credentialRef, harness) {
447
493
  try {
448
- const password = secureEntry(routerUrl, credentialRef).getPassword();
494
+ const password = secureEntry(routerUrl, credentialRef, harness).getPassword();
449
495
  if (!password || password.length > 4096) throw new HumanLoginRequiredError();
450
496
  return validateHumanSession(JSON.parse(password), routerUrl);
451
497
  } catch {
@@ -457,11 +503,11 @@ function readHumanSession(routerUrl, credentialRef) {
457
503
  function harnessTransport(harness) {
458
504
  return transportForConfig(harness, loadManagedConfig(process.env, harness));
459
505
  }
460
- function transportForConfig(harness, { config: config2, principal }) {
506
+ function transportForConfig(harness, { config: config2, principal, principalId }) {
461
507
  if (principal.human) {
462
508
  const routerUrl = humanRouterUrl(config2.routerUrl);
463
509
  const reference = principal.human.credentialRef;
464
- let session = readHumanSession(routerUrl, reference);
510
+ let session = readHumanSession(routerUrl, reference, principalId);
465
511
  return new RouterTransport({
466
512
  routerUrl,
467
513
  access: principal,
@@ -469,7 +515,7 @@ function transportForConfig(harness, { config: config2, principal }) {
469
515
  tokenPattern: HUMAN_TOKEN_PATTERN,
470
516
  unauthorizedError: () => new HumanLoginRequiredError(),
471
517
  token: () => {
472
- session = readHumanSession(routerUrl, reference);
518
+ session = readHumanSession(routerUrl, reference, principalId);
473
519
  return session.token;
474
520
  }
475
521
  });
@@ -1277,7 +1323,7 @@ var PLUGIN_GOVERNED_BANK_FIELDS = [
1277
1323
  ];
1278
1324
 
1279
1325
  // package.json
1280
- var version = "0.8.9";
1326
+ var version = "0.8.14";
1281
1327
 
1282
1328
  // src/core/util.ts
1283
1329
  import { accessSync, constants } from "fs";
@@ -1791,7 +1837,7 @@ var HindsightClient = class _HindsightClient {
1791
1837
  */
1792
1838
  async tree() {
1793
1839
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
1794
- const r = await this.req("GET", this.bankUrl("/knowledge-base/tree"));
1840
+ const r = await this.req("GET", this.bankUrl("/pages/tree"));
1795
1841
  if (await this.pagesUnsupported(r)) throw new KnowledgePagesUnavailableError();
1796
1842
  if (r.status === 404) return [];
1797
1843
  this.knowledgePagesSupported = true;
@@ -1839,7 +1885,7 @@ var HindsightClient = class _HindsightClient {
1839
1885
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
1840
1886
  const r = await this.req(
1841
1887
  "GET",
1842
- this.bankUrl(`/knowledge-base/pages/${encodeURIComponent(pageId)}`)
1888
+ this.bankUrl(`/pages/${encodeURIComponent(pageId)}`)
1843
1889
  );
1844
1890
  if (r.status === 404) throw new Error(`knowledge page not found: ${pageId}`);
1845
1891
  return shapePage(await r.json());
@@ -1852,7 +1898,7 @@ var HindsightClient = class _HindsightClient {
1852
1898
  const q = `?q=${encodeURIComponent(query)}&limit=${opts.limit ?? this.pageSearchLimit}`;
1853
1899
  const r = await this.req(
1854
1900
  "GET",
1855
- this.bankUrl(`/knowledge-base/search${q}`),
1901
+ this.bankUrl(`/pages/search${q}`),
1856
1902
  void 0,
1857
1903
  [],
1858
1904
  opts.timeoutMs
@@ -1871,7 +1917,7 @@ var HindsightClient = class _HindsightClient {
1871
1917
  /**
1872
1918
  * Seed the fixed page taxonomy as knowledge-base pages at the tree root, idempotently.
1873
1919
  *
1874
- * Matched by NAME, not id: `/knowledge-base/pages` mints its own `kp-…` id, so a stable
1920
+ * Matched by NAME, not id: `/pages` mints its own `kp-…` id, so a stable
1875
1921
  * client-chosen id isn't available to match on (unlike the old mental-model path, which keyed
1876
1922
  * off a slug). Names are unique per folder server-side, which makes them a sound key.
1877
1923
  *
@@ -1910,7 +1956,7 @@ var HindsightClient = class _HindsightClient {
1910
1956
  trigger: pageTriggerFor(pageTrigger, this.bank, page.name)
1911
1957
  };
1912
1958
  if (!hit) {
1913
- const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), body, [409]);
1959
+ const r = await this.req("POST", this.bankUrl("/pages"), body, [409]);
1914
1960
  if (await this.pagesUnsupported(r)) {
1915
1961
  this.log(
1916
1962
  `[bank] knowledge pages unavailable on ${this.apiUrl}; continuing without pages`
@@ -1937,7 +1983,7 @@ var HindsightClient = class _HindsightClient {
1937
1983
  if (triggerDrift) patch.trigger = pageTriggerPatch(body.trigger);
1938
1984
  const r = await this.req(
1939
1985
  "PATCH",
1940
- this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(hit.id)}`),
1986
+ this.bankUrl(`/pages/nodes/${encodeURIComponent(hit.id)}`),
1941
1987
  patch
1942
1988
  );
1943
1989
  if (await this.pagesUnsupported(r)) {
@@ -1991,7 +2037,7 @@ var HindsightClient = class _HindsightClient {
1991
2037
  if (!patch.trigger && !patch.source_query) continue;
1992
2038
  const r = await this.req(
1993
2039
  "PATCH",
1994
- this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(page.id)}`),
2040
+ this.bankUrl(`/pages/nodes/${encodeURIComponent(page.id)}`),
1995
2041
  patch
1996
2042
  );
1997
2043
  if (r.status === 404) continue;
@@ -2020,7 +2066,7 @@ var HindsightClient = class _HindsightClient {
2020
2066
  let pageId = args.relatesToPageId;
2021
2067
  if (!pageId) {
2022
2068
  const folderId = await this.ensureFolder("Initiatives");
2023
- const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), {
2069
+ const r = await this.req("POST", this.bankUrl("/pages"), {
2024
2070
  name: args.title,
2025
2071
  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.` + pageScopeRule(this.project),
2026
2072
  parent_id: folderId,
@@ -2048,7 +2094,7 @@ var HindsightClient = class _HindsightClient {
2048
2094
  /** Find a root folder by name (case-insensitive) or create it; returns its id. Fail-open to undefined. */
2049
2095
  async ensureFolder(name) {
2050
2096
  try {
2051
- const tree = await (await this.req("GET", this.bankUrl("/knowledge-base/tree"))).json();
2097
+ const tree = await (await this.req("GET", this.bankUrl("/pages/tree"))).json();
2052
2098
  const hit = (tree.roots || []).find(
2053
2099
  (n) => n.kind === "folder" && (n.name || "").toLowerCase() === name.toLowerCase()
2054
2100
  );
@@ -2057,7 +2103,7 @@ var HindsightClient = class _HindsightClient {
2057
2103
  if (error instanceof AccessDeniedError) throw error;
2058
2104
  }
2059
2105
  try {
2060
- const r = await this.req("POST", this.bankUrl("/knowledge-base/folders"), { name });
2106
+ const r = await this.req("POST", this.bankUrl("/pages/folders"), { name });
2061
2107
  return (await r.json()).id;
2062
2108
  } catch (error) {
2063
2109
  if (error instanceof AccessDeniedError) throw error;
@@ -36,12 +36,10 @@ function requireBank(access, bank, operation) {
36
36
  }
37
37
  function classifyOperation(method, suffix) {
38
38
  if (method === "POST" && ["/memories/recall", "/reflect"].includes(suffix)) return "read";
39
- if (method === "GET" && /^\/(?:config|stats|tags|graph|documents|operations|memories|mental-models|knowledge-base)(?:\/[^/]+)*$/.test(
40
- suffix
41
- ))
39
+ if (method === "GET" && /^\/(?:config|stats|tags|graph|documents|operations|memories|mental-models|pages)(?:\/[^/]+)*$/.test(suffix))
42
40
  return "read";
43
41
  if (method === "GET" && suffix === "") return "read";
44
- if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && /^(?:\/(?:config|import|memories|documents|mental-models|knowledge-base|consolidate|consolidation)(?:\/[^/]+)*)?$/.test(
42
+ if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && /^(?:\/(?:config|import|memories|documents|mental-models|pages|consolidate|consolidation)(?:\/[^/]+)*)?$/.test(
45
43
  suffix
46
44
  ))
47
45
  return "write";
@@ -427,6 +425,54 @@ var RouterTransport = class {
427
425
  // ../../coding-agents/human-session.ts
428
426
  import { createHash as createHash2 } from "crypto";
429
427
  import { createRequire } from "module";
428
+
429
+ // src/harness/names.ts
430
+ var HARNESS_NAMES = [
431
+ "opencode",
432
+ // opencode v2 (binary `opencode2`) — a ground-up rewrite of the plugin API, loaded from the
433
+ // package's root index.js (src/opencode2.ts). Like opencode it has NO hook binary.
434
+ "opencode2",
435
+ // Kilo CLI is an opencode fork loaded as a persistent plugin (src/kilo.ts), so like opencode it
436
+ // has NO hook binary — deliberately absent from HOOK_BINS below.
437
+ "kilo",
438
+ // Cline CLI loads dist/cline.js through its native plugin manager; file hooks cannot inject.
439
+ "cline-cli",
440
+ // DeepSeek Harness loads dist/dsh.js as a native Cordis plugin (src/dsh.ts). Its Claude Code /
441
+ // Codex hook bridges are optional packages, so there is no hook binary to install either.
442
+ "dsh",
443
+ // pi loads dist/pi.js as an extension (src/pi.ts), and Prime Agent — a fork of pi — loads
444
+ // dist/prime-agent.js the same way (src/prime-agent.ts). Neither has a hook binary.
445
+ "pi",
446
+ "prime-agent",
447
+ "claude-code",
448
+ "cursor-cli",
449
+ "codex",
450
+ "dcode",
451
+ "antigravity-cli",
452
+ "devin-cli",
453
+ "copilot-cli",
454
+ "grok-build",
455
+ "qwen-code",
456
+ // Factory Droid is a per-prompt HOOK host: the installer wires ~/.factory/hooks.json and the
457
+ // stdio MCP registration in ~/.factory/mcp.json (see src/installer.ts).
458
+ "factory-droid",
459
+ // ZCode is a per-prompt HOOK host too, registered in its own CLI config
460
+ // (~/.zcode/cli/config.json) under `hooks.events` — never the user's real Claude Code settings.
461
+ "zcode",
462
+ // TraeCode is a per-prompt HOOK host registered in ~/.trae-cn/hooks.json (see src/installer.ts).
463
+ "traecode",
464
+ "kimi-code",
465
+ // WorkBuddy is a per-prompt HOOK host too: the installer wires ~/.workbuddy/settings.json and
466
+ // the stdio MCP registration in ~/.workbuddy/mcp.json (see src/installer.ts).
467
+ "workbuddy",
468
+ // CodeBuddy Code is the SAME @genie/agent-cli HOOK host, one product config apart (WorkBuddy only
469
+ // renames the home folder): the installer wires ~/.codebuddy/settings.json and the stdio MCP
470
+ // registration in CodeBuddy's priority-chained MCP file (see src/installer.ts). The CLI
471
+ // writes WorkBuddy's transcript format; the CodeBuddy IDE has a reader of its own.
472
+ "codebuddy"
473
+ ];
474
+
475
+ // ../../coding-agents/human-session.ts
430
476
  var HUMAN_TOKEN_PATTERN = /^mrh_[0-9a-f]{32}_[0-9a-f]{64}$/;
431
477
  var HumanLoginRequiredError = class extends AccessDeniedError {
432
478
  constructor() {
@@ -452,14 +498,14 @@ function humanRouterUrl(value) {
452
498
  if (url.search || url.hash) throw new HumanLoginRequiredError();
453
499
  return canonical2;
454
500
  }
455
- function secureEntry(routerUrl, credentialRef) {
501
+ function secureEntry(routerUrl, credentialRef, harness) {
456
502
  try {
457
- if (!["darwin", "win32", "linux"].includes(process.platform) || !/^[A-Za-z0-9._-]{1,64}$/.test(credentialRef)) {
503
+ if (!["darwin", "win32", "linux"].includes(process.platform) || !/^[A-Za-z0-9._-]{1,64}$/.test(credentialRef) || !HARNESS_NAMES.includes(harness)) {
458
504
  throw new HumanLoginRequiredError();
459
505
  }
460
506
  const { Entry: NativeEntry } = createRequire(import.meta.url)("@napi-rs/keyring");
461
- const service = `hindsight-memory-router:${createHash2("sha256").update(humanRouterUrl(routerUrl)).digest("hex")}`;
462
- return new NativeEntry(service, credentialRef, { linux: { store: "secret-service" } });
507
+ const service = `hindsight-memory-router:human-v2:${createHash2("sha256").update(humanRouterUrl(routerUrl)).digest("hex")}`;
508
+ return new NativeEntry(service, `${harness}:${credentialRef}`, { linux: { store: "secret-service" } });
463
509
  } catch {
464
510
  throw new HumanLoginRequiredError();
465
511
  }
@@ -477,9 +523,9 @@ function validateHumanSession(value, routerUrl, allowExpired = false) {
477
523
  routerUrl: session.routerUrl
478
524
  };
479
525
  }
480
- function readHumanSession(routerUrl, credentialRef) {
526
+ function readHumanSession(routerUrl, credentialRef, harness) {
481
527
  try {
482
- const password = secureEntry(routerUrl, credentialRef).getPassword();
528
+ const password = secureEntry(routerUrl, credentialRef, harness).getPassword();
483
529
  if (!password || password.length > 4096) throw new HumanLoginRequiredError();
484
530
  return validateHumanSession(JSON.parse(password), routerUrl);
485
531
  } catch {
@@ -491,11 +537,11 @@ function readHumanSession(routerUrl, credentialRef) {
491
537
  function harnessTransport(harness) {
492
538
  return transportForConfig(harness, loadManagedConfig(process.env, harness));
493
539
  }
494
- function transportForConfig(harness, { config: config2, principal }) {
540
+ function transportForConfig(harness, { config: config2, principal, principalId }) {
495
541
  if (principal.human) {
496
542
  const routerUrl = humanRouterUrl(config2.routerUrl);
497
543
  const reference = principal.human.credentialRef;
498
- let session = readHumanSession(routerUrl, reference);
544
+ let session = readHumanSession(routerUrl, reference, principalId);
499
545
  return new RouterTransport({
500
546
  routerUrl,
501
547
  access: principal,
@@ -503,7 +549,7 @@ function transportForConfig(harness, { config: config2, principal }) {
503
549
  tokenPattern: HUMAN_TOKEN_PATTERN,
504
550
  unauthorizedError: () => new HumanLoginRequiredError(),
505
551
  token: () => {
506
- session = readHumanSession(routerUrl, reference);
552
+ session = readHumanSession(routerUrl, reference, principalId);
507
553
  return session.token;
508
554
  }
509
555
  });
@@ -1348,7 +1394,7 @@ var PLUGIN_GOVERNED_BANK_FIELDS = [
1348
1394
  ];
1349
1395
 
1350
1396
  // package.json
1351
- var version = "0.8.9";
1397
+ var version = "0.8.14";
1352
1398
 
1353
1399
  // src/core/util.ts
1354
1400
  import { accessSync, constants } from "fs";
@@ -1881,7 +1927,7 @@ var HindsightClient = class _HindsightClient {
1881
1927
  */
1882
1928
  async tree() {
1883
1929
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
1884
- const r = await this.req("GET", this.bankUrl("/knowledge-base/tree"));
1930
+ const r = await this.req("GET", this.bankUrl("/pages/tree"));
1885
1931
  if (await this.pagesUnsupported(r)) throw new KnowledgePagesUnavailableError();
1886
1932
  if (r.status === 404) return [];
1887
1933
  this.knowledgePagesSupported = true;
@@ -1929,7 +1975,7 @@ var HindsightClient = class _HindsightClient {
1929
1975
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
1930
1976
  const r = await this.req(
1931
1977
  "GET",
1932
- this.bankUrl(`/knowledge-base/pages/${encodeURIComponent(pageId)}`)
1978
+ this.bankUrl(`/pages/${encodeURIComponent(pageId)}`)
1933
1979
  );
1934
1980
  if (r.status === 404) throw new Error(`knowledge page not found: ${pageId}`);
1935
1981
  return shapePage(await r.json());
@@ -1942,7 +1988,7 @@ var HindsightClient = class _HindsightClient {
1942
1988
  const q = `?q=${encodeURIComponent(query)}&limit=${opts.limit ?? this.pageSearchLimit}`;
1943
1989
  const r = await this.req(
1944
1990
  "GET",
1945
- this.bankUrl(`/knowledge-base/search${q}`),
1991
+ this.bankUrl(`/pages/search${q}`),
1946
1992
  void 0,
1947
1993
  [],
1948
1994
  opts.timeoutMs
@@ -1961,7 +2007,7 @@ var HindsightClient = class _HindsightClient {
1961
2007
  /**
1962
2008
  * Seed the fixed page taxonomy as knowledge-base pages at the tree root, idempotently.
1963
2009
  *
1964
- * Matched by NAME, not id: `/knowledge-base/pages` mints its own `kp-…` id, so a stable
2010
+ * Matched by NAME, not id: `/pages` mints its own `kp-…` id, so a stable
1965
2011
  * client-chosen id isn't available to match on (unlike the old mental-model path, which keyed
1966
2012
  * off a slug). Names are unique per folder server-side, which makes them a sound key.
1967
2013
  *
@@ -2000,7 +2046,7 @@ var HindsightClient = class _HindsightClient {
2000
2046
  trigger: pageTriggerFor(pageTrigger, this.bank, page.name)
2001
2047
  };
2002
2048
  if (!hit) {
2003
- const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), body, [409]);
2049
+ const r = await this.req("POST", this.bankUrl("/pages"), body, [409]);
2004
2050
  if (await this.pagesUnsupported(r)) {
2005
2051
  this.log(
2006
2052
  `[bank] knowledge pages unavailable on ${this.apiUrl}; continuing without pages`
@@ -2027,7 +2073,7 @@ var HindsightClient = class _HindsightClient {
2027
2073
  if (triggerDrift) patch.trigger = pageTriggerPatch(body.trigger);
2028
2074
  const r = await this.req(
2029
2075
  "PATCH",
2030
- this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(hit.id)}`),
2076
+ this.bankUrl(`/pages/nodes/${encodeURIComponent(hit.id)}`),
2031
2077
  patch
2032
2078
  );
2033
2079
  if (await this.pagesUnsupported(r)) {
@@ -2081,7 +2127,7 @@ var HindsightClient = class _HindsightClient {
2081
2127
  if (!patch.trigger && !patch.source_query) continue;
2082
2128
  const r = await this.req(
2083
2129
  "PATCH",
2084
- this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(page.id)}`),
2130
+ this.bankUrl(`/pages/nodes/${encodeURIComponent(page.id)}`),
2085
2131
  patch
2086
2132
  );
2087
2133
  if (r.status === 404) continue;
@@ -2110,7 +2156,7 @@ var HindsightClient = class _HindsightClient {
2110
2156
  let pageId = args.relatesToPageId;
2111
2157
  if (!pageId) {
2112
2158
  const folderId = await this.ensureFolder("Initiatives");
2113
- const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), {
2159
+ const r = await this.req("POST", this.bankUrl("/pages"), {
2114
2160
  name: args.title,
2115
2161
  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.` + pageScopeRule(this.project),
2116
2162
  parent_id: folderId,
@@ -2138,7 +2184,7 @@ var HindsightClient = class _HindsightClient {
2138
2184
  /** Find a root folder by name (case-insensitive) or create it; returns its id. Fail-open to undefined. */
2139
2185
  async ensureFolder(name) {
2140
2186
  try {
2141
- const tree = await (await this.req("GET", this.bankUrl("/knowledge-base/tree"))).json();
2187
+ const tree = await (await this.req("GET", this.bankUrl("/pages/tree"))).json();
2142
2188
  const hit = (tree.roots || []).find(
2143
2189
  (n) => n.kind === "folder" && (n.name || "").toLowerCase() === name.toLowerCase()
2144
2190
  );
@@ -2147,7 +2193,7 @@ var HindsightClient = class _HindsightClient {
2147
2193
  if (error instanceof AccessDeniedError) throw error;
2148
2194
  }
2149
2195
  try {
2150
- const r = await this.req("POST", this.bankUrl("/knowledge-base/folders"), { name });
2196
+ const r = await this.req("POST", this.bankUrl("/pages/folders"), { name });
2151
2197
  return (await r.json()).id;
2152
2198
  } catch (error) {
2153
2199
  if (error instanceof AccessDeniedError) throw error;
@@ -36,12 +36,10 @@ function requireBank(access, bank, operation) {
36
36
  }
37
37
  function classifyOperation(method, suffix) {
38
38
  if (method === "POST" && ["/memories/recall", "/reflect"].includes(suffix)) return "read";
39
- if (method === "GET" && /^\/(?:config|stats|tags|graph|documents|operations|memories|mental-models|knowledge-base)(?:\/[^/]+)*$/.test(
40
- suffix
41
- ))
39
+ if (method === "GET" && /^\/(?:config|stats|tags|graph|documents|operations|memories|mental-models|pages)(?:\/[^/]+)*$/.test(suffix))
42
40
  return "read";
43
41
  if (method === "GET" && suffix === "") return "read";
44
- if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && /^(?:\/(?:config|import|memories|documents|mental-models|knowledge-base|consolidate|consolidation)(?:\/[^/]+)*)?$/.test(
42
+ if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && /^(?:\/(?:config|import|memories|documents|mental-models|pages|consolidate|consolidation)(?:\/[^/]+)*)?$/.test(
45
43
  suffix
46
44
  ))
47
45
  return "write";
@@ -379,6 +377,54 @@ var RouterTransport = class {
379
377
  // ../../coding-agents/human-session.ts
380
378
  import { createHash as createHash2 } from "crypto";
381
379
  import { createRequire } from "module";
380
+
381
+ // src/harness/names.ts
382
+ var HARNESS_NAMES = [
383
+ "opencode",
384
+ // opencode v2 (binary `opencode2`) — a ground-up rewrite of the plugin API, loaded from the
385
+ // package's root index.js (src/opencode2.ts). Like opencode it has NO hook binary.
386
+ "opencode2",
387
+ // Kilo CLI is an opencode fork loaded as a persistent plugin (src/kilo.ts), so like opencode it
388
+ // has NO hook binary — deliberately absent from HOOK_BINS below.
389
+ "kilo",
390
+ // Cline CLI loads dist/cline.js through its native plugin manager; file hooks cannot inject.
391
+ "cline-cli",
392
+ // DeepSeek Harness loads dist/dsh.js as a native Cordis plugin (src/dsh.ts). Its Claude Code /
393
+ // Codex hook bridges are optional packages, so there is no hook binary to install either.
394
+ "dsh",
395
+ // pi loads dist/pi.js as an extension (src/pi.ts), and Prime Agent — a fork of pi — loads
396
+ // dist/prime-agent.js the same way (src/prime-agent.ts). Neither has a hook binary.
397
+ "pi",
398
+ "prime-agent",
399
+ "claude-code",
400
+ "cursor-cli",
401
+ "codex",
402
+ "dcode",
403
+ "antigravity-cli",
404
+ "devin-cli",
405
+ "copilot-cli",
406
+ "grok-build",
407
+ "qwen-code",
408
+ // Factory Droid is a per-prompt HOOK host: the installer wires ~/.factory/hooks.json and the
409
+ // stdio MCP registration in ~/.factory/mcp.json (see src/installer.ts).
410
+ "factory-droid",
411
+ // ZCode is a per-prompt HOOK host too, registered in its own CLI config
412
+ // (~/.zcode/cli/config.json) under `hooks.events` — never the user's real Claude Code settings.
413
+ "zcode",
414
+ // TraeCode is a per-prompt HOOK host registered in ~/.trae-cn/hooks.json (see src/installer.ts).
415
+ "traecode",
416
+ "kimi-code",
417
+ // WorkBuddy is a per-prompt HOOK host too: the installer wires ~/.workbuddy/settings.json and
418
+ // the stdio MCP registration in ~/.workbuddy/mcp.json (see src/installer.ts).
419
+ "workbuddy",
420
+ // CodeBuddy Code is the SAME @genie/agent-cli HOOK host, one product config apart (WorkBuddy only
421
+ // renames the home folder): the installer wires ~/.codebuddy/settings.json and the stdio MCP
422
+ // registration in CodeBuddy's priority-chained MCP file (see src/installer.ts). The CLI
423
+ // writes WorkBuddy's transcript format; the CodeBuddy IDE has a reader of its own.
424
+ "codebuddy"
425
+ ];
426
+
427
+ // ../../coding-agents/human-session.ts
382
428
  var HUMAN_TOKEN_PATTERN = /^mrh_[0-9a-f]{32}_[0-9a-f]{64}$/;
383
429
  var HumanLoginRequiredError = class extends AccessDeniedError {
384
430
  constructor() {
@@ -404,14 +450,14 @@ function humanRouterUrl(value) {
404
450
  if (url.search || url.hash) throw new HumanLoginRequiredError();
405
451
  return canonical2;
406
452
  }
407
- function secureEntry(routerUrl, credentialRef) {
453
+ function secureEntry(routerUrl, credentialRef, harness) {
408
454
  try {
409
- if (!["darwin", "win32", "linux"].includes(process.platform) || !/^[A-Za-z0-9._-]{1,64}$/.test(credentialRef)) {
455
+ if (!["darwin", "win32", "linux"].includes(process.platform) || !/^[A-Za-z0-9._-]{1,64}$/.test(credentialRef) || !HARNESS_NAMES.includes(harness)) {
410
456
  throw new HumanLoginRequiredError();
411
457
  }
412
458
  const { Entry: NativeEntry } = createRequire(import.meta.url)("@napi-rs/keyring");
413
- const service = `hindsight-memory-router:${createHash2("sha256").update(humanRouterUrl(routerUrl)).digest("hex")}`;
414
- return new NativeEntry(service, credentialRef, { linux: { store: "secret-service" } });
459
+ const service = `hindsight-memory-router:human-v2:${createHash2("sha256").update(humanRouterUrl(routerUrl)).digest("hex")}`;
460
+ return new NativeEntry(service, `${harness}:${credentialRef}`, { linux: { store: "secret-service" } });
415
461
  } catch {
416
462
  throw new HumanLoginRequiredError();
417
463
  }
@@ -429,9 +475,9 @@ function validateHumanSession(value, routerUrl, allowExpired = false) {
429
475
  routerUrl: session.routerUrl
430
476
  };
431
477
  }
432
- function readHumanSession(routerUrl, credentialRef) {
478
+ function readHumanSession(routerUrl, credentialRef, harness) {
433
479
  try {
434
- const password = secureEntry(routerUrl, credentialRef).getPassword();
480
+ const password = secureEntry(routerUrl, credentialRef, harness).getPassword();
435
481
  if (!password || password.length > 4096) throw new HumanLoginRequiredError();
436
482
  return validateHumanSession(JSON.parse(password), routerUrl);
437
483
  } catch {
@@ -443,11 +489,11 @@ function readHumanSession(routerUrl, credentialRef) {
443
489
  function harnessTransport(harness) {
444
490
  return transportForConfig(harness, loadManagedConfig(process.env, harness));
445
491
  }
446
- function transportForConfig(harness, { config: config2, principal }) {
492
+ function transportForConfig(harness, { config: config2, principal, principalId }) {
447
493
  if (principal.human) {
448
494
  const routerUrl = humanRouterUrl(config2.routerUrl);
449
495
  const reference = principal.human.credentialRef;
450
- let session = readHumanSession(routerUrl, reference);
496
+ let session = readHumanSession(routerUrl, reference, principalId);
451
497
  return new RouterTransport({
452
498
  routerUrl,
453
499
  access: principal,
@@ -455,7 +501,7 @@ function transportForConfig(harness, { config: config2, principal }) {
455
501
  tokenPattern: HUMAN_TOKEN_PATTERN,
456
502
  unauthorizedError: () => new HumanLoginRequiredError(),
457
503
  token: () => {
458
- session = readHumanSession(routerUrl, reference);
504
+ session = readHumanSession(routerUrl, reference, principalId);
459
505
  return session.token;
460
506
  }
461
507
  });
@@ -1214,7 +1260,7 @@ var PLUGIN_GOVERNED_BANK_FIELDS = [
1214
1260
  ];
1215
1261
 
1216
1262
  // package.json
1217
- var version = "0.8.9";
1263
+ var version = "0.8.14";
1218
1264
 
1219
1265
  // src/core/util.ts
1220
1266
  import { accessSync, constants } from "fs";
@@ -1728,7 +1774,7 @@ var HindsightClient = class _HindsightClient {
1728
1774
  */
1729
1775
  async tree() {
1730
1776
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
1731
- const r = await this.req("GET", this.bankUrl("/knowledge-base/tree"));
1777
+ const r = await this.req("GET", this.bankUrl("/pages/tree"));
1732
1778
  if (await this.pagesUnsupported(r)) throw new KnowledgePagesUnavailableError();
1733
1779
  if (r.status === 404) return [];
1734
1780
  this.knowledgePagesSupported = true;
@@ -1776,7 +1822,7 @@ var HindsightClient = class _HindsightClient {
1776
1822
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
1777
1823
  const r = await this.req(
1778
1824
  "GET",
1779
- this.bankUrl(`/knowledge-base/pages/${encodeURIComponent(pageId)}`)
1825
+ this.bankUrl(`/pages/${encodeURIComponent(pageId)}`)
1780
1826
  );
1781
1827
  if (r.status === 404) throw new Error(`knowledge page not found: ${pageId}`);
1782
1828
  return shapePage(await r.json());
@@ -1789,7 +1835,7 @@ var HindsightClient = class _HindsightClient {
1789
1835
  const q = `?q=${encodeURIComponent(query)}&limit=${opts.limit ?? this.pageSearchLimit}`;
1790
1836
  const r = await this.req(
1791
1837
  "GET",
1792
- this.bankUrl(`/knowledge-base/search${q}`),
1838
+ this.bankUrl(`/pages/search${q}`),
1793
1839
  void 0,
1794
1840
  [],
1795
1841
  opts.timeoutMs
@@ -1808,7 +1854,7 @@ var HindsightClient = class _HindsightClient {
1808
1854
  /**
1809
1855
  * Seed the fixed page taxonomy as knowledge-base pages at the tree root, idempotently.
1810
1856
  *
1811
- * Matched by NAME, not id: `/knowledge-base/pages` mints its own `kp-…` id, so a stable
1857
+ * Matched by NAME, not id: `/pages` mints its own `kp-…` id, so a stable
1812
1858
  * client-chosen id isn't available to match on (unlike the old mental-model path, which keyed
1813
1859
  * off a slug). Names are unique per folder server-side, which makes them a sound key.
1814
1860
  *
@@ -1847,7 +1893,7 @@ var HindsightClient = class _HindsightClient {
1847
1893
  trigger: pageTriggerFor(pageTrigger, this.bank, page.name)
1848
1894
  };
1849
1895
  if (!hit) {
1850
- const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), body, [409]);
1896
+ const r = await this.req("POST", this.bankUrl("/pages"), body, [409]);
1851
1897
  if (await this.pagesUnsupported(r)) {
1852
1898
  this.log(
1853
1899
  `[bank] knowledge pages unavailable on ${this.apiUrl}; continuing without pages`
@@ -1874,7 +1920,7 @@ var HindsightClient = class _HindsightClient {
1874
1920
  if (triggerDrift) patch.trigger = pageTriggerPatch(body.trigger);
1875
1921
  const r = await this.req(
1876
1922
  "PATCH",
1877
- this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(hit.id)}`),
1923
+ this.bankUrl(`/pages/nodes/${encodeURIComponent(hit.id)}`),
1878
1924
  patch
1879
1925
  );
1880
1926
  if (await this.pagesUnsupported(r)) {
@@ -1928,7 +1974,7 @@ var HindsightClient = class _HindsightClient {
1928
1974
  if (!patch.trigger && !patch.source_query) continue;
1929
1975
  const r = await this.req(
1930
1976
  "PATCH",
1931
- this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(page.id)}`),
1977
+ this.bankUrl(`/pages/nodes/${encodeURIComponent(page.id)}`),
1932
1978
  patch
1933
1979
  );
1934
1980
  if (r.status === 404) continue;
@@ -1957,7 +2003,7 @@ var HindsightClient = class _HindsightClient {
1957
2003
  let pageId = args.relatesToPageId;
1958
2004
  if (!pageId) {
1959
2005
  const folderId = await this.ensureFolder("Initiatives");
1960
- const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), {
2006
+ const r = await this.req("POST", this.bankUrl("/pages"), {
1961
2007
  name: args.title,
1962
2008
  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.` + pageScopeRule(this.project),
1963
2009
  parent_id: folderId,
@@ -1985,7 +2031,7 @@ var HindsightClient = class _HindsightClient {
1985
2031
  /** Find a root folder by name (case-insensitive) or create it; returns its id. Fail-open to undefined. */
1986
2032
  async ensureFolder(name) {
1987
2033
  try {
1988
- const tree = await (await this.req("GET", this.bankUrl("/knowledge-base/tree"))).json();
2034
+ const tree = await (await this.req("GET", this.bankUrl("/pages/tree"))).json();
1989
2035
  const hit = (tree.roots || []).find(
1990
2036
  (n) => n.kind === "folder" && (n.name || "").toLowerCase() === name.toLowerCase()
1991
2037
  );
@@ -1994,7 +2040,7 @@ var HindsightClient = class _HindsightClient {
1994
2040
  if (error instanceof AccessDeniedError) throw error;
1995
2041
  }
1996
2042
  try {
1997
- const r = await this.req("POST", this.bankUrl("/knowledge-base/folders"), { name });
2043
+ const r = await this.req("POST", this.bankUrl("/pages/folders"), { name });
1998
2044
  return (await r.json()).id;
1999
2045
  } catch (error) {
2000
2046
  if (error instanceof AccessDeniedError) throw error;