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
@@ -0,0 +1,351 @@
1
+ """Capability resolution for local Skills, MCP servers, and Tool contracts."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import hashlib
6
+ import json
7
+ import re
8
+ from pathlib import Path
9
+ from typing import Any, Protocol, cast
10
+
11
+ from ksadk.studio.contracts import (
12
+ CapabilityRef,
13
+ MCPServerRef,
14
+ ModelSpec,
15
+ ResolvedModel,
16
+ ToolContract,
17
+ )
18
+ from ksadk.studio.errors import StudioError
19
+ from ksadk.studio.repository import load_yaml_file
20
+ from ksadk.studio.workspace import Workspace
21
+
22
+ _EXACT_SEMVER = re.compile(r"^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$")
23
+
24
+
25
+ def canonical_json(payload: Any) -> bytes:
26
+ return json.dumps(
27
+ payload,
28
+ ensure_ascii=False,
29
+ sort_keys=True,
30
+ separators=(",", ":"),
31
+ ).encode("utf-8")
32
+
33
+
34
+ def sha256_digest(payload: bytes) -> str:
35
+ return f"sha256:{hashlib.sha256(payload).hexdigest()}"
36
+
37
+
38
+ def require_exact_version(version: str, *, field: str) -> None:
39
+ if not _EXACT_SEMVER.fullmatch(version):
40
+ raise StudioError(
41
+ "CAPABILITY_VERSION_MUTABLE",
42
+ "能力依赖必须使用确定的语义化版本",
43
+ status_code=422,
44
+ field=field,
45
+ details={"version": version},
46
+ )
47
+
48
+
49
+ class CapabilityResolver(Protocol):
50
+ def resolve_model(self, spec: ModelSpec) -> ResolvedModel: ...
51
+
52
+ def resolve_skill(self, ref: CapabilityRef) -> dict[str, Any]: ...
53
+
54
+ def resolve_mcp(self, ref: MCPServerRef) -> dict[str, Any]: ...
55
+
56
+ def resolve_tool(self, contract: ToolContract) -> ToolContract: ...
57
+
58
+
59
+ class LocalCapabilityResolver:
60
+ def __init__(self, workspace: Workspace) -> None:
61
+ self.workspace = workspace
62
+
63
+ def resolve_model(self, spec: ModelSpec) -> ResolvedModel:
64
+ endpoint = self._normalize_endpoint(spec)
65
+ return ResolvedModel(
66
+ provider=spec.provider,
67
+ model=spec.model,
68
+ endpoint_url=endpoint,
69
+ credential_ref=spec.credential_ref,
70
+ parameters=spec.parameters,
71
+ wire_api=spec.wire_api,
72
+ )
73
+
74
+ def resolve_skill(self, ref: CapabilityRef) -> dict[str, Any]:
75
+ require_exact_version(ref.version, field=f"spec.capabilities.skills[{ref.name}].version")
76
+ root = self.workspace.resolve(Path("capabilities/skills") / ref.name)
77
+ if not root.is_dir():
78
+ raise StudioError(
79
+ "CAPABILITY_UNRESOLVED",
80
+ "本地 Skill 不存在",
81
+ status_code=422,
82
+ details={"kind": "skill", "name": ref.name},
83
+ )
84
+ digest = self._directory_digest(root)
85
+ if ref.digest and ref.digest != digest:
86
+ raise StudioError(
87
+ "CAPABILITY_DIGEST_MISMATCH",
88
+ "Skill 内容与声明 digest 不一致",
89
+ status_code=422,
90
+ details={"name": ref.name, "expected": ref.digest, "actual": digest},
91
+ )
92
+ manifest_path = root / "skill.yaml"
93
+ manifest = load_yaml_file(manifest_path) if manifest_path.is_file() else {}
94
+ instructions_file = str(manifest.get("instructionsFile") or "SKILL.md")
95
+ instructions_path = self.workspace.resolve(root / instructions_file)
96
+ instructions = (
97
+ instructions_path.read_text(encoding="utf-8")
98
+ if instructions_path.is_file()
99
+ else ""
100
+ )
101
+ return {
102
+ "name": ref.name,
103
+ "version": ref.version,
104
+ "digest": digest,
105
+ "bundlePath": f"capabilities/skills/{ref.name}",
106
+ "instructions": instructions,
107
+ }
108
+
109
+ def resolve_mcp(self, ref: MCPServerRef) -> dict[str, Any]:
110
+ require_exact_version(
111
+ ref.version,
112
+ field=f"spec.capabilities.mcpServers[{ref.name}].version",
113
+ )
114
+ payload = ref.model_dump(by_alias=True, exclude_none=True, mode="json")
115
+ payload.pop("digest", None)
116
+ digest = sha256_digest(canonical_json(payload))
117
+ if ref.digest and ref.digest != digest:
118
+ raise StudioError(
119
+ "CAPABILITY_DIGEST_MISMATCH",
120
+ "MCP 配置与声明 digest 不一致",
121
+ status_code=422,
122
+ details={"name": ref.name, "expected": ref.digest, "actual": digest},
123
+ )
124
+ payload["digest"] = digest
125
+ return cast(dict[str, Any], payload)
126
+
127
+ def resolve_tool(self, contract: ToolContract) -> ToolContract:
128
+ require_exact_version(
129
+ contract.version,
130
+ field=f"spec.capabilities.tools[{contract.name}].version",
131
+ )
132
+ payload = contract.model_dump(by_alias=True, exclude_none=True, mode="json")
133
+ payload.pop("digest", None)
134
+ digest = sha256_digest(canonical_json(payload))
135
+ if contract.digest and contract.digest != digest:
136
+ raise StudioError(
137
+ "CAPABILITY_DIGEST_MISMATCH",
138
+ "Tool 合同与声明 digest 不一致",
139
+ status_code=422,
140
+ details={"name": contract.name, "expected": contract.digest, "actual": digest},
141
+ )
142
+ return cast(
143
+ ToolContract,
144
+ contract.model_copy(update={"digest": digest}),
145
+ )
146
+
147
+ @staticmethod
148
+ def _normalize_endpoint(spec: ModelSpec) -> str:
149
+ if spec.endpoint_url:
150
+ return spec.endpoint_url.rstrip("/")
151
+ assert spec.base_url
152
+ base = spec.base_url.rstrip("/")
153
+ suffix = "/responses" if spec.wire_api == "responses" else "/chat/completions"
154
+ return f"{base}{suffix}"
155
+
156
+ def _directory_digest(self, root: Path) -> str:
157
+ digest = hashlib.sha256()
158
+ files = [path for path in root.rglob("*") if path.is_file() and not path.is_symlink()]
159
+ for path in sorted(files, key=lambda item: item.relative_to(root).as_posix()):
160
+ relative = path.relative_to(root).as_posix().encode("utf-8")
161
+ digest.update(len(relative).to_bytes(4, "big"))
162
+ digest.update(relative)
163
+ content = path.read_bytes()
164
+ digest.update(len(content).to_bytes(8, "big"))
165
+ digest.update(content)
166
+ return f"sha256:{digest.hexdigest()}"
167
+
168
+
169
+ def builtin_tool_contracts() -> dict[str, ToolContract]:
170
+ return {
171
+ "builtin.echo": ToolContract(
172
+ name="builtin.echo",
173
+ version="1.0.0",
174
+ description="回显结构化输入",
175
+ input_schema={"type": "object", "additionalProperties": True},
176
+ output_schema={"type": "object", "additionalProperties": True},
177
+ side_effect="none",
178
+ ),
179
+ "builtin.current_time": ToolContract(
180
+ name="builtin.current_time",
181
+ version="1.0.0",
182
+ description="返回指定时区的当前时间",
183
+ input_schema={
184
+ "type": "object",
185
+ "properties": {"timezone": {"type": "string"}},
186
+ "additionalProperties": False,
187
+ },
188
+ output_schema={
189
+ "type": "object",
190
+ "required": ["iso8601", "timezone"],
191
+ "properties": {
192
+ "iso8601": {"type": "string"},
193
+ "timezone": {"type": "string"},
194
+ },
195
+ },
196
+ permissions=["system:time:read"],
197
+ side_effect="read",
198
+ ),
199
+ "workspace.read": ToolContract(
200
+ name="workspace.read",
201
+ version="1.0.0",
202
+ description="读取当前 Agent 工作区内的 UTF-8 文本文件",
203
+ input_schema={
204
+ "type": "object",
205
+ "required": ["path"],
206
+ "properties": {
207
+ "path": {"type": "string"},
208
+ "maxChars": {
209
+ "type": "integer",
210
+ "minimum": 1,
211
+ "maximum": 200000,
212
+ "default": 50000,
213
+ },
214
+ },
215
+ "additionalProperties": False,
216
+ },
217
+ output_schema={
218
+ "type": "object",
219
+ "required": ["path", "content", "truncated"],
220
+ "properties": {
221
+ "path": {"type": "string"},
222
+ "content": {"type": "string"},
223
+ "truncated": {"type": "boolean"},
224
+ },
225
+ },
226
+ permissions=["workspace:file:read"],
227
+ side_effect="read",
228
+ ),
229
+ "workspace.write": ToolContract(
230
+ name="workspace.write",
231
+ version="1.0.0",
232
+ description="在当前 Agent 工作区内写入 UTF-8 文本文件",
233
+ input_schema={
234
+ "type": "object",
235
+ "required": ["path", "content"],
236
+ "properties": {
237
+ "path": {"type": "string"},
238
+ "content": {"type": "string", "maxLength": 1000000},
239
+ },
240
+ "additionalProperties": False,
241
+ },
242
+ output_schema={
243
+ "type": "object",
244
+ "required": ["path", "bytesWritten"],
245
+ "properties": {
246
+ "path": {"type": "string"},
247
+ "bytesWritten": {"type": "integer"},
248
+ },
249
+ },
250
+ permissions=["workspace:file:write"],
251
+ side_effect="write",
252
+ approval="always",
253
+ ),
254
+ "workspace.edit": ToolContract(
255
+ name="workspace.edit",
256
+ version="1.0.0",
257
+ description="在当前 Agent 工作区文本文件中执行精确替换",
258
+ input_schema={
259
+ "type": "object",
260
+ "required": ["path", "oldText", "newText"],
261
+ "properties": {
262
+ "path": {"type": "string"},
263
+ "oldText": {"type": "string", "minLength": 1},
264
+ "newText": {"type": "string"},
265
+ "replaceAll": {"type": "boolean", "default": False},
266
+ },
267
+ "additionalProperties": False,
268
+ },
269
+ output_schema={
270
+ "type": "object",
271
+ "required": ["path", "replacements"],
272
+ "properties": {
273
+ "path": {"type": "string"},
274
+ "replacements": {"type": "integer"},
275
+ },
276
+ },
277
+ permissions=["workspace:file:read", "workspace:file:write"],
278
+ side_effect="write",
279
+ approval="always",
280
+ ),
281
+ "workspace.glob": ToolContract(
282
+ name="workspace.glob",
283
+ version="1.0.0",
284
+ description="按 glob pattern 列出当前 Agent 工作区文件",
285
+ input_schema={
286
+ "type": "object",
287
+ "required": ["pattern"],
288
+ "properties": {
289
+ "pattern": {"type": "string"},
290
+ "limit": {
291
+ "type": "integer",
292
+ "minimum": 1,
293
+ "maximum": 1000,
294
+ "default": 200,
295
+ },
296
+ },
297
+ "additionalProperties": False,
298
+ },
299
+ output_schema={
300
+ "type": "object",
301
+ "required": ["matches", "truncated"],
302
+ "properties": {
303
+ "matches": {"type": "array", "items": {"type": "string"}},
304
+ "truncated": {"type": "boolean"},
305
+ },
306
+ },
307
+ permissions=["workspace:file:list"],
308
+ side_effect="read",
309
+ ),
310
+ "workspace.grep": ToolContract(
311
+ name="workspace.grep",
312
+ version="1.0.0",
313
+ description="在当前 Agent 工作区 UTF-8 文本文件中搜索字符串",
314
+ input_schema={
315
+ "type": "object",
316
+ "required": ["query"],
317
+ "properties": {
318
+ "query": {"type": "string", "minLength": 1},
319
+ "filePattern": {"type": "string", "default": "**/*"},
320
+ "limit": {
321
+ "type": "integer",
322
+ "minimum": 1,
323
+ "maximum": 1000,
324
+ "default": 200,
325
+ },
326
+ },
327
+ "additionalProperties": False,
328
+ },
329
+ output_schema={
330
+ "type": "object",
331
+ "required": ["matches", "truncated"],
332
+ "properties": {
333
+ "matches": {
334
+ "type": "array",
335
+ "items": {
336
+ "type": "object",
337
+ "required": ["path", "line", "text"],
338
+ "properties": {
339
+ "path": {"type": "string"},
340
+ "line": {"type": "integer"},
341
+ "text": {"type": "string"},
342
+ },
343
+ },
344
+ },
345
+ "truncated": {"type": "boolean"},
346
+ },
347
+ },
348
+ permissions=["workspace:file:read", "workspace:file:list"],
349
+ side_effect="read",
350
+ ),
351
+ }
ksadk/studio/cloud.py ADDED
@@ -0,0 +1,278 @@
1
+ """Cloud Artifact Admission and Deployment gateway contracts."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import hashlib
6
+ import json
7
+ from pathlib import Path
8
+ from typing import Any, Protocol, cast
9
+ from uuid import uuid4
10
+
11
+ import httpx
12
+
13
+ from ksadk.studio.contracts import (
14
+ BuildStatus,
15
+ DeploymentRecord,
16
+ DeploymentRequest,
17
+ )
18
+ from ksadk.studio.errors import StudioError
19
+ from ksadk.studio.repository import BuildRepository
20
+ from ksadk.studio.workspace import Workspace
21
+
22
+
23
+ class CloudDeploymentGateway(Protocol):
24
+ async def upload_bundle(
25
+ self,
26
+ *,
27
+ bundle: bytes,
28
+ bundle_digest: str,
29
+ provenance: dict[str, Any],
30
+ ) -> str: ...
31
+
32
+ async def create_version(
33
+ self,
34
+ *,
35
+ agent_id: str,
36
+ bundle_uri: str,
37
+ bundle_digest: str,
38
+ provenance: dict[str, Any],
39
+ ) -> str: ...
40
+
41
+ async def create_deployment(
42
+ self,
43
+ *,
44
+ build_id: str,
45
+ version_id: str,
46
+ bundle_digest: str,
47
+ request: DeploymentRequest,
48
+ ) -> DeploymentRecord: ...
49
+
50
+
51
+ class UnavailableCloudGateway:
52
+ async def upload_bundle(self, **_kwargs) -> str:
53
+ raise StudioError(
54
+ "CLOUD_BUNDLE_ADMISSION_UNAVAILABLE",
55
+ "当前未配置支持 AgentBundle Admission 的云端控制面",
56
+ status_code=501,
57
+ )
58
+
59
+ async def create_version(self, **_kwargs) -> str:
60
+ raise AssertionError("upload_bundle must fail first")
61
+
62
+ async def create_deployment(self, **_kwargs) -> DeploymentRecord:
63
+ raise AssertionError("upload_bundle must fail first")
64
+
65
+
66
+ class InMemoryCloudGateway:
67
+ """Contract-test gateway; it records exactly what would cross the cloud boundary."""
68
+
69
+ def __init__(self) -> None:
70
+ self.uploads: list[dict[str, Any]] = []
71
+ self.versions: list[dict[str, Any]] = []
72
+ self.deployments: list[DeploymentRecord] = []
73
+
74
+ async def upload_bundle(self, **kwargs) -> str:
75
+ self.uploads.append(kwargs)
76
+ return f"memory://artifacts/{kwargs['bundle_digest']}"
77
+
78
+ async def create_version(self, **kwargs) -> str:
79
+ self.versions.append(kwargs)
80
+ return f"ver_{uuid4().hex}"
81
+
82
+ async def create_deployment(self, **kwargs) -> DeploymentRecord:
83
+ record = DeploymentRecord(
84
+ id=f"dep_{uuid4().hex}",
85
+ build_id=kwargs["build_id"],
86
+ bundle_digest=kwargs["bundle_digest"],
87
+ version_id=kwargs["version_id"],
88
+ status="READY",
89
+ target=kwargs["request"].target,
90
+ )
91
+ self.deployments.append(record)
92
+ return record
93
+
94
+
95
+ class HttpCloudDeploymentGateway:
96
+ def __init__(self, *, base_url: str, bearer_token: str) -> None:
97
+ self.base_url = base_url.rstrip("/")
98
+ self.bearer_token = bearer_token
99
+
100
+ async def upload_bundle(self, **kwargs) -> str:
101
+ headers = {"Authorization": f"Bearer {self.bearer_token}"}
102
+ async with httpx.AsyncClient(follow_redirects=False, timeout=60) as client:
103
+ create = await client.post(
104
+ f"{self.base_url}/v1/artifact-uploads",
105
+ headers=headers,
106
+ json={
107
+ "bundleDigest": kwargs["bundle_digest"],
108
+ "size": len(kwargs["bundle"]),
109
+ "provenance": kwargs["provenance"],
110
+ },
111
+ )
112
+ self._raise(create)
113
+ upload = create.json()
114
+ put = await client.put(
115
+ upload["uploadUrl"],
116
+ content=kwargs["bundle"],
117
+ headers=upload.get("headers") or {},
118
+ )
119
+ self._raise(put)
120
+ return str(upload["artifactUri"])
121
+
122
+ async def create_version(self, **kwargs) -> str:
123
+ async with httpx.AsyncClient(follow_redirects=False, timeout=30) as client:
124
+ response = await client.post(
125
+ f"{self.base_url}/v1/agents/{kwargs['agent_id']}/versions",
126
+ headers={"Authorization": f"Bearer {self.bearer_token}"},
127
+ json={
128
+ "bundle": {
129
+ "uri": kwargs["bundle_uri"],
130
+ "digest": kwargs["bundle_digest"],
131
+ },
132
+ "provenance": kwargs["provenance"],
133
+ },
134
+ )
135
+ self._raise(response)
136
+ return str(response.json()["versionId"])
137
+
138
+ async def create_deployment(self, **kwargs) -> DeploymentRecord:
139
+ request: DeploymentRequest = kwargs["request"]
140
+ async with httpx.AsyncClient(follow_redirects=False, timeout=30) as client:
141
+ response = await client.post(
142
+ f"{self.base_url}/v1/deployments",
143
+ headers={"Authorization": f"Bearer {self.bearer_token}"},
144
+ json={
145
+ "versionId": kwargs["version_id"],
146
+ "bundleDigest": kwargs["bundle_digest"],
147
+ **request.model_dump(by_alias=True, mode="json"),
148
+ },
149
+ )
150
+ self._raise(response)
151
+ return cast(DeploymentRecord, DeploymentRecord.model_validate(response.json()))
152
+
153
+ @staticmethod
154
+ def _raise(response: httpx.Response) -> None:
155
+ if response.status_code < 400:
156
+ return
157
+ raise StudioError(
158
+ "CLOUD_ADMISSION_REJECTED",
159
+ "云端拒绝 AgentBundle 或 Deployment",
160
+ status_code=422,
161
+ details={"upstreamStatus": response.status_code},
162
+ )
163
+
164
+
165
+ class CloudDeploymentService:
166
+ def __init__(
167
+ self,
168
+ workspace: Workspace,
169
+ *,
170
+ gateway: CloudDeploymentGateway,
171
+ build_repository: BuildRepository | None = None,
172
+ ) -> None:
173
+ self.workspace = workspace
174
+ self.gateway = gateway
175
+ self.build_repository = build_repository or BuildRepository(workspace)
176
+
177
+ async def deploy(
178
+ self,
179
+ build_id: str,
180
+ request: DeploymentRequest,
181
+ ) -> DeploymentRecord:
182
+ build = self.build_repository.get(build_id)
183
+ if build.status != BuildStatus.SUCCEEDED or not build.artifact_path:
184
+ raise StudioError(
185
+ "BUILD_NOT_READY",
186
+ "只有成功 Build 可以部署",
187
+ status_code=409,
188
+ )
189
+ archive = self.workspace.resolve(build.artifact_path, must_exist=True)
190
+ manifest_path = archive.parent / "agent-bundle" / "manifest.json"
191
+ provenance_path = archive.parent / "agent-bundle" / "provenance.json"
192
+ manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
193
+ if manifest.get("bundleDigest") != build.bundle_digest:
194
+ raise StudioError(
195
+ "BUILD_DIGEST_MISMATCH",
196
+ "上传前 Bundle digest 校验失败",
197
+ status_code=422,
198
+ )
199
+ bundle = archive.read_bytes()
200
+ archive_sha256 = f"sha256:{hashlib.sha256(bundle).hexdigest()}"
201
+ provenance = json.loads(provenance_path.read_text(encoding="utf-8"))
202
+ provenance["archiveSha256"] = archive_sha256
203
+ bundle_uri = await self.gateway.upload_bundle(
204
+ bundle=bundle,
205
+ bundle_digest=build.bundle_digest,
206
+ provenance=provenance,
207
+ )
208
+ version_id = await self.gateway.create_version(
209
+ agent_id=build.agent_id,
210
+ bundle_uri=bundle_uri,
211
+ bundle_digest=build.bundle_digest,
212
+ provenance=provenance,
213
+ )
214
+ record = await self.gateway.create_deployment(
215
+ build_id=build_id,
216
+ version_id=version_id,
217
+ bundle_digest=build.bundle_digest,
218
+ request=request,
219
+ )
220
+ self._save(record, request)
221
+ return record
222
+
223
+ def get(self, deployment_id: str) -> DeploymentRecord:
224
+ path = self.workspace.resolve(
225
+ Path(".agentkit/deployments") / f"{deployment_id}.json"
226
+ )
227
+ if not path.is_file():
228
+ raise StudioError(
229
+ "DEPLOYMENT_NOT_FOUND",
230
+ "Deployment 不存在",
231
+ status_code=404,
232
+ details={"id": deployment_id},
233
+ )
234
+ payload = json.loads(path.read_text(encoding="utf-8"))
235
+ return cast(
236
+ DeploymentRecord,
237
+ DeploymentRecord.model_validate(payload["record"]),
238
+ )
239
+
240
+ async def rollback(
241
+ self,
242
+ deployment_id: str,
243
+ *,
244
+ target_build_id: str,
245
+ ) -> DeploymentRecord:
246
+ path = self.workspace.resolve(
247
+ Path(".agentkit/deployments") / f"{deployment_id}.json"
248
+ )
249
+ if not path.is_file():
250
+ self.get(deployment_id)
251
+ payload = json.loads(path.read_text(encoding="utf-8"))
252
+ request = DeploymentRequest.model_validate(payload["request"])
253
+ return await self.deploy(target_build_id, request)
254
+
255
+ def _save(
256
+ self,
257
+ record: DeploymentRecord,
258
+ request: DeploymentRequest,
259
+ ) -> None:
260
+ directory = self.workspace.resolve(".agentkit/deployments")
261
+ directory.mkdir(parents=True, exist_ok=True)
262
+ self.workspace.atomic_write_text(
263
+ directory / f"{record.id}.json",
264
+ json.dumps(
265
+ {
266
+ "record": record.model_dump(
267
+ by_alias=True, exclude_none=True, mode="json"
268
+ ),
269
+ "request": request.model_dump(
270
+ by_alias=True, exclude_none=True, mode="json"
271
+ ),
272
+ },
273
+ ensure_ascii=False,
274
+ sort_keys=True,
275
+ indent=2,
276
+ )
277
+ + "\n",
278
+ )