@ouro.bot/cli 0.1.0-alpha.7 → 0.1.0-alpha.700

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 (514) hide show
  1. package/README.md +235 -183
  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/SerpentGuide.ouro/agent.json +83 -0
  10. package/SerpentGuide.ouro/psyche/SOUL.md +25 -0
  11. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/monty.md +2 -2
  12. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-serpent.md +1 -1
  13. package/assets/ouroboros.png +0 -0
  14. package/changelog.json +4827 -0
  15. package/dist/a2a/card.js +57 -0
  16. package/dist/a2a/client.js +180 -0
  17. package/dist/a2a/config.js +50 -0
  18. package/dist/a2a/delegation-stores.js +56 -0
  19. package/dist/a2a/did-resolution.js +93 -0
  20. package/dist/a2a/identity.js +170 -0
  21. package/dist/a2a/inbound-share.js +107 -0
  22. package/dist/a2a/mission-result-wire.js +196 -0
  23. package/dist/a2a/onboarding.js +115 -0
  24. package/dist/a2a/pin-store.js +132 -0
  25. package/dist/a2a/seen-ledger.js +120 -0
  26. package/dist/a2a/server.js +604 -0
  27. package/dist/a2a/task-store.js +69 -0
  28. package/dist/a2a/transport.js +45 -0
  29. package/dist/a2a/types.js +3 -0
  30. package/dist/arc/attention-types.js +8 -0
  31. package/dist/arc/cares.js +144 -0
  32. package/dist/arc/episodes.js +118 -0
  33. package/dist/arc/evolution.js +490 -0
  34. package/dist/arc/flight-recorder.js +928 -0
  35. package/dist/arc/intentions.js +134 -0
  36. package/dist/arc/json-store.js +117 -0
  37. package/dist/arc/obligations.js +348 -0
  38. package/dist/arc/packets.js +336 -0
  39. package/dist/arc/presence.js +185 -0
  40. package/dist/arc/task-lifecycle.js +57 -0
  41. package/dist/commerce/store.js +755 -0
  42. package/dist/commerce/types.js +3 -0
  43. package/dist/heart/active-work.js +1002 -0
  44. package/dist/heart/agent-entry.js +190 -3
  45. package/dist/heart/attachments/image-normalize.js +194 -0
  46. package/dist/heart/attachments/materialize.js +97 -0
  47. package/dist/heart/attachments/originals.js +88 -0
  48. package/dist/heart/attachments/render.js +29 -0
  49. package/dist/heart/attachments/sources/bluebubbles.js +156 -0
  50. package/dist/heart/attachments/sources/cli-local-file.js +78 -0
  51. package/dist/heart/attachments/sources/index.js +16 -0
  52. package/dist/heart/attachments/store.js +103 -0
  53. package/dist/heart/attachments/types.js +93 -0
  54. package/dist/heart/auth/auth-flow.js +479 -0
  55. package/dist/heart/autonomy-budget.js +434 -0
  56. package/dist/heart/awaiting/await-alert.js +146 -0
  57. package/dist/heart/awaiting/await-expiry.js +108 -0
  58. package/dist/heart/awaiting/await-loader.js +91 -0
  59. package/dist/heart/awaiting/await-parser.js +141 -0
  60. package/dist/heart/awaiting/await-runtime-state.js +100 -0
  61. package/dist/heart/awaiting/await-scheduler.js +378 -0
  62. package/dist/heart/background-operations.js +281 -0
  63. package/dist/heart/bridges/manager.js +478 -0
  64. package/dist/heart/bridges/state-machine.js +135 -0
  65. package/dist/heart/bridges/store.js +135 -0
  66. package/dist/heart/bundle-state.js +168 -0
  67. package/dist/heart/commitments.js +135 -0
  68. package/dist/heart/config-registry.js +331 -0
  69. package/dist/heart/config.js +172 -135
  70. package/dist/heart/context-loss-gauntlet.js +354 -0
  71. package/dist/heart/context-loss-sentinel.js +1155 -0
  72. package/dist/heart/core.js +1480 -262
  73. package/dist/heart/cross-chat-delivery.js +132 -0
  74. package/dist/heart/daemon/agent-config-check.js +451 -0
  75. package/dist/heart/daemon/agent-discovery.js +263 -0
  76. package/dist/heart/daemon/agent-service.js +523 -0
  77. package/dist/heart/daemon/agentic-repair.js +547 -0
  78. package/dist/heart/daemon/await-private-wake.js +59 -0
  79. package/dist/heart/daemon/bluebubbles-health-diagnostics.js +122 -0
  80. package/dist/heart/daemon/boot-sync-probe.js +197 -0
  81. package/dist/heart/daemon/cadence.js +180 -0
  82. package/dist/heart/daemon/cli-defaults.js +780 -0
  83. package/dist/heart/daemon/cli-desk.js +322 -0
  84. package/dist/heart/daemon/cli-exec.js +8142 -0
  85. package/dist/heart/daemon/cli-help.js +675 -0
  86. package/dist/heart/daemon/cli-parse.js +2461 -0
  87. package/dist/heart/daemon/cli-render-doctor.js +57 -0
  88. package/dist/heart/daemon/cli-render.js +770 -0
  89. package/dist/heart/daemon/cli-types.js +8 -0
  90. package/dist/heart/daemon/connect-bay.js +323 -0
  91. package/dist/heart/daemon/daemon-cli.js +30 -784
  92. package/dist/heart/daemon/daemon-entry.js +874 -13
  93. package/dist/heart/daemon/daemon-health.js +176 -0
  94. package/dist/heart/daemon/daemon-rollup.js +57 -0
  95. package/dist/heart/daemon/daemon-runtime-sync.js +287 -0
  96. package/dist/heart/daemon/daemon-tombstone.js +236 -0
  97. package/dist/heart/daemon/daemon.js +1412 -26
  98. package/dist/heart/daemon/dns-workflow.js +394 -0
  99. package/dist/heart/daemon/doctor-types.js +8 -0
  100. package/dist/heart/daemon/doctor.js +1126 -0
  101. package/dist/heart/daemon/habit-private-wake.js +56 -0
  102. package/dist/heart/daemon/health-monitor.js +142 -11
  103. package/dist/heart/daemon/hooks/agent-config-v2.js +33 -0
  104. package/dist/heart/daemon/hooks/bundle-meta.js +226 -0
  105. package/dist/heart/daemon/http-health-probe.js +80 -0
  106. package/dist/heart/daemon/human-command-screens.js +234 -0
  107. package/dist/heart/daemon/human-readiness.js +114 -0
  108. package/dist/heart/daemon/inner-status.js +78 -0
  109. package/dist/heart/daemon/interactive-repair.js +394 -0
  110. package/dist/heart/daemon/launchd.js +188 -0
  111. package/dist/heart/daemon/log-tailer.js +82 -12
  112. package/dist/heart/daemon/logs-prune.js +110 -0
  113. package/dist/heart/daemon/mcp-canary.js +297 -0
  114. package/dist/heart/daemon/message-router.js +60 -11
  115. package/dist/heart/daemon/migrate-to-desk.js +848 -0
  116. package/dist/heart/daemon/os-cron-deps.js +135 -0
  117. package/dist/heart/daemon/os-cron.js +22 -14
  118. package/dist/heart/daemon/ouro-bot-entry.js +4 -2
  119. package/dist/heart/daemon/ouro-entry.js +3 -1
  120. package/dist/heart/daemon/plugin-cli.js +432 -0
  121. package/dist/heart/daemon/process-manager.js +525 -33
  122. package/dist/heart/daemon/provider-discovery.js +137 -0
  123. package/dist/heart/daemon/provider-ping-progress.js +83 -0
  124. package/dist/heart/daemon/pulse.js +511 -0
  125. package/dist/heart/daemon/readiness-repair.js +365 -0
  126. package/dist/heart/daemon/run-hooks.js +39 -0
  127. package/dist/heart/daemon/runtime-logging.js +86 -16
  128. package/dist/heart/daemon/runtime-metadata.js +191 -0
  129. package/dist/{repertoire/tasks/lifecycle.js → heart/daemon/runtime-mode.js} +26 -39
  130. package/dist/heart/daemon/safe-mode.js +161 -0
  131. package/dist/heart/daemon/sense-manager.js +929 -0
  132. package/dist/heart/daemon/session-id-resolver.js +131 -0
  133. package/dist/heart/daemon/skill-management-installer.js +94 -0
  134. package/dist/heart/daemon/socket-client.js +361 -0
  135. package/dist/heart/daemon/stale-bundle-prune.js +113 -0
  136. package/dist/heart/daemon/startup-tui.js +338 -0
  137. package/dist/heart/daemon/task-scheduler.js +117 -39
  138. package/dist/heart/daemon/terminal-ui.js +499 -0
  139. package/dist/heart/daemon/thoughts.js +591 -0
  140. package/dist/heart/daemon/up-progress.js +366 -0
  141. package/dist/heart/daemon/vault-items.js +56 -0
  142. package/dist/heart/delegation.js +59 -0
  143. package/dist/heart/external-events/router.js +121 -0
  144. package/dist/heart/habits/habit-migration.js +189 -0
  145. package/dist/heart/habits/habit-parser.js +214 -0
  146. package/dist/heart/habits/habit-runtime-state.js +114 -0
  147. package/dist/heart/habits/habit-scheduler.js +431 -0
  148. package/dist/heart/habits/habit-session-summary.js +318 -0
  149. package/dist/heart/habits/habit-session.js +617 -0
  150. package/dist/heart/{daemon → hatch}/hatch-animation.js +10 -3
  151. package/dist/heart/{daemon → hatch}/hatch-flow.js +53 -137
  152. package/dist/heart/{daemon → hatch}/hatch-specialist.js +6 -8
  153. package/dist/heart/hatch/specialist-orchestrator.js +129 -0
  154. package/dist/heart/hatch/specialist-prompt.js +102 -0
  155. package/dist/heart/hatch/specialist-tools.js +318 -0
  156. package/dist/heart/identity.js +287 -67
  157. package/dist/heart/kept-notes.js +289 -0
  158. package/dist/heart/kicks.js +2 -20
  159. package/dist/heart/machine-identity.js +161 -0
  160. package/dist/heart/mail-import-discovery.js +353 -0
  161. package/dist/heart/mailbox/mailbox-http-hooks.js +96 -0
  162. package/dist/heart/mailbox/mailbox-http-response.js +7 -0
  163. package/dist/heart/mailbox/mailbox-http-routes.js +375 -0
  164. package/dist/heart/mailbox/mailbox-http-static.js +103 -0
  165. package/dist/heart/mailbox/mailbox-http-transport.js +116 -0
  166. package/dist/heart/mailbox/mailbox-http.js +99 -0
  167. package/dist/heart/mailbox/mailbox-read.js +37 -0
  168. package/dist/heart/mailbox/mailbox-types.js +27 -0
  169. package/dist/heart/mailbox/mailbox-view.js +197 -0
  170. package/dist/heart/mailbox/readers/agent-machine.js +428 -0
  171. package/dist/heart/mailbox/readers/continuity-readers.js +329 -0
  172. package/dist/heart/mailbox/readers/mail.js +375 -0
  173. package/dist/heart/mailbox/readers/runtime-readers.js +815 -0
  174. package/dist/heart/mailbox/readers/sessions.js +232 -0
  175. package/dist/heart/mailbox/readers/shared.js +111 -0
  176. package/dist/heart/mcp/mcp-server.js +696 -0
  177. package/dist/heart/migrate-config.js +100 -0
  178. package/dist/heart/model-capabilities.js +59 -0
  179. package/dist/heart/orientation-frame.js +217 -0
  180. package/dist/heart/platform.js +81 -0
  181. package/dist/heart/primitives.js +1 -1
  182. package/dist/heart/private-runtime/decision-renderer.js +156 -0
  183. package/dist/heart/private-runtime/index.js +18 -0
  184. package/dist/heart/private-runtime/ledger.js +218 -0
  185. package/dist/heart/private-runtime/policy.js +214 -0
  186. package/dist/heart/private-runtime/types.js +2 -0
  187. package/dist/heart/progress-story.js +42 -0
  188. package/dist/heart/provider-attempt.js +134 -0
  189. package/dist/heart/provider-binding-resolver.js +273 -0
  190. package/dist/heart/provider-credentials.js +441 -0
  191. package/dist/heart/provider-failover.js +311 -0
  192. package/dist/heart/provider-models.js +81 -0
  193. package/dist/heart/provider-ping.js +262 -0
  194. package/dist/heart/provider-readiness-cache.js +119 -0
  195. package/dist/heart/provider-visibility.js +188 -0
  196. package/dist/heart/providers/anthropic-token.js +131 -0
  197. package/dist/heart/providers/anthropic.js +202 -50
  198. package/dist/heart/providers/azure.js +104 -13
  199. package/dist/heart/providers/error-classification.js +127 -0
  200. package/dist/heart/providers/github-copilot.js +145 -0
  201. package/dist/heart/providers/minimax-vlm.js +189 -0
  202. package/dist/heart/providers/minimax.js +29 -7
  203. package/dist/heart/providers/openai-codex-token.js +349 -0
  204. package/dist/heart/providers/openai-codex.js +63 -39
  205. package/dist/heart/run-ledger.js +247 -0
  206. package/dist/heart/runtime-capability-check.js +170 -0
  207. package/dist/heart/runtime-credentials.js +398 -0
  208. package/dist/heart/runtime-cwd.js +87 -0
  209. package/dist/heart/sense-truth.js +77 -0
  210. package/dist/heart/session-activity.js +235 -0
  211. package/dist/heart/session-events.js +1133 -0
  212. package/dist/heart/session-playback-cli-main.js +5 -0
  213. package/dist/heart/session-playback-cli.js +36 -0
  214. package/dist/heart/session-playback.js +231 -0
  215. package/dist/heart/session-stats-cli-main.js +5 -0
  216. package/dist/heart/session-stats.js +182 -0
  217. package/dist/heart/session-transcript.js +133 -0
  218. package/dist/heart/start-of-turn-packet.js +365 -0
  219. package/dist/heart/streaming.js +129 -34
  220. package/dist/heart/structured-output.js +196 -0
  221. package/dist/heart/sync-classification.js +176 -0
  222. package/dist/heart/sync.js +449 -0
  223. package/dist/heart/target-resolution.js +127 -0
  224. package/dist/heart/tempo.js +93 -0
  225. package/dist/heart/temporal-view.js +41 -0
  226. package/dist/heart/timeouts.js +101 -0
  227. package/dist/heart/tool-activity-callbacks.js +59 -0
  228. package/dist/heart/tool-description.js +155 -0
  229. package/dist/heart/tool-friction.js +55 -0
  230. package/dist/heart/tool-loop.js +200 -0
  231. package/dist/heart/turn-context.js +472 -0
  232. package/dist/heart/turn-coordinator.js +28 -0
  233. package/dist/heart/versioning/ouro-bot-global-installer.js +129 -0
  234. package/dist/heart/{daemon → versioning}/ouro-bot-wrapper.js +1 -1
  235. package/dist/heart/versioning/ouro-path-installer.js +426 -0
  236. package/dist/heart/{daemon → versioning}/ouro-uti.js +11 -2
  237. package/dist/heart/versioning/ouro-version-manager.js +409 -0
  238. package/dist/heart/versioning/staged-restart.js +146 -0
  239. package/dist/heart/versioning/update-checker.js +116 -0
  240. package/dist/heart/versioning/update-hooks.js +154 -0
  241. package/dist/heart/versioning/wrapper-publish-guard.js +86 -0
  242. package/dist/heart/work-card.js +380 -0
  243. package/dist/mailbox-ui/assets/index-Du_9G9WO.css +1 -0
  244. package/dist/mailbox-ui/assets/index-J8zDwHmE.js +1 -0
  245. package/dist/mailbox-ui/assets/vendor-CcN1XpQ9.js +61 -0
  246. package/dist/mailbox-ui/index.html +16 -0
  247. package/dist/mailroom/attention.js +167 -0
  248. package/dist/mailroom/autonomy.js +209 -0
  249. package/dist/mailroom/blob-store.js +715 -0
  250. package/dist/mailroom/body-cache.js +61 -0
  251. package/dist/mailroom/core.js +788 -0
  252. package/dist/mailroom/entry.js +160 -0
  253. package/dist/mailroom/file-store.js +568 -0
  254. package/dist/mailroom/mbox-import.js +393 -0
  255. package/dist/mailroom/migration.js +164 -0
  256. package/dist/mailroom/outbound.js +380 -0
  257. package/dist/mailroom/policy.js +263 -0
  258. package/dist/mailroom/reader.js +233 -0
  259. package/dist/mailroom/search-cache.js +334 -0
  260. package/dist/mailroom/search-relevance.js +319 -0
  261. package/dist/mailroom/smtp-ingress.js +176 -0
  262. package/dist/mailroom/source-state.js +176 -0
  263. package/dist/mailroom/thread.js +109 -0
  264. package/dist/mailroom/travel-extract.js +89 -0
  265. package/dist/mind/bundle-manifest.js +93 -1
  266. package/dist/mind/context.js +259 -94
  267. package/dist/mind/desk-section.js +362 -0
  268. package/dist/mind/diary-integrity.js +60 -0
  269. package/dist/mind/{memory.js → diary.js} +90 -98
  270. package/dist/mind/embedding-provider.js +60 -0
  271. package/dist/mind/file-state.js +179 -0
  272. package/dist/mind/first-impressions.js +16 -2
  273. package/dist/mind/{associative-recall.js → note-search.js} +61 -60
  274. package/dist/mind/obligation-steering.js +221 -0
  275. package/dist/mind/pending.js +77 -9
  276. package/dist/mind/phrases.js +1 -0
  277. package/dist/mind/prompt-budget.js +380 -0
  278. package/dist/mind/prompt-refresh.js +3 -2
  279. package/dist/mind/prompt.js +1279 -139
  280. package/dist/mind/provenance-trust.js +26 -0
  281. package/dist/mind/record-paths.js +312 -0
  282. package/dist/mind/scrutiny.js +173 -0
  283. package/dist/mind/token-estimate.js +8 -12
  284. package/dist/nerves/cli-logging.js +22 -3
  285. package/dist/nerves/coverage/audit-rules.js +15 -6
  286. package/dist/nerves/coverage/audit.js +28 -2
  287. package/dist/nerves/coverage/cli.js +1 -1
  288. package/dist/nerves/coverage/contract.js +5 -5
  289. package/dist/nerves/coverage/file-completeness.js +139 -5
  290. package/dist/nerves/coverage/run-artifacts.js +1 -1
  291. package/dist/nerves/event-buffer.js +111 -0
  292. package/dist/nerves/index.js +234 -4
  293. package/dist/nerves/observation.js +20 -0
  294. package/dist/nerves/redact.js +79 -0
  295. package/dist/nerves/review/cli-main.js +5 -0
  296. package/dist/nerves/review/cli.js +156 -0
  297. package/dist/nerves/review/core.js +152 -0
  298. package/dist/nerves/runtime.js +5 -1
  299. package/dist/repertoire/ado-client.js +17 -56
  300. package/dist/repertoire/ado-semantic.js +16 -10
  301. package/dist/repertoire/api-client.js +97 -0
  302. package/dist/repertoire/bitwarden-store.js +1042 -0
  303. package/dist/repertoire/bundle-templates.js +71 -0
  304. package/dist/repertoire/bw-installer.js +180 -0
  305. package/dist/repertoire/coding/codex-jsonl.js +64 -0
  306. package/dist/repertoire/coding/context-pack.js +331 -0
  307. package/dist/repertoire/coding/feedback.js +322 -0
  308. package/dist/repertoire/coding/index.js +18 -3
  309. package/dist/repertoire/coding/manager.js +228 -14
  310. package/dist/repertoire/coding/spawner.js +61 -14
  311. package/dist/repertoire/coding/tools.js +279 -12
  312. package/dist/repertoire/coding/workbench-client.js +272 -0
  313. package/dist/repertoire/coding/workbench-manager.js +346 -0
  314. package/dist/repertoire/commerce-errors.js +109 -0
  315. package/dist/repertoire/commerce-self-test.js +156 -0
  316. package/dist/repertoire/credential-access.js +178 -0
  317. package/dist/repertoire/data/ado-endpoints.json +188 -0
  318. package/dist/repertoire/desk/classifier.js +362 -0
  319. package/dist/repertoire/duffel-client.js +185 -0
  320. package/dist/repertoire/github-client.js +14 -55
  321. package/dist/repertoire/graph-client.js +11 -52
  322. package/dist/repertoire/guardrails.js +408 -0
  323. package/dist/repertoire/mcp-client.js +295 -0
  324. package/dist/repertoire/mcp-manager.js +434 -0
  325. package/dist/repertoire/mcp-tools.js +83 -0
  326. package/dist/repertoire/plugin-mcp.js +175 -0
  327. package/dist/repertoire/plugins.js +253 -0
  328. package/dist/repertoire/shell-sessions.js +133 -0
  329. package/dist/repertoire/skills.js +45 -24
  330. package/dist/repertoire/stripe-client.js +131 -0
  331. package/dist/repertoire/tool-results.js +29 -0
  332. package/dist/repertoire/tools-a2a.js +699 -0
  333. package/dist/repertoire/tools-attachments.js +317 -0
  334. package/dist/repertoire/tools-awaiting.js +372 -0
  335. package/dist/repertoire/tools-base.js +68 -707
  336. package/dist/repertoire/tools-bluebubbles.js +95 -0
  337. package/dist/repertoire/tools-bridge.js +144 -0
  338. package/dist/repertoire/tools-bundle.js +993 -0
  339. package/dist/repertoire/tools-commerce.js +253 -0
  340. package/dist/repertoire/tools-config.js +186 -0
  341. package/dist/repertoire/tools-continuity.js +252 -0
  342. package/dist/repertoire/tools-credential.js +383 -0
  343. package/dist/repertoire/tools-evolution.js +527 -0
  344. package/dist/repertoire/tools-files.js +344 -0
  345. package/dist/repertoire/tools-flight.js +290 -0
  346. package/dist/repertoire/tools-flow.js +119 -0
  347. package/dist/repertoire/tools-github.js +3 -8
  348. package/dist/repertoire/tools-mail.js +1975 -0
  349. package/dist/repertoire/tools-notes.js +459 -0
  350. package/dist/repertoire/tools-obligations.js +182 -0
  351. package/dist/repertoire/tools-orientation.js +31 -0
  352. package/dist/repertoire/tools-record.js +482 -0
  353. package/dist/repertoire/tools-rsvp.js +139 -0
  354. package/dist/repertoire/tools-runtime.js +150 -0
  355. package/dist/repertoire/tools-session.js +881 -0
  356. package/dist/repertoire/tools-shell.js +120 -0
  357. package/dist/repertoire/tools-stripe.js +224 -0
  358. package/dist/repertoire/tools-surface.js +355 -0
  359. package/dist/repertoire/tools-teams.js +67 -61
  360. package/dist/repertoire/tools-travel.js +125 -0
  361. package/dist/repertoire/tools-trip.js +982 -0
  362. package/dist/repertoire/tools-user-profile.js +146 -0
  363. package/dist/repertoire/tools-vault.js +40 -0
  364. package/dist/repertoire/tools-voice.js +145 -0
  365. package/dist/repertoire/tools.js +313 -102
  366. package/dist/repertoire/travel-api-client.js +360 -0
  367. package/dist/repertoire/user-profile.js +131 -0
  368. package/dist/repertoire/vault-setup.js +246 -0
  369. package/dist/repertoire/vault-unlock.js +594 -0
  370. package/dist/rsvp/aisleplanner-client.js +354 -0
  371. package/dist/rsvp/cli.js +704 -0
  372. package/dist/rsvp/config.js +327 -0
  373. package/dist/rsvp/cutover.js +431 -0
  374. package/dist/rsvp/diagnostics.js +222 -0
  375. package/dist/rsvp/diff-renderer.js +161 -0
  376. package/dist/rsvp/habit-policy.js +85 -0
  377. package/dist/rsvp/habit-stage.js +93 -0
  378. package/dist/rsvp/incident-bundle.js +97 -0
  379. package/dist/rsvp/migration.js +204 -0
  380. package/dist/rsvp/outbound-state.js +254 -0
  381. package/dist/rsvp/query.js +118 -0
  382. package/dist/rsvp/replay.js +233 -0
  383. package/dist/rsvp/snapshot.js +232 -0
  384. package/dist/scripts/claude-code-hook.js +41 -0
  385. package/dist/scripts/claude-code-stop-hook.js +47 -0
  386. package/dist/senses/a2a-entry.js +115 -0
  387. package/dist/senses/attention-queue.js +186 -0
  388. package/dist/senses/await-turn-message.js +58 -0
  389. package/dist/senses/bluebubbles/active-turns.js +216 -0
  390. package/dist/senses/bluebubbles/attachment-cache.js +53 -0
  391. package/dist/senses/bluebubbles/attachment-download.js +137 -0
  392. package/dist/senses/bluebubbles/client.js +691 -0
  393. package/dist/senses/bluebubbles/entry.js +77 -0
  394. package/dist/senses/bluebubbles/inbound-log.js +126 -0
  395. package/dist/senses/bluebubbles/index.js +2937 -0
  396. package/dist/senses/bluebubbles/media.js +389 -0
  397. package/dist/senses/{bluebubbles-model.js → bluebubbles/model.js} +45 -16
  398. package/dist/senses/{bluebubbles-mutation-log.js → bluebubbles/mutation-log.js} +46 -6
  399. package/dist/senses/bluebubbles/outbound-state.js +304 -0
  400. package/dist/senses/bluebubbles/processed-log.js +133 -0
  401. package/dist/senses/bluebubbles/replay.js +284 -0
  402. package/dist/senses/bluebubbles/runtime-state.js +137 -0
  403. package/dist/senses/bluebubbles/session-cleanup.js +72 -0
  404. package/dist/senses/bluebubbles-meta-guard.js +39 -0
  405. package/dist/senses/cli/bracketed-paste.js +82 -0
  406. package/dist/senses/cli/image-paste.js +287 -0
  407. package/dist/senses/cli/image-ref-navigation.js +75 -0
  408. package/dist/senses/cli/ink-app.js +156 -0
  409. package/dist/senses/cli/inline-diff.js +64 -0
  410. package/dist/senses/cli/input-keys.js +174 -0
  411. package/dist/senses/cli/kill-ring.js +86 -0
  412. package/dist/senses/cli/message-list.js +51 -0
  413. package/dist/senses/cli/ouro-tui.js +607 -0
  414. package/dist/senses/cli/spinner-imperative.js +135 -0
  415. package/dist/senses/cli/spinner.js +101 -0
  416. package/dist/senses/cli/status-line.js +60 -0
  417. package/dist/senses/cli/streaming-markdown.js +526 -0
  418. package/dist/senses/cli/tool-display.js +85 -0
  419. package/dist/senses/cli/tool-render.js +85 -0
  420. package/dist/senses/cli/tui-store.js +240 -0
  421. package/dist/senses/cli/virtual-list.js +35 -0
  422. package/dist/senses/cli-entry.js +60 -8
  423. package/dist/senses/cli-layout.js +187 -0
  424. package/dist/senses/cli.js +780 -269
  425. package/dist/senses/commands.js +66 -3
  426. package/dist/senses/context-packet-ledger.js +245 -0
  427. package/dist/senses/context-packets.js +154 -0
  428. package/dist/senses/continuity.js +94 -0
  429. package/dist/senses/habit-turn-message.js +160 -0
  430. package/dist/senses/mail-entry.js +66 -0
  431. package/dist/senses/mail.js +395 -0
  432. package/dist/senses/pipeline.js +1052 -0
  433. package/dist/senses/private-runtime-worker.js +723 -0
  434. package/dist/senses/private-runtime.js +1157 -0
  435. package/dist/senses/proactive-content-guard.js +51 -0
  436. package/dist/senses/shared-turn.js +416 -0
  437. package/dist/senses/surface-tool.js +109 -0
  438. package/dist/senses/teams-entry.js +60 -8
  439. package/dist/senses/teams.js +928 -199
  440. package/dist/senses/trust-gate.js +207 -2
  441. package/dist/senses/voice/audio-playback.js +237 -0
  442. package/dist/senses/voice/audio-routing.js +119 -0
  443. package/dist/senses/voice/elevenlabs.js +202 -0
  444. package/dist/senses/voice/floor-control.js +431 -0
  445. package/dist/senses/voice/floor-controller.js +115 -0
  446. package/dist/senses/voice/golden-path.js +116 -0
  447. package/dist/senses/voice/index.js +29 -0
  448. package/dist/senses/voice/meeting.js +113 -0
  449. package/dist/senses/voice/outbound.js +190 -0
  450. package/dist/senses/voice/phone.js +33 -0
  451. package/dist/senses/voice/playback.js +139 -0
  452. package/dist/senses/voice/realtime-eval.js +496 -0
  453. package/dist/senses/voice/realtime-trace.js +531 -0
  454. package/dist/senses/voice/transcript.js +70 -0
  455. package/dist/senses/voice/turn.js +191 -0
  456. package/dist/senses/voice/twilio-phone-runtime.js +807 -0
  457. package/dist/senses/voice/twilio-phone.js +5081 -0
  458. package/dist/senses/voice/types.js +2 -0
  459. package/dist/senses/voice/whisper.js +161 -0
  460. package/dist/senses/voice-entry.js +81 -0
  461. package/dist/senses/voice-realtime-eval-command.js +99 -0
  462. package/dist/senses/voice-realtime-eval-entry.js +21 -0
  463. package/dist/senses/voice-twilio-entry.js +87 -0
  464. package/dist/trips/core.js +138 -0
  465. package/dist/trips/store.js +265 -0
  466. package/dist/util/frontmatter.js +69 -0
  467. package/package.json +67 -11
  468. package/skills/agent-commerce.md +113 -0
  469. package/skills/browser-navigation.md +117 -0
  470. package/skills/commerce-setup-guide.md +116 -0
  471. package/skills/commerce-setup.md +84 -0
  472. package/skills/configure-dev-tools.md +99 -0
  473. package/skills/travel-planning.md +138 -0
  474. package/AdoptionSpecialist.ouro/agent.json +0 -20
  475. package/AdoptionSpecialist.ouro/psyche/SOUL.md +0 -22
  476. package/dist/heart/daemon/specialist-orchestrator.js +0 -160
  477. package/dist/heart/daemon/specialist-prompt.js +0 -40
  478. package/dist/heart/daemon/specialist-session.js +0 -142
  479. package/dist/heart/daemon/specialist-tools.js +0 -128
  480. package/dist/heart/daemon/subagent-installer.js +0 -125
  481. package/dist/inner-worker-entry.js +0 -4
  482. package/dist/mind/friends/channel.js +0 -49
  483. package/dist/mind/friends/resolver.js +0 -84
  484. package/dist/mind/friends/store-file.js +0 -171
  485. package/dist/mind/friends/store.js +0 -4
  486. package/dist/mind/friends/tokens.js +0 -26
  487. package/dist/mind/friends/types.js +0 -21
  488. package/dist/repertoire/tasks/board.js +0 -122
  489. package/dist/repertoire/tasks/index.js +0 -210
  490. package/dist/repertoire/tasks/middleware.js +0 -65
  491. package/dist/repertoire/tasks/parser.js +0 -173
  492. package/dist/repertoire/tasks/scanner.js +0 -132
  493. package/dist/repertoire/tasks/transitions.js +0 -145
  494. package/dist/senses/bluebubbles-client.js +0 -279
  495. package/dist/senses/bluebubbles-entry.js +0 -11
  496. package/dist/senses/bluebubbles.js +0 -332
  497. package/dist/senses/inner-dialog-worker.js +0 -61
  498. package/dist/senses/inner-dialog.js +0 -231
  499. package/subagents/README.md +0 -73
  500. package/subagents/work-doer.md +0 -233
  501. package/subagents/work-merger.md +0 -624
  502. package/subagents/work-planner.md +0 -373
  503. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/basilisk.md +0 -0
  504. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jafar.md +0 -0
  505. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jormungandr.md +0 -0
  506. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/kaa.md +0 -0
  507. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/medusa.md +0 -0
  508. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/nagini.md +0 -0
  509. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/ouroboros.md +0 -0
  510. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/python.md +0 -0
  511. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/quetzalcoatl.md +0 -0
  512. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/sir-hiss.md +0 -0
  513. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-snake.md +0 -0
  514. /package/dist/{repertoire/tasks/types.js → heart/attachments/sources/adapter.js} +0 -0
@@ -0,0 +1,355 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.surfaceToolDefinition = exports.surfaceToolDef = void 0;
37
+ const fs = __importStar(require("fs"));
38
+ const identity_1 = require("../heart/identity");
39
+ const surface_tool_1 = require("../senses/surface-tool");
40
+ const obligations_1 = require("../arc/obligations");
41
+ const packets_1 = require("../arc/packets");
42
+ const session_activity_1 = require("../heart/session-activity");
43
+ const bluebubbles_meta_guard_1 = require("../senses/bluebubbles-meta-guard");
44
+ const runtime_1 = require("../nerves/runtime");
45
+ const path = __importStar(require("path"));
46
+ const outbound_1 = require("../senses/voice/outbound");
47
+ /* v8 ignore start -- surface voice delivery hints are covered at the outbound voice bridge; this adapter only normalizes optional tool args @preserve */
48
+ function normalizeSurfaceDeliveryChannel(value) {
49
+ if (typeof value !== "string")
50
+ return "auto";
51
+ const normalized = value.trim().toLowerCase();
52
+ return normalized === "voice" ? "voice" : "auto";
53
+ }
54
+ function parseSurfaceVoiceInitialAudio(args) {
55
+ const source = args.voiceAudioSource === "url" || args.voiceAudioSource === "file" || args.voiceAudioSource === "tone"
56
+ ? args.voiceAudioSource
57
+ : undefined;
58
+ const hasAudioHint = Boolean(source
59
+ || args.voiceAudioUrl?.trim()
60
+ || args.voiceAudioPath?.trim()
61
+ || args.voiceAudioLabel?.trim()
62
+ || args.voiceAudioToneHz?.trim()
63
+ || args.voiceAudioDurationMs?.trim());
64
+ if (!hasAudioHint)
65
+ return undefined;
66
+ const toneHz = args.voiceAudioToneHz?.trim() ? Number(args.voiceAudioToneHz) : undefined;
67
+ const durationMs = args.voiceAudioDurationMs?.trim() ? Number(args.voiceAudioDurationMs) : undefined;
68
+ return {
69
+ source: source ?? "tone",
70
+ ...(args.voiceAudioUrl?.trim() ? { url: args.voiceAudioUrl.trim() } : {}),
71
+ ...(args.voiceAudioPath?.trim() ? { path: args.voiceAudioPath.trim() } : {}),
72
+ ...(args.voiceAudioLabel?.trim() ? { label: args.voiceAudioLabel.trim() } : {}),
73
+ ...(Number.isFinite(toneHz) ? { toneHz } : {}),
74
+ ...(Number.isFinite(durationMs) ? { durationMs } : {}),
75
+ };
76
+ }
77
+ /* v8 ignore stop */
78
+ // Surface tool schema — canonical home. Handler lives in senses/surface-tool.ts.
79
+ exports.surfaceToolDef = {
80
+ type: "function",
81
+ function: {
82
+ name: "surface",
83
+ description: "return a ready thought to a friend or active session without publishing private-runtime work to BlueBubbles. pass delegationId to address a held thought (see your attention queue above), or friendId for spontaneous outreach. Surface delivers tool responses to the active session. BlueBubbles is a dedicated channel - use send_message with channel=\"bluebubbles\" for intentional iMessage delivery. set channel=voice only when you intentionally want a live phone call; content becomes the call reason/opening context. does not end your turn.",
84
+ parameters: {
85
+ type: "object",
86
+ properties: {
87
+ content: {
88
+ type: "string",
89
+ description: "the message to deliver",
90
+ },
91
+ delegationId: {
92
+ type: "string",
93
+ description: "ID from your attention queue — addresses a specific held thought",
94
+ },
95
+ friendId: {
96
+ type: "string",
97
+ description: "friend to reach out to spontaneously (when not addressing a held thought)",
98
+ },
99
+ channel: {
100
+ type: "string",
101
+ enum: ["auto", "voice"],
102
+ description: "optional delivery channel; use voice for a live phone call to a trusted friend, otherwise omit",
103
+ },
104
+ phoneNumber: {
105
+ type: "string",
106
+ description: "optional E.164 phone override for channel=voice when the trusted friend's record has no usable phone handle",
107
+ },
108
+ voiceAudioSource: {
109
+ type: "string",
110
+ enum: ["tone", "url", "file"],
111
+ description: "optional initial non-speech audio to play after the opening greeting when channel=voice",
112
+ },
113
+ voiceAudioUrl: {
114
+ type: "string",
115
+ description: "short audio URL for voiceAudioSource=url",
116
+ },
117
+ voiceAudioPath: {
118
+ type: "string",
119
+ description: "local audio file path for voiceAudioSource=file",
120
+ },
121
+ voiceAudioLabel: {
122
+ type: "string",
123
+ description: "short label for the initial voice audio",
124
+ },
125
+ voiceAudioToneHz: {
126
+ type: "number",
127
+ description: "tone frequency for voiceAudioSource=tone",
128
+ },
129
+ voiceAudioDurationMs: {
130
+ type: "number",
131
+ description: "initial audio duration in milliseconds",
132
+ },
133
+ },
134
+ required: ["content"],
135
+ },
136
+ },
137
+ };
138
+ // Surface tool handler: routes content to friend's freshest session
139
+ /* v8 ignore start -- surface handler wiring: core logic tested via surface-tool.test.ts; this wires identity/routing deps @preserve */
140
+ exports.surfaceToolDefinition = {
141
+ tool: exports.surfaceToolDef,
142
+ handler: async (args, ctx) => {
143
+ const rawContent = args.content ?? "";
144
+ const deliveryHint = {
145
+ channel: normalizeSurfaceDeliveryChannel(args.channel),
146
+ phoneNumber: typeof args.phoneNumber === "string" ? args.phoneNumber : undefined,
147
+ initialAudio: parseSurfaceVoiceInitialAudio(args),
148
+ };
149
+ if ((0, bluebubbles_meta_guard_1.containsInternalMetaMarkers)(rawContent)) {
150
+ (0, runtime_1.emitNervesEvent)({
151
+ level: "warn",
152
+ component: "repertoire",
153
+ event: "tools.surface_meta_blocked",
154
+ message: "surface tool blocked: internal meta markers in content",
155
+ meta: {
156
+ hasDelegationId: Boolean(args.delegationId),
157
+ hasFriendId: Boolean(args.friendId),
158
+ contentLength: rawContent.length,
159
+ },
160
+ });
161
+ return "failed — blocked: contains internal meta markers";
162
+ }
163
+ const queue = ctx?.delegatedOrigins ?? [];
164
+ const agentName = (() => { try {
165
+ return (0, identity_1.getAgentName)();
166
+ }
167
+ catch {
168
+ return "unknown";
169
+ } })();
170
+ const routeToFriend = async (friendId, content, queueItem, hint) => {
171
+ /* v8 ignore start -- routing: integration path tested via private-runtime routing tests @preserve */
172
+ try {
173
+ const agentRoot = (0, identity_1.getAgentRoot)();
174
+ const sessionsDir = path.join(agentRoot, "state", "sessions");
175
+ const friendsDir = path.join(agentRoot, "friends");
176
+ // Resolve friend name → UUID if needed (agents may pass name instead of UUID)
177
+ let resolvedFriendId = friendId;
178
+ if (!fs.existsSync(path.join(sessionsDir, friendId))) {
179
+ try {
180
+ const friendFiles = fs.readdirSync(friendsDir).filter((f) => f.endsWith(".json"));
181
+ for (const file of friendFiles) {
182
+ const raw = fs.readFileSync(path.join(friendsDir, file), "utf-8");
183
+ const record = JSON.parse(raw);
184
+ if (record.name?.toLowerCase() === friendId.toLowerCase() && record.id) {
185
+ resolvedFriendId = record.id;
186
+ break;
187
+ }
188
+ }
189
+ }
190
+ catch { /* friends dir unreadable — continue with original friendId */ }
191
+ }
192
+ friendId = resolvedFriendId;
193
+ if (hint?.channel === "voice") {
194
+ const voiceResult = await (0, outbound_1.placeTrustedFriendVoiceOutboundCall)({
195
+ agentName,
196
+ agentRoot,
197
+ friendId,
198
+ reason: content,
199
+ phoneNumber: hint.phoneNumber,
200
+ ...(hint.initialAudio ? { initialAudio: hint.initialAudio } : {}),
201
+ });
202
+ return voiceResult.status === "placed"
203
+ ? { status: "delivered", detail: voiceResult.detail }
204
+ : { status: "failed", detail: voiceResult.detail };
205
+ }
206
+ // Priority 1: Bridge-preferred session (if queue item has a bridgeId)
207
+ if (queueItem?.bridgeId) {
208
+ const { createBridgeManager } = await Promise.resolve().then(() => __importStar(require("../heart/bridges/manager")));
209
+ const bridge = createBridgeManager().getBridge(queueItem.bridgeId);
210
+ if (bridge && bridge.lifecycle !== "completed" && bridge.lifecycle !== "cancelled") {
211
+ const allSessions = (0, session_activity_1.listSessionActivity)({ sessionsDir, friendsDir, agentName, activeThresholdMs: Number.MAX_SAFE_INTEGER });
212
+ const bridgeTarget = allSessions.find((activity) => activity.friendId === friendId
213
+ && activity.channel !== "inner"
214
+ && bridge.attachedSessions.some((s) => s.friendId === activity.friendId && s.channel === activity.channel && s.key === activity.key));
215
+ if (bridgeTarget) {
216
+ const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
217
+ const pendingDir = getPendingDir(agentName, bridgeTarget.friendId, bridgeTarget.channel, bridgeTarget.key);
218
+ queuePendingMessage(pendingDir, {
219
+ from: agentName,
220
+ friendId: bridgeTarget.friendId,
221
+ channel: bridgeTarget.channel,
222
+ key: bridgeTarget.key,
223
+ content,
224
+ timestamp: Date.now(),
225
+ });
226
+ return { status: "queued", detail: `for next interaction via ${bridgeTarget.channel}` };
227
+ }
228
+ }
229
+ }
230
+ // Priority 1.5: exact held-work origin.
231
+ // A delegated return has a concrete reply address. Preserve that
232
+ // address before considering fresher sessions for the same friend,
233
+ // especially MCP sessions where check_response drains this path.
234
+ if (queueItem?.channel && queueItem.key && queueItem.channel !== "inner") {
235
+ const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
236
+ const pendingDir = getPendingDir(agentName, friendId, queueItem.channel, queueItem.key);
237
+ queuePendingMessage(pendingDir, {
238
+ from: agentName,
239
+ friendId,
240
+ channel: queueItem.channel,
241
+ key: queueItem.key,
242
+ content,
243
+ timestamp: Date.now(),
244
+ });
245
+ return { status: "queued", detail: `for originating ${queueItem.channel} session` };
246
+ }
247
+ // Priority 2: Try proactive delivery first, then queue to freshest session
248
+ const allFriendSessions = (0, session_activity_1.listSessionActivity)({ sessionsDir, friendsDir, agentName, activeThresholdMs: Number.MAX_SAFE_INTEGER })
249
+ .filter((s) => s.friendId === friendId && s.channel !== "inner");
250
+ // Priority 2: Queue to freshest non-private-runtime session
251
+ const freshest = allFriendSessions[0];
252
+ if (freshest) {
253
+ const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
254
+ const pendingDir = getPendingDir(agentName, freshest.friendId, freshest.channel, freshest.key);
255
+ queuePendingMessage(pendingDir, {
256
+ from: agentName,
257
+ friendId: freshest.friendId,
258
+ channel: freshest.channel,
259
+ key: freshest.key,
260
+ content,
261
+ timestamp: Date.now(),
262
+ });
263
+ return { status: "queued", detail: `for next interaction via ${freshest.channel}` };
264
+ }
265
+ // Priority 3: Deferred — no active session found
266
+ const { getDeferredReturnDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
267
+ const { queuePendingMessage: queueDeferred } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
268
+ const deferredDir = getDeferredReturnDir(agentName, friendId);
269
+ queueDeferred(deferredDir, {
270
+ from: agentName,
271
+ friendId,
272
+ channel: "deferred",
273
+ key: "return",
274
+ content,
275
+ timestamp: Date.now(),
276
+ });
277
+ return { status: "deferred", detail: "they'll see it next time" };
278
+ }
279
+ catch {
280
+ return { status: "failed" };
281
+ }
282
+ /* v8 ignore stop */
283
+ };
284
+ return (0, surface_tool_1.handleSurface)({
285
+ content: args.content ?? "",
286
+ delegationId: args.delegationId,
287
+ friendId: args.friendId,
288
+ deliveryHint: deliveryHint.channel === "voice" || deliveryHint.phoneNumber ? deliveryHint : undefined,
289
+ queue,
290
+ routeToFriend,
291
+ advanceObligation: (obligationId, update) => {
292
+ /* v8 ignore start -- obligation advance: tested via attention-queue tests @preserve */
293
+ try {
294
+ const name = (() => { try {
295
+ return (0, identity_1.getAgentName)();
296
+ }
297
+ catch {
298
+ return "unknown";
299
+ } })();
300
+ (0, obligations_1.advanceReturnObligation)(name, obligationId, {
301
+ status: update.status,
302
+ ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
303
+ ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
304
+ });
305
+ }
306
+ catch {
307
+ // swallowed — obligation advance must never break surface delivery
308
+ }
309
+ /* v8 ignore stop */
310
+ },
311
+ completePonderPacket: (packetId) => {
312
+ /* v8 ignore start -- packet completion: tested via surface-tool and arc packet unit tests @preserve */
313
+ try {
314
+ (0, packets_1.completePonderPacket)((0, identity_1.getAgentRoot)(), packetId);
315
+ }
316
+ catch {
317
+ // swallowed — packet completion must never break surface delivery
318
+ }
319
+ /* v8 ignore stop */
320
+ },
321
+ fulfillHeartObligation: (origin) => {
322
+ /* v8 ignore start -- heart obligation fulfillment: tested via surface-tool.test.ts @preserve */
323
+ try {
324
+ const agentRoot = (0, identity_1.getAgentRoot)();
325
+ const heartObligation = (0, obligations_1.findPendingObligationForOrigin)(agentRoot, origin);
326
+ if (heartObligation) {
327
+ (0, obligations_1.fulfillObligation)(agentRoot, heartObligation.id);
328
+ }
329
+ }
330
+ catch {
331
+ // swallowed — heart obligation fulfillment must never break surface delivery
332
+ }
333
+ /* v8 ignore stop */
334
+ },
335
+ onRouteResult: ({ targetFriendId, queueItem, result }) => {
336
+ ctx?.habitSession?.recordSurfaceAttempt?.({
337
+ recipient: targetFriendId,
338
+ channel: queueItem?.channel ?? args.channel ?? "surface",
339
+ reason: result.status === "failed" ? "blocked" : "answer",
340
+ result: result.status,
341
+ rawStatus: result.status,
342
+ ...(queueItem ? { routeKind: "originator" } : {}),
343
+ ...(result.status === "failed" ? { error: result.detail ?? "surface route failed" } : {}),
344
+ });
345
+ },
346
+ });
347
+ },
348
+ summaryKeys: ["content", "delegationId", "friendId", "channel"],
349
+ riskProfile: {
350
+ mutates: ["durable_state_write", "external_side_effect"],
351
+ risk: "high",
352
+ reason: "queues or delivers surfaced responses and may fulfill obligations",
353
+ },
354
+ };
355
+ /* v8 ignore stop */
@@ -3,24 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
3
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.teamsToolHandlers = exports.teamsTools = exports.teamsToolDefinitions = void 0;
7
- exports.summarizeTeamsArgs = summarizeTeamsArgs;
6
+ exports.teamsToolDefinitions = void 0;
8
7
  const graph_client_1 = require("./graph-client");
9
8
  const ado_client_1 = require("./ado-client");
10
9
  const graph_endpoints_json_1 = __importDefault(require("./data/graph-endpoints.json"));
11
10
  const ado_endpoints_json_1 = __importDefault(require("./data/ado-endpoints.json"));
12
11
  const runtime_1 = require("../nerves/runtime");
13
12
  const MUTATE_METHODS = ["POST", "PATCH", "DELETE"];
14
- // Map HTTP method to authority action name for canWrite() checks
15
- const METHOD_TO_ACTION = {
16
- POST: "createWorkItem",
17
- PATCH: "updateWorkItem",
18
- DELETE: "deleteWorkItem",
19
- };
20
- // Check if a tool response indicates a 403 PERMISSION_DENIED (authority checker removed; this is now a no-op kept for call-site stability)
21
- function checkAndRecord403(_result, _integration, _scope, _action, _ctx) {
22
- // No-op: AuthorityChecker eliminated. 403 recording removed.
23
- }
24
13
  const DEFAULT_ADO_QUERY = "SELECT [System.Id], [System.Title], [System.State], [System.AssignedTo] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] <> 'Closed' ORDER BY [System.ChangedDate] DESC";
25
14
  exports.teamsToolDefinitions = [
26
15
  // -- Generic Graph tools --
@@ -46,6 +35,7 @@ exports.teamsToolDefinitions = [
46
35
  return (0, graph_client_1.graphRequest)(ctx.graphToken, "GET", args.path);
47
36
  },
48
37
  integration: "graph",
38
+ summaryKeys: ["path"],
49
39
  },
50
40
  {
51
41
  tool: {
@@ -74,7 +64,8 @@ exports.teamsToolDefinitions = [
74
64
  return (0, graph_client_1.graphRequest)(ctx.graphToken, args.method, args.path, args.body);
75
65
  },
76
66
  integration: "graph",
77
- confirmationRequired: true,
67
+ summaryKeys: ["method", "path"],
68
+ riskProfile: { mutates: "external_side_effect", risk: "high", reason: "mutates Microsoft Graph resources" },
78
69
  },
79
70
  // -- Generic ADO tools --
80
71
  {
@@ -82,7 +73,7 @@ exports.teamsToolDefinitions = [
82
73
  type: "function",
83
74
  function: {
84
75
  name: "ado_query",
85
- description: "GET or POST (for WIQL read queries) any Azure DevOps API endpoint. Use ado_docs first to look up the correct path.",
76
+ description: "GET or POST (for WIQL read queries) any Azure DevOps API endpoint. Use ado_docs first to look up the correct path and host.",
86
77
  parameters: {
87
78
  type: "object",
88
79
  properties: {
@@ -90,6 +81,7 @@ exports.teamsToolDefinitions = [
90
81
  path: { type: "string", description: "ADO API path after /{org}, e.g. /_apis/wit/wiql" },
91
82
  method: { type: "string", enum: ["GET", "POST"], description: "HTTP method (defaults to GET)" },
92
83
  body: { type: "string", description: "JSON request body (optional, used with POST for WIQL)" },
84
+ host: { type: "string", description: "API host override for non-standard APIs (e.g. 'vsapm.dev.azure.com' for entitlements, 'vssps.dev.azure.com' for users). Omit for standard dev.azure.com." },
93
85
  },
94
86
  required: ["organization", "path"],
95
87
  },
@@ -100,18 +92,17 @@ exports.teamsToolDefinitions = [
100
92
  return "AUTH_REQUIRED:ado -- I need access to Azure DevOps. Please sign in when prompted.";
101
93
  }
102
94
  const method = args.method || "GET";
103
- const result = await (0, ado_client_1.adoRequest)(ctx.adoToken, method, args.organization, args.path, args.body);
104
- checkAndRecord403(result, "ado", args.organization, method, ctx);
105
- return result;
95
+ return (0, ado_client_1.adoRequest)(ctx.adoToken, method, args.organization, args.path, args.body, args.host);
106
96
  },
107
97
  integration: "ado",
98
+ summaryKeys: ["method", "organization", "path"],
108
99
  },
109
100
  {
110
101
  tool: {
111
102
  type: "function",
112
103
  function: {
113
104
  name: "ado_mutate",
114
- description: "POST/PATCH/DELETE any Azure DevOps API endpoint for actual mutations. Use ado_docs first to look up the correct path.",
105
+ description: "POST/PATCH/DELETE any Azure DevOps API endpoint for actual mutations. Use ado_docs first to look up the correct path and host.",
115
106
  parameters: {
116
107
  type: "object",
117
108
  properties: {
@@ -119,6 +110,7 @@ exports.teamsToolDefinitions = [
119
110
  organization: { type: "string", description: "Azure DevOps organization name" },
120
111
  path: { type: "string", description: "ADO API path after /{org}" },
121
112
  body: { type: "string", description: "JSON request body (optional)" },
113
+ host: { type: "string", description: "API host override for non-standard APIs (e.g. 'vsapm.dev.azure.com' for entitlements, 'vssps.dev.azure.com' for users). Omit for standard dev.azure.com." },
122
114
  },
123
115
  required: ["method", "organization", "path"],
124
116
  },
@@ -131,14 +123,11 @@ exports.teamsToolDefinitions = [
131
123
  if (!MUTATE_METHODS.includes(args.method)) {
132
124
  return `Invalid method "${args.method}". Must be one of: ${MUTATE_METHODS.join(", ")}`;
133
125
  }
134
- /* v8 ignore next -- fallback unreachable: method is validated against MUTATE_METHODS above @preserve */
135
- const action = METHOD_TO_ACTION[args.method] || args.method;
136
- const result = await (0, ado_client_1.adoRequest)(ctx.adoToken, args.method, args.organization, args.path, args.body);
137
- checkAndRecord403(result, "ado", args.organization, action, ctx);
138
- return result;
126
+ return (0, ado_client_1.adoRequest)(ctx.adoToken, args.method, args.organization, args.path, args.body, args.host);
139
127
  },
140
128
  integration: "ado",
141
- confirmationRequired: true,
129
+ summaryKeys: ["method", "organization", "path"],
130
+ riskProfile: { mutates: "external_side_effect", risk: "high", reason: "mutates Azure DevOps resources" },
142
131
  },
143
132
  // -- Convenience aliases (backward compat) --
144
133
  {
@@ -157,6 +146,7 @@ exports.teamsToolDefinitions = [
157
146
  return (0, graph_client_1.getProfile)(ctx.graphToken);
158
147
  },
159
148
  integration: "graph",
149
+ summaryKeys: [],
160
150
  },
161
151
  {
162
152
  tool: {
@@ -200,6 +190,55 @@ exports.teamsToolDefinitions = [
200
190
  return (0, ado_client_1.queryWorkItems)(ctx.adoToken, org, query);
201
191
  },
202
192
  integration: "ado",
193
+ summaryKeys: ["organization", "query"],
194
+ },
195
+ // -- Proactive messaging --
196
+ {
197
+ tool: {
198
+ type: "function",
199
+ function: {
200
+ name: "teams_send_message",
201
+ description: "send a proactive 1:1 Teams message to a user. requires their AAD object ID (use graph_query /users to find it). the message appears as coming from the bot.",
202
+ parameters: {
203
+ type: "object",
204
+ properties: {
205
+ user_id: { type: "string", description: "AAD object ID of the user to message" },
206
+ user_name: { type: "string", description: "display name of the user (for logging)" },
207
+ message: { type: "string", description: "message text to send" },
208
+ tenant_id: { type: "string", description: "tenant ID (optional, defaults to current conversation tenant)" },
209
+ },
210
+ required: ["user_id", "message"],
211
+ },
212
+ },
213
+ },
214
+ /* v8 ignore start -- proactive messaging requires live Teams SDK conversation client @preserve */
215
+ handler: async (args, ctx) => {
216
+ if (!ctx?.botApi) {
217
+ return "proactive messaging is not available -- no bot API context (this tool only works in the Teams channel)";
218
+ }
219
+ try {
220
+ const tenantId = args.tenant_id || ctx.tenantId;
221
+ // Cast to the SDK's ConversationClient shape (kept as `unknown` in ToolContext to avoid type coupling)
222
+ const conversations = ctx.botApi.conversations;
223
+ const conversation = await conversations.create({
224
+ bot: { id: ctx.botApi.id },
225
+ members: [{ id: args.user_id, role: "user", name: args.user_name || args.user_id }],
226
+ tenantId,
227
+ isGroup: false,
228
+ });
229
+ await conversations.activities(conversation.id).create({
230
+ type: "message",
231
+ text: args.message,
232
+ });
233
+ return `message sent to ${args.user_name || args.user_id}`;
234
+ }
235
+ catch (e) {
236
+ return `failed to send proactive message: ${e instanceof Error ? e.message : String(e)}`;
237
+ }
238
+ },
239
+ /* v8 ignore stop */
240
+ summaryKeys: ["user_name", "user_id"],
241
+ riskProfile: { mutates: "external_side_effect", risk: "high", reason: "sends a proactive Teams message" },
203
242
  },
204
243
  // -- Documentation tools --
205
244
  {
@@ -221,6 +260,7 @@ exports.teamsToolDefinitions = [
221
260
  return searchEndpoints(graph_endpoints_json_1.default, args.query || "");
222
261
  },
223
262
  integration: "graph",
263
+ summaryKeys: ["query"],
224
264
  },
225
265
  {
226
266
  tool: {
@@ -241,12 +281,9 @@ exports.teamsToolDefinitions = [
241
281
  return searchEndpoints(ado_endpoints_json_1.default, args.query || "");
242
282
  },
243
283
  integration: "ado",
284
+ summaryKeys: ["query"],
244
285
  },
245
286
  ];
246
- // Backward-compat: extract just the OpenAI tool schemas
247
- exports.teamsTools = exports.teamsToolDefinitions.map((d) => d.tool);
248
- // Backward-compat: extract just the handlers by name
249
- exports.teamsToolHandlers = Object.fromEntries(exports.teamsToolDefinitions.map((d) => [d.tool.function.name, d.handler]));
250
287
  function searchEndpoints(entries, query) {
251
288
  (0, runtime_1.emitNervesEvent)({
252
289
  component: "repertoire",
@@ -268,41 +305,10 @@ function searchEndpoints(entries, query) {
268
305
  ` ${e.description}`,
269
306
  ` Params: ${e.params || "none"}`,
270
307
  ];
308
+ if (e.host)
309
+ lines.push(` Host: ${e.host}`);
271
310
  if (e.scopes)
272
311
  lines.push(` Scopes: ${e.scopes}`);
273
312
  return lines.join("\n");
274
313
  }).join("\n\n");
275
314
  }
276
- function summarizeTeamsArgs(name, args) {
277
- function summarizeKeyValues(keys) {
278
- const parts = [];
279
- for (const key of keys) {
280
- const raw = args[key];
281
- if (raw === undefined || raw === null)
282
- continue;
283
- const compact = String(raw).replace(/\s+/g, " ").trim();
284
- if (!compact)
285
- continue;
286
- const clipped = compact.length > 60 ? compact.slice(0, 60) + "..." : compact;
287
- parts.push(`${key}=${clipped}`);
288
- }
289
- return parts.join(" ");
290
- }
291
- if (name === "graph_profile")
292
- return "";
293
- if (name === "ado_work_items")
294
- return summarizeKeyValues(["organization", "query"]);
295
- if (name === "graph_query")
296
- return summarizeKeyValues(["path"]);
297
- if (name === "graph_mutate")
298
- return summarizeKeyValues(["method", "path"]);
299
- if (name === "ado_query")
300
- return summarizeKeyValues(["method", "organization", "path"]);
301
- if (name === "ado_mutate")
302
- return summarizeKeyValues(["method", "organization", "path"]);
303
- if (name === "graph_docs")
304
- return summarizeKeyValues(["query"]);
305
- if (name === "ado_docs")
306
- return summarizeKeyValues(["query"]);
307
- return undefined;
308
- }