test(examples): consolidate local plugin install smoke test

Co-authored-by: openhands <openhands@all-hands.dev>

Author: openhands-agent

.pr/local_plugin_install_test/README.md

@@ -13,8 +13,11 @@ plugin utilities end-to-end in this PR.
 
 ## How to (re)generate
 
+This reuses the committed example script, but writes artifacts into `.pr/` via an env var:
+
 ```bash
-uv run python .pr/local_plugin_install_test/run_test.py
+OPENHANDS_EXAMPLE_ARTIFACT_DIR=.pr/local_plugin_install_test \
+  uv run python examples/05_skills_and_plugins/03_local_plugin_install/main.py
 ```
 
 ## Artifacts

.pr/local_plugin_install_test/console_log.md

@@ -2,12 +2,12 @@
   "plugins": {
     "local-plugin": {
       "name": "local-plugin",
-      "version": "1.0.0",
-      "description": "Example local plugin (PR smoke test)",
+      "version": "1.0.1",
+      "description": "Example local plugin",
       "source": "/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/plugin_src/local-plugin",
       "resolved_ref": null,
       "repo_path": null,
-      "installed_at": "2026-03-01T23:48:36.175328+00:00",
+      "installed_at": "2026-03-02T00:17:35.569316+00:00",
       "install_path": "/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin"
     }
   }

.pr/local_plugin_install_test/console_output.txt

@@ -1 +1 @@
-{"name": "local-plugin", "version": "1.0.0", "description": "Example local plugin (PR smoke test)"}
+{"name": "local-plugin", "version": "1.0.1", "description": "Example local plugin"}

.pr/local_plugin_install_test/installed_root/plugins/installed/.installed.json

@@ -1 +1 @@
-{"id":"00000000-0000-0000-0000-000000000203","agent":{"llm":{"model":"test-model","openrouter_site_url":"https://docs.all-hands.dev/","openrouter_app_name":"OpenHands","num_retries":5,"retry_multiplier":8.0,"retry_min_wait":8,"retry_max_wait":64,"timeout":300,"max_message_chars":30000,"temperature":0.0,"top_p":1.0,"stream":false,"drop_params":true,"modify_params":true,"disable_stop_word":false,"caching_prompt":true,"log_completions":false,"log_completions_folder":"logs/completions","native_tool_calling":true,"reasoning_effort":"high","enable_encrypted_reasoning":true,"prompt_cache_retention":"24h","extended_thinking_budget":200000,"usage_id":"test-llm","litellm_extra_body":{}},"tools":[],"mcp_config":{},"include_default_tools":["FinishTool","ThinkTool"],"agent_context":{"skills":[{"name":"hello","content":"Reply with a short greeting.","trigger":{"type":"keyword","keywords":["hello"]},"source":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/skills/hello/SKILL.md","inputs":[],"is_agentskills_format":true,"description":"Say hello","resources":{"skill_root":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/skills/hello","scripts":[],"references":[],"assets":[]}}],"load_user_skills":false,"load_public_skills":false,"current_datetime":"2026-03-01T23:48:36.177747"},"system_prompt_filename":"system_prompt.j2","security_policy_filename":"security_policy.j2","system_prompt_kwargs":{"llm_security_analyzer":true},"kind":"Agent"},"workspace":{"working_dir":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test","kind":"LocalWorkspace"},"persistence_dir":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/persistence/00000000000000000000000000000203","max_iterations":500,"stuck_detection":true,"execution_status":"finished","confirmation_policy":{"kind":"NeverConfirm"},"activated_knowledge_skills":["hello"],"blocked_actions":{},"blocked_messages":{},"last_user_message_id":"85bf1352-5287-4e0f-bce2-83575ae0a76d","stats":{"usage_to_metrics":{}},"secret_registry":{"secret_sources":{}},"agent_state":{}}
+{"id":"00000000-0000-0000-0000-000000000203","agent":{"llm":{"model":"test-model","openrouter_site_url":"https://docs.all-hands.dev/","openrouter_app_name":"OpenHands","num_retries":5,"retry_multiplier":8.0,"retry_min_wait":8,"retry_max_wait":64,"timeout":300,"max_message_chars":30000,"temperature":0.0,"top_p":1.0,"stream":false,"drop_params":true,"modify_params":true,"disable_stop_word":false,"caching_prompt":true,"log_completions":false,"log_completions_folder":"logs/completions","native_tool_calling":true,"reasoning_effort":"high","enable_encrypted_reasoning":true,"prompt_cache_retention":"24h","extended_thinking_budget":200000,"usage_id":"test-llm","litellm_extra_body":{}},"tools":[],"mcp_config":{},"include_default_tools":["FinishTool","ThinkTool"],"agent_context":{"skills":[{"name":"hello","content":"Reply with a short greeting.","trigger":{"type":"keyword","keywords":["hello"]},"source":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/skills/hello/SKILL.md","inputs":[],"is_agentskills_format":true,"description":"Say hello","resources":{"skill_root":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/skills/hello","scripts":[],"references":[],"assets":[]}}],"load_user_skills":false,"load_public_skills":false,"current_datetime":"2026-03-02T00:17:35.557058"},"system_prompt_filename":"system_prompt.j2","security_policy_filename":"security_policy.j2","system_prompt_kwargs":{"llm_security_analyzer":true},"kind":"Agent"},"workspace":{"working_dir":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test","kind":"LocalWorkspace"},"persistence_dir":"/workspace/project/software-agent-sdk/.pr/local_plugin_install_test/persistence/00000000000000000000000000000203","max_iterations":500,"stuck_detection":true,"execution_status":"finished","confirmation_policy":{"kind":"NeverConfirm"},"activated_knowledge_skills":["hello"],"blocked_actions":{},"blocked_messages":{},"last_user_message_id":"2ad1aaa6-170e-48c7-8728-a1f1a34ac324","stats":{"usage_to_metrics":{}},"secret_registry":{"secret_sources":{}},"agent_state":{}}

.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/.plugin/plugin.json

@@ -1 +1 @@
-{"id":"b2b9c917-be6f-4641-a8e8-128d830f1979","timestamp":"2026-03-01T23:47:39.538841","source":"user","llm_message":{"role":"user","content":[{"cache_prompt":false,"type":"text","text":"hello"}],"thinking_blocks":[]},"activated_skills":["hello"],"extended_content":[{"cache_prompt":false,"type":"text","text":"<EXTRA_INFO>\nThe following information has been included based on a keyword match for \"hello\".\nIt may or may not be relevant to the user's request.\n\nSkill location: /workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/skills/hello/SKILL.md\n(Use this path to resolve relative file references in the skill content below)\n\n\nReply with a short greeting.\n</EXTRA_INFO>"}],"kind":"MessageEvent"}
+{"id":"2ad1aaa6-170e-48c7-8728-a1f1a34ac324","timestamp":"2026-03-02T00:17:35.560410","source":"user","llm_message":{"role":"user","content":[{"cache_prompt":false,"type":"text","text":"hello"}],"thinking_blocks":[]},"activated_skills":["hello"],"extended_content":[{"cache_prompt":false,"type":"text","text":"<EXTRA_INFO>\nThe following information has been included based on a keyword match for \"hello\".\nIt may or may not be relevant to the user's request.\n\nSkill location: /workspace/project/software-agent-sdk/.pr/local_plugin_install_test/installed_root/plugins/installed/local-plugin/skills/hello/SKILL.md\n(Use this path to resolve relative file references in the skill content below)\n\n\nReply with a short greeting.\n</EXTRA_INFO>"}],"kind":"MessageEvent"}

.pr/local_plugin_install_test/persistence/00000000000000000000000000000203/base_state.json

@@ -1 +1 @@
-{"id":"99c9faf9-b717-4e8e-8f86-e58815ed09f8","timestamp":"2026-03-01T23:48:36.190051","source":"agent","llm_message":{"role":"assistant","content":[{"cache_prompt":false,"type":"text","text":"Done"}],"thinking_blocks":[]},"llm_response_id":"test-response-1","activated_skills":[],"extended_content":[],"kind":"MessageEvent"}
+{"id":"e6cc1c04-55f1-453a-b0d6-38b52346063c","timestamp":"2026-03-02T00:17:35.566932","source":"agent","llm_message":{"role":"assistant","content":[{"cache_prompt":false,"type":"text","text":"Done"}],"thinking_blocks":[]},"llm_response_id":"test-response-1","activated_skills":[],"extended_content":[],"kind":"MessageEvent"}