fruxon 2.3.0__tar.gz → 2.3.1__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.1}/HISTORY.md +14 -0
  2. {fruxon-2.3.0 → fruxon-2.3.1}/PKG-INFO +3 -3
  3. {fruxon-2.3.0 → fruxon-2.3.1}/README.md +2 -2
  4. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/_version.py +2 -2
  5. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_memory.py +86 -4
  6. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_sandbox.py +25 -1
  7. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/examples.py +2 -0
  8. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/fruxon.py +36 -5
  9. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/models.py +1 -0
  10. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/fruxon-agent-mode/SKILL.md +1 -0
  11. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/fruxon-build-agent/SKILL.md +10 -0
  12. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/fruxon-meet/SKILL.md +1 -0
  13. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_agents_sandbox.py +27 -1
  14. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_memory.py +99 -3
  15. {fruxon-2.3.0 → fruxon-2.3.1}/.gitignore +0 -0
  16. {fruxon-2.3.0 → fruxon-2.3.1}/LICENSE +0 -0
  17. {fruxon-2.3.0 → fruxon-2.3.1}/pyproject.toml +0 -0
  18. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/__init__.py +0 -0
  19. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/__main__.py +0 -0
  20. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/_request_id.py +0 -0
  21. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/_ssl.py +0 -0
  22. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/checks/__init__.py +0 -0
  23. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/checks/agent.py +0 -0
  24. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/checks/ledger.py +0 -0
  25. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/checks/references.py +0 -0
  26. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/__init__.py +0 -0
  27. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_crash.py +0 -0
  28. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_last_failure.py +0 -0
  29. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_ledger_passes.py +0 -0
  30. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_plugin_hint.py +0 -0
  31. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_schema.py +0 -0
  32. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_shared.py +0 -0
  33. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/_stream.py +0 -0
  34. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/access_requests.py +0 -0
  35. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents.py +0 -0
  36. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_approvals.py +0 -0
  37. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_budget.py +0 -0
  38. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_channels.py +0 -0
  39. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_draft.py +0 -0
  40. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_evaluations.py +0 -0
  41. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_executions.py +0 -0
  42. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_improvements.py +0 -0
  43. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_lifecycle.py +0 -0
  44. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_reply_style.py +0 -0
  45. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_revisions.py +0 -0
  46. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_sandbox_test.py +0 -0
  47. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_slots.py +0 -0
  48. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_system_blocks.py +0 -0
  49. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_tests.py +0 -0
  50. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_topics.py +0 -0
  51. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/agents_voice_calls.py +0 -0
  52. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/applications.py +0 -0
  53. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/applications_entry_points.py +0 -0
  54. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/assets.py +0 -0
  55. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/auth.py +0 -0
  56. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/capabilities.py +0 -0
  57. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/completion.py +0 -0
  58. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/config.py +0 -0
  59. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/consult_pins.py +0 -0
  60. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/conversation_imports.py +0 -0
  61. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/dash.py +0 -0
  62. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/describe.py +0 -0
  63. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/doctor.py +0 -0
  64. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/environments.py +0 -0
  65. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/escalation_desks.py +0 -0
  66. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/escalation_operators.py +0 -0
  67. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/escalations.py +0 -0
  68. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/feedback.py +0 -0
  69. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/guides.py +0 -0
  70. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/integrations.py +0 -0
  71. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/integrations_sandbox.py +0 -0
  72. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/integrations_webhooks.py +0 -0
  73. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/keys.py +0 -0
  74. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/knowledge_bases.py +0 -0
  75. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/knowledge_documents.py +0 -0
  76. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/knowledge_notices.py +0 -0
  77. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/knowledge_sources.py +0 -0
  78. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/llm_providers.py +0 -0
  79. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/messages.py +0 -0
  80. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/metrics.py +0 -0
  81. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/participants.py +0 -0
  82. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/secrets.py +0 -0
  83. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/skills.py +0 -0
  84. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/storage.py +0 -0
  85. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/tools.py +0 -0
  86. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers.py +0 -0
  87. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers_budget.py +0 -0
  88. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers_check.py +0 -0
  89. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers_ledger.py +0 -0
  90. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers_ledger_stage_tests.py +0 -0
  91. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers_questions.py +0 -0
  92. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/triggers_shape.py +0 -0
  93. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/working_hours.py +0 -0
  94. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/cli/workspaces.py +0 -0
  95. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/credentials.py +0 -0
  96. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/device_auth.py +0 -0
  97. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/doctor.py +0 -0
  98. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/exceptions.py +0 -0
  99. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/flow_validation.py +0 -0
  100. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/output.py +0 -0
  101. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/params.py +0 -0
  102. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/sandbox_scenario.py +0 -0
  103. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/__init__.py +0 -0
  104. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/fruxon-create-integration/SKILL.md +0 -0
  105. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/fruxon-debug-trace/SKILL.md +0 -0
  106. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/skills/fruxon-use-integrations/SKILL.md +0 -0
  107. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/telemetry.py +0 -0
  108. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/__init__.py +0 -0
  109. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/app.py +0 -0
  110. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/demo.py +0 -0
  111. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/links.py +0 -0
  112. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/__init__.py +0 -0
  113. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/agent.py +0 -0
  114. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/base.py +0 -0
  115. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/home.py +0 -0
  116. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/ledger.py +0 -0
  117. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/loader.py +0 -0
  118. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/pickers.py +0 -0
  119. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/screens/trace.py +0 -0
  120. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/source.py +0 -0
  121. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/theme.py +0 -0
  122. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/views.py +0 -0
  123. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/tui/widgets.py +0 -0
  124. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/ui.py +0 -0
  125. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/update_check.py +0 -0
  126. {fruxon-2.3.0 → fruxon-2.3.1}/src/fruxon/validation.py +0 -0
  127. {fruxon-2.3.0 → fruxon-2.3.1}/tests/.test_durations.json +0 -0
  128. {fruxon-2.3.0 → fruxon-2.3.1}/tests/__init__.py +0 -0
  129. {fruxon-2.3.0 → fruxon-2.3.1}/tests/conftest.py +0 -0
  130. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_actor.py +0 -0
  131. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_agent_lifecycle.py +0 -0
  132. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_agent_revisions_list.py +0 -0
  133. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_agent_slots.py +0 -0
  134. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_agents_check_cli.py +0 -0
  135. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_agents_revisions_cli.py +0 -0
  136. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_applications.py +0 -0
  137. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_approvals.py +0 -0
  138. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_assets.py +0 -0
  139. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_budgets.py +0 -0
  140. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_capabilities.py +0 -0
  141. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_channels.py +0 -0
  142. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_checks_agent.py +0 -0
  143. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_checks_ledger.py +0 -0
  144. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli.py +0 -0
  145. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli_base_url_routing.py +0 -0
  146. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli_crash.py +0 -0
  147. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli_feedback.py +0 -0
  148. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli_friction_round2.py +0 -0
  149. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli_friction_round3.py +0 -0
  150. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_cli_root_flags.py +0 -0
  151. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_client.py +0 -0
  152. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_connect_nudge.py +0 -0
  153. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_consult.py +0 -0
  154. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_conversation_imports.py +0 -0
  155. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_credentials.py +0 -0
  156. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_dash_app.py +0 -0
  157. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_dash_cli.py +0 -0
  158. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_dash_client.py +0 -0
  159. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_dash_links.py +0 -0
  160. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_dash_source.py +0 -0
  161. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_describe.py +0 -0
  162. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_device_auth.py +0 -0
  163. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_docs_commands_exist.py +0 -0
  164. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_doctor.py +0 -0
  165. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_draft_bootstrap.py +0 -0
  166. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_draft_evaluate_cli.py +0 -0
  167. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_draft_pull_shape.py +0 -0
  168. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_draft_run_replay.py +0 -0
  169. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_draft_validate_cli.py +0 -0
  170. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_drafts.py +0 -0
  171. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_entry_points.py +0 -0
  172. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_environments.py +0 -0
  173. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_escalation_operators.py +0 -0
  174. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_escalations.py +0 -0
  175. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_evaluations.py +0 -0
  176. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_execution_records.py +0 -0
  177. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_flow_validation.py +0 -0
  178. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_fruxon.py +0 -0
  179. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_guides.py +0 -0
  180. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_improvements.py +0 -0
  181. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_integration_configs_write_cli.py +0 -0
  182. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_integration_sandbox_cli.py +0 -0
  183. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_integration_triggers_cli.py +0 -0
  184. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_integrations_authorize_cli.py +0 -0
  185. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_integrations_connect_cli.py +0 -0
  186. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_kb_trial_cli.py +0 -0
  187. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_knowledge_bases.py +0 -0
  188. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_knowledge_documents.py +0 -0
  189. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_knowledge_notices.py +0 -0
  190. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_knowledge_sources.py +0 -0
  191. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_llm_provider_configs_cli.py +0 -0
  192. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_llm_providers_connect_cli.py +0 -0
  193. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_llm_providers_list_cli.py +0 -0
  194. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_managed_by.py +0 -0
  195. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_messages.py +0 -0
  196. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_metrics.py +0 -0
  197. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_online_llm_config_refs.py +0 -0
  198. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_online_prefetch_refs.py +0 -0
  199. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_online_secret_refs.py +0 -0
  200. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_output.py +0 -0
  201. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_params.py +0 -0
  202. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_participants.py +0 -0
  203. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_participants_write.py +0 -0
  204. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_plugin_hint.py +0 -0
  205. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_project_urls.py +0 -0
  206. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_reply_style.py +0 -0
  207. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_request_id.py +0 -0
  208. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_sandbox_scenario.py +0 -0
  209. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_schema.py +0 -0
  210. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_schema_fetch.py +0 -0
  211. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_secrets.py +0 -0
  212. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_skills.py +0 -0
  213. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_ssl.py +0 -0
  214. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_storage.py +0 -0
  215. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_system_blocks.py +0 -0
  216. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_system_blocks_cli.py +0 -0
  217. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_telemetry.py +0 -0
  218. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_test_chats.py +0 -0
  219. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_topics.py +0 -0
  220. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_trigger_budgets.py +0 -0
  221. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers.py +0 -0
  222. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_check_cli.py +0 -0
  223. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_ledger.py +0 -0
  224. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_ledger_batch_views.py +0 -0
  225. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_ledger_stage_tests.py +0 -0
  226. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_questions.py +0 -0
  227. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_shape.py +0 -0
  228. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_triggers_write.py +0 -0
  229. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_tui_boundary.py +0 -0
  230. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_ui.py +0 -0
  231. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_update_check.py +0 -0
  232. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_validation.py +0 -0
  233. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_voice_calls.py +0 -0
  234. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_working_hours_cli.py +0 -0
  235. {fruxon-2.3.0 → fruxon-2.3.1}/tests/test_workspaces_cli.py +0 -0
@@ -1,5 +1,19 @@
1
1
  # History
2
2
 
3
+ ## Unreleased — testing memory in the sandbox
4
+
5
+ - **`fruxon agents sandbox open <agent> --keep-memory`** (F-019): the session gets real memory in a separate
6
+ sandbox realm — it recalls what earlier `--keep-memory` sessions stored, and live runs never see it.
7
+ Without the flag nothing changes: a sandbox session recalls nothing and its memory writes are discarded.
8
+ The text output says when memory persists. `FruxonClient.open_sandbox_session(agent, persist_memory=True)`
9
+ sends `persistMemory: true` (omitted otherwise).
10
+ - **`fruxon agents memory reset-sandbox <agent>`** deletes the sandbox realm only and prints `deletedCount`;
11
+ confirms, and refuses without `--yes` in agent mode (EXIT 16). Needs the Editor role and `agents:test`.
12
+ **`FruxonClient.reset_sandbox_memories`**.
13
+ - **`--realm LIVE|SANDBOX`** on `agents memory list` and `agents memory subjects` (default: the server's,
14
+ `LIVE`). `list_memories(realm=…)`, `list_memory_subjects(realm=…)`; `Memory.realm`, and `realm` in the
15
+ JSON of `list` / `get`.
16
+
3
17
  ## Unreleased — taking a Telegram channel live from the CLI
4
18
 
5
19
  - **`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.1
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.1'
22
+ __version_tuple__ = version_tuple = (2, 3, 1)
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")
@@ -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)"),
@@ -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. |
@@ -296,6 +296,16 @@ it from your app via the SDK (`FruxonClient.stream` / `execute`).
296
296
  > min_score}` for an opt-in **semantic** check that scores the reply against a
297
297
  > tenant eval metric (by id / key / name). See `fruxon examples sandbox`.
298
298
  >
299
+ > **Testing memory across sessions?** A sandbox session has no memory by
300
+ > default — nothing is recalled, writes are discarded. Open each session with
301
+ > `fruxon agents sandbox open <agent> --keep-memory`: it gets real memory in a
302
+ > separate sandbox realm that later `--keep-memory` sessions recall and live
303
+ > runs never see. Tell session A a fact and `close` it; open session B with
304
+ > `--keep-memory` and ask — the agent should recall. A session opened without
305
+ > the flag should not (your control). `fruxon agents memory list <agent>
306
+ > --realm SANDBOX` shows what was stored; `fruxon agents memory reset-sandbox
307
+ > <agent> --yes` gives the next test a clean slate.
308
+ >
299
309
  > **Fixing a reply a real customer got?** Don't retype the conversation:
300
310
  > `fruxon agents sandbox fork <agent> <message-id> --send --draft --wait` copies
301
311
  > the history the agent had at that turn into a sandbox session, re-sends the
@@ -61,6 +61,7 @@ fruxon agents approvals list <agent> # pending human-in-the-loop approvals a r
61
61
  fruxon agents approvals respond <agent> <id> --approve|--reject # answer the gate (needs --yes in agent mode)
62
62
  fruxon agents memory list <agent> --subject <s> # what the agent remembers (filter by subject/search/scope)
63
63
  fruxon agents memory forget-subject <agent> <s> # GDPR-forget a subject (needs --yes in agent mode)
64
+ fruxon agents memory reset-sandbox <agent> --yes # wipe what --keep-memory sandbox sessions stored
64
65
  fruxon agents sandbox open/turn/fire/stream/answer/close # drive a network sandbox e2e (captures+blocks real sends)
65
66
  fruxon agents sandbox fork <agent> <message-id> --send --draft --wait # replay a real bad reply against your draft, same history
66
67
  fruxon agents sandbox test <file|dir> # run scenario e2e tests of an agent (exit 0 pass / 1 fail; --junit)
@@ -43,6 +43,13 @@ def test_open_posts_sandbox_body(client, monkeypatch):
43
43
  assert out["sessionId"] == "s1"
44
44
 
45
45
 
46
+ def test_open_keep_memory_sends_persist_memory(client, monkeypatch):
47
+ cap = {}
48
+ monkeypatch.setattr(client, "_post_json", lambda url, body: cap.update(body=body) or {"sessionId": "s1"})
49
+ client.open_sandbox_session("my-agent", persist_memory=True)
50
+ assert cap["body"] == {"agentId": "my-agent", "deliveryMode": "SANDBOX", "persistMemory": True}
51
+
52
+
46
53
  def test_close_posts_close_verb(client, monkeypatch):
47
54
  cap = {}
48
55
  monkeypatch.setattr(client, "_post_json", lambda url, body: cap.update(url=url, body=body) or {})
@@ -154,8 +161,9 @@ class _Stub:
154
161
  def __init__(self):
155
162
  self.calls = {}
156
163
 
157
- def open_sandbox_session(self, agent):
164
+ def open_sandbox_session(self, agent, *, persist_memory=False):
158
165
  self.calls["open"] = agent
166
+ self.calls["persist_memory"] = persist_memory
159
167
  return {"sessionId": "s1", "agentId": agent, "status": "OPEN"}
160
168
 
161
169
  def close_sandbox_session(self, session):
@@ -260,6 +268,24 @@ def test_open_output_id_prints_session_id(monkeypatch):
260
268
  assert stub.calls["open"] == "my-agent"
261
269
 
262
270
 
271
+ def test_open_without_keep_memory_does_not_persist(monkeypatch):
272
+ stub = _Stub()
273
+ _patch(monkeypatch, stub)
274
+ result = runner.invoke(app, ["agents", "sandbox", "open", "my-agent", "-o", "json"])
275
+ assert result.exit_code == 0, result.output
276
+ assert stub.calls["persist_memory"] is False
277
+
278
+
279
+ def test_open_keep_memory_forwards_and_says_so(monkeypatch):
280
+ stub = _Stub()
281
+ _patch(monkeypatch, stub, agent_mode=False)
282
+ result = runner.invoke(app, ["agents", "sandbox", "open", "my-agent", "--keep-memory", "-o", "text"])
283
+ assert result.exit_code == 0, result.output
284
+ assert stub.calls["persist_memory"] is True
285
+ assert "Memory persists" in result.output
286
+ assert "reset-sandbox my-agent" in result.output
287
+
288
+
263
289
  def test_turn_await_maps_force_await(monkeypatch):
264
290
  stub = _Stub()
265
291
  _patch(monkeypatch, stub)