fruxon 2.3.0__tar.gz → 2.3.2__tar.gz

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 (235) hide show
  1. {fruxon-2.3.0 → fruxon-2.3.2}/HISTORY.md +25 -0
  2. {fruxon-2.3.0 → fruxon-2.3.2}/PKG-INFO +3 -3
  3. {fruxon-2.3.0 → fruxon-2.3.2}/README.md +2 -2
  4. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/_version.py +2 -2
  5. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_memory.py +86 -4
  6. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_sandbox.py +25 -1
  7. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/doctor.py +1 -0
  8. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/examples.py +3 -1
  9. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/doctor.py +126 -0
  10. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/fruxon.py +36 -5
  11. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/models.py +1 -0
  12. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/fruxon-agent-mode/SKILL.md +1 -0
  13. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/fruxon-build-agent/SKILL.md +10 -0
  14. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/fruxon-debug-trace/SKILL.md +1 -1
  15. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/fruxon-meet/SKILL.md +2 -1
  16. {fruxon-2.3.0 → fruxon-2.3.2}/tests/conftest.py +3 -0
  17. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_agents_sandbox.py +27 -1
  18. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_doctor.py +91 -0
  19. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_guides.py +8 -0
  20. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_memory.py +99 -3
  21. {fruxon-2.3.0 → fruxon-2.3.2}/.gitignore +0 -0
  22. {fruxon-2.3.0 → fruxon-2.3.2}/LICENSE +0 -0
  23. {fruxon-2.3.0 → fruxon-2.3.2}/pyproject.toml +0 -0
  24. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/__init__.py +0 -0
  25. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/__main__.py +0 -0
  26. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/_request_id.py +0 -0
  27. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/_ssl.py +0 -0
  28. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/checks/__init__.py +0 -0
  29. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/checks/agent.py +0 -0
  30. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/checks/ledger.py +0 -0
  31. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/checks/references.py +0 -0
  32. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/__init__.py +0 -0
  33. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_crash.py +0 -0
  34. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_last_failure.py +0 -0
  35. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_ledger_passes.py +0 -0
  36. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_plugin_hint.py +0 -0
  37. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_schema.py +0 -0
  38. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_shared.py +0 -0
  39. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/_stream.py +0 -0
  40. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/access_requests.py +0 -0
  41. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents.py +0 -0
  42. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_approvals.py +0 -0
  43. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_budget.py +0 -0
  44. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_channels.py +0 -0
  45. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_draft.py +0 -0
  46. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_evaluations.py +0 -0
  47. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_executions.py +0 -0
  48. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_improvements.py +0 -0
  49. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_lifecycle.py +0 -0
  50. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_reply_style.py +0 -0
  51. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_revisions.py +0 -0
  52. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_sandbox_test.py +0 -0
  53. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_slots.py +0 -0
  54. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_system_blocks.py +0 -0
  55. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_tests.py +0 -0
  56. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_topics.py +0 -0
  57. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/agents_voice_calls.py +0 -0
  58. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/applications.py +0 -0
  59. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/applications_entry_points.py +0 -0
  60. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/assets.py +0 -0
  61. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/auth.py +0 -0
  62. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/capabilities.py +0 -0
  63. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/completion.py +0 -0
  64. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/config.py +0 -0
  65. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/consult_pins.py +0 -0
  66. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/conversation_imports.py +0 -0
  67. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/dash.py +0 -0
  68. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/describe.py +0 -0
  69. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/environments.py +0 -0
  70. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/escalation_desks.py +0 -0
  71. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/escalation_operators.py +0 -0
  72. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/escalations.py +0 -0
  73. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/feedback.py +0 -0
  74. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/guides.py +0 -0
  75. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/integrations.py +0 -0
  76. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/integrations_sandbox.py +0 -0
  77. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/integrations_webhooks.py +0 -0
  78. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/keys.py +0 -0
  79. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/knowledge_bases.py +0 -0
  80. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/knowledge_documents.py +0 -0
  81. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/knowledge_notices.py +0 -0
  82. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/knowledge_sources.py +0 -0
  83. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/llm_providers.py +0 -0
  84. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/messages.py +0 -0
  85. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/metrics.py +0 -0
  86. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/participants.py +0 -0
  87. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/secrets.py +0 -0
  88. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/skills.py +0 -0
  89. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/storage.py +0 -0
  90. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/tools.py +0 -0
  91. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers.py +0 -0
  92. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers_budget.py +0 -0
  93. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers_check.py +0 -0
  94. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers_ledger.py +0 -0
  95. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers_ledger_stage_tests.py +0 -0
  96. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers_questions.py +0 -0
  97. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/triggers_shape.py +0 -0
  98. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/working_hours.py +0 -0
  99. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/cli/workspaces.py +0 -0
  100. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/credentials.py +0 -0
  101. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/device_auth.py +0 -0
  102. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/exceptions.py +0 -0
  103. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/flow_validation.py +0 -0
  104. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/output.py +0 -0
  105. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/params.py +0 -0
  106. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/sandbox_scenario.py +0 -0
  107. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/__init__.py +0 -0
  108. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/fruxon-create-integration/SKILL.md +0 -0
  109. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/skills/fruxon-use-integrations/SKILL.md +0 -0
  110. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/telemetry.py +0 -0
  111. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/__init__.py +0 -0
  112. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/app.py +0 -0
  113. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/demo.py +0 -0
  114. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/links.py +0 -0
  115. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/__init__.py +0 -0
  116. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/agent.py +0 -0
  117. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/base.py +0 -0
  118. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/home.py +0 -0
  119. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/ledger.py +0 -0
  120. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/loader.py +0 -0
  121. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/pickers.py +0 -0
  122. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/screens/trace.py +0 -0
  123. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/source.py +0 -0
  124. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/theme.py +0 -0
  125. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/views.py +0 -0
  126. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/tui/widgets.py +0 -0
  127. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/ui.py +0 -0
  128. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/update_check.py +0 -0
  129. {fruxon-2.3.0 → fruxon-2.3.2}/src/fruxon/validation.py +0 -0
  130. {fruxon-2.3.0 → fruxon-2.3.2}/tests/.test_durations.json +0 -0
  131. {fruxon-2.3.0 → fruxon-2.3.2}/tests/__init__.py +0 -0
  132. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_actor.py +0 -0
  133. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_agent_lifecycle.py +0 -0
  134. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_agent_revisions_list.py +0 -0
  135. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_agent_slots.py +0 -0
  136. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_agents_check_cli.py +0 -0
  137. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_agents_revisions_cli.py +0 -0
  138. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_applications.py +0 -0
  139. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_approvals.py +0 -0
  140. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_assets.py +0 -0
  141. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_budgets.py +0 -0
  142. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_capabilities.py +0 -0
  143. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_channels.py +0 -0
  144. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_checks_agent.py +0 -0
  145. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_checks_ledger.py +0 -0
  146. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli.py +0 -0
  147. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli_base_url_routing.py +0 -0
  148. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli_crash.py +0 -0
  149. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli_feedback.py +0 -0
  150. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli_friction_round2.py +0 -0
  151. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli_friction_round3.py +0 -0
  152. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_cli_root_flags.py +0 -0
  153. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_client.py +0 -0
  154. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_connect_nudge.py +0 -0
  155. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_consult.py +0 -0
  156. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_conversation_imports.py +0 -0
  157. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_credentials.py +0 -0
  158. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_dash_app.py +0 -0
  159. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_dash_cli.py +0 -0
  160. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_dash_client.py +0 -0
  161. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_dash_links.py +0 -0
  162. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_dash_source.py +0 -0
  163. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_describe.py +0 -0
  164. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_device_auth.py +0 -0
  165. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_docs_commands_exist.py +0 -0
  166. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_draft_bootstrap.py +0 -0
  167. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_draft_evaluate_cli.py +0 -0
  168. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_draft_pull_shape.py +0 -0
  169. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_draft_run_replay.py +0 -0
  170. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_draft_validate_cli.py +0 -0
  171. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_drafts.py +0 -0
  172. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_entry_points.py +0 -0
  173. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_environments.py +0 -0
  174. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_escalation_operators.py +0 -0
  175. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_escalations.py +0 -0
  176. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_evaluations.py +0 -0
  177. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_execution_records.py +0 -0
  178. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_flow_validation.py +0 -0
  179. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_fruxon.py +0 -0
  180. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_improvements.py +0 -0
  181. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_integration_configs_write_cli.py +0 -0
  182. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_integration_sandbox_cli.py +0 -0
  183. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_integration_triggers_cli.py +0 -0
  184. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_integrations_authorize_cli.py +0 -0
  185. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_integrations_connect_cli.py +0 -0
  186. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_kb_trial_cli.py +0 -0
  187. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_knowledge_bases.py +0 -0
  188. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_knowledge_documents.py +0 -0
  189. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_knowledge_notices.py +0 -0
  190. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_knowledge_sources.py +0 -0
  191. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_llm_provider_configs_cli.py +0 -0
  192. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_llm_providers_connect_cli.py +0 -0
  193. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_llm_providers_list_cli.py +0 -0
  194. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_managed_by.py +0 -0
  195. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_messages.py +0 -0
  196. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_metrics.py +0 -0
  197. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_online_llm_config_refs.py +0 -0
  198. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_online_prefetch_refs.py +0 -0
  199. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_online_secret_refs.py +0 -0
  200. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_output.py +0 -0
  201. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_params.py +0 -0
  202. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_participants.py +0 -0
  203. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_participants_write.py +0 -0
  204. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_plugin_hint.py +0 -0
  205. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_project_urls.py +0 -0
  206. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_reply_style.py +0 -0
  207. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_request_id.py +0 -0
  208. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_sandbox_scenario.py +0 -0
  209. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_schema.py +0 -0
  210. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_schema_fetch.py +0 -0
  211. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_secrets.py +0 -0
  212. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_skills.py +0 -0
  213. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_ssl.py +0 -0
  214. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_storage.py +0 -0
  215. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_system_blocks.py +0 -0
  216. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_system_blocks_cli.py +0 -0
  217. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_telemetry.py +0 -0
  218. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_test_chats.py +0 -0
  219. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_topics.py +0 -0
  220. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_trigger_budgets.py +0 -0
  221. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers.py +0 -0
  222. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_check_cli.py +0 -0
  223. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_ledger.py +0 -0
  224. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_ledger_batch_views.py +0 -0
  225. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_ledger_stage_tests.py +0 -0
  226. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_questions.py +0 -0
  227. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_shape.py +0 -0
  228. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_triggers_write.py +0 -0
  229. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_tui_boundary.py +0 -0
  230. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_ui.py +0 -0
  231. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_update_check.py +0 -0
  232. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_validation.py +0 -0
  233. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_voice_calls.py +0 -0
  234. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_working_hours_cli.py +0 -0
  235. {fruxon-2.3.0 → fruxon-2.3.2}/tests/test_workspaces_cli.py +0 -0
@@ -1,5 +1,30 @@
1
1
  # History
2
2
 
3
+ ## Unreleased — a stale Claude Code plugin shows up in doctor
4
+
5
+ - **`fruxon doctor`** has a **Claude Code plugin** row (F-034): it finds the installed fruxon plugin (Claude
6
+ Code's installed-plugins registry, else its plugin cache, under `$CLAUDE_CONFIG_DIR` or `~/.claude`) and
7
+ warns when its version differs from the CLI's, with the `claude plugin marketplace update` /
8
+ `claude plugin update fruxon@<marketplace>` commands to run (or `pip install -U fruxon` when the plugin is the
9
+ newer one). A missing plugin is fine, and a CLI run from source skips the comparison. In JSON it is the
10
+ `Claude Code plugin` check.
11
+ - The bundled guides no longer say "pipeline" anywhere, so nothing in them reads as the collection pipelines
12
+ sdk#168 removed; a test keeps it that way.
13
+
14
+ ## Unreleased — testing memory in the sandbox
15
+
16
+ - **`fruxon agents sandbox open <agent> --keep-memory`** (F-019): the session gets real memory in a separate
17
+ sandbox realm — it recalls what earlier `--keep-memory` sessions stored, and live runs never see it.
18
+ Without the flag nothing changes: a sandbox session recalls nothing and its memory writes are discarded.
19
+ The text output says when memory persists. `FruxonClient.open_sandbox_session(agent, persist_memory=True)`
20
+ sends `persistMemory: true` (omitted otherwise).
21
+ - **`fruxon agents memory reset-sandbox <agent>`** deletes the sandbox realm only and prints `deletedCount`;
22
+ confirms, and refuses without `--yes` in agent mode (EXIT 16). Needs the Editor role and `agents:test`.
23
+ **`FruxonClient.reset_sandbox_memories`**.
24
+ - **`--realm LIVE|SANDBOX`** on `agents memory list` and `agents memory subjects` (default: the server's,
25
+ `LIVE`). `list_memories(realm=…)`, `list_memory_subjects(realm=…)`; `Memory.realm`, and `realm` in the
26
+ JSON of `list` / `get`.
27
+
3
28
  ## Unreleased — taking a Telegram channel live from the CLI
4
29
 
5
30
  - **`fruxon integrations configs webhook generate|rotate|apply|inspect|remove <integration> <config>`**
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: fruxon
3
- Version: 2.3.0
3
+ Version: 2.3.2
4
4
  Summary: The Fruxon SDK is a lightweight Python client for integrating with the Fruxon platform.
5
5
  Project-URL: homepage, https://fruxon.com
6
6
  Project-URL: documentation, https://docs.fruxon.com/guides/cli
@@ -99,14 +99,14 @@ Execution:
99
99
  | `fruxon agents executions trace <agent> <record-id>` | Step-by-step trace of one execution — LLM/tool calls, durations, and for a tool that records it, where the call's time went (service stages vs. unaccounted). Flags a result the model got offloaded or projected. Prints a quality check's verdict (score, criteria, rationale) under its `JUDGE` step, and marks a reply the check refused. `--show-io` also prints each tool step's parameters and result (the payload lives at `steps[].result`, a sibling of `toolTrace` — whose `resultDelivery` carries sizes only). `--show-system` labels each LLM step's system prompt block by block — your prompt vs. the platform's `<tag>` blocks, sizes, and the cache breakpoint. |
100
100
  | `fruxon agents executions result <agent> <record-id>` | The final output one execution produced. |
101
101
  | `fruxon agents approvals list/get/respond/cancel <agent>` | Operate human-in-the-loop approval gates — see what a run is blocked on and answer it. `respond`/`cancel` confirm first and refuse without `--yes` in agent mode (an LLM must not silently auto-approve). |
102
- | `fruxon agents memory list/subjects/get/forget-subject <agent>` | Inspect and prune what an agent remembers. `list` filters server-side by `--subject`/`--query`/`--scope`; `forget-subject` is a GDPR-style delete (confirms; refuses without `--yes` in agent mode). |
102
+ | `fruxon agents memory list/subjects/get/forget-subject/reset-sandbox <agent>` | Inspect and prune what an agent remembers. `list` filters server-side by `--subject`/`--query`/`--scope`; `list` / `subjects` read the live realm unless `--realm SANDBOX`; `forget-subject` is a GDPR-style delete and `reset-sandbox` wipes only the sandbox realm (both confirm; refuse without `--yes` in agent mode). |
103
103
  | `fruxon agents topics list/search/get/messages/sessions <agent>` + `fruxon agents inbox <agent>` | Read the conversation spine — the agent's topics (threads), one topic's transcript, its episodes, and its inbox (what it's focused on). `list`/`search` filter server-side by `--state`/`--participant`/`--query`. Read-only. Each message carries `author` — a human colleague's turn is stored as `ASSISTANT` on purpose, so `role` alone cannot tell their reply from the agent's; `HUMAN_OPERATOR` can. A message the runtime *withheld* is in no transcript at all — see `fruxon messages list`. `sessions` explains a fresh, blind session: a topic outlives its sessions, and `endCause` on the previous one (`CONSOLE_ALREADY_RESOLVED` — a human closed it in the provider's console) is why the next started with no history. |
104
104
  | `fruxon escalations list/history/unhandled/policy/ack` | What happened when an agent handed a conversation to a person. `list` is the queue (live takeovers + degraded escalations nobody was reachable for); `unhandled` is the append-only ledger under it; `list --include-rehearsals` also shows sandbox rehearsals, which page nobody (newer servers; it warns when the server ignored the flag). **`history` is the record of closed console-routed takeovers** — those leave the queue, so `list --status ALL` answers `[]` about a conversation a human worked for half an hour. Read `humanObservedAt` before believing a `RESOLVED`: null means nobody was ever seen picking it up. `policy <agent>` resolves who the *next* escalation would reach — an empty ladder under `NATIVE_HANDOFF` is correct, the console supplies the human — and names the desk it went through. `set-policy <agent>` changes that desk: `--operator` (repeatable, one tier; `--strategy`), `--working-hours <schedule|none>`, `--default-reason`, `--entry-point` for a channel's desk. It reads the desk and PUTs it back with only those changed, for every agent on the desk (`participants:write`). |
105
105
  | `fruxon escalations desks list/create/attach/detach` | An Application's escalation desks. `create --name … [--mode BRIDGE\|NATIVE_HANDOFF] [--operator …] [--working-hours …] [--attach other\|<entry-point>]` makes one and attaches it; `attach <desk> other <entry-point>…` / `detach other <entry-point>…` move hand-off between desks. `other` is conversations through no channel (operator desks only). `--agent` picks the agent's Application, `--application` names one. |
106
106
  | `fruxon escalations operators list/candidates/add/remove` | An Application's human operators — the only people a desk's `--operator` ladder accepts. `candidates [--search …]` shows who can be added (`ELIGIBLE`, `PROMOTABLE` = marked internal on add, `INELIGIBLE`); `add <participant>…`; `remove <participant>… --yes`. Same `--agent` / `--application` as `desks`. |
107
107
  | `fruxon working-hours list/get/create/update/delete` | Working-hours schedules: a time zone, a week (`--hours "sun-thu 08:00-20:00"`, repeatable; a day not named is closed), dated closures (`--closed 2026-12-25`), or `--file` with the full body. A schedule governs the escalation hand-off once a desk uses it (`escalations set-policy --working-hours`); what the agent says about opening hours stays in its prompt. `participants:read` / `participants:write`. |
108
108
  | `fruxon messages list` | The channel ledger — including inbound an agent was never shown. A **withheld** message (a human owns the chat in the source console, or admission refused the sender) never becomes a conversation turn, so it is in no transcript and the thread reads as a customer being ignored. `--delivery WITHHELD_PENDING` lists the ones nothing has ever acted on; nothing drains them. |
109
- | `fruxon agents sandbox open/turn/fire/resolve-input/stream/answer/close <session>` | Drive an agent-network sandbox end-to-end without real channels — send turns as participants, test-fire triggers, and watch the run (`--wait` on `turn` / `fire` follows it to the end; `stream` shows only what happens after it connects; NDJSON in agent mode). Sandbox **captures the reply and hard-blocks every real send**; `--await` makes consult/approval gates suspend so they can be resolved (`answer` for consults, `approvals respond` for approvals). `--draft` runs your unpublished draft instead of the deployed revision (`sandbox draft <session>` says which); `--confirm-writes` holds every create/update/delete tool call for approval, because sandbox does **not** block integration writes; a write that did not run (rejected, expired, or one the run could not pause for) shows on `stream` as `refused`. |
109
+ | `fruxon agents sandbox open/turn/fire/resolve-input/stream/answer/close <session>` | Drive an agent-network sandbox end-to-end without real channels — send turns as participants, test-fire triggers, and watch the run (`--wait` on `turn` / `fire` follows it to the end; `stream` shows only what happens after it connects; NDJSON in agent mode). Sandbox **captures the reply and hard-blocks every real send**; `open --keep-memory` gives the session real memory in a separate sandbox realm, recalled by later `--keep-memory` sessions and never by live runs, so recall can be tested across sessions; `--await` makes consult/approval gates suspend so they can be resolved (`answer` for consults, `approvals respond` for approvals). `--draft` runs your unpublished draft instead of the deployed revision (`sandbox draft <session>` says which); `--confirm-writes` holds every create/update/delete tool call for approval, because sandbox does **not** block integration writes; a write that did not run (rejected, expired, or one the run could not pause for) shows on `stream` as `refused`. |
110
110
  | `fruxon agents voice-calls list/get <agent>` | Read back the Test lab's Talk calls. `list` gives calls newest first (status, end reason, turns, length). `get <agent> <call-id>` gives the call turn by turn: the caller's transcript, the reply, what was heard of it (`delivery`; `spokenText` when the caller cut in), and each reply's `executionRecordId` for `agents executions trace`. Read-only; needs `executions:read`. |
111
111
  | `fruxon agents sandbox fork <agent> <message-id>` | Fork a real conversation at a transcript row (an `id` from `agents topics messages`) into a sandbox session already holding the history the agent had when it produced that reply. `--send` re-sends the customer's message against it — with `--draft` to test an edit before publishing, and `--wait` to follow the turn until it ends — and holds writes for approval unless `--no-confirm-writes`. |
112
112
  | `fruxon agents sandbox test <file-or-dir>` | Run scenario-based e2e tests of an agent's network behavior. A scenario (YAML/JSON) declares `steps` (turns / trigger fires), `responders` (scripted consult/approval answers), and `expect` assertions (reply / routing / tools called or refused / no-leak / outcome); the runner drives a sandbox session and returns one verdict — exit 0 (pass) / 1 (fail) / 12 (bad file), with `--junit` for CI. An optional `setup` block provisions real resources first — an `asset` (uploaded + ingestion-waited), `participant`, or `agent` — templated as `${asset.catalog.id}` and **torn down afterwards even on failure** (`--keep` to inspect) — or a `seed` step that resets, imports into and/or generates a SIMULATED integration config's sandbox store (not torn down; only sandbox runs read it). Assertions are deterministic by default; `reply_judge: {metric, min_score}` adds an opt-in **semantic** check that scores the reply against a tenant eval metric. The thing an agent runs to prove the agent it built works. |
@@ -65,14 +65,14 @@ Execution:
65
65
  | `fruxon agents executions trace <agent> <record-id>` | Step-by-step trace of one execution — LLM/tool calls, durations, and for a tool that records it, where the call's time went (service stages vs. unaccounted). Flags a result the model got offloaded or projected. Prints a quality check's verdict (score, criteria, rationale) under its `JUDGE` step, and marks a reply the check refused. `--show-io` also prints each tool step's parameters and result (the payload lives at `steps[].result`, a sibling of `toolTrace` — whose `resultDelivery` carries sizes only). `--show-system` labels each LLM step's system prompt block by block — your prompt vs. the platform's `<tag>` blocks, sizes, and the cache breakpoint. |
66
66
  | `fruxon agents executions result <agent> <record-id>` | The final output one execution produced. |
67
67
  | `fruxon agents approvals list/get/respond/cancel <agent>` | Operate human-in-the-loop approval gates — see what a run is blocked on and answer it. `respond`/`cancel` confirm first and refuse without `--yes` in agent mode (an LLM must not silently auto-approve). |
68
- | `fruxon agents memory list/subjects/get/forget-subject <agent>` | Inspect and prune what an agent remembers. `list` filters server-side by `--subject`/`--query`/`--scope`; `forget-subject` is a GDPR-style delete (confirms; refuses without `--yes` in agent mode). |
68
+ | `fruxon agents memory list/subjects/get/forget-subject/reset-sandbox <agent>` | Inspect and prune what an agent remembers. `list` filters server-side by `--subject`/`--query`/`--scope`; `list` / `subjects` read the live realm unless `--realm SANDBOX`; `forget-subject` is a GDPR-style delete and `reset-sandbox` wipes only the sandbox realm (both confirm; refuse without `--yes` in agent mode). |
69
69
  | `fruxon agents topics list/search/get/messages/sessions <agent>` + `fruxon agents inbox <agent>` | Read the conversation spine — the agent's topics (threads), one topic's transcript, its episodes, and its inbox (what it's focused on). `list`/`search` filter server-side by `--state`/`--participant`/`--query`. Read-only. Each message carries `author` — a human colleague's turn is stored as `ASSISTANT` on purpose, so `role` alone cannot tell their reply from the agent's; `HUMAN_OPERATOR` can. A message the runtime *withheld* is in no transcript at all — see `fruxon messages list`. `sessions` explains a fresh, blind session: a topic outlives its sessions, and `endCause` on the previous one (`CONSOLE_ALREADY_RESOLVED` — a human closed it in the provider's console) is why the next started with no history. |
70
70
  | `fruxon escalations list/history/unhandled/policy/ack` | What happened when an agent handed a conversation to a person. `list` is the queue (live takeovers + degraded escalations nobody was reachable for); `unhandled` is the append-only ledger under it; `list --include-rehearsals` also shows sandbox rehearsals, which page nobody (newer servers; it warns when the server ignored the flag). **`history` is the record of closed console-routed takeovers** — those leave the queue, so `list --status ALL` answers `[]` about a conversation a human worked for half an hour. Read `humanObservedAt` before believing a `RESOLVED`: null means nobody was ever seen picking it up. `policy <agent>` resolves who the *next* escalation would reach — an empty ladder under `NATIVE_HANDOFF` is correct, the console supplies the human — and names the desk it went through. `set-policy <agent>` changes that desk: `--operator` (repeatable, one tier; `--strategy`), `--working-hours <schedule|none>`, `--default-reason`, `--entry-point` for a channel's desk. It reads the desk and PUTs it back with only those changed, for every agent on the desk (`participants:write`). |
71
71
  | `fruxon escalations desks list/create/attach/detach` | An Application's escalation desks. `create --name … [--mode BRIDGE\|NATIVE_HANDOFF] [--operator …] [--working-hours …] [--attach other\|<entry-point>]` makes one and attaches it; `attach <desk> other <entry-point>…` / `detach other <entry-point>…` move hand-off between desks. `other` is conversations through no channel (operator desks only). `--agent` picks the agent's Application, `--application` names one. |
72
72
  | `fruxon escalations operators list/candidates/add/remove` | An Application's human operators — the only people a desk's `--operator` ladder accepts. `candidates [--search …]` shows who can be added (`ELIGIBLE`, `PROMOTABLE` = marked internal on add, `INELIGIBLE`); `add <participant>…`; `remove <participant>… --yes`. Same `--agent` / `--application` as `desks`. |
73
73
  | `fruxon working-hours list/get/create/update/delete` | Working-hours schedules: a time zone, a week (`--hours "sun-thu 08:00-20:00"`, repeatable; a day not named is closed), dated closures (`--closed 2026-12-25`), or `--file` with the full body. A schedule governs the escalation hand-off once a desk uses it (`escalations set-policy --working-hours`); what the agent says about opening hours stays in its prompt. `participants:read` / `participants:write`. |
74
74
  | `fruxon messages list` | The channel ledger — including inbound an agent was never shown. A **withheld** message (a human owns the chat in the source console, or admission refused the sender) never becomes a conversation turn, so it is in no transcript and the thread reads as a customer being ignored. `--delivery WITHHELD_PENDING` lists the ones nothing has ever acted on; nothing drains them. |
75
- | `fruxon agents sandbox open/turn/fire/resolve-input/stream/answer/close <session>` | Drive an agent-network sandbox end-to-end without real channels — send turns as participants, test-fire triggers, and watch the run (`--wait` on `turn` / `fire` follows it to the end; `stream` shows only what happens after it connects; NDJSON in agent mode). Sandbox **captures the reply and hard-blocks every real send**; `--await` makes consult/approval gates suspend so they can be resolved (`answer` for consults, `approvals respond` for approvals). `--draft` runs your unpublished draft instead of the deployed revision (`sandbox draft <session>` says which); `--confirm-writes` holds every create/update/delete tool call for approval, because sandbox does **not** block integration writes; a write that did not run (rejected, expired, or one the run could not pause for) shows on `stream` as `refused`. |
75
+ | `fruxon agents sandbox open/turn/fire/resolve-input/stream/answer/close <session>` | Drive an agent-network sandbox end-to-end without real channels — send turns as participants, test-fire triggers, and watch the run (`--wait` on `turn` / `fire` follows it to the end; `stream` shows only what happens after it connects; NDJSON in agent mode). Sandbox **captures the reply and hard-blocks every real send**; `open --keep-memory` gives the session real memory in a separate sandbox realm, recalled by later `--keep-memory` sessions and never by live runs, so recall can be tested across sessions; `--await` makes consult/approval gates suspend so they can be resolved (`answer` for consults, `approvals respond` for approvals). `--draft` runs your unpublished draft instead of the deployed revision (`sandbox draft <session>` says which); `--confirm-writes` holds every create/update/delete tool call for approval, because sandbox does **not** block integration writes; a write that did not run (rejected, expired, or one the run could not pause for) shows on `stream` as `refused`. |
76
76
  | `fruxon agents voice-calls list/get <agent>` | Read back the Test lab's Talk calls. `list` gives calls newest first (status, end reason, turns, length). `get <agent> <call-id>` gives the call turn by turn: the caller's transcript, the reply, what was heard of it (`delivery`; `spokenText` when the caller cut in), and each reply's `executionRecordId` for `agents executions trace`. Read-only; needs `executions:read`. |
77
77
  | `fruxon agents sandbox fork <agent> <message-id>` | Fork a real conversation at a transcript row (an `id` from `agents topics messages`) into a sandbox session already holding the history the agent had when it produced that reply. `--send` re-sends the customer's message against it — with `--draft` to test an edit before publishing, and `--wait` to follow the turn until it ends — and holds writes for approval unless `--no-confirm-writes`. |
78
78
  | `fruxon agents sandbox test <file-or-dir>` | Run scenario-based e2e tests of an agent's network behavior. A scenario (YAML/JSON) declares `steps` (turns / trigger fires), `responders` (scripted consult/approval answers), and `expect` assertions (reply / routing / tools called or refused / no-leak / outcome); the runner drives a sandbox session and returns one verdict — exit 0 (pass) / 1 (fail) / 12 (bad file), with `--junit` for CI. An optional `setup` block provisions real resources first — an `asset` (uploaded + ingestion-waited), `participant`, or `agent` — templated as `${asset.catalog.id}` and **torn down afterwards even on failure** (`--keep` to inspect) — or a `seed` step that resets, imports into and/or generates a SIMULATED integration config's sandbox store (not torn down; only sandbox runs read it). Assertions are deterministic by default; `reply_judge: {metric, min_score}` adds an opt-in **semantic** check that scores the reply against a tenant eval metric. The thing an agent runs to prove the agent it built works. |
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '2.3.0'
22
- __version_tuple__ = version_tuple = (2, 3, 0)
21
+ __version__ = version = '2.3.2'
22
+ __version_tuple__ = version_tuple = (2, 3, 2)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -11,6 +11,11 @@ Designed for an LLM driver: ``list`` narrows **server-side** by
11
11
  instead of dumping everything), and ``forget-subject`` — irreversible —
12
12
  confirms first and refuses without ``--yes`` under agent mode.
13
13
 
14
+ Memories live in two realms: ``LIVE`` (real runs) and ``SANDBOX`` (what
15
+ ``agents sandbox open --keep-memory`` sessions stored). ``list`` and
16
+ ``subjects`` read ``LIVE`` unless ``--realm SANDBOX``; ``reset-sandbox``
17
+ wipes the sandbox realm only.
18
+
14
19
  Read-only otherwise: the agent writes its own memories at run time;
15
20
  editing an individual memory by hand is a dashboard concern.
16
21
  """
@@ -38,12 +43,17 @@ from fruxon.ui import (
38
43
  )
39
44
 
40
45
  memory_app = typer.Typer(
41
- help="Inspect and prune an agent's memories (list / subjects / get / forget-subject).",
46
+ help="Inspect and prune an agent's memories (list / subjects / get / forget-subject / reset-sandbox).",
42
47
  no_args_is_help=True,
43
48
  )
44
49
  agents_app.add_typer(memory_app, name="memory")
45
50
 
46
51
  _SCOPES = {"AGENT", "SUBJECT"}
52
+ _REALMS = {"LIVE", "SANDBOX"}
53
+
54
+ _REALM_HELP = (
55
+ "LIVE (default: what real runs remember) or SANDBOX (what `agents sandbox open --keep-memory` sessions stored)."
56
+ )
47
57
 
48
58
 
49
59
  @memory_app.command("list")
@@ -64,6 +74,7 @@ def memory_list(
64
74
  str | None,
65
75
  typer.Option("--scope", help="AGENT (cross-everyone facts) or SUBJECT (per-person facts)."),
66
76
  ] = None,
77
+ realm: Annotated[str | None, typer.Option("--realm", help=_REALM_HELP)] = None,
67
78
  workspace: Annotated[str | None, typer.Option("--workspace", help="Workspace identifier override.")] = None,
68
79
  base_url: Annotated[str | None, typer.Option("--base-url", help="API base URL override.")] = None,
69
80
  output: Annotated[
@@ -90,6 +101,7 @@ def memory_list(
90
101
  fruxon agents memory list my-agent --subject telegram:123456789
91
102
  fruxon agents memory list my-agent --query "dark mode"
92
103
  fruxon agents memory list my-agent --scope AGENT --output id
104
+ fruxon agents memory list my-agent --realm SANDBOX
93
105
  """
94
106
  output = resolve_output_format(output, human_default="table", agent_default="json")
95
107
  if output not in {"table", "json", "id"}:
@@ -99,14 +111,15 @@ def memory_list(
99
111
  code=EXIT_VALIDATION,
100
112
  )
101
113
  scope_norm = _normalize_scope(scope)
114
+ realm_norm = _normalize_realm(realm)
102
115
 
103
116
  client = build_client(workspace, base_url)
104
117
  try:
105
118
  if stderr.is_terminal and output != "id":
106
119
  with stderr.status(f"[bold]Fetching memories for [cyan]{agent}[/cyan]…[/bold]"):
107
- memories = client.list_memories(agent, subject=subject, query=query, scope=scope_norm)
120
+ memories = client.list_memories(agent, subject=subject, query=query, scope=scope_norm, realm=realm_norm)
108
121
  else:
109
- memories = client.list_memories(agent, subject=subject, query=query, scope=scope_norm)
122
+ memories = client.list_memories(agent, subject=subject, query=query, scope=scope_norm, realm=realm_norm)
110
123
  except FruxonError as e:
111
124
  fail_from_api_error(e, hint=_hint_for_get_error(e, agent, client))
112
125
 
@@ -136,6 +149,7 @@ def memory_list(
136
149
  @memory_app.command("subjects")
137
150
  def memory_subjects(
138
151
  agent: Annotated[str, typer.Argument(help="Agent whose memory subjects to list.")],
152
+ realm: Annotated[str | None, typer.Option("--realm", help=_REALM_HELP)] = None,
139
153
  workspace: Annotated[str | None, typer.Option("--workspace", help="Workspace identifier override.")] = None,
140
154
  base_url: Annotated[str | None, typer.Option("--base-url", help="API base URL override.")] = None,
141
155
  output: Annotated[
@@ -151,6 +165,7 @@ def memory_subjects(
151
165
  Examples:
152
166
  fruxon agents memory subjects my-agent
153
167
  fruxon agents memory subjects my-agent --output id
168
+ fruxon agents memory subjects my-agent --realm SANDBOX
154
169
  """
155
170
  output = resolve_output_format(output, human_default="table", agent_default="json")
156
171
  if output not in {"table", "json", "id"}:
@@ -160,9 +175,11 @@ def memory_subjects(
160
175
  code=EXIT_VALIDATION,
161
176
  )
162
177
 
178
+ realm_norm = _normalize_realm(realm)
179
+
163
180
  client = build_client(workspace, base_url)
164
181
  try:
165
- body = client.list_memory_subjects(agent)
182
+ body = client.list_memory_subjects(agent, realm=realm_norm)
166
183
  except FruxonError as e:
167
184
  fail_from_api_error(e, hint=_hint_for_get_error(e, agent, client))
168
185
 
@@ -225,6 +242,8 @@ def memory_get(
225
242
  stderr.print()
226
243
  _say_kv("id", fetched.id)
227
244
  _say_kv("scope", fetched.scope or "[dim]—[/dim]")
245
+ if fetched.realm:
246
+ _say_kv("realm", fetched.realm)
228
247
  if fetched.subject:
229
248
  _say_kv("subject", fetched.subject)
230
249
  if fetched.tags:
@@ -295,6 +314,55 @@ def memory_forget_subject(
295
314
  say_ok(f"Forgot [bold]{count if count is not None else 'all'}[/bold] memories about [bold]{subject}[/bold].")
296
315
 
297
316
 
317
+ @memory_app.command("reset-sandbox")
318
+ def memory_reset_sandbox(
319
+ agent: Annotated[str, typer.Argument(help="Agent whose sandbox memories to delete.")],
320
+ yes: Annotated[
321
+ bool,
322
+ typer.Option("--yes", "-y", help="Skip the confirmation prompt. REQUIRED under agent mode (CLAUDECODE / CI)."),
323
+ ] = False,
324
+ workspace: Annotated[str | None, typer.Option("--workspace", help="Workspace identifier override.")] = None,
325
+ base_url: Annotated[str | None, typer.Option("--base-url", help="API base URL override.")] = None,
326
+ output: Annotated[
327
+ str | None,
328
+ typer.Option("--output", "-o", help="Output format: text (default), json."),
329
+ ] = None,
330
+ ):
331
+ """Delete every memory in an agent's sandbox realm — live memories are untouched.
332
+
333
+ The sandbox realm holds what `agents sandbox open --keep-memory`
334
+ sessions stored. Reset it to start a memory test from a clean slate.
335
+ Irreversible; confirms first, and under agent mode refuses without
336
+ [bold]--yes[/bold]. Needs the Editor role.
337
+
338
+ Examples:
339
+ fruxon agents memory reset-sandbox my-agent --yes
340
+ fruxon agents memory reset-sandbox my-agent --yes -o json
341
+ """
342
+ output = resolve_output_format(output, human_default="text", agent_default="json")
343
+ if output not in {"text", "json"}:
344
+ fail(f"Unknown output format: [bold]{output}[/bold]", hint="Valid formats: text, json.", code=EXIT_VALIDATION)
345
+
346
+ confirm_or_die(
347
+ f"Delete [bold]every sandbox memory[/bold] of [bold]{agent}[/bold]? Live memories are kept. "
348
+ "This can't be undone.",
349
+ yes=yes,
350
+ action="reset an agent's sandbox memories",
351
+ )
352
+
353
+ client = build_client(workspace, base_url)
354
+ try:
355
+ result = client.reset_sandbox_memories(agent)
356
+ except FruxonError as e:
357
+ fail_from_api_error(e, hint=_hint_for_get_error(e, agent, client))
358
+
359
+ count = result.get("deletedCount") if isinstance(result, dict) else None
360
+ if output == "json":
361
+ print(json.dumps(result if isinstance(result, dict) else {"deletedCount": count}, indent=2))
362
+ return
363
+ say_ok(f"Deleted [bold]{count if count is not None else 'all'}[/bold] sandbox memories of [bold]{agent}[/bold].")
364
+
365
+
298
366
  # ─────────────────────────────────────────────────────────────────────────────
299
367
  # helpers
300
368
  # ─────────────────────────────────────────────────────────────────────────────
@@ -313,11 +381,25 @@ def _normalize_scope(scope: str | None) -> str | None:
313
381
  return norm
314
382
 
315
383
 
384
+ def _normalize_realm(realm: str | None) -> str | None:
385
+ if realm is None:
386
+ return None
387
+ norm = realm.strip().upper()
388
+ if norm not in _REALMS:
389
+ fail(
390
+ f"Unknown realm [bold]{realm}[/bold].",
391
+ hint=f"Valid realms: {', '.join(sorted(_REALMS))}.",
392
+ code=EXIT_VALIDATION,
393
+ )
394
+ return norm
395
+
396
+
316
397
  def _to_dict(m: Memory) -> dict:
317
398
  """Serialize for ``--output json`` — camelCase to mirror the API payload."""
318
399
  return {
319
400
  "id": m.id,
320
401
  "scope": m.scope,
402
+ "realm": m.realm,
321
403
  "subject": m.subject,
322
404
  "title": m.title,
323
405
  "content": m.content,
@@ -80,6 +80,16 @@ _TIMEOUT_HELP = "With --wait: seconds to wait for the turn to end before giving
80
80
  @sandbox_app.command("open")
81
81
  def sandbox_open(
82
82
  agent: Annotated[str, typer.Argument(help="Agent to open the sandbox session against.")],
83
+ keep_memory: Annotated[
84
+ bool,
85
+ typer.Option(
86
+ "--keep-memory",
87
+ help=(
88
+ "Give the session real memory in a separate sandbox realm: it recalls what earlier "
89
+ "--keep-memory sessions stored and stores for later ones. Never visible to live runs."
90
+ ),
91
+ ),
92
+ ] = False,
83
93
  workspace: Annotated[str | None, typer.Option("--workspace", help="Workspace identifier override.")] = None,
84
94
  base_url: Annotated[str | None, typer.Option("--base-url", help="API base URL override.")] = None,
85
95
  output: Annotated[
@@ -92,11 +102,19 @@ def sandbox_open(
92
102
  Pipe the id into later commands:
93
103
  S=$(fruxon agents sandbox open my-agent -o id)
94
104
  fruxon agents sandbox turn "$S" --as <participant> --text "hi"
105
+
106
+ By default the session has no memory: nothing is recalled and memory
107
+ writes are discarded. [bold]--keep-memory[/bold] gives it real memory in a
108
+ separate sandbox realm, so you can test recall across sessions — tell
109
+ session A a fact, close it, open session B with [bold]--keep-memory[/bold]
110
+ and ask. Live runs never see sandbox memories. Inspect them with
111
+ `agents memory list <agent> --realm SANDBOX`; wipe them with
112
+ `agents memory reset-sandbox <agent>`.
95
113
  """
96
114
  output = _resolve_format(output)
97
115
  client = build_client(workspace, base_url)
98
116
  try:
99
- session = client.open_sandbox_session(agent)
117
+ session = client.open_sandbox_session(agent, persist_memory=keep_memory)
100
118
  except FruxonError as e:
101
119
  fail_from_api_error(e, hint=_hint_for_get_error(e, agent, client))
102
120
 
@@ -107,6 +125,12 @@ def sandbox_open(
107
125
  print(json.dumps(session, indent=2))
108
126
  return
109
127
  say_ok(f"Opened sandbox session [bold]{session.get('sessionId')}[/bold] for [bold]{agent}[/bold].")
128
+ if keep_memory:
129
+ say_info(
130
+ "Memory persists in the sandbox realm: this session recalls and stores memories shared with "
131
+ "other --keep-memory sessions (never with live runs). Wipe with "
132
+ f"[bold]fruxon agents memory reset-sandbox {agent}[/bold]."
133
+ )
110
134
 
111
135
 
112
136
  @sandbox_app.command("fork")
@@ -102,6 +102,7 @@ def doctor(
102
102
  "Base URL": "credentials",
103
103
  "API reachability": "api_reachability",
104
104
  "Auth health": "auth",
105
+ "Claude Code plugin": "claude_plugin",
105
106
  }
106
107
  failed_keys = sorted(
107
108
  {_DOCTOR_TITLE_TO_KEY[r.title] for r in results if r.status != "ok" and r.title in _DOCTOR_TITLE_TO_KEY}
@@ -206,7 +206,7 @@ _EXAMPLES: dict[str, list[tuple[str, str]]] = {
206
206
  "Merge the clusters you accepted from that report — a cluster whose documents moved "
207
207
  "since comes back STALE and is left entirely alone",
208
208
  ),
209
- ("fruxon knowledge-bases source list $KB", "The pipelines writing articles — a built source lands PAUSED"),
209
+ ("fruxon knowledge-bases source list $KB", "The sources that write articles — a built source lands PAUSED"),
210
210
  (
211
211
  "fruxon knowledge-bases source preview $KB $SOURCE",
212
212
  "What it would read, admitting nothing — counts are floors once a ceiling stopped the scan",
@@ -406,6 +406,8 @@ _EXAMPLES: dict[str, list[tuple[str, str]]] = {
406
406
  "fruxon agents memory forget-subject my-agent telegram:123456789 --yes",
407
407
  "GDPR-forget everything about a person",
408
408
  ),
409
+ ("fruxon agents memory list my-agent --realm SANDBOX", "What --keep-memory sandbox sessions stored"),
410
+ ("fruxon agents memory reset-sandbox my-agent --yes", "Wipe the sandbox realm before a memory test"),
409
411
  ],
410
412
  "metrics": [
411
413
  ("fruxon metrics list", "Browse evaluation metrics (ids for quality checks)"),
@@ -170,6 +170,131 @@ def check_sdk_version(*, skip_network: bool = False) -> CheckResult:
170
170
  return CheckResult("Fruxon SDK", "ok", f"v{version}", hint=upgrade_hint)
171
171
 
172
172
 
173
+ def _claude_config_dir() -> Path:
174
+ """Claude Code's config dir: ``$CLAUDE_CONFIG_DIR`` when set, else ``~/.claude``."""
175
+ override = os.environ.get("CLAUDE_CONFIG_DIR")
176
+ return Path(override).expanduser() if override else Path.home() / ".claude"
177
+
178
+
179
+ def _version_tuple(version: str) -> tuple[int, ...] | None:
180
+ parts: list[int] = []
181
+ for piece in version.strip().lstrip("v").split("."):
182
+ digits = ""
183
+ for ch in piece:
184
+ if not ch.isdigit():
185
+ break
186
+ digits += ch
187
+ if not digits:
188
+ break
189
+ parts.append(int(digits))
190
+ return tuple(parts) or None
191
+
192
+
193
+ def _plugin_manifest_version(install_path: Path) -> str | None:
194
+ for manifest in (install_path / ".claude-plugin" / "plugin.json", install_path / "plugin.json"):
195
+ try:
196
+ version = json.loads(manifest.read_text()).get("version")
197
+ except (OSError, ValueError, AttributeError):
198
+ continue
199
+ if isinstance(version, str) and version:
200
+ return version
201
+ return None
202
+
203
+
204
+ def find_claude_plugin() -> tuple[str, str, Path] | None:
205
+ """Locate the installed fruxon Claude Code plugin.
206
+
207
+ Returns ``(version, marketplace, install_path)`` or ``None``. Reads
208
+ Claude Code's installed-plugins registry first (``plugins/installed_plugins.json``,
209
+ keyed ``fruxon@<marketplace>``), then falls back to the plugin cache
210
+ (``plugins/cache/<marketplace>/fruxon/<version>/``). When more than one
211
+ copy is installed, the newest version wins — that's the one a stale
212
+ warning should be judged against.
213
+ """
214
+ plugins_dir = _claude_config_dir() / "plugins"
215
+ found: list[tuple[str, str, Path]] = []
216
+
217
+ try:
218
+ registry = json.loads((plugins_dir / "installed_plugins.json").read_text())
219
+ except (OSError, ValueError):
220
+ registry = None
221
+ entries = registry.get("plugins") if isinstance(registry, dict) else None
222
+ if isinstance(entries, dict):
223
+ for key, installs in entries.items():
224
+ name, _, marketplace = str(key).partition("@")
225
+ if name != "fruxon":
226
+ continue
227
+ for install in installs if isinstance(installs, list) else [installs]:
228
+ if not isinstance(install, dict):
229
+ continue
230
+ path = Path(str(install.get("installPath") or ""))
231
+ version = install.get("version")
232
+ if not isinstance(version, str) or _version_tuple(version) is None:
233
+ version = _plugin_manifest_version(path)
234
+ if version:
235
+ found.append((version, marketplace or "?", path))
236
+
237
+ if not found:
238
+ cache = plugins_dir / "cache"
239
+ try:
240
+ for path in cache.glob("*/fruxon/*"):
241
+ if path.is_dir():
242
+ version = _plugin_manifest_version(path) or path.name
243
+ if _version_tuple(version) is not None:
244
+ found.append((version, path.parent.parent.name, path))
245
+ except OSError:
246
+ pass
247
+
248
+ if not found:
249
+ return None
250
+ return max(found, key=lambda f: _version_tuple(f[0]) or ())
251
+
252
+
253
+ def check_claude_plugin() -> CheckResult:
254
+ """Compare the installed fruxon Claude Code plugin with this CLI.
255
+
256
+ The plugin ships the same skills the CLI bundles (``fruxon guides``) and is
257
+ re-released from each CLI version, so its version tracks the CLI's. A
258
+ plugin from an older CLI teaches commands that no longer exist. Not having
259
+ the plugin is fine — the row is informational then.
260
+ """
261
+ from fruxon.ui import get_version
262
+
263
+ title = "Claude Code plugin"
264
+ plugin = find_claude_plugin()
265
+ if plugin is None:
266
+ return CheckResult(title, "ok", "not installed (optional)")
267
+
268
+ plugin_version, marketplace, _path = plugin
269
+ cli_version = get_version()
270
+ plugin_ref = f"fruxon@{marketplace}"
271
+ detail = f"v{plugin_version} ({plugin_ref})"
272
+ cli_tuple = _version_tuple(cli_version)
273
+ if cli_tuple is None or any(mark in cli_version for mark in ("-dev", ".dev", "+")):
274
+ return CheckResult(title, "ok", detail, hint="CLI runs from source — version not compared.")
275
+
276
+ plugin_tuple = _version_tuple(plugin_version) or ()
277
+ if plugin_tuple == cli_tuple:
278
+ return CheckResult(title, "ok", detail)
279
+ if plugin_tuple < cli_tuple:
280
+ return CheckResult(
281
+ title,
282
+ "warn",
283
+ f"v{plugin_version} is older than the CLI (v{cli_version}) — its skills may teach removed commands",
284
+ hint=(
285
+ f"Update it: `claude plugin marketplace update {marketplace}` then "
286
+ f"`claude plugin update {plugin_ref}`, and restart Claude Code. "
287
+ "`fruxon guides show <name>` always matches this CLI."
288
+ ),
289
+ )
290
+ return CheckResult(
291
+ title,
292
+ "warn",
293
+ f"v{plugin_version} is newer than the CLI (v{cli_version}) — its skills may use commands this CLI lacks",
294
+ hint="Upgrade the CLI with `pip install -U fruxon`.",
295
+ )
296
+
297
+
173
298
  def check_credentials_file() -> CheckResult:
174
299
  """Verify the credentials file exists and is readable."""
175
300
  path = credentials.credentials_path()
@@ -365,6 +490,7 @@ def run_checks(*, skip_network: bool = False) -> list[CheckResult]:
365
490
  check_workspace(),
366
491
  check_base_url(),
367
492
  check_shell_completion(),
493
+ check_claude_plugin(),
368
494
  ]
369
495
  if not skip_network:
370
496
  checks.append(check_connectivity())
@@ -1627,6 +1627,7 @@ class FruxonClient:
1627
1627
  subject: str | None = None,
1628
1628
  query: str | None = None,
1629
1629
  scope: str | None = None,
1630
+ realm: str | None = None,
1630
1631
  all_pages: bool = True,
1631
1632
  ) -> list[Memory]:
1632
1633
  """List what an agent remembers, narrowing server-side.
@@ -1641,7 +1642,9 @@ class FruxonClient:
1641
1642
  them;
1642
1643
  * ``query`` — full-text over title/content;
1643
1644
  * ``scope`` — ``AGENT`` (cross-everyone facts) or ``SUBJECT``
1644
- (per-person facts).
1645
+ (per-person facts);
1646
+ * ``realm`` — ``LIVE`` (the server default: what real runs wrote) or
1647
+ ``SANDBOX`` (what memory-persisting sandbox sessions wrote).
1645
1648
 
1646
1649
  Each item maps to the narrow :class:`Memory` view.
1647
1650
  """
@@ -1653,6 +1656,8 @@ class FruxonClient:
1653
1656
  params.append(("query", query))
1654
1657
  if scope:
1655
1658
  params.append(("scope", scope))
1659
+ if realm:
1660
+ params.append(("realm", realm))
1656
1661
  items = (
1657
1662
  self._fetch_all_pages(base_url, params)
1658
1663
  if all_pages
@@ -1667,17 +1672,32 @@ class FruxonClient:
1667
1672
  """
1668
1673
  return _parse_memory(self._get_json(self._memories_url(agent, f"/{memory}")))
1669
1674
 
1670
- def list_memory_subjects(self, agent: str) -> dict:
1675
+ def list_memory_subjects(self, agent: str, *, realm: str | None = None) -> dict:
1671
1676
  """List the subjects an agent has memories about, with counts.
1672
1677
 
1673
1678
  Hits ``GET .../memories/subjects`` → the raw ``MemorySubjectsResponse``
1674
1679
  (``subjects`` = ``[{subject, count, displayName}]`` plus the
1675
1680
  ``sharedCount`` / ``perPersonCount`` / ``peopleCount`` aggregates).
1676
1681
  The discovery step before a subject-scoped query or a forget.
1682
+ ``realm`` is ``LIVE`` (server default) or ``SANDBOX``.
1677
1683
  """
1678
- raw = self._get_json(self._memories_url(agent, "/subjects"))
1684
+ url = self._memories_url(agent, "/subjects")
1685
+ if realm:
1686
+ url = f"{url}?{urllib.parse.urlencode({'realm': realm})}"
1687
+ raw = self._get_json(url)
1679
1688
  return raw if isinstance(raw, dict) else {"subjects": []}
1680
1689
 
1690
+ def reset_sandbox_memories(self, agent: str) -> dict:
1691
+ """Delete every memory in an agent's ``SANDBOX`` realm.
1692
+
1693
+ Hits ``POST .../memories:resetSandbox`` → ``{"deletedCount": N}``.
1694
+ Only the sandbox realm — what memory-persisting sandbox sessions
1695
+ (:meth:`open_sandbox_session` with ``persist_memory=True``) wrote —
1696
+ is touched; live memories are never deleted. Needs the Editor role
1697
+ and the ``agents:test`` scope.
1698
+ """
1699
+ return self._post_json(self._memories_url(agent, ":resetSandbox"), {})
1700
+
1681
1701
  def forget_subject(self, agent: str, subject: str) -> dict:
1682
1702
  """Forget every memory an agent holds about one subject (GDPR-style).
1683
1703
 
@@ -8287,7 +8307,7 @@ class FruxonClient:
8287
8307
 
8288
8308
  # ------------------------------------------------------- fruxon sandbox sessions
8289
8309
 
8290
- def open_sandbox_session(self, agent: str) -> dict:
8310
+ def open_sandbox_session(self, agent: str, *, persist_memory: bool = False) -> dict:
8291
8311
  """Open a sandbox debug session against an agent.
8292
8312
 
8293
8313
  Hits ``POST /v1/tenants/{tenant}/fruxon/sessions`` with
@@ -8296,8 +8316,18 @@ class FruxonClient:
8296
8316
  an agent network can be exercised end-to-end (turns, trigger fires,
8297
8317
  consults, approvals) without messaging anyone for real. Returns
8298
8318
  ``{sessionId, agentId, deliveryMode, status}``.
8319
+
8320
+ By default a sandbox session has no memory: recall is suppressed and
8321
+ memory writes are discarded. ``persist_memory=True`` sends
8322
+ ``persistMemory: true`` — the session reads and writes real memory in
8323
+ a separate ``SANDBOX`` realm, recalled by later sandbox sessions that
8324
+ also persist memory and never visible to live runs. Clear that realm
8325
+ with :meth:`reset_sandbox_memories`.
8299
8326
  """
8300
- return self._post_json(self._fruxon_session_url(), {"agentId": agent, "deliveryMode": "SANDBOX"})
8327
+ body: dict[str, object] = {"agentId": agent, "deliveryMode": "SANDBOX"}
8328
+ if persist_memory:
8329
+ body["persistMemory"] = True
8330
+ return self._post_json(self._fruxon_session_url(), body)
8301
8331
 
8302
8332
  def close_sandbox_session(self, session: str) -> dict:
8303
8333
  """Close a sandbox session. Hits ``POST .../fruxon/sessions/{session}:close``."""
@@ -9477,6 +9507,7 @@ def _parse_memory(data: object) -> Memory:
9477
9507
  tags=[t for t in tags if isinstance(t, str)] if isinstance(tags, list) else [],
9478
9508
  created_at=int(data.get("createdAt") or 0),
9479
9509
  modified_at=int(data.get("modifiedAt") or 0),
9510
+ realm=str(data.get("realm") or ""),
9480
9511
  )
9481
9512
 
9482
9513
 
@@ -496,6 +496,7 @@ class Memory:
496
496
  tags: list[str]
497
497
  created_at: int = 0 # epoch ms
498
498
  modified_at: int = 0 # epoch ms
499
+ realm: str = "" # LIVE | SANDBOX (SANDBOX = written by a memory-persisting sandbox session)
499
500
 
500
501
 
501
502
  @dataclass(frozen=True)
@@ -133,6 +133,7 @@ the bypass flag.
133
133
  | `agents draft evaluate` (no --yes) | Pass `--yes` — it costs real money |
134
134
  | `agents approvals respond` / `cancel` (no --yes) | Pass `--yes` — **but stop first.** This responds to a *human-in-the-loop* gate; a response can run the gated tool. Only auto-`--yes` if the human you're acting for explicitly told you to approve/reject this request. Defaulting to approve defeats the gate. |
135
135
  | `agents memory forget-subject` (no --yes) | Pass `--yes` — it irreversibly deletes a subject's memories (GDPR forget). |
136
+ | `agents memory reset-sandbox` (no --yes) | Pass `--yes` — it deletes the agent's sandbox-realm memories (live ones are kept). |
136
137
  | `triggers fire` (no --yes) | Pass `--yes` — it runs the bound agent(s) now (cost + side effects). |
137
138
  | `triggers ledger walk` (no --yes) | Pass `--yes` — every step is a paid model run on the agent's test budget (up to `--max-steps`, default 10). It writes nothing; read `stopped.code` in the JSON, since it exits 0 whenever it ran. |
138
139
  | `triggers delete` / `unbind` (no --yes) | Pass `--yes` — removes the trigger / its agent wiring. |