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/studio/api.py ADDED
@@ -0,0 +1,1046 @@
1
+ """FastAPI application for the loopback-only AgentKit Studio control plane."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import hmac
7
+ import json
8
+ import os
9
+ import secrets
10
+ from collections.abc import AsyncIterator
11
+ from contextlib import asynccontextmanager
12
+ from pathlib import Path
13
+ from typing import Any, Literal
14
+
15
+ from fastapi import FastAPI, File, Header, Query, Request, Response, UploadFile
16
+ from fastapi.exceptions import RequestValidationError
17
+ from fastapi.responses import FileResponse, JSONResponse, StreamingResponse
18
+ from fastapi.staticfiles import StaticFiles
19
+
20
+ from ksadk.studio.api_catalog_routes import register_catalog_routes
21
+ from ksadk.studio.api_contracts import (
22
+ AuthoringCommitRequest,
23
+ BuildRequest,
24
+ ConversationAuthoringRequest,
25
+ CreateAgentRequest,
26
+ EvaluationRequest,
27
+ InteractionSubmitRequest,
28
+ ProjectInspectRequest,
29
+ QuickAuthoringRequest,
30
+ RollbackRequest,
31
+ RunRequest,
32
+ SessionExchangeRequest,
33
+ StudioEvaluationCreate,
34
+ ValidationRequest,
35
+ WorkspaceOpenRequest,
36
+ )
37
+ from ksadk.studio.api_helpers import (
38
+ error_response as _error_response,
39
+ )
40
+ from ksadk.studio.api_helpers import (
41
+ is_local_origin,
42
+ )
43
+ from ksadk.studio.api_helpers import (
44
+ optional_int as _optional_int,
45
+ )
46
+ from ksadk.studio.api_helpers import (
47
+ parse_revision as _parse_revision,
48
+ )
49
+ from ksadk.studio.api_helpers import (
50
+ require_idempotency_key as _require_idempotency_key,
51
+ )
52
+ from ksadk.studio.api_helpers import (
53
+ responses_input as _responses_input,
54
+ )
55
+ from ksadk.studio.api_helpers import (
56
+ responses_session_id as _responses_session_id,
57
+ )
58
+ from ksadk.studio.api_helpers import (
59
+ sse as _sse,
60
+ )
61
+ from ksadk.studio.codex_manifest import CodexAgentManifest
62
+ from ksadk.studio.contracts import (
63
+ AgentAppearance,
64
+ AgentBindings,
65
+ AgentSpec,
66
+ AgentTemplateComposeRequest,
67
+ DeploymentRequest,
68
+ OperationStatus,
69
+ )
70
+ from ksadk.studio.errors import StudioError
71
+ from ksadk.studio.service import StudioService
72
+ from ksadk.studio.shared_web import StudioSharedWebBridge
73
+
74
+ _WRITE_METHODS = {"POST", "PUT", "PATCH", "DELETE"}
75
+ _PUBLIC_API_PATHS = {
76
+ "/api/v1/system/health",
77
+ "/api/v1/system/session",
78
+ }
79
+ _LOCAL_HOSTS = {"127.0.0.1", "::1", "localhost", "testserver"}
80
+
81
+
82
+ def create_studio_app(
83
+ root: Path | str,
84
+ *,
85
+ service: StudioService | None = None,
86
+ session_token: str | None = None,
87
+ csrf_token: str | None = None,
88
+ security_enabled: bool = True,
89
+ ) -> FastAPI:
90
+ studio = service or StudioService(root)
91
+ session_secret = session_token or secrets.token_urlsafe(32)
92
+ csrf_secret = csrf_token or secrets.token_urlsafe(24)
93
+
94
+ @asynccontextmanager
95
+ async def lifespan(_app: FastAPI) -> AsyncIterator[None]:
96
+ try:
97
+ yield
98
+ finally:
99
+ studio.credentials.clear_session()
100
+
101
+ app = FastAPI(
102
+ title="AgentKit Local Studio",
103
+ version="1.0.0",
104
+ docs_url=None,
105
+ redoc_url=None,
106
+ openapi_url="/api/v1/openapi.json",
107
+ lifespan=lifespan,
108
+ )
109
+ app.state.studio_service = studio
110
+ app.state.session_token = session_secret
111
+ app.state.csrf_token = csrf_secret
112
+ static_root = Path(__file__).with_name("static")
113
+ shared_web = StudioSharedWebBridge(studio)
114
+ app.state.shared_web_bridge = shared_web
115
+ app.mount("/static", StaticFiles(directory=static_root), name="studio-static")
116
+
117
+ @app.middleware("http")
118
+ async def local_security(request: Request, call_next):
119
+ request.state.request_id = request.headers.get("X-Request-Id") or (
120
+ f"req_{secrets.token_hex(12)}"
121
+ )
122
+ host = (request.url.hostname or "").lower()
123
+ if host not in _LOCAL_HOSTS:
124
+ return _error_response(
125
+ StudioError(
126
+ "LOCAL_HOST_FORBIDDEN",
127
+ "Studio 只接受 loopback Host",
128
+ status_code=403,
129
+ ),
130
+ request,
131
+ )
132
+ origin = request.headers.get("Origin")
133
+ if origin and not is_local_origin(origin, local_hosts=_LOCAL_HOSTS):
134
+ return _error_response(
135
+ StudioError(
136
+ "LOCAL_ORIGIN_FORBIDDEN",
137
+ "请求 Origin 不是本地 Studio",
138
+ status_code=403,
139
+ ),
140
+ request,
141
+ )
142
+ content_length = request.headers.get("Content-Length")
143
+ large_upload_paths = {
144
+ "/api/v1/catalog/skills:import": 52 * 1024 * 1024,
145
+ "/api/v1/authoring/imports:inspect": 102 * 1024 * 1024,
146
+ }
147
+ request_limit = large_upload_paths.get(request.url.path, 2 * 1024 * 1024)
148
+ if content_length and int(content_length) > request_limit:
149
+ return _error_response(
150
+ StudioError(
151
+ "REQUEST_TOO_LARGE",
152
+ "请求体超过 2 MiB 限制",
153
+ status_code=413,
154
+ ),
155
+ request,
156
+ )
157
+ studio_api = request.url.path.startswith("/api/v1")
158
+ shared_web_api = request.url.path.startswith("/agentengine/api/v1")
159
+ responses_api = request.url.path == "/v1/responses" or request.url.path.startswith(
160
+ "/v1/responses/"
161
+ )
162
+ if security_enabled and (
163
+ (studio_api and request.url.path not in _PUBLIC_API_PATHS)
164
+ or shared_web_api
165
+ or responses_api
166
+ ):
167
+ supplied = request.cookies.get("agentkit_studio_session") or request.headers.get(
168
+ "X-AgentKit-Session"
169
+ )
170
+ if not supplied or not hmac.compare_digest(supplied, session_secret):
171
+ return _error_response(
172
+ StudioError(
173
+ "LOCAL_SESSION_REQUIRED",
174
+ "缺少有效的 Studio 本地会话",
175
+ status_code=401,
176
+ ),
177
+ request,
178
+ )
179
+ if (studio_api or responses_api) and request.method in _WRITE_METHODS:
180
+ csrf = request.headers.get("X-CSRF-Token")
181
+ if not csrf or not hmac.compare_digest(csrf, csrf_secret):
182
+ return _error_response(
183
+ StudioError(
184
+ "CSRF_TOKEN_INVALID",
185
+ "缺少有效的 CSRF token",
186
+ status_code=403,
187
+ ),
188
+ request,
189
+ )
190
+ response = await call_next(request)
191
+ response.headers["X-Request-Id"] = request.state.request_id
192
+ response.headers["Cache-Control"] = (
193
+ "no-store"
194
+ if request.url.path.startswith(("/api/", "/v1/"))
195
+ else response.headers.get("Cache-Control", "no-cache")
196
+ )
197
+ response.headers["X-Content-Type-Options"] = "nosniff"
198
+ response.headers["X-Frame-Options"] = "DENY"
199
+ response.headers["Referrer-Policy"] = "no-referrer"
200
+ return response
201
+
202
+ @app.exception_handler(StudioError)
203
+ async def studio_error_handler(request: Request, exc: StudioError):
204
+ return _error_response(exc, request)
205
+
206
+ @app.exception_handler(RequestValidationError)
207
+ async def validation_error_handler(request: Request, exc: RequestValidationError):
208
+ first = exc.errors()[0] if exc.errors() else {}
209
+ field = ".".join(str(value) for value in first.get("loc", [])[1:])
210
+ return _error_response(
211
+ StudioError(
212
+ "REQUEST_VALIDATION_FAILED",
213
+ str(first.get("msg") or "请求参数无效"),
214
+ status_code=422,
215
+ field=field or None,
216
+ ),
217
+ request,
218
+ )
219
+
220
+ @app.get("/")
221
+ async def index():
222
+ path = static_root / "index.html"
223
+ response = FileResponse(path, media_type="text/html")
224
+ if security_enabled:
225
+ response.set_cookie(
226
+ "agentkit_studio_session",
227
+ session_secret,
228
+ httponly=True,
229
+ samesite="strict",
230
+ secure=False,
231
+ path="/",
232
+ )
233
+ return response
234
+
235
+ @app.get("/favicon.ico")
236
+ async def favicon():
237
+ return Response(status_code=204)
238
+
239
+ async def runtime_model_catalog():
240
+ api_base = os.getenv("OPENAI_BASE_URL") or os.getenv("OPENAI_API_BASE")
241
+ current_model = os.getenv("OPENAI_MODEL_NAME") or os.getenv("MODEL_NAME")
242
+ try:
243
+ api_key = studio.credentials.resolve("env://OPENAI_API_KEY")
244
+ except StudioError:
245
+ api_key = None
246
+ return await studio.catalog.discover_provider_models(
247
+ api_base=api_base,
248
+ api_key=api_key,
249
+ current_model=current_model,
250
+ )
251
+
252
+ @app.get("/v1/models")
253
+ async def openai_models():
254
+ models, source = await runtime_model_catalog()
255
+ return {
256
+ "object": "list",
257
+ "data": [dict(item.contract.get("metadata") or {"id": item.name}) for item in models],
258
+ "current": os.getenv("OPENAI_MODEL_NAME") or os.getenv("MODEL_NAME"),
259
+ "source": source,
260
+ }
261
+
262
+ @app.post("/v1/responses")
263
+ async def openai_responses(payload: dict[str, Any]):
264
+ metadata = payload.get("metadata")
265
+ metadata = metadata if isinstance(metadata, dict) else {}
266
+ agent_id = str(metadata.get("agent_id") or metadata.get("agentId") or "") or None
267
+ requested_approval_mode = (
268
+ str(metadata.get("approval_mode") or metadata.get("approvalMode") or "").strip().lower()
269
+ )
270
+ if requested_approval_mode and requested_approval_mode not in {"ask", "risk", "full"}:
271
+ raise StudioError(
272
+ "APPROVAL_MODE_INVALID",
273
+ "批准模式必须是 ask、risk 或 full",
274
+ status_code=422,
275
+ field="metadata.approval_mode",
276
+ )
277
+ collaboration_mode = (
278
+ str(metadata.get("collaboration_mode") or metadata.get("collaborationMode") or "")
279
+ .strip()
280
+ .lower()
281
+ )
282
+ if collaboration_mode and collaboration_mode not in {"default", "plan"}:
283
+ raise StudioError(
284
+ "COLLABORATION_MODE_INVALID",
285
+ "协作模式必须是 default 或 plan",
286
+ status_code=422,
287
+ field="metadata.collaboration_mode",
288
+ )
289
+ goal_objective = str(
290
+ metadata.get("goal_objective") or metadata.get("goalObjective") or ""
291
+ ).strip()
292
+ session_id = _responses_session_id(payload, bridge=shared_web)
293
+ response_id = str(
294
+ metadata.get("invocation_id")
295
+ or metadata.get("invocationId")
296
+ or f"resp_{secrets.token_hex(12)}"
297
+ )
298
+ bridge_payload: dict[str, Any] = {
299
+ "AgentId": shared_web.resolve_agent_id(agent_id),
300
+ "SessionId": session_id or f"ses_{secrets.token_hex(12)}",
301
+ "InvocationId": response_id,
302
+ "Model": str(payload.get("model") or ""),
303
+ "ResponsesInput": _responses_input(payload.get("input")),
304
+ "ApprovalMode": requested_approval_mode,
305
+ "CollaborationMode": collaboration_mode,
306
+ "GoalObjective": goal_objective,
307
+ }
308
+ bridge_payload["Model"] = shared_web.select_model(
309
+ bridge_payload["AgentId"],
310
+ bridge_payload["Model"],
311
+ )
312
+ if bool(payload.get("stream")):
313
+ return StreamingResponse(
314
+ shared_web.stream_run(bridge_payload),
315
+ media_type="text/event-stream",
316
+ headers={"Cache-Control": "no-store", "X-Accel-Buffering": "no"},
317
+ )
318
+ return await shared_web.invoke_response(bridge_payload)
319
+
320
+ @app.post("/v1/responses/{response_id}/cancel")
321
+ async def cancel_openai_response(response_id: str):
322
+ result = shared_web.cancel_run(response_id)
323
+ return {
324
+ "id": response_id,
325
+ "object": "response",
326
+ "status": "cancelled" if result["Cancelled"] else "not_found",
327
+ }
328
+
329
+ @app.post("/v1/responses/{response_id}:pause", status_code=202)
330
+ async def pause_openai_response(response_id: str):
331
+ return await shared_web.pause_run(response_id)
332
+
333
+ @app.post("/v1/responses/{response_id}:resume", status_code=202)
334
+ async def resume_openai_response(response_id: str):
335
+ return await shared_web.resume_run(response_id)
336
+
337
+ @app.post("/agentengine/api/v1/{action}")
338
+ async def shared_chat_action(
339
+ action: str,
340
+ request: Request,
341
+ payload: dict[str, Any],
342
+ ):
343
+ try:
344
+ cookie_agent_id = request.cookies.get("agentkit_studio_chat_agent")
345
+ requested_agent_id = str(payload.get("AgentId") or cookie_agent_id or "")
346
+ if action == "GetAgentUiBootstrap":
347
+ data = shared_web.bootstrap(shared_web.resolve_agent_id(requested_agent_id or None))
348
+ elif action == "ListAgentModels":
349
+ data = shared_web.list_models(
350
+ shared_web.resolve_agent_id(requested_agent_id or None)
351
+ )
352
+ elif action == "ListSessions":
353
+ data = shared_web.list_sessions(
354
+ shared_web.resolve_agent_id(requested_agent_id or None),
355
+ page=int(payload.get("Page") or 1),
356
+ page_size=int(payload.get("PageSize") or 30),
357
+ )
358
+ elif action == "CreateSession":
359
+ data = shared_web.create_session(
360
+ shared_web.resolve_agent_id(requested_agent_id or None)
361
+ )
362
+ elif action == "GetSession":
363
+ data = shared_web.get_session(str(payload.get("SessionId") or ""))
364
+ elif action == "DeleteSession":
365
+ data = shared_web.delete_session(str(payload.get("SessionId") or ""))
366
+ elif action == "ListSessionMessages":
367
+ data = shared_web.list_messages(
368
+ str(payload.get("SessionId") or ""),
369
+ after_seq_id=_optional_int(payload.get("AfterSeqId")),
370
+ before_seq_id=_optional_int(payload.get("BeforeSeqId")),
371
+ limit=int(payload.get("Limit") or 50),
372
+ )
373
+ elif action == "ListSessionEvents":
374
+ data = shared_web.list_session_events(str(payload.get("SessionId") or ""))
375
+ elif action == "RunAgent":
376
+ return StreamingResponse(
377
+ shared_web.stream_run(payload),
378
+ media_type="text/event-stream",
379
+ headers={
380
+ "Cache-Control": "no-store",
381
+ "X-Accel-Buffering": "no",
382
+ },
383
+ )
384
+ elif action == "CancelRun":
385
+ data = shared_web.cancel_run(str(payload.get("InvocationId") or ""))
386
+ elif action in {
387
+ "GetResponseFeedback",
388
+ "UpsertResponseFeedback",
389
+ "DeleteResponseFeedback",
390
+ }:
391
+ data = {"Feedback": None} if action == "GetResponseFeedback" else {}
392
+ elif action == "ListSessionCheckpoints":
393
+ data = {"Checkpoints": []}
394
+ elif action == "ListToolReceipts":
395
+ data = {"ToolReceipts": []}
396
+ else:
397
+ return JSONResponse(
398
+ status_code=404,
399
+ content={
400
+ "Code": 404,
401
+ "Message": f"Studio 尚未实现共享 Web 动作:{action}",
402
+ "Data": {},
403
+ },
404
+ )
405
+ return {"Code": 0, "Message": "OK", "Data": data}
406
+ except StudioError as exc:
407
+ return JSONResponse(
408
+ status_code=exc.status_code,
409
+ content={
410
+ "Code": exc.status_code,
411
+ "Message": exc.message,
412
+ "Data": {"errorCode": exc.code},
413
+ },
414
+ )
415
+
416
+ @app.get("/agentengine/api/v1/SubscribeRunEvents")
417
+ async def shared_chat_subscribe_run_events():
418
+ async def completed_stream():
419
+ yield "event: done\ndata: [DONE]\n\n"
420
+
421
+ return StreamingResponse(
422
+ completed_stream(),
423
+ media_type="text/event-stream",
424
+ headers={"Cache-Control": "no-store", "X-Accel-Buffering": "no"},
425
+ )
426
+
427
+ @app.get("/api/v1/system/health")
428
+ async def health():
429
+ return {
430
+ "status": "ok",
431
+ "version": "1.0.0",
432
+ "workspaceReady": studio.workspace.root.is_dir(),
433
+ }
434
+
435
+ @app.post("/api/v1/system/session")
436
+ async def exchange_session(payload: SessionExchangeRequest, response: Response):
437
+ if security_enabled and not hmac.compare_digest(payload.token, session_secret):
438
+ raise StudioError(
439
+ "LOCAL_SESSION_INVALID",
440
+ "Studio 启动会话无效",
441
+ status_code=401,
442
+ )
443
+ response.set_cookie(
444
+ "agentkit_studio_session",
445
+ session_secret,
446
+ httponly=True,
447
+ samesite="strict",
448
+ secure=False,
449
+ path="/",
450
+ )
451
+ return {"csrfToken": csrf_secret}
452
+
453
+ @app.get("/api/v1/system/bootstrap")
454
+ async def bootstrap():
455
+ return {
456
+ "serverVersion": "1.0.0",
457
+ "apiVersion": "v1",
458
+ "sessionTokenRequired": security_enabled,
459
+ "csrfToken": csrf_secret,
460
+ "workspace": {
461
+ "name": studio.workspace.root.name,
462
+ "path": str(studio.workspace.root),
463
+ },
464
+ "features": {
465
+ "build": True,
466
+ "run": True,
467
+ "runtimeRegistry": True,
468
+ "runtimeTypes": ["codex", "adk", "langgraph"],
469
+ "evaluation": True,
470
+ "deployment": True,
471
+ "cloudRebuild": False,
472
+ "reactChat": True,
473
+ },
474
+ "runtimes": studio.runtime_catalog(),
475
+ }
476
+
477
+ @app.get("/api/v1/system/settings")
478
+ async def get_settings():
479
+ return studio.get_settings()
480
+
481
+ @app.put("/api/v1/system/settings")
482
+ async def update_settings(payload: dict[str, Any]):
483
+ return studio.update_settings(payload)
484
+
485
+ @app.post("/api/v1/workspaces:open")
486
+ async def open_workspace(payload: WorkspaceOpenRequest):
487
+ if not studio.workspace.matches_configured_root_path(payload.path):
488
+ raise StudioError(
489
+ "WORKSPACE_PATH_FORBIDDEN",
490
+ "当前 Daemon 不允许切换到启动 root 之外的工作区",
491
+ status_code=403,
492
+ )
493
+ return {
494
+ "name": studio.workspace.root.name,
495
+ "path": str(studio.workspace.root),
496
+ }
497
+
498
+ @app.get("/api/v1/codex/manifest")
499
+ async def get_codex_manifest():
500
+ return studio.codex_manifest_state()
501
+
502
+ @app.put("/api/v1/codex/manifest")
503
+ async def put_codex_manifest(payload: CodexAgentManifest):
504
+ return studio.save_codex_manifest(payload)
505
+
506
+ @app.post("/api/v1/codex/manifest:validate")
507
+ async def validate_codex_manifest(_payload: CodexAgentManifest):
508
+ return {"valid": True, "diagnostics": []}
509
+
510
+ @app.post("/api/v1/codex/builds", status_code=202)
511
+ async def create_codex_build(
512
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
513
+ ):
514
+ return studio.submit_codex_build(idempotency_key=_require_idempotency_key(idempotency_key))
515
+
516
+ @app.get("/api/v1/codex/builds")
517
+ async def list_codex_builds():
518
+ return {"items": studio.codex_builds.list()}
519
+
520
+ @app.get("/api/v1/codex/builds/{build_id}")
521
+ async def get_codex_build(build_id: str):
522
+ return studio.codex_builds.get(build_id)
523
+
524
+ @app.post("/api/v1/codex/builds/{build_id}/runs", status_code=202)
525
+ async def create_codex_run(
526
+ build_id: str,
527
+ payload: RunRequest,
528
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
529
+ ):
530
+ if payload.environment != "local":
531
+ raise StudioError(
532
+ "RUN_ENVIRONMENT_UNSUPPORTED",
533
+ "Codex Studio 只支持只读本地运行",
534
+ status_code=422,
535
+ )
536
+ return studio.submit_codex_run(
537
+ build_id,
538
+ payload.input.content,
539
+ session_id=payload.session_id,
540
+ model=payload.model,
541
+ idempotency_key=_require_idempotency_key(idempotency_key),
542
+ )
543
+
544
+ @app.post("/api/v1/builds/{build_id}/run:stream")
545
+ async def stream_run(
546
+ build_id: str,
547
+ payload: RunRequest,
548
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
549
+ ):
550
+ key = _require_idempotency_key(idempotency_key)
551
+ if payload.environment != "local":
552
+ raise StudioError(
553
+ "RUN_ENVIRONMENT_UNSUPPORTED",
554
+ "Codex Studio 只支持只读本地运行",
555
+ status_code=422,
556
+ )
557
+
558
+ queue: asyncio.Queue = asyncio.Queue()
559
+
560
+ def observe(event):
561
+ queue.put_nowait(event)
562
+
563
+ # The Operation owns the runtime task. The SSE response is only one
564
+ # observer, so refreshing or switching chats cannot cancel the Run.
565
+ operation = studio.submit_studio_run(
566
+ build_id,
567
+ payload.input.content,
568
+ session_id=payload.session_id,
569
+ model=payload.model,
570
+ sandbox=payload.sandbox,
571
+ idempotency_key=key,
572
+ on_event=observe,
573
+ )
574
+
575
+ async def render():
576
+ while True:
577
+ try:
578
+ event = await asyncio.wait_for(queue.get(), timeout=0.1)
579
+ except TimeoutError:
580
+ event = None
581
+ if event is not None:
582
+ data = json.dumps(
583
+ event.data,
584
+ ensure_ascii=False,
585
+ separators=(",", ":"),
586
+ )
587
+ yield f"id: {event.id}\nevent: {event.type}\ndata: {data}\n\n"
588
+ current = studio.operations.get(operation.id)
589
+ if (
590
+ current.status
591
+ in {
592
+ OperationStatus.SUCCEEDED,
593
+ OperationStatus.FAILED,
594
+ OperationStatus.CANCELLED,
595
+ OperationStatus.INTERRUPTED,
596
+ }
597
+ and queue.empty()
598
+ ):
599
+ if current.status == OperationStatus.FAILED:
600
+ data = json.dumps(current.error or {}, ensure_ascii=False)
601
+ yield f"event: run.failed\ndata: {data}\n\n"
602
+ break
603
+
604
+ return StreamingResponse(
605
+ render(),
606
+ media_type="text/event-stream",
607
+ headers={"Cache-Control": "no-store", "X-Accel-Buffering": "no"},
608
+ )
609
+
610
+ @app.post("/api/v1/agents", status_code=201)
611
+ async def create_agent(payload: CreateAgentRequest):
612
+ return studio.create_studio_agent(
613
+ agent_id=payload.id,
614
+ name=payload.name,
615
+ description=payload.description,
616
+ template=payload.template,
617
+ spec=payload.spec,
618
+ runtime=payload.runtime,
619
+ )
620
+
621
+ @app.post("/api/v1/assets/agent-avatars", status_code=201)
622
+ async def upload_agent_avatar(request: Request):
623
+ declared_size = request.headers.get("Content-Length")
624
+ if (
625
+ declared_size
626
+ and declared_size.isdigit()
627
+ and int(declared_size) > studio.avatar_assets.MAX_BYTES
628
+ ):
629
+ raise StudioError(
630
+ "AGENT_AVATAR_TOO_LARGE",
631
+ "头像文件不能超过 2 MiB",
632
+ status_code=413,
633
+ field="file",
634
+ details={"maxBytes": studio.avatar_assets.MAX_BYTES},
635
+ )
636
+ return studio.avatar_assets.store(
637
+ await request.body(),
638
+ content_type=request.headers.get("Content-Type", ""),
639
+ )
640
+
641
+ @app.get("/api/v1/assets/agent-avatars/{asset_name}")
642
+ async def get_agent_avatar(asset_name: str):
643
+ path, media_type = studio.avatar_assets.get(asset_name)
644
+ return FileResponse(
645
+ path,
646
+ media_type=media_type,
647
+ headers={"Cache-Control": "private, max-age=31536000, immutable"},
648
+ )
649
+
650
+ @app.get("/api/v1/agent-templates")
651
+ async def agent_templates():
652
+ return {"items": studio.list_agent_templates()}
653
+
654
+ @app.post("/api/v1/agent-templates/{template_id}:compose")
655
+ async def compose_agent_template(
656
+ template_id: str,
657
+ payload: AgentTemplateComposeRequest,
658
+ ):
659
+ return studio.compose_agent_template(template_id, payload)
660
+
661
+ @app.post("/api/v1/authoring/quick", status_code=201)
662
+ async def quick_author_agent(payload: QuickAuthoringRequest):
663
+ return studio.create_authored_agent(
664
+ name=payload.name,
665
+ slug=payload.slug,
666
+ runtime_type=payload.runtime_type,
667
+ template=payload.template,
668
+ description=payload.description,
669
+ spec=payload.spec,
670
+ )
671
+
672
+ @app.post("/api/v1/authoring/conversations:compose")
673
+ async def compose_authoring_conversation(payload: ConversationAuthoringRequest):
674
+ return await studio.compose_agent_conversation(
675
+ messages=[item.model_dump(mode="json") for item in payload.messages],
676
+ model_profile_id=payload.model_profile_id,
677
+ )
678
+
679
+ @app.post("/api/v1/authoring/imports:inspect")
680
+ async def inspect_agent_import(file: UploadFile = File(...)):
681
+ content = await file.read(100 * 1024 * 1024 + 1)
682
+ return studio.inspect_agent_import(
683
+ content,
684
+ filename=file.filename or "agent.yaml",
685
+ )
686
+
687
+ @app.post(
688
+ "/api/v1/authoring/imports/{inspection_token}:commit",
689
+ status_code=201,
690
+ )
691
+ async def commit_agent_import(
692
+ inspection_token: str,
693
+ payload: AuthoringCommitRequest,
694
+ ):
695
+ return studio.commit_agent_import(
696
+ inspection_token,
697
+ name=payload.name,
698
+ slug=payload.slug,
699
+ )
700
+
701
+ @app.post("/api/v1/authoring/projects:inspect")
702
+ async def inspect_agent_project(payload: ProjectInspectRequest):
703
+ return studio.inspect_agent_project(payload.path)
704
+
705
+ @app.post(
706
+ "/api/v1/authoring/projects/{inspection_token}:commit",
707
+ status_code=201,
708
+ )
709
+ async def commit_agent_project(
710
+ inspection_token: str,
711
+ payload: AuthoringCommitRequest,
712
+ ):
713
+ return studio.commit_agent_project(
714
+ inspection_token,
715
+ name=payload.name,
716
+ slug=payload.slug,
717
+ model_profile_id=payload.model_profile_id,
718
+ )
719
+
720
+ @app.get("/api/v1/agents")
721
+ async def list_agents(
722
+ limit: int = Query(default=50, ge=1, le=200),
723
+ query: str = "",
724
+ ):
725
+ return {
726
+ "items": studio.list_agents(query=query, limit=limit),
727
+ "nextCursor": None,
728
+ }
729
+
730
+ @app.get("/api/v1/agents/{agent_id}")
731
+ async def get_agent(agent_id: str):
732
+ return studio.agent_detail(agent_id)
733
+
734
+ @app.get("/api/v1/agents/{agent_id}/models")
735
+ async def get_agent_models(agent_id: str):
736
+ return shared_web.list_models(shared_web.resolve_agent_id(agent_id))
737
+
738
+ @app.put("/api/v1/agents/{agent_id}")
739
+ async def update_agent(
740
+ agent_id: str,
741
+ spec: AgentSpec,
742
+ if_match: str | None = Header(default=None, alias="If-Match"),
743
+ ):
744
+ if not if_match:
745
+ raise StudioError(
746
+ "AGENT_REVISION_REQUIRED",
747
+ "更新 Agent 必须提供 If-Match revision",
748
+ status_code=428,
749
+ )
750
+ try:
751
+ revision = int(if_match.strip().strip('"'))
752
+ except ValueError as exc:
753
+ raise StudioError(
754
+ "AGENT_REVISION_INVALID",
755
+ "If-Match 必须是整数 revision",
756
+ status_code=400,
757
+ ) from exc
758
+ return studio.update_studio_agent(
759
+ agent_id,
760
+ spec,
761
+ expected_revision=revision,
762
+ )
763
+
764
+ @app.put("/api/v1/agents/{agent_id}/bindings")
765
+ async def update_agent_bindings(
766
+ agent_id: str,
767
+ bindings: AgentBindings,
768
+ if_match: str | None = Header(default=None, alias="If-Match"),
769
+ ):
770
+ revision = _parse_revision(if_match)
771
+ return studio.update_studio_agent_bindings(
772
+ agent_id,
773
+ bindings,
774
+ expected_revision=revision,
775
+ )
776
+
777
+ @app.put("/api/v1/agents/{agent_id}/appearance")
778
+ async def update_agent_appearance(
779
+ agent_id: str,
780
+ appearance: AgentAppearance,
781
+ if_match: str | None = Header(default=None, alias="If-Match"),
782
+ ):
783
+ return studio.update_studio_agent_appearance(
784
+ agent_id,
785
+ appearance,
786
+ expected_revision=_parse_revision(if_match),
787
+ )
788
+
789
+ @app.delete("/api/v1/agents/{agent_id}", status_code=204)
790
+ async def delete_agent(agent_id: str, purge: bool = False):
791
+ studio.delete_studio_agent(agent_id, purge=purge)
792
+ return Response(status_code=204)
793
+
794
+ @app.post("/api/v1/agents/{agent_id}/validations")
795
+ async def validate_agent(agent_id: str, payload: ValidationRequest):
796
+ return studio.validate_studio_agent(
797
+ agent_id,
798
+ revision=payload.revision,
799
+ level=payload.level,
800
+ )
801
+
802
+ @app.post("/api/v1/agents/{agent_id}/builds", status_code=202)
803
+ async def create_build(
804
+ agent_id: str,
805
+ payload: BuildRequest,
806
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
807
+ ):
808
+ return studio.submit_studio_build(
809
+ agent_id,
810
+ revision=payload.revision,
811
+ idempotency_key=_require_idempotency_key(idempotency_key),
812
+ )
813
+
814
+ @app.get("/api/v1/builds/{build_id}")
815
+ async def get_build(build_id: str):
816
+ return studio.build_view(build_id)
817
+
818
+ @app.get("/api/v1/builds/{build_id}/manifest")
819
+ async def get_build_manifest(build_id: str):
820
+ try:
821
+ record = studio.codex_builds.get(build_id)
822
+ except StudioError as exc:
823
+ if exc.status_code != 404:
824
+ raise
825
+ else:
826
+ return {
827
+ "agentengine": studio.codex_manifests.load(record.agent_name).manifest,
828
+ "runtimeLock": record.runtime_lock,
829
+ "manifestSha256": record.manifest_sha256,
830
+ }
831
+ build = studio.builds.get(build_id)
832
+ if not build.artifact_path:
833
+ raise StudioError("BUILD_NOT_READY", "Build 尚未生成制品", status_code=409)
834
+ archive = studio.workspace.resolve(build.artifact_path)
835
+ manifest = archive.parent / "agent-bundle" / "manifest.json"
836
+ return json.loads(manifest.read_text(encoding="utf-8"))
837
+
838
+ @app.post("/api/v1/builds/{build_id}/runs", status_code=202)
839
+ async def create_run(
840
+ build_id: str,
841
+ payload: RunRequest,
842
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
843
+ ):
844
+ if payload.environment != "local":
845
+ raise StudioError(
846
+ "RUN_ENVIRONMENT_UNSUPPORTED",
847
+ "一期 Local Run 只支持 environment=local",
848
+ status_code=422,
849
+ )
850
+ return studio.submit_studio_run(
851
+ build_id,
852
+ payload.input.content,
853
+ session_id=payload.session_id,
854
+ model=payload.model,
855
+ idempotency_key=_require_idempotency_key(idempotency_key),
856
+ )
857
+
858
+ @app.get("/api/v1/runs/{run_id}")
859
+ async def get_run(run_id: str):
860
+ return studio.event_store.get(run_id)
861
+
862
+ @app.post("/api/v1/runs/{run_id}:cancel", status_code=202)
863
+ async def cancel_run(run_id: str):
864
+ return await studio.run_service.cancel_run(run_id)
865
+
866
+ @app.post("/api/v1/runs/{run_id}:pause", status_code=202)
867
+ async def pause_run(run_id: str):
868
+ return await studio.run_service.pause_run(run_id)
869
+
870
+ @app.post("/api/v1/runs/{run_id}:resume", status_code=202)
871
+ async def resume_run(run_id: str):
872
+ return await studio.run_service.resume_run(run_id)
873
+
874
+ @app.post("/api/v1/runs/{run_id}/interactions/{interaction_id}:submit")
875
+ async def submit_run_interaction(
876
+ run_id: str,
877
+ interaction_id: str,
878
+ payload: InteractionSubmitRequest,
879
+ ):
880
+ return await studio.run_service.submit_interaction(
881
+ run_id,
882
+ interaction_id,
883
+ name=payload.name,
884
+ data=payload.data,
885
+ )
886
+
887
+ @app.delete("/api/v1/sessions/{session_id}", status_code=204)
888
+ async def delete_studio_session(session_id: str):
889
+ studio.delete_session(session_id)
890
+ return Response(status_code=204)
891
+
892
+ @app.get("/api/v1/runs")
893
+ async def list_runs(session_id: str | None = Query(default=None, alias="sessionId")):
894
+ return {"items": studio.event_store.list_runs(session_id=session_id)}
895
+
896
+ @app.get("/api/v1/runs/{run_id}/events")
897
+ async def run_events(
898
+ run_id: str,
899
+ request: Request,
900
+ after: int = Query(default=0, ge=0),
901
+ ):
902
+ last = request.headers.get("Last-Event-ID")
903
+ cursor = int(last) if last and last.isdigit() else after
904
+ events = studio.event_store.events(run_id, after=cursor)
905
+ return _sse(events)
906
+
907
+ @app.get("/api/v1/traces/overview")
908
+ async def trace_overview(
909
+ range_name: Literal["24h", "7d"] = Query(default="24h", alias="range"),
910
+ agent_id: str | None = Query(default=None, alias="agentId"),
911
+ status: str | None = Query(default=None),
912
+ ):
913
+ return studio.event_store.trace_overview(
914
+ range_name=range_name,
915
+ agent_id=agent_id,
916
+ status=status,
917
+ )
918
+
919
+ @app.get("/api/v1/traces")
920
+ async def list_traces(
921
+ agent_id: str | None = Query(default=None, alias="agentId"),
922
+ status: str | None = Query(default=None),
923
+ query: str = Query(default=""),
924
+ limit: int = Query(default=50, ge=1, le=1000),
925
+ cursor: str | None = Query(default=None),
926
+ sort: Literal["startedAt:desc", "startedAt:asc"] = "startedAt:desc",
927
+ ):
928
+ return studio.event_store.list_traces_page(
929
+ agent_id=agent_id,
930
+ status=status,
931
+ query=query,
932
+ limit=limit,
933
+ cursor=cursor,
934
+ sort=sort,
935
+ )
936
+
937
+ @app.get("/api/v1/traces/{trace_id}")
938
+ async def get_trace(trace_id: str):
939
+ return studio.event_store.trace(trace_id)
940
+
941
+ @app.get("/api/v1/traces/{trace_id}/otlp")
942
+ async def get_trace_otlp(trace_id: str):
943
+ return studio.event_store.trace_otlp(trace_id)
944
+
945
+ @app.post("/api/v1/builds/{build_id}/evaluations", status_code=202)
946
+ async def create_evaluation(
947
+ build_id: str,
948
+ payload: EvaluationRequest,
949
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
950
+ ):
951
+ return studio.submit_evaluation(
952
+ build_id,
953
+ payload.suite_refs,
954
+ fail_fast=payload.fail_fast,
955
+ idempotency_key=_require_idempotency_key(idempotency_key),
956
+ )
957
+
958
+ @app.post("/api/v1/evaluations", status_code=202)
959
+ async def create_public_evaluation(
960
+ payload: StudioEvaluationCreate,
961
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
962
+ ):
963
+ return studio.submit_public_evaluation(
964
+ payload.evalset_file,
965
+ payload.target,
966
+ payload.config,
967
+ idempotency_key=_require_idempotency_key(idempotency_key),
968
+ )
969
+
970
+ @app.get("/api/v1/evaluations")
971
+ async def list_public_evaluations():
972
+ return {"items": studio.list_public_evaluations()}
973
+
974
+ @app.get("/api/v1/evaluations/{evaluation_id}")
975
+ async def get_evaluation(evaluation_id: str):
976
+ report_path = studio.evaluation_storage.report_path(evaluation_id)
977
+ if report_path.is_file():
978
+ return studio.get_public_evaluation(evaluation_id)
979
+ return studio.evaluations.get(evaluation_id)
980
+
981
+ @app.get("/api/v1/evaluations/{evaluation_id}/cases/{case_id}")
982
+ async def get_public_evaluation_case(evaluation_id: str, case_id: str):
983
+ report = studio.get_public_evaluation(evaluation_id)
984
+ for case_run in report.case_runs:
985
+ if case_run.case_id == case_id:
986
+ return case_run
987
+ raise StudioError(
988
+ "EVALUATION_CASE_NOT_FOUND",
989
+ "Evaluation Case 不存在",
990
+ status_code=404,
991
+ details={"id": case_id, "evaluationId": evaluation_id},
992
+ )
993
+
994
+ @app.post("/api/v1/builds/{build_id}/deployments", status_code=202)
995
+ async def create_deployment(
996
+ build_id: str,
997
+ payload: DeploymentRequest,
998
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
999
+ ):
1000
+ return studio.submit_deployment(
1001
+ build_id,
1002
+ payload,
1003
+ idempotency_key=_require_idempotency_key(idempotency_key),
1004
+ )
1005
+
1006
+ @app.get("/api/v1/deployments/{deployment_id}")
1007
+ async def get_deployment(deployment_id: str):
1008
+ return studio.cloud.get(deployment_id)
1009
+
1010
+ @app.post("/api/v1/deployments/{deployment_id}:rollback", status_code=202)
1011
+ async def rollback_deployment(
1012
+ deployment_id: str,
1013
+ payload: RollbackRequest,
1014
+ idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
1015
+ ):
1016
+ return studio.submit_rollback(
1017
+ deployment_id,
1018
+ target_build_id=payload.target_build_id,
1019
+ idempotency_key=_require_idempotency_key(idempotency_key),
1020
+ )
1021
+
1022
+ @app.get("/api/v1/operations/{operation_id}")
1023
+ async def get_operation(operation_id: str):
1024
+ return studio.operations.get(operation_id)
1025
+
1026
+ @app.post("/api/v1/operations/{operation_id}:cancel")
1027
+ async def cancel_operation(operation_id: str):
1028
+ return studio.operations.cancel(operation_id)
1029
+
1030
+ @app.get("/api/v1/operations/{operation_id}/events")
1031
+ async def operation_events(
1032
+ operation_id: str,
1033
+ request: Request,
1034
+ after: int = Query(default=0, ge=0),
1035
+ ):
1036
+ last = request.headers.get("Last-Event-ID")
1037
+ cursor = int(last) if last and last.isdigit() else after
1038
+ return _sse(studio.operations.events(operation_id, after=cursor))
1039
+
1040
+ register_catalog_routes(
1041
+ app,
1042
+ studio,
1043
+ runtime_model_catalog=runtime_model_catalog,
1044
+ )
1045
+
1046
+ return app