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.
- {fruxon-2.2.8 → fruxon-2.2.10}/HISTORY.md +52 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/PKG-INFO +4 -2
- {fruxon-2.2.8 → fruxon-2.2.10}/README.md +3 -1
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/_version.py +2 -2
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/agent.py +17 -2
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/__init__.py +2 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_reply_style.py +61 -4
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_revisions.py +35 -2
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/assets.py +110 -0
- fruxon-2.2.10/src/fruxon/cli/escalation_desks.py +394 -0
- fruxon-2.2.10/src/fruxon/cli/escalation_operators.py +277 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/escalations.py +34 -3
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/examples.py +4 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/integrations_sandbox.py +57 -1
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/working_hours.py +3 -3
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/fruxon.py +150 -1
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-build-agent/SKILL.md +9 -3
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-meet/SKILL.md +3 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agents_check_cli.py +1 -1
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_assets.py +109 -0
- fruxon-2.2.10/tests/test_cli_friction_round2.py +320 -0
- fruxon-2.2.10/tests/test_escalation_operators.py +274 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integration_sandbox_cli.py +52 -1
- {fruxon-2.2.8 → fruxon-2.2.10}/.gitignore +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/LICENSE +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/pyproject.toml +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/__init__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/__main__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/_request_id.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/_ssl.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/__init__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/ledger.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/checks/references.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_crash.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_last_failure.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_ledger_passes.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_plugin_hint.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_schema.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_shared.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/_stream.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_approvals.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_budget.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_channels.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_draft.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_evaluations.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_executions.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_improvements.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_lifecycle.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_memory.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_sandbox.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_sandbox_test.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_slots.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_system_blocks.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_tests.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_topics.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/agents_voice_calls.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/applications.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/applications_entry_points.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/auth.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/capabilities.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/completion.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/config.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/consult_pins.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/conversation_imports.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/dash.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/describe.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/doctor.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/environments.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/feedback.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/guides.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/integrations.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/keys.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_bases.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_documents.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_notices.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/knowledge_sources.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/llm_providers.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/messages.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/metrics.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/participants.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/pipelines.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/secrets.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/skills.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/storage.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/tools.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_budget.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_check.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_ledger.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_ledger_stage_tests.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_questions.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/triggers_shape.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/cli/workspaces.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/credentials.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/device_auth.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/doctor.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/exceptions.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/flow_validation.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/models.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/output.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/params.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/sandbox_scenario.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/__init__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-agent-mode/SKILL.md +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-create-integration/SKILL.md +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-debug-trace/SKILL.md +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/skills/fruxon-use-integrations/SKILL.md +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/telemetry.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/__init__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/app.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/demo.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/links.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/__init__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/agent.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/base.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/home.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/ledger.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/loader.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/pickers.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/screens/trace.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/source.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/theme.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/views.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/tui/widgets.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/ui.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/update_check.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/src/fruxon/validation.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/.test_durations.json +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/__init__.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/conftest.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_actor.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agent_lifecycle.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agent_revisions_list.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agent_slots.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agents_revisions_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_agents_sandbox.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_applications.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_approvals.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_budgets.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_capabilities.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_channels.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_checks_agent.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_checks_ledger.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_base_url_routing.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_crash.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_feedback.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_cli_root_flags.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_client.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_connect_nudge.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_consult.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_conversation_imports.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_credentials.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_app.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_client.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_links.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_dash_source.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_describe.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_device_auth.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_docs_commands_exist.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_doctor.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_bootstrap.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_evaluate_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_pull_shape.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_run_replay.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_draft_validate_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_drafts.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_entry_points.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_environments.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_escalations.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_evaluations.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_execution_records.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_flow_validation.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_fruxon.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_guides.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_improvements.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integration_configs_write_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integration_triggers_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integrations_authorize_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_integrations_connect_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_kb_trial_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_bases.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_documents.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_notices.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_knowledge_sources.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_llm_provider_configs_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_llm_providers_connect_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_llm_providers_list_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_managed_by.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_memory.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_messages.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_metrics.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_online_llm_config_refs.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_online_prefetch_refs.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_online_secret_refs.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_output.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_params.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_participants.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_participants_write.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_pipelines.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_plugin_hint.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_project_urls.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_reply_style.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_request_id.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_sandbox_scenario.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_schema.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_schema_fetch.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_secrets.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_skills.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_ssl.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_storage.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_system_blocks.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_system_blocks_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_telemetry.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_test_chats.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_topics.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_trigger_budgets.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_check_cli.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_ledger.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_ledger_batch_views.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_ledger_stage_tests.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_questions.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_shape.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_triggers_write.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_tui_boundary.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_ui.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_update_check.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_validation.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_voice_calls.py +0 -0
- {fruxon-2.2.8 → fruxon-2.2.10}/tests/test_working_hours_cli.py +0 -0
- {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.
|
|
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`
|
|
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`
|
|
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.
|
|
22
|
-
__version_tuple__ = version_tuple = (2, 2,
|
|
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
|
-
|
|
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[
|
|
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
|
-
|
|
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
|