fruxon 2.2.7__tar.gz → 2.2.9__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.7 → fruxon-2.2.9}/HISTORY.md +196 -0
- fruxon-2.2.7/README.md → fruxon-2.2.9/PKG-INFO +57 -9
- fruxon-2.2.7/PKG-INFO → fruxon-2.2.9/README.md +23 -44
- {fruxon-2.2.7 → fruxon-2.2.9}/pyproject.toml +9 -3
- fruxon-2.2.9/src/fruxon/_request_id.py +75 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/_version.py +2 -2
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/checks/agent.py +115 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/__init__.py +85 -14
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/_crash.py +65 -27
- fruxon-2.2.9/src/fruxon/cli/_last_failure.py +124 -0
- fruxon-2.2.9/src/fruxon/cli/_plugin_hint.py +65 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents.py +1 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_draft.py +20 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_improvements.py +251 -56
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_reply_style.py +61 -4
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_revisions.py +87 -7
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_sandbox.py +322 -49
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_topics.py +1 -1
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/auth.py +47 -18
- fruxon-2.2.9/src/fruxon/cli/escalation_desks.py +382 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/escalations.py +171 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/examples.py +29 -8
- fruxon-2.2.9/src/fruxon/cli/feedback.py +447 -0
- fruxon-2.2.9/src/fruxon/cli/integrations_sandbox.py +474 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/knowledge_documents.py +139 -15
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/llm_providers.py +15 -0
- fruxon-2.2.9/src/fruxon/cli/working_hours.py +352 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/device_auth.py +5 -1
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/exceptions.py +26 -2
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/fruxon.py +319 -28
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/models.py +9 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/sandbox_scenario.py +50 -2
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/fruxon-agent-mode/SKILL.md +104 -13
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/fruxon-build-agent/SKILL.md +97 -18
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/fruxon-debug-trace/SKILL.md +10 -2
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/fruxon-meet/SKILL.md +6 -1
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/fruxon-use-integrations/SKILL.md +4 -1
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/ui.py +118 -8
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/conftest.py +1 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_agents_check_cli.py +99 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_agents_revisions_cli.py +68 -1
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_agents_sandbox.py +273 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_cli.py +67 -26
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_cli_crash.py +118 -3
- fruxon-2.2.9/tests/test_cli_feedback.py +502 -0
- fruxon-2.2.9/tests/test_cli_friction_round2.py +320 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_draft_validate_cli.py +71 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_improvements.py +187 -2
- fruxon-2.2.9/tests/test_integration_sandbox_cli.py +255 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_knowledge_documents.py +76 -0
- fruxon-2.2.9/tests/test_llm_providers_list_cli.py +65 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_plugin_hint.py +27 -0
- fruxon-2.2.9/tests/test_project_urls.py +25 -0
- fruxon-2.2.9/tests/test_request_id.py +346 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_sandbox_scenario.py +64 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_ui.py +5 -2
- fruxon-2.2.9/tests/test_working_hours_cli.py +281 -0
- fruxon-2.2.7/src/fruxon/cli/_plugin_hint.py +0 -25
- {fruxon-2.2.7 → fruxon-2.2.9}/.gitignore +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/LICENSE +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/__init__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/__main__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/_ssl.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/checks/__init__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/checks/ledger.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/checks/references.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/_ledger_passes.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/_schema.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/_shared.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/_stream.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_approvals.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_budget.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_channels.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_evaluations.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_executions.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_lifecycle.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_memory.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_sandbox_test.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_slots.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_system_blocks.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_tests.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/agents_voice_calls.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/applications.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/applications_entry_points.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/assets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/capabilities.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/completion.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/config.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/consult_pins.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/conversation_imports.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/dash.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/describe.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/doctor.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/environments.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/guides.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/integrations.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/keys.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/knowledge_bases.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/knowledge_notices.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/knowledge_sources.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/messages.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/metrics.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/participants.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/pipelines.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/secrets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/skills.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/storage.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/tools.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers_budget.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers_check.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers_ledger.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers_ledger_stage_tests.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers_questions.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/triggers_shape.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/cli/workspaces.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/credentials.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/doctor.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/flow_validation.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/output.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/params.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/__init__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/skills/fruxon-create-integration/SKILL.md +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/telemetry.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/__init__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/app.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/demo.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/links.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/__init__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/agent.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/base.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/home.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/ledger.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/loader.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/pickers.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/screens/trace.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/source.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/theme.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/views.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/tui/widgets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/update_check.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/src/fruxon/validation.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/.test_durations.json +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/__init__.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_actor.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_agent_lifecycle.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_agent_revisions_list.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_agent_slots.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_applications.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_approvals.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_assets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_budgets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_capabilities.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_channels.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_checks_agent.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_checks_ledger.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_cli_base_url_routing.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_cli_root_flags.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_client.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_connect_nudge.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_consult.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_conversation_imports.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_credentials.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_dash_app.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_dash_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_dash_client.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_dash_links.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_dash_source.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_describe.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_device_auth.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_docs_commands_exist.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_doctor.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_draft_bootstrap.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_draft_evaluate_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_draft_pull_shape.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_draft_run_replay.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_drafts.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_entry_points.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_environments.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_escalations.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_evaluations.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_execution_records.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_flow_validation.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_fruxon.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_guides.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_integration_configs_write_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_integration_triggers_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_integrations_authorize_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_integrations_connect_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_kb_trial_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_knowledge_bases.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_knowledge_notices.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_knowledge_sources.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_llm_provider_configs_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_llm_providers_connect_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_managed_by.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_memory.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_messages.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_metrics.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_online_llm_config_refs.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_online_prefetch_refs.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_online_secret_refs.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_output.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_params.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_participants.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_participants_write.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_pipelines.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_reply_style.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_schema.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_schema_fetch.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_secrets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_skills.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_ssl.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_storage.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_system_blocks.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_system_blocks_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_telemetry.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_test_chats.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_topics.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_trigger_budgets.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_check_cli.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_ledger.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_ledger_batch_views.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_ledger_stage_tests.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_questions.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_shape.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_triggers_write.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_tui_boundary.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_update_check.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_validation.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_voice_calls.py +0 -0
- {fruxon-2.2.7 → fruxon-2.2.9}/tests/test_workspaces_cli.py +0 -0
|
@@ -1,5 +1,201 @@
|
|
|
1
1
|
# History
|
|
2
2
|
|
|
3
|
+
## Unreleased — escalation desks, reply-style schema, deploy output
|
|
4
|
+
|
|
5
|
+
- **`fruxon escalations desks list|create|attach|detach`**: an Application with no escalation desk
|
|
6
|
+
can get one from the CLI. `create --name … [--mode BRIDGE|NATIVE_HANDOFF] [--operator …]
|
|
7
|
+
[--strategy …] [--working-hours …] [--default-reason …] [--attach other|<entry-point>]`;
|
|
8
|
+
`attach <desk> <target>…` and `detach <target>…`, where `other` is conversations that came through
|
|
9
|
+
no channel. `--agent` resolves the agent's Application; `--application` names one; neither uses the
|
|
10
|
+
workspace default. **`FruxonClient.create_escalation_desk`**,
|
|
11
|
+
**`set_other_conversations_escalation_desk`**, and `update_entry_point(escalation_desk=,
|
|
12
|
+
clear_escalation_desk=)`.
|
|
13
|
+
- **`escalations set-policy`** with no desk to change now names the `desks create` command instead of
|
|
14
|
+
the dashboard; so does the `agents check` / `draft validate --online` `escalation_unreachable` hint
|
|
15
|
+
when a desk is missing.
|
|
16
|
+
- **Command name fixed**: the `escalation_unreachable` hint and `working-hours create` said
|
|
17
|
+
`fruxon escalations policy set`; the command is `fruxon escalations set-policy`.
|
|
18
|
+
- **`agents reply-style new|edit --schema`** prints the content's JSON schema
|
|
19
|
+
(`AgentReplyStyleContent`), and their help shows an example.
|
|
20
|
+
- **`integrations configs sandbox generate --context <file|-|text>`** grounds the generated entities
|
|
21
|
+
in facts they must agree with (services, durations, hours — e.g. the agent's KB article), up to
|
|
22
|
+
16,000 characters. `FruxonClient.generate_config_sandbox_data(..., context=)`. Needs the backend's
|
|
23
|
+
`context` field on `sandbox:generate`.
|
|
24
|
+
- **`agents revisions deploy`** takes `-o text|json` (JSON by default in agent mode:
|
|
25
|
+
`{"agentId", "revision", "deployed": true, "result"}`) and accepts `--yes`, which changes nothing —
|
|
26
|
+
deploying never prompts.
|
|
27
|
+
|
|
28
|
+
## Unreleased — Improvements reviews on Fruxon's reviewer model, for credits
|
|
29
|
+
|
|
30
|
+
- **`fruxon agents improvements settings`** chooses where reviews run:
|
|
31
|
+
- **`--run-on fruxon`** uses Fruxon's reviewer model, at a fixed number of credits per reviewed
|
|
32
|
+
conversation under a daily limit, `--daily-credits` (1–10,000).
|
|
33
|
+
- **`--run-on own`** uses a model of your own, as before.
|
|
34
|
+
- **Left out:** the agent keeps where it runs, and `--daily-credits` keeps the stored limit.
|
|
35
|
+
Neither is sent, so a save never changes who pays.
|
|
36
|
+
- **On Fruxon's model:** `--on` needs no model. `--provider`, `--model`, `--llm-config`,
|
|
37
|
+
`--param` and `--daily-budget` are refused, with a hint to add `--run-on own`.
|
|
38
|
+
- **Agent mode:** `--run-on` needs `--yes`, like `--on`.
|
|
39
|
+
- **Output:** it shows where reviews run, today's credits against the limit, and why Fruxon's
|
|
40
|
+
model can't run the agent's reviews when it can't.
|
|
41
|
+
- **Older servers:** against a server that doesn't offer Fruxon's model yet, `--run-on` and
|
|
42
|
+
`--daily-credits` are refused rather than silently dropped.
|
|
43
|
+
- **`review` and `revise`** name the credits they cost on Fruxon's model when they refuse in agent
|
|
44
|
+
mode without `--yes`. Only then do they read the settings; a confirmed run makes no extra call.
|
|
45
|
+
- **`status`** says why a conversation was let go: `SKIPPED_BUDGET` (the daily limit ran out) or
|
|
46
|
+
the new `SKIPPED_NO_CREDITS` (the workspace had no credits left).
|
|
47
|
+
- **`FruxonClient.update_review_settings(..., run_on=, daily_credit_limit=)`**: both keyword-only
|
|
48
|
+
and sent only when given. **`get_review_settings`** documents `runOn`, `dailyCreditLimit`,
|
|
49
|
+
`spentTodayCredits`, `creditsPerReview`, `creditsPerRevise` and `laneUnavailableReason`.
|
|
50
|
+
- Needs fruxon-backend #1832 on the server.
|
|
51
|
+
|
|
52
|
+
## Unreleased — `fruxon feedback`: report a problem from the CLI
|
|
53
|
+
|
|
54
|
+
- **`fruxon feedback "<what happened>"`** files a report with Fruxon support:
|
|
55
|
+
the message, `--kind bug|idea|docs|other`, where the CLI ran, and the last
|
|
56
|
+
failed command with its request id. The failure is attached only if it's
|
|
57
|
+
under an hour old and from this workspace, and never with its arguments.
|
|
58
|
+
- **A person** sees everything first and confirms (`--yes` skips the
|
|
59
|
+
prompt). With no message, it opens `$EDITOR`.
|
|
60
|
+
- **An agent** files without a prompt and gets
|
|
61
|
+
`{"id", "reference", "receivedAt"}` back. Agent reports are off when
|
|
62
|
+
telemetry is off (exit 16).
|
|
63
|
+
- **`--crash-log`** takes only a `crash-*.log` the CLI wrote, up to 64 KB.
|
|
64
|
+
- **`--dry-run`** prints the body and sends nothing.
|
|
65
|
+
- **When it can't send** (signed out, a refused key, a server without the
|
|
66
|
+
endpoint), it says it didn't send and prints the report to email instead.
|
|
67
|
+
- Needs fruxon-backend #1828 on the server. Before that it answers exit 11.
|
|
68
|
+
- **Crashes point at it.** The crash message, the crash log and the agent
|
|
69
|
+
envelope's `report` now say
|
|
70
|
+
`fruxon feedback --crash-log <file> "<what you were doing>"`. The support
|
|
71
|
+
address stays as the fallback.
|
|
72
|
+
- **Server errors suggest it.** Under a 5xx (exit 14) people see
|
|
73
|
+
`Report it: fruxon feedback "<what you were doing>"`, and the agent error
|
|
74
|
+
envelope carries it in a new `feedback` field.
|
|
75
|
+
- **`FruxonClient.submit_cli_feedback(...)`**, and
|
|
76
|
+
**`FruxonAPIError.retry_after`**: a 429's `Retry-After`, in seconds.
|
|
77
|
+
|
|
78
|
+
## Unreleased — CLI friction fixes from building a clinic front-desk agent
|
|
79
|
+
|
|
80
|
+
- **A closed pipe exits 141**, not 1: `fruxon llm-providers list | head -c 2500`
|
|
81
|
+
ends the way any Unix tool killed by SIGPIPE does (128 + 13), so a driver
|
|
82
|
+
checking exit codes does not read the reader leaving as a failed command.
|
|
83
|
+
- **`fruxon login` works in agent mode.** It used to exit 16
|
|
84
|
+
(`interactive_required`). It now prints the approval link and user code as a
|
|
85
|
+
JSON line on stdout (`"event":"device_authorization"`) for the driver to
|
|
86
|
+
relay to its human, keeps polling, and prints `"event":"signed_in"` once they
|
|
87
|
+
approve. No browser is opened and the key never appears on stdout or a
|
|
88
|
+
command line.
|
|
89
|
+
- **`llm-providers list` marks hosted providers** (surface `FRUXON_HOSTED`,
|
|
90
|
+
e.g. `fruxon_managed_gemini`) *hosted — no config needed*, and the
|
|
91
|
+
build-agent skill no longer says `provider.tenantConfigId` is required for
|
|
92
|
+
them: the server synthesises their config, and `connect` refuses them.
|
|
93
|
+
- **`agents revisions create --deploy` skips the deploy when the new revision
|
|
94
|
+
is already live** — an agent's first revision goes live on create, and the
|
|
95
|
+
redundant deploy call was refused with a bare `403 Error:` on the default
|
|
96
|
+
developer key. A 403 from the deploy step (here and in `revisions deploy`)
|
|
97
|
+
now names the missing `revisions:deploy` scope and `fruxon login --preset
|
|
98
|
+
maintainer`.
|
|
99
|
+
- **`knowledge-bases add-document --markdown <file.md>`** adds a Markdown file
|
|
100
|
+
as an article without hand-building a JSON body: the title is `--title` or
|
|
101
|
+
the file's first `# ` heading (else its name), with `--status` and
|
|
102
|
+
`--locale`. A directory adds every `.md` in it, one article each.
|
|
103
|
+
- **`fruxon working-hours list/get/create/update/delete`** over the workspace's
|
|
104
|
+
working-hours schedules (`--hours "sun-thu 08:00-20:00"`, `--closed`,
|
|
105
|
+
or `--file`).
|
|
106
|
+
- **`fruxon escalations set-policy <agent>`** changes the escalation desk the
|
|
107
|
+
agent's hand-off goes to: `--operator` (the ladder), `--working-hours`,
|
|
108
|
+
`--default-reason`, `--entry-point` for a channel's desk. `escalations
|
|
109
|
+
policy` now names the desk too.
|
|
110
|
+
- **`agents check` gains an Escalation row**, and `draft validate --online` an
|
|
111
|
+
`escalation_unreachable` warning: an agent with escalation on whose desk has
|
|
112
|
+
no operators (or whose channel has no desk) told customers it handed them
|
|
113
|
+
off while it reached nobody.
|
|
114
|
+
- **`integrations configs create <integration> --simulated`** creates a
|
|
115
|
+
`SIMULATED` config with no credentials and publishes it — what took
|
|
116
|
+
`connect`, `configs update` and `configs publish`. **`integrations configs
|
|
117
|
+
sandbox status/entities/generate/import/reset/snapshot/restore`** read and
|
|
118
|
+
seed its store, and scenario files take a `seed` setup step. The
|
|
119
|
+
build-agent skill gains a "Simulate first" section.
|
|
120
|
+
- **The Claude Code plugin hint is printed at most once a day per machine**
|
|
121
|
+
(marker: `<config dir>/plugin-hint-shown`), not on every command. It went to
|
|
122
|
+
stderr on every invocation under Claude Code, so `fruxon … 2>&1 | json.load`
|
|
123
|
+
failed every time.
|
|
124
|
+
|
|
125
|
+
## Unreleased — every request carries an id support can find; the last failure is kept
|
|
126
|
+
|
|
127
|
+
- **Every API request now sends `X-Correlation-ID`** (`cli-<32 hex>`, or
|
|
128
|
+
`sdk-…` from the Python client). The server already keeps a caller's id,
|
|
129
|
+
returns it, and writes it on every log line for the request
|
|
130
|
+
(`labels.correlation_id`), including in the workers it hands work to.
|
|
131
|
+
- **Errors carry it.** `FruxonError.request_id` is set on any SDK error that
|
|
132
|
+
came from a request. On an HTTP error it is the id the server echoed; on a
|
|
133
|
+
connection error or timeout, the id that was sent.
|
|
134
|
+
- **The CLI shows it** as `Request: cli-…` under a 5xx or a network failure,
|
|
135
|
+
and as `request_id` in the agent-mode error envelope (any failure from a
|
|
136
|
+
request, 4xx included).
|
|
137
|
+
- **`<config dir>/last-failure.json`** (mode 0600) keeps the last failed
|
|
138
|
+
command: its name, exit code, error code and class, the message the CLI
|
|
139
|
+
printed, HTTP status, server code, request id, and for a crash the
|
|
140
|
+
fingerprint and crash log. Never arguments or option values. A parse error,
|
|
141
|
+
Ctrl-C, a declined prompt or a closed pipe doesn't replace it.
|
|
142
|
+
- `FRUXON_CORRELATION_ID` sends one id of your choosing on every request, to
|
|
143
|
+
tie a script's commands together (1–64 letters, digits and hyphens;
|
|
144
|
+
anything else is ignored).
|
|
145
|
+
- **Why:** a failure could not be matched to the request the server logged,
|
|
146
|
+
so neither a support email nor a crash report could point at what
|
|
147
|
+
happened. This is the first step toward `fruxon feedback`.
|
|
148
|
+
|
|
149
|
+
## Unreleased — piping into `head` is not a crash; crash reports go to support
|
|
150
|
+
|
|
151
|
+
- **`fruxon describe | head` no longer reports a crash.** When the program
|
|
152
|
+
reading the CLI's output exits early, the CLI now exits 1 quietly, as Click
|
|
153
|
+
intends. Before, it said "The Fruxon CLI hit a bug", wrote a crash log, and in
|
|
154
|
+
agent mode printed an `internal_error` envelope. A short output (under the
|
|
155
|
+
pipe buffer) printed Python's own "Exception ignored … BrokenPipeError" and
|
|
156
|
+
exited 120 instead.
|
|
157
|
+
- **Why:** this was the only crash the CLI reported between 2026-10-18 and
|
|
158
|
+
2026-11-16, ten times across both cells. Telemetry now files it as
|
|
159
|
+
`user_input` with no fingerprint, not `network`.
|
|
160
|
+
- **A crash report now says to email support@fruxon.com** with the crash log
|
|
161
|
+
attached. The log carries the subject line to use. In agent mode the
|
|
162
|
+
envelope's `report` is `mailto:support@fruxon.com`.
|
|
163
|
+
- **Why:** the report linked to the SDK's GitHub issues, and that repository is
|
|
164
|
+
private, so the link was a 404 for every customer. No issue was ever filed.
|
|
165
|
+
- The PyPI project links no longer point into the private repository:
|
|
166
|
+
homepage is fruxon.com, documentation is the CLI guide, and bugs is the
|
|
167
|
+
support address.
|
|
168
|
+
|
|
169
|
+
## Unreleased — `--wait` follows a sandbox turn from the start
|
|
170
|
+
|
|
171
|
+
- **`fruxon agents sandbox turn` / `fire` / `fork --send` and `fruxon agents
|
|
172
|
+
improvements test --send` take `--wait`**: the command opens the session's
|
|
173
|
+
stream before it sends the turn, then follows the turn until it ends —
|
|
174
|
+
replied, silent, parked or failed. With `-o json` (the default in agent mode)
|
|
175
|
+
it prints NDJSON: `start`, a `sent` record carrying what the command prints
|
|
176
|
+
today, the frames `stream` prints, then `stopped`. `--wait` with `fork -o id`
|
|
177
|
+
is refused.
|
|
178
|
+
- `--wait` exits 0 only when it saw the turn end. When the stream closes first,
|
|
179
|
+
or `--timeout` seconds pass (default 300), it exits 1 and says where the run
|
|
180
|
+
can be read. A turn the server accepts without starting a run never sends
|
|
181
|
+
`turn_complete`, so without the timeout `--wait` would wait forever.
|
|
182
|
+
`--timeout` without `--wait` is refused.
|
|
183
|
+
- `agents sandbox stream` flushes each NDJSON record as it prints it. Before,
|
|
184
|
+
records written to a file or pipe sat in the buffer until the process ended.
|
|
185
|
+
- **Why:** the stream replays nothing and `turn_complete` is never stored. The
|
|
186
|
+
old recipe — send, then run `sandbox stream` — missed any turn that ended
|
|
187
|
+
before the stream connected, and `stream` then waited forever. A turn that
|
|
188
|
+
stayed silent left no trace at all, so it looked as if it had never run.
|
|
189
|
+
- Without `--wait`, `fork --send` now says where the turn's run can be read
|
|
190
|
+
(`agents executions list <agent> --origin TEST --session <ts_…>`), and the
|
|
191
|
+
text view of a silent `turn_complete` says the agent sent no reply.
|
|
192
|
+
- The turn goes out once the stream's response headers are in, which is when
|
|
193
|
+
the server has registered the subscriber, so `--wait` never sends a turn it
|
|
194
|
+
isn't watching. With fruxon-backend#1822 the headers come at once. An older
|
|
195
|
+
server holds them until its first frame, a heartbeat up to 20 s away on a
|
|
196
|
+
quiet session, and the turn waits that long. If the stream does not open,
|
|
197
|
+
nothing is sent.
|
|
198
|
+
|
|
3
199
|
## Unreleased — passes list the work claimed between them
|
|
4
200
|
|
|
5
201
|
- **`fruxon triggers ledger passes`** and **`fruxon knowledge-bases source
|
|
@@ -1,8 +1,42 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: fruxon
|
|
3
|
+
Version: 2.2.9
|
|
4
|
+
Summary: The Fruxon SDK is a lightweight Python client for integrating with the Fruxon platform.
|
|
5
|
+
Project-URL: homepage, https://fruxon.com
|
|
6
|
+
Project-URL: documentation, https://docs.fruxon.com/guides/cli
|
|
7
|
+
Author-email: Hagai Cohen <hagai@fruxon.com>
|
|
8
|
+
Maintainer-email: Hagai Cohen <hagai@fruxon.com>
|
|
9
|
+
License: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Classifier: Development Status :: 3 - Alpha
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Requires-Python: >=3.10
|
|
20
|
+
Requires-Dist: certifi>=2024.2.2
|
|
21
|
+
Requires-Dist: click>=8.2
|
|
22
|
+
Requires-Dist: keyring>=24.0
|
|
23
|
+
Requires-Dist: typer>=0.13
|
|
24
|
+
Provides-Extra: test
|
|
25
|
+
Requires-Dist: coverage; extra == 'test'
|
|
26
|
+
Requires-Dist: ipdb; extra == 'test'
|
|
27
|
+
Requires-Dist: pre-commit; extra == 'test'
|
|
28
|
+
Requires-Dist: pytest; extra == 'test'
|
|
29
|
+
Requires-Dist: ruff; extra == 'test'
|
|
30
|
+
Requires-Dist: ty; extra == 'test'
|
|
31
|
+
Provides-Extra: tui
|
|
32
|
+
Requires-Dist: textual>=8.2; extra == 'tui'
|
|
33
|
+
Description-Content-Type: text/markdown
|
|
34
|
+
|
|
1
35
|
# fruxon
|
|
2
36
|
|
|
3
37
|
[](https://pypi.org/project/fruxon/)
|
|
4
38
|
[](https://pypi.org/project/fruxon/)
|
|
5
|
-
[](https://
|
|
39
|
+
[](https://pypi.org/project/fruxon/)
|
|
6
40
|
|
|
7
41
|
Run, build, and orchestrate AI agents from your terminal — the official Python SDK and CLI for the [Fruxon](https://fruxon.com) platform.
|
|
8
42
|
|
|
@@ -42,6 +76,7 @@ Top-level discovery commands — useful whether you're a human or an AI agent dr
|
|
|
42
76
|
| `fruxon completion {bash\|zsh\|fish}` | Print a shell-completion script. `eval "$(fruxon completion zsh)"` to install. |
|
|
43
77
|
| `fruxon guides list / show <id>` | Bundled CLI playbooks. Start with `fruxon-meet`; `fruxon-agent-mode` covers the exit codes, error envelope, and output shapes a program driving the CLI relies on. |
|
|
44
78
|
| `fruxon doctor` | Diagnose local setup (interpreter, SDK version, credentials, API reachability, auth). |
|
|
79
|
+
| `fruxon feedback "<what happened>"` | Report a problem (or an idea) to Fruxon support. Attaches the last failed command and its request id; you see it all and confirm first. `--crash-log <file>` sends a crash log, `--dry-run` shows the body without sending. |
|
|
45
80
|
|
|
46
81
|
Auth:
|
|
47
82
|
|
|
@@ -66,12 +101,14 @@ Execution:
|
|
|
66
101
|
| `fruxon agents approvals list/get/respond/cancel <agent>` | Operate human-in-the-loop approval gates — see what a run is blocked on and answer it. `respond`/`cancel` confirm first and refuse without `--yes` in agent mode (an LLM must not silently auto-approve). |
|
|
67
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). |
|
|
68
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. |
|
|
69
|
-
| `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. |
|
|
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 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`. |
|
|
70
107
|
| `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. |
|
|
71
|
-
| `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 (`stream
|
|
108
|
+
| `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`. |
|
|
72
109
|
| `fruxon agents voice-calls list/get <agent>` | Read back the Test lab's Talk calls. `list` gives calls newest first (status, end reason, turns, length). `get <agent> <call-id>` gives the call turn by turn: the caller's transcript, the reply, what was heard of it (`delivery`; `spokenText` when the caller cut in), and each reply's `executionRecordId` for `agents executions trace`. Read-only; needs `executions:read`. |
|
|
73
|
-
| `fruxon agents sandbox fork <agent> <message-id>` | Fork a real conversation at a transcript row (an `id` from `agents topics messages`) into a sandbox session already holding the history the agent had when it produced that reply. `--send` re-sends the customer's message against it — with `--draft` to test an edit before publishing — and holds writes for approval unless `--no-confirm-writes`. |
|
|
74
|
-
| `fruxon agents sandbox test <file-or-dir>` | Run scenario-based e2e tests of an agent's network behavior. A scenario (YAML/JSON) declares `steps` (turns / trigger fires), `responders` (scripted consult/approval answers), and `expect` assertions (reply / routing / tools called or refused / no-leak / outcome); the runner drives a sandbox session and returns one verdict — exit 0 (pass) / 1 (fail) / 12 (bad file), with `--junit` for CI. An optional `setup` block provisions real resources first — an `asset` (uploaded + ingestion-waited), `participant`, or `agent` — templated as `${asset.catalog.id}` and **torn down afterwards even on failure** (`--keep` to inspect). Assertions are deterministic by default; `reply_judge: {metric, min_score}` adds an opt-in **semantic** check that scores the reply against a tenant eval metric. The thing an agent runs to prove the agent it built works. |
|
|
110
|
+
| `fruxon agents sandbox fork <agent> <message-id>` | Fork a real conversation at a transcript row (an `id` from `agents topics messages`) into a sandbox session already holding the history the agent had when it produced that reply. `--send` re-sends the customer's message against it — with `--draft` to test an edit before publishing, and `--wait` to follow the turn until it ends — and holds writes for approval unless `--no-confirm-writes`. |
|
|
111
|
+
| `fruxon agents sandbox test <file-or-dir>` | Run scenario-based e2e tests of an agent's network behavior. A scenario (YAML/JSON) declares `steps` (turns / trigger fires), `responders` (scripted consult/approval answers), and `expect` assertions (reply / routing / tools called or refused / no-leak / outcome); the runner drives a sandbox session and returns one verdict — exit 0 (pass) / 1 (fail) / 12 (bad file), with `--junit` for CI. An optional `setup` block provisions real resources first — an `asset` (uploaded + ingestion-waited), `participant`, or `agent` — templated as `${asset.catalog.id}` and **torn down afterwards even on failure** (`--keep` to inspect) — or a `seed` step that resets, imports into and/or generates a SIMULATED integration config's sandbox store (not torn down; only sandbox runs read it). Assertions are deterministic by default; `reply_judge: {metric, min_score}` adds an opt-in **semantic** check that scores the reply against a tenant eval metric. The thing an agent runs to prove the agent it built works. |
|
|
75
112
|
|
|
76
113
|
Invoking a *deployed* agent in production goes through the [Python client](#the-python-client) (`FruxonClient.stream` / `execute`), not the CLI.
|
|
77
114
|
|
|
@@ -89,7 +126,7 @@ Agent authoring + management:
|
|
|
89
126
|
| `fruxon agents draft validate <id> [--online]` | Lint a draft body locally (no network): a missing `definition`, slot ids, tool→slot wiring, provider config, misplaced `parametersMetadata`. `--online` also resolves references against the live catalog (unknown/unpublished config, unreal model, bad tool id). `{valid, errors, warnings}` envelope (the same `errors` as `agents validate`); exits 12 on any error. `warnings[]` are advisory wiring gaps (`consult_unwired`, `approver_slot_undeclared`) that never flip `valid` or the exit code. |
|
|
90
127
|
| `fruxon agents draft run <id> --file <def.json> [--restore]` | Run a draft definition against an existing agent without publishing it. A CI gate for agent changes. The body goes into the agent's server draft (what `revisions create` publishes); for a file other than the pulled one, `--restore` puts the previous draft back after the run, `--yes` keeps it. |
|
|
91
128
|
| `fruxon agents draft run <id> --replay <run> [--stages <file>]` | Re-run a real execution of the agent on its draft. A run a ledger stage dispatched is replayed as a stage test — on exactly the data it was handed, under the stage's output contract, with no ledger transition or item change; `--stages` swaps in edited stage definitions (the `set-stages` file). Any other run re-runs with the parameters it was recorded with (`-p` overlays them). |
|
|
92
|
-
| `fruxon agents revisions create/get/deploy` | Mint and deploy immutable revisions. `create --deploy` does both in one step. `get --as-draft` converts a stored revision back into a postable body. |
|
|
129
|
+
| `fruxon agents revisions create/get/deploy` | Mint and deploy immutable revisions. `create --deploy` does both in one step, and skips the deploy when the new revision is already live (an agent's first revision goes live on create). Deploying needs `revisions:deploy` (`fruxon login --preset maintainer`); a 403 says so. `get --as-draft` converts a stored revision back into a postable body. |
|
|
93
130
|
| `fruxon agents revisions list/deploys <id>` | `list` shows revisions newest first (20 unless `--all` or `-n`): number, ★ on the live one, who created it and its comment. After a rollback the ★ is not the top row. `-o json` adds `lastDeployedAt`. Bodies are not listed; `get <id> <n>` fetches one. `deploys` is the deploy history: each attempt, failed ones too, `from → to` with ↩ on a rollback, who made it and why. A backend without the list endpoint gets a warning and the same list built from the older history endpoint. |
|
|
94
131
|
| `fruxon agents slots list/bind/unbind <id>` | An agent's contacts — the humans `notify` / `ask` / `escalate` reach. The definition declares them; the binding says who receives (`--participant`, `--role`, or `--queue`). Declared but unbound means the reach-out dead-ends at run time, so `list` calls that out and `unbind` is `--yes`-gated. `bind --role` warns first when nobody holds the role — advisory, since binding ahead of staffing is legitimate. |
|
|
95
132
|
| `fruxon agents check <id>` | Audit whether a **deployed** agent is wired to run end-to-end, beyond the definition: a deployed revision, an inbound path (bound trigger / channel binding / active entry point), a consult roster if the agent enables consult, declared **and bound** contacts, every bound trigger populating the agent's required params, and that the revision's references resolve. `{overall, checks[]}` (doctor-style); exits non-zero only on a hard fail (no deployed revision) — advisory `warn` rows stay exit 0. |
|
|
@@ -109,12 +146,14 @@ Integrations + tools:
|
|
|
109
146
|
| `fruxon integrations list/get/create/update/verify/open` | Manage external integrations — the connections agents draw tools from. `create`/`update`/`verify` take a `--file` JSON body; `open` opens the dashboard. |
|
|
110
147
|
| `fruxon integrations configs list/get/update/publish` | The per-integration auth/config records. `update --file` patches a config's draft (only the fields sent; `{"egressCountry": ""}` clears an egress pin) and prints it with secrets masked; `publish` makes the draft the revision tool calls resolve, asks first (`--yes` in agent mode), and prints the new revision's `id` and `version`, never the credentials. |
|
|
111
148
|
| `fruxon integrations authorize <integration>` | `connect` for an OAuth integration (Gmail, Google Sheets, Outlook…): creates a config for its OAuth2 method (auto-detected; `--auth-method` to pick, `--scope` for what to ask, `--config-param` for connection settings, `--config <id>` for an existing config) and prints a credential link. A human opens it, signs in to Fruxon and then to the provider, and the account is connected and the config published, ready for a slot to pin. |
|
|
149
|
+
| `fruxon integrations configs create <integration> --simulated` | A config with `sandboxMode: SIMULATED` and no credentials, published in one step: every tool call a sandbox run makes through it is answered from its simulated store. `--file` creates an unpublished draft from a full body instead. |
|
|
150
|
+
| `fruxon integrations configs sandbox status/entities/generate/import/reset/snapshot/restore <integration> <config>` | Read and seed a simulated config's store. `generate --type event --prompt … --count N` has a model write entities (the server snapshots first); `import --file` inserts them as written (`payload` may be an object); `snapshot --name` saves a state (no `--name` lists them), `restore` / `reset` are `--yes`-gated. |
|
|
112
151
|
| `fruxon integrations connect <integration>` | Create a config for an integration and print a **credential link**: a human opens it and signs in to Fruxon, then types the API key, token or password (Stripe, most REST APIs), and the page tests it and publishes the config; or, for an OAuth integration, signs in to the provider (`--scope` picks what they grant) and the account is connected and the config published. The secret never passes through the terminal or an agent driving the CLI. `--config <id>` fills an existing config, `--param name=value` sets a connection setting, `--no-sign-in` mints a link anyone holding it can fill (for a client without a Fruxon login), `--expires-in-hours` 1–720. Needs `integrations:write` (the default login preset); `--no-sign-in` also needs `workspace:write` (Admin or Owner). |
|
|
113
152
|
| `fruxon integrations triggers <integration>` | List the event types an integration can fire an agent on — each descriptor's `id` is the `eventType` a trigger listens for, plus the `payloadFields` (dotted paths) a binding's `parameterMappings` can read. Discovery for wiring an inbound-event trigger without guessing. |
|
|
114
153
|
| `fruxon integrations mcp …` | Inspect and enable the MCP server for an integration. |
|
|
115
154
|
| `fruxon tools list/get/create/update/delete/run` | Manage the tools inside an integration. Integration-scoped. `get` and `run` select the tool with `--tool`; `run` executes it outside any agent — real credentials, real result — with `-p key=value`, and `-c` naming the config that supplies credentials. The tenant list API hides internal `knowledge_base` / `assets` tools; `tools list` recovers them by ID and lists them like any other (`--no-include-internal` for the raw server answer). |
|
|
116
155
|
| `fruxon keys list/mint/revoke/delete/history/scopes` | Audit and revoke scoped tokens. Minting opens the dashboard so the secret never enters the CLI process. |
|
|
117
|
-
| `fruxon llm-providers list/get/models` | Browse LLM providers and models supported at the tenant level. |
|
|
156
|
+
| `fruxon llm-providers list/get/models` | Browse LLM providers and models supported at the tenant level. `list` marks a Fruxon-hosted provider (`fruxon_managed_gemini`) *hosted — no config needed*: an agent on it omits `provider.tenantConfigId`. |
|
|
118
157
|
| `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. |
|
|
119
158
|
| `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`). |
|
|
120
159
|
| `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. |
|
|
@@ -122,7 +161,7 @@ Integrations + tools:
|
|
|
122
161
|
| `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. |
|
|
123
162
|
| `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. |
|
|
124
163
|
| `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. |
|
|
125
|
-
| `fruxon knowledge-bases documents/document/add-document/edit-document/delete-document` | The articles. `--query` matches the title, `--status` narrows to DRAFT / PUBLISHED / ARCHIVED — and `--status DRAFT` is usually the answer to "why can't search see this". `--unpublished` lists only what the next publish changes (new or edited since the last publish, or archived / moved back to draft while agents still get them). `document` prints the Markdown body **unrendered to stdout**: that is the exact text which gets embedded, so it has to be pipeable and byte-faithful. Deleting one leaves the indexed snapshot alone until the base is published again. |
|
|
164
|
+
| `fruxon knowledge-bases documents/document/add-document/edit-document/delete-document` | The articles. `--query` matches the title, `--status` narrows to DRAFT / PUBLISHED / ARCHIVED — and `--status DRAFT` is usually the answer to "why can't search see this". `--unpublished` lists only what the next publish changes (new or edited since the last publish, or archived / moved back to draft while agents still get them). `add-document --markdown <file.md|dir>` adds a Markdown file as an article (title from `--title` or its first `# ` heading; `--status`, `--locale`), or every `.md` in a directory, one article each; `--file` takes the full JSON body. `document` prints the Markdown body **unrendered to stdout**: that is the exact text which gets embedded, so it has to be pipeable and byte-faithful. Deleting one leaves the indexed snapshot alone until the base is published again. |
|
|
126
165
|
| `fruxon knowledge-bases review-queue/revisions/evidence/correct` | `review-queue` carries each draft's newest revision *and the one before it*, so the change is readable without a request per row; a row with no previous revision is a new article, not an edit, and `--order PRIORITY` puts personal-data risks ahead of the routine edits `NEWEST` buries them under; a `Close to:` line names a waiting draft that reads close to the row (the same question drafted twice). `revisions` is the base-wide timeline (or one document's) holding whole bodies rather than diffs, with person, agent and run attribution kept apart. `evidence` returns the source **keys, never the items** — resolving one is the source system's call, so reading an article does not hand you the transcript; an `agent-review:` row names the topic and run it came from and whether the team (`OPERATOR`), a tool or nobody answered it. `correct` runs the base's editor agent over your instruction; it **may decline** (the instruction needs a fact it was not given, or is about a claim the article does not make), which writes nothing and exits non-zero, and correcting a *published* article returns it to DRAFT. |
|
|
127
166
|
| `fruxon knowledge-bases consolidate` → `apply` / `calibrate` | Two steps on purpose. `consolidate` queues a **report** of near-duplicate clusters and writes nothing — a standalone pass can no longer merge as it goes, and the old `--apply` is refused. `apply <kb> <run> --cluster <id>` (or `--all`) merges the clusters you accepted: the report's version rides along as a compare-and-set read off the run itself, and each member is revalidated against the content hash the report recorded, so a cluster whose documents moved comes back STALE and is left **entirely** alone rather than partly merged. It re-runs the base's consolidator agent per cluster, so a base without a deployed one is refused. `calibrate` records what a person reviewed a report under — it applies and publishes nothing, and is what reopens automatic source approval. |
|
|
128
167
|
| `fruxon knowledge-bases source list/get/add/update/plan-update/preview/activity/passes/sync/pause/resume/archive/unarchive/fork/delete` | The pipelines that read a customer's history and write articles. `managementMode` decides **who owns the implementation**, which is what the verbs key on: a LINKED source's resources are yours and survive a `delete`, a MANAGED one's agents, automation and ledger go with it — and `fork` flips managed to linked, keeping the history, one-way. **Stopped is the default**: a built source lands paused and `unarchive` returns one paused, so `resume` and `sync` confirm (they start reading someone's history, and dispatched items cost a run each) while `pause` and `archive` do not. `preview` admits nothing and is deliberately not narrowed by the watermark — a caught-up source would otherwise look broken — and reports **floors, not totals**, once a ceiling stopped the scan. `activity` speaks the ledger's vocabulary, so `ready` is backlog rather than motion, and a missing work ledger is reduced health rather than an error. |
|
|
@@ -210,7 +249,7 @@ When `CLAUDECODE=1`, `CODEX_THREAD_ID` (set by Codex), `CODEX_CI=1`, `CI=1`, or
|
|
|
210
249
|
- **NDJSON streaming.** `fruxon agents draft run` and `fruxon agents tests watch` emit one JSON record per line on stdout (`{"type":"text","delta":"..."}`, `{"type":"tool_call",...}`, `{"type":"done",...}`).
|
|
211
250
|
- **Typed exit codes.** `10` = auth_required, `11` = not_found, `12` = validation, `13` = conflict, `14` = server_error, `15` = network_error, `16` = interactive_required. Match on the number, not on prose.
|
|
212
251
|
- **Structured errors.** Every failure emits a one-line JSON envelope on stderr: `{"error":{"code","message","exit_code","hint"}}`.
|
|
213
|
-
- **Interactive guards.** Any path that would block on stdin (
|
|
252
|
+
- **Interactive guards.** Any path that would block on stdin (`--edit`, missing `--yes`) fails fast with `EXIT_INTERACTIVE_REQUIRED` and a hint naming the bypass flag. `fruxon login` instead prints the approval link and code as a JSON line for the driver to relay to its human, then waits for the approval.
|
|
214
253
|
- **Cold-start manifest.** Bare `fruxon` invocation emits a one-line JSON manifest with next-step commands so an LLM driver learns the surface without `--help` walking.
|
|
215
254
|
|
|
216
255
|
Full contract: `fruxon guides show fruxon-agent-mode`.
|
|
@@ -349,8 +388,17 @@ The stored layer is split:
|
|
|
349
388
|
| `FRUXON_NO_UPDATE_CHECK=1` | Opt out of the "newer version available" notifier. |
|
|
350
389
|
| `FRUXON_SCHEMA_TIMEOUT` | Seconds `--schema` waits on the server for the OpenAPI spec (default `60`). |
|
|
351
390
|
| `FRUXON_SCHEMA_CACHE_TTL` | Seconds a cached OpenAPI spec is reused before `--schema` asks again (default `3600`; `0` asks every time). Cached per host under `<config dir>/cache/openapi/`. |
|
|
391
|
+
| `FRUXON_CORRELATION_ID` | Send this as every request's id instead of a fresh `cli-…` one, to tie a script's commands together in the server's logs. 1–64 letters, digits and hyphens; anything else is ignored. |
|
|
352
392
|
| `NO_COLOR=1` | Standard convention — disables color output. |
|
|
353
393
|
|
|
394
|
+
## When something fails
|
|
395
|
+
|
|
396
|
+
Every request the CLI sends carries a request id (`X-Correlation-ID`, `cli-…`), the same id the server writes on every log line for that request. When the server or the network fails, the CLI prints it under the error (`Request: cli-4bf9…`); in agent mode it's `request_id` in the error envelope.
|
|
397
|
+
|
|
398
|
+
To report it, run `fruxon feedback "what you were doing"`. It sends your message with the last failed command and its request id attached, after showing you everything it will send, and prints a reference like `fb-3f2a91c0`. Replies come to the email on your Fruxon account. After a crash, add `--crash-log <file>` with the file the crash message names. Signed out, or if it can't send, it prints the report for you to email to support@fruxon.com.
|
|
399
|
+
|
|
400
|
+
The last failed command is also kept in `<config dir>/last-failure.json` (`~/.fruxon` by default, readable only by you): the command's name, exit code, the error the CLI printed, HTTP status and request id. Never its arguments or option values. A parse error, Ctrl-C or `| head` closing the pipe doesn't replace it.
|
|
401
|
+
|
|
354
402
|
## Docs
|
|
355
403
|
|
|
356
404
|
- [Installation](docs/installation.md)
|
|
@@ -1,43 +1,8 @@
|
|
|
1
|
-
Metadata-Version: 2.5
|
|
2
|
-
Name: fruxon
|
|
3
|
-
Version: 2.2.7
|
|
4
|
-
Summary: The Fruxon SDK is a lightweight Python client for integrating with the Fruxon platform.
|
|
5
|
-
Project-URL: bugs, https://github.com/fruxon-ai/fruxon-sdk/issues
|
|
6
|
-
Project-URL: changelog, https://github.com/fruxon-ai/fruxon-sdk/blob/main/HISTORY.md
|
|
7
|
-
Project-URL: homepage, https://github.com/fruxon-ai/fruxon-sdk
|
|
8
|
-
Author-email: Hagai Cohen <hagai@fruxon.com>
|
|
9
|
-
Maintainer-email: Hagai Cohen <hagai@fruxon.com>
|
|
10
|
-
License: MIT
|
|
11
|
-
License-File: LICENSE
|
|
12
|
-
Classifier: Development Status :: 3 - Alpha
|
|
13
|
-
Classifier: Intended Audience :: Developers
|
|
14
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
-
Classifier: Programming Language :: Python :: 3
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
-
Requires-Python: >=3.10
|
|
21
|
-
Requires-Dist: certifi>=2024.2.2
|
|
22
|
-
Requires-Dist: click>=8.2
|
|
23
|
-
Requires-Dist: keyring>=24.0
|
|
24
|
-
Requires-Dist: typer>=0.13
|
|
25
|
-
Provides-Extra: test
|
|
26
|
-
Requires-Dist: coverage; extra == 'test'
|
|
27
|
-
Requires-Dist: ipdb; extra == 'test'
|
|
28
|
-
Requires-Dist: pre-commit; extra == 'test'
|
|
29
|
-
Requires-Dist: pytest; extra == 'test'
|
|
30
|
-
Requires-Dist: ruff; extra == 'test'
|
|
31
|
-
Requires-Dist: ty; extra == 'test'
|
|
32
|
-
Provides-Extra: tui
|
|
33
|
-
Requires-Dist: textual>=8.2; extra == 'tui'
|
|
34
|
-
Description-Content-Type: text/markdown
|
|
35
|
-
|
|
36
1
|
# fruxon
|
|
37
2
|
|
|
38
3
|
[](https://pypi.org/project/fruxon/)
|
|
39
4
|
[](https://pypi.org/project/fruxon/)
|
|
40
|
-
[](https://
|
|
5
|
+
[](https://pypi.org/project/fruxon/)
|
|
41
6
|
|
|
42
7
|
Run, build, and orchestrate AI agents from your terminal — the official Python SDK and CLI for the [Fruxon](https://fruxon.com) platform.
|
|
43
8
|
|
|
@@ -77,6 +42,7 @@ Top-level discovery commands — useful whether you're a human or an AI agent dr
|
|
|
77
42
|
| `fruxon completion {bash\|zsh\|fish}` | Print a shell-completion script. `eval "$(fruxon completion zsh)"` to install. |
|
|
78
43
|
| `fruxon guides list / show <id>` | Bundled CLI playbooks. Start with `fruxon-meet`; `fruxon-agent-mode` covers the exit codes, error envelope, and output shapes a program driving the CLI relies on. |
|
|
79
44
|
| `fruxon doctor` | Diagnose local setup (interpreter, SDK version, credentials, API reachability, auth). |
|
|
45
|
+
| `fruxon feedback "<what happened>"` | Report a problem (or an idea) to Fruxon support. Attaches the last failed command and its request id; you see it all and confirm first. `--crash-log <file>` sends a crash log, `--dry-run` shows the body without sending. |
|
|
80
46
|
|
|
81
47
|
Auth:
|
|
82
48
|
|
|
@@ -101,12 +67,14 @@ Execution:
|
|
|
101
67
|
| `fruxon agents approvals list/get/respond/cancel <agent>` | Operate human-in-the-loop approval gates — see what a run is blocked on and answer it. `respond`/`cancel` confirm first and refuse without `--yes` in agent mode (an LLM must not silently auto-approve). |
|
|
102
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). |
|
|
103
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. |
|
|
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. |
|
|
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 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`. |
|
|
105
73
|
| `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. |
|
|
106
|
-
| `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 (`stream
|
|
74
|
+
| `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`. |
|
|
107
75
|
| `fruxon agents voice-calls list/get <agent>` | Read back the Test lab's Talk calls. `list` gives calls newest first (status, end reason, turns, length). `get <agent> <call-id>` gives the call turn by turn: the caller's transcript, the reply, what was heard of it (`delivery`; `spokenText` when the caller cut in), and each reply's `executionRecordId` for `agents executions trace`. Read-only; needs `executions:read`. |
|
|
108
|
-
| `fruxon agents sandbox fork <agent> <message-id>` | Fork a real conversation at a transcript row (an `id` from `agents topics messages`) into a sandbox session already holding the history the agent had when it produced that reply. `--send` re-sends the customer's message against it — with `--draft` to test an edit before publishing — and holds writes for approval unless `--no-confirm-writes`. |
|
|
109
|
-
| `fruxon agents sandbox test <file-or-dir>` | Run scenario-based e2e tests of an agent's network behavior. A scenario (YAML/JSON) declares `steps` (turns / trigger fires), `responders` (scripted consult/approval answers), and `expect` assertions (reply / routing / tools called or refused / no-leak / outcome); the runner drives a sandbox session and returns one verdict — exit 0 (pass) / 1 (fail) / 12 (bad file), with `--junit` for CI. An optional `setup` block provisions real resources first — an `asset` (uploaded + ingestion-waited), `participant`, or `agent` — templated as `${asset.catalog.id}` and **torn down afterwards even on failure** (`--keep` to inspect). Assertions are deterministic by default; `reply_judge: {metric, min_score}` adds an opt-in **semantic** check that scores the reply against a tenant eval metric. The thing an agent runs to prove the agent it built works. |
|
|
76
|
+
| `fruxon agents sandbox fork <agent> <message-id>` | Fork a real conversation at a transcript row (an `id` from `agents topics messages`) into a sandbox session already holding the history the agent had when it produced that reply. `--send` re-sends the customer's message against it — with `--draft` to test an edit before publishing, and `--wait` to follow the turn until it ends — and holds writes for approval unless `--no-confirm-writes`. |
|
|
77
|
+
| `fruxon agents sandbox test <file-or-dir>` | Run scenario-based e2e tests of an agent's network behavior. A scenario (YAML/JSON) declares `steps` (turns / trigger fires), `responders` (scripted consult/approval answers), and `expect` assertions (reply / routing / tools called or refused / no-leak / outcome); the runner drives a sandbox session and returns one verdict — exit 0 (pass) / 1 (fail) / 12 (bad file), with `--junit` for CI. An optional `setup` block provisions real resources first — an `asset` (uploaded + ingestion-waited), `participant`, or `agent` — templated as `${asset.catalog.id}` and **torn down afterwards even on failure** (`--keep` to inspect) — or a `seed` step that resets, imports into and/or generates a SIMULATED integration config's sandbox store (not torn down; only sandbox runs read it). Assertions are deterministic by default; `reply_judge: {metric, min_score}` adds an opt-in **semantic** check that scores the reply against a tenant eval metric. The thing an agent runs to prove the agent it built works. |
|
|
110
78
|
|
|
111
79
|
Invoking a *deployed* agent in production goes through the [Python client](#the-python-client) (`FruxonClient.stream` / `execute`), not the CLI.
|
|
112
80
|
|
|
@@ -124,7 +92,7 @@ Agent authoring + management:
|
|
|
124
92
|
| `fruxon agents draft validate <id> [--online]` | Lint a draft body locally (no network): a missing `definition`, slot ids, tool→slot wiring, provider config, misplaced `parametersMetadata`. `--online` also resolves references against the live catalog (unknown/unpublished config, unreal model, bad tool id). `{valid, errors, warnings}` envelope (the same `errors` as `agents validate`); exits 12 on any error. `warnings[]` are advisory wiring gaps (`consult_unwired`, `approver_slot_undeclared`) that never flip `valid` or the exit code. |
|
|
125
93
|
| `fruxon agents draft run <id> --file <def.json> [--restore]` | Run a draft definition against an existing agent without publishing it. A CI gate for agent changes. The body goes into the agent's server draft (what `revisions create` publishes); for a file other than the pulled one, `--restore` puts the previous draft back after the run, `--yes` keeps it. |
|
|
126
94
|
| `fruxon agents draft run <id> --replay <run> [--stages <file>]` | Re-run a real execution of the agent on its draft. A run a ledger stage dispatched is replayed as a stage test — on exactly the data it was handed, under the stage's output contract, with no ledger transition or item change; `--stages` swaps in edited stage definitions (the `set-stages` file). Any other run re-runs with the parameters it was recorded with (`-p` overlays them). |
|
|
127
|
-
| `fruxon agents revisions create/get/deploy` | Mint and deploy immutable revisions. `create --deploy` does both in one step. `get --as-draft` converts a stored revision back into a postable body. |
|
|
95
|
+
| `fruxon agents revisions create/get/deploy` | Mint and deploy immutable revisions. `create --deploy` does both in one step, and skips the deploy when the new revision is already live (an agent's first revision goes live on create). Deploying needs `revisions:deploy` (`fruxon login --preset maintainer`); a 403 says so. `get --as-draft` converts a stored revision back into a postable body. |
|
|
128
96
|
| `fruxon agents revisions list/deploys <id>` | `list` shows revisions newest first (20 unless `--all` or `-n`): number, ★ on the live one, who created it and its comment. After a rollback the ★ is not the top row. `-o json` adds `lastDeployedAt`. Bodies are not listed; `get <id> <n>` fetches one. `deploys` is the deploy history: each attempt, failed ones too, `from → to` with ↩ on a rollback, who made it and why. A backend without the list endpoint gets a warning and the same list built from the older history endpoint. |
|
|
129
97
|
| `fruxon agents slots list/bind/unbind <id>` | An agent's contacts — the humans `notify` / `ask` / `escalate` reach. The definition declares them; the binding says who receives (`--participant`, `--role`, or `--queue`). Declared but unbound means the reach-out dead-ends at run time, so `list` calls that out and `unbind` is `--yes`-gated. `bind --role` warns first when nobody holds the role — advisory, since binding ahead of staffing is legitimate. |
|
|
130
98
|
| `fruxon agents check <id>` | Audit whether a **deployed** agent is wired to run end-to-end, beyond the definition: a deployed revision, an inbound path (bound trigger / channel binding / active entry point), a consult roster if the agent enables consult, declared **and bound** contacts, every bound trigger populating the agent's required params, and that the revision's references resolve. `{overall, checks[]}` (doctor-style); exits non-zero only on a hard fail (no deployed revision) — advisory `warn` rows stay exit 0. |
|
|
@@ -144,12 +112,14 @@ Integrations + tools:
|
|
|
144
112
|
| `fruxon integrations list/get/create/update/verify/open` | Manage external integrations — the connections agents draw tools from. `create`/`update`/`verify` take a `--file` JSON body; `open` opens the dashboard. |
|
|
145
113
|
| `fruxon integrations configs list/get/update/publish` | The per-integration auth/config records. `update --file` patches a config's draft (only the fields sent; `{"egressCountry": ""}` clears an egress pin) and prints it with secrets masked; `publish` makes the draft the revision tool calls resolve, asks first (`--yes` in agent mode), and prints the new revision's `id` and `version`, never the credentials. |
|
|
146
114
|
| `fruxon integrations authorize <integration>` | `connect` for an OAuth integration (Gmail, Google Sheets, Outlook…): creates a config for its OAuth2 method (auto-detected; `--auth-method` to pick, `--scope` for what to ask, `--config-param` for connection settings, `--config <id>` for an existing config) and prints a credential link. A human opens it, signs in to Fruxon and then to the provider, and the account is connected and the config published, ready for a slot to pin. |
|
|
115
|
+
| `fruxon integrations configs create <integration> --simulated` | A config with `sandboxMode: SIMULATED` and no credentials, published in one step: every tool call a sandbox run makes through it is answered from its simulated store. `--file` creates an unpublished draft from a full body instead. |
|
|
116
|
+
| `fruxon integrations configs sandbox status/entities/generate/import/reset/snapshot/restore <integration> <config>` | Read and seed a simulated config's store. `generate --type event --prompt … --count N` has a model write entities (the server snapshots first); `import --file` inserts them as written (`payload` may be an object); `snapshot --name` saves a state (no `--name` lists them), `restore` / `reset` are `--yes`-gated. |
|
|
147
117
|
| `fruxon integrations connect <integration>` | Create a config for an integration and print a **credential link**: a human opens it and signs in to Fruxon, then types the API key, token or password (Stripe, most REST APIs), and the page tests it and publishes the config; or, for an OAuth integration, signs in to the provider (`--scope` picks what they grant) and the account is connected and the config published. The secret never passes through the terminal or an agent driving the CLI. `--config <id>` fills an existing config, `--param name=value` sets a connection setting, `--no-sign-in` mints a link anyone holding it can fill (for a client without a Fruxon login), `--expires-in-hours` 1–720. Needs `integrations:write` (the default login preset); `--no-sign-in` also needs `workspace:write` (Admin or Owner). |
|
|
148
118
|
| `fruxon integrations triggers <integration>` | List the event types an integration can fire an agent on — each descriptor's `id` is the `eventType` a trigger listens for, plus the `payloadFields` (dotted paths) a binding's `parameterMappings` can read. Discovery for wiring an inbound-event trigger without guessing. |
|
|
149
119
|
| `fruxon integrations mcp …` | Inspect and enable the MCP server for an integration. |
|
|
150
120
|
| `fruxon tools list/get/create/update/delete/run` | Manage the tools inside an integration. Integration-scoped. `get` and `run` select the tool with `--tool`; `run` executes it outside any agent — real credentials, real result — with `-p key=value`, and `-c` naming the config that supplies credentials. The tenant list API hides internal `knowledge_base` / `assets` tools; `tools list` recovers them by ID and lists them like any other (`--no-include-internal` for the raw server answer). |
|
|
151
121
|
| `fruxon keys list/mint/revoke/delete/history/scopes` | Audit and revoke scoped tokens. Minting opens the dashboard so the secret never enters the CLI process. |
|
|
152
|
-
| `fruxon llm-providers list/get/models` | Browse LLM providers and models supported at the tenant level. |
|
|
122
|
+
| `fruxon llm-providers list/get/models` | Browse LLM providers and models supported at the tenant level. `list` marks a Fruxon-hosted provider (`fruxon_managed_gemini`) *hosted — no config needed*: an agent on it omits `provider.tenantConfigId`. |
|
|
153
123
|
| `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. |
|
|
154
124
|
| `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`). |
|
|
155
125
|
| `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. |
|
|
@@ -157,7 +127,7 @@ Integrations + tools:
|
|
|
157
127
|
| `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. |
|
|
158
128
|
| `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. |
|
|
159
129
|
| `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. |
|
|
160
|
-
| `fruxon knowledge-bases documents/document/add-document/edit-document/delete-document` | The articles. `--query` matches the title, `--status` narrows to DRAFT / PUBLISHED / ARCHIVED — and `--status DRAFT` is usually the answer to "why can't search see this". `--unpublished` lists only what the next publish changes (new or edited since the last publish, or archived / moved back to draft while agents still get them). `document` prints the Markdown body **unrendered to stdout**: that is the exact text which gets embedded, so it has to be pipeable and byte-faithful. Deleting one leaves the indexed snapshot alone until the base is published again. |
|
|
130
|
+
| `fruxon knowledge-bases documents/document/add-document/edit-document/delete-document` | The articles. `--query` matches the title, `--status` narrows to DRAFT / PUBLISHED / ARCHIVED — and `--status DRAFT` is usually the answer to "why can't search see this". `--unpublished` lists only what the next publish changes (new or edited since the last publish, or archived / moved back to draft while agents still get them). `add-document --markdown <file.md|dir>` adds a Markdown file as an article (title from `--title` or its first `# ` heading; `--status`, `--locale`), or every `.md` in a directory, one article each; `--file` takes the full JSON body. `document` prints the Markdown body **unrendered to stdout**: that is the exact text which gets embedded, so it has to be pipeable and byte-faithful. Deleting one leaves the indexed snapshot alone until the base is published again. |
|
|
161
131
|
| `fruxon knowledge-bases review-queue/revisions/evidence/correct` | `review-queue` carries each draft's newest revision *and the one before it*, so the change is readable without a request per row; a row with no previous revision is a new article, not an edit, and `--order PRIORITY` puts personal-data risks ahead of the routine edits `NEWEST` buries them under; a `Close to:` line names a waiting draft that reads close to the row (the same question drafted twice). `revisions` is the base-wide timeline (or one document's) holding whole bodies rather than diffs, with person, agent and run attribution kept apart. `evidence` returns the source **keys, never the items** — resolving one is the source system's call, so reading an article does not hand you the transcript; an `agent-review:` row names the topic and run it came from and whether the team (`OPERATOR`), a tool or nobody answered it. `correct` runs the base's editor agent over your instruction; it **may decline** (the instruction needs a fact it was not given, or is about a claim the article does not make), which writes nothing and exits non-zero, and correcting a *published* article returns it to DRAFT. |
|
|
162
132
|
| `fruxon knowledge-bases consolidate` → `apply` / `calibrate` | Two steps on purpose. `consolidate` queues a **report** of near-duplicate clusters and writes nothing — a standalone pass can no longer merge as it goes, and the old `--apply` is refused. `apply <kb> <run> --cluster <id>` (or `--all`) merges the clusters you accepted: the report's version rides along as a compare-and-set read off the run itself, and each member is revalidated against the content hash the report recorded, so a cluster whose documents moved comes back STALE and is left **entirely** alone rather than partly merged. It re-runs the base's consolidator agent per cluster, so a base without a deployed one is refused. `calibrate` records what a person reviewed a report under — it applies and publishes nothing, and is what reopens automatic source approval. |
|
|
163
133
|
| `fruxon knowledge-bases source list/get/add/update/plan-update/preview/activity/passes/sync/pause/resume/archive/unarchive/fork/delete` | The pipelines that read a customer's history and write articles. `managementMode` decides **who owns the implementation**, which is what the verbs key on: a LINKED source's resources are yours and survive a `delete`, a MANAGED one's agents, automation and ledger go with it — and `fork` flips managed to linked, keeping the history, one-way. **Stopped is the default**: a built source lands paused and `unarchive` returns one paused, so `resume` and `sync` confirm (they start reading someone's history, and dispatched items cost a run each) while `pause` and `archive` do not. `preview` admits nothing and is deliberately not narrowed by the watermark — a caught-up source would otherwise look broken — and reports **floors, not totals**, once a ceiling stopped the scan. `activity` speaks the ledger's vocabulary, so `ready` is backlog rather than motion, and a missing work ledger is reduced health rather than an error. |
|
|
@@ -245,7 +215,7 @@ When `CLAUDECODE=1`, `CODEX_THREAD_ID` (set by Codex), `CODEX_CI=1`, `CI=1`, or
|
|
|
245
215
|
- **NDJSON streaming.** `fruxon agents draft run` and `fruxon agents tests watch` emit one JSON record per line on stdout (`{"type":"text","delta":"..."}`, `{"type":"tool_call",...}`, `{"type":"done",...}`).
|
|
246
216
|
- **Typed exit codes.** `10` = auth_required, `11` = not_found, `12` = validation, `13` = conflict, `14` = server_error, `15` = network_error, `16` = interactive_required. Match on the number, not on prose.
|
|
247
217
|
- **Structured errors.** Every failure emits a one-line JSON envelope on stderr: `{"error":{"code","message","exit_code","hint"}}`.
|
|
248
|
-
- **Interactive guards.** Any path that would block on stdin (
|
|
218
|
+
- **Interactive guards.** Any path that would block on stdin (`--edit`, missing `--yes`) fails fast with `EXIT_INTERACTIVE_REQUIRED` and a hint naming the bypass flag. `fruxon login` instead prints the approval link and code as a JSON line for the driver to relay to its human, then waits for the approval.
|
|
249
219
|
- **Cold-start manifest.** Bare `fruxon` invocation emits a one-line JSON manifest with next-step commands so an LLM driver learns the surface without `--help` walking.
|
|
250
220
|
|
|
251
221
|
Full contract: `fruxon guides show fruxon-agent-mode`.
|
|
@@ -384,8 +354,17 @@ The stored layer is split:
|
|
|
384
354
|
| `FRUXON_NO_UPDATE_CHECK=1` | Opt out of the "newer version available" notifier. |
|
|
385
355
|
| `FRUXON_SCHEMA_TIMEOUT` | Seconds `--schema` waits on the server for the OpenAPI spec (default `60`). |
|
|
386
356
|
| `FRUXON_SCHEMA_CACHE_TTL` | Seconds a cached OpenAPI spec is reused before `--schema` asks again (default `3600`; `0` asks every time). Cached per host under `<config dir>/cache/openapi/`. |
|
|
357
|
+
| `FRUXON_CORRELATION_ID` | Send this as every request's id instead of a fresh `cli-…` one, to tie a script's commands together in the server's logs. 1–64 letters, digits and hyphens; anything else is ignored. |
|
|
387
358
|
| `NO_COLOR=1` | Standard convention — disables color output. |
|
|
388
359
|
|
|
360
|
+
## When something fails
|
|
361
|
+
|
|
362
|
+
Every request the CLI sends carries a request id (`X-Correlation-ID`, `cli-…`), the same id the server writes on every log line for that request. When the server or the network fails, the CLI prints it under the error (`Request: cli-4bf9…`); in agent mode it's `request_id` in the error envelope.
|
|
363
|
+
|
|
364
|
+
To report it, run `fruxon feedback "what you were doing"`. It sends your message with the last failed command and its request id attached, after showing you everything it will send, and prints a reference like `fb-3f2a91c0`. Replies come to the email on your Fruxon account. After a crash, add `--crash-log <file>` with the file the crash message names. Signed out, or if it can't send, it prints the report for you to email to support@fruxon.com.
|
|
365
|
+
|
|
366
|
+
The last failed command is also kept in `<config dir>/last-failure.json` (`~/.fruxon` by default, readable only by you): the command's name, exit code, the error the CLI printed, HTTP status and request id. Never its arguments or option values. A parse error, Ctrl-C or `| head` closing the pipe doesn't replace it.
|
|
367
|
+
|
|
389
368
|
## Docs
|
|
390
369
|
|
|
391
370
|
- [Installation](docs/installation.md)
|
|
@@ -107,10 +107,16 @@ test = [
|
|
|
107
107
|
"pre-commit", # git hook runner for lint/format on every commit
|
|
108
108
|
]
|
|
109
109
|
|
|
110
|
+
# Shown on PyPI, so every one must open for someone outside the org. The source
|
|
111
|
+
# repository is private: links into it (the issue tracker, HISTORY.md) were a
|
|
112
|
+
# 404 for every reader. HISTORY.md still ships in the sdist.
|
|
113
|
+
#
|
|
114
|
+
# PyPI accepts only http(s) here and rejects the whole upload otherwise: a
|
|
115
|
+
# `mailto:` bugs link failed the 2.2.8 release with a 400. There is no public
|
|
116
|
+
# bug page, so there is no bugs link; the CLI prints the support address itself.
|
|
110
117
|
[project.urls]
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
homepage = "https://github.com/fruxon-ai/fruxon-sdk"
|
|
118
|
+
homepage = "https://fruxon.com"
|
|
119
|
+
documentation = "https://docs.fruxon.com/guides/cli"
|
|
114
120
|
|
|
115
121
|
[project.scripts]
|
|
116
122
|
fruxon = "fruxon.cli:app"
|