@ouro.bot/cli 0.1.0-alpha.29 → 0.1.0-alpha.290

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 (281) hide show
  1. package/README.md +188 -190
  2. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/agent.json +3 -2
  3. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/SOUL.md +1 -1
  4. package/changelog.json +1756 -0
  5. package/dist/arc/attention-types.js +8 -0
  6. package/dist/arc/cares.js +140 -0
  7. package/dist/arc/episodes.js +117 -0
  8. package/dist/arc/intentions.js +133 -0
  9. package/dist/arc/json-store.js +117 -0
  10. package/dist/arc/obligations.js +237 -0
  11. package/dist/arc/packets.js +203 -0
  12. package/dist/arc/presence.js +185 -0
  13. package/dist/heart/active-work.js +832 -0
  14. package/dist/heart/agent-entry.js +37 -2
  15. package/dist/heart/attachments/image-normalize.js +194 -0
  16. package/dist/heart/attachments/materialize.js +230 -0
  17. package/dist/heart/attachments/render.js +29 -0
  18. package/dist/heart/attachments/store.js +103 -0
  19. package/dist/heart/attachments/types.js +138 -0
  20. package/dist/heart/auth/auth-flow.js +456 -0
  21. package/dist/heart/bridges/manager.js +358 -0
  22. package/dist/heart/bridges/state-machine.js +135 -0
  23. package/dist/heart/bridges/store.js +123 -0
  24. package/dist/heart/bundle-state.js +147 -0
  25. package/dist/heart/commitments.js +111 -0
  26. package/dist/heart/config-registry.js +304 -0
  27. package/dist/heart/config.js +63 -30
  28. package/dist/heart/core.js +669 -195
  29. package/dist/heart/cross-chat-delivery.js +131 -0
  30. package/dist/heart/daemon/agent-config-check.js +149 -0
  31. package/dist/heart/daemon/agent-discovery.js +79 -3
  32. package/dist/heart/daemon/agent-service.js +360 -0
  33. package/dist/heart/daemon/cadence.js +70 -0
  34. package/dist/heart/daemon/cli-defaults.js +574 -0
  35. package/dist/heart/daemon/cli-exec.js +1932 -0
  36. package/dist/heart/daemon/cli-parse.js +762 -0
  37. package/dist/heart/daemon/cli-render.js +503 -0
  38. package/dist/heart/daemon/cli-types.js +8 -0
  39. package/dist/heart/daemon/daemon-cli.js +29 -1171
  40. package/dist/heart/daemon/daemon-entry.js +235 -3
  41. package/dist/heart/daemon/daemon-health.js +136 -0
  42. package/dist/heart/daemon/daemon-runtime-sync.js +153 -12
  43. package/dist/heart/daemon/daemon-tombstone.js +236 -0
  44. package/dist/heart/daemon/daemon.js +706 -57
  45. package/dist/heart/daemon/hooks/agent-config-v2.js +33 -0
  46. package/dist/heart/daemon/hooks/bundle-meta.js +115 -1
  47. package/dist/heart/daemon/inner-status.js +89 -0
  48. package/dist/heart/daemon/launchd.js +46 -9
  49. package/dist/heart/daemon/log-tailer.js +82 -12
  50. package/dist/heart/daemon/logs-prune.js +105 -0
  51. package/dist/heart/daemon/message-router.js +17 -8
  52. package/dist/heart/daemon/os-cron-deps.js +134 -0
  53. package/dist/heart/daemon/ouro-bot-entry.js +1 -1
  54. package/dist/heart/daemon/process-manager.js +180 -0
  55. package/dist/heart/daemon/pulse.js +463 -0
  56. package/dist/heart/daemon/run-hooks.js +2 -0
  57. package/dist/heart/daemon/runtime-logging.js +67 -16
  58. package/dist/heart/daemon/runtime-metadata.js +101 -0
  59. package/dist/heart/daemon/runtime-mode.js +67 -0
  60. package/dist/heart/daemon/safe-mode.js +161 -0
  61. package/dist/heart/daemon/sense-manager.js +72 -3
  62. package/dist/heart/daemon/session-id-resolver.js +131 -0
  63. package/dist/heart/daemon/skill-management-installer.js +94 -0
  64. package/dist/heart/daemon/socket-client.js +307 -0
  65. package/dist/heart/daemon/task-scheduler.js +3 -25
  66. package/dist/heart/daemon/thoughts.js +510 -0
  67. package/dist/heart/delegation.js +62 -0
  68. package/dist/heart/habits/habit-migration.js +181 -0
  69. package/dist/heart/habits/habit-parser.js +140 -0
  70. package/dist/heart/habits/habit-scheduler.js +371 -0
  71. package/dist/heart/{daemon → hatch}/hatch-flow.js +30 -120
  72. package/dist/heart/{daemon → hatch}/hatch-specialist.js +3 -3
  73. package/dist/heart/{daemon → hatch}/specialist-prompt.js +10 -7
  74. package/dist/heart/{daemon → hatch}/specialist-tools.js +49 -3
  75. package/dist/heart/identity.js +163 -60
  76. package/dist/heart/kicks.js +2 -20
  77. package/dist/heart/mcp/mcp-server.js +653 -0
  78. package/dist/heart/migrate-config.js +127 -0
  79. package/dist/heart/model-capabilities.js +59 -0
  80. package/dist/heart/outlook/outlook-http.js +439 -0
  81. package/dist/heart/outlook/outlook-read.js +1618 -0
  82. package/dist/heart/outlook/outlook-render.js +1032 -0
  83. package/dist/heart/outlook/outlook-types.js +7 -0
  84. package/dist/heart/outlook/outlook-view.js +194 -0
  85. package/dist/heart/progress-story.js +42 -0
  86. package/dist/heart/provider-failover.js +88 -0
  87. package/dist/heart/provider-ping.js +162 -0
  88. package/dist/heart/providers/anthropic-token.js +163 -0
  89. package/dist/heart/providers/anthropic.js +169 -46
  90. package/dist/heart/providers/azure.js +98 -11
  91. package/dist/heart/providers/error-classification.js +63 -0
  92. package/dist/heart/providers/github-copilot.js +136 -0
  93. package/dist/heart/providers/minimax-vlm.js +189 -0
  94. package/dist/heart/providers/minimax.js +23 -5
  95. package/dist/heart/providers/openai-codex.js +33 -22
  96. package/dist/heart/session-activity.js +172 -0
  97. package/dist/heart/session-recall.js +216 -0
  98. package/dist/heart/start-of-turn-packet.js +339 -0
  99. package/dist/heart/streaming.js +36 -27
  100. package/dist/heart/sync.js +277 -0
  101. package/dist/heart/target-resolution.js +127 -0
  102. package/dist/heart/tempo.js +93 -0
  103. package/dist/heart/temporal-view.js +41 -0
  104. package/dist/heart/tool-activity-callbacks.js +36 -0
  105. package/dist/heart/tool-description.js +135 -0
  106. package/dist/heart/tool-friction.js +55 -0
  107. package/dist/heart/tool-loop.js +200 -0
  108. package/dist/heart/turn-context.js +358 -0
  109. package/dist/heart/turn-coordinator.js +28 -0
  110. package/dist/heart/{daemon → versioning}/ouro-bot-global-installer.js +1 -1
  111. package/dist/heart/{daemon → versioning}/ouro-bot-wrapper.js +1 -1
  112. package/dist/heart/{daemon → versioning}/ouro-path-installer.js +78 -35
  113. package/dist/heart/versioning/ouro-version-manager.js +295 -0
  114. package/dist/heart/{daemon → versioning}/staged-restart.js +40 -8
  115. package/dist/heart/{daemon → versioning}/update-checker.js +12 -2
  116. package/dist/heart/{daemon → versioning}/update-hooks.js +63 -59
  117. package/dist/mind/associative-recall.js +126 -66
  118. package/dist/mind/bundle-manifest.js +8 -1
  119. package/dist/mind/context.js +125 -14
  120. package/dist/mind/{memory.js → diary.js} +68 -96
  121. package/dist/mind/embedding-provider.js +60 -0
  122. package/dist/mind/file-state.js +179 -0
  123. package/dist/mind/first-impressions.js +14 -1
  124. package/dist/mind/friends/channel.js +56 -0
  125. package/dist/mind/friends/group-context.js +144 -0
  126. package/dist/mind/friends/resolver.js +37 -0
  127. package/dist/mind/friends/store-file.js +58 -3
  128. package/dist/mind/friends/trust-explanation.js +74 -0
  129. package/dist/mind/friends/types.js +8 -0
  130. package/dist/mind/journal-index.js +161 -0
  131. package/dist/mind/obligation-steering.js +221 -0
  132. package/dist/mind/pending.js +76 -9
  133. package/dist/mind/prompt.js +885 -109
  134. package/dist/mind/scrutiny.js +173 -0
  135. package/dist/mind/token-estimate.js +8 -12
  136. package/dist/nerves/cli-logging.js +7 -1
  137. package/dist/nerves/coverage/audit.js +1 -1
  138. package/dist/nerves/coverage/file-completeness.js +56 -5
  139. package/dist/nerves/coverage/run-artifacts.js +1 -1
  140. package/dist/nerves/event-buffer.js +111 -0
  141. package/dist/nerves/index.js +224 -4
  142. package/dist/nerves/observation.js +20 -0
  143. package/dist/nerves/redact.js +79 -0
  144. package/dist/nerves/runtime.js +5 -1
  145. package/dist/outlook-ui/assets/index-Ck8agNeO.js +61 -0
  146. package/dist/outlook-ui/assets/index-LwChZTgL.css +1 -0
  147. package/dist/outlook-ui/index.html +15 -0
  148. package/dist/repertoire/ado-client.js +15 -56
  149. package/dist/repertoire/ado-semantic.js +11 -10
  150. package/dist/repertoire/api-client.js +97 -0
  151. package/dist/repertoire/bitwarden-store.js +319 -0
  152. package/dist/repertoire/bundle-templates.js +72 -0
  153. package/dist/repertoire/bw-installer.js +79 -0
  154. package/dist/repertoire/coding/codex-jsonl.js +64 -0
  155. package/dist/repertoire/coding/context-pack.js +330 -0
  156. package/dist/repertoire/coding/feedback.js +197 -30
  157. package/dist/repertoire/coding/manager.js +149 -2
  158. package/dist/repertoire/coding/spawner.js +55 -9
  159. package/dist/repertoire/coding/tools.js +170 -7
  160. package/dist/repertoire/commerce-errors.js +109 -0
  161. package/dist/repertoire/commerce-self-test.js +156 -0
  162. package/dist/repertoire/credential-access.js +515 -0
  163. package/dist/repertoire/duffel-client.js +185 -0
  164. package/dist/repertoire/github-client.js +14 -55
  165. package/dist/repertoire/graph-client.js +11 -52
  166. package/dist/repertoire/guardrails.js +375 -0
  167. package/dist/repertoire/mcp-client.js +255 -0
  168. package/dist/repertoire/mcp-manager.js +305 -0
  169. package/dist/repertoire/mcp-tools.js +63 -0
  170. package/dist/repertoire/shell-sessions.js +133 -0
  171. package/dist/repertoire/skills.js +14 -23
  172. package/dist/repertoire/stripe-client.js +131 -0
  173. package/dist/repertoire/tasks/board.js +43 -5
  174. package/dist/repertoire/tasks/fix.js +182 -0
  175. package/dist/repertoire/tasks/index.js +28 -10
  176. package/dist/repertoire/tasks/lifecycle.js +2 -2
  177. package/dist/repertoire/tasks/parser.js +3 -2
  178. package/dist/repertoire/tasks/scanner.js +194 -37
  179. package/dist/repertoire/tasks/transitions.js +11 -28
  180. package/dist/repertoire/tool-results.js +29 -0
  181. package/dist/repertoire/tools-attachments.js +316 -0
  182. package/dist/repertoire/tools-base.js +45 -771
  183. package/dist/repertoire/tools-bluebubbles.js +94 -0
  184. package/dist/repertoire/tools-bridge.js +141 -0
  185. package/dist/repertoire/tools-bundle.js +978 -0
  186. package/dist/repertoire/tools-config.js +185 -0
  187. package/dist/repertoire/tools-continuity.js +248 -0
  188. package/dist/repertoire/tools-credential.js +182 -0
  189. package/dist/repertoire/tools-files.js +342 -0
  190. package/dist/repertoire/tools-flight.js +224 -0
  191. package/dist/repertoire/tools-flow.js +105 -0
  192. package/dist/repertoire/tools-github.js +1 -7
  193. package/dist/repertoire/tools-memory.js +347 -0
  194. package/dist/repertoire/tools-session.js +739 -0
  195. package/dist/repertoire/tools-shell.js +120 -0
  196. package/dist/repertoire/tools-stripe.js +180 -0
  197. package/dist/repertoire/tools-surface.js +243 -0
  198. package/dist/repertoire/tools-teams.js +12 -62
  199. package/dist/repertoire/tools-travel.js +125 -0
  200. package/dist/repertoire/tools-user-profile.js +144 -0
  201. package/dist/repertoire/tools-vault.js +110 -0
  202. package/dist/repertoire/tools.js +148 -130
  203. package/dist/repertoire/travel-api-client.js +360 -0
  204. package/dist/repertoire/user-profile.js +118 -0
  205. package/dist/repertoire/vault-setup.js +241 -0
  206. package/dist/scripts/claude-code-hook.js +41 -0
  207. package/dist/scripts/claude-code-stop-hook.js +47 -0
  208. package/dist/senses/attention-queue.js +116 -0
  209. package/dist/senses/bluebubbles/attachment-cache.js +53 -0
  210. package/dist/senses/bluebubbles/attachment-download.js +137 -0
  211. package/dist/senses/{bluebubbles-client.js → bluebubbles/client.js} +143 -9
  212. package/dist/senses/bluebubbles/entry.js +13 -0
  213. package/dist/senses/bluebubbles/inbound-log.js +110 -0
  214. package/dist/senses/bluebubbles/index.js +1410 -0
  215. package/dist/senses/{bluebubbles-media.js → bluebubbles/media.js} +122 -70
  216. package/dist/senses/{bluebubbles-model.js → bluebubbles/model.js} +29 -16
  217. package/dist/senses/{bluebubbles-mutation-log.js → bluebubbles/mutation-log.js} +46 -6
  218. package/dist/senses/bluebubbles/runtime-state.js +109 -0
  219. package/dist/senses/bluebubbles/session-cleanup.js +72 -0
  220. package/dist/senses/cli/bracketed-paste.js +82 -0
  221. package/dist/senses/cli/image-paste.js +287 -0
  222. package/dist/senses/cli/image-ref-navigation.js +75 -0
  223. package/dist/senses/cli/ink-app.js +156 -0
  224. package/dist/senses/cli/inline-diff.js +64 -0
  225. package/dist/senses/cli/input-keys.js +174 -0
  226. package/dist/senses/cli/kill-ring.js +86 -0
  227. package/dist/senses/cli/message-list.js +51 -0
  228. package/dist/senses/cli/ouro-tui.js +595 -0
  229. package/dist/senses/cli/spinner-imperative.js +135 -0
  230. package/dist/senses/cli/spinner.js +101 -0
  231. package/dist/senses/cli/status-line.js +60 -0
  232. package/dist/senses/cli/streaming-markdown.js +526 -0
  233. package/dist/senses/cli/tool-display.js +83 -0
  234. package/dist/senses/cli/tool-render.js +85 -0
  235. package/dist/senses/cli/tui-store.js +240 -0
  236. package/dist/senses/cli/virtual-list.js +35 -0
  237. package/dist/senses/cli-entry.js +1 -1
  238. package/dist/senses/cli-layout.js +187 -0
  239. package/dist/senses/cli.js +588 -246
  240. package/dist/senses/commands.js +65 -1
  241. package/dist/senses/continuity.js +94 -0
  242. package/dist/senses/habit-turn-message.js +108 -0
  243. package/dist/senses/inner-dialog-worker.js +112 -19
  244. package/dist/senses/inner-dialog.js +633 -86
  245. package/dist/senses/pipeline.js +560 -0
  246. package/dist/senses/shared-turn.js +195 -0
  247. package/dist/senses/surface-tool.js +68 -0
  248. package/dist/senses/teams.js +664 -165
  249. package/dist/senses/trust-gate.js +112 -2
  250. package/package.json +14 -7
  251. package/skills/agent-commerce.md +106 -0
  252. package/skills/browser-navigation.md +110 -0
  253. package/skills/commerce-setup-guide.md +116 -0
  254. package/skills/commerce-setup.md +84 -0
  255. package/skills/configure-dev-tools.md +81 -0
  256. package/skills/travel-planning.md +138 -0
  257. package/dist/heart/daemon/subagent-installer.js +0 -134
  258. package/dist/senses/bluebubbles-entry.js +0 -11
  259. package/dist/senses/bluebubbles.js +0 -421
  260. package/dist/senses/debug-activity.js +0 -108
  261. package/subagents/README.md +0 -73
  262. package/subagents/work-doer.md +0 -235
  263. package/subagents/work-merger.md +0 -618
  264. package/subagents/work-planner.md +0 -382
  265. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/basilisk.md +0 -0
  266. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jafar.md +0 -0
  267. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jormungandr.md +0 -0
  268. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/kaa.md +0 -0
  269. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/medusa.md +0 -0
  270. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/monty.md +0 -0
  271. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/nagini.md +0 -0
  272. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/ouroboros.md +0 -0
  273. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/python.md +0 -0
  274. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/quetzalcoatl.md +0 -0
  275. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/sir-hiss.md +0 -0
  276. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-serpent.md +0 -0
  277. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-snake.md +0 -0
  278. /package/dist/heart/{daemon → hatch}/hatch-animation.js +0 -0
  279. /package/dist/heart/{daemon → hatch}/specialist-orchestrator.js +0 -0
  280. /package/dist/heart/{daemon → versioning}/ouro-uti.js +0 -0
  281. /package/dist/heart/{daemon → versioning}/wrapper-publish-guard.js +0 -0
@@ -33,52 +33,24 @@ var __importStar = (this && this.__importStar) || (function () {
33
33
  };
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
- exports.__memoryTestUtils = void 0;
37
- exports.ensureMemoryStorePaths = ensureMemoryStorePaths;
38
- exports.appendFactsWithDedup = appendFactsWithDedup;
39
- exports.readMemoryFacts = readMemoryFacts;
40
- exports.saveMemoryFact = saveMemoryFact;
36
+ exports.ensureDiaryStorePaths = ensureDiaryStorePaths;
37
+ exports.appendEntriesWithDedup = appendEntriesWithDedup;
38
+ exports.resolveDiaryRoot = resolveDiaryRoot;
39
+ exports.readDiaryEntries = readDiaryEntries;
40
+ exports.saveDiaryEntry = saveDiaryEntry;
41
41
  exports.backfillEmbeddings = backfillEmbeddings;
42
- exports.searchMemoryFacts = searchMemoryFacts;
42
+ exports.searchDiaryEntries = searchDiaryEntries;
43
43
  const fs = __importStar(require("fs"));
44
44
  const path = __importStar(require("path"));
45
45
  const crypto_1 = require("crypto");
46
- const config_1 = require("../heart/config");
47
46
  const identity_1 = require("../heart/identity");
48
47
  const runtime_1 = require("../nerves/runtime");
48
+ const associative_recall_1 = require("./associative-recall");
49
+ const embedding_provider_1 = require("./embedding-provider");
49
50
  const DEDUP_THRESHOLD = 0.6;
51
+ const SEMANTIC_DEDUP_THRESHOLD = 0.95;
50
52
  const ENTITY_TOKEN = /[a-z0-9]+/g;
51
- const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
52
- class OpenAIEmbeddingProvider {
53
- apiKey;
54
- model;
55
- constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
56
- this.apiKey = apiKey;
57
- this.model = model;
58
- }
59
- async embed(texts) {
60
- const response = await fetch("https://api.openai.com/v1/embeddings", {
61
- method: "POST",
62
- headers: {
63
- Authorization: `Bearer ${this.apiKey}`,
64
- "Content-Type": "application/json",
65
- },
66
- body: JSON.stringify({
67
- model: this.model,
68
- input: texts,
69
- }),
70
- });
71
- if (!response.ok) {
72
- throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
73
- }
74
- const payload = (await response.json());
75
- if (!payload.data || payload.data.length !== texts.length) {
76
- throw new Error("embedding response missing expected vectors");
77
- }
78
- return payload.data.map((entry) => entry.embedding);
79
- }
80
- }
81
- function ensureMemoryStorePaths(rootDir) {
53
+ function ensureDiaryStorePaths(rootDir) {
82
54
  const factsPath = path.join(rootDir, "facts.jsonl");
83
55
  const entitiesPath = path.join(rootDir, "entities.json");
84
56
  const dailyDir = path.join(rootDir, "daily");
@@ -90,8 +62,8 @@ function ensureMemoryStorePaths(rootDir) {
90
62
  fs.writeFileSync(entitiesPath, "{}\n", "utf8");
91
63
  (0, runtime_1.emitNervesEvent)({
92
64
  component: "mind",
93
- event: "mind.memory_paths_ready",
94
- message: "memory store paths ready",
65
+ event: "mind.diary_paths_ready",
66
+ message: "diary store paths ready",
95
67
  meta: { rootDir },
96
68
  });
97
69
  return { rootDir, factsPath, entitiesPath, dailyDir };
@@ -114,15 +86,22 @@ function overlapScore(left, right) {
114
86
  }
115
87
  return common / Math.min(leftWords.size, rightWords.size);
116
88
  }
117
- function readExistingFacts(factsPath) {
89
+ function readExistingEntries(factsPath) {
118
90
  if (!fs.existsSync(factsPath))
119
91
  return [];
120
92
  const raw = fs.readFileSync(factsPath, "utf8").trim();
121
93
  if (!raw)
122
94
  return [];
123
- return raw
124
- .split("\n")
125
- .map((line) => JSON.parse(line));
95
+ const facts = [];
96
+ for (const line of raw.split("\n")) {
97
+ try {
98
+ facts.push(JSON.parse(line));
99
+ }
100
+ catch {
101
+ // Skip corrupt lines (e.g. partial write from a crash).
102
+ }
103
+ }
104
+ return facts;
126
105
  }
127
106
  function readEntityIndex(entitiesPath) {
128
107
  if (!fs.existsSync(entitiesPath))
@@ -170,13 +149,24 @@ function appendDailyFact(dailyDir, fact) {
170
149
  const dayPath = path.join(dailyDir, `${day}.jsonl`);
171
150
  fs.appendFileSync(dayPath, `${JSON.stringify(fact)}\n`, "utf8");
172
151
  }
173
- function appendFactsWithDedup(stores, incoming) {
174
- const existing = readExistingFacts(stores.factsPath);
152
+ function appendEntriesWithDedup(stores, incoming, options) {
153
+ const existing = readExistingEntries(stores.factsPath);
175
154
  const all = [...existing];
176
155
  let added = 0;
177
156
  let skipped = 0;
157
+ const semanticThreshold = options?.semanticThreshold;
178
158
  for (const fact of incoming) {
179
- const duplicate = all.some((prior) => overlapScore(prior.text, fact.text) > DEDUP_THRESHOLD);
159
+ const duplicate = all.some((prior) => {
160
+ if (overlapScore(prior.text, fact.text) > DEDUP_THRESHOLD)
161
+ return true;
162
+ if (semanticThreshold !== undefined &&
163
+ Array.isArray(fact.embedding) && fact.embedding.length > 0 &&
164
+ Array.isArray(prior.embedding) && prior.embedding.length > 0 &&
165
+ fact.embedding.length === prior.embedding.length) {
166
+ return (0, associative_recall_1.cosineSimilarity)(fact.embedding, prior.embedding) > semanticThreshold;
167
+ }
168
+ return false;
169
+ });
180
170
  if (duplicate) {
181
171
  skipped++;
182
172
  continue;
@@ -189,44 +179,20 @@ function appendFactsWithDedup(stores, incoming) {
189
179
  }
190
180
  (0, runtime_1.emitNervesEvent)({
191
181
  component: "mind",
192
- event: "mind.memory_write",
193
- message: "memory write completed",
182
+ event: "mind.diary_write",
183
+ message: "diary write completed",
194
184
  meta: { added, skipped },
195
185
  });
196
186
  return { added, skipped };
197
187
  }
198
- function cosineSimilarity(left, right) {
199
- if (left.length === 0 || right.length === 0 || left.length !== right.length)
200
- return 0;
201
- let dot = 0;
202
- let leftNorm = 0;
203
- let rightNorm = 0;
204
- for (let i = 0; i < left.length; i += 1) {
205
- dot += left[i] * right[i];
206
- leftNorm += left[i] * left[i];
207
- rightNorm += right[i] * right[i];
208
- }
209
- if (leftNorm === 0 || rightNorm === 0)
210
- return 0;
211
- return dot / (Math.sqrt(leftNorm) * Math.sqrt(rightNorm));
212
- }
213
- exports.__memoryTestUtils = {
214
- cosineSimilarity,
215
- };
216
- function createDefaultEmbeddingProvider() {
217
- const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)().trim();
218
- if (!apiKey)
219
- return null;
220
- return new OpenAIEmbeddingProvider(apiKey);
221
- }
222
188
  async function buildEmbedding(text, embeddingProvider) {
223
- const provider = embeddingProvider ?? createDefaultEmbeddingProvider();
189
+ const provider = embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
224
190
  if (!provider) {
225
191
  (0, runtime_1.emitNervesEvent)({
226
192
  level: "warn",
227
193
  component: "mind",
228
- event: "mind.memory_embedding_unavailable",
229
- message: "embedding provider unavailable for memory write",
194
+ event: "mind.diary_embedding_unavailable",
195
+ message: "embedding provider unavailable for diary write",
230
196
  meta: { reason: "missing_openai_embeddings_key" },
231
197
  });
232
198
  return [];
@@ -239,8 +205,8 @@ async function buildEmbedding(text, embeddingProvider) {
239
205
  (0, runtime_1.emitNervesEvent)({
240
206
  level: "warn",
241
207
  component: "mind",
242
- event: "mind.memory_embedding_unavailable",
243
- message: "embedding provider unavailable for memory write",
208
+ event: "mind.diary_embedding_unavailable",
209
+ message: "embedding provider unavailable for diary write",
244
210
  meta: {
245
211
  reason: error instanceof Error ? error.message : String(error),
246
212
  },
@@ -248,13 +214,19 @@ async function buildEmbedding(text, embeddingProvider) {
248
214
  return [];
249
215
  }
250
216
  }
251
- function readMemoryFacts(memoryRoot = path.join((0, identity_1.getAgentRoot)(), "psyche", "memory")) {
252
- return readExistingFacts(path.join(memoryRoot, "facts.jsonl"));
217
+ function resolveDiaryRoot(explicitRoot) {
218
+ if (explicitRoot)
219
+ return explicitRoot;
220
+ const agentRoot = (0, identity_1.getAgentRoot)();
221
+ return path.join(agentRoot, "diary");
222
+ }
223
+ function readDiaryEntries(diaryRoot) {
224
+ return readExistingEntries(path.join(resolveDiaryRoot(diaryRoot), "facts.jsonl"));
253
225
  }
254
- async function saveMemoryFact(options) {
226
+ async function saveDiaryEntry(options) {
255
227
  const text = options.text.trim();
256
- const memoryRoot = options.memoryRoot ?? path.join((0, identity_1.getAgentRoot)(), "psyche", "memory");
257
- const stores = ensureMemoryStorePaths(memoryRoot);
228
+ const diaryRoot = resolveDiaryRoot(options.diaryRoot);
229
+ const stores = ensureDiaryStorePaths(diaryRoot);
258
230
  const embedding = await buildEmbedding(text, options.embeddingProvider);
259
231
  const fact = {
260
232
  id: options.idFactory ? options.idFactory() : (0, crypto_1.randomUUID)(),
@@ -264,23 +236,23 @@ async function saveMemoryFact(options) {
264
236
  createdAt: (options.now ?? (() => new Date()))().toISOString(),
265
237
  embedding,
266
238
  };
267
- return appendFactsWithDedup(stores, [fact]);
239
+ return appendEntriesWithDedup(stores, [fact], { semanticThreshold: SEMANTIC_DEDUP_THRESHOLD });
268
240
  }
269
241
  async function backfillEmbeddings(options) {
270
- const memoryRoot = options?.memoryRoot ?? path.join((0, identity_1.getAgentRoot)(), "psyche", "memory");
271
- const factsPath = path.join(memoryRoot, "facts.jsonl");
242
+ const diaryRoot = resolveDiaryRoot(options?.diaryRoot);
243
+ const factsPath = path.join(diaryRoot, "facts.jsonl");
272
244
  if (!fs.existsSync(factsPath))
273
245
  return { total: 0, backfilled: 0, failed: 0 };
274
- const facts = readExistingFacts(factsPath);
246
+ const facts = readExistingEntries(factsPath);
275
247
  const needsEmbedding = facts.filter((f) => !Array.isArray(f.embedding) || f.embedding.length === 0);
276
248
  if (needsEmbedding.length === 0)
277
249
  return { total: facts.length, backfilled: 0, failed: 0 };
278
- const provider = options?.embeddingProvider ?? createDefaultEmbeddingProvider();
250
+ const provider = options?.embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
279
251
  if (!provider) {
280
252
  (0, runtime_1.emitNervesEvent)({
281
253
  level: "warn",
282
254
  component: "mind",
283
- event: "mind.memory_backfill_skipped",
255
+ event: "mind.diary_backfill_skipped",
284
256
  message: "embedding provider unavailable for backfill",
285
257
  meta: { needsEmbedding: needsEmbedding.length },
286
258
  });
@@ -306,7 +278,7 @@ async function backfillEmbeddings(options) {
306
278
  (0, runtime_1.emitNervesEvent)({
307
279
  level: "warn",
308
280
  component: "mind",
309
- event: "mind.memory_backfill_batch_error",
281
+ event: "mind.diary_backfill_batch_error",
310
282
  message: "embedding backfill batch failed",
311
283
  meta: {
312
284
  batchStart: i,
@@ -321,7 +293,7 @@ async function backfillEmbeddings(options) {
321
293
  fs.writeFileSync(factsPath, lines, "utf8");
322
294
  (0, runtime_1.emitNervesEvent)({
323
295
  component: "mind",
324
- event: "mind.memory_backfill_complete",
296
+ event: "mind.diary_backfill_complete",
325
297
  message: "embedding backfill completed",
326
298
  meta: { total: facts.length, backfilled, failed },
327
299
  });
@@ -341,7 +313,7 @@ function uniqueFacts(facts) {
341
313
  }
342
314
  return unique;
343
315
  }
344
- async function searchMemoryFacts(query, facts, embeddingProvider) {
316
+ async function searchDiaryEntries(query, facts, embeddingProvider) {
345
317
  const trimmed = query.trim();
346
318
  if (!trimmed)
347
319
  return [];
@@ -351,7 +323,7 @@ async function searchMemoryFacts(query, facts, embeddingProvider) {
351
323
  if (embeddedFacts.length === 0) {
352
324
  return substringFallback();
353
325
  }
354
- const provider = embeddingProvider ?? createDefaultEmbeddingProvider();
326
+ const provider = embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
355
327
  if (!provider) {
356
328
  return substringFallback();
357
329
  }
@@ -365,7 +337,7 @@ async function searchMemoryFacts(query, facts, embeddingProvider) {
365
337
  .filter((fact) => fact.embedding.length === queryEmbedding.length)
366
338
  .map((fact) => ({
367
339
  fact,
368
- score: cosineSimilarity(queryEmbedding, fact.embedding),
340
+ score: (0, associative_recall_1.cosineSimilarity)(queryEmbedding, fact.embedding),
369
341
  }))
370
342
  .filter((entry) => entry.score > 0)
371
343
  .sort((left, right) => right.score - left.score)
@@ -377,8 +349,8 @@ async function searchMemoryFacts(query, facts, embeddingProvider) {
377
349
  (0, runtime_1.emitNervesEvent)({
378
350
  level: "warn",
379
351
  component: "mind",
380
- event: "mind.memory_embedding_unavailable",
381
- message: "embedding provider unavailable for memory search",
352
+ event: "mind.diary_embedding_unavailable",
353
+ message: "embedding provider unavailable for diary search",
382
354
  meta: {
383
355
  reason: error instanceof Error ? error.message : String(error),
384
356
  },
@@ -0,0 +1,60 @@
1
+ "use strict";
2
+ /**
3
+ * Shared OpenAI embedding provider.
4
+ *
5
+ * Both diary.ts and associative-recall.ts need to call the OpenAI embeddings
6
+ * API. This module provides the shared implementation so neither duplicates
7
+ * the fetch logic.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.OpenAIEmbeddingProvider = void 0;
11
+ exports.createDefaultEmbeddingProvider = createDefaultEmbeddingProvider;
12
+ const config_1 = require("../heart/config");
13
+ const runtime_1 = require("../nerves/runtime");
14
+ const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
15
+ class OpenAIEmbeddingProvider {
16
+ apiKey;
17
+ model;
18
+ constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
19
+ this.apiKey = apiKey;
20
+ this.model = model;
21
+ }
22
+ async embed(texts) {
23
+ const response = await fetch("https://api.openai.com/v1/embeddings", {
24
+ method: "POST",
25
+ headers: {
26
+ Authorization: `Bearer ${this.apiKey}`,
27
+ "Content-Type": "application/json",
28
+ },
29
+ body: JSON.stringify({
30
+ model: this.model,
31
+ input: texts,
32
+ }),
33
+ });
34
+ if (!response.ok) {
35
+ throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
36
+ }
37
+ const payload = (await response.json());
38
+ if (!payload.data || payload.data.length !== texts.length) {
39
+ throw new Error("embedding response missing expected vectors");
40
+ }
41
+ return payload.data.map((entry) => entry.embedding);
42
+ }
43
+ }
44
+ exports.OpenAIEmbeddingProvider = OpenAIEmbeddingProvider;
45
+ /**
46
+ * Create a default embedding provider from the configured API key.
47
+ * Returns null if no key is configured.
48
+ */
49
+ function createDefaultEmbeddingProvider() {
50
+ const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)().trim();
51
+ if (!apiKey)
52
+ return null;
53
+ (0, runtime_1.emitNervesEvent)({
54
+ component: "mind",
55
+ event: "mind.embedding_provider_created",
56
+ message: "default embedding provider created",
57
+ meta: { model: DEFAULT_EMBEDDING_MODEL },
58
+ });
59
+ return new OpenAIEmbeddingProvider(apiKey);
60
+ }
@@ -0,0 +1,179 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.fileStateCache = exports.FileStateCache = void 0;
4
+ exports.contentHash = contentHash;
5
+ const crypto_1 = require("crypto");
6
+ const fs_1 = require("fs");
7
+ const runtime_1 = require("../nerves/runtime");
8
+ /** Compute sha256 hex hash of content */
9
+ function contentHash(content) {
10
+ return (0, crypto_1.createHash)("sha256").update(content).digest("hex");
11
+ }
12
+ /**
13
+ * Session-scoped LRU cache tracking file reads.
14
+ * Stores content hashes (not full content) to limit memory.
15
+ * Keyed by absolute file path.
16
+ *
17
+ * Also maintains a separate snapshot list for future rewind support.
18
+ * Snapshots are indexed by content hash and linked to conversation messages.
19
+ */
20
+ class FileStateCache {
21
+ entries;
22
+ maxSize;
23
+ snapshots = [];
24
+ maxSnapshots = 100;
25
+ constructor(maxSize = 50) {
26
+ this.entries = new Map();
27
+ this.maxSize = maxSize;
28
+ }
29
+ /**
30
+ * Record a file read. Computes content hash and stores metadata.
31
+ */
32
+ record(filePath, content, mtime, offset, limit, messageId) {
33
+ // If key already exists, delete it so re-insertion moves it to end (most recent)
34
+ if (this.entries.has(filePath)) {
35
+ this.entries.delete(filePath);
36
+ }
37
+ const hash = contentHash(content);
38
+ const fullRead = offset === undefined && limit === undefined;
39
+ this.entries.set(filePath, {
40
+ hash,
41
+ mtime,
42
+ offset: fullRead ? undefined : offset,
43
+ limit: fullRead ? undefined : limit,
44
+ fullRead,
45
+ recordedAt: Date.now(),
46
+ messageId,
47
+ });
48
+ (0, runtime_1.emitNervesEvent)({
49
+ component: "mind",
50
+ event: "mind.file_state.record",
51
+ message: "recorded file state",
52
+ meta: { path: filePath, hash, fullRead },
53
+ });
54
+ // Evict LRU (first entry in Map iteration order) if over capacity
55
+ if (this.entries.size > this.maxSize) {
56
+ const firstKey = this.entries.keys().next().value;
57
+ this.entries.delete(firstKey);
58
+ }
59
+ }
60
+ /**
61
+ * Get the cached state for a file path. Also promotes it in LRU order.
62
+ */
63
+ get(filePath) {
64
+ const entry = this.entries.get(filePath);
65
+ if (entry === undefined)
66
+ return undefined;
67
+ // Promote to most-recently-used by re-inserting
68
+ this.entries.delete(filePath);
69
+ this.entries.set(filePath, entry);
70
+ (0, runtime_1.emitNervesEvent)({
71
+ component: "mind",
72
+ event: "mind.file_state.get",
73
+ message: "retrieved file state",
74
+ meta: { path: filePath, hash: entry.hash },
75
+ });
76
+ return entry;
77
+ }
78
+ /**
79
+ * Check if a file has been modified since the last recorded read.
80
+ * Uses mtime as primary signal, content hash as fallback for cloud sync / touch scenarios.
81
+ * Returns { stale: false } if the path is not in cache or the file cannot be stat'd.
82
+ */
83
+ isStale(filePath) {
84
+ const entry = this.entries.get(filePath);
85
+ if (entry === undefined)
86
+ return { stale: false };
87
+ let currentMtime;
88
+ try {
89
+ currentMtime = (0, fs_1.statSync)(filePath).mtimeMs;
90
+ }
91
+ catch {
92
+ // File doesn't exist or can't be stat'd -- no basis for staleness
93
+ return { stale: false };
94
+ }
95
+ // Fast path: mtime unchanged means not stale
96
+ if (currentMtime === entry.mtime)
97
+ return { stale: false };
98
+ // mtime differs -- check content hash as fallback (handles touch / cloud sync)
99
+ try {
100
+ const currentContent = (0, fs_1.readFileSync)(filePath, "utf-8");
101
+ const currentHash = contentHash(currentContent);
102
+ if (currentHash === entry.hash)
103
+ return { stale: false };
104
+ (0, runtime_1.emitNervesEvent)({
105
+ component: "mind",
106
+ event: "mind.file_state.stale_detected",
107
+ message: "file staleness detected",
108
+ meta: { path: filePath, previousHash: entry.hash, currentHash },
109
+ });
110
+ return { stale: true, reason: `file modified since last read (mtime and content differ)` };
111
+ }
112
+ catch {
113
+ // Can't read file -- treat as not stale (file may have been deleted)
114
+ return { stale: false };
115
+ }
116
+ }
117
+ /**
118
+ * Create a pre-edit snapshot of the current cache state for a file.
119
+ * Snapshots are stored separately from the LRU cache for future rewind support.
120
+ * Returns undefined if the path is not in cache.
121
+ */
122
+ snapshot(filePath) {
123
+ const entry = this.entries.get(filePath);
124
+ if (entry === undefined)
125
+ return undefined;
126
+ const snap = {
127
+ filePath,
128
+ hash: entry.hash,
129
+ mtime: entry.mtime,
130
+ messageId: entry.messageId,
131
+ createdAt: Date.now(),
132
+ };
133
+ this.snapshots.push(snap);
134
+ (0, runtime_1.emitNervesEvent)({
135
+ component: "mind",
136
+ event: "mind.file_state.snapshot_created",
137
+ message: "created file state snapshot",
138
+ meta: { path: filePath, hash: snap.hash },
139
+ });
140
+ // Evict oldest snapshots if over capacity
141
+ if (this.snapshots.length > this.maxSnapshots) {
142
+ this.snapshots = this.snapshots.slice(this.snapshots.length - this.maxSnapshots);
143
+ }
144
+ return snap;
145
+ }
146
+ /**
147
+ * Get all snapshots in creation order.
148
+ */
149
+ getSnapshots() {
150
+ return this.snapshots;
151
+ }
152
+ /**
153
+ * Look up a snapshot by content hash. Returns the first match.
154
+ */
155
+ lookupSnapshotByHash(hash) {
156
+ return this.snapshots.find(s => s.hash === hash);
157
+ }
158
+ /**
159
+ * Clear all snapshots.
160
+ */
161
+ clearSnapshots() {
162
+ this.snapshots = [];
163
+ }
164
+ /**
165
+ * Clear all cached entries (does not clear snapshots).
166
+ */
167
+ clear() {
168
+ (0, runtime_1.emitNervesEvent)({
169
+ component: "mind",
170
+ event: "mind.file_state.clear",
171
+ message: "cleared file state cache",
172
+ meta: { entryCount: this.entries.size },
173
+ });
174
+ this.entries.clear();
175
+ }
176
+ }
177
+ exports.FileStateCache = FileStateCache;
178
+ /** Session-scoped singleton instance used by tool handlers */
179
+ exports.fileStateCache = new FileStateCache();
@@ -11,9 +11,22 @@ exports.ONBOARDING_TOKEN_THRESHOLD = 100_000;
11
11
  function isOnboarding(friend) {
12
12
  return (friend.totalTokens ?? 0) < exports.ONBOARDING_TOKEN_THRESHOLD;
13
13
  }
14
- function getFirstImpressions(friend) {
14
+ function hasLiveContinuityPressure(state) {
15
+ if (!state)
16
+ return false;
17
+ if (typeof state.currentObligation === "string" && state.currentObligation.trim().length > 0)
18
+ return true;
19
+ if (state.mustResolveBeforeHandoff === true)
20
+ return true;
21
+ if (state.hasQueuedFollowUp === true)
22
+ return true;
23
+ return false;
24
+ }
25
+ function getFirstImpressions(friend, state) {
15
26
  if (!isOnboarding(friend))
16
27
  return "";
28
+ if (hasLiveContinuityPressure(state))
29
+ return "";
17
30
  (0, runtime_1.emitNervesEvent)({
18
31
  component: "mind",
19
32
  event: "mind.first_impressions",
@@ -2,11 +2,26 @@
2
2
  // Channel capabilities -- hardcoded const map keyed by channel identifier.
3
3
  // Pure lookup, no I/O, cannot fail. Unknown channel gets minimal defaults.
4
4
  Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.channelToFacing = channelToFacing;
5
6
  exports.getChannelCapabilities = getChannelCapabilities;
7
+ exports.isRemoteChannel = isRemoteChannel;
8
+ exports.getAlwaysOnSenseNames = getAlwaysOnSenseNames;
6
9
  const runtime_1 = require("../../nerves/runtime");
10
+ const AGENT_FACING_CHANNELS = new Set(["inner", "mcp"]);
11
+ function channelToFacing(channel) {
12
+ const facing = channel && AGENT_FACING_CHANNELS.has(channel) ? "agent" : "human";
13
+ (0, runtime_1.emitNervesEvent)({
14
+ component: "channels",
15
+ event: "channel.facing_lookup",
16
+ message: "channel facing lookup",
17
+ meta: { channel: channel ?? "undefined", facing },
18
+ });
19
+ return facing;
20
+ }
7
21
  const CHANNEL_CAPABILITIES = {
8
22
  cli: {
9
23
  channel: "cli",
24
+ senseType: "local",
10
25
  availableIntegrations: [],
11
26
  supportsMarkdown: false,
12
27
  supportsStreaming: true,
@@ -15,6 +30,7 @@ const CHANNEL_CAPABILITIES = {
15
30
  },
16
31
  teams: {
17
32
  channel: "teams",
33
+ senseType: "closed",
18
34
  availableIntegrations: ["ado", "graph", "github"],
19
35
  supportsMarkdown: true,
20
36
  supportsStreaming: true,
@@ -23,15 +39,35 @@ const CHANNEL_CAPABILITIES = {
23
39
  },
24
40
  bluebubbles: {
25
41
  channel: "bluebubbles",
42
+ senseType: "open",
26
43
  availableIntegrations: [],
27
44
  supportsMarkdown: false,
28
45
  supportsStreaming: false,
29
46
  supportsRichCards: false,
30
47
  maxMessageLength: Infinity,
31
48
  },
49
+ inner: {
50
+ channel: "inner",
51
+ senseType: "internal",
52
+ availableIntegrations: [],
53
+ supportsMarkdown: false,
54
+ supportsStreaming: true,
55
+ supportsRichCards: false,
56
+ maxMessageLength: Infinity,
57
+ },
58
+ mcp: {
59
+ channel: "mcp",
60
+ senseType: "local",
61
+ availableIntegrations: [],
62
+ supportsMarkdown: true,
63
+ supportsStreaming: false,
64
+ supportsRichCards: false,
65
+ maxMessageLength: Infinity,
66
+ },
32
67
  };
33
68
  const DEFAULT_CAPABILITIES = {
34
69
  channel: "cli",
70
+ senseType: "local",
35
71
  availableIntegrations: [],
36
72
  supportsMarkdown: false,
37
73
  supportsStreaming: false,
@@ -47,3 +83,23 @@ function getChannelCapabilities(channel) {
47
83
  });
48
84
  return CHANNEL_CAPABILITIES[channel] ?? DEFAULT_CAPABILITIES;
49
85
  }
86
+ /** Whether the channel is remote (open or closed) vs local/internal. */
87
+ function isRemoteChannel(capabilities) {
88
+ const senseType = capabilities?.senseType;
89
+ return senseType !== undefined && senseType !== "local" && senseType !== "internal";
90
+ }
91
+ /**
92
+ * Returns channel names whose senseType is "open" or "closed" -- i.e. channels
93
+ * that are always-on (daemon-managed) rather than interactive or internal.
94
+ */
95
+ function getAlwaysOnSenseNames() {
96
+ (0, runtime_1.emitNervesEvent)({
97
+ component: "channels",
98
+ event: "channel.always_on_lookup",
99
+ message: "always-on sense names lookup",
100
+ meta: {},
101
+ });
102
+ return Object.entries(CHANNEL_CAPABILITIES)
103
+ .filter(([, cap]) => cap.senseType === "open" || cap.senseType === "closed")
104
+ .map(([channel]) => channel);
105
+ }