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