@ouro.bot/cli 0.1.0-alpha.68 → 0.1.0-alpha.681

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