agentengine-sdk-python 0.7.0__py3-none-any.whl → 0.8.1__py3-none-any.whl

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 (450) hide show
  1. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/METADATA +52 -20
  2. agentengine_sdk_python-0.8.1.dist-info/RECORD +644 -0
  3. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/WHEEL +1 -1
  4. ksadk/a2a/__init__.py +180 -11
  5. ksadk/a2a/bootstrap.py +332 -0
  6. ksadk/a2a/card.py +15 -0
  7. ksadk/a2a/context_store.py +203 -0
  8. ksadk/a2a/control_plane.py +1056 -0
  9. ksadk/a2a/credential.py +99 -0
  10. ksadk/a2a/event_adapter.py +149 -0
  11. ksadk/a2a/executor.py +361 -137
  12. ksadk/a2a/external_transport.py +516 -0
  13. ksadk/a2a/identity.py +304 -0
  14. ksadk/a2a/ids.py +22 -0
  15. ksadk/a2a/langgraph.py +285 -0
  16. ksadk/a2a/resume_store.py +201 -0
  17. ksadk/a2a/routes.py +112 -0
  18. ksadk/a2a/server.py +102 -62
  19. ksadk/a2a/service_env.py +33 -0
  20. ksadk/a2a/space_client.py +1122 -0
  21. ksadk/a2a/task_adapter.py +423 -0
  22. ksadk/a2a/task_event_dispatcher.py +167 -0
  23. ksadk/a2a/task_event_outbox.py +326 -0
  24. ksadk/a2a/task_store.py +206 -0
  25. ksadk/a2a_card.py +101 -0
  26. ksadk/a2ui/__init__.py +27 -0
  27. ksadk/a2ui/core.py +186 -0
  28. ksadk/a2ui/models.py +166 -0
  29. ksadk/a2ui/renderer.py +198 -0
  30. ksadk/agui/__init__.py +9 -0
  31. ksadk/agui/a2ui_projection.py +92 -0
  32. ksadk/agui/agent.py +872 -0
  33. ksadk/agui/config.py +92 -0
  34. ksadk/agui/routes.py +47 -0
  35. ksadk/api/client.py +238 -204
  36. ksadk/api/environment.py +27 -0
  37. ksadk/builders/__init__.py +2 -0
  38. ksadk/builders/base.py +16 -14
  39. ksadk/builders/code_builder.py +375 -270
  40. ksadk/builders/container_builder.py +240 -200
  41. ksadk/builders/framework_requirements.py +31 -12
  42. ksadk/builders/ks3_uploader.py +60 -29
  43. ksadk/builders/managed_runtime_builder.py +173 -0
  44. ksadk/builders/mcp_builder.py +91 -92
  45. ksadk/builders/requirements_utils.py +1 -5
  46. ksadk/cli/__init__.py +97 -171
  47. ksadk/cli/cmd_a2a.py +255 -84
  48. ksadk/cli/cmd_agent.py +19 -5
  49. ksadk/cli/cmd_build.py +158 -29
  50. ksadk/cli/cmd_completion.py +47 -35
  51. ksadk/cli/cmd_config.py +267 -198
  52. ksadk/cli/cmd_create.py +507 -740
  53. ksadk/cli/cmd_dashboard.py +120 -45
  54. ksadk/cli/cmd_deploy.py +135 -59
  55. ksadk/cli/cmd_destroy.py +44 -14
  56. ksadk/cli/cmd_eval.py +386 -0
  57. ksadk/cli/cmd_files.py +63 -24
  58. ksadk/cli/cmd_hermes.py +313 -135
  59. ksadk/cli/cmd_invoke.py +184 -122
  60. ksadk/cli/cmd_launch.py +76 -28
  61. ksadk/cli/cmd_mcp.py +98 -64
  62. ksadk/cli/cmd_model.py +14 -5
  63. ksadk/cli/cmd_openclaw.py +564 -268
  64. ksadk/cli/cmd_replay.py +71 -0
  65. ksadk/cli/cmd_run.py +58 -73
  66. ksadk/cli/cmd_status.py +80 -31
  67. ksadk/cli/cmd_studio.py +110 -0
  68. ksadk/cli/cmd_version.py +20 -13
  69. ksadk/cli/cmd_web.py +95 -18
  70. ksadk/cli/deploy_utils.py +20 -20
  71. ksadk/cli/dry_run.py +7 -4
  72. ksadk/cli/env_options.py +83 -0
  73. ksadk/cli/error_utils.py +37 -12
  74. ksadk/cli/global_options.py +4 -3
  75. ksadk/cli/local_runtime.py +1 -2
  76. ksadk/cli/model_catalog.py +6 -2
  77. ksadk/cli/network_options.py +41 -19
  78. ksadk/cli/resource_common.py +6 -2
  79. ksadk/cli/runtime_bootstrap.py +51 -0
  80. ksadk/cli/storage.py +0 -1
  81. ksadk/cli/ui.py +11 -3
  82. ksadk/cli/workflow_common.py +52 -18
  83. ksadk/codex/__init__.py +12 -0
  84. ksadk/codex/client.py +1042 -0
  85. ksadk/codex/phase.py +143 -0
  86. ksadk/codex/runtime.py +940 -0
  87. ksadk/common/aicp_env.py +0 -1
  88. ksadk/common/auth.py +2 -2
  89. ksadk/common/constants.py +1 -3
  90. ksadk/common/kop_client.py +232 -0
  91. ksadk/common/llm_utils.py +17 -13
  92. ksadk/compat/__init__.py +5 -0
  93. ksadk/compat/adk_compat.py +200 -0
  94. ksadk/compat/copilotkit_a2ui.py +330 -0
  95. ksadk/configs/__init__.py +12 -14
  96. ksadk/configs/env_registry.py +661 -116
  97. ksadk/configs/global_config.py +3 -2
  98. ksadk/configs/settings.py +133 -209
  99. ksadk/conversations/__init__.py +85 -92
  100. ksadk/conversations/attachment_storage.py +16 -11
  101. ksadk/conversations/attachments.py +44 -36
  102. ksadk/conversations/compaction_pipeline.py +12 -12
  103. ksadk/conversations/compaction_prompt.py +9 -5
  104. ksadk/conversations/context.py +221 -6
  105. ksadk/conversations/message_projection.py +438 -51
  106. ksadk/conversations/model_context.py +12 -6
  107. ksadk/conversations/model_options.py +0 -1
  108. ksadk/conversations/normalize.py +20 -16
  109. ksadk/conversations/reasoning_markup.py +1 -1
  110. ksadk/conversations/runtime.py +339 -5255
  111. ksadk/conversations/runtime_compaction.py +333 -0
  112. ksadk/conversations/runtime_constants.py +27 -0
  113. ksadk/conversations/runtime_governance.py +185 -0
  114. ksadk/conversations/runtime_input.py +660 -0
  115. ksadk/conversations/runtime_invocation.py +395 -0
  116. ksadk/conversations/runtime_metadata.py +475 -0
  117. ksadk/conversations/runtime_observability.py +367 -0
  118. ksadk/conversations/runtime_payloads.py +272 -0
  119. ksadk/conversations/runtime_persistence.py +440 -0
  120. ksadk/conversations/runtime_preparation.py +426 -0
  121. ksadk/conversations/runtime_resume.py +836 -0
  122. ksadk/conversations/runtime_stream_events.py +902 -0
  123. ksadk/conversations/runtime_streaming.py +700 -0
  124. ksadk/conversations/semantic_summary.py +17 -5
  125. ksadk/conversations/session_title.py +6 -3
  126. ksadk/deployment/__init__.py +15 -16
  127. ksadk/deployment/agent_access.py +12 -23
  128. ksadk/deployment/base.py +51 -38
  129. ksadk/deployment/managed_runtime.py +33 -0
  130. ksadk/deployment/manager.py +85 -71
  131. ksadk/deployment/providers/serverless.py +379 -210
  132. ksadk/deployment/registry.py +38 -32
  133. ksadk/deployment/state.py +11 -11
  134. ksadk/deployment/ui_config.py +1 -1
  135. ksadk/detection/__init__.py +1 -1
  136. ksadk/detection/detector.py +146 -83
  137. ksadk/detection/mcp_detector.py +9 -6
  138. ksadk/evaluation/__init__.py +84 -0
  139. ksadk/evaluation/a2a_adapter.py +444 -0
  140. ksadk/evaluation/adapters.py +54 -0
  141. ksadk/evaluation/contracts.py +409 -0
  142. ksadk/evaluation/evalset.py +351 -0
  143. ksadk/evaluation/evaluators.py +461 -0
  144. ksadk/evaluation/executor.py +118 -0
  145. ksadk/evaluation/storage.py +68 -0
  146. ksadk/evaluation/target.py +73 -0
  147. ksadk/events/__init__.py +25 -0
  148. ksadk/events/parser.py +191 -0
  149. ksadk/events/replay.py +37 -0
  150. ksadk/events/runtime_event.py +273 -0
  151. ksadk/events/store.py +317 -0
  152. ksadk/harness/__init__.py +35 -0
  153. ksadk/harness/app.py +269 -0
  154. ksadk/harness/config.py +181 -0
  155. ksadk/harness/reasoner.py +105 -0
  156. ksadk/harness/runtime.py +364 -0
  157. ksadk/harness/sandbox.py +141 -0
  158. ksadk/harness/tools.py +222 -0
  159. ksadk/hermes_terminal.py +28 -12
  160. ksadk/identity/resolver.py +15 -9
  161. ksadk/ids.py +32 -0
  162. ksadk/knowledge_base/adk_tool.py +1 -1
  163. ksadk/knowledge_base/client.py +38 -33
  164. ksadk/managed_a2a_card.py +160 -0
  165. ksadk/managed_runtime.py +195 -0
  166. ksadk/markdown.py +5 -2
  167. ksadk/mcp_runtime/__init__.py +9 -6
  168. ksadk/memory/__init__.py +1 -1
  169. ksadk/memory/adk/__init__.py +2 -0
  170. ksadk/memory/adk/backends/base_ltm_backend.py +2 -6
  171. ksadk/memory/adk/backends/http_ltm_backend.py +13 -21
  172. ksadk/memory/adk/backends/inmemory_ltm_backend.py +7 -13
  173. ksadk/memory/adk/backends/sdk_ltm_backend.py +36 -36
  174. ksadk/memory/adk/long_term_memory.py +34 -37
  175. ksadk/memory/adk/resilient_session_service.py +4 -5
  176. ksadk/memory/adk/short_term_memory.py +12 -21
  177. ksadk/memory/adk_tool.py +3 -2
  178. ksadk/memory/backends/base.py +19 -19
  179. ksadk/memory/backends/memory.py +24 -25
  180. ksadk/memory/backends/redis.py +31 -30
  181. ksadk/memory/langchain_tool.py +2 -1
  182. ksadk/memory/manager.py +52 -47
  183. ksadk/memory/service.py +16 -6
  184. ksadk/memory/tool.py +4 -0
  185. ksadk/model_policy.py +15 -7
  186. ksadk/model_proxy/__init__.py +51 -0
  187. ksadk/model_proxy/bootstrap.py +80 -0
  188. ksadk/model_proxy/cache.py +165 -0
  189. ksadk/model_proxy/config.py +66 -0
  190. ksadk/model_proxy/demo_webui.py +115 -0
  191. ksadk/model_proxy/detect.py +145 -0
  192. ksadk/model_proxy/gate.py +68 -0
  193. ksadk/model_proxy/namespace.py +201 -0
  194. ksadk/model_proxy/protocol_proxy.py +22 -0
  195. ksadk/model_proxy/server.py +443 -0
  196. ksadk/model_proxy/transform.py +735 -0
  197. ksadk/openclaw_gateway.py +29 -14
  198. ksadk/runners/adk_runner.py +354 -146
  199. ksadk/runners/base_runner.py +71 -29
  200. ksadk/runners/deepagents_runner.py +0 -1
  201. ksadk/runners/factory.py +18 -5
  202. ksadk/runners/langchain_runner.py +29 -742
  203. ksadk/runners/langgraph_runner.py +417 -97
  204. ksadk/runners/patch_langchain.py +16 -16
  205. ksadk/runners/remote_runner.py +134 -33
  206. ksadk/runners/usage_accumulator.py +1 -0
  207. ksadk/runners/utils/__init__.py +0 -10
  208. ksadk/runners/utils/loader.py +23 -7
  209. ksadk/runtime/__init__.py +67 -0
  210. ksadk/runtime/adapter.py +412 -0
  211. ksadk/runtime/conversation_execution.py +553 -0
  212. ksadk/runtime/executor.py +251 -0
  213. ksadk/runtime/factory.py +156 -0
  214. ksadk/runtime/framework_adapters.py +118 -0
  215. ksadk/runtime/launch.py +48 -0
  216. ksadk/runtime/preprocessing.py +131 -0
  217. ksadk/runtime/runner_adapter.py +1032 -0
  218. ksadk/runtime/runner_loading.py +36 -0
  219. ksadk/runtime_context.py +18 -3
  220. ksadk/runtime_state.py +0 -1
  221. ksadk/sandbox/__init__.py +4 -1
  222. ksadk/sandbox/backends/__init__.py +4 -1
  223. ksadk/sandbox/backends/e2b.py +13 -5
  224. ksadk/sandbox/backends/local_process.py +11 -3
  225. ksadk/sandbox/base.py +10 -15
  226. ksadk/sandbox/factory.py +14 -4
  227. ksadk/sandbox/registry.py +57 -6
  228. ksadk/server/__init__.py +39 -4
  229. ksadk/server/api_models.py +15 -5
  230. ksadk/server/app.py +24 -3928
  231. ksadk/server/composition.py +47 -0
  232. ksadk/server/factory.py +622 -0
  233. ksadk/server/routes/__init__.py +1 -0
  234. ksadk/server/routes/checkpoint_resolution.py +116 -0
  235. ksadk/server/routes/common.py +682 -0
  236. ksadk/server/routes/control.py +331 -0
  237. ksadk/server/routes/dependencies.py +98 -0
  238. ksadk/server/routes/misc.py +425 -0
  239. ksadk/server/routes/models.py +451 -0
  240. ksadk/server/routes/openai_compat.py +229 -0
  241. ksadk/server/routes/projection.py +848 -0
  242. ksadk/server/routes/routers.py +52 -0
  243. ksadk/server/routes/run.py +519 -0
  244. ksadk/server/routes/sessions.py +644 -0
  245. ksadk/server/routes/streaming.py +265 -0
  246. ksadk/server/routes/workspace.py +414 -0
  247. ksadk/server/static/assets/{ArtifactsPanel-D-SSn2ee.js → ArtifactsPanel-CakCqxEN.js} +1 -1
  248. ksadk/server/static/assets/CodeBlock-CynLknyO.js +9 -0
  249. ksadk/server/static/assets/MathMessageMarkdown-3sQdOysS.js +8 -0
  250. ksadk/server/static/assets/MermaidBlock-NERD_ef7.js +303 -0
  251. ksadk/server/static/assets/NativeTerminalPanel-CiHWf82q.js +1 -0
  252. ksadk/server/static/assets/{arc-BA13sHc9.js → arc-DrgjcKhl.js} +1 -1
  253. ksadk/server/static/assets/architecture-7EHR7CIX-CpZLRCcY.js +1 -0
  254. ksadk/server/static/assets/{architectureDiagram-3BPJPVTR-DzJzgVoL.js → architectureDiagram-3BPJPVTR-BXoVRbQ6.js} +1 -1
  255. ksadk/server/static/assets/{blockDiagram-GPEHLZMM-UTdVcZhn.js → blockDiagram-GPEHLZMM-BnaB3Ywv.js} +1 -1
  256. ksadk/server/static/assets/{c4Diagram-AAUBKEIU-Dix0GD4m.js → c4Diagram-AAUBKEIU-Dw4weZcp.js} +1 -1
  257. ksadk/server/static/assets/channel-Dt3rQTFI.js +1 -0
  258. ksadk/server/static/assets/{chunk-2J33WTMH-C2JxuZ42.js → chunk-2J33WTMH-ChjpLK7j.js} +1 -1
  259. ksadk/server/static/assets/{chunk-4BX2VUAB-Be57QPgD.js → chunk-4BX2VUAB-B9drTgOW.js} +1 -1
  260. ksadk/server/static/assets/{chunk-55IACEB6-WjSuy4nv.js → chunk-55IACEB6-CK4ROATy.js} +1 -1
  261. ksadk/server/static/assets/{chunk-727SXJPM-BOovP-b5.js → chunk-727SXJPM-B9KtTTgw.js} +1 -1
  262. ksadk/server/static/assets/{chunk-AQP2D5EJ-DOmZNmWj.js → chunk-AQP2D5EJ-1O1mki3m.js} +1 -1
  263. ksadk/server/static/assets/{chunk-FMBD7UC4-DzwlodkU.js → chunk-FMBD7UC4-B_fH2YuH.js} +1 -1
  264. ksadk/server/static/assets/{chunk-ND2GUHAM-DMqAikEU.js → chunk-ND2GUHAM-D6rFLaVV.js} +1 -1
  265. ksadk/server/static/assets/chunk-QZHKN3VN-iXEZtKQc.js +1 -0
  266. ksadk/server/static/assets/classDiagram-4FO5ZUOK-DIveV17Q.js +1 -0
  267. ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-DIveV17Q.js +1 -0
  268. ksadk/server/static/assets/{cose-bilkent-S5V4N54A-Zhy2GBnP.js → cose-bilkent-S5V4N54A-ChNs_Mdk.js} +1 -1
  269. ksadk/server/static/assets/{dagre-BM42HDAG-CbKrtIUz.js → dagre-BM42HDAG-D0QXg_MQ.js} +1 -1
  270. ksadk/server/static/assets/{diagram-2AECGRRQ-BRApgQRK.js → diagram-2AECGRRQ-DBDDKwBQ.js} +1 -1
  271. ksadk/server/static/assets/{diagram-5GNKFQAL-D0xbnDiK.js → diagram-5GNKFQAL-BkwDOxmO.js} +1 -1
  272. ksadk/server/static/assets/{diagram-KO2AKTUF-CVugVI9L.js → diagram-KO2AKTUF-Bv8waYvY.js} +1 -1
  273. ksadk/server/static/assets/{diagram-LMA3HP47-DozUGgee.js → diagram-LMA3HP47-e1VECDdu.js} +1 -1
  274. ksadk/server/static/assets/{diagram-OG6HWLK6-ZOYsKlru.js → diagram-OG6HWLK6-Ds9adfRl.js} +1 -1
  275. ksadk/server/static/assets/{dist-DpKtt4Bo.js → dist-4N2NMVYg.js} +1 -1
  276. ksadk/server/static/assets/{dist-CkEKJFtk.js → dist-B-jNR6Vn.js} +1 -1
  277. ksadk/server/static/assets/{dist-D57wnGWd.js → dist-B5J2uhNk.js} +1 -1
  278. ksadk/server/static/assets/{dist-8_SfK1IP.js → dist-B5oS1zcj.js} +1 -1
  279. ksadk/server/static/assets/{dist-DMezvBGJ.js → dist-BB3-OwTQ.js} +1 -1
  280. ksadk/server/static/assets/{dist-2hInLS_J.js → dist-BIlKoW0k.js} +1 -1
  281. ksadk/server/static/assets/{dist-BrCcQ47T.js → dist-BjOdlDjj.js} +1 -1
  282. ksadk/server/static/assets/{dist-BmlMPsCc.js → dist-C1sz5Eo3.js} +1 -1
  283. ksadk/server/static/assets/{dist-B0NP_Z0z.js → dist-CWV4lDr1.js} +1 -1
  284. ksadk/server/static/assets/{dist-D-xOD048.js → dist-CmZHzlwZ.js} +1 -1
  285. ksadk/server/static/assets/{dist-DL_NKc_z.js → dist-D6MpCZtz.js} +1 -1
  286. ksadk/server/static/assets/{dist-DyOkZmze.js → dist-DJN_6Y39.js} +1 -1
  287. ksadk/server/static/assets/{dist-DmFaq_Iy.js → dist-DQU9EWw-.js} +1 -1
  288. ksadk/server/static/assets/{dist-gX6GOLKq.js → dist-DWKByxWV.js} +1 -1
  289. ksadk/server/static/assets/{dist-DyWsb78Q.js → dist-Dli7qW-B.js} +1 -1
  290. ksadk/server/static/assets/{dist-BIJVDMuB.js → dist-DsHPdk3W.js} +1 -1
  291. ksadk/server/static/assets/{dist-Dp0k7bWI.js → dist-X4TnqwOK.js} +1 -1
  292. ksadk/server/static/assets/{dist-8EEyGgDx.js → dist-_pHPTyZ-.js} +1 -1
  293. ksadk/server/static/assets/{dist-CPBtqRTW.js → dist-fhOuWds5.js} +1 -1
  294. ksadk/server/static/assets/{dist-D-JMdWPQ.js → dist-gLnrGsoU.js} +1 -1
  295. ksadk/server/static/assets/{dist-BssVmjIo.js → dist-j6Dxmf_j.js} +1 -1
  296. ksadk/server/static/assets/{dist-C3HIIaN5.js → dist-o2OVmKvt.js} +1 -1
  297. ksadk/server/static/assets/{erDiagram-TEJ5UH35-Bk-9bgE5.js → erDiagram-TEJ5UH35-BPItFKH6.js} +1 -1
  298. ksadk/server/static/assets/eventmodeling-FCH6USID-DYFSxbqr.js +1 -0
  299. ksadk/server/static/assets/{flowDiagram-I6XJVG4X-Dn9kZVuZ.js → flowDiagram-I6XJVG4X-BbYB9w5Y.js} +1 -1
  300. ksadk/server/static/assets/{ganttDiagram-6RSMTGT7-BGxXlJqm.js → ganttDiagram-6RSMTGT7-TQXa0KXv.js} +1 -1
  301. ksadk/server/static/assets/gitGraph-WXDBUCRP-DyNYp6BN.js +1 -0
  302. ksadk/server/static/assets/{gitGraphDiagram-PVQCEYII-C7Q0X-wi.js → gitGraphDiagram-PVQCEYII-bKblCnpa.js} +1 -1
  303. ksadk/server/static/assets/index-R52pJJvg.js +177 -0
  304. ksadk/server/static/assets/index-jJr3_955.css +2 -0
  305. ksadk/server/static/assets/info-J43DQDTF-WUx7qTde.js +1 -0
  306. ksadk/server/static/assets/{infoDiagram-5YYISTIA-BO_CSqq5.js → infoDiagram-5YYISTIA-BGVT7J_i.js} +1 -1
  307. ksadk/server/static/assets/{ishikawaDiagram-YF4QCWOH-eYLPLd46.js → ishikawaDiagram-YF4QCWOH-K0OOfVna.js} +1 -1
  308. ksadk/server/static/assets/{journeyDiagram-JHISSGLW-De9geSb0.js → journeyDiagram-JHISSGLW-8LeOJaZp.js} +1 -1
  309. ksadk/server/static/assets/{kanban-definition-UN3LZRKU-Cs80kQto.js → kanban-definition-UN3LZRKU-C6uCgZrW.js} +1 -1
  310. ksadk/server/static/assets/{katex-DSrCFD8n.js → katex-CYWseY5E.js} +1 -1
  311. ksadk/server/static/assets/{linear-CN9sbKTF.js → linear-hdBcYzM8.js} +1 -1
  312. ksadk/server/static/assets/{mermaid-parser.core-DlgSBU8l.js → mermaid-parser.core-BWrDjSZM.js} +2 -2
  313. ksadk/server/static/assets/{mindmap-definition-RKZ34NQL-9afz7Oug.js → mindmap-definition-RKZ34NQL-Bjy_2v4_.js} +1 -1
  314. ksadk/server/static/assets/packet-YPE3B663-BN13y_xl.js +1 -0
  315. ksadk/server/static/assets/pie-LRSECV5Y-ftSLXhhc.js +1 -0
  316. ksadk/server/static/assets/{pieDiagram-4H26LBE5-DPv_VstN.js → pieDiagram-4H26LBE5-GmmqNiVH.js} +1 -1
  317. ksadk/server/static/assets/{quadrantDiagram-W4KKPZXB-o77wZ1XK.js → quadrantDiagram-W4KKPZXB-BmkRbwCg.js} +1 -1
  318. ksadk/server/static/assets/radar-GUYGQ44K-jaICkIeO.js +1 -0
  319. ksadk/server/static/assets/{requirementDiagram-4Y6WPE33-BYVw81VC.js → requirementDiagram-4Y6WPE33-DSWFqL7c.js} +1 -1
  320. ksadk/server/static/assets/{sankeyDiagram-5OEKKPKP-B7nZFMKT.js → sankeyDiagram-5OEKKPKP-l6iXmU65.js} +1 -1
  321. ksadk/server/static/assets/{sequenceDiagram-3UESZ5HK-BGRRrFw5.js → sequenceDiagram-3UESZ5HK-Cq6UBeQB.js} +1 -1
  322. ksadk/server/static/assets/{stateDiagram-AJRCARHV-BUfHCoPs.js → stateDiagram-AJRCARHV-qzTQpg3Y.js} +1 -1
  323. ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-BYCoYGAN.js +1 -0
  324. ksadk/server/static/assets/{timeline-definition-PNZ67QCA-FbCTGrf9.js → timeline-definition-PNZ67QCA-DEz24vV0.js} +1 -1
  325. ksadk/server/static/assets/treeView-BLDUP644-Cpib_vlz.js +1 -0
  326. ksadk/server/static/assets/treemap-LRROVOQU-DQxfmVHK.js +1 -0
  327. ksadk/server/static/assets/{vennDiagram-CIIHVFJN-DWgwtPsJ.js → vennDiagram-CIIHVFJN-CMCixki2.js} +1 -1
  328. ksadk/server/static/assets/wardley-L42UT6IY-BQYHnnkU.js +1 -0
  329. ksadk/server/static/assets/{wardleyDiagram-YWT4CUSO-2x8G-tTM.js → wardleyDiagram-YWT4CUSO-CVzB8F9K.js} +1 -1
  330. ksadk/server/static/assets/{xychartDiagram-2RQKCTM6-Drma3AYl.js → xychartDiagram-2RQKCTM6-BFBqBLc1.js} +1 -1
  331. ksadk/server/static/index.html +2 -2
  332. ksadk/server/terminal_sessions.py +111 -58
  333. ksadk/sessions/__init__.py +69 -19
  334. ksadk/sessions/base.py +31 -11
  335. ksadk/sessions/continuity.py +2 -3
  336. ksadk/sessions/in_memory.py +46 -2
  337. ksadk/sessions/local_service.py +148 -17
  338. ksadk/sessions/postgres_service.py +143 -25
  339. ksadk/sessions/resilient.py +36 -8
  340. ksadk/skills/models.py +17 -5
  341. ksadk/skills/package_store.py +5 -2
  342. ksadk/skills/runtime/agent.py +20 -5
  343. ksadk/skills/runtime/artifacts.py +1 -5
  344. ksadk/skills/runtime/backends/e2b.py +10 -4
  345. ksadk/skills/runtime/backends/local.py +15 -3
  346. ksadk/skills/runtime/base.py +1 -2
  347. ksadk/skills/runtime/executor.py +10 -3
  348. ksadk/skills/runtime/factory.py +4 -2
  349. ksadk/skills/runtime/loader.py +1 -2
  350. ksadk/skills/runtime/registry.py +15 -10
  351. ksadk/skills/runtime/request.py +3 -1
  352. ksadk/skills/service_client.py +47 -16
  353. ksadk/skills/tool_defs.py +15 -10
  354. ksadk/studio/__init__.py +5 -0
  355. ksadk/studio/agent_avatar_assets.py +120 -0
  356. ksadk/studio/agent_lifecycle.py +51 -0
  357. ksadk/studio/api.py +1046 -0
  358. ksadk/studio/api_catalog_routes.py +324 -0
  359. ksadk/studio/api_contracts.py +177 -0
  360. ksadk/studio/api_helpers.py +132 -0
  361. ksadk/studio/authoring.py +524 -0
  362. ksadk/studio/authoring_coordinator.py +285 -0
  363. ksadk/studio/builder.py +320 -0
  364. ksadk/studio/capabilities.py +351 -0
  365. ksadk/studio/cloud.py +278 -0
  366. ksadk/studio/codex_agent_service.py +583 -0
  367. ksadk/studio/codex_builder.py +324 -0
  368. ksadk/studio/codex_manifest.py +278 -0
  369. ksadk/studio/codex_run.py +352 -0
  370. ksadk/studio/compiler.py +189 -0
  371. ksadk/studio/contracts.py +644 -0
  372. ksadk/studio/errors.py +47 -0
  373. ksadk/studio/evaluation.py +192 -0
  374. ksadk/studio/event_store.py +284 -0
  375. ksadk/studio/framework_run.py +114 -0
  376. ksadk/studio/identifiers.py +33 -0
  377. ksadk/studio/mcp_runtime.py +229 -0
  378. ksadk/studio/model_client.py +543 -0
  379. ksadk/studio/model_profile_service.py +214 -0
  380. ksadk/studio/operations.py +243 -0
  381. ksadk/studio/otel_trace.py +754 -0
  382. ksadk/studio/pagination.py +182 -0
  383. ksadk/studio/python_tool_inspection.py +183 -0
  384. ksadk/studio/repository.py +306 -0
  385. ksadk/studio/resource_catalog.py +1217 -0
  386. ksadk/studio/run_service.py +707 -0
  387. ksadk/studio/runtime_catalog.py +74 -0
  388. ksadk/studio/runtime_source.py +339 -0
  389. ksadk/studio/service.py +1141 -0
  390. ksadk/studio/shared_web.py +994 -0
  391. ksadk/studio/skill_discovery.py +628 -0
  392. ksadk/studio/static/assets/PrismRenderer-IYN-ffww.js +3 -0
  393. ksadk/studio/static/assets/index-CaEN0eTR.css +1 -0
  394. ksadk/studio/static/assets/index-DI2eY_NH.js +252 -0
  395. ksadk/studio/static/assets/react-vendor-BNmTiJ-I.js +9 -0
  396. ksadk/studio/static/assets/rolldown-runtime-hePW80VL.js +1 -0
  397. ksadk/studio/static/index.html +15 -0
  398. ksadk/studio/templates.py +630 -0
  399. ksadk/studio/validator.py +246 -0
  400. ksadk/studio/workspace.py +137 -0
  401. ksadk/terminal_exec_policy.py +3 -4
  402. ksadk/tools/gateway.py +101 -15
  403. ksadk/tools/result_budget.py +12 -4
  404. ksadk/toolsets/__init__.py +161 -37
  405. ksadk/toolsets/a2a.py +426 -0
  406. ksadk/toolsets/platform.py +21 -5
  407. ksadk/toolsets/sandbox.py +82 -16
  408. ksadk/toolsets/skills.py +200 -39
  409. ksadk/toolsets/web.py +123 -26
  410. ksadk/toolsets/workspace.py +212 -101
  411. ksadk/tracing/__init__.py +19 -21
  412. ksadk/tracing/exporters/inmemory_exporter.py +62 -51
  413. ksadk/tracing/setup.py +135 -506
  414. ksadk/tracing/span_utils.py +0 -41
  415. ksadk/tui/loop.py +78 -30
  416. ksadk/tui/stream_render.py +1 -0
  417. ksadk/ui_config.py +5 -3
  418. ksadk/version.py +1 -1
  419. ksadk_runtime_common/memory_backend/registry.py +56 -56
  420. ksadk_runtime_common/schemas/runtime_event_v1.json +95 -0
  421. ksadk_runtime_common/workspace_files/router.py +8 -2
  422. agentengine_sdk_python-0.7.0.dist-info/RECORD +0 -482
  423. ksadk/a2a/card_builder.py +0 -64
  424. ksadk/a2a/client.py +0 -309
  425. ksadk/runners/utils/langfuse.py +0 -230
  426. ksadk/server/static/assets/CodeBlock-P16VOLYi.js +0 -9
  427. ksadk/server/static/assets/MathMessageMarkdown-CdGiQWHR.js +0 -8
  428. ksadk/server/static/assets/MermaidBlock-IOcal8cm.js +0 -303
  429. ksadk/server/static/assets/NativeTerminalPanel-DGSDWsei.js +0 -1
  430. ksadk/server/static/assets/architecture-7EHR7CIX-BvUlsA6l.js +0 -1
  431. ksadk/server/static/assets/channel-CTuydARX.js +0 -1
  432. ksadk/server/static/assets/chunk-QZHKN3VN-BnCydivS.js +0 -1
  433. ksadk/server/static/assets/classDiagram-4FO5ZUOK-BNHg45Be.js +0 -1
  434. ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-BNHg45Be.js +0 -1
  435. ksadk/server/static/assets/eventmodeling-FCH6USID-DsAgWnlf.js +0 -1
  436. ksadk/server/static/assets/gitGraph-WXDBUCRP-BIao9Yjg.js +0 -1
  437. ksadk/server/static/assets/index-C00Lwg3L.js +0 -165
  438. ksadk/server/static/assets/index-DAURbCsP.css +0 -1
  439. ksadk/server/static/assets/info-J43DQDTF-CyipqGxU.js +0 -1
  440. ksadk/server/static/assets/packet-YPE3B663-CGkyRxlg.js +0 -1
  441. ksadk/server/static/assets/pie-LRSECV5Y-M0uWAf4n.js +0 -1
  442. ksadk/server/static/assets/radar-GUYGQ44K-Bdbm24-x.js +0 -1
  443. ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-8xBN_gLM.js +0 -1
  444. ksadk/server/static/assets/treeView-BLDUP644-npMo0ak1.js +0 -1
  445. ksadk/server/static/assets/treemap-LRROVOQU-CHdzrrdo.js +0 -1
  446. ksadk/server/static/assets/wardley-L42UT6IY-BEQz7wyy.js +0 -1
  447. ksadk/tracing/exporters/langfuse_exporter.py +0 -445
  448. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/entry_points.txt +0 -0
  449. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/licenses/LICENSE +0 -0
  450. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/top_level.txt +0 -0
ksadk/toolsets/skills.py CHANGED
@@ -18,15 +18,18 @@ from ksadk.skills.service_env import (
18
18
  user_skill_space_ids,
19
19
  )
20
20
  from ksadk.skills.tool_defs import (
21
- build_execute_skills_tool as build_runtime_execute_skills_tool,
21
+ _skill_manifest_item,
22
22
  load_remote_skill_manifests,
23
23
  resolve_skill_space_ids,
24
24
  )
25
+ from ksadk.skills.tool_defs import (
26
+ build_execute_skills_tool as build_runtime_execute_skills_tool,
27
+ )
25
28
  from ksadk.tools.gateway import ToolPolicy, default_tool_gateway
26
29
  from ksadk.toolsets._langchain import as_tool
27
30
 
28
-
29
31
  _SKILL_TOOL_POLICIES = {
32
+ "list_skill_spaces": ToolPolicy(risk_level="low"),
30
33
  "list_skills": ToolPolicy(risk_level="low"),
31
34
  "search_skills": ToolPolicy(risk_level="low"),
32
35
  "load_skill": ToolPolicy(risk_level="low", side_effects=("skill_cache_write",)),
@@ -38,27 +41,132 @@ def _gateway():
38
41
  return default_tool_gateway(_SKILL_TOOL_POLICIES)
39
42
 
40
43
 
41
- def list_skills() -> dict[str, Any]:
42
- """List skills discoverable from configured Skill Spaces."""
44
+ def _dict_result(value: Any, *, tool_name: str) -> dict[str, Any]:
45
+ if not isinstance(value, dict):
46
+ raise TypeError(f"{tool_name} returned {type(value).__name__}, expected dict")
47
+ return dict(value)
48
+
43
49
 
50
+ def list_skill_spaces() -> dict[str, Any]:
51
+ """List visible Skill Spaces with id/name/description, so the model can pick one by intent.
52
+
53
+ 多 space 场景下,先调用本工具了解可选 space,再按用户意图用
54
+ ``search_skills(query, space_id=...)`` 或 ``load_skill(name, space_id=...)`` 定向查找。
55
+ """
56
+
57
+ configured = resolve_skill_space_ids()
44
58
  try:
45
- manifests = load_remote_skill_manifests(resolve_skill_space_ids())
59
+ client = _skill_service_client()
60
+ payload = client.list_skill_spaces()
61
+ spaces = _parse_skill_spaces(payload)
62
+ configured_set = set(configured)
63
+ for space in spaces:
64
+ space["configured"] = space["space_id"] in configured_set
65
+ if not spaces:
66
+ # 服务不支持 ListSkillSpaces 时,退化为返回已配置的 space id。
67
+ spaces = [
68
+ {"space_id": sid, "space_name": "", "description": "", "configured": True}
69
+ for sid in configured
70
+ ]
71
+ return {
72
+ "ok": True,
73
+ "configured_space_ids": configured,
74
+ "spaces": spaces,
75
+ "usage": (
76
+ "根据用户意图从这些 space 中选一个 space_id,再用 "
77
+ "search_skills(query, space_id=...) 在该 space 内搜索,或用 "
78
+ "load_skill(skill_name, space_id=...) 精确加载该 space 下的 skill。"
79
+ ),
80
+ }
81
+ except Exception as exc:
82
+ return {
83
+ "ok": False,
84
+ "error_type": type(exc).__name__,
85
+ "error_message": str(exc),
86
+ "configured_space_ids": configured,
87
+ "spaces": [
88
+ {"space_id": sid, "space_name": "", "description": "", "configured": True}
89
+ for sid in configured
90
+ ],
91
+ }
92
+
93
+
94
+ def _parse_skill_spaces(payload: dict[str, Any]) -> list[dict[str, Any]]:
95
+ data = payload.get("Data") or payload.get("data") or {}
96
+ raw = (
97
+ data.get("SkillSpaces")
98
+ or data.get("skill_spaces")
99
+ or data.get("Spaces")
100
+ or data.get("spaces")
101
+ or data.get("Items")
102
+ or data.get("items")
103
+ or []
104
+ )
105
+ spaces: list[dict[str, Any]] = []
106
+ for item in raw:
107
+ if not isinstance(item, dict):
108
+ continue
109
+ spaces.append(
110
+ {
111
+ "space_id": str(
112
+ item.get("SkillSpaceId")
113
+ or item.get("skill_space_id")
114
+ or item.get("SpaceId")
115
+ or item.get("space_id")
116
+ or ""
117
+ ),
118
+ "space_name": str(
119
+ item.get("SkillSpaceName")
120
+ or item.get("skill_space_name")
121
+ or item.get("SpaceName")
122
+ or item.get("space_name")
123
+ or ""
124
+ ),
125
+ "description": str(item.get("Description") or item.get("description") or ""),
126
+ }
127
+ )
128
+ return spaces
129
+
130
+
131
+ def list_skills(space_id: str | None = None) -> dict[str, Any]:
132
+ """List skills discoverable from configured Skill Spaces, optionally limited to one space.
133
+
134
+ ``space_id`` 指定时只列该 space(user space id 或 ``"public"``);缺省列出全部已配置 space。
135
+ """
136
+
137
+ space_ids = [space_id] if space_id else resolve_skill_space_ids()
138
+ try:
139
+ if space_id:
140
+ client = _skill_service_client()
141
+ manifests = [
142
+ _skill_manifest_item(skill, space_id=sid)
143
+ for sid, skill in _iter_remote_skills(client, space_id=space_id)
144
+ if skill.name
145
+ ]
146
+ else:
147
+ manifests = load_remote_skill_manifests(space_ids)
46
148
  return {
47
149
  "ok": True,
48
150
  "skills": manifests,
49
- "skill_space_ids": resolve_skill_space_ids(),
151
+ "skill_space_ids": space_ids,
152
+ "space_id": space_id,
50
153
  }
51
154
  except Exception as exc:
52
155
  return {
53
156
  "ok": False,
54
157
  "error_type": type(exc).__name__,
55
158
  "error_message": str(exc),
56
- "skill_space_ids": resolve_skill_space_ids(),
159
+ "skill_space_ids": space_ids,
160
+ "space_id": space_id,
57
161
  }
58
162
 
59
163
 
60
- def load_skill(skill_name: str) -> dict[str, Any]:
61
- """Download and load a skill's SKILL.md instructions from configured Skill Spaces."""
164
+ def load_skill(skill_name: str, space_id: str | None = None) -> dict[str, Any]:
165
+ """Download and load a skill's SKILL.md instructions from configured Skill Spaces.
166
+
167
+ ``space_id`` 指定时只在该 space 内按名匹配,用于多 space 下精确定位、避免同名冲突;
168
+ 缺省按配置顺序(user space 优先于 public)取第一个匹配。
169
+ """
62
170
 
63
171
  target = str(skill_name or "").strip().lower()
64
172
  if not target:
@@ -66,7 +174,7 @@ def load_skill(skill_name: str) -> dict[str, Any]:
66
174
  try:
67
175
  client = _skill_service_client()
68
176
  available: list[str] = []
69
- for space_id, skill in _iter_remote_skills(client):
177
+ for sid, skill in _iter_remote_skills(client, space_id=space_id):
70
178
  if not skill.name:
71
179
  continue
72
180
  available.append(skill.name)
@@ -79,7 +187,7 @@ def load_skill(skill_name: str) -> dict[str, Any]:
79
187
  "execution_context": "outer_agent",
80
188
  "name": local_skill.name,
81
189
  "description": local_skill.description,
82
- "space_id": space_id,
190
+ "space_id": sid,
83
191
  "skill_id": skill.skill_id,
84
192
  "version_id": skill.version_id,
85
193
  "version": skill.version,
@@ -88,31 +196,52 @@ def load_skill(skill_name: str) -> dict[str, Any]:
88
196
  "has_scripts_dir": (local_skill.root_dir / "scripts").is_dir(),
89
197
  "script_files": _script_files(local_skill.root_dir),
90
198
  "instructions": local_skill.body,
91
- "usage": "Read these instructions and complete the user's task in the outer agent unless the skill explicitly requires isolated execution.",
199
+ "usage": (
200
+ "Read these instructions and complete the user's task in the outer "
201
+ "agent unless the skill explicitly requires isolated execution."
202
+ ),
92
203
  }
93
204
  return {
94
205
  "ok": False,
95
206
  "error_message": f"Skill not found: {skill_name}",
207
+ "space_id": space_id,
96
208
  "available_skills": available,
97
209
  }
98
210
  except Exception as exc:
99
211
  return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc)}
100
212
 
101
213
 
102
- def search_skills(query: str, max_results: int = 10) -> dict[str, Any]:
103
- """Search skills by name, aliases, tags, description, and examples."""
214
+ def search_skills(query: str, max_results: int = 10, space_id: str | None = None) -> dict[str, Any]:
215
+ """Search skills by name, aliases, tags, description, and examples.
216
+
217
+ ``space_id`` 指定时只在该 space 内搜索;缺省聚合全部已配置 space。结果带 ``space_id``,
218
+ 便于后续 ``load_skill(name, space_id=...)`` 精确定位。
219
+ """
104
220
 
105
221
  query_text = str(query or "").strip()
106
222
  if not query_text:
107
223
  return {"ok": False, "error_message": "query is required"}
108
224
  try:
109
225
  client = _skill_service_client()
110
- refs = [skill for _, skill in _iter_remote_skills(client)]
226
+ pairs = list(_iter_remote_skills(client, space_id=space_id))
227
+ # 建立 skill 标识 -> space_id 映射,给结果回填来源 space(cache_key 与 match 去重一致)。
228
+ space_of: dict[str, str] = {}
229
+ for sid, skill in pairs:
230
+ space_of.setdefault(skill.cache_key or skill.skill_id or skill.name, sid)
231
+ refs = [skill for _, skill in pairs]
111
232
  matches = match_skill_refs(refs, query_text, limit=max_results)
233
+ results = []
234
+ for match in matches:
235
+ item = match.to_dict()
236
+ item["space_id"] = space_of.get(
237
+ match.skill.cache_key or match.skill.skill_id or match.skill.name, ""
238
+ )
239
+ results.append(item)
112
240
  return {
113
241
  "ok": True,
114
242
  "query": query,
115
- "results": [match.to_dict() for match in matches],
243
+ "space_id": space_id,
244
+ "results": results,
116
245
  }
117
246
  except Exception as exc:
118
247
  return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc)}
@@ -125,43 +254,64 @@ def execute_skills(
125
254
  ) -> dict[str, Any]:
126
255
  """Execute a workflow through the configured Skill Runtime."""
127
256
 
128
- return _gateway().invoke(
129
- "execute_skills",
130
- _execute_skills_impl,
131
- workflow_prompt,
132
- skill_names,
133
- approval=approval,
257
+ return _dict_result(
258
+ _gateway().invoke(
259
+ "execute_skills",
260
+ _execute_skills_impl,
261
+ workflow_prompt,
262
+ skill_names,
263
+ approval=approval,
264
+ ),
265
+ tool_name="execute_skills",
134
266
  )
135
267
 
136
268
 
137
- def _execute_skills_impl(workflow_prompt: str, skill_names: list[str] | str | None = None) -> dict[str, Any]:
269
+ def _execute_skills_impl(
270
+ workflow_prompt: str, skill_names: list[str] | str | None = None
271
+ ) -> dict[str, Any]:
138
272
  try:
139
273
  backend = create_skill_runtime_backend()
140
274
  raw_tool = build_runtime_execute_skills_tool(backend=backend)
141
275
  result = raw_tool(workflow_prompt, skill_names)
142
- if isinstance(result, dict):
143
- result.setdefault("execution_context", f"skill-runtime/{_skill_execution_backend()}")
144
- return result
276
+ if not isinstance(result, dict):
277
+ return {
278
+ "ok": False,
279
+ "error_type": "invalid_skill_runtime_result",
280
+ "error_message": (f"skill runtime returned {type(result).__name__}, expected dict"),
281
+ }
282
+ result.setdefault("execution_context", f"skill-runtime/{_skill_execution_backend()}")
283
+ return dict(result)
145
284
  except SkillRuntimeError as exc:
146
285
  return {
147
286
  "ok": False,
148
287
  "error_type": "skill_runtime_disabled",
149
288
  "error_message": str(exc),
150
- "hint": "Configure KSADK_SKILL_RUNTIME_BACKEND=local_process/e2b or KSADK_SANDBOX_TEMPLATE_ID for isolated Skill workflow execution.",
289
+ "hint": (
290
+ "Configure KSADK_SKILL_RUNTIME_BACKEND=local_process/e2b or "
291
+ "KSADK_SANDBOX_TEMPLATE_ID for isolated Skill workflow execution."
292
+ ),
151
293
  }
152
294
  except Exception as exc:
153
295
  return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc)}
154
296
 
155
297
 
156
298
  def get_skill_tools() -> list:
157
- return [as_tool(list_skills), as_tool(search_skills), as_tool(load_skill), as_tool(execute_skills)]
299
+ return [
300
+ as_tool(list_skills),
301
+ as_tool(list_skill_spaces),
302
+ as_tool(search_skills),
303
+ as_tool(load_skill),
304
+ as_tool(execute_skills),
305
+ ]
158
306
 
159
307
 
160
308
  def _skill_execution_backend() -> str:
161
309
  explicit = os.environ.get("KSADK_SKILL_RUNTIME_BACKEND", "").strip().lower()
162
310
  if explicit:
163
311
  return explicit
164
- if os.environ.get("KSADK_SANDBOX_TEMPLATE_ID") or os.environ.get("KSADK_SKILL_RUNTIME_TEMPLATE_ID"):
312
+ if os.environ.get("KSADK_SANDBOX_TEMPLATE_ID") or os.environ.get(
313
+ "KSADK_SKILL_RUNTIME_TEMPLATE_ID"
314
+ ):
165
315
  return "e2b"
166
316
  return "disabled"
167
317
 
@@ -177,21 +327,34 @@ def _skill_service_client() -> SkillServiceClient:
177
327
  )
178
328
 
179
329
 
180
- def _iter_remote_skills(client: SkillServiceClient):
181
- for space_id in user_skill_space_ids():
330
+ def _iter_space_skills(client: SkillServiceClient, space_id: str):
331
+ """遍历单个 space 的 active skill;space_id="public" 走 premade 列表。"""
332
+
333
+ if space_id == "public":
334
+ listing = client.list_available_premade_skills()
335
+ for skill in select_public_skill_refs(listing.active_skills()):
336
+ yield listing.space_id or "public", skill
337
+ else:
182
338
  listing = client.list_skills_by_space_id(space_id)
183
339
  for skill in listing.active_skills():
184
340
  yield space_id, skill
341
+
342
+
343
+ def _iter_remote_skills(client: SkillServiceClient, space_id: str | None = None):
344
+ """遍历配置的 space;space_id 指定时只遍历该 space(user 或 "public")。"""
345
+
346
+ if space_id:
347
+ yield from _iter_space_skills(client, space_id)
348
+ return
349
+ for user_space_id in user_skill_space_ids():
350
+ yield from _iter_space_skills(client, user_space_id)
185
351
  if public_skill_space_ids():
186
- listing = client.list_available_premade_skills()
187
- for skill in select_public_skill_refs(listing.active_skills()):
188
- yield listing.space_id or "public", skill
352
+ yield from _iter_space_skills(client, "public")
189
353
 
190
354
 
191
355
  def _get_or_download_package(client: SkillServiceClient, skill):
192
356
  cache_dir = Path(
193
- os.environ.get("KSADK_SKILL_CACHE_DIR")
194
- or Path(tempfile.gettempdir()) / "ksadk-skill-cache"
357
+ os.environ.get("KSADK_SKILL_CACHE_DIR") or Path(tempfile.gettempdir()) / "ksadk-skill-cache"
195
358
  )
196
359
  store = PackageStore(cache_dir=cache_dir)
197
360
  package = store.get_cached(skill)
@@ -211,7 +374,5 @@ def _script_files(root_dir: Path) -> list[str]:
211
374
  if not scripts_dir.is_dir():
212
375
  return []
213
376
  return [
214
- str(path.relative_to(root_dir))
215
- for path in sorted(scripts_dir.rglob("*"))
216
- if path.is_file()
377
+ str(path.relative_to(root_dir)) for path in sorted(scripts_dir.rglob("*")) if path.is_file()
217
378
  ][:20]
ksadk/toolsets/web.py CHANGED
@@ -15,10 +15,17 @@ from ksadk.tools.gateway import ToolPolicy, default_tool_gateway
15
15
  from ksadk.tools.result_budget import budget_tool_output, default_tool_result_budget
16
16
  from ksadk.toolsets._langchain import as_tool
17
17
 
18
-
19
18
  _WEB_TOOL_POLICIES = {
20
- "web_fetch": ToolPolicy(risk_level="low"),
21
- "web_search": ToolPolicy(risk_level="low"),
19
+ "web_fetch": ToolPolicy(
20
+ risk_level="low",
21
+ approval_scopes=("public_network",),
22
+ approval_exempt=True,
23
+ ),
24
+ "web_search": ToolPolicy(
25
+ risk_level="low",
26
+ approval_scopes=("public_network",),
27
+ approval_exempt=True,
28
+ ),
22
29
  }
23
30
 
24
31
 
@@ -26,10 +33,19 @@ def _gateway():
26
33
  return default_tool_gateway(_WEB_TOOL_POLICIES)
27
34
 
28
35
 
36
+ def _dict_result(value: Any, *, tool_name: str) -> dict[str, Any]:
37
+ if not isinstance(value, dict):
38
+ raise TypeError(f"{tool_name} returned {type(value).__name__}, expected dict")
39
+ return dict(value)
40
+
41
+
29
42
  def web_fetch(url: str, max_chars: int | None = None, timeout: int = 30) -> dict:
30
43
  """Fetch a public HTTP(S) URL and return sanitized text content."""
31
44
 
32
- return _gateway().invoke("web_fetch", _web_fetch_impl, url, max_chars, timeout)
45
+ return _dict_result(
46
+ _gateway().invoke("web_fetch", _web_fetch_impl, url, max_chars, timeout),
47
+ tool_name="web_fetch",
48
+ )
33
49
 
34
50
 
35
51
  def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -> dict:
@@ -44,9 +60,19 @@ def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -
44
60
  with httpx.Client(follow_redirects=False, timeout=timeout) as client:
45
61
  response = client.get(current_url)
46
62
  except httpx.TimeoutException:
47
- return {"ok": False, "error_type": "timeout", "error_message": "web_fetch timed out", "url": current_url}
63
+ return {
64
+ "ok": False,
65
+ "error_type": "timeout",
66
+ "error_message": "web_fetch timed out",
67
+ "url": current_url,
68
+ }
48
69
  except httpx.HTTPError as exc:
49
- return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc), "url": current_url}
70
+ return {
71
+ "ok": False,
72
+ "error_type": type(exc).__name__,
73
+ "error_message": str(exc),
74
+ "url": current_url,
75
+ }
50
76
  if response.is_redirect and response.headers.get("location"):
51
77
  current_url = urljoin(current_url, str(response.headers["location"]))
52
78
  continue
@@ -58,7 +84,9 @@ def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -
58
84
  field_name="text",
59
85
  value=text,
60
86
  metadata={"tool_use_id": "web_fetch"},
61
- budget=default_tool_result_budget(max_chars=limit, preview_chars=limit, persist_threshold_chars=limit),
87
+ budget=default_tool_result_budget(
88
+ max_chars=limit, preview_chars=limit, persist_threshold_chars=limit
89
+ ),
62
90
  )
63
91
  return {
64
92
  "ok": True,
@@ -68,13 +96,21 @@ def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -
68
96
  "content_type": content_type,
69
97
  **budgeted,
70
98
  }
71
- return {"ok": False, "error_type": "too_many_redirects", "error_message": "web_fetch exceeded redirect limit", "url": url}
99
+ return {
100
+ "ok": False,
101
+ "error_type": "too_many_redirects",
102
+ "error_message": "web_fetch exceeded redirect limit",
103
+ "url": url,
104
+ }
72
105
 
73
106
 
74
107
  def web_search(query: str, max_results: int = 5, recency_days: int | None = None) -> dict:
75
108
  """Search the web and return title/url/snippet results without fetching full pages."""
76
109
 
77
- return _gateway().invoke("web_search", _web_search_impl, query, max_results, recency_days)
110
+ return _dict_result(
111
+ _gateway().invoke("web_search", _web_search_impl, query, max_results, recency_days),
112
+ tool_name="web_search",
113
+ )
78
114
 
79
115
 
80
116
  def _web_search_impl(query: str, max_results: int = 5, recency_days: int | None = None) -> dict:
@@ -83,7 +119,11 @@ def _web_search_impl(query: str, max_results: int = 5, recency_days: int | None
83
119
  return {"ok": False, "error_type": "query_required", "error_message": "query is required"}
84
120
  provider = _web_search_provider()
85
121
  if not provider:
86
- return {"ok": False, "error_type": "provider_not_configured", "error_message": "web search provider is not configured"}
122
+ return {
123
+ "ok": False,
124
+ "error_type": "provider_not_configured",
125
+ "error_message": "web search provider is not configured",
126
+ }
87
127
  if provider == "fake":
88
128
  return {
89
129
  "ok": True,
@@ -103,7 +143,11 @@ def _web_search_impl(query: str, max_results: int = 5, recency_days: int | None
103
143
  return _web_search_http(text, max_results=max_results, recency_days=recency_days)
104
144
  if provider == "ksyun":
105
145
  return _web_search_ksyun(text, max_results=max_results)
106
- return {"ok": False, "error_type": "provider_not_configured", "error_message": f"unsupported web search provider: {provider}"}
146
+ return {
147
+ "ok": False,
148
+ "error_type": "provider_not_configured",
149
+ "error_message": f"unsupported web search provider: {provider}",
150
+ }
107
151
 
108
152
 
109
153
  def get_web_tools() -> list:
@@ -112,17 +156,35 @@ def get_web_tools() -> list:
112
156
 
113
157
  def _web_search_provider() -> str:
114
158
  return (
115
- os.environ.get("KSADK_WEB_SEARCH_PROVIDER")
116
- or os.environ.get("OPENCLAW_WEB_SEARCH_PROVIDER")
117
- or ""
118
- ).strip().lower()
159
+ (
160
+ os.environ.get("KSADK_WEB_SEARCH_PROVIDER")
161
+ or os.environ.get("OPENCLAW_WEB_SEARCH_PROVIDER")
162
+ or ""
163
+ )
164
+ .strip()
165
+ .lower()
166
+ )
119
167
 
120
168
 
121
- def _web_search_http(query: str, *, max_results: int = 5, recency_days: int | None = None) -> dict[str, Any]:
122
- base_url = str(os.environ.get("KSADK_WEB_SEARCH_BASE_URL") or os.environ.get("OPENCLAW_WEB_SEARCH_BASE_URL") or "").strip()
169
+ def _web_search_http(
170
+ query: str, *, max_results: int = 5, recency_days: int | None = None
171
+ ) -> dict[str, Any]:
172
+ base_url = str(
173
+ os.environ.get("KSADK_WEB_SEARCH_BASE_URL")
174
+ or os.environ.get("OPENCLAW_WEB_SEARCH_BASE_URL")
175
+ or ""
176
+ ).strip()
123
177
  if not base_url:
124
- return {"ok": False, "error_type": "provider_not_configured", "error_message": "web search base URL is not configured"}
125
- api_key = str(os.environ.get("KSADK_WEB_SEARCH_API_KEY") or os.environ.get("OPENCLAW_WEB_SEARCH_API_KEY") or "").strip()
178
+ return {
179
+ "ok": False,
180
+ "error_type": "provider_not_configured",
181
+ "error_message": "web search base URL is not configured",
182
+ }
183
+ api_key = str(
184
+ os.environ.get("KSADK_WEB_SEARCH_API_KEY")
185
+ or os.environ.get("OPENCLAW_WEB_SEARCH_API_KEY")
186
+ or ""
187
+ ).strip()
126
188
  params: dict[str, Any] = {"q": query, "max_results": max(1, int(max_results or 5))}
127
189
  if recency_days is not None:
128
190
  params["recency_days"] = int(recency_days)
@@ -190,7 +252,14 @@ def _web_search_ksyun(query: str, *, max_results: int = 5) -> dict[str, Any]:
190
252
  endpoint = _ksyun_search_endpoint()
191
253
  api_key = _ksyun_search_api_key()
192
254
  if not api_key:
193
- return {"ok": False, "error_type": "provider_not_configured", "error_message": "ksyun web search api key is not configured (KSADK_WEB_SEARCH_API_KEY / KSADK_MCP_KEY / KSC_AIPRO_API_KEY)"}
255
+ return {
256
+ "ok": False,
257
+ "error_type": "provider_not_configured",
258
+ "error_message": (
259
+ "ksyun web search api key is not configured "
260
+ "(KSADK_WEB_SEARCH_API_KEY / KSADK_MCP_KEY / KSC_AIPRO_API_KEY)"
261
+ ),
262
+ }
194
263
  size = max(1, min(int(max_results or 5), 200))
195
264
  headers = {"Content-Type": "application/json", "Authorization": f"Bearer {api_key}"}
196
265
  payload_body = {"q": query, "scope": _ksyun_search_scope(), "size": size}
@@ -231,25 +300,53 @@ def _web_search_ksyun(query: str, *, max_results: int = 5) -> dict[str, Any]:
231
300
  def _validate_public_http_url(url: str) -> dict | None:
232
301
  parsed = urlparse(url)
233
302
  if parsed.scheme not in {"http", "https"}:
234
- return {"ok": False, "error_type": "unsupported_scheme", "error_message": "only http and https URLs are supported", "url": url}
303
+ return {
304
+ "ok": False,
305
+ "error_type": "unsupported_scheme",
306
+ "error_message": "only http and https URLs are supported",
307
+ "url": url,
308
+ }
235
309
  if not parsed.hostname:
236
- return {"ok": False, "error_type": "invalid_url", "error_message": "URL host is required", "url": url}
310
+ return {
311
+ "ok": False,
312
+ "error_type": "invalid_url",
313
+ "error_message": "URL host is required",
314
+ "url": url,
315
+ }
237
316
  policy = _ssrf_policy()
238
317
  if policy.get("allow_private") is True:
239
318
  return None
240
319
  try:
241
- addresses = socket.getaddrinfo(parsed.hostname, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
320
+ addresses = socket.getaddrinfo(
321
+ parsed.hostname,
322
+ parsed.port or (443 if parsed.scheme == "https" else 80),
323
+ type=socket.SOCK_STREAM,
324
+ )
242
325
  except socket.gaierror as exc:
243
- return {"ok": False, "error_type": "dns_resolution_failed", "error_message": str(exc), "url": url}
326
+ return {
327
+ "ok": False,
328
+ "error_type": "dns_resolution_failed",
329
+ "error_message": str(exc),
330
+ "url": url,
331
+ }
244
332
  for address in addresses:
245
333
  ip = ipaddress.ip_address(address[4][0])
246
334
  if ip.is_loopback or ip.is_private or ip.is_link_local or ip.is_multicast or ip.is_reserved:
247
- return {"ok": False, "error_type": "blocked_by_ssrf_policy", "error_message": f"blocked non-public address: {ip}", "url": url}
335
+ return {
336
+ "ok": False,
337
+ "error_type": "blocked_by_ssrf_policy",
338
+ "error_message": f"blocked non-public address: {ip}",
339
+ "url": url,
340
+ }
248
341
  return None
249
342
 
250
343
 
251
344
  def _ssrf_policy() -> dict:
252
- raw = os.environ.get("KSADK_WEB_SSRF_POLICY_JSON") or os.environ.get("OPENCLAW_BROWSER_SSRF_POLICY_JSON") or ""
345
+ raw = (
346
+ os.environ.get("KSADK_WEB_SSRF_POLICY_JSON")
347
+ or os.environ.get("OPENCLAW_BROWSER_SSRF_POLICY_JSON")
348
+ or ""
349
+ )
253
350
  if not raw:
254
351
  return {}
255
352
  try: