mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-16 19:36:54 +00:00
# Conflicts: # apps/desktop/e2e/archived-hidden-session-recoverable.spec.ts # apps/desktop/e2e/bot-chat-message-agent-friendly-name.spec.ts # apps/desktop/e2e/bot-mailbox-unreadable-ticket.spec.ts # apps/desktop/e2e/bot-mode-roster-localized.spec.ts # apps/desktop/e2e/bot-mode-row-click-mirrors-registry.spec.ts # apps/desktop/e2e/bot-mode-tab-shows-bot-name.spec.ts # apps/desktop/e2e/bot-roster-group-row-organisation.spec.ts # apps/desktop/e2e/bot-roster-ignores-infra-dirs.spec.ts # apps/desktop/e2e/bot-roster-timestamp-meta.spec.ts # apps/desktop/e2e/bot-roster-user-sections.spec.ts # apps/desktop/e2e/bot-routines-pane-narrow.spec.ts # apps/desktop/e2e/bot-row-open-recent-session.spec.ts # apps/desktop/e2e/bot-tile-ignores-ambient-composer-model.spec.ts # apps/desktop/e2e/group-composer-auto-grow.spec.ts # apps/desktop/e2e/group-create-gate-remote-roster.spec.ts # apps/desktop/e2e/group-prompt-renamed-primary-handle.spec.ts # apps/desktop/e2e/hosted-room-backend-continuity.spec.ts # apps/desktop/e2e/hosted-room-legacy-store-migration.spec.ts # apps/desktop/e2e/settings-scope-chips-bot-title.spec.ts # apps/desktop/e2e/worktree-branch-status.spec.ts # apps/desktop/electron/backend-probes.test.ts # apps/desktop/electron/connection-apply.test.ts # apps/desktop/electron/desktop-electron-pin.test.ts # apps/desktop/electron/desktop-uninstall.test.ts # apps/desktop/electron/gateway-file-download-transport.test.ts # apps/desktop/electron/gateway-stop-before-update.test.ts # apps/desktop/electron/github-api-auth.test.ts # apps/desktop/electron/registry-primary-profile-scope.test.ts # apps/desktop/electron/update-api-check.test.ts # apps/desktop/electron/update-handoff-marker.test.ts # apps/desktop/electron/venv-blocker-scan.test.ts # apps/desktop/scripts/after-extract.test.mjs # apps/desktop/scripts/local-pack-publish.test.mjs # apps/desktop/scripts/tasks-scroll.test.mjs # apps/desktop/src/app/settings/model-settings.test.tsx # apps/desktop/src/app/updates-overlay.blockers.test.tsx # apps/desktop/src/components/desktop-install-overlay.test.tsx # apps/desktop/src/lib/update-copy.test.ts # scripts/ci/check_os_marker_fakes.py # tests-js/desktop-mac-usage-descriptions.test.ts # tests-js/node-engine-alignment.test.ts # tests/agent/lsp/test_install_and_lint_fixes.py # tests/agent/test_command_token_source.py # tests/agent/test_compression_boundary_hook.py # tests/agent/test_create_openai_client_ssl_verify.py # tests/agent/test_custom_provider_ca_probes.py # tests/agent/test_endpoint_blackhole.py # tests/agent/test_estimator_parity.py # tests/agent/test_in_place_compaction.py # tests/agent/test_moa_loop_mode.py # tests/agent/test_model_metadata.py # tests/agent/test_skill_session_platform_gate.py # tests/agent/test_skill_utils.py # tests/agent/test_ssl_ca_guard.py # tests/computer_use/test_doctor.py # tests/cron/test_codex_execution_paths.py # tests/cron/test_cron_bot_chat_delivery.py # tests/cron/test_cron_script.py # tests/cron/test_media_delivery_parity.py # tests/cron/test_misfire_catchup.py # tests/cron/test_parallel_pool.py # tests/cron/test_recurring_eagain_redispatch.py # tests/gateway/test_choice_picker.py # tests/gateway/test_control_socket_windows_live.py # tests/gateway/test_dingtalk.py # tests/gateway/test_feishu.py # tests/gateway/test_feishu_onboard.py # tests/gateway/test_gateway_shutdown.py # tests/gateway/test_matrix.py # tests/gateway/test_model_command_custom_providers.py # tests/gateway/test_reasoning_command.py # tests/gateway/test_runtime_footer.py # tests/gateway/test_session.py # tests/gateway/test_session_hygiene.py # tests/gateway/test_status.py # tests/gateway/test_teams.py # tests/gateway/test_turn_lease.py # tests/gateway/test_whatsapp_connect.py # tests/hermes_cli/test_approvals_command.py # tests/hermes_cli/test_auth_store_lock_concurrent.py # tests/hermes_cli/test_backup.py # tests/hermes_cli/test_banner_git_state.py # tests/hermes_cli/test_certifi_repair.py # tests/hermes_cli/test_cmd_update.py # tests/hermes_cli/test_compat_manifest_targets.py # tests/hermes_cli/test_computer_use_cli.py # tests/hermes_cli/test_cpr_local_leak.py # tests/hermes_cli/test_dashboard_auth_gate.py # tests/hermes_cli/test_dashboard_procs_kill_grace.py # tests/hermes_cli/test_desktop_lifecycle_windows_live.py # tests/hermes_cli/test_doctor.py # tests/hermes_cli/test_doctor_command_install.py # tests/hermes_cli/test_fleet_config_migration_windows_live.py # tests/hermes_cli/test_gateway.py # tests/hermes_cli/test_gateway_platform_gating.py # tests/hermes_cli/test_gateway_restart_loop.py # tests/hermes_cli/test_gateway_task_probe.py # tests/hermes_cli/test_gateway_wsl.py # tests/hermes_cli/test_gui_command.py # tests/hermes_cli/test_install_cua_driver.py # tests/hermes_cli/test_kanban_db.py # tests/hermes_cli/test_lazy_command_exports.py # tests/hermes_cli/test_lazy_refresh_venv_repair.py # tests/hermes_cli/test_linux_desktop_entry.py # tests/hermes_cli/test_local_runtime.py # tests/hermes_cli/test_local_runtime_updates.py # tests/hermes_cli/test_managed_uv.py # tests/hermes_cli/test_mcp_reload_confirm_gate.py # tests/hermes_cli/test_nous_subscription.py # tests/hermes_cli/test_npm_engine.py # tests/hermes_cli/test_personality_none.py # tests/hermes_cli/test_pet_toggle.py # tests/hermes_cli/test_plan_reconciliation_windows_live.py # tests/hermes_cli/test_plugin_event_bus.py # tests/hermes_cli/test_plugin_manifest_v2.py # tests/hermes_cli/test_plugin_packs.py # tests/hermes_cli/test_plugins_cmd.py # tests/hermes_cli/test_plugins_cmd_enable_disable_nested.py # tests/hermes_cli/test_process_identity.py # tests/hermes_cli/test_profiles.py # tests/hermes_cli/test_profiles_sidebar_cache.py # tests/hermes_cli/test_pty_bridge.py # tests/hermes_cli/test_resolve_turn_limit.py # tests/hermes_cli/test_serve_runtime_inventory.py # tests/hermes_cli/test_session_vacuum_config.py # tests/hermes_cli/test_set_config_value.py # tests/hermes_cli/test_signal_handler_kanban_worker.py # tests/hermes_cli/test_slash_confirm_windows.py # tests/hermes_cli/test_stale_pid_guard.py # tests/hermes_cli/test_startup_fast_guards.py # tests/hermes_cli/test_status.py # tests/hermes_cli/test_telegram_managed_bot.py # tests/hermes_cli/test_tools_config.py # tests/hermes_cli/test_update_apply_shallow_count.py # tests/hermes_cli/test_update_autostash.py # tests/hermes_cli/test_update_concurrent_quarantine.py # tests/hermes_cli/test_update_fetch_failure_classifier.py # tests/hermes_cli/test_update_fleet_probe_resume_token.py # tests/hermes_cli/test_update_handoff_backend_reap.py # tests/hermes_cli/test_update_handoff_desktop_rebuild.py # tests/hermes_cli/test_update_head_moved_gate.py # tests/hermes_cli/test_update_host_obligation.py # tests/hermes_cli/test_update_import_guard.py # tests/hermes_cli/test_update_interrupted_recovery.py # tests/hermes_cli/test_update_inventory.py # tests/hermes_cli/test_update_launchd_unloaded_gateway.py # tests/hermes_cli/test_update_missing_configured_deps.py # tests/hermes_cli/test_update_modified_notice.py # tests/hermes_cli/test_update_multiplex_migration_hook.py # tests/hermes_cli/test_update_no_gateway_restart.py # tests/hermes_cli/test_update_orphan_backend_reap.py # tests/hermes_cli/test_update_parked_branch_guard.py # tests/hermes_cli/test_update_post_pull_syntax_guard.py # tests/hermes_cli/test_update_receipt.py # tests/hermes_cli/test_update_self_lock.py # tests/hermes_cli/test_update_shim_fail_closed.py # tests/hermes_cli/test_update_shim_self_lock.py # tests/hermes_cli/test_update_sqlite_remediation.py # tests/hermes_cli/test_update_stale_dashboard.py # tests/hermes_cli/test_update_stale_virtualenv.py # tests/hermes_cli/test_update_venv_health.py # tests/hermes_cli/test_update_venv_ownership_preflight.py # tests/hermes_cli/test_update_wedged_gateway.py # tests/hermes_cli/test_update_yes_flag.py # tests/hermes_cli/test_update_zip_two_phase.py # tests/hermes_cli/test_urllib_security.py # tests/hermes_cli/test_ux_messages_auth_config.py # tests/hermes_cli/test_ux_messages_startup.py # tests/hermes_cli/test_venv_holder_classifier.py # tests/hermes_cli/test_verify_console_scripts.py # tests/hermes_cli/test_verify_core_dependencies.py # tests/hermes_cli/test_web_server.py # tests/hermes_cli/test_web_server_console_ws.py # tests/hermes_cli/test_web_server_ws_ping.py # tests/hermes_cli/test_web_ui_build.py # tests/hermes_state/test_fts_rebuild_admission.py # tests/hermes_state/test_hermes_state.py # tests/plugins/memory/test_memory_lazy_install.py # tests/plugins/test_google_meet_plugin.py # tests/plugins/test_langfuse_plugin.py # tests/plugins/test_security_guidance_plugin.py # tests/plugins/test_transform_llm_output_hook.py # tests/scripts/desktop_update/test_desktop_update_windows_gateway_flag.py # tests/scripts/desktop_update/test_desktop_update_windows_python_handoff.py # tests/scripts/desktop_update/test_desktop_update_windows_timestamp.py # tests/scripts/install/test_install_clone_throttle_fallback.py # tests/scripts/install/test_install_lockfile_churn.py # tests/scripts/install/test_install_no_initial_commit.py # tests/scripts/install/test_install_sh_browser_install.py # tests/scripts/install/test_install_sh_node_prerelease.py # tests/scripts/install/test_install_sh_symlink_stomp.py # tests/scripts/install/test_install_sh_uv_lock_config.py # tests/scripts/install/test_install_unmerged_index.py # tests/scripts/test_contributor_map.py # tests/scripts/test_run_tests_parallel.py # tests/skills/test_competitor_news_monitor_skill.py # tests/skills/test_document_to_action_items_skill.py # tests/skills/test_google_workspace_setup.py # tests/skills/test_google_workspace_setup_deps.py # tests/skills/test_grounded_citations_skill.py # tests/skills/test_ip_as_logo_skill.py # tests/skills/test_live_dashboard_skill.py # tests/skills/test_mcp_oauth_remote_gateway_skill.py # tests/skills/test_office_document_skills.py # tests/skills/test_openclaw_migration.py # tests/skills/test_product_price_monitor_skill.py # tests/skills/test_scrollcraft_skill.py # tests/skills/test_setup_wizard_generator_skill.py # tests/skills/test_weekly_review_planning_skill.py # tests/test_engines_satisfiable.py # tests/test_fast_safe_load.py # tests/test_hermes_bootstrap.py # tests/test_hermes_constants.py # tests/test_hermes_logging.py # tests/test_managed_runtime_resolution.py # tests/test_model_tools_async_bridge.py # tests/test_packaging_build_guard.py # tests/test_packaging_metadata.py # tests/test_yaml_indent_consistency.py # tests/tools/test_approval_timeout_overflow.py # tests/tools/test_base_environment.py # tests/tools/test_bot_mode_dm.py # tests/tools/test_browser_chromium_check.py # tests/tools/test_browser_hardening.py # tests/tools/test_browser_homebrew_paths.py # tests/tools/test_browser_npx_warmup.py # tests/tools/test_browser_orphan_reaper.py # tests/tools/test_browser_real_profile.py # tests/tools/test_browser_use_cli.py # tests/tools/test_clipboard.py # tests/tools/test_code_execution.py # tests/tools/test_code_execution_modes.py # tests/tools/test_code_execution_windows_env.py # tests/tools/test_computer_use.py # tests/tools/test_delegate_liveness_timeout.py # tests/tools/test_execute_code_approval_cluster.py # tests/tools/test_execution_flag_detection.py # tests/tools/test_fal_common.py # tests/tools/test_file_operations.py # tests/tools/test_file_tools.py # tests/tools/test_file_tools_cwd_resolution.py # tests/tools/test_file_tools_live.py # tests/tools/test_lazy_deps.py # tests/tools/test_lazy_deps_durable_target.py # tests/tools/test_lazy_deps_managed.py # tests/tools/test_local_env_blocklist.py # tests/tools/test_local_tempdir.py # tests/tools/test_macos_protected_search.py # tests/tools/test_mcp_npx_cached_bin.py # tests/tools/test_oneshot_completion_linger.py # tests/tools/test_process_registry.py # tests/tools/test_read_file_schema_gating.py # tests/tools/test_skill_improvements.py # tests/tools/test_skills_sync.py # tests/tools/test_termux_api_detection.py # tests/tools/test_tirith_security.py # tests/tools/test_transcription_tools.py # tests/tools/test_tts_streaming.py # tests/tools/test_wake_word.py # tests/tui_gateway/test_compute_host_borrowed_lease.py # tests/tui_gateway/test_compute_host_turn_protocol.py # tests/tui_gateway/test_isolated_orphan_activity.py # tests/tui_gateway/test_protocol.py # tests/tui_gateway/test_slash_worker_profile_home.py # tests/tui_gateway/test_subprocess_encoding.py # tests/tui_gateway/test_tui_gateway_server.py # ui-tui/src/__tests__/terminalParity.test.ts # ui-tui/src/__tests__/termuxComposerLayout.test.ts # ui-tui/src/__tests__/textInputFastEcho.test.ts
657 lines
26 KiB
Python
657 lines
26 KiB
Python
#!/usr/bin/env python3
|
|
"""Tests for Krea image generation provider."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
from unittest.mock import MagicMock, patch
|
|
|
|
import pytest
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Fixtures
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
@pytest.fixture(autouse=True)
|
|
def _fake_api_key(monkeypatch):
|
|
"""Ensure KREA_API_KEY is set for all tests."""
|
|
monkeypatch.setenv("KREA_API_KEY", "test-key-12345")
|
|
|
|
|
|
def _completed_job(url: str = "https://krea.cdn/img.png") -> dict:
|
|
return {
|
|
"job_id": "00000000-0000-0000-0000-000000000abc",
|
|
"status": "completed",
|
|
"created_at": "2026-05-27T00:00:00Z",
|
|
"completed_at": "2026-05-27T00:00:30Z",
|
|
"result": {"urls": [url]},
|
|
}
|
|
|
|
|
|
def _submit_response(job_id: str = "00000000-0000-0000-0000-000000000abc"):
|
|
resp = MagicMock()
|
|
resp.status_code = 200
|
|
resp.raise_for_status = MagicMock()
|
|
resp.json.return_value = {
|
|
"job_id": job_id,
|
|
"status": "queued",
|
|
"created_at": "2026-05-27T00:00:00Z",
|
|
"completed_at": None,
|
|
"result": None,
|
|
}
|
|
return resp
|
|
|
|
|
|
def _poll_response(body: dict):
|
|
resp = MagicMock()
|
|
resp.status_code = 200
|
|
resp.raise_for_status = MagicMock()
|
|
resp.json.return_value = body
|
|
return resp
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Provider class tests
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
class TestKreaImageGenProvider:
|
|
|
|
|
|
def test_is_available_with_key(self, monkeypatch):
|
|
monkeypatch.setenv("KREA_API_KEY", "sk-test")
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
assert KreaImageGenProvider().is_available() is True
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Model resolution
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
class TestModelResolution:
|
|
|
|
def test_env_override_large(self, monkeypatch):
|
|
monkeypatch.setenv("KREA_IMAGE_MODEL", "krea-2-large")
|
|
from plugins.image_gen.krea import _resolve_model
|
|
|
|
model_id, meta = _resolve_model()
|
|
assert model_id == "krea-2-large"
|
|
assert meta["path"] == "large"
|
|
|
|
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Generate — main flow
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
class TestGenerate:
|
|
def test_missing_api_key(self, monkeypatch):
|
|
monkeypatch.delenv("KREA_API_KEY", raising=False)
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
assert result["success"] is False
|
|
assert "KREA_API_KEY" in result["error"]
|
|
assert result["error_type"] == "auth_required"
|
|
|
|
def test_empty_prompt(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
result = KreaImageGenProvider().generate(prompt=" ")
|
|
assert result["success"] is False
|
|
assert result["error_type"] == "invalid_argument"
|
|
|
|
def test_successful_generation(self):
|
|
"""Happy path: submit → one poll → completed → URL downloaded."""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job("https://krea.cdn/result.png"))
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll) as mock_get, \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/krea_krea-2-medium_test.png"),
|
|
) as mock_save, \
|
|
patch("plugins.image_gen.krea.time.sleep"): # skip real waits
|
|
result = KreaImageGenProvider().generate(prompt="A cinematic lamp", upscale=False)
|
|
|
|
assert result["success"] is True
|
|
assert result["image"] == str(Path("/tmp/krea_krea-2-medium_test.png"))
|
|
assert result["provider"] == "krea"
|
|
assert result["model"] == "krea-2-medium"
|
|
assert result["aspect_ratio"] == "landscape"
|
|
assert result["job_id"] == "00000000-0000-0000-0000-000000000abc"
|
|
assert result["resolution"] == "1K"
|
|
assert result["creativity"] == "medium"
|
|
# Submit hit the medium endpoint
|
|
post_url = mock_post.call_args[0][0]
|
|
assert post_url.endswith("/generate/image/krea/krea-2/medium")
|
|
# Poll hit /jobs/{job_id}
|
|
poll_url = mock_get.call_args[0][0]
|
|
assert "/jobs/00000000-0000-0000-0000-000000000abc" in poll_url
|
|
# URL was materialised once
|
|
mock_save.assert_called_once()
|
|
|
|
def test_large_model_routes_to_large_endpoint(self, monkeypatch):
|
|
monkeypatch.setenv("KREA_IMAGE_MODEL", "krea-2-large")
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
KreaImageGenProvider().generate(prompt="test")
|
|
|
|
post_url = mock_post.call_args[0][0]
|
|
assert post_url.endswith("/generate/image/krea/krea-2/large")
|
|
|
|
def test_aspect_ratio_mapping(self):
|
|
"""Hermes 'square' must map to Krea '1:1' in the wire payload."""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
KreaImageGenProvider().generate(prompt="test", aspect_ratio="square", upscale=False)
|
|
|
|
payload = mock_post.call_args.kwargs["json"]
|
|
assert payload["aspect_ratio"] == "1:1"
|
|
assert payload["resolution"] == "1K"
|
|
|
|
def test_auth_header(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
KreaImageGenProvider().generate(prompt="test")
|
|
|
|
headers = mock_post.call_args.kwargs["headers"]
|
|
assert headers["Authorization"] == "Bearer test-key-12345"
|
|
assert headers["Content-Type"] == "application/json"
|
|
|
|
def test_passthrough_seed_styles_moodboards(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
KreaImageGenProvider().generate(
|
|
prompt="test",
|
|
seed=42,
|
|
styles=[{"id": "lora-1", "strength": 0.7}],
|
|
moodboards=[{"url": "https://x.com/mood.png"}, {"url": "https://x.com/mood2.png"}],
|
|
image_style_references=[{"url": f"https://x.com/{i}.png"} for i in range(15)],
|
|
creativity="high",
|
|
upscale=False,
|
|
)
|
|
|
|
payload = mock_post.call_args.kwargs["json"]
|
|
assert payload["seed"] == 42
|
|
assert payload["styles"] == [{"id": "lora-1", "strength": 0.7}]
|
|
assert len(payload["moodboards"]) == 1 # capped at 1
|
|
assert len(payload["image_style_references"]) == 10 # capped at 10
|
|
assert payload["creativity"] == "high"
|
|
|
|
def test_string_style_references_converted_to_objects(self):
|
|
"""Krea requires {url, strength} objects; bare URL strings must be
|
|
converted (a string yields a 422 'Expected object, received string')."""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
KreaImageGenProvider().generate(
|
|
prompt="test",
|
|
image_style_references=[
|
|
"https://x.com/a.png",
|
|
{"url": "https://x.com/b.png", "strength": 1.2},
|
|
],
|
|
upscale=False,
|
|
)
|
|
|
|
payload = mock_post.call_args.kwargs["json"]
|
|
assert payload["image_style_references"] == [
|
|
{"url": "https://x.com/a.png", "strength": 0.6},
|
|
{"url": "https://x.com/b.png", "strength": 1.2},
|
|
]
|
|
|
|
def test_unknown_kwargs_ignored(self):
|
|
"""Forward-compat: unknown kwargs must not break generate()."""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit), \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(
|
|
prompt="test",
|
|
fictional_param="should be ignored",
|
|
num_images=4,
|
|
)
|
|
|
|
assert result["success"] is True
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Generate — error paths
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
class TestGenerateErrors:
|
|
def test_submit_http_error(self):
|
|
import requests as req_lib
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
resp = req_lib.Response()
|
|
resp.status_code = 401
|
|
resp._content = b'{"error": {"message": "Invalid API key"}}'
|
|
resp.headers["Content-Type"] = "application/json"
|
|
resp.raise_for_status = MagicMock(
|
|
side_effect=req_lib.HTTPError(response=resp)
|
|
)
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=resp):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is False
|
|
assert result["error_type"] == "api_error"
|
|
assert "401" in result["error"]
|
|
assert "Invalid API key" in result["error"]
|
|
|
|
|
|
def test_job_failed(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
failed = {
|
|
"job_id": "abc",
|
|
"status": "failed",
|
|
"completed_at": "2026-05-27T00:01:00Z",
|
|
"result": {"error": "NSFW content"},
|
|
}
|
|
|
|
submit = _submit_response()
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit), \
|
|
patch(
|
|
"plugins.image_gen.krea.requests.get",
|
|
return_value=_poll_response(failed),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is False
|
|
assert result["error_type"] == "api_error"
|
|
assert "NSFW" in result["error"]
|
|
|
|
|
|
def test_completed_but_missing_urls(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
completed_empty = {
|
|
"job_id": "abc",
|
|
"status": "completed",
|
|
"completed_at": "2026-05-27T00:01:00Z",
|
|
"result": {"urls": []},
|
|
}
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=_submit_response()), \
|
|
patch(
|
|
"plugins.image_gen.krea.requests.get",
|
|
return_value=_poll_response(completed_empty),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is False
|
|
assert result["error_type"] == "empty_response"
|
|
|
|
def test_url_download_failure_falls_back_to_bare_url(self):
|
|
"""Mirror of xAI behaviour — if local cache fails, return the URL."""
|
|
import requests as req_lib
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
url = "https://krea.cdn/expired-soon.png"
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job(url))
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit), \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
side_effect=req_lib.HTTPError("404"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is True
|
|
assert result["image"] == url
|
|
|
|
def test_polling_picks_up_completed_at_with_unknown_status(self):
|
|
"""``completed_at`` set + unrecognised pending status → still terminal."""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
# Use a status value that is NOT in our terminal set ("intermediate-complete")
|
|
# but with completed_at populated — Krea's spec says completed_at is the
|
|
# canonical terminal marker.
|
|
oddball = {
|
|
"job_id": "abc",
|
|
"status": "intermediate-complete",
|
|
"completed_at": "2026-05-27T00:01:00Z",
|
|
"result": {"urls": ["https://krea.cdn/done.png"]},
|
|
}
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=_submit_response()), \
|
|
patch(
|
|
"plugins.image_gen.krea.requests.get",
|
|
return_value=_poll_response(oddball),
|
|
), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is True
|
|
|
|
|
|
class TestPollRetryPolicy:
|
|
"""Polling fail-fast on permanent 4xx, retry on transient 5xx/429."""
|
|
|
|
def _http_error_response(self, status: int):
|
|
import requests as req_lib
|
|
|
|
resp = req_lib.Response()
|
|
resp.status_code = status
|
|
resp._content = b'{"error": "boom"}'
|
|
resp.headers["Content-Type"] = "application/json"
|
|
resp.raise_for_status = MagicMock(
|
|
side_effect=req_lib.HTTPError(response=resp)
|
|
)
|
|
return resp
|
|
|
|
def test_poll_fails_fast_on_401(self):
|
|
"""Auth failure mid-poll should not wait the 180s deadline."""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
bad_poll = self._http_error_response(401)
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=_submit_response()), \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=bad_poll) as mock_get, \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is False
|
|
assert result["error_type"] == "api_error"
|
|
assert "401" in result["error"]
|
|
# One call — no retry on permanent auth failure.
|
|
assert mock_get.call_count == 1
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Managed Nous gateway path
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
def _managed_cfg(
|
|
origin: str = "https://krea-gateway.example.com",
|
|
token: str = "nous-tok-abc",
|
|
):
|
|
from types import SimpleNamespace
|
|
|
|
return SimpleNamespace(
|
|
vendor="krea",
|
|
gateway_origin=origin,
|
|
nous_user_token=token,
|
|
managed_mode=True,
|
|
)
|
|
|
|
|
|
class TestManagedGateway:
|
|
def test_managed_submit_uses_gateway_origin_and_nous_token(self, monkeypatch):
|
|
"""Managed mode submits to the gateway origin with the Nous token."""
|
|
import plugins.image_gen.krea as krea_mod
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
# Even with a direct key present, an active managed gateway wins.
|
|
monkeypatch.setattr(krea_mod, "_resolve_managed_krea_gateway", lambda: _managed_cfg())
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll) as mock_get, \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="A managed lamp", upscale=False)
|
|
|
|
assert result["success"] is True
|
|
post_url = mock_post.call_args[0][0]
|
|
assert post_url == (
|
|
"https://krea-gateway.example.com/generate/image/krea/krea-2/medium"
|
|
)
|
|
headers = mock_post.call_args.kwargs["headers"]
|
|
assert headers["Authorization"] == "Bearer nous-tok-abc"
|
|
# Idempotency key drives the gateway's per-generation billing boundary.
|
|
assert headers["x-idempotency-key"]
|
|
# Poll is bound to the same gateway + Nous token.
|
|
poll_url = mock_get.call_args[0][0]
|
|
assert poll_url.startswith("https://krea-gateway.example.com/jobs/")
|
|
poll_headers = mock_get.call_args.kwargs["headers"]
|
|
assert poll_headers["Authorization"] == "Bearer nous-tok-abc"
|
|
|
|
|
|
def test_managed_429_concurrency_hint(self, monkeypatch):
|
|
import requests as req_lib
|
|
import plugins.image_gen.krea as krea_mod
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
monkeypatch.setattr(krea_mod, "_resolve_managed_krea_gateway", lambda: _managed_cfg())
|
|
|
|
resp = req_lib.Response()
|
|
resp.status_code = 429
|
|
resp._content = b'{"error": {"message": "maximum number of concurrent jobs"}}'
|
|
resp.headers["Content-Type"] = "application/json"
|
|
resp.raise_for_status = MagicMock(side_effect=req_lib.HTTPError(response=resp))
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=resp):
|
|
result = KreaImageGenProvider().generate(prompt="test")
|
|
|
|
assert result["success"] is False
|
|
assert "429" in result["error"]
|
|
assert "concurrency" in result["error"].lower()
|
|
|
|
|
|
class TestExplicitModelOverride:
|
|
def test_model_kwarg_overrides_config(self, monkeypatch):
|
|
"""An explicit ``model`` kwarg (managed routing) wins over config/default."""
|
|
from plugins.image_gen.krea import _resolve_model
|
|
|
|
model_id, meta = _resolve_model("krea-2-large")
|
|
assert model_id == "krea-2-large"
|
|
assert meta["path"] == "large"
|
|
|
|
def test_turbo_routes_to_medium_turbo_endpoint(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
submit = _submit_response()
|
|
poll = _poll_response(_completed_job())
|
|
with patch("plugins.image_gen.krea.requests.post", return_value=submit) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", return_value=poll), \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
return_value=Path("/tmp/x.png"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(prompt="test", model="krea-2-medium-turbo", upscale=False)
|
|
|
|
assert result["success"] is True
|
|
assert result["model"] == "krea-2-medium-turbo"
|
|
post_url = mock_post.call_args[0][0]
|
|
assert post_url.endswith("/generate/image/krea/krea-2/medium-turbo")
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Upscale pass (Krea Enhance)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
class TestUpscalePass:
|
|
def _run_generate(self, *, upscale, enhance_job, model=None):
|
|
"""Drive generate() with sequenced post/get mocks.
|
|
|
|
Sequence: generation submit POST → generation poll GET; then (when
|
|
upscale fires) enhance submit POST → enhance poll GET.
|
|
"""
|
|
from plugins.image_gen.krea import KreaImageGenProvider
|
|
|
|
gen_submit = _submit_response()
|
|
gen_poll = _poll_response(_completed_job("https://krea.cdn/native.png"))
|
|
enh_submit = _submit_response("00000000-0000-0000-0000-00000000e0e0")
|
|
enh_poll = _poll_response(enhance_job) if enhance_job else None
|
|
|
|
posts = [gen_submit, enh_submit]
|
|
gets = [gen_poll] + ([enh_poll] if enh_poll else [])
|
|
|
|
kwargs = {"prompt": "a lamp", "upscale": upscale}
|
|
if model is not None:
|
|
kwargs["model"] = model
|
|
|
|
with patch("plugins.image_gen.krea.requests.post", side_effect=posts) as mock_post, \
|
|
patch("plugins.image_gen.krea.requests.get", side_effect=gets) as mock_get, \
|
|
patch(
|
|
"plugins.image_gen.krea.save_url_image",
|
|
side_effect=lambda url, prefix: Path(f"/tmp/{url.rsplit('/', 1)[-1]}"),
|
|
), \
|
|
patch("plugins.image_gen.krea.time.sleep"):
|
|
result = KreaImageGenProvider().generate(**kwargs)
|
|
return result, mock_post, mock_get
|
|
|
|
def test_upscale_routes_through_enhance_endpoint(self):
|
|
enhance_job = {
|
|
"job_id": "00000000-0000-0000-0000-00000000e0e0",
|
|
"status": "completed",
|
|
"created_at": "2026-05-27T00:00:00Z",
|
|
"completed_at": "2026-05-27T00:01:00Z",
|
|
"result": {"urls": ["https://krea.cdn/enhanced.png"]},
|
|
}
|
|
result, mock_post, _ = self._run_generate(upscale=True, enhance_job=enhance_job)
|
|
|
|
assert result["success"] is True
|
|
assert result["upscaled"] is True
|
|
assert result["upscale_factor"] == 2
|
|
assert result["image"].endswith("enhanced.png")
|
|
# Second POST hit the Enhance endpoint with the native image + factor.
|
|
assert mock_post.call_count == 2
|
|
enh_url = mock_post.call_args_list[1][0][0]
|
|
assert enh_url.endswith("/generate/enhance/krea/enhance")
|
|
enh_payload = mock_post.call_args_list[1].kwargs["json"]
|
|
assert enh_payload["image_url"] == "https://krea.cdn/native.png"
|
|
assert enh_payload["image_scaling_factor"] == 2
|
|
assert enh_payload["prompt"] == "a lamp"
|
|
|
|
def test_upscale_failure_falls_back_to_native(self):
|
|
failed_job = {
|
|
"job_id": "00000000-0000-0000-0000-00000000e0e0",
|
|
"status": "failed",
|
|
"created_at": "2026-05-27T00:00:00Z",
|
|
"completed_at": "2026-05-27T00:01:00Z",
|
|
"result": None,
|
|
}
|
|
result, mock_post, _ = self._run_generate(upscale=True, enhance_job=failed_job)
|
|
|
|
assert result["success"] is True
|
|
assert result["upscaled"] is False
|
|
assert result["image"].endswith("native.png")
|
|
assert mock_post.call_count == 2 # enhance attempted, fell back
|
|
|
|
def test_medium_skips_upscale_by_default(self):
|
|
"""Upscaling is opt-in only (Aug 2026 policy) — even for
|
|
krea-2-medium's 1.5K native output, no automatic Enhance pass."""
|
|
result, mock_post, _ = self._run_generate(upscale=None, enhance_job=None)
|
|
|
|
assert result["success"] is True
|
|
assert result["upscaled"] is False
|
|
assert result["image"].endswith("native.png")
|
|
assert mock_post.call_count == 1 # only the generation submit
|
|
|
|
|
|
def test_explicit_false_disables_default(self):
|
|
"""Explicit upscale=False matches the off default."""
|
|
result, mock_post, _ = self._run_generate(upscale=False, enhance_job=None)
|
|
|
|
assert result["success"] is True
|
|
assert result["upscaled"] is False
|
|
assert result["image"].endswith("native.png")
|
|
assert mock_post.call_count == 1
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Registration
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
class TestRegistration:
|
|
def test_register(self):
|
|
from plugins.image_gen.krea import KreaImageGenProvider, register
|
|
|
|
mock_ctx = MagicMock()
|
|
register(mock_ctx)
|
|
mock_ctx.register_image_gen_provider.assert_called_once()
|
|
provider = mock_ctx.register_image_gen_provider.call_args[0][0]
|
|
assert isinstance(provider, KreaImageGenProvider)
|
|
assert provider.name == "krea"
|