fruxon 2.2.8__tar.gz → 2.2.10__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 (234) hide show
  1. {fruxon-2.2.8 → fruxon-2.2.10}/HISTORY.md +52 -0
  2. {fruxon-2.2.8 → fruxon-2.2.10}/PKG-INFO +4 -2
  3. {fruxon-2.2.8 → fruxon-2.2.10}/README.md +3 -1
  4. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/_version.py +2 -2
  5. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/agent.py +17 -2
  6. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/__init__.py +2 -0
  7. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_reply_style.py +61 -4
  8. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_revisions.py +35 -2
  9. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/assets.py +110 -0
  10. fruxon-2.2.10/src/fruxon/cli/escalation_desks.py +394 -0
  11. fruxon-2.2.10/src/fruxon/cli/escalation_operators.py +277 -0
  12. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/escalations.py +34 -3
  13. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/examples.py +4 -0
  14. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/integrations_sandbox.py +57 -1
  15. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/working_hours.py +3 -3
  16. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/fruxon.py +150 -1
  17. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-build-agent/SKILL.md +9 -3
  18. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-meet/SKILL.md +3 -0
  19. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agents_check_cli.py +1 -1
  20. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_assets.py +109 -0
  21. fruxon-2.2.10/tests/test_cli_friction_round2.py +320 -0
  22. fruxon-2.2.10/tests/test_escalation_operators.py +274 -0
  23. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integration_sandbox_cli.py +52 -1
  24. {fruxon-2.2.8 → fruxon-2.2.10}/.gitignore +0 -0
  25. {fruxon-2.2.8 → fruxon-2.2.10}/LICENSE +0 -0
  26. {fruxon-2.2.8 → fruxon-2.2.10}/pyproject.toml +0 -0
  27. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/__init__.py +0 -0
  28. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/__main__.py +0 -0
  29. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/_request_id.py +0 -0
  30. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/_ssl.py +0 -0
  31. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/__init__.py +0 -0
  32. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/ledger.py +0 -0
  33. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/references.py +0 -0
  34. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_crash.py +0 -0
  35. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_last_failure.py +0 -0
  36. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_ledger_passes.py +0 -0
  37. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_plugin_hint.py +0 -0
  38. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_schema.py +0 -0
  39. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_shared.py +0 -0
  40. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_stream.py +0 -0
  41. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents.py +0 -0
  42. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_approvals.py +0 -0
  43. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_budget.py +0 -0
  44. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_channels.py +0 -0
  45. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_draft.py +0 -0
  46. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_evaluations.py +0 -0
  47. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_executions.py +0 -0
  48. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_improvements.py +0 -0
  49. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_lifecycle.py +0 -0
  50. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_memory.py +0 -0
  51. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_sandbox.py +0 -0
  52. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_sandbox_test.py +0 -0
  53. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_slots.py +0 -0
  54. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_system_blocks.py +0 -0
  55. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_tests.py +0 -0
  56. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_topics.py +0 -0
  57. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_voice_calls.py +0 -0
  58. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/applications.py +0 -0
  59. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/applications_entry_points.py +0 -0
  60. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/auth.py +0 -0
  61. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/capabilities.py +0 -0
  62. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/completion.py +0 -0
  63. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/config.py +0 -0
  64. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/consult_pins.py +0 -0
  65. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/conversation_imports.py +0 -0
  66. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/dash.py +0 -0
  67. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/describe.py +0 -0
  68. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/doctor.py +0 -0
  69. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/environments.py +0 -0
  70. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/feedback.py +0 -0
  71. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/guides.py +0 -0
  72. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/integrations.py +0 -0
  73. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/keys.py +0 -0
  74. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_bases.py +0 -0
  75. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_documents.py +0 -0
  76. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_notices.py +0 -0
  77. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_sources.py +0 -0
  78. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/llm_providers.py +0 -0
  79. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/messages.py +0 -0
  80. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/metrics.py +0 -0
  81. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/participants.py +0 -0
  82. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/pipelines.py +0 -0
  83. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/secrets.py +0 -0
  84. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/skills.py +0 -0
  85. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/storage.py +0 -0
  86. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/tools.py +0 -0
  87. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers.py +0 -0
  88. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_budget.py +0 -0
  89. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_check.py +0 -0
  90. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_ledger.py +0 -0
  91. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_ledger_stage_tests.py +0 -0
  92. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_questions.py +0 -0
  93. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_shape.py +0 -0
  94. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/workspaces.py +0 -0
  95. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/credentials.py +0 -0
  96. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/device_auth.py +0 -0
  97. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/doctor.py +0 -0
  98. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/exceptions.py +0 -0
  99. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/flow_validation.py +0 -0
  100. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/models.py +0 -0
  101. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/output.py +0 -0
  102. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/params.py +0 -0
  103. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/sandbox_scenario.py +0 -0
  104. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/__init__.py +0 -0
  105. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-agent-mode/SKILL.md +0 -0
  106. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-create-integration/SKILL.md +0 -0
  107. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-debug-trace/SKILL.md +0 -0
  108. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-use-integrations/SKILL.md +0 -0
  109. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/telemetry.py +0 -0
  110. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/__init__.py +0 -0
  111. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/app.py +0 -0
  112. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/demo.py +0 -0
  113. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/links.py +0 -0
  114. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/__init__.py +0 -0
  115. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/agent.py +0 -0
  116. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/base.py +0 -0
  117. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/home.py +0 -0
  118. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/ledger.py +0 -0
  119. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/loader.py +0 -0
  120. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/pickers.py +0 -0
  121. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/trace.py +0 -0
  122. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/source.py +0 -0
  123. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/theme.py +0 -0
  124. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/views.py +0 -0
  125. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/widgets.py +0 -0
  126. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/ui.py +0 -0
  127. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/update_check.py +0 -0
  128. {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/validation.py +0 -0
  129. {fruxon-2.2.8 → fruxon-2.2.10}/tests/.test_durations.json +0 -0
  130. {fruxon-2.2.8 → fruxon-2.2.10}/tests/__init__.py +0 -0
  131. {fruxon-2.2.8 → fruxon-2.2.10}/tests/conftest.py +0 -0
  132. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_actor.py +0 -0
  133. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agent_lifecycle.py +0 -0
  134. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agent_revisions_list.py +0 -0
  135. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agent_slots.py +0 -0
  136. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agents_revisions_cli.py +0 -0
  137. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agents_sandbox.py +0 -0
  138. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_applications.py +0 -0
  139. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_approvals.py +0 -0
  140. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_budgets.py +0 -0
  141. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_capabilities.py +0 -0
  142. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_channels.py +0 -0
  143. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_checks_agent.py +0 -0
  144. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_checks_ledger.py +0 -0
  145. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli.py +0 -0
  146. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_base_url_routing.py +0 -0
  147. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_crash.py +0 -0
  148. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_feedback.py +0 -0
  149. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_root_flags.py +0 -0
  150. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_client.py +0 -0
  151. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_connect_nudge.py +0 -0
  152. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_consult.py +0 -0
  153. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_conversation_imports.py +0 -0
  154. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_credentials.py +0 -0
  155. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_app.py +0 -0
  156. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_cli.py +0 -0
  157. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_client.py +0 -0
  158. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_links.py +0 -0
  159. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_source.py +0 -0
  160. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_describe.py +0 -0
  161. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_device_auth.py +0 -0
  162. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_docs_commands_exist.py +0 -0
  163. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_doctor.py +0 -0
  164. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_bootstrap.py +0 -0
  165. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_evaluate_cli.py +0 -0
  166. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_pull_shape.py +0 -0
  167. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_run_replay.py +0 -0
  168. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_validate_cli.py +0 -0
  169. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_drafts.py +0 -0
  170. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_entry_points.py +0 -0
  171. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_environments.py +0 -0
  172. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_escalations.py +0 -0
  173. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_evaluations.py +0 -0
  174. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_execution_records.py +0 -0
  175. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_flow_validation.py +0 -0
  176. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_fruxon.py +0 -0
  177. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_guides.py +0 -0
  178. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_improvements.py +0 -0
  179. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integration_configs_write_cli.py +0 -0
  180. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integration_triggers_cli.py +0 -0
  181. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integrations_authorize_cli.py +0 -0
  182. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integrations_connect_cli.py +0 -0
  183. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_kb_trial_cli.py +0 -0
  184. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_bases.py +0 -0
  185. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_documents.py +0 -0
  186. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_notices.py +0 -0
  187. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_sources.py +0 -0
  188. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_llm_provider_configs_cli.py +0 -0
  189. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_llm_providers_connect_cli.py +0 -0
  190. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_llm_providers_list_cli.py +0 -0
  191. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_managed_by.py +0 -0
  192. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_memory.py +0 -0
  193. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_messages.py +0 -0
  194. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_metrics.py +0 -0
  195. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_online_llm_config_refs.py +0 -0
  196. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_online_prefetch_refs.py +0 -0
  197. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_online_secret_refs.py +0 -0
  198. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_output.py +0 -0
  199. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_params.py +0 -0
  200. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_participants.py +0 -0
  201. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_participants_write.py +0 -0
  202. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_pipelines.py +0 -0
  203. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_plugin_hint.py +0 -0
  204. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_project_urls.py +0 -0
  205. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_reply_style.py +0 -0
  206. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_request_id.py +0 -0
  207. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_sandbox_scenario.py +0 -0
  208. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_schema.py +0 -0
  209. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_schema_fetch.py +0 -0
  210. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_secrets.py +0 -0
  211. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_skills.py +0 -0
  212. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_ssl.py +0 -0
  213. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_storage.py +0 -0
  214. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_system_blocks.py +0 -0
  215. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_system_blocks_cli.py +0 -0
  216. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_telemetry.py +0 -0
  217. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_test_chats.py +0 -0
  218. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_topics.py +0 -0
  219. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_trigger_budgets.py +0 -0
  220. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers.py +0 -0
  221. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_check_cli.py +0 -0
  222. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_ledger.py +0 -0
  223. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_ledger_batch_views.py +0 -0
  224. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_ledger_stage_tests.py +0 -0
  225. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_questions.py +0 -0
  226. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_shape.py +0 -0
  227. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_write.py +0 -0
  228. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_tui_boundary.py +0 -0
  229. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_ui.py +0 -0
  230. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_update_check.py +0 -0
  231. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_validation.py +0 -0
  232. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_voice_calls.py +0 -0
  233. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_working_hours_cli.py +0 -0
  234. {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_workspaces_cli.py +0 -0
@@ -1,5 +1,57 @@
1
1
  # History
2
2
 
3
+ ## Unreleased — Application operators from the CLI
4
+
5
+ - **`fruxon escalations operators list|candidates|add|remove`**: make a participant an operator of an
6
+ Application, so an escalation desk can name them. `desks create --operator` and `set-policy
7
+ --operator` only accept active operators, and adding one used to need the dashboard (Application →
8
+ People). `candidates [--search …] [--limit …]` shows the server's verdict per person: `ELIGIBLE`,
9
+ `PROMOTABLE` (not yet classified — `add` marks them internal) or `INELIGIBLE` with a reason. `add`
10
+ is idempotent and re-activates a disabled operator; a customer is a 400 (EXIT 12) whose hint names
11
+ `candidates`. `remove` confirms and needs `--yes` in agent mode (EXIT 16). `--agent` / `--application`
12
+ resolve the Application as `desks` does. **`FruxonClient.list_application_operators`**,
13
+ **`get_application_operator`**, **`list_application_operator_candidates`**,
14
+ **`add_application_operator`**, **`remove_application_operator`**.
15
+ - **`desks create` / `set-policy`** refused with "Operators […] are not active operators of network …"
16
+ now hint the exact `fruxon escalations operators add <ids> --application <id>` command.
17
+
18
+ ## Unreleased — replace an uploaded file asset's contents
19
+
20
+ - **`fruxon assets replace-file <asset> --file <path>`** gives an uploaded-file asset new contents
21
+ under the same id, so agents, step scopes and prompts that use it read the new file. `--wait`
22
+ blocks on the re-index (`--timeout`, default 300 s); search answers from the previous file until it
23
+ finishes and keeps it if the new file can't be indexed. Confirms, and refuses without `--yes` in
24
+ agent mode (EXIT 16): the previous file is no longer offered for download. `-o json` returns the
25
+ server's `{asset, longOperation}` plus `reindexing` and `waited`; `-o id` prints the asset id. A 409
26
+ (indexing running) names `fruxon assets wait`; a 400 names `fruxon assets supported-types`.
27
+ **`FruxonClient.replace_asset_file(asset, path)`** (`POST /assets/{asset}:replaceFile`). Needs the
28
+ backend's endpoint (fruxon-backend #1846).
29
+
30
+ ## Unreleased — escalation desks, reply-style schema, deploy output
31
+
32
+ - **`fruxon escalations desks list|create|attach|detach`**: an Application with no escalation desk
33
+ can get one from the CLI. `create --name … [--mode BRIDGE|NATIVE_HANDOFF] [--operator …]
34
+ [--strategy …] [--working-hours …] [--default-reason …] [--attach other|<entry-point>]`;
35
+ `attach <desk> <target>…` and `detach <target>…`, where `other` is conversations that came through
36
+ no channel. `--agent` resolves the agent's Application; `--application` names one; neither uses the
37
+ workspace default. **`FruxonClient.create_escalation_desk`**,
38
+ **`set_other_conversations_escalation_desk`**, and `update_entry_point(escalation_desk=,
39
+ clear_escalation_desk=)`.
40
+ - **`escalations set-policy`** with no desk to change now names the `desks create` command instead of
41
+ the dashboard; so does the `agents check` / `draft validate --online` `escalation_unreachable` hint
42
+ when a desk is missing.
43
+ - **Command name fixed**: the `escalation_unreachable` hint and `working-hours create` said
44
+ `fruxon escalations policy set`; the command is `fruxon escalations set-policy`.
45
+ - **`agents reply-style new|edit --schema`** prints the content's JSON schema
46
+ (`AgentReplyStyleContent`), and their help shows an example.
47
+ - **`integrations configs sandbox generate --context <file|-|text>`** grounds the generated entities
48
+ in facts they must agree with (services, durations, hours — e.g. the agent's KB article), up to
49
+ 16,000 characters. `FruxonClient.generate_config_sandbox_data(..., context=)`. Needs the backend's
50
+ `context` field on `sandbox:generate`.
51
+ - **`agents revisions deploy`** takes `-o text|json` (JSON by default in agent mode:
52
+ `{"agentId", "revision", "deployed": true, "result"}`) and accepts `--yes`, which changes nothing —
53
+ deploying never prompts.
54
+
3
55
  ## Unreleased — Improvements reviews on Fruxon's reviewer model, for credits
4
56
 
5
57
  - **`fruxon agents improvements settings`** chooses where reviews run:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: fruxon
3
- Version: 2.2.8
3
+ Version: 2.2.10
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
@@ -102,6 +102,8 @@ Execution:
102
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). |
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. **`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
+ | `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
+ | `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`. |
105
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`. |
106
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. |
107
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`. |
@@ -156,7 +158,7 @@ Integrations + tools:
156
158
  | `fruxon llm-providers connect <provider>` / `link-status` | Create a config for an LLM provider and print a **credential link**: a human opens it, signs in to Fruxon, types the API key (or access keys, or service account key), and the page tests it with the provider and publishes the config an agent pins as `provider.tenantConfigId`. The key never passes through the terminal or an agent driving the CLI. `--config <id>` fills an existing config, `--param name=value` sets a non-secret setting such as Bedrock's `region`, `--no-sign-in` mints a link anyone holding it can fill (Admin or Owner). `link-status <provider> <config> <request> [--wait]` says when it was filled. |
157
159
  | `fruxon llm-providers configs list/get/test/publish` | The workspace's saved LLM credentials — the `provider.tenantConfigId` an agent pins. `get` shows the draft (secrets masked), the published revision and last known health. `test` probes the draft on every provider surface that shares the credential (or just one, given that surface's provider id), one line per failing surface, exit 12 on failure (`llm_providers:test`). `publish` ships the draft as a new revision that every agent on the config switches to — it confirms, needs `--yes` in agent mode, and does not wait on a passing test (`llm_providers:write`). |
158
160
  | `fruxon llm-providers configs complete <provider> <config> --model M` | One completion on a saved config's published revision, with no agent, session or execution — to see whether a model follows a prompt or a system block's instruction. `--system` (text, `@file`, `-`; repeatable), `-m [user:\|assistant:]TEXT` (repeatable) or `--messages chat.json`, `--temperature`, `--max-tokens` (server cap 8192), `--param k=v`. The reply goes to stdout, the model, finish reason, tokens and latency to stderr (`llm_providers:test`). Fruxon-hosted providers are refused. |
159
- | `fruxon assets create/list/get/wait/operations/delete` | Manage knowledge-base (RAG) assets an agent can query — upload local files, wait for async ingestion, inspect operations, and use the ids for `assetConfig.assetIds`. `delete` confirms + refuses without `--yes` in agent mode. |
161
+ | `fruxon assets create/list/get/wait/operations/replace-file/delete` | Manage knowledge-base (RAG) assets an agent can query — upload local files, wait for async ingestion, inspect operations, and use the ids for `assetConfig.assetIds`. `replace-file <asset> --file …` gives an uploaded-file asset new contents under the same id (`--wait` blocks on the re-index; search keeps the previous file until it finishes). `replace-file` and `delete` confirm + refuse without `--yes` in agent mode. |
160
162
  | `fruxon knowledge-bases list/get/create/update/publish/archive/delete` | The authored, reviewable corpus behind a `manual_knowledge` asset — **not** the asset itself, which is what gets searched (`get` prints the asset id as `backingAssetId`). **`publish` is the step that makes any of it findable**: only `PUBLISHED` documents travel in a snapshot, and only publishing the *base* moves one, so a base full of finished articles answers nothing until it runs. It returns on *acceptance*, not searchability — RAG ingests afterwards, so a pending publish state is normal. `list` hides archived bases, which keep answering for agents already attached to them; `delete` is refused while an agent revision still attaches one, and `archive` is the reversible path. |
161
163
  | `fruxon knowledge-bases usage <kb>` | Whether agents actually use the base: searches per hour, day or week (`--interval`), the passage tokens each search handed the agent, how many found nothing (split from searches that **could not fully search** it — index missing or still building, a phrasing failed), and which agents searched (up to 20 you can open, the rest counted together). `--origin test` counts test runs instead of production. Retrieved tokens are counted by the search index, so what the model read can be less when a large result is trimmed or offloaded. Searches are recorded from 15 October 2026 and kept 90 days at most, so a window reaching further back says where counting began rather than showing empty days. A 404 is a wrong id or a backend that predates the read. |
162
164
  | `fruxon knowledge-bases notices/notice/post-notice/edit-notice/extend-notice/withdraw-notice` | Time-boxed notices on a base — an outage being fixed, a known bug, a closure. **Not documents**: never indexed or published, so every agent attaching the base is given each active notice whole from its next turn. `post-notice --valid-for 4h` (or `--until`) — every notice ends, at most 30 days after it was posted, and a base holds ten active ones (409 `notice_limit` / `notice_too_long`, each with its remedy). The body is Markdown, at most 1,200 characters, best as four headings: *What is happening*, *Applies when*, *Tell the customer*, *Do not*. A time without an offset is read in the notice's zone (`--time-zone`, else this machine's), which is also the zone agents tell customers the end in. `withdraw-notice` tells each conversation that was given it, on its next turn, that it ended; it confirms, and needs `--yes` in agent mode. An ended notice is not extended: `post-notice --from <id>` posts it again as a new one. |
@@ -68,6 +68,8 @@ Execution:
68
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). |
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. **`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
+ | `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
+ | `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`. |
71
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`. |
72
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. |
73
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`. |
@@ -122,7 +124,7 @@ Integrations + tools:
122
124
  | `fruxon llm-providers connect <provider>` / `link-status` | Create a config for an LLM provider and print a **credential link**: a human opens it, signs in to Fruxon, types the API key (or access keys, or service account key), and the page tests it with the provider and publishes the config an agent pins as `provider.tenantConfigId`. The key never passes through the terminal or an agent driving the CLI. `--config <id>` fills an existing config, `--param name=value` sets a non-secret setting such as Bedrock's `region`, `--no-sign-in` mints a link anyone holding it can fill (Admin or Owner). `link-status <provider> <config> <request> [--wait]` says when it was filled. |
123
125
  | `fruxon llm-providers configs list/get/test/publish` | The workspace's saved LLM credentials — the `provider.tenantConfigId` an agent pins. `get` shows the draft (secrets masked), the published revision and last known health. `test` probes the draft on every provider surface that shares the credential (or just one, given that surface's provider id), one line per failing surface, exit 12 on failure (`llm_providers:test`). `publish` ships the draft as a new revision that every agent on the config switches to — it confirms, needs `--yes` in agent mode, and does not wait on a passing test (`llm_providers:write`). |
124
126
  | `fruxon llm-providers configs complete <provider> <config> --model M` | One completion on a saved config's published revision, with no agent, session or execution — to see whether a model follows a prompt or a system block's instruction. `--system` (text, `@file`, `-`; repeatable), `-m [user:\|assistant:]TEXT` (repeatable) or `--messages chat.json`, `--temperature`, `--max-tokens` (server cap 8192), `--param k=v`. The reply goes to stdout, the model, finish reason, tokens and latency to stderr (`llm_providers:test`). Fruxon-hosted providers are refused. |
125
- | `fruxon assets create/list/get/wait/operations/delete` | Manage knowledge-base (RAG) assets an agent can query — upload local files, wait for async ingestion, inspect operations, and use the ids for `assetConfig.assetIds`. `delete` confirms + refuses without `--yes` in agent mode. |
127
+ | `fruxon assets create/list/get/wait/operations/replace-file/delete` | Manage knowledge-base (RAG) assets an agent can query — upload local files, wait for async ingestion, inspect operations, and use the ids for `assetConfig.assetIds`. `replace-file <asset> --file …` gives an uploaded-file asset new contents under the same id (`--wait` blocks on the re-index; search keeps the previous file until it finishes). `replace-file` and `delete` confirm + refuse without `--yes` in agent mode. |
126
128
  | `fruxon knowledge-bases list/get/create/update/publish/archive/delete` | The authored, reviewable corpus behind a `manual_knowledge` asset — **not** the asset itself, which is what gets searched (`get` prints the asset id as `backingAssetId`). **`publish` is the step that makes any of it findable**: only `PUBLISHED` documents travel in a snapshot, and only publishing the *base* moves one, so a base full of finished articles answers nothing until it runs. It returns on *acceptance*, not searchability — RAG ingests afterwards, so a pending publish state is normal. `list` hides archived bases, which keep answering for agents already attached to them; `delete` is refused while an agent revision still attaches one, and `archive` is the reversible path. |
127
129
  | `fruxon knowledge-bases usage <kb>` | Whether agents actually use the base: searches per hour, day or week (`--interval`), the passage tokens each search handed the agent, how many found nothing (split from searches that **could not fully search** it — index missing or still building, a phrasing failed), and which agents searched (up to 20 you can open, the rest counted together). `--origin test` counts test runs instead of production. Retrieved tokens are counted by the search index, so what the model read can be less when a large result is trimmed or offloaded. Searches are recorded from 15 October 2026 and kept 90 days at most, so a window reaching further back says where counting began rather than showing empty days. A 404 is a wrong id or a backend that predates the read. |
128
130
  | `fruxon knowledge-bases notices/notice/post-notice/edit-notice/extend-notice/withdraw-notice` | Time-boxed notices on a base — an outage being fixed, a known bug, a closure. **Not documents**: never indexed or published, so every agent attaching the base is given each active notice whole from its next turn. `post-notice --valid-for 4h` (or `--until`) — every notice ends, at most 30 days after it was posted, and a base holds ten active ones (409 `notice_limit` / `notice_too_long`, each with its remedy). The body is Markdown, at most 1,200 characters, best as four headings: *What is happening*, *Applies when*, *Tell the customer*, *Do not*. A time without an offset is read in the notice's zone (`--time-zone`, else this machine's), which is also the zone agents tell customers the end in. `withdraw-notice` tells each conversation that was given it, on its next turn, that it ended; it confirms, and needs `--yes` in agent mode. An ended notice is not extended: `post-notice --from <id>` posts it again as a new one. |
@@ -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.2.8'
22
- __version_tuple__ = version_tuple = (2, 2, 8)
21
+ __version__ = version = '2.2.10'
22
+ __version_tuple__ = version_tuple = (2, 2, 10)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -623,6 +623,9 @@ def escalation_reach(client, agent: str) -> tuple[str, str, str | None]:
623
623
 
624
624
  surfaces: list[tuple[str, object]] = []
625
625
  problems: list[str] = []
626
+ # Where a desk is missing outright, the fix is a new desk, not a ladder:
627
+ # `set-policy` has nothing to change there.
628
+ deskless: list[str] = []
626
629
  if top.channels:
627
630
  resolved: dict[str, object] = {}
628
631
  for channel in top.channels:
@@ -630,6 +633,7 @@ def escalation_reach(client, agent: str) -> tuple[str, str, str | None]:
630
633
  desk = channel.get("deskId")
631
634
  if not desk:
632
635
  problems.append(f"{where}: no escalation desk — hand-off isn't available there")
636
+ deskless.append(f"--attach {channel.get('entryPointId') or '<entry-point-id>'}")
633
637
  continue
634
638
  if desk not in resolved:
635
639
  try:
@@ -644,15 +648,26 @@ def escalation_reach(client, agent: str) -> tuple[str, str, str | None]:
644
648
  problem = _desk_problem(policy, where)
645
649
  if problem:
646
650
  problems.append(problem)
651
+ if not policy.desk_id:
652
+ deskless.append("--attach other")
647
653
 
648
654
  if problems:
655
+ if deskless:
656
+ hint = (
657
+ f"fruxon escalations desks create --agent {agent} --name <name> --operator <participant-id> "
658
+ f"{' '.join(deskless)} (operators: fruxon participants list)"
659
+ )
660
+ else:
661
+ hint = (
662
+ f"fruxon escalations set-policy {agent} --operator <participant-id> "
663
+ "(operators: fruxon participants list)"
664
+ )
649
665
  return (
650
666
  "warn",
651
667
  "escalation is on, but a hand-off reaches nobody — "
652
668
  + "; ".join(problems)
653
669
  + ". The agent still tells the customer it handed off.",
654
- f"fruxon escalations policy set {agent} --operator <participant-id> "
655
- "(operators: fruxon participants list)",
670
+ hint,
656
671
  )
657
672
  reached = sorted({len(p.configured_operators) for _, p in surfaces})
658
673
  consoles = sum(1 for _, p in surfaces if (p.mode or "").upper() == "NATIVE_HANDOFF")
@@ -794,6 +794,8 @@ from fruxon.cli import dash as _dash # noqa: E402, F401
794
794
  from fruxon.cli import describe as _describe # noqa: E402, F401
795
795
  from fruxon.cli import doctor as _doctor # noqa: E402, F401
796
796
  from fruxon.cli import environments as _environments # noqa: E402, F401
797
+ from fruxon.cli import escalation_desks as _escalation_desks # noqa: E402, F401
798
+ from fruxon.cli import escalation_operators as _escalation_operators # noqa: E402, F401
797
799
  from fruxon.cli import escalations as _escalations # noqa: E402, F401
798
800
  from fruxon.cli import examples as _examples # noqa: E402, F401
799
801
  from fruxon.cli import feedback as _feedback # noqa: E402, F401
@@ -797,13 +797,40 @@ def new_version(
797
797
  from_version: Annotated[
798
798
  int | None, typer.Option("--from", help="Copy this version into a new draft to edit.")
799
799
  ] = None,
800
+ schema: Annotated[
801
+ bool,
802
+ typer.Option("--schema", help="Print the JSON schema for --file (AgentReplyStyleContent) and exit."),
803
+ ] = False,
800
804
  workspace: _WORKSPACE_OPT = None,
801
805
  base_url: _BASE_URL_OPT = None,
802
806
  output: Annotated[
803
807
  str | None, typer.Option("--output", "-o", help="Output format: text (default), json, id (version number).")
804
808
  ] = None,
805
809
  ):
806
- """Write a draft by hand, or copy a version into one to edit. There is at most one draft."""
810
+ """Write a draft by hand, or copy a version into one to edit. There is at most one draft.
811
+
812
+ `--file` is an AgentReplyStyleContent — `summary` (optional), `rules`
813
+ (`text`, optional `situation`), and `examples` (optional `situation`,
814
+ `turns` of `role` CUSTOMER or AGENT and `text`, ending on the agent).
815
+ Pass `--schema` for its JSON schema. For example:
816
+
817
+ {"summary": "Short, warm replies in the customer's language.",
818
+ "rules": [{"text": "Greet only on the first reply."},
819
+ {"text": "Offer two slots, never a list.", "situation": "booking"}],
820
+ "examples": [{"situation": "booking",
821
+ "turns": [{"role": "CUSTOMER", "text": "Can I come in Tuesday?"},
822
+ {"role": "AGENT", "text": "Tuesday works: 10:00 or 14:30?"}]}]}
823
+
824
+ Examples:
825
+ fruxon agents reply-style new my-agent --schema
826
+ fruxon agents reply-style new my-agent --file style.json
827
+ fruxon agents reply-style new my-agent --from 2
828
+ """
829
+ if schema:
830
+ from fruxon.cli._schema import print_schema
831
+
832
+ print_schema("AgentReplyStyleContent", workspace=workspace, base_url=base_url)
833
+ return
807
834
  if (file is None) == (from_version is None):
808
835
  fail("Pass exactly one of --file and --from.", code=EXIT_VALIDATION)
809
836
  output = _output(output, ("text", "json", "id"))
@@ -825,8 +852,14 @@ def new_version(
825
852
  @reply_style_app.command("edit")
826
853
  def edit_version(
827
854
  agent: _AGENT_ARG,
828
- version: Annotated[int, typer.Argument(help="The draft's number.")],
829
- file: Annotated[str, typer.Option("--file", "-f", help="Content JSON replacing the draft's ('-' for stdin).")],
855
+ version: Annotated[int | None, typer.Argument(help="The draft's number.")] = None,
856
+ file: Annotated[
857
+ str | None, typer.Option("--file", "-f", help="Content JSON replacing the draft's ('-' for stdin).")
858
+ ] = None,
859
+ schema: Annotated[
860
+ bool,
861
+ typer.Option("--schema", help="Print the JSON schema for --file (AgentReplyStyleContent) and exit."),
862
+ ] = False,
830
863
  workspace: _WORKSPACE_OPT = None,
831
864
  base_url: _BASE_URL_OPT = None,
832
865
  output: Annotated[str | None, typer.Option("--output", "-o", help="Output format: text (default), json.")] = None,
@@ -836,10 +869,34 @@ def edit_version(
836
869
  Take the content from `show <agent> <n> -o json` (its `content` member),
837
870
  change it, and send it back.
838
871
 
839
- Example:
872
+ `--file` is an AgentReplyStyleContent — `summary` (optional), `rules`
873
+ (`text`, optional `situation`), and `examples` (optional `situation`,
874
+ `turns` of `role` CUSTOMER or AGENT and `text`, ending on the agent).
875
+ Pass `--schema` for its JSON schema. For example:
876
+
877
+ {"summary": "Short, warm replies in the customer's language.",
878
+ "rules": [{"text": "Greet only on the first reply."},
879
+ {"text": "Offer two slots, never a list.", "situation": "booking"}],
880
+ "examples": [{"situation": "booking",
881
+ "turns": [{"role": "CUSTOMER", "text": "Can I come in Tuesday?"},
882
+ {"role": "AGENT", "text": "Tuesday works: 10:00 or 14:30?"}]}]}
883
+
884
+ Examples:
885
+ fruxon agents reply-style edit my-agent --schema
840
886
  fruxon agents reply-style show my-agent 3 -o json | jq .content > draft.json
841
887
  fruxon agents reply-style edit my-agent 3 --file draft.json
842
888
  """
889
+ if schema:
890
+ from fruxon.cli._schema import print_schema
891
+
892
+ print_schema("AgentReplyStyleContent", workspace=workspace, base_url=base_url)
893
+ return
894
+ if version is None or file is None:
895
+ fail(
896
+ "Pass the draft's number and [bold]--file[/bold].",
897
+ hint="Or [bold]--schema[/bold] to see the content's shape.",
898
+ code=EXIT_VALIDATION,
899
+ )
843
900
  output = _output(output, ("text", "json"))
844
901
  content = load_json_body(file, what=_CONTENT_SHAPE)
845
902
  if "content" in content and isinstance(content["content"], dict) and "rules" not in content:
@@ -464,15 +464,48 @@ def _say_live_state(agent: str, revision: int | str, live_revision: int | None)
464
464
  def revisions_deploy(
465
465
  agent: Annotated[str, typer.Argument(help="Agent identifier.")],
466
466
  revision: Annotated[int, typer.Argument(help="Revision number to deploy.")],
467
+ yes: Annotated[
468
+ bool,
469
+ typer.Option(
470
+ "--yes",
471
+ "-y",
472
+ help="Accepted for scripts that pass it to every write; deploying never prompts.",
473
+ ),
474
+ ] = False,
467
475
  workspace: Annotated[str | None, typer.Option("--workspace", help="Workspace identifier override.")] = None,
468
476
  base_url: Annotated[str | None, typer.Option("--base-url", help="API base URL override.")] = None,
477
+ output: Annotated[
478
+ str | None,
479
+ typer.Option("--output", "-o", help="Output format: text (default for humans), json (default in agent mode)."),
480
+ ] = None,
469
481
  ):
470
- """Deploy a previously-created revision so it becomes the agent's live revision."""
482
+ """Deploy a previously-created revision so it becomes the agent's live revision.
483
+
484
+ Deploying does not prompt — like `revisions create --deploy`, it is undone
485
+ by deploying the previous revision (`fruxon agents revisions deploys`
486
+ lists them). `--yes` is accepted and changes nothing.
487
+
488
+ In JSON (`-o json`, the agent-mode default) it prints
489
+ `{"agentId", "revision", "deployed": true, "result"}`, where `result`
490
+ is the server's DeployResult (the updated agent and which connectors
491
+ were activated).
492
+
493
+ Examples:
494
+ fruxon agents revisions deploy my-agent 2
495
+ fruxon agents revisions deploy my-agent 2 -o json | jq .deployed
496
+ """
497
+ del yes # accepted, never needed: see the docstring
498
+ output = resolve_output_format(output, human_default="text", agent_default="json")
499
+ if output not in {"text", "json"}:
500
+ fail(f"Unknown output format: [bold]{output}[/bold]", hint="Valid formats: text, json.", code=EXIT_VALIDATION)
471
501
  client = build_client(workspace, base_url)
472
502
  try:
473
- client.deploy_revision(agent, revision)
503
+ result = client.deploy_revision(agent, revision)
474
504
  except FruxonError as e:
475
505
  fail_from_api_error(e, hint=_deploy_hint(e))
506
+ if output == "json":
507
+ print(json.dumps({"agentId": agent, "revision": revision, "deployed": True, "result": result}, indent=2))
508
+ return
476
509
  say_ok(f"Deployed revision [bold]{revision}[/bold] of [bold]{agent}[/bold]")
477
510
 
478
511
 
@@ -253,6 +253,102 @@ def assets_create(
253
253
  _say_kv("wait", f"fruxon assets wait {asset_id}")
254
254
 
255
255
 
256
+ @assets_app.command("replace-file")
257
+ def assets_replace_file(
258
+ asset: Annotated[str, typer.Argument(help="Identifier of an uploaded-file asset.")],
259
+ file_path: Annotated[
260
+ Path,
261
+ typer.Option("--file", "-f", exists=True, dir_okay=False, readable=True, help="Local file to replace it with."),
262
+ ],
263
+ wait: Annotated[bool, typer.Option("--wait", help="Block until the re-index finishes.")] = False,
264
+ timeout: Annotated[float, typer.Option("--timeout", help="Seconds --wait waits before timing out.")] = 300.0,
265
+ yes: Annotated[
266
+ bool,
267
+ typer.Option("--yes", "-y", help="Skip confirmation. REQUIRED under agent mode (CLAUDECODE / CI)."),
268
+ ] = False,
269
+ workspace: Annotated[str | None, typer.Option("--workspace", help="Workspace identifier override.")] = None,
270
+ base_url: Annotated[str | None, typer.Option("--base-url", help="API base URL override.")] = None,
271
+ output: Annotated[
272
+ str | None,
273
+ typer.Option("--output", "-o", help="Output format: text (default), json, id."),
274
+ ] = None,
275
+ ):
276
+ """Replace the file behind an uploaded-file asset; the asset keeps its id.
277
+
278
+ Agents and prompts that use the asset read the new file. For an indexed
279
+ asset this starts a re-index: search answers from the previous file until
280
+ it finishes, and keeps it if the new file can't be indexed. The previous
281
+ file is no longer offered for download, so confirm first.
282
+
283
+ Examples:
284
+ fruxon assets replace-file $ASSET_ID --file ./faq.md --yes --wait
285
+ fruxon assets replace-file $ASSET_ID --file ./faq.md --yes -o json
286
+ """
287
+ output = resolve_output_format(output, human_default="text", agent_default="json")
288
+ if output not in {"text", "json", "id"}:
289
+ fail(
290
+ f"Unknown output format: [bold]{output}[/bold]",
291
+ hint="Valid formats: text, json, id.",
292
+ code=EXIT_VALIDATION,
293
+ )
294
+ if wait and timeout <= 0:
295
+ fail("Timeout must be positive.", code=EXIT_VALIDATION)
296
+
297
+ require_yes_in_agent_mode(yes, action=f"replace the file of asset {asset}")
298
+ if not yes and not typer.confirm(
299
+ f"Replace the file of asset {asset} with {file_path.name}? "
300
+ "The current file won't be offered for download afterwards.",
301
+ default=False,
302
+ ):
303
+ say_info("Cancelled.")
304
+ return
305
+
306
+ client = build_client(workspace, base_url)
307
+ try:
308
+ if stderr.is_terminal and output == "text":
309
+ with stderr.status(f"[bold]Uploading [cyan]{file_path.name}[/cyan]…[/bold]"):
310
+ response = client.replace_asset_file(asset, file_path)
311
+ else:
312
+ response = client.replace_asset_file(asset, file_path)
313
+ except FruxonError as e:
314
+ fail_from_api_error(e, hint=_hint_for_replace_error(e, asset))
315
+
316
+ operation = response.get("longOperation") if isinstance(response.get("longOperation"), dict) else {}
317
+ reindexing = bool(operation) and _operation_status(operation).lower() != "done"
318
+ waited = None
319
+ if wait and reindexing:
320
+ try:
321
+ if stderr.is_terminal and output == "text":
322
+ with stderr.status(f"[bold]Re-indexing [cyan]{asset}[/cyan]…[/bold]"):
323
+ waited = client.wait_for_asset(asset, operation=_operation_id(operation) or None, timeout_s=timeout)
324
+ else:
325
+ waited = client.wait_for_asset(asset, operation=_operation_id(operation) or None, timeout_s=timeout)
326
+ except TimeoutError as e:
327
+ fail(str(e), hint=f"The file was replaced. Keep waiting with [bold]fruxon assets wait {asset}[/bold].")
328
+ except FruxonError as e:
329
+ fail_from_api_error(
330
+ e,
331
+ hint=(
332
+ "The file was replaced, but the new one didn't index; search still answers from the previous "
333
+ f"file. Inspect with [bold]fruxon assets operations {asset}[/bold]."
334
+ ),
335
+ )
336
+
337
+ asset_id = _asset_id_from_response(response) or asset
338
+ if output == "id":
339
+ print(asset_id)
340
+ return
341
+ if output == "json":
342
+ print(json.dumps({**response, "reindexing": reindexing, "waited": waited}, indent=2))
343
+ return
344
+
345
+ say_ok(f"Replaced the file of asset [bold]{asset_id}[/bold] with [bold]{file_path.name}[/bold].")
346
+ if waited is not None:
347
+ say_ok("Re-index complete.")
348
+ elif reindexing:
349
+ _say_kv("wait", f"fruxon assets wait {asset_id}")
350
+
351
+
256
352
  @assets_app.command("wait")
257
353
  def assets_wait(
258
354
  asset: Annotated[str, typer.Argument(help="Asset identifier to wait for.")],
@@ -593,6 +689,20 @@ def _hint_for_error(error: FruxonError) -> str | None:
593
689
  return None
594
690
 
595
691
 
692
+ def _hint_for_replace_error(error: FruxonError, asset: str) -> str | None:
693
+ """The two refusals a replace has of its own, before the asset-wide hints."""
694
+ from fruxon.exceptions import FruxonAPIError
695
+
696
+ if isinstance(error, FruxonAPIError) and error.status == 409:
697
+ return f"Indexing is running. Wait with [bold]fruxon assets wait {asset}[/bold], then replace the file again."
698
+ if isinstance(error, FruxonAPIError) and error.status == 400:
699
+ return (
700
+ "Only an uploaded-file asset can be replaced, and an indexed one only with a type "
701
+ "[bold]fruxon assets supported-types[/bold] lists."
702
+ )
703
+ return _hint_for_error(error)
704
+
705
+
596
706
  def _hint_for_chunks_error(error: FruxonError, asset: str) -> str | None:
597
707
  """Like :func:`_hint_for_error`, but ``assets chunks`` takes two ids —
598
708
  a 404 is just as likely to mean the document id as the asset id, so