openhands-agent-server 1.52.0__tar.gz → 1.53.0__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 (102) hide show
  1. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/PKG-INFO +1 -1
  2. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions/installed.py +20 -0
  3. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions/manifest.py +43 -4
  4. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions_router.py +40 -0
  5. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands_agent_server.egg-info/PKG-INFO +1 -1
  6. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/pyproject.toml +1 -1
  7. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/__init__.py +0 -0
  8. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/__main__.py +0 -0
  9. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/_secret_redaction.py +0 -0
  10. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/_secrets_exposure.py +0 -0
  11. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/agent_profiles_router.py +0 -0
  12. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/api.py +0 -0
  13. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/auth_router.py +0 -0
  14. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/bash_router.py +0 -0
  15. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/bash_service.py +0 -0
  16. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions/__init__.py +0 -0
  17. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions/backend.py +0 -0
  18. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions/bridge.py +0 -0
  19. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/canvas_extensions_bridge_router.py +0 -0
  20. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/config.py +0 -0
  21. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/conversation_lease.py +0 -0
  22. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/conversation_registry.py +0 -0
  23. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/conversation_router.py +0 -0
  24. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/conversation_service.py +0 -0
  25. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/credential_binding.py +0 -0
  26. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/dependencies.py +0 -0
  27. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker/Dockerfile +0 -0
  28. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker/build.py +0 -0
  29. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker_runtime/__init__.py +0 -0
  30. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker_runtime/mediation.py +0 -0
  31. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker_runtime/provisioning.py +0 -0
  32. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker_runtime/proxy.py +0 -0
  33. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker_runtime/registry.py +0 -0
  34. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/docker_runtime/routers.py +0 -0
  35. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/env_parser.py +0 -0
  36. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/event_router.py +0 -0
  37. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/event_service.py +0 -0
  38. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/file_router.py +0 -0
  39. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/git_provider_service.py +0 -0
  40. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/git_router.py +0 -0
  41. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/hooks_router.py +0 -0
  42. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/hooks_service.py +0 -0
  43. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/init_router.py +0 -0
  44. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/launch.py +0 -0
  45. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/llm_router.py +0 -0
  46. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/local_secret_resolver.py +0 -0
  47. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/logging_config.py +0 -0
  48. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/managed_llm_key.py +0 -0
  49. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/mcp_oauth_store.py +0 -0
  50. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/mcp_router.py +0 -0
  51. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/meta_profiles_router.py +0 -0
  52. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/middleware.py +0 -0
  53. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/models.py +0 -0
  54. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/openai/__init__.py +0 -0
  55. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/openai/models.py +0 -0
  56. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/openai/router.py +0 -0
  57. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/openai/service.py +0 -0
  58. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/openapi.py +0 -0
  59. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/persistence/__init__.py +0 -0
  60. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/persistence/models.py +0 -0
  61. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/persistence/store.py +0 -0
  62. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/plugins_router.py +0 -0
  63. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/plugins_service.py +0 -0
  64. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/profiles_router.py +0 -0
  65. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/provider_connections_router.py +0 -0
  66. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/pub_sub.py +0 -0
  67. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/py.typed +0 -0
  68. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/runtime_router.py +0 -0
  69. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/server_details_router.py +0 -0
  70. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/session_protocol.py +0 -0
  71. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/session_socket.py +0 -0
  72. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/settings_router.py +0 -0
  73. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/skills_router.py +0 -0
  74. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/skills_service.py +0 -0
  75. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/sockets.py +0 -0
  76. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/sub_agents_router.py +0 -0
  77. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/__init__.py +0 -0
  78. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/factory.py +0 -0
  79. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/http_exporter.py +0 -0
  80. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/models.py +0 -0
  81. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/policy.py +0 -0
  82. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/posthog_exporter.py +0 -0
  83. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/sanitizer.py +0 -0
  84. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/service.py +0 -0
  85. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/sink.py +0 -0
  86. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry/subscriber.py +0 -0
  87. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/telemetry_types.py +0 -0
  88. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/tool_preload_service.py +0 -0
  89. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/tool_router.py +0 -0
  90. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/utils.py +0 -0
  91. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/vscode_extensions/openhands-settings/extension.js +0 -0
  92. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/vscode_extensions/openhands-settings/package.json +0 -0
  93. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/vscode_router.py +0 -0
  94. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/vscode_service.py +0 -0
  95. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/workspace_router.py +0 -0
  96. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands/agent_server/workspaces_router.py +0 -0
  97. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands_agent_server.egg-info/SOURCES.txt +0 -0
  98. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands_agent_server.egg-info/dependency_links.txt +0 -0
  99. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands_agent_server.egg-info/entry_points.txt +0 -0
  100. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands_agent_server.egg-info/requires.txt +0 -0
  101. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/openhands_agent_server.egg-info/top_level.txt +0 -0
  102. {openhands_agent_server-1.52.0 → openhands_agent_server-1.53.0}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: openhands-agent-server
3
- Version: 1.52.0
3
+ Version: 1.53.0
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
@@ -18,6 +18,7 @@ directory in one rename), rolling back if the second fails.
18
18
 
19
19
  import os
20
20
  import shutil
21
+ from contextlib import suppress
21
22
  from pathlib import Path
22
23
 
23
24
  from pydantic import BaseModel, Field, ValidationError
@@ -26,6 +27,7 @@ from openhands.agent_server.canvas_extensions.manifest import (
26
27
  MANIFEST_FILENAME,
27
28
  CanvasExtensionManifest,
28
29
  resolve_entrypoint,
30
+ resolve_icon,
29
31
  )
30
32
  from openhands.sdk.extensions.fetch import fetch_with_resolution
31
33
  from openhands.sdk.extensions.installation import (
@@ -248,6 +250,24 @@ def get_canvas_extension_bundle_path(
248
250
  return resolve_entrypoint(manifest, installed_dir / name)
249
251
 
250
252
 
253
+ def get_canvas_extension_icon_path(
254
+ name: str, installed_dir: Path | None = None
255
+ ) -> Path | None:
256
+ """Resolve *name*'s icon file, re-checking containment like the bundle.
257
+
258
+ Returns:
259
+ None if not installed, no icon is declared, or the icon doesn't resolve
260
+ to a contained file. A broken icon never affects the manifest itself.
261
+ """
262
+ installed_dir = _resolve_installed_dir(installed_dir)
263
+ manifest = get_installed_canvas_extension_manifest(name, installed_dir)
264
+ if manifest is None:
265
+ return None
266
+ with suppress(ValueError, OSError):
267
+ return resolve_icon(manifest, installed_dir / name)
268
+ return None
269
+
270
+
251
271
  class CanvasExtensionUpdateCheck(BaseModel):
252
272
  """Result of ``check_canvas_extension_update``.
253
273
 
@@ -21,6 +21,10 @@ from typing import Final, Literal
21
21
  from pydantic import BaseModel, Field, field_validator, model_validator
22
22
 
23
23
  from openhands.sdk.extensions.installation.utils import validate_extension_name
24
+ from openhands.sdk.logger import get_logger
25
+
26
+
27
+ logger = get_logger(__name__)
24
28
 
25
29
 
26
30
  # Filename a canvas extension's manifest is loaded from, at its package root.
@@ -181,6 +185,25 @@ class CanvasExtensionManifest(BaseModel):
181
185
  exclude_if=lambda value: value is None,
182
186
  description="Optional explicitly prepared and started backend service",
183
187
  )
188
+ icon: str | None = Field(
189
+ default=None,
190
+ exclude_if=lambda value: value is None,
191
+ description="Path, relative to the extension package root, to an SVG icon",
192
+ )
193
+
194
+ @field_validator("icon", mode="before")
195
+ @classmethod
196
+ def _validate_icon(cls, v: object) -> str | None:
197
+ """Drop a non-SVG icon instead of raising.
198
+
199
+ The manifest is re-validated on every read, so raising here would hide
200
+ the whole extension. Containment is checked at serve time by
201
+ :func:`resolve_icon`.
202
+ """
203
+ if v is None or (isinstance(v, str) and v.endswith(".svg")):
204
+ return v
205
+ logger.warning("Ignoring invalid canvas extension icon %r", v)
206
+ return None
184
207
 
185
208
  @field_validator("schema_version")
186
209
  @classmethod
@@ -237,16 +260,32 @@ def resolve_entrypoint(manifest: CanvasExtensionManifest, package_root: Path) ->
237
260
  a directory, a dangling symlink, and symlink cycles — none of
238
261
  which ``is_relative_to`` alone rejects).
239
262
  """
263
+ return _resolve_contained_file("entrypoint", manifest.entrypoint, package_root)
264
+
265
+
266
+ def resolve_icon(manifest: CanvasExtensionManifest, package_root: Path) -> Path | None:
267
+ """Resolve ``manifest.icon`` with the same containment check as the entrypoint.
268
+
269
+ Returns:
270
+ None if the manifest declares no icon.
271
+
272
+ Raises:
273
+ ValueError: If the icon escapes ``package_root`` or is not a file.
274
+ """
275
+ icon = manifest.icon
276
+ return None if icon is None else _resolve_contained_file("icon", icon, package_root)
277
+
278
+
279
+ def _resolve_contained_file(label: str, relative_path: str, package_root: Path) -> Path:
240
280
  root = package_root.resolve()
241
- candidate = (root / manifest.entrypoint).resolve()
281
+ candidate = (root / relative_path).resolve()
242
282
  if not candidate.is_relative_to(root):
243
283
  raise ValueError(
244
- f"entrypoint {manifest.entrypoint!r} resolves outside the "
245
- "extension package root"
284
+ f"{label} {relative_path!r} resolves outside the extension package root"
246
285
  )
247
286
  if not candidate.is_file():
248
287
  raise ValueError(
249
- f"entrypoint {manifest.entrypoint!r} does not resolve to a file "
288
+ f"{label} {relative_path!r} does not resolve to a file "
250
289
  "in the extension package"
251
290
  )
252
291
  return candidate
@@ -26,6 +26,7 @@ from openhands.agent_server.canvas_extensions.installed import (
26
26
  disable_canvas_extension,
27
27
  enable_canvas_extension,
28
28
  get_canvas_extension_bundle_path,
29
+ get_canvas_extension_icon_path,
29
30
  get_installed_canvas_extension,
30
31
  get_installed_canvas_extension_manifest,
31
32
  install_canvas_extension,
@@ -437,3 +438,42 @@ def get_canvas_extension_bundle_endpoint(
437
438
  detail=f"Canvas extension '{extension_name}' bundle not found",
438
439
  )
439
440
  return FileResponse(bundle_path, headers={"Cache-Control": "no-cache"})
441
+
442
+
443
+ @canvas_extensions_router.get(
444
+ "/installed/{extension_name}/icon",
445
+ response_class=FileResponse,
446
+ responses={
447
+ 200: {
448
+ "content": {
449
+ "image/svg+xml": {"schema": {"type": "string", "format": "binary"}}
450
+ }
451
+ },
452
+ 404: {"description": "Canvas extension or icon not found"},
453
+ },
454
+ )
455
+ def get_canvas_extension_icon_endpoint(
456
+ extension_name: CanvasExtensionNamePath,
457
+ ) -> FileResponse:
458
+ """Serve the SVG icon declared by an installed canvas extension's manifest.
459
+
460
+ The path comes from the manifest, never the request. The CSP sandbox keeps
461
+ a directly opened SVG from running scripts on the agent-server origin.
462
+ """
463
+ icon_path = get_canvas_extension_icon_path(name=extension_name)
464
+ if icon_path is None:
465
+ raise HTTPException(
466
+ status_code=404,
467
+ detail=f"Canvas extension '{extension_name}' icon not found",
468
+ )
469
+ return FileResponse(
470
+ icon_path,
471
+ media_type="image/svg+xml",
472
+ headers={
473
+ "Cache-Control": "no-cache",
474
+ "Content-Security-Policy": (
475
+ "default-src 'none'; style-src 'unsafe-inline'; sandbox"
476
+ ),
477
+ "X-Content-Type-Options": "nosniff",
478
+ },
479
+ )
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: openhands-agent-server
3
- Version: 1.52.0
3
+ Version: 1.53.0
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.52.0"
3
+ version = "1.53.0"
4
4
  description = "OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent"
5
5
 
6
6
  requires-python = ">=3.12"