@ouro.bot/cli 0.1.0-alpha.66 → 0.1.0-alpha.660

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 (449) hide show
  1. package/README.md +127 -23
  2. package/RepairGuide.ouro/agent.json +5 -0
  3. package/RepairGuide.ouro/psyche/IDENTITY.md +19 -0
  4. package/RepairGuide.ouro/psyche/SOUL.md +55 -0
  5. package/RepairGuide.ouro/skills/diagnose-broken-remote.md +63 -0
  6. package/RepairGuide.ouro/skills/diagnose-stacked-typed-issues.md +35 -0
  7. package/RepairGuide.ouro/skills/diagnose-sync-blocked.md +54 -0
  8. package/RepairGuide.ouro/skills/diagnose-vault-expired.md +60 -0
  9. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/agent.json +4 -2
  10. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/SOUL.md +2 -2
  11. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-serpent.md +1 -1
  12. package/changelog.json +4209 -13
  13. package/dist/a2a/card.js +56 -0
  14. package/dist/a2a/client.js +143 -0
  15. package/dist/a2a/config.js +50 -0
  16. package/dist/a2a/onboarding.js +111 -0
  17. package/dist/a2a/server.js +498 -0
  18. package/dist/a2a/task-store.js +69 -0
  19. package/dist/a2a/types.js +3 -0
  20. package/dist/arc/attention-types.js +8 -0
  21. package/dist/arc/cares.js +144 -0
  22. package/dist/arc/episodes.js +118 -0
  23. package/dist/arc/evolution.js +487 -0
  24. package/dist/arc/flight-recorder.js +369 -0
  25. package/dist/arc/intentions.js +134 -0
  26. package/dist/arc/json-store.js +117 -0
  27. package/dist/arc/obligations.js +292 -0
  28. package/dist/arc/packets.js +288 -0
  29. package/dist/arc/presence.js +185 -0
  30. package/dist/arc/task-lifecycle.js +57 -0
  31. package/dist/commerce/store.js +755 -0
  32. package/dist/commerce/types.js +3 -0
  33. package/dist/heart/active-work.js +860 -43
  34. package/dist/heart/agent-entry.js +69 -3
  35. package/dist/heart/attachments/image-normalize.js +194 -0
  36. package/dist/heart/attachments/materialize.js +97 -0
  37. package/dist/heart/attachments/originals.js +88 -0
  38. package/dist/heart/attachments/render.js +29 -0
  39. package/dist/heart/attachments/sources/bluebubbles.js +156 -0
  40. package/dist/heart/attachments/sources/cli-local-file.js +78 -0
  41. package/dist/heart/attachments/sources/index.js +16 -0
  42. package/dist/heart/attachments/store.js +103 -0
  43. package/dist/heart/attachments/types.js +93 -0
  44. package/dist/heart/auth/auth-flow.js +479 -0
  45. package/dist/heart/awaiting/await-alert.js +146 -0
  46. package/dist/heart/awaiting/await-expiry.js +108 -0
  47. package/dist/heart/awaiting/await-loader.js +91 -0
  48. package/dist/heart/awaiting/await-parser.js +141 -0
  49. package/dist/heart/awaiting/await-runtime-state.js +100 -0
  50. package/dist/heart/awaiting/await-scheduler.js +377 -0
  51. package/dist/heart/background-operations.js +281 -0
  52. package/dist/heart/bridges/manager.js +137 -17
  53. package/dist/heart/bridges/store.js +14 -2
  54. package/dist/heart/bundle-state.js +168 -0
  55. package/dist/heart/commitments.js +135 -0
  56. package/dist/heart/config-registry.js +331 -0
  57. package/dist/heart/config.js +118 -119
  58. package/dist/heart/context-loss-gauntlet.js +354 -0
  59. package/dist/heart/core.js +1123 -247
  60. package/dist/heart/cross-chat-delivery.js +3 -18
  61. package/dist/heart/daemon/agent-config-check.js +419 -0
  62. package/dist/heart/daemon/agent-discovery.js +102 -3
  63. package/dist/heart/daemon/agent-service.js +523 -0
  64. package/dist/heart/daemon/agentic-repair.js +547 -0
  65. package/dist/heart/daemon/bluebubbles-health-diagnostics.js +122 -0
  66. package/dist/heart/daemon/boot-sync-probe.js +197 -0
  67. package/dist/heart/daemon/cadence.js +70 -0
  68. package/dist/heart/daemon/cli-defaults.js +780 -0
  69. package/dist/heart/daemon/cli-desk.js +322 -0
  70. package/dist/heart/daemon/cli-exec.js +7767 -0
  71. package/dist/heart/daemon/cli-help.js +558 -0
  72. package/dist/heart/daemon/cli-parse.js +1688 -0
  73. package/dist/heart/daemon/cli-render-doctor.js +57 -0
  74. package/dist/heart/daemon/cli-render.js +763 -0
  75. package/dist/heart/daemon/cli-types.js +8 -0
  76. package/dist/heart/daemon/connect-bay.js +323 -0
  77. package/dist/heart/daemon/daemon-cli.js +29 -1750
  78. package/dist/heart/daemon/daemon-entry.js +485 -2
  79. package/dist/heart/daemon/daemon-health.js +176 -0
  80. package/dist/heart/daemon/daemon-rollup.js +57 -0
  81. package/dist/heart/daemon/daemon-runtime-sync.js +88 -13
  82. package/dist/heart/daemon/daemon-tombstone.js +236 -0
  83. package/dist/heart/daemon/daemon.js +937 -74
  84. package/dist/heart/daemon/dns-workflow.js +394 -0
  85. package/dist/heart/daemon/doctor-types.js +8 -0
  86. package/dist/heart/daemon/doctor.js +873 -0
  87. package/dist/heart/daemon/health-monitor.js +122 -1
  88. package/dist/heart/daemon/hooks/agent-config-v2.js +33 -0
  89. package/dist/heart/daemon/hooks/bundle-meta.js +135 -1
  90. package/dist/heart/daemon/http-health-probe.js +80 -0
  91. package/dist/heart/daemon/human-command-screens.js +234 -0
  92. package/dist/heart/daemon/human-readiness.js +114 -0
  93. package/dist/heart/daemon/inner-status.js +78 -0
  94. package/dist/heart/daemon/interactive-repair.js +394 -0
  95. package/dist/heart/daemon/launchd.js +37 -8
  96. package/dist/heart/daemon/log-tailer.js +79 -10
  97. package/dist/heart/daemon/logs-prune.js +110 -0
  98. package/dist/heart/daemon/mcp-canary.js +297 -0
  99. package/dist/heart/daemon/message-router.js +6 -2
  100. package/dist/heart/daemon/migrate-to-desk.js +848 -0
  101. package/dist/heart/daemon/os-cron-deps.js +135 -0
  102. package/dist/heart/daemon/os-cron.js +14 -12
  103. package/dist/heart/daemon/ouro-bot-entry.js +4 -2
  104. package/dist/heart/daemon/ouro-entry.js +3 -1
  105. package/dist/heart/daemon/plugin-cli.js +432 -0
  106. package/dist/heart/daemon/process-manager.js +511 -40
  107. package/dist/heart/daemon/provider-discovery.js +137 -0
  108. package/dist/heart/daemon/provider-ping-progress.js +83 -0
  109. package/dist/heart/daemon/pulse.js +475 -0
  110. package/dist/heart/daemon/readiness-repair.js +365 -0
  111. package/dist/heart/daemon/run-hooks.js +2 -0
  112. package/dist/heart/daemon/runtime-logging.js +35 -14
  113. package/dist/heart/daemon/runtime-metadata.js +2 -30
  114. package/dist/heart/daemon/safe-mode.js +161 -0
  115. package/dist/heart/daemon/sense-manager.js +564 -38
  116. package/dist/heart/daemon/session-id-resolver.js +131 -0
  117. package/dist/heart/daemon/skill-management-installer.js +1 -1
  118. package/dist/heart/daemon/socket-client.js +158 -11
  119. package/dist/heart/daemon/stale-bundle-prune.js +96 -0
  120. package/dist/heart/daemon/startup-tui.js +330 -0
  121. package/dist/heart/daemon/task-scheduler.js +117 -39
  122. package/dist/heart/daemon/terminal-ui.js +499 -0
  123. package/dist/heart/daemon/thoughts.js +229 -17
  124. package/dist/heart/daemon/up-progress.js +366 -0
  125. package/dist/heart/daemon/vault-items.js +56 -0
  126. package/dist/heart/delegation.js +1 -4
  127. package/dist/heart/habits/habit-migration.js +189 -0
  128. package/dist/heart/habits/habit-parser.js +203 -0
  129. package/dist/heart/habits/habit-runtime-state.js +100 -0
  130. package/dist/heart/habits/habit-scheduler.js +372 -0
  131. package/dist/heart/{daemon → hatch}/hatch-flow.js +40 -56
  132. package/dist/heart/{daemon → hatch}/hatch-specialist.js +6 -8
  133. package/dist/heart/{daemon → hatch}/specialist-prompt.js +12 -9
  134. package/dist/heart/{daemon → hatch}/specialist-tools.js +45 -18
  135. package/dist/heart/identity.js +174 -57
  136. package/dist/heart/kept-notes.js +289 -0
  137. package/dist/heart/kicks.js +1 -1
  138. package/dist/heart/machine-identity.js +161 -0
  139. package/dist/heart/mail-import-discovery.js +353 -0
  140. package/dist/heart/mailbox/mailbox-http-hooks.js +67 -0
  141. package/dist/heart/mailbox/mailbox-http-response.js +7 -0
  142. package/dist/heart/mailbox/mailbox-http-routes.js +250 -0
  143. package/dist/heart/mailbox/mailbox-http-static.js +103 -0
  144. package/dist/heart/mailbox/mailbox-http-transport.js +116 -0
  145. package/dist/heart/mailbox/mailbox-http.js +99 -0
  146. package/dist/heart/mailbox/mailbox-read.js +32 -0
  147. package/dist/heart/mailbox/mailbox-types.js +27 -0
  148. package/dist/heart/mailbox/mailbox-view.js +197 -0
  149. package/dist/heart/mailbox/readers/agent-machine.js +418 -0
  150. package/dist/heart/mailbox/readers/continuity-readers.js +324 -0
  151. package/dist/heart/mailbox/readers/mail.js +375 -0
  152. package/dist/heart/mailbox/readers/runtime-readers.js +728 -0
  153. package/dist/heart/mailbox/readers/sessions.js +232 -0
  154. package/dist/heart/mailbox/readers/shared.js +111 -0
  155. package/dist/heart/mcp/mcp-server.js +696 -0
  156. package/dist/heart/migrate-config.js +100 -0
  157. package/dist/heart/model-capabilities.js +19 -0
  158. package/dist/heart/orientation-frame.js +217 -0
  159. package/dist/heart/platform.js +81 -0
  160. package/dist/heart/provider-attempt.js +134 -0
  161. package/dist/heart/provider-binding-resolver.js +272 -0
  162. package/dist/heart/provider-credentials.js +425 -0
  163. package/dist/heart/provider-failover.js +311 -0
  164. package/dist/heart/provider-models.js +81 -0
  165. package/dist/heart/provider-ping.js +262 -0
  166. package/dist/heart/provider-readiness-cache.js +40 -0
  167. package/dist/heart/provider-visibility.js +188 -0
  168. package/dist/heart/providers/anthropic-token.js +131 -0
  169. package/dist/heart/providers/anthropic.js +139 -52
  170. package/dist/heart/providers/azure.js +23 -11
  171. package/dist/heart/providers/error-classification.js +127 -0
  172. package/dist/heart/providers/github-copilot.js +145 -0
  173. package/dist/heart/providers/minimax-vlm.js +189 -0
  174. package/dist/heart/providers/minimax.js +26 -8
  175. package/dist/heart/providers/openai-codex-token.js +349 -0
  176. package/dist/heart/providers/openai-codex.js +55 -40
  177. package/dist/heart/runtime-capability-check.js +170 -0
  178. package/dist/heart/runtime-credentials.js +367 -0
  179. package/dist/heart/runtime-cwd.js +87 -0
  180. package/dist/heart/sense-truth.js +17 -4
  181. package/dist/heart/session-activity.js +48 -24
  182. package/dist/heart/session-events.js +1133 -0
  183. package/dist/heart/session-playback-cli-main.js +5 -0
  184. package/dist/heart/session-playback-cli.js +36 -0
  185. package/dist/heart/session-playback.js +231 -0
  186. package/dist/heart/session-stats-cli-main.js +5 -0
  187. package/dist/heart/session-stats.js +182 -0
  188. package/dist/heart/session-transcript.js +133 -0
  189. package/dist/heart/start-of-turn-packet.js +351 -0
  190. package/dist/heart/streaming.js +44 -27
  191. package/dist/heart/structured-output.js +196 -0
  192. package/dist/heart/sync-classification.js +176 -0
  193. package/dist/heart/sync.js +449 -0
  194. package/dist/heart/target-resolution.js +9 -5
  195. package/dist/heart/tempo.js +93 -0
  196. package/dist/heart/temporal-view.js +41 -0
  197. package/dist/heart/timeouts.js +101 -0
  198. package/dist/heart/tool-activity-callbacks.js +59 -0
  199. package/dist/heart/tool-description.js +155 -0
  200. package/dist/heart/tool-friction.js +55 -0
  201. package/dist/heart/tool-loop.js +200 -0
  202. package/dist/heart/turn-context.js +430 -0
  203. package/dist/heart/{daemon → versioning}/ouro-bot-global-installer.js +6 -5
  204. package/dist/heart/{daemon → versioning}/ouro-bot-wrapper.js +1 -1
  205. package/dist/heart/versioning/ouro-path-installer.js +426 -0
  206. package/dist/heart/versioning/ouro-version-manager.js +409 -0
  207. package/dist/heart/{daemon → versioning}/staged-restart.js +40 -8
  208. package/dist/heart/{daemon → versioning}/update-checker.js +6 -1
  209. package/dist/heart/versioning/update-hooks.js +154 -0
  210. package/dist/heart/work-card.js +386 -0
  211. package/dist/mailbox-ui/assets/index-B-V9vRQ0.js +61 -0
  212. package/dist/mailbox-ui/assets/index-BOZbGbkL.css +1 -0
  213. package/dist/mailbox-ui/index.html +15 -0
  214. package/dist/mailroom/attention.js +167 -0
  215. package/dist/mailroom/autonomy.js +209 -0
  216. package/dist/mailroom/blob-store.js +715 -0
  217. package/dist/mailroom/body-cache.js +61 -0
  218. package/dist/mailroom/core.js +788 -0
  219. package/dist/mailroom/entry.js +160 -0
  220. package/dist/mailroom/file-store.js +568 -0
  221. package/dist/mailroom/mbox-import.js +393 -0
  222. package/dist/mailroom/migration.js +164 -0
  223. package/dist/mailroom/outbound.js +380 -0
  224. package/dist/mailroom/policy.js +263 -0
  225. package/dist/mailroom/reader.js +233 -0
  226. package/dist/mailroom/search-cache.js +334 -0
  227. package/dist/mailroom/search-relevance.js +319 -0
  228. package/dist/mailroom/smtp-ingress.js +176 -0
  229. package/dist/mailroom/source-state.js +176 -0
  230. package/dist/mailroom/thread.js +109 -0
  231. package/dist/mailroom/travel-extract.js +89 -0
  232. package/dist/mind/bundle-manifest.js +21 -2
  233. package/dist/mind/context.js +250 -101
  234. package/dist/mind/desk-section.js +362 -0
  235. package/dist/mind/diary-integrity.js +60 -0
  236. package/dist/mind/{memory.js → diary.js} +68 -77
  237. package/dist/mind/embedding-provider.js +60 -0
  238. package/dist/mind/file-state.js +179 -0
  239. package/dist/mind/friends/channel.js +48 -0
  240. package/dist/mind/friends/resolver.js +67 -4
  241. package/dist/mind/friends/store-file.js +61 -4
  242. package/dist/mind/friends/types.js +2 -2
  243. package/dist/mind/{associative-recall.js → note-search.js} +47 -58
  244. package/dist/mind/obligation-steering.js +221 -0
  245. package/dist/mind/pending.js +6 -1
  246. package/dist/mind/prompt-refresh.js +3 -2
  247. package/dist/mind/prompt.js +1015 -140
  248. package/dist/mind/provenance-trust.js +26 -0
  249. package/dist/mind/record-paths.js +312 -0
  250. package/dist/mind/scrutiny.js +173 -0
  251. package/dist/nerves/cli-logging.js +7 -1
  252. package/dist/nerves/coverage/audit-rules.js +15 -6
  253. package/dist/nerves/coverage/audit.js +28 -2
  254. package/dist/nerves/coverage/cli.js +1 -1
  255. package/dist/nerves/coverage/contract.js +5 -5
  256. package/dist/nerves/coverage/file-completeness.js +139 -5
  257. package/dist/nerves/event-buffer.js +111 -0
  258. package/dist/nerves/index.js +224 -4
  259. package/dist/nerves/observation.js +20 -0
  260. package/dist/nerves/redact.js +79 -0
  261. package/dist/nerves/review/cli-main.js +5 -0
  262. package/dist/nerves/review/cli.js +156 -0
  263. package/dist/nerves/review/core.js +152 -0
  264. package/dist/nerves/runtime.js +5 -1
  265. package/dist/repertoire/ado-client.js +15 -56
  266. package/dist/repertoire/ado-semantic.js +16 -10
  267. package/dist/repertoire/api-client.js +97 -0
  268. package/dist/repertoire/bitwarden-store.js +1041 -0
  269. package/dist/repertoire/bundle-templates.js +71 -0
  270. package/dist/repertoire/bw-installer.js +180 -0
  271. package/dist/repertoire/coding/codex-jsonl.js +64 -0
  272. package/dist/repertoire/coding/context-pack.js +331 -0
  273. package/dist/repertoire/coding/feedback.js +197 -30
  274. package/dist/repertoire/coding/manager.js +166 -10
  275. package/dist/repertoire/coding/spawner.js +55 -9
  276. package/dist/repertoire/coding/tools.js +219 -7
  277. package/dist/repertoire/commerce-errors.js +109 -0
  278. package/dist/repertoire/commerce-self-test.js +156 -0
  279. package/dist/repertoire/credential-access.js +178 -0
  280. package/dist/repertoire/desk/classifier.js +362 -0
  281. package/dist/repertoire/duffel-client.js +185 -0
  282. package/dist/repertoire/github-client.js +14 -55
  283. package/dist/repertoire/graph-client.js +11 -52
  284. package/dist/repertoire/guardrails.js +159 -25
  285. package/dist/repertoire/mcp-client.js +295 -0
  286. package/dist/repertoire/mcp-manager.js +434 -0
  287. package/dist/repertoire/mcp-tools.js +83 -0
  288. package/dist/repertoire/plugin-mcp.js +175 -0
  289. package/dist/repertoire/plugins.js +253 -0
  290. package/dist/repertoire/shell-sessions.js +133 -0
  291. package/dist/repertoire/skills.js +48 -4
  292. package/dist/repertoire/stripe-client.js +131 -0
  293. package/dist/repertoire/tool-results.js +29 -0
  294. package/dist/repertoire/tools-a2a.js +283 -0
  295. package/dist/repertoire/tools-attachments.js +317 -0
  296. package/dist/repertoire/tools-awaiting.js +372 -0
  297. package/dist/repertoire/tools-base.js +63 -1082
  298. package/dist/repertoire/tools-bluebubbles.js +2 -0
  299. package/dist/repertoire/tools-bridge.js +144 -0
  300. package/dist/repertoire/tools-bundle.js +993 -0
  301. package/dist/repertoire/tools-commerce.js +253 -0
  302. package/dist/repertoire/tools-config.js +186 -0
  303. package/dist/repertoire/tools-continuity.js +252 -0
  304. package/dist/repertoire/tools-credential.js +383 -0
  305. package/dist/repertoire/tools-evolution.js +527 -0
  306. package/dist/repertoire/tools-files.js +344 -0
  307. package/dist/repertoire/tools-flight.js +290 -0
  308. package/dist/repertoire/tools-flow.js +119 -0
  309. package/dist/repertoire/tools-github.js +3 -8
  310. package/dist/repertoire/tools-mail.js +1975 -0
  311. package/dist/repertoire/tools-notes.js +418 -0
  312. package/dist/repertoire/tools-obligations.js +143 -0
  313. package/dist/repertoire/tools-orientation.js +31 -0
  314. package/dist/repertoire/tools-record.js +469 -0
  315. package/dist/repertoire/tools-runtime.js +150 -0
  316. package/dist/repertoire/tools-session.js +766 -0
  317. package/dist/repertoire/tools-shell.js +120 -0
  318. package/dist/repertoire/tools-stripe.js +224 -0
  319. package/dist/repertoire/tools-surface.js +344 -0
  320. package/dist/repertoire/tools-teams.js +12 -39
  321. package/dist/repertoire/tools-travel.js +125 -0
  322. package/dist/repertoire/tools-trip.js +982 -0
  323. package/dist/repertoire/tools-user-profile.js +146 -0
  324. package/dist/repertoire/tools-vault.js +40 -0
  325. package/dist/repertoire/tools-voice.js +145 -0
  326. package/dist/repertoire/tools.js +243 -79
  327. package/dist/repertoire/travel-api-client.js +360 -0
  328. package/dist/repertoire/user-profile.js +131 -0
  329. package/dist/repertoire/vault-setup.js +246 -0
  330. package/dist/repertoire/vault-unlock.js +594 -0
  331. package/dist/scripts/claude-code-hook.js +41 -0
  332. package/dist/scripts/claude-code-stop-hook.js +47 -0
  333. package/dist/senses/a2a-entry.js +78 -0
  334. package/dist/senses/attention-queue.js +186 -0
  335. package/dist/senses/await-turn-message.js +58 -0
  336. package/dist/senses/bluebubbles/active-turns.js +216 -0
  337. package/dist/senses/bluebubbles/attachment-cache.js +53 -0
  338. package/dist/senses/bluebubbles/attachment-download.js +137 -0
  339. package/dist/senses/{bluebubbles-client.js → bluebubbles/client.js} +219 -18
  340. package/dist/senses/bluebubbles/entry.js +77 -0
  341. package/dist/senses/{bluebubbles-inbound-log.js → bluebubbles/inbound-log.js} +20 -3
  342. package/dist/senses/bluebubbles/index.js +2737 -0
  343. package/dist/senses/{bluebubbles-media.js → bluebubbles/media.js} +121 -71
  344. package/dist/senses/{bluebubbles-model.js → bluebubbles/model.js} +33 -12
  345. package/dist/senses/{bluebubbles-mutation-log.js → bluebubbles/mutation-log.js} +3 -3
  346. package/dist/senses/bluebubbles/processed-log.js +133 -0
  347. package/dist/senses/bluebubbles/replay.js +137 -0
  348. package/dist/senses/{bluebubbles-runtime-state.js → bluebubbles/runtime-state.js} +30 -2
  349. package/dist/senses/{bluebubbles-session-cleanup.js → bluebubbles/session-cleanup.js} +1 -1
  350. package/dist/senses/bluebubbles-meta-guard.js +40 -0
  351. package/dist/senses/cli/bracketed-paste.js +82 -0
  352. package/dist/senses/cli/image-paste.js +287 -0
  353. package/dist/senses/cli/image-ref-navigation.js +75 -0
  354. package/dist/senses/cli/ink-app.js +156 -0
  355. package/dist/senses/cli/inline-diff.js +64 -0
  356. package/dist/senses/cli/input-keys.js +174 -0
  357. package/dist/senses/cli/kill-ring.js +86 -0
  358. package/dist/senses/cli/message-list.js +51 -0
  359. package/dist/senses/cli/ouro-tui.js +607 -0
  360. package/dist/senses/cli/spinner-imperative.js +135 -0
  361. package/dist/senses/cli/spinner.js +101 -0
  362. package/dist/senses/cli/status-line.js +60 -0
  363. package/dist/senses/cli/streaming-markdown.js +526 -0
  364. package/dist/senses/cli/tool-display.js +85 -0
  365. package/dist/senses/cli/tool-render.js +85 -0
  366. package/dist/senses/cli/tui-store.js +240 -0
  367. package/dist/senses/cli/virtual-list.js +35 -0
  368. package/dist/senses/cli-entry.js +60 -8
  369. package/dist/senses/cli-layout.js +100 -0
  370. package/dist/senses/cli.js +517 -204
  371. package/dist/senses/commands.js +66 -3
  372. package/dist/senses/habit-turn-message.js +122 -0
  373. package/dist/senses/inner-dialog-worker.js +303 -22
  374. package/dist/senses/inner-dialog.js +525 -41
  375. package/dist/senses/mail-entry.js +66 -0
  376. package/dist/senses/mail.js +379 -0
  377. package/dist/senses/pipeline.js +857 -180
  378. package/dist/senses/proactive-content-guard.js +51 -0
  379. package/dist/senses/shared-turn.js +419 -0
  380. package/dist/senses/surface-tool.js +108 -0
  381. package/dist/senses/teams-entry.js +60 -8
  382. package/dist/senses/teams.js +390 -98
  383. package/dist/senses/trust-gate.js +100 -5
  384. package/dist/senses/voice/audio-playback.js +237 -0
  385. package/dist/senses/voice/audio-routing.js +119 -0
  386. package/dist/senses/voice/elevenlabs.js +202 -0
  387. package/dist/senses/voice/floor-control.js +431 -0
  388. package/dist/senses/voice/floor-controller.js +115 -0
  389. package/dist/senses/voice/golden-path.js +116 -0
  390. package/dist/senses/voice/index.js +29 -0
  391. package/dist/senses/voice/meeting.js +113 -0
  392. package/dist/senses/voice/outbound.js +190 -0
  393. package/dist/senses/voice/phone.js +33 -0
  394. package/dist/senses/voice/playback.js +139 -0
  395. package/dist/senses/voice/realtime-eval.js +496 -0
  396. package/dist/senses/voice/realtime-trace.js +531 -0
  397. package/dist/senses/voice/transcript.js +70 -0
  398. package/dist/senses/voice/turn.js +191 -0
  399. package/dist/senses/voice/twilio-phone-runtime.js +807 -0
  400. package/dist/senses/voice/twilio-phone.js +5079 -0
  401. package/dist/senses/voice/types.js +2 -0
  402. package/dist/senses/voice/whisper.js +161 -0
  403. package/dist/senses/voice-entry.js +81 -0
  404. package/dist/senses/voice-realtime-eval-command.js +99 -0
  405. package/dist/senses/voice-realtime-eval-entry.js +21 -0
  406. package/dist/senses/voice-twilio-entry.js +87 -0
  407. package/dist/trips/core.js +138 -0
  408. package/dist/trips/store.js +265 -0
  409. package/dist/util/frontmatter.js +69 -0
  410. package/package.json +55 -12
  411. package/skills/agent-commerce.md +113 -0
  412. package/skills/browser-navigation.md +117 -0
  413. package/skills/commerce-setup-guide.md +116 -0
  414. package/skills/commerce-setup.md +84 -0
  415. package/skills/configure-dev-tools.md +99 -0
  416. package/skills/travel-planning.md +138 -0
  417. package/dist/heart/daemon/auth-flow.js +0 -351
  418. package/dist/heart/daemon/ouro-path-installer.js +0 -178
  419. package/dist/heart/daemon/update-hooks.js +0 -138
  420. package/dist/heart/safe-workspace.js +0 -228
  421. package/dist/heart/session-recall.js +0 -116
  422. package/dist/repertoire/tasks/board.js +0 -134
  423. package/dist/repertoire/tasks/index.js +0 -224
  424. package/dist/repertoire/tasks/lifecycle.js +0 -80
  425. package/dist/repertoire/tasks/middleware.js +0 -65
  426. package/dist/repertoire/tasks/parser.js +0 -173
  427. package/dist/repertoire/tasks/scanner.js +0 -132
  428. package/dist/repertoire/tasks/transitions.js +0 -144
  429. package/dist/senses/bluebubbles-entry.js +0 -13
  430. package/dist/senses/bluebubbles.js +0 -1177
  431. package/dist/senses/debug-activity.js +0 -148
  432. package/subagents/README.md +0 -7
  433. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/basilisk.md +0 -0
  434. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jafar.md +0 -0
  435. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jormungandr.md +0 -0
  436. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/kaa.md +0 -0
  437. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/medusa.md +0 -0
  438. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/monty.md +0 -0
  439. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/nagini.md +0 -0
  440. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/ouroboros.md +0 -0
  441. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/python.md +0 -0
  442. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/quetzalcoatl.md +0 -0
  443. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/sir-hiss.md +0 -0
  444. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-snake.md +0 -0
  445. /package/dist/{repertoire/tasks/types.js → heart/attachments/sources/adapter.js} +0 -0
  446. /package/dist/heart/{daemon → hatch}/hatch-animation.js +0 -0
  447. /package/dist/heart/{daemon → hatch}/specialist-orchestrator.js +0 -0
  448. /package/dist/heart/{daemon → versioning}/ouro-uti.js +0 -0
  449. /package/dist/heart/{daemon → versioning}/wrapper-publish-guard.js +0 -0
@@ -4,58 +4,525 @@
4
4
  // resolve friend -> trust gate -> load session -> drain pending -> runAgent -> postTurn -> token accumulation.
5
5
  //
6
6
  // Transport-level concerns (BB API calls, Teams cards, readline) stay in sense adapters.
7
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
8
+ if (k2 === undefined) k2 = k;
9
+ var desc = Object.getOwnPropertyDescriptor(m, k);
10
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
11
+ desc = { enumerable: true, get: function() { return m[k]; } };
12
+ }
13
+ Object.defineProperty(o, k2, desc);
14
+ }) : (function(o, m, k, k2) {
15
+ if (k2 === undefined) k2 = k;
16
+ o[k2] = m[k];
17
+ }));
18
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
19
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
20
+ }) : function(o, v) {
21
+ o["default"] = v;
22
+ });
23
+ var __importStar = (this && this.__importStar) || (function () {
24
+ var ownKeys = function(o) {
25
+ ownKeys = Object.getOwnPropertyNames || function (o) {
26
+ var ar = [];
27
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
28
+ return ar;
29
+ };
30
+ return ownKeys(o);
31
+ };
32
+ return function (mod) {
33
+ if (mod && mod.__esModule) return mod;
34
+ var result = {};
35
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
36
+ __setModuleDefault(result, mod);
37
+ return result;
38
+ };
39
+ })();
7
40
  Object.defineProperty(exports, "__esModule", { value: true });
41
+ exports.emitObligationTransitionEpisodes = emitObligationTransitionEpisodes;
8
42
  exports.handleInboundTurn = handleInboundTurn;
43
+ const fs = __importStar(require("fs"));
44
+ const path = __importStar(require("path"));
9
45
  const runtime_1 = require("../nerves/runtime");
46
+ const commands_1 = require("./commands");
10
47
  const continuity_1 = require("./continuity");
11
48
  const manager_1 = require("../heart/bridges/manager");
12
49
  const identity_1 = require("../heart/identity");
13
- const tasks_1 = require("../repertoire/tasks");
14
- const session_activity_1 = require("../heart/session-activity");
50
+ const auth_flow_1 = require("../heart/auth/auth-flow");
51
+ const socket_client_1 = require("../heart/daemon/socket-client");
15
52
  const active_work_1 = require("../heart/active-work");
16
53
  const delegation_1 = require("../heart/delegation");
17
- const target_resolution_1 = require("../heart/target-resolution");
18
- const thoughts_1 = require("../heart/daemon/thoughts");
19
- const pending_1 = require("../mind/pending");
20
- function emptyTaskBoard() {
54
+ const obligations_1 = require("../arc/obligations");
55
+ const packets_1 = require("../arc/packets");
56
+ const evolution_1 = require("../arc/evolution");
57
+ const provider_failover_1 = require("../heart/provider-failover");
58
+ const openai_codex_token_1 = require("../heart/providers/openai-codex-token");
59
+ const tempo_1 = require("../heart/tempo");
60
+ const temporal_view_1 = require("../heart/temporal-view");
61
+ const start_of_turn_packet_1 = require("../heart/start-of-turn-packet");
62
+ const bundle_state_1 = require("../heart/bundle-state");
63
+ const sync_1 = require("../heart/sync");
64
+ const config_1 = require("../heart/config");
65
+ const session_events_1 = require("../heart/session-events");
66
+ const presence_1 = require("../arc/presence");
67
+ const episodes_1 = require("../arc/episodes");
68
+ const turn_context_1 = require("../heart/turn-context");
69
+ const provider_visibility_1 = require("../heart/provider-visibility");
70
+ const orientation_frame_1 = require("../heart/orientation-frame");
71
+ const flight_recorder_1 = require("../arc/flight-recorder");
72
+ const VOICE_PENDING_MAX_AGE_MS = 15 * 60 * 1_000;
73
+ const ACTIVE_FLIGHT_RECORDER_PACKET_STATUSES = new Set([
74
+ "drafting",
75
+ "processing",
76
+ "validating",
77
+ "collaborating",
78
+ "paused",
79
+ "blocked",
80
+ ]);
81
+ function pendingExpirationReason(channel, message, now) {
82
+ /* v8 ignore start -- pending expiry edge permutations are covered by the stale voice queue tests; this helper keeps defensive non-voice fallbacks @preserve */
83
+ if (Number.isFinite(message.expiresAt) && Number(message.expiresAt) <= now)
84
+ return "explicit_expiry";
85
+ if (channel !== "voice")
86
+ return null;
87
+ if (!Number.isFinite(message.timestamp))
88
+ return null;
89
+ return now - message.timestamp > VOICE_PENDING_MAX_AGE_MS ? "voice_freshness_window" : null;
90
+ /* v8 ignore stop */
91
+ }
92
+ function archiveExpiredPendingMessages(input) {
93
+ /* v8 ignore start -- archive path edge cases are defensive filesystem hygiene; stale voice expiry tests cover the normal archive path @preserve */
94
+ if (input.expired.length === 0)
95
+ return;
96
+ const pendingRoot = path.join(input.agentRoot, "state", "pending");
97
+ const relativePendingDir = path.relative(pendingRoot, input.pendingDir);
98
+ const archiveDir = relativePendingDir && !relativePendingDir.startsWith("..") && !path.isAbsolute(relativePendingDir)
99
+ ? path.join(input.agentRoot, "state", "pending-expired", relativePendingDir)
100
+ : path.join(input.agentRoot, "state", "pending-expired", input.channel);
101
+ try {
102
+ fs.mkdirSync(archiveDir, { recursive: true });
103
+ input.expired.forEach(({ message, reason }, index) => {
104
+ const stamp = Number.isFinite(message.timestamp) ? message.timestamp : input.now;
105
+ const filePath = path.join(archiveDir, `${stamp}-${index}.json`);
106
+ fs.writeFileSync(filePath, `${JSON.stringify({
107
+ ...message,
108
+ expiredAt: input.now,
109
+ expirationReason: reason,
110
+ originalPendingDir: input.pendingDir,
111
+ }, null, 2)}\n`, "utf-8");
112
+ });
113
+ /* v8 ignore stop */
114
+ (0, runtime_1.emitNervesEvent)({
115
+ component: "senses",
116
+ event: "senses.pending_expired",
117
+ message: "expired stale pending sense messages before model injection",
118
+ meta: {
119
+ channel: input.channel,
120
+ pendingDir: input.pendingDir,
121
+ archiveDir,
122
+ count: String(input.expired.length),
123
+ },
124
+ });
125
+ }
126
+ catch (error) {
127
+ /* v8 ignore next -- filesystem archive failures are defensive; stale voice expiry success path is covered @preserve */
128
+ (0, runtime_1.emitNervesEvent)({
129
+ level: "warn",
130
+ component: "senses",
131
+ event: "senses.pending_expire_archive_error",
132
+ message: "failed to archive expired pending sense messages",
133
+ meta: {
134
+ channel: input.channel,
135
+ pendingDir: input.pendingDir,
136
+ count: String(input.expired.length),
137
+ error: error instanceof Error ? error.message : String(error),
138
+ },
139
+ });
140
+ }
141
+ }
142
+ function filterDeliverablePendingMessages(input) {
143
+ if (input.messages.length === 0)
144
+ return input.messages;
145
+ const now = input.now ?? Date.now();
146
+ const deliverable = [];
147
+ const expired = [];
148
+ for (const message of input.messages) {
149
+ const reason = pendingExpirationReason(input.channel, message, now);
150
+ if (reason) {
151
+ expired.push({ message, reason });
152
+ }
153
+ else {
154
+ deliverable.push(message);
155
+ }
156
+ }
157
+ if (expired.length > 0) {
158
+ try {
159
+ archiveExpiredPendingMessages({ ...input, agentRoot: (0, identity_1.getAgentRoot)(), expired, now });
160
+ }
161
+ catch (error) {
162
+ /* v8 ignore next -- getAgentRoot failure is only reachable under broken runtime identity state @preserve */
163
+ (0, runtime_1.emitNervesEvent)({
164
+ level: "warn",
165
+ component: "senses",
166
+ event: "senses.pending_expire_archive_error",
167
+ message: "failed to resolve agent root for expired pending sense message archive",
168
+ meta: {
169
+ channel: input.channel,
170
+ pendingDir: input.pendingDir,
171
+ count: String(expired.length),
172
+ error: error instanceof Error ? error.message : String(error),
173
+ },
174
+ });
175
+ }
176
+ }
177
+ return deliverable;
178
+ }
179
+ /**
180
+ * Emit episodes for obligation state transitions detected during a turn.
181
+ * Exported for direct testability (avoids v8 coverage merge issues in multi-file test suites).
182
+ */
183
+ function emitObligationTransitionEpisodes(agentRoot, preTurnObligationIds, postTurnObligations, preTurnObligations) {
184
+ const postTurnObligationIds = new Set(postTurnObligations.map((ob) => `${ob.id}:${ob.status}`));
185
+ for (const key of preTurnObligationIds) {
186
+ if (!postTurnObligationIds.has(key)) {
187
+ const [obId] = key.split(":");
188
+ const matchedOb = postTurnObligations.find((ob) => ob.id === obId) ?? preTurnObligations.find((ob) => ob.id === obId);
189
+ (0, episodes_1.emitEpisode)(agentRoot, {
190
+ kind: "obligation_shift",
191
+ summary: `obligation "${matchedOb?.content ?? obId}" status changed`,
192
+ whyItMattered: "obligation state transition detected during turn",
193
+ relatedEntities: [`obligation:${obId}`],
194
+ salience: "medium",
195
+ });
196
+ }
197
+ }
198
+ }
199
+ function providerLaneForChannel(channel) {
200
+ return channel === "inner" ? "inner" : "outward";
201
+ }
202
+ function latestUserAuthoredText(messages, continuityIngressTexts) {
203
+ const ingress = continuityIngressTexts?.map((entry) => entry.trim()).filter(Boolean);
204
+ if (ingress?.length)
205
+ return ingress[ingress.length - 1];
206
+ const userMessages = messages
207
+ .filter((message) => message.role === "user")
208
+ .map((message) => typeof message.content === "string" ? message.content.trim() : "")
209
+ .filter(Boolean);
210
+ return userMessages[userMessages.length - 1];
211
+ }
212
+ function sessionRefForFlightRecorder(session) {
213
+ return `${session.friendId}/${session.channel}/${session.key}`;
214
+ }
215
+ function isTerminalWithoutContinuation(outcome, hasActiveContinuation) {
216
+ return !hasActiveContinuation && (outcome === "settled"
217
+ || outcome === "observed"
218
+ || outcome === "rested"
219
+ || outcome === "superseded");
220
+ }
221
+ function readPostTurnFlightRecorderArcSnapshot(agentRoot) {
222
+ const latest = (0, flight_recorder_1.readFlightRecorderResume)(agentRoot);
21
223
  return {
22
- compact: "",
23
- full: "",
24
- byStatus: {
25
- drafting: [],
26
- processing: [],
27
- validating: [],
28
- collaborating: [],
29
- paused: [],
30
- blocked: [],
31
- done: [],
32
- },
33
- actionRequired: [],
34
- unresolvedDependencies: [],
35
- activeSessions: [],
36
- activeBridges: [],
224
+ activeObligationIds: (0, obligations_1.readPendingObligations)(agentRoot).map((obligation) => obligation.id),
225
+ activeReturnObligationIds: (0, obligations_1.listActiveReturnObligationsForRoot)(agentRoot).map((obligation) => obligation.id),
226
+ activePacketIds: (0, packets_1.listPonderPackets)(agentRoot)
227
+ .filter((packet) => ACTIVE_FLIGHT_RECORDER_PACKET_STATUSES.has(packet.status))
228
+ .map((packet) => packet.id),
229
+ openEvolutionCaseIds: (0, evolution_1.listOpenEvolutionCases)(agentRoot).map((evolutionCase) => evolutionCase.id),
230
+ recentClaimIds: latest.recentClaimIds,
231
+ unverifiedClaimIds: latest.unverifiedClaimIds,
37
232
  };
38
233
  }
39
- function readInnerWorkState() {
40
- try {
41
- const agentRoot = (0, identity_1.getAgentRoot)();
42
- const pendingDir = (0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)());
43
- const sessionPath = (0, thoughts_1.getInnerDialogSessionPath)(agentRoot);
44
- const status = (0, thoughts_1.readInnerDialogStatus)(sessionPath, pendingDir);
45
- return {
46
- status: status.processing === "started" ? "running" : "idle",
47
- hasPending: status.queue !== "clear",
48
- };
234
+ function recordPostTurnFlightRecorderCheckpoint(input) {
235
+ const hasActiveContinuation = input.mustResolveBeforeHandoff
236
+ || input.activeObligationIds.length > 0
237
+ || input.activeReturnObligationIds.length > 0
238
+ || input.activePacketIds.length > 0
239
+ || input.openEvolutionCaseIds.length > 0;
240
+ const blockedBecause = [
241
+ ...(input.outcome === "blocked" ? ["agent reported a blocker in this turn"] : []),
242
+ ...(input.outcome === "errored" ? ["turn errored before a safe continuation was reached"] : []),
243
+ ...(input.outcome === "aborted" ? ["turn aborted before a safe continuation was reached"] : []),
244
+ ...(isTerminalWithoutContinuation(input.outcome, hasActiveContinuation) ? [`turn outcome ${input.outcome}; wait for new input before acting`] : []),
245
+ ];
246
+ const nextSafeAction = input.nextSafeAction
247
+ ?? (blockedBecause.length > 0
248
+ ? "inspect the latest session and wait for new input before acting"
249
+ : "continue the current held work and update Arc/Desk with the next checkpoint");
250
+ (0, flight_recorder_1.recordFlightRecorderEvent)(input.agentRoot, {
251
+ kind: "post_turn_persisted",
252
+ sessionRef: sessionRefForFlightRecorder(input.currentSession),
253
+ summary: `persisted ${input.currentSession.channel}/${input.currentSession.key} turn with outcome ${input.outcome}`,
254
+ currentAsk: input.currentAsk,
255
+ nextSafeAction,
256
+ blockedBecause,
257
+ stopBefore: blockedBecause.length > 0 ? ["acting on stale context"] : [],
258
+ activeObligationIds: input.activeObligationIds,
259
+ activeReturnObligationIds: input.activeReturnObligationIds,
260
+ activePacketIds: input.activePacketIds,
261
+ openEvolutionCaseIds: input.openEvolutionCaseIds,
262
+ recentClaimIds: input.recentClaimIds,
263
+ unverifiedClaimIds: input.unverifiedClaimIds,
264
+ meta: {
265
+ outcome: input.outcome,
266
+ mustResolveBeforeHandoff: input.mustResolveBeforeHandoff,
267
+ sessionPath: input.currentSession.sessionPath,
268
+ },
269
+ });
270
+ }
271
+ function resolveCurrentFailoverBinding(agentName, lane) {
272
+ const agentRoot = (0, identity_1.getAgentRoot)();
273
+ const { config: agentConfig } = (0, auth_flow_1.readAgentConfigForAgent)(agentName, path.dirname(agentRoot));
274
+ const fallback = lane === "inner" ? agentConfig.agentFacing : agentConfig.humanFacing;
275
+ return { provider: fallback.provider, model: fallback.model };
276
+ }
277
+ /**
278
+ * Apply an agent-driven failover switch to agent.json, but only after
279
+ * re-pinging the candidate. The inventory ping that produced the candidate
280
+ * may be stale by the time the agent replies — without this preflight, a
281
+ * "switch to <provider>" reply can move the lane onto an unreachable provider.
282
+ *
283
+ * Returns:
284
+ * { ok: true } — preflight passed, state mutated
285
+ * { ok: false, refused } — preflight failed, state untouched, caller should
286
+ * surface the refusal to the agent
287
+ * Throws on disk errors only (caught by caller as before).
288
+ */
289
+ async function writeFailoverAgentConfigSwitch(agentName, action) {
290
+ const validation = await (0, provider_failover_1.validateFailoverSwitchCandidate)(agentName, { provider: action.provider, model: action.model });
291
+ if (!validation.ok) {
292
+ return { ok: false, refused: true, classification: validation.classification, message: validation.message };
49
293
  }
50
- catch {
294
+ const agentRoot = (0, identity_1.getAgentRoot)();
295
+ const { configPath, config } = (0, auth_flow_1.readAgentConfigForAgent)(agentName, path.dirname(agentRoot));
296
+ const facingKey = action.lane === "inner" ? "agentFacing" : "humanFacing";
297
+ const nextConfig = {
298
+ ...config,
299
+ [facingKey]: {
300
+ ...config[facingKey],
301
+ provider: action.provider,
302
+ model: action.model,
303
+ },
304
+ };
305
+ fs.writeFileSync(configPath, `${JSON.stringify(nextConfig, null, 2)}\n`, "utf-8");
306
+ return { ok: true };
307
+ }
308
+ function formatFailoverSwitchLabel(action) {
309
+ const provenance = (0, provider_failover_1.formatCredentialProvenanceLabel)(action);
310
+ return `${action.provider} (${action.model}${provenance ? `; ${provenance}` : ""})`;
311
+ }
312
+ /**
313
+ * Build the operational refusal context message handed back to the agent when
314
+ * a failover switch is rejected by the preflight ping. Field-tested format:
315
+ * lead with the refusal + reason, restate the lane that's still standing, then
316
+ * list remaining ready alternatives so the next turn doesn't have to re-enter
317
+ * discovery mode.
318
+ */
319
+ function buildFailoverSwitchRefusedMessage(pendingContext, refusedAction, refusal) {
320
+ const refusedLabel = formatFailoverSwitchLabel(refusedAction);
321
+ const remaining = pendingContext.readyProviders.filter((candidate) => candidate.provider !== refusedAction.provider);
322
+ const alternativesLine = remaining.length > 0
323
+ ? `available verified alternatives right now: ${remaining.map((c) => `${c.provider} (${c.model})`).join(", ")}.`
324
+ : "no other verified alternatives are ready right now.";
325
+ const nextMove = remaining.length > 0
326
+ ? `next move: reply "switch to <provider>" picking one of the alternatives above, or tell the user you cannot continue and why.`
327
+ : `next move: ask the operator to repair credentials for ${refusedAction.provider} (or another provider), or tell the user you cannot continue and why.`;
328
+ return [
329
+ `[provider switch refused: tried to switch ${refusedAction.lane} lane to ${refusedLabel}.`,
330
+ `reason: preflight ping failed (${refusal.classification}: ${refusal.message}).`,
331
+ `current lane unchanged: ${pendingContext.currentProvider} / ${pendingContext.currentModel} on the ${pendingContext.currentLane} lane.`,
332
+ alternativesLine,
333
+ nextMove + "]",
334
+ ].join(" ");
335
+ }
336
+ function prependTurnSections(message, sections) {
337
+ /* v8 ignore next -- defensive: only user messages with non-empty sections reach here @preserve */
338
+ if (message.role !== "user" || sections.length === 0)
339
+ return message;
340
+ const prefix = sections.join("\n\n");
341
+ /* v8 ignore start -- defensive: multipart content branch; non-string user messages are rare @preserve */
342
+ if (typeof message.content === "string") {
51
343
  return {
52
- status: "idle",
53
- hasPending: false,
344
+ ...message,
345
+ content: `${prefix}\n\n${message.content}`,
54
346
  };
55
347
  }
348
+ return {
349
+ ...message,
350
+ content: [
351
+ { type: "text", text: `${prefix}\n\n` },
352
+ ...message.content,
353
+ ],
354
+ };
355
+ /* v8 ignore stop */
56
356
  }
57
357
  // ── Pipeline ──────────────────────────────────────────────────────
358
+ let _lastSessionKey = null;
58
359
  async function handleInboundTurn(input) {
360
+ // Reset session-scoped state when the session changes
361
+ const sessionKey = `${input.channel}/${input.sessionKey ?? "session"}`;
362
+ if (sessionKey !== _lastSessionKey) {
363
+ _lastSessionKey = sessionKey;
364
+ // Reset file-state cache and scrutiny tracking for the new session
365
+ const { fileStateCache } = await Promise.resolve().then(() => __importStar(require("../mind/file-state")));
366
+ const { resetSessionModifiedFiles } = await Promise.resolve().then(() => __importStar(require("../mind/scrutiny")));
367
+ fileStateCache.clear();
368
+ resetSessionModifiedFiles();
369
+ }
370
+ // Step 0: Check for pending failover reply
371
+ if (input.failoverState?.pending) {
372
+ const userText = input.messages
373
+ .filter((m) => m.role === "user")
374
+ .map((m) => typeof m.content === "string" ? m.content : /* v8 ignore next -- defensive: multipart content fallback @preserve */ "")
375
+ .join(" ")
376
+ .trim();
377
+ const pendingContext = input.failoverState.pending;
378
+ const failoverAction = (0, provider_failover_1.handleFailoverReply)(userText, pendingContext);
379
+ const failoverAgentName = pendingContext.agentName;
380
+ input.failoverState.pending = null; // always clear before acting
381
+ if (failoverAction.action === "switch") {
382
+ let switchOutcome = null;
383
+ try {
384
+ switchOutcome = await writeFailoverAgentConfigSwitch(failoverAgentName, failoverAction);
385
+ /* v8 ignore start -- defensive: write failure during provider switch @preserve */
386
+ }
387
+ catch (switchError) {
388
+ (0, runtime_1.emitNervesEvent)({
389
+ level: "error",
390
+ component: "senses",
391
+ event: "senses.failover_switch_error",
392
+ message: `failed to switch ${failoverAction.lane} provider lane to ${failoverAction.provider}`,
393
+ meta: { agentName: failoverAgentName, lane: failoverAction.lane, provider: failoverAction.provider, model: failoverAction.model, error: switchError instanceof Error ? switchError.message : String(switchError) },
394
+ });
395
+ }
396
+ /* v8 ignore stop */
397
+ if (switchOutcome?.ok) {
398
+ (0, runtime_1.emitNervesEvent)({
399
+ component: "senses",
400
+ event: "senses.failover_switch",
401
+ message: `switched ${failoverAction.lane} provider lane to ${failoverAction.provider} via failover`,
402
+ meta: {
403
+ agentName: failoverAgentName,
404
+ lane: failoverAction.lane,
405
+ provider: failoverAction.provider,
406
+ model: failoverAction.model,
407
+ credentialRevision: failoverAction.credentialRevision,
408
+ source: failoverAction.source,
409
+ },
410
+ });
411
+ // Replace "switch to <provider>" with a context message for the agent.
412
+ // The session already has the user's original question from the failed turn.
413
+ // The agent needs to know what happened so it can respond appropriately.
414
+ const newProviderLabel = formatFailoverSwitchLabel(failoverAction);
415
+ input.messages = [{
416
+ role: "user",
417
+ content: `[provider switch: ${pendingContext.errorSummary}. switched ${failoverAction.lane} lane to ${newProviderLabel}. your conversation history is intact — respond to the user's last message.]`,
418
+ }];
419
+ input.switchedProvider = failoverAction.provider;
420
+ }
421
+ else if (switchOutcome && !switchOutcome.ok) {
422
+ // Preflight refused the switch — the candidate provider is not actually
423
+ // reachable right now. Keep the existing lane intact and tell the agent
424
+ // what happened so it can pick something else next turn.
425
+ (0, runtime_1.emitNervesEvent)({
426
+ level: "warn",
427
+ component: "senses",
428
+ event: "senses.failover_switch_refused",
429
+ message: `refused failover switch of ${failoverAction.lane} lane to ${failoverAction.provider}: ${switchOutcome.message}`,
430
+ meta: {
431
+ agentName: failoverAgentName,
432
+ lane: failoverAction.lane,
433
+ provider: failoverAction.provider,
434
+ model: failoverAction.model,
435
+ classification: switchOutcome.classification,
436
+ error: switchOutcome.message,
437
+ },
438
+ });
439
+ input.messages = [{
440
+ role: "user",
441
+ content: buildFailoverSwitchRefusedMessage(pendingContext, failoverAction, switchOutcome),
442
+ }];
443
+ }
444
+ // Switch failed OR succeeded — either way, fall through to normal processing.
445
+ }
446
+ else if (failoverAction.action === "refresh") {
447
+ const refresh = failoverAction.provider === "openai-codex"
448
+ ? await (0, openai_codex_token_1.refreshOpenAICodexProviderCredentials)(failoverAgentName, {
449
+ force: true,
450
+ reason: "failover-reply",
451
+ })
452
+ : { ok: false, actor: "human-required", message: `provider ${failoverAction.provider} does not support chat-driven refresh` };
453
+ if (refresh.ok) {
454
+ (0, runtime_1.emitNervesEvent)({
455
+ component: "senses",
456
+ event: "senses.failover_refresh",
457
+ message: `refreshed ${failoverAction.provider} provider credentials via failover`,
458
+ meta: {
459
+ agentName: failoverAgentName,
460
+ lane: failoverAction.lane,
461
+ provider: failoverAction.provider,
462
+ refreshed: refresh.refreshed,
463
+ },
464
+ });
465
+ input.messages = [{
466
+ role: "user",
467
+ content: `[provider refresh: ${pendingContext.errorSummary}. refreshed ${failoverAction.provider} credentials for the ${failoverAction.lane} lane. your conversation history is intact — respond to the user's last message.]`,
468
+ }];
469
+ }
470
+ else {
471
+ (0, runtime_1.emitNervesEvent)({
472
+ level: refresh.actor === "human-required" ? "warn" : "error",
473
+ component: "senses",
474
+ event: "senses.failover_refresh_error",
475
+ message: `failed to refresh ${failoverAction.provider} provider credentials via failover`,
476
+ meta: {
477
+ agentName: failoverAgentName,
478
+ lane: failoverAction.lane,
479
+ provider: failoverAction.provider,
480
+ actor: refresh.actor,
481
+ error: refresh.message,
482
+ },
483
+ });
484
+ input.messages = [{
485
+ role: "user",
486
+ content: `[provider refresh failed: tried to refresh ${failoverAction.provider} for the ${failoverAction.lane} lane. actor: ${refresh.actor}. reason: ${refresh.message}. current lane unchanged: ${pendingContext.currentProvider} / ${pendingContext.currentModel}. If ready alternatives are listed in the prior failover message, switch to one; otherwise tell the user the concrete human-required auth step.]`,
487
+ }];
488
+ }
489
+ }
490
+ }
491
+ // Step 0b: Slash command interception (before friend resolution / agent turn)
492
+ {
493
+ const firstUserMsg = input.messages.find((m) => m.role === "user");
494
+ const userText = firstUserMsg
495
+ ? (typeof firstUserMsg.content === "string"
496
+ ? firstUserMsg.content
497
+ : Array.isArray(firstUserMsg.content)
498
+ ? firstUserMsg.content.find((p) => p.type === "text")?.text ?? ""
499
+ : /* v8 ignore next -- defensive: content is always string or array @preserve */ "")
500
+ : "";
501
+ const parsed = (0, commands_1.parseSlashCommand)(userText);
502
+ if (parsed) {
503
+ const registry = (0, commands_1.getSharedCommandRegistry)();
504
+ const dispatchResult = registry.dispatch(parsed.command, { channel: input.channel });
505
+ if (dispatchResult.handled && dispatchResult.result) {
506
+ (0, runtime_1.emitNervesEvent)({
507
+ component: "senses",
508
+ event: "senses.pipeline_command",
509
+ message: `slash command intercepted: /${parsed.command}`,
510
+ meta: { command: parsed.command, channel: input.channel },
511
+ });
512
+ if (dispatchResult.result.message) {
513
+ input.callbacks.onTextChunk(dispatchResult.result.message);
514
+ }
515
+ // Return a minimal result — no agent turn, no session write
516
+ const resolvedContext = await input.friendResolver.resolve();
517
+ return {
518
+ resolvedContext,
519
+ gateResult: { allowed: true },
520
+ turnOutcome: "command",
521
+ commandAction: dispatchResult.result.action,
522
+ };
523
+ }
524
+ }
525
+ }
59
526
  // Step 1: Resolve friend
60
527
  const resolvedContext = await input.friendResolver.resolve();
61
528
  (0, runtime_1.emitNervesEvent)({
@@ -101,6 +568,7 @@ async function handleInboundTurn(input) {
101
568
  // Step 3: Load/create session
102
569
  const session = await input.sessionLoader.loadOrCreate();
103
570
  const sessionMessages = session.messages;
571
+ const sessionEvents = session.events ?? [];
104
572
  let mustResolveBeforeHandoff = (0, continuity_1.resolveMustResolveBeforeHandoff)(session.state?.mustResolveBeforeHandoff === true, input.continuityIngressTexts);
105
573
  const lastFriendActivityAt = input.channel === "inner"
106
574
  ? session.state?.lastFriendActivityAt
@@ -115,164 +583,373 @@ async function handleInboundTurn(input) {
115
583
  key: input.sessionKey ?? "session",
116
584
  sessionPath: session.sessionPath,
117
585
  };
118
- const activeBridges = (0, manager_1.createBridgeManager)().findBridgesForSession({
119
- friendId: currentSession.friendId,
120
- channel: currentSession.channel,
121
- key: currentSession.key,
122
- });
123
- const bridgeContext = (0, manager_1.formatBridgeContext)(activeBridges) || undefined;
124
- let sessionActivity = [];
586
+ const currentSessionTiming = (0, session_events_1.describeCurrentSessionTiming)(sessionEvents);
587
+ // Step 3b: Pre-turn sync pull (opt-in) — MUST happen before any continuity state reads
588
+ // so that obligations, episodes, cares, etc. reflect the latest remote state.
589
+ let syncFailure;
590
+ let syncConfig = { enabled: false, remote: "origin" };
591
+ const liveLatencyMode = input.latencyMode === "live";
125
592
  try {
126
- const agentRoot = (0, identity_1.getAgentRoot)();
127
- sessionActivity = (0, session_activity_1.listSessionActivity)({
128
- sessionsDir: `${agentRoot}/state/sessions`,
129
- friendsDir: `${agentRoot}/friends`,
130
- agentName: (0, identity_1.getAgentName)(),
131
- currentSession: {
132
- friendId: currentSession.friendId,
133
- channel: currentSession.channel,
134
- key: currentSession.key,
135
- },
136
- });
137
- }
138
- catch {
139
- sessionActivity = [];
593
+ syncConfig = (0, config_1.getSyncConfig)();
140
594
  }
141
- let targetCandidates = [];
595
+ catch { /* config not available */ }
596
+ // Wrap the turn body in try/finally so postTurnPush always runs — even on
597
+ // error or early-return failover paths.
142
598
  try {
143
- if (input.channel !== "inner") {
599
+ /* v8 ignore start -- sync-enabled branches tested in sync.test.ts, pipeline tests mock at module boundary @preserve */
600
+ if (syncConfig.enabled && !liveLatencyMode) {
601
+ const pullResult = (0, sync_1.preTurnPull)((0, identity_1.getAgentRoot)(), syncConfig);
602
+ if (!pullResult.ok) {
603
+ syncFailure = pullResult.error;
604
+ }
605
+ // Check for pending-sync from a prior failed push
606
+ if (!syncFailure) {
607
+ const pendingSyncPath = path.join((0, identity_1.getAgentRoot)(), "state", "pending-sync.json");
608
+ try {
609
+ if (fs.existsSync(pendingSyncPath)) {
610
+ const pendingSync = JSON.parse(fs.readFileSync(pendingSyncPath, "utf-8"));
611
+ syncFailure = `prior sync push failed: ${pendingSync.error ?? "unknown"}`;
612
+ fs.unlinkSync(pendingSyncPath);
613
+ }
614
+ }
615
+ catch {
616
+ // Ignore read errors for pending-sync
617
+ }
618
+ }
619
+ }
620
+ /* v8 ignore stop */
621
+ // Build the turn context snapshot — centralizes all state reads
622
+ const ctx = await (0, turn_context_1.buildTurnContext)({
623
+ currentSession,
624
+ channel: input.channel,
625
+ friendStore: input.friendStore,
626
+ });
627
+ // Propagate sync failure from pre-turn pull
628
+ ctx.syncFailure = syncFailure;
629
+ const { activeBridges, sessionActivity, pendingObligations, codingSessions, otherCodingSessions, backgroundOperations } = ctx;
630
+ const bridgeContext = (0, manager_1.formatBridgeContext)(activeBridges) || undefined;
631
+ const activeWorkFrame = (0, active_work_1.buildActiveWorkFrame)({
632
+ currentSession,
633
+ currentObligation,
634
+ mustResolveBeforeHandoff,
635
+ inner: ctx.innerWorkState,
636
+ bridges: activeBridges,
637
+ codingSessions,
638
+ backgroundOperations,
639
+ otherCodingSessions,
640
+ pendingObligations,
641
+ friendActivity: sessionActivity,
642
+ targetCandidates: ctx.targetCandidates,
643
+ innerReturnObligations: ctx.returnObligations,
644
+ });
645
+ const delegationDecision = (0, delegation_1.decideDelegation)({
646
+ channel: input.channel,
647
+ ingressTexts: input.continuityIngressTexts ?? [],
648
+ activeWork: activeWorkFrame,
649
+ mustResolveBeforeHandoff,
650
+ });
651
+ // Step 4: Drain deferred friend returns, then ordinary per-session pending.
652
+ const deferredReturns = input.channel === "inner"
653
+ ? []
654
+ : (input.drainDeferredReturns?.(resolvedContext.friend.id) ?? []);
655
+ const sessionPending = input.drainPending(input.pendingDir);
656
+ const pending = filterDeliverablePendingMessages({
657
+ pendingDir: input.pendingDir,
658
+ channel: input.channel,
659
+ messages: [...deferredReturns, ...sessionPending],
660
+ });
661
+ // Assemble messages: session messages + pending + inbound user messages
662
+ // NOTE: live world-state checkpoint and pending messages are rendered via buildSystem (system prompt sections)
663
+ const extraPrefixSections = input.onPendingDrained?.(pending) ?? [];
664
+ // extraPrefixSections from onPendingDrained still prepend to user message (e.g., inner dialog wakes)
665
+ if (extraPrefixSections.length > 0 && input.messages.length > 0) {
666
+ input.messages[0] = prependTurnSections(input.messages[0], extraPrefixSections);
667
+ }
668
+ // Append user messages from the inbound turn
669
+ for (const msg of input.messages) {
670
+ (0, session_events_1.stampIngressTime)(msg);
671
+ sessionMessages.push(msg);
672
+ }
673
+ const currentUserMessages = input.messages.filter((message) => message.role === "user");
674
+ const orientationFrame = input.runAgentOptions?.orientationFrame
675
+ ?? (currentUserMessages.length > 0
676
+ ? (0, orientation_frame_1.buildOrientationFrame)({
677
+ channel: input.channel,
678
+ messages: sessionMessages,
679
+ currentUserMessages,
680
+ structuredOutputs: session.structuredOutputs ?? [],
681
+ })
682
+ : undefined);
683
+ // Step 4b: Continuity pipeline — derive tempo, build start-of-turn packet, snapshot obligations
684
+ let renderedStartOfTurnPacket;
685
+ const preTurnObligationIds = new Set(pendingObligations.map((ob) => `${ob.id}:${ob.status}`));
686
+ try {
144
687
  const agentRoot = (0, identity_1.getAgentRoot)();
145
- targetCandidates = await (0, target_resolution_1.listTargetSessionCandidates)({
146
- sessionsDir: `${agentRoot}/state/sessions`,
147
- friendsDir: `${agentRoot}/friends`,
148
- agentName: (0, identity_1.getAgentName)(),
149
- currentSession: {
150
- friendId: currentSession.friendId,
151
- channel: currentSession.channel,
152
- key: currentSession.key,
688
+ const agentName = (0, identity_1.getAgentName)();
689
+ const { recentEpisodes, activeCares } = ctx;
690
+ const tempoState = (0, tempo_1.deriveTempo)({
691
+ activeSessions: sessionActivity.length + 1,
692
+ openObligations: pendingObligations.length,
693
+ recentEpisodeCount: recentEpisodes.length,
694
+ lastActivityAgeMs: sessionActivity.length > 0
695
+ ? Date.now() - new Date(sessionActivity[0].lastActivityAt).getTime()
696
+ : 0,
697
+ hasBlockers: false, // obligations use specific statuses, not "blocked"
698
+ highSalienceEpisodes: recentEpisodes.filter((ep) => ep.salience === "high" || ep.salience === "critical").length,
699
+ activeCareCount: activeCares.length,
700
+ atRiskCareCount: activeCares.filter((c) => c.currentRisk != null).length,
701
+ });
702
+ const temporalView = (0, temporal_view_1.buildTemporalView)(agentRoot, {
703
+ tempo: tempoState.mode,
704
+ preloaded: {
705
+ recentEpisodes,
706
+ activeObligations: pendingObligations,
707
+ activeCares,
153
708
  },
154
- friendStore: input.friendStore,
155
709
  });
156
- }
157
- }
158
- catch {
159
- targetCandidates = [];
160
- }
161
- const activeWorkFrame = (0, active_work_1.buildActiveWorkFrame)({
162
- currentSession,
163
- currentObligation,
164
- mustResolveBeforeHandoff,
165
- inner: readInnerWorkState(),
166
- bridges: activeBridges,
167
- taskBoard: (() => {
168
- try {
169
- return (0, tasks_1.getTaskModule)().getBoard();
710
+ const startOfTurnPacket = (0, start_of_turn_packet_1.buildStartOfTurnPacket)(temporalView, {
711
+ canonicalObligations: {
712
+ primary: activeWorkFrame.primaryObligation,
713
+ all: activeWorkFrame.pendingObligations,
714
+ },
715
+ currentSessionTiming,
716
+ flightRecorderResume: ctx.flightRecorderResume,
717
+ });
718
+ /* v8 ignore next 3 -- syncFailure propagation tested in sync.test.ts @preserve */
719
+ if (syncFailure) {
720
+ startOfTurnPacket.syncFailure = syncFailure;
170
721
  }
171
- catch {
172
- return emptyTaskBoard();
722
+ if (ctx.providerVisibility) {
723
+ startOfTurnPacket.providerSelection = (0, provider_visibility_1.formatAgentProviderVisibilityForStartOfTurn)(ctx.providerVisibility);
173
724
  }
174
- })(),
175
- friendActivity: sessionActivity,
176
- targetCandidates,
177
- });
178
- const delegationDecision = (0, delegation_1.decideDelegation)({
179
- channel: input.channel,
180
- ingressTexts: input.continuityIngressTexts ?? [],
181
- activeWork: activeWorkFrame,
182
- mustResolveBeforeHandoff,
183
- });
184
- // Step 4: Drain deferred friend returns, then ordinary per-session pending.
185
- const deferredReturns = input.channel === "inner"
186
- ? []
187
- : (input.drainDeferredReturns?.(resolvedContext.friend.id) ?? []);
188
- const sessionPending = input.drainPending(input.pendingDir);
189
- const pending = [...deferredReturns, ...sessionPending];
190
- // Assemble messages: session messages + pending (formatted) + inbound user messages
191
- if (pending.length > 0) {
192
- // Format pending messages and prepend to the user content
193
- const pendingSection = pending
194
- .map((msg) => `[pending from ${msg.from}]: ${msg.content}`)
195
- .join("\n");
196
- // If there are inbound user messages, prepend pending to the first one
197
- if (input.messages.length > 0) {
198
- const firstMsg = input.messages[0];
199
- if (firstMsg.role === "user") {
200
- if (typeof firstMsg.content === "string") {
201
- input.messages[0] = {
202
- ...firstMsg,
203
- content: `## pending messages\n${pendingSection}\n\n${firstMsg.content}`,
204
- };
725
+ // Structured bundle state detection — surfaces discrete issues the
726
+ // agent can remediate via the bundle_* tools. Runs independently of
727
+ // syncFailure so the two signals coexist during the transition away
728
+ // from the legacy free-form syncFailure string. Always assigned; the
729
+ // packet renderer's empty-filter handles the empty-array case without
730
+ // a separate branch here.
731
+ startOfTurnPacket.bundleState = (0, bundle_state_1.detectBundleState)(agentRoot);
732
+ const capabilities = (0, start_of_turn_packet_1.buildCapabilitiesSection)(agentRoot);
733
+ if (capabilities) {
734
+ startOfTurnPacket.capabilities = capabilities;
735
+ }
736
+ renderedStartOfTurnPacket = (0, start_of_turn_packet_1.renderStartOfTurnPacket)(startOfTurnPacket);
737
+ if (!renderedStartOfTurnPacket)
738
+ renderedStartOfTurnPacket = undefined;
739
+ // Update self-presence
740
+ const presence = (0, presence_1.derivePresence)(agentRoot, agentName, {
741
+ activeSessions: sessionActivity.length + 1,
742
+ openObligations: pendingObligations.length,
743
+ activeBridges: activeBridges.length,
744
+ codingLanes: codingSessions.length,
745
+ currentTempo: tempoState.mode,
746
+ });
747
+ (0, presence_1.writePresence)(agentRoot, agentName, presence);
748
+ }
749
+ catch (continuityError) {
750
+ (0, runtime_1.emitNervesEvent)({
751
+ level: "warn",
752
+ component: "senses",
753
+ event: "senses.continuity_error",
754
+ message: "continuity pipeline failed, continuing without start-of-turn packet",
755
+ meta: { error: continuityError instanceof Error ? continuityError.message : String(continuityError) },
756
+ });
757
+ }
758
+ // Step 5: runAgent
759
+ const existingToolContext = input.runAgentOptions?.toolContext;
760
+ const currentUserMessage = existingToolContext?.currentUserMessage
761
+ ?? latestUserAuthoredText(input.messages, input.continuityIngressTexts);
762
+ const runAgentOptions = {
763
+ ...input.runAgentOptions,
764
+ ...(orientationFrame ? { orientationFrame } : {}),
765
+ ...(liveLatencyMode ? { skipKeptNotes: true } : {}),
766
+ bridgeContext,
767
+ activeWorkFrame,
768
+ delegationDecision,
769
+ startOfTurnPacket: renderedStartOfTurnPacket,
770
+ pendingMessages: pending.length > 0 ? pending.map((msg) => ({ from: msg.from, content: msg.content })) : undefined,
771
+ currentSessionKey: currentSession.key,
772
+ currentObligation,
773
+ mustResolveBeforeHandoff,
774
+ setMustResolveBeforeHandoff: (value) => {
775
+ mustResolveBeforeHandoff = value;
776
+ },
777
+ // Pre-read state from TurnContext for prompt assembly
778
+ daemonRunning: ctx.daemonRunning,
779
+ senseStatusLines: ctx.senseStatusLines,
780
+ bundleMeta: ctx.bundleMeta,
781
+ daemonHealth: ctx.daemonHealth,
782
+ flightRecorderResume: ctx.flightRecorderResume,
783
+ ...(ctx.providerVisibility ? { providerVisibility: ctx.providerVisibility } : {}),
784
+ toolContext: {
785
+ /* v8 ignore next -- default no-op signin satisfies interface; real signin injected by sense adapter @preserve */
786
+ signin: async () => undefined,
787
+ ...existingToolContext,
788
+ ...(currentUserMessage ? { currentUserMessage } : {}),
789
+ context: resolvedContext,
790
+ friendStore: input.friendStore,
791
+ currentSession,
792
+ activeBridges,
793
+ ...(orientationFrame ? { orientationFrame } : {}),
794
+ },
795
+ };
796
+ const result = await input.runAgent(sessionMessages, input.callbacks, input.channel, input.signal, runAgentOptions);
797
+ // Step 5b: Failover on terminal error
798
+ if (result.outcome === "errored" && input.failoverState) {
799
+ try {
800
+ const agentName = (0, identity_1.getAgentName)();
801
+ const currentLane = providerLaneForChannel(input.channel);
802
+ const currentBinding = resolveCurrentFailoverBinding(agentName, currentLane);
803
+ const currentProvider = currentBinding.provider;
804
+ /* v8 ignore next -- defensive: errorClassification always set when errored @preserve */
805
+ const classification = result.errorClassification ?? "unknown";
806
+ const inventory = await (0, provider_failover_1.runMachineProviderFailoverInventory)(agentName, currentProvider);
807
+ const failoverContext = (0, provider_failover_1.buildFailoverContext)(
808
+ /* v8 ignore next -- defensive: error always set when errored @preserve */
809
+ result.error?.message ?? "unknown error", classification, currentProvider, currentBinding.model, agentName, inventory, {}, { currentLane });
810
+ input.failoverState.pending = failoverContext;
811
+ input.postTurn(sessionMessages, session.sessionPath, result.usage);
812
+ try {
813
+ const postTurnArc = readPostTurnFlightRecorderArcSnapshot((0, identity_1.getAgentRoot)());
814
+ recordPostTurnFlightRecorderCheckpoint({
815
+ agentRoot: (0, identity_1.getAgentRoot)(),
816
+ currentSession,
817
+ currentAsk: currentObligation
818
+ ?? activeWorkFrame.primaryObligation?.content?.trim()
819
+ ?? currentUserMessage
820
+ ?? null,
821
+ nextSafeAction: failoverContext.userMessage,
822
+ outcome: "errored",
823
+ mustResolveBeforeHandoff,
824
+ activeObligationIds: postTurnArc.activeObligationIds,
825
+ activeReturnObligationIds: postTurnArc.activeReturnObligationIds,
826
+ activePacketIds: postTurnArc.activePacketIds,
827
+ openEvolutionCaseIds: postTurnArc.openEvolutionCaseIds,
828
+ recentClaimIds: postTurnArc.recentClaimIds,
829
+ unverifiedClaimIds: postTurnArc.unverifiedClaimIds,
830
+ });
205
831
  }
206
- else {
207
- input.messages[0] = {
208
- ...firstMsg,
209
- content: [
210
- { type: "text", text: `## pending messages\n${pendingSection}\n\n` },
211
- ...firstMsg.content,
212
- ],
213
- };
832
+ catch (checkpointError) {
833
+ /* v8 ignore next -- best-effort recorder write must not hide provider-failover guidance @preserve */
834
+ (0, runtime_1.emitNervesEvent)({
835
+ level: "warn",
836
+ component: "senses",
837
+ event: "senses.flight_recorder_checkpoint_error",
838
+ message: "failed to record provider-failover flight recorder checkpoint",
839
+ meta: { error: checkpointError instanceof Error ? checkpointError.message : String(checkpointError) },
840
+ });
214
841
  }
842
+ return {
843
+ resolvedContext,
844
+ gateResult,
845
+ usage: result.usage,
846
+ turnOutcome: result.outcome,
847
+ sessionPath: session.sessionPath,
848
+ messages: sessionMessages,
849
+ drainedPending: pending,
850
+ failoverMessage: failoverContext.userMessage,
851
+ };
852
+ /* v8 ignore start -- failover catch: tested via pipeline failover sequence throws test but v8 under-reports catch coverage @preserve */
215
853
  }
854
+ catch (failoverError) {
855
+ (0, runtime_1.emitNervesEvent)({
856
+ level: "warn",
857
+ component: "senses",
858
+ event: "senses.failover_error",
859
+ message: "failover sequence failed, falling through",
860
+ meta: { error: failoverError instanceof Error ? failoverError.message : String(failoverError) },
861
+ });
862
+ }
863
+ /* v8 ignore stop */
864
+ }
865
+ // Step 5c: Emit episodes for obligation state transitions
866
+ try {
867
+ const agentRoot = (0, identity_1.getAgentRoot)();
868
+ const postTurnObligations = (0, obligations_1.readPendingObligations)(agentRoot);
869
+ emitObligationTransitionEpisodes(agentRoot, preTurnObligationIds, postTurnObligations, pendingObligations);
870
+ }
871
+ catch {
872
+ // Episode emission is non-fatal
216
873
  }
874
+ // Step 6: postTurn
875
+ const continuingState = {
876
+ ...(mustResolveBeforeHandoff ? { mustResolveBeforeHandoff: true } : {}),
877
+ ...(typeof lastFriendActivityAt === "string" ? { lastFriendActivityAt } : {}),
878
+ };
879
+ const nextState = result.outcome === "settled" || result.outcome === "blocked" || result.outcome === "superseded" || result.outcome === "observed"
880
+ ? (typeof lastFriendActivityAt === "string"
881
+ ? { lastFriendActivityAt }
882
+ : undefined)
883
+ : (Object.keys(continuingState).length > 0 ? continuingState : undefined);
884
+ input.postTurn(sessionMessages, session.sessionPath, result.usage, undefined, nextState);
885
+ try {
886
+ const agentRoot = (0, identity_1.getAgentRoot)();
887
+ const postTurnArc = readPostTurnFlightRecorderArcSnapshot(agentRoot);
888
+ recordPostTurnFlightRecorderCheckpoint({
889
+ agentRoot,
890
+ currentSession,
891
+ currentAsk: currentObligation
892
+ ?? activeWorkFrame.primaryObligation?.content?.trim()
893
+ ?? currentUserMessage
894
+ ?? null,
895
+ nextSafeAction: activeWorkFrame.resumeHandle?.nextAction
896
+ ?? activeWorkFrame.primaryObligation?.nextAction?.trim()
897
+ ?? null,
898
+ outcome: result.outcome ?? "observed",
899
+ mustResolveBeforeHandoff,
900
+ activeObligationIds: postTurnArc.activeObligationIds,
901
+ activeReturnObligationIds: postTurnArc.activeReturnObligationIds,
902
+ activePacketIds: postTurnArc.activePacketIds,
903
+ openEvolutionCaseIds: postTurnArc.openEvolutionCaseIds,
904
+ recentClaimIds: postTurnArc.recentClaimIds,
905
+ unverifiedClaimIds: postTurnArc.unverifiedClaimIds,
906
+ });
907
+ }
908
+ catch (error) {
909
+ /* v8 ignore next -- defensive recorder failures are non-fatal to already-persisted user turns @preserve */
910
+ (0, runtime_1.emitNervesEvent)({
911
+ level: "warn",
912
+ component: "senses",
913
+ event: "senses.flight_recorder_checkpoint_error",
914
+ message: "failed to record post-turn flight recorder checkpoint",
915
+ meta: { error: error instanceof Error ? error.message : String(error) },
916
+ });
917
+ }
918
+ // Step 7: Token accumulation
919
+ await input.accumulateFriendTokens(input.friendStore, resolvedContext.friend.id, result.usage);
920
+ (0, runtime_1.emitNervesEvent)({
921
+ component: "senses",
922
+ event: "senses.pipeline_end",
923
+ message: "inbound turn pipeline completed",
924
+ meta: {
925
+ channel: input.channel,
926
+ friendId: resolvedContext.friend.id,
927
+ },
928
+ });
929
+ // DRY cross-session awareness: notify inner dialog that activity happened on another channel
930
+ // Inner dialog's next checkpoint will include this session's state
931
+ if (input.channel !== "inner") {
932
+ try {
933
+ (0, socket_client_1.requestInnerWake)((0, identity_1.getAgentName)(), existingToolContext?.daemonSocketPath).catch(/* v8 ignore next */ () => { });
934
+ }
935
+ catch { /* getAgentName may fail in test environments */ }
936
+ }
937
+ return {
938
+ resolvedContext,
939
+ gateResult,
940
+ usage: result.usage,
941
+ turnOutcome: result.outcome,
942
+ completion: result.completion,
943
+ sessionPath: session.sessionPath,
944
+ messages: sessionMessages,
945
+ drainedPending: pending,
946
+ ...(input.switchedProvider ? { switchedProvider: input.switchedProvider } : {}),
947
+ };
217
948
  }
218
- // Append user messages from the inbound turn
219
- for (const msg of input.messages) {
220
- sessionMessages.push(msg);
949
+ finally {
950
+ // Step 6b: Post-turn sync push (opt-in, git-status-based discovery).
951
+ if (syncConfig.enabled && !liveLatencyMode) {
952
+ (0, sync_1.postTurnPush)((0, identity_1.getAgentRoot)(), syncConfig);
953
+ }
221
954
  }
222
- // Step 5: runAgent
223
- const existingToolContext = input.runAgentOptions?.toolContext;
224
- const runAgentOptions = {
225
- ...input.runAgentOptions,
226
- bridgeContext,
227
- activeWorkFrame,
228
- delegationDecision,
229
- currentSessionKey: currentSession.key,
230
- currentObligation,
231
- mustResolveBeforeHandoff,
232
- setMustResolveBeforeHandoff: (value) => {
233
- mustResolveBeforeHandoff = value;
234
- },
235
- toolContext: {
236
- /* v8 ignore next -- default no-op signin satisfies interface; real signin injected by sense adapter @preserve */
237
- signin: async () => undefined,
238
- ...existingToolContext,
239
- context: resolvedContext,
240
- friendStore: input.friendStore,
241
- currentSession,
242
- activeBridges,
243
- },
244
- };
245
- const result = await input.runAgent(sessionMessages, input.callbacks, input.channel, input.signal, runAgentOptions);
246
- // Step 6: postTurn
247
- const continuingState = {
248
- ...(mustResolveBeforeHandoff ? { mustResolveBeforeHandoff: true } : {}),
249
- ...(typeof lastFriendActivityAt === "string" ? { lastFriendActivityAt } : {}),
250
- };
251
- const nextState = result.outcome === "complete" || result.outcome === "blocked" || result.outcome === "superseded"
252
- ? (typeof lastFriendActivityAt === "string"
253
- ? { lastFriendActivityAt }
254
- : undefined)
255
- : (Object.keys(continuingState).length > 0 ? continuingState : undefined);
256
- input.postTurn(sessionMessages, session.sessionPath, result.usage, undefined, nextState);
257
- // Step 7: Token accumulation
258
- await input.accumulateFriendTokens(input.friendStore, resolvedContext.friend.id, result.usage);
259
- (0, runtime_1.emitNervesEvent)({
260
- component: "senses",
261
- event: "senses.pipeline_end",
262
- message: "inbound turn pipeline completed",
263
- meta: {
264
- channel: input.channel,
265
- friendId: resolvedContext.friend.id,
266
- },
267
- });
268
- return {
269
- resolvedContext,
270
- gateResult,
271
- usage: result.usage,
272
- turnOutcome: result.outcome,
273
- completion: result.completion,
274
- sessionPath: session.sessionPath,
275
- messages: sessionMessages,
276
- drainedPending: pending,
277
- };
278
955
  }