openhands-agent-server 1.55.0__tar.gz → 1.55.1__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.
Files changed (110) hide show
  1. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/PKG-INFO +1 -1
  2. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/agent_profiles_router.py +2 -16
  3. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker/Dockerfile +7 -1
  4. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/file_router.py +4 -2
  5. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/plugins_router.py +72 -0
  6. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/plugins_service.py +23 -0
  7. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands_agent_server.egg-info/PKG-INFO +1 -1
  8. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/pyproject.toml +1 -1
  9. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/__init__.py +0 -0
  10. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/__main__.py +0 -0
  11. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/_secret_redaction.py +0 -0
  12. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/_secrets_exposure.py +0 -0
  13. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/acp_router.py +0 -0
  14. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/api.py +0 -0
  15. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/auth_router.py +0 -0
  16. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/bash_router.py +0 -0
  17. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/bash_service.py +0 -0
  18. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions/__init__.py +0 -0
  19. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions/backend.py +0 -0
  20. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions/bridge.py +0 -0
  21. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions/installed.py +0 -0
  22. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions/manifest.py +0 -0
  23. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions_bridge_router.py +0 -0
  24. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/canvas_extensions_router.py +0 -0
  25. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/config.py +0 -0
  26. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/conversation_lease.py +0 -0
  27. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/conversation_registry.py +0 -0
  28. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/conversation_router.py +0 -0
  29. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/conversation_service.py +0 -0
  30. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/credential_binding.py +0 -0
  31. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/dependencies.py +0 -0
  32. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker/build.py +0 -0
  33. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/__init__.py +0 -0
  34. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/mediation.py +0 -0
  35. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/provisioning.py +0 -0
  36. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/proxy.py +0 -0
  37. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/registry.py +0 -0
  38. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/routers.py +0 -0
  39. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/docker_runtime/storage.py +0 -0
  40. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/env_parser.py +0 -0
  41. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/event_router.py +0 -0
  42. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/event_service.py +0 -0
  43. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/git_provider_service.py +0 -0
  44. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/git_router.py +0 -0
  45. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/hooks_router.py +0 -0
  46. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/hooks_service.py +0 -0
  47. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/init_router.py +0 -0
  48. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/launch.py +0 -0
  49. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/llm_router.py +0 -0
  50. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/local_secret_resolver.py +0 -0
  51. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/local_storage.py +0 -0
  52. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/logging_config.py +0 -0
  53. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/managed_llm_key.py +0 -0
  54. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/mcp_oauth_store.py +0 -0
  55. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/mcp_router.py +0 -0
  56. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/meta_profiles_router.py +0 -0
  57. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/middleware.py +0 -0
  58. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/models.py +0 -0
  59. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/openai/__init__.py +0 -0
  60. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/openai/models.py +0 -0
  61. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/openai/router.py +0 -0
  62. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/openai/service.py +0 -0
  63. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/openapi.py +0 -0
  64. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/persistence/__init__.py +0 -0
  65. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/persistence/models.py +0 -0
  66. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/persistence/store.py +0 -0
  67. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/profiles_router.py +0 -0
  68. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/provider_connections_router.py +0 -0
  69. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/pub_sub.py +0 -0
  70. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/py.typed +0 -0
  71. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/runtime_router.py +0 -0
  72. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/server_details_router.py +0 -0
  73. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/session_protocol.py +0 -0
  74. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/session_socket.py +0 -0
  75. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/settings_router.py +0 -0
  76. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/skills_router.py +0 -0
  77. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/skills_service.py +0 -0
  78. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/sockets.py +0 -0
  79. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/storage/__init__.py +0 -0
  80. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/storage/model.py +0 -0
  81. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/storage/reclaimer.py +0 -0
  82. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/storage/selectors.py +0 -0
  83. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/storage/trash.py +0 -0
  84. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/sub_agents_router.py +0 -0
  85. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/__init__.py +0 -0
  86. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/factory.py +0 -0
  87. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/http_exporter.py +0 -0
  88. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/models.py +0 -0
  89. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/policy.py +0 -0
  90. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/posthog_exporter.py +0 -0
  91. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/sanitizer.py +0 -0
  92. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/service.py +0 -0
  93. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/sink.py +0 -0
  94. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry/subscriber.py +0 -0
  95. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/telemetry_types.py +0 -0
  96. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/tool_preload_service.py +0 -0
  97. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/tool_router.py +0 -0
  98. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/utils.py +0 -0
  99. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/vscode_extensions/openhands-settings/extension.js +0 -0
  100. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/vscode_extensions/openhands-settings/package.json +0 -0
  101. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/vscode_router.py +0 -0
  102. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/vscode_service.py +0 -0
  103. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/workspace_router.py +0 -0
  104. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands/agent_server/workspaces_router.py +0 -0
  105. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands_agent_server.egg-info/SOURCES.txt +0 -0
  106. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands_agent_server.egg-info/dependency_links.txt +0 -0
  107. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands_agent_server.egg-info/entry_points.txt +0 -0
  108. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands_agent_server.egg-info/requires.txt +0 -0
  109. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/openhands_agent_server.egg-info/top_level.txt +0 -0
  110. {openhands_agent_server-1.55.0 → openhands_agent_server-1.55.1}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: openhands-agent-server
3
- Version: 1.55.0
3
+ Version: 1.55.1
4
4
  Summary: OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent
5
5
  Project-URL: Source, https://github.com/OpenHands/software-agent-sdk
6
6
  Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk
@@ -47,6 +47,8 @@ from openhands.sdk.profiles import (
47
47
  ACPAgentProfile,
48
48
  AgentProfile,
49
49
  AgentProfileDiagnostics,
50
+ AgentProfileInfo,
51
+ AgentProfileListResponse,
50
52
  AgentProfileStore,
51
53
  OpenHandsAgentProfile,
52
54
  ProfileLimitExceeded,
@@ -73,22 +75,6 @@ ProfileName = Annotated[
73
75
  ProfileId = Annotated[str, Path(min_length=1, max_length=128)]
74
76
 
75
77
 
76
- class AgentProfileInfo(BaseModel):
77
- """Summary projection of a stored profile (no secret instantiation)."""
78
-
79
- id: str | None = None
80
- name: str
81
- agent_kind: str = "openhands"
82
- revision: int | None = None
83
- llm_profile_ref: str | None = None
84
- mcp_server_refs: list[str] | None = None
85
-
86
-
87
- class AgentProfileListResponse(BaseModel):
88
- profiles: list[AgentProfileInfo]
89
- active_agent_profile_id: str | None = None
90
-
91
-
92
78
  class AgentProfileDetailResponse(BaseModel):
93
79
  name: str
94
80
  profile: dict[str, Any]
@@ -42,7 +42,10 @@ FROM node:24.21.0-trixie-slim AS node-runtime
42
42
 
43
43
  # pip 26.2.1 vendors urllib3 2.7.0 (CVE-2026-97689) and msgpack 1.1.2
44
44
  # (GHSA-6v7p-g79w-8964), and no pip release vendors the fixed versions yet.
45
- # Re-vendor them with pip's own tooling so its import rewrites, patches, and
45
+ # Its pkg_resources (setuptools 70.3.0: CVE-2025-47273, CVE-2026-59890) is
46
+ # removed, as setuptools dropped it in 82.0.0 but fixed CVE-2026-59890 in 83.0.0.
47
+ # pip imports it only for _PIP_USE_IMPORTLIB_METADATA=0, which raises ImportError.
48
+ # Re-vendor with pip's own tooling so its import rewrites, patches, and
46
49
  # bom.cdx.json stay consistent; the source archive is used because the sdist
47
50
  # omits tools/vendoring/patches. Drop this stage once pip ships the fixes;
48
51
  # tests/agent_server/docker_runtime/test_pip_revendoring_retirement.py flags it.
@@ -56,9 +59,12 @@ RUN set -eux; \
56
59
  sed -i -E \
57
60
  -e 's/^( +)urllib3==2\.7\.0$/\1urllib3==2.8.0/' \
58
61
  -e 's/^msgpack==1\.1\.2$/msgpack==1.2.1/' \
62
+ -e '/^setuptools==70\.3\.0$/d' \
59
63
  src/pip/_vendor/vendor.txt; \
60
64
  grep -qx ' urllib3==2.8.0' src/pip/_vendor/vendor.txt; \
61
65
  grep -qx 'msgpack==1.2.1' src/pip/_vendor/vendor.txt; \
66
+ if grep -q '^setuptools==' src/pip/_vendor/vendor.txt; then exit 1; fi; \
67
+ rm tools/vendoring/patches/pkg_resources.patch; \
62
68
  python -m venv /tmp/vendoring; \
63
69
  /tmp/vendoring/bin/pip install --no-cache-dir vendoring==1.4.0; \
64
70
  /tmp/vendoring/bin/vendoring sync; \
@@ -19,6 +19,7 @@ from fastapi import (
19
19
  File,
20
20
  HTTPException,
21
21
  Query,
22
+ Request,
22
23
  UploadFile,
23
24
  status,
24
25
  )
@@ -30,7 +31,7 @@ from openhands.agent_server._secret_redaction import (
30
31
  redacted_json_bytes,
31
32
  should_redact,
32
33
  )
33
- from openhands.agent_server.config import get_default_config
34
+ from openhands.agent_server.config import Config
34
35
  from openhands.agent_server.models import Success
35
36
  from openhands.agent_server.server_details_router import update_last_execution_time
36
37
  from openhands.sdk.git.exceptions import GitCommandError, GitRepositoryError
@@ -931,9 +932,10 @@ async def search_subdirs(
931
932
  )
932
933
  async def download_trajectory(
933
934
  conversation_id: UUID,
935
+ request: Request,
934
936
  ) -> FileResponse:
935
937
  """Download a zip archive of a conversation trajectory."""
936
- config = get_default_config()
938
+ config: Config = request.app.state.config
937
939
  temp_file = config.conversations_path / f"{conversation_id.hex}.zip"
938
940
  conversation_dir = config.conversations_path / conversation_id.hex
939
941
 
@@ -19,6 +19,7 @@ from openhands.agent_server.plugins_service import (
19
19
  PluginSkillSummary,
20
20
  service_disable_plugin,
21
21
  service_enable_plugin,
22
+ service_fetch_plugin,
22
23
  service_get_installed_plugin,
23
24
  service_get_plugins_marketplace_catalog,
24
25
  service_install_plugin,
@@ -31,6 +32,13 @@ from openhands.agent_server.plugins_service import (
31
32
  )
32
33
  from openhands.sdk.extensions.fetch import ExtensionFetchError
33
34
  from openhands.sdk.plugin import InstalledPluginInfo, Plugin, PluginFetchError
35
+ from openhands.sdk.plugin.strict_fetch import PluginSourceError
36
+ from openhands.sdk.secret import SecretSource
37
+
38
+
39
+ type JSONValue = (
40
+ str | int | float | bool | None | list[JSONValue] | dict[str, JSONValue]
41
+ )
34
42
 
35
43
 
36
44
  plugins_router = APIRouter(prefix="/plugins", tags=["Plugins"])
@@ -116,6 +124,34 @@ class InstallPluginRequest(BaseModel):
116
124
  )
117
125
 
118
126
 
127
+ class FetchPluginRequest(BaseModel):
128
+ """Request body for strictly fetching a plugin without installing it."""
129
+
130
+ source: str = Field(min_length=1, description="Plugin git source")
131
+ ref: str | None = Field(default=None, description="Branch, tag, or commit")
132
+ repo_path: str | None = Field(
133
+ default=None,
134
+ description="Subdirectory path within the repository (for monorepos)",
135
+ )
136
+ secrets: dict[str, SecretSource] = Field(
137
+ default_factory=dict,
138
+ description="Secrets used to expand ${VAR} placeholders in source and ref",
139
+ )
140
+ timeout: int = Field(default=60, ge=1, le=600, description="Git timeout seconds")
141
+
142
+
143
+ class FetchPluginResponse(BaseModel):
144
+ """Response from strictly fetching a plugin source."""
145
+
146
+ path: str
147
+ resolved_ref: str | None
148
+ source: str
149
+ repo_path: str | None
150
+ manifest: dict[str, JSONValue]
151
+ skills: list[str]
152
+ commands: list[str]
153
+
154
+
119
155
  class InstalledPluginResponse(BaseModel):
120
156
  """Response containing installed plugin information."""
121
157
 
@@ -239,6 +275,42 @@ def get_plugins(request: PluginsRequest) -> PluginsResponse:
239
275
  return PluginsResponse(plugins=[_plugin_info(p) for p in plugins])
240
276
 
241
277
 
278
+ @plugins_router.post(
279
+ "/fetch",
280
+ response_model=FetchPluginResponse,
281
+ responses={
282
+ 422: {"description": "Invalid plugin source, ref, path, or plugin"},
283
+ 502: {"description": "Plugin source unavailable"},
284
+ 504: {"description": "Plugin fetch timed out"},
285
+ },
286
+ )
287
+ def fetch_plugin_endpoint(request: FetchPluginRequest) -> FetchPluginResponse:
288
+ """Fetch and pin a plugin source without installing or enabling it."""
289
+ try:
290
+ checked = service_fetch_plugin(
291
+ source=request.source,
292
+ ref=request.ref,
293
+ repo_path=request.repo_path,
294
+ secrets=request.secrets,
295
+ timeout=request.timeout,
296
+ )
297
+ except PluginSourceError as exc:
298
+ raise HTTPException(
299
+ status_code=exc.status_code,
300
+ detail={"code": exc.code, "message": exc.message},
301
+ ) from exc
302
+
303
+ return FetchPluginResponse(
304
+ path=str(checked.path),
305
+ resolved_ref=checked.resolved_ref,
306
+ source=checked.source,
307
+ repo_path=checked.repo_path,
308
+ manifest=checked.manifest,
309
+ skills=checked.skills,
310
+ commands=checked.commands,
311
+ )
312
+
313
+
242
314
  @plugins_router.post(
243
315
  "/install",
244
316
  response_model=InstalledPluginResponse,
@@ -15,6 +15,7 @@ counterparts (``skills_service.py``) so the router stays focused on HTTP:
15
15
 
16
16
  import json
17
17
  import os
18
+ from collections.abc import Mapping
18
19
  from pathlib import Path
19
20
  from time import monotonic
20
21
 
@@ -23,6 +24,7 @@ from pydantic import BaseModel, ValidationError
23
24
  from openhands.sdk.logger import get_logger
24
25
  from openhands.sdk.marketplace import Marketplace
25
26
  from openhands.sdk.plugin import (
27
+ CheckedPlugin,
26
28
  InstalledPluginInfo,
27
29
  Plugin,
28
30
  disable_plugin,
@@ -33,6 +35,8 @@ from openhands.sdk.plugin import (
33
35
  uninstall_plugin,
34
36
  update_plugin,
35
37
  )
38
+ from openhands.sdk.plugin.strict_fetch import fetch_plugin_strict
39
+ from openhands.sdk.secret import SecretValue
36
40
  from openhands.sdk.skills.skill import (
37
41
  DEFAULT_MARKETPLACE_PATH,
38
42
  PUBLIC_SKILLS_REF,
@@ -70,6 +74,25 @@ def service_install_plugin(
70
74
  )
71
75
 
72
76
 
77
+ def service_fetch_plugin(
78
+ source: str,
79
+ ref: str | None = None,
80
+ repo_path: str | None = None,
81
+ secrets: Mapping[str, SecretValue] | None = None,
82
+ timeout: int = 60,
83
+ ) -> CheckedPlugin:
84
+ """Strictly fetch a plugin into the immutable plugin cache."""
85
+ return fetch_plugin_strict(
86
+ source=source,
87
+ ref=ref,
88
+ repo_path=repo_path,
89
+ secrets=secrets,
90
+ timeout=timeout,
91
+ allow_local=True,
92
+ use_cache=True,
93
+ )
94
+
95
+
73
96
  def service_uninstall_plugin(name: str, installed_dir: Path | None = None) -> bool:
74
97
  """Uninstall a plugin by name. Returns False if it wasn't installed."""
75
98
  return uninstall_plugin(name, installed_dir=installed_dir)
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: openhands-agent-server
3
- Version: 1.55.0
3
+ Version: 1.55.1
4
4
  Summary: OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent
5
5
  Project-URL: Source, https://github.com/OpenHands/software-agent-sdk
6
6
  Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "openhands-agent-server"
3
- version = "1.55.0"
3
+ version = "1.55.1"
4
4
  description = "OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent"
5
5
 
6
6
  requires-python = ">=3.12"