@ouro.bot/cli 0.1.0-alpha.69 → 0.1.0-alpha.691

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