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,707 @@
1
+ """Studio Run persistence on top of the canonical RuntimeExecutor."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import time
7
+ from collections.abc import Callable, Mapping
8
+ from dataclasses import dataclass, field
9
+ from datetime import datetime, timezone
10
+ from typing import Any
11
+ from uuid import uuid4
12
+
13
+ from ksadk.agui.a2ui_projection import project_a2ui_operations
14
+ from ksadk.events.runtime_event import EventType, RuntimeEvent
15
+ from ksadk.runtime import (
16
+ CONVERSATION_PREPROCESSING_METADATA_KEY,
17
+ PauseResult,
18
+ ResumePayload,
19
+ ResumeTarget,
20
+ RuntimeExecutor,
21
+ RuntimeLaunchContext,
22
+ StartRequest,
23
+ )
24
+ from ksadk.studio.contracts import RunEvent, RunRecord, RunStatus, Usage
25
+ from ksadk.studio.errors import StudioError
26
+ from ksadk.studio.event_store import RunEventStore
27
+ from ksadk.studio.workspace import Workspace
28
+
29
+ _CANCEL_TIMEOUT_SECONDS = 2.0
30
+
31
+
32
+ @dataclass(frozen=True)
33
+ class StudioRunSpec:
34
+ """Product metadata plus the core launch context for one Studio run."""
35
+
36
+ launch_context: RuntimeLaunchContext
37
+ build_id: str
38
+ agent_id: str
39
+ model: str | None = None
40
+ request_config: Mapping[str, Any] = field(default_factory=dict)
41
+ manifest_sha256: str = ""
42
+
43
+
44
+ class StudioRunService:
45
+ """Persist Studio state without selecting or wrapping a RuntimeAdapter."""
46
+
47
+ def __init__(
48
+ self,
49
+ workspace: Workspace,
50
+ executor: RuntimeExecutor,
51
+ *,
52
+ event_store: RunEventStore | None = None,
53
+ ) -> None:
54
+ self.workspace = workspace
55
+ self.executor = executor
56
+ self.event_store = event_store or RunEventStore(workspace)
57
+ self._active_handles: dict[str, Any] = {}
58
+ self._cancel_flags: dict[str, bool] = {}
59
+ self._control_queues: dict[str, asyncio.Queue[tuple[str, ResumePayload | None]]] = {}
60
+ self._waiting_modes: dict[str, str] = {}
61
+
62
+ async def run(
63
+ self,
64
+ spec: StudioRunSpec,
65
+ user_input: str,
66
+ *,
67
+ runtime_input: Any = None,
68
+ session_id: str | None = None,
69
+ on_event: Callable[[RunEvent], None] | None = None,
70
+ ) -> RunRecord:
71
+ run_id = f"run_{uuid4().hex}"
72
+ session = session_id or f"ses_{uuid4().hex}"
73
+ runtime_type = spec.launch_context.runtime_type.strip().lower()
74
+ record = RunRecord(
75
+ id=run_id,
76
+ build_id=spec.build_id,
77
+ agent_id=spec.agent_id,
78
+ session_id=session,
79
+ trace_id=uuid4().hex,
80
+ manifest_sha256=spec.manifest_sha256,
81
+ runtime_type=runtime_type,
82
+ model=str(spec.model or ""),
83
+ collaboration_mode=str(spec.request_config.get("collaboration_mode") or ""),
84
+ goal_objective=str(spec.request_config.get("goal_objective") or ""),
85
+ input=user_input,
86
+ )
87
+ self.event_store.create(record)
88
+ created = self.event_store.append(
89
+ record.id,
90
+ "run.created",
91
+ {
92
+ "runId": record.id,
93
+ "buildId": spec.build_id,
94
+ "sessionId": session,
95
+ "traceId": record.trace_id,
96
+ "runtimeType": runtime_type,
97
+ "manifestSha256": spec.manifest_sha256,
98
+ "model": record.model,
99
+ "collaborationMode": record.collaboration_mode,
100
+ "goalObjective": record.goal_objective,
101
+ },
102
+ )
103
+ if on_event is not None:
104
+ on_event(created)
105
+
106
+ started = time.monotonic()
107
+ record.status = RunStatus.RUNNING
108
+ record.started_at = datetime.now(timezone.utc)
109
+ self.event_store.save(record)
110
+
111
+ def persist(runtime_event: RuntimeEvent) -> RunEvent:
112
+ event_type, data = project_runtime_event(runtime_event)
113
+ stored = self.event_store.append(record.id, event_type, data)
114
+ if on_event is not None:
115
+ on_event(stored)
116
+ return stored
117
+
118
+ handle = None
119
+ final_text = ""
120
+ streamed_final = ""
121
+ runtime_duration_ms: int | None = None
122
+ control_queue: asyncio.Queue[tuple[str, ResumePayload | None]] = asyncio.Queue()
123
+ self._control_queues[run_id] = control_queue
124
+ try:
125
+ tool_approval_mode = str(spec.request_config.get("tool_approval_mode") or "")
126
+ conversation_request: dict[str, Any] = {
127
+ "messages": self._conversation_messages(
128
+ spec.agent_id,
129
+ session,
130
+ user_input,
131
+ )
132
+ }
133
+ if tool_approval_mode:
134
+ conversation_request["request_metadata"] = {
135
+ "tool_approval_mode": tool_approval_mode,
136
+ }
137
+ request = StartRequest(
138
+ input=runtime_input if runtime_input is not None else user_input,
139
+ user_id="local-user",
140
+ session_id=session,
141
+ agent_id=spec.agent_id,
142
+ model=spec.model,
143
+ config=dict(spec.request_config),
144
+ metadata={
145
+ "invocation_id": run_id,
146
+ CONVERSATION_PREPROCESSING_METADATA_KEY: conversation_request,
147
+ **self._native_session_metadata(spec.agent_id, session, runtime_type),
148
+ },
149
+ )
150
+ handle = await self.executor.start(spec.launch_context, request)
151
+ record.runtime_handle = handle.model_dump(mode="json")
152
+ self.event_store.save(record)
153
+ self._active_handles[run_id] = handle
154
+ while True:
155
+ terminal_seen = False
156
+ should_resume = False
157
+ async for event in self.executor.stream(handle):
158
+ persist(event)
159
+ if self._cancel_flags.get(run_id):
160
+ raise asyncio.CancelledError()
161
+ if event.event_type == EventType.TEXT_DELTA and event.phase == "final_answer":
162
+ text = str(event.payload.get("text") or "")
163
+ if event.payload.get("replace"):
164
+ streamed_final = text
165
+ else:
166
+ streamed_final += text
167
+ elif (
168
+ event.event_type == EventType.TEXT_COMPLETED
169
+ and event.phase == "final_answer"
170
+ ):
171
+ final_text = str(event.payload.get("text") or "")
172
+ elif event.event_type == EventType.USAGE_REPORTED:
173
+ record.usage = Usage(
174
+ input_tokens=int(event.payload.get("input_tokens") or 0),
175
+ output_tokens=int(event.payload.get("output_tokens") or 0),
176
+ total_tokens=int(event.payload.get("total_tokens") or 0),
177
+ cached_input_tokens=int(event.payload.get("cached_tokens") or 0),
178
+ reasoning_output_tokens=int(event.payload.get("reasoning_tokens") or 0),
179
+ reported=True,
180
+ source=str(event.payload.get("source") or runtime_type),
181
+ )
182
+ elif event.event_type in {
183
+ EventType.APPROVAL_REQUESTED,
184
+ EventType.A2UI_INTERACTION,
185
+ }:
186
+ record.status = RunStatus.WAITING_INPUT
187
+ self._waiting_modes[run_id] = "live"
188
+ self.event_store.save(record)
189
+ if event.event_type == EventType.APPROVAL_REQUESTED:
190
+ self._persist_approval_surface(record, event, on_event=on_event)
191
+ elif event.event_type in {
192
+ EventType.APPROVAL_RESOLVED,
193
+ EventType.A2UI_ACTION,
194
+ }:
195
+ record.status = RunStatus.RUNNING
196
+ self._waiting_modes.pop(run_id, None)
197
+ self.event_store.save(record)
198
+ elif event.event_type == EventType.RUN_FAILED:
199
+ terminal_seen = True
200
+ record.status = RunStatus.FAILED
201
+ record.error = {
202
+ "code": "RUNTIME_RUN_FAILED",
203
+ "message": str(event.payload.get("error") or "Runtime 运行失败"),
204
+ }
205
+ elif event.event_type == EventType.RUN_CANCELED:
206
+ terminal_seen = True
207
+ record.status = RunStatus.CANCELLED
208
+ record.error = {
209
+ "code": "RUN_CANCELLED",
210
+ "message": str(event.payload.get("status") or "运行已取消"),
211
+ }
212
+ elif event.event_type == EventType.RUN_INTERRUPTED:
213
+ interrupted_status = str(event.payload.get("status") or "")
214
+ if interrupted_status == "paused":
215
+ record.status = RunStatus.PAUSED
216
+ should_resume = True
217
+ elif record.status == RunStatus.WAITING_INPUT:
218
+ self._waiting_modes[run_id] = "resume"
219
+ should_resume = True
220
+ else:
221
+ terminal_seen = True
222
+ record.status = RunStatus.INTERRUPTED
223
+ record.error = {
224
+ "code": "RUN_INTERRUPTED",
225
+ "message": interrupted_status or "运行已中断",
226
+ }
227
+ self.event_store.save(record)
228
+ elif event.event_type == EventType.RUN_COMPLETED:
229
+ terminal_seen = True
230
+ record.status = RunStatus.COMPLETED
231
+ raw_duration = event.payload.get("duration_ms")
232
+ if raw_duration is not None:
233
+ runtime_duration_ms = max(0, int(raw_duration))
234
+ if terminal_seen:
235
+ break
236
+ if not should_resume:
237
+ record.status = RunStatus.COMPLETED
238
+ break
239
+
240
+ command, resume_payload = await control_queue.get()
241
+ if command == "cancel" or self._cancel_flags.get(run_id):
242
+ raise asyncio.CancelledError()
243
+ if command != "resume":
244
+ continue
245
+ native_thread_id = handle.native_ref.get("thread_id")
246
+ target = (
247
+ ResumeTarget(kind="thread_id", id=str(native_thread_id))
248
+ if native_thread_id
249
+ else ResumeTarget(kind="invocation_id", id=handle.run_id)
250
+ )
251
+ handle = await self.executor.resume(
252
+ handle,
253
+ target,
254
+ resume_payload,
255
+ )
256
+ self._active_handles[run_id] = handle
257
+ record.runtime_handle = handle.model_dump(mode="json")
258
+ record.status = RunStatus.RUNNING
259
+ record.error = None
260
+ self._waiting_modes.pop(run_id, None)
261
+ resumed = self.event_store.append(
262
+ run_id,
263
+ "run.resumed",
264
+ {"runId": run_id, "runtimeHandle": record.runtime_handle},
265
+ )
266
+ if on_event is not None:
267
+ on_event(resumed)
268
+ self.event_store.save(record)
269
+ record.output = final_text or streamed_final
270
+ except asyncio.CancelledError:
271
+ cancel_result = "task_cancelled"
272
+ if handle is not None and self.executor.is_attached(handle):
273
+ try:
274
+ result = await asyncio.wait_for(
275
+ asyncio.shield(self.executor.cancel(handle)),
276
+ timeout=_CANCEL_TIMEOUT_SECONDS,
277
+ )
278
+ cancel_result = result.value
279
+ except TimeoutError:
280
+ cancel_result = "cancel_timed_out"
281
+ except Exception: # best effort; close still owns resource cleanup
282
+ cancel_result = "cancel_failed"
283
+ record.status = RunStatus.CANCELLED
284
+ record.error = {"code": "RUN_CANCELLED", "message": "运行已取消"}
285
+ cancelled = RuntimeEvent.create(
286
+ EventType.RUN_CANCELED,
287
+ agent_id=spec.agent_id,
288
+ user_id="local-user",
289
+ session_id=session,
290
+ invocation_id=handle.run_id if handle is not None else run_id,
291
+ seq_id=len(self.event_store.events(run_id)) + 1,
292
+ payload={"status": "cancelled", "cancel_result": cancel_result},
293
+ )
294
+ persist(cancelled)
295
+ raise
296
+ except Exception as exc: # noqa: BLE001
297
+ record.status = RunStatus.FAILED
298
+ record.error = {"code": "RUNTIME_RUN_FAILED", "message": str(exc)}
299
+ failure = RuntimeEvent.create(
300
+ EventType.RUN_FAILED,
301
+ agent_id=spec.agent_id,
302
+ user_id="local-user",
303
+ session_id=session,
304
+ invocation_id=handle.run_id if handle is not None else run_id,
305
+ seq_id=len(self.event_store.events(run_id)) + 1,
306
+ payload={"status": "failed", "error": str(exc)},
307
+ )
308
+ persist(failure)
309
+ finally:
310
+ if handle is not None and self.executor.is_attached(handle):
311
+ try:
312
+ await asyncio.shield(self.executor.close(handle))
313
+ except asyncio.CancelledError:
314
+ pass
315
+ except Exception: # cleanup is best effort; run state is already durable
316
+ pass
317
+ self._active_handles.pop(run_id, None)
318
+ self._cancel_flags.pop(run_id, None)
319
+ self._control_queues.pop(run_id, None)
320
+ self._waiting_modes.pop(run_id, None)
321
+ record.completed_at = datetime.now(timezone.utc)
322
+ if runtime_duration_ms is not None:
323
+ record.duration_ms = runtime_duration_ms
324
+ record.duration_source = "runtime"
325
+ else:
326
+ record.duration_ms = int((time.monotonic() - started) * 1000)
327
+ record.duration_source = "studio"
328
+ self.event_store.save(record)
329
+ return record
330
+
331
+ async def cancel_run(self, run_id: str) -> dict[str, str]:
332
+ """Request cancellation; the flag and executor perform the actual stop."""
333
+ self._cancel_flags[run_id] = True
334
+ queue = self._control_queues.get(run_id)
335
+ if queue is not None:
336
+ queue.put_nowait(("cancel", None))
337
+ handle = self._active_handles.get(run_id)
338
+ if handle is not None and self.executor.is_attached(handle):
339
+ try:
340
+ await asyncio.wait_for(
341
+ asyncio.shield(self.executor.cancel(handle)),
342
+ timeout=_CANCEL_TIMEOUT_SECONDS,
343
+ )
344
+ except TimeoutError:
345
+ # The cancellation flag wakes the Studio state machine; final
346
+ # transport teardown remains close()'s responsibility.
347
+ pass
348
+ except Exception:
349
+ pass
350
+ return {"runId": run_id, "status": "cancelling"}
351
+
352
+ async def pause_run(self, run_id: str) -> dict[str, str]:
353
+ record = self.event_store.get(run_id)
354
+ if record.status == RunStatus.WAITING_INPUT:
355
+ raise StudioError(
356
+ "RUN_WAITING_INPUT",
357
+ "当前运行正在等待交互输入,请先处理卡片",
358
+ status_code=409,
359
+ )
360
+ if record.status != RunStatus.RUNNING:
361
+ raise StudioError("RUN_NOT_RUNNING", "只有运行中的 Run 可以暂停", status_code=409)
362
+ handle = self._active_handles.get(run_id)
363
+ if handle is None or not self.executor.is_attached(handle):
364
+ raise StudioError("RUN_NOT_ATTACHED", "运行句柄已不在当前进程", status_code=409)
365
+ result = await self.executor.pause(handle)
366
+ if result is PauseResult.NOT_SUPPORTED:
367
+ raise StudioError(
368
+ "RUN_PAUSE_UNSUPPORTED",
369
+ "当前 Runtime 不支持可恢复暂停",
370
+ status_code=409,
371
+ )
372
+ if result is not PauseResult.PAUSED_ACTIVE_TURN:
373
+ raise StudioError("RUN_PAUSE_FAILED", "暂停运行失败", status_code=409)
374
+ return {"runId": run_id, "status": "pausing"}
375
+
376
+ async def resume_run(self, run_id: str) -> dict[str, str]:
377
+ record = self.event_store.get(run_id)
378
+ if record.status != RunStatus.PAUSED:
379
+ raise StudioError("RUN_NOT_PAUSED", "只有已暂停的 Run 可以继续", status_code=409)
380
+ queue = self._control_queues.get(run_id)
381
+ if queue is None:
382
+ raise StudioError(
383
+ "RUN_RESUME_UNAVAILABLE",
384
+ "Studio 进程已重启,当前暂停点无法恢复",
385
+ status_code=409,
386
+ )
387
+ queue.put_nowait(("resume", ResumePayload(kind="free_text", data="继续运行")))
388
+ return {"runId": run_id, "status": "resuming"}
389
+
390
+ async def submit_interaction(
391
+ self,
392
+ run_id: str,
393
+ interaction_id: str,
394
+ *,
395
+ name: str,
396
+ data: dict[str, Any] | None = None,
397
+ ) -> dict[str, Any]:
398
+ record = self.event_store.get(run_id)
399
+ if record.status != RunStatus.WAITING_INPUT:
400
+ raise StudioError(
401
+ "INTERACTION_NOT_PENDING",
402
+ "该 Run 当前没有等待中的交互",
403
+ status_code=409,
404
+ )
405
+ prior = [
406
+ event
407
+ for event in self.event_store.events(run_id)
408
+ if event.type == "a2ui.action"
409
+ and str(event.data.get("interactionId") or event.data.get("interaction_id") or "")
410
+ == interaction_id
411
+ ]
412
+ if prior:
413
+ return {"runId": run_id, "interactionId": interaction_id, "status": "resolved"}
414
+
415
+ interaction = next(
416
+ (
417
+ event
418
+ for event in reversed(self.event_store.events(run_id))
419
+ if event.type == "a2ui.interaction"
420
+ and str(event.data.get("interactionId") or event.data.get("interaction_id") or "")
421
+ == interaction_id
422
+ ),
423
+ None,
424
+ )
425
+ if interaction is None:
426
+ raise StudioError("INTERACTION_NOT_FOUND", "交互请求不存在", status_code=404)
427
+ kind = str(interaction.data.get("kind") or "form")
428
+ payload_data = {"decision": name, **dict(data or {})}
429
+ payload = ResumePayload(
430
+ kind="approval_decision" if kind == "approval" else "hitl_answer",
431
+ call_id=interaction_id,
432
+ data=payload_data,
433
+ )
434
+ mode = self._waiting_modes.get(run_id)
435
+ handle = self._active_handles.get(run_id)
436
+ if mode == "live":
437
+ if handle is None or not self.executor.is_attached(handle):
438
+ raise StudioError("INTERACTION_EXPIRED", "运行时交互已失效", status_code=409)
439
+ try:
440
+ await self.executor.submit(handle, payload)
441
+ except (RuntimeError, ValueError) as exc:
442
+ raise StudioError(
443
+ "INTERACTION_SUBMIT_FAILED",
444
+ str(exc),
445
+ status_code=409,
446
+ ) from exc
447
+ elif mode == "resume":
448
+ queue = self._control_queues.get(run_id)
449
+ if queue is None:
450
+ raise StudioError("INTERACTION_EXPIRED", "运行时交互已失效", status_code=409)
451
+ queue.put_nowait(("resume", payload))
452
+ else:
453
+ raise StudioError("INTERACTION_EXPIRED", "运行时交互已失效", status_code=409)
454
+
455
+ resolved = self.event_store.append(
456
+ run_id,
457
+ "approval.resolved" if kind == "approval" else "interaction.resolved",
458
+ {
459
+ "runId": run_id,
460
+ "interactionId": interaction_id,
461
+ "callId": interaction_id,
462
+ "name": name,
463
+ "data": dict(data or {}),
464
+ },
465
+ )
466
+ action = self.event_store.append(
467
+ run_id,
468
+ "a2ui.action",
469
+ {
470
+ "runId": run_id,
471
+ "surfaceId": str(
472
+ interaction.data.get("surfaceId") or interaction.data.get("surface_id") or ""
473
+ ),
474
+ "interactionId": interaction_id,
475
+ "actionId": f"action-{interaction_id}",
476
+ "name": name,
477
+ "data": dict(data or {}),
478
+ },
479
+ )
480
+ record.status = RunStatus.RUNNING
481
+ self.event_store.save(record)
482
+ self._waiting_modes.pop(run_id, None)
483
+ return {
484
+ "runId": run_id,
485
+ "interactionId": interaction_id,
486
+ "status": "resolved",
487
+ "eventId": action.id,
488
+ "resolutionEventId": resolved.id,
489
+ }
490
+
491
+ def _persist_approval_surface(
492
+ self,
493
+ record: RunRecord,
494
+ event: RuntimeEvent,
495
+ *,
496
+ on_event: Callable[[RunEvent], None] | None,
497
+ ) -> None:
498
+ approval_id = str(event.payload.get("approval_id") or event.payload.get("call_id") or "")
499
+ if not approval_id:
500
+ return
501
+ surface_id = f"approval-{approval_id}"
502
+ detail = event.payload.get("detail")
503
+ detail = detail if isinstance(detail, dict) else {}
504
+ command = str(detail.get("command") or detail.get("reason") or "")
505
+ kind = str(event.payload.get("kind") or "tool")
506
+ components = [
507
+ {
508
+ "id": "root",
509
+ "component": "Card",
510
+ "title": "需要你的确认",
511
+ "children": ["approval"],
512
+ },
513
+ {
514
+ "id": "approval",
515
+ "component": "ApprovalBar",
516
+ "tool_name": kind,
517
+ "summary": command or f"Agent 请求执行 {kind} 操作",
518
+ "approve_label": "批准",
519
+ "deny_label": "拒绝",
520
+ },
521
+ ]
522
+ begin = self.event_store.append(
523
+ record.id,
524
+ "a2ui.surface.begin",
525
+ {
526
+ "runId": record.id,
527
+ "surfaceId": surface_id,
528
+ "a2uiOperations": [
529
+ {
530
+ "version": "v0.9",
531
+ "createSurface": {
532
+ "surfaceId": surface_id,
533
+ "catalogId": "https://a2ui.org/specification/v0_9/basic_catalog.json",
534
+ },
535
+ },
536
+ {
537
+ "version": "v0.9",
538
+ "updateComponents": {
539
+ "surfaceId": surface_id,
540
+ "components": components,
541
+ },
542
+ },
543
+ ],
544
+ },
545
+ )
546
+ interaction = self.event_store.append(
547
+ record.id,
548
+ "a2ui.interaction",
549
+ {
550
+ "runId": record.id,
551
+ "surfaceId": surface_id,
552
+ "interactionId": approval_id,
553
+ "kind": "approval",
554
+ "inputSchema": {
555
+ "type": "object",
556
+ "properties": {
557
+ "decision": {
558
+ "type": "string",
559
+ "enum": ["approve", "approve_session", "deny"],
560
+ }
561
+ },
562
+ "required": ["decision"],
563
+ },
564
+ },
565
+ )
566
+ if on_event is not None:
567
+ on_event(begin)
568
+ on_event(interaction)
569
+
570
+ def _conversation_messages(
571
+ self,
572
+ agent_id: str,
573
+ session_id: str,
574
+ user_input: str,
575
+ ) -> list[dict[str, str]]:
576
+ messages: list[dict[str, str]] = []
577
+ for previous in self.event_store.list_runs(session_id=session_id):
578
+ if previous.agent_id != agent_id or previous.status != RunStatus.COMPLETED:
579
+ continue
580
+ messages.append({"role": "user", "content": previous.input})
581
+ messages.append({"role": "assistant", "content": previous.output})
582
+ messages.append({"role": "user", "content": user_input})
583
+ return messages
584
+
585
+ def _native_session_metadata(
586
+ self,
587
+ agent_id: str,
588
+ session_id: str,
589
+ runtime_type: str,
590
+ ) -> dict[str, str]:
591
+ if runtime_type != "codex":
592
+ return {}
593
+ for previous in self.event_store.list_runs(session_id=session_id):
594
+ if previous.agent_id != agent_id or previous.status != RunStatus.COMPLETED:
595
+ continue
596
+ native_ref = previous.runtime_handle.get("native_ref")
597
+ native_ref = native_ref if isinstance(native_ref, dict) else {}
598
+ thread_id = str(native_ref.get("thread_id") or "")
599
+ if thread_id:
600
+ return {"thread_id": thread_id}
601
+ return {}
602
+
603
+
604
+ def project_runtime_event(event: RuntimeEvent) -> tuple[str, dict[str, Any]]:
605
+ """Project the canonical RuntimeEvent into Studio's persisted event view."""
606
+
607
+ payload = dict(event.payload)
608
+ event_type = event.event_type
609
+ if event_type == EventType.RUN_STARTED:
610
+ projected = "run.started"
611
+ elif event_type == EventType.RUN_PROGRESS:
612
+ projected = str(payload.get("native_event") or "run.progress")
613
+ native_data = payload.get("native_data")
614
+ if isinstance(native_data, dict):
615
+ payload = dict(native_data)
616
+ elif event_type in {EventType.REASONING_DELTA, EventType.REASONING_COMPLETED}:
617
+ projected = (
618
+ "thinking.delta" if event_type == EventType.REASONING_DELTA else "thinking.completed"
619
+ )
620
+ elif event_type == EventType.TEXT_DELTA:
621
+ projected = "message.delta" if event.phase == "final_answer" else "thinking.delta"
622
+ elif event_type == EventType.TEXT_COMPLETED:
623
+ projected = "message.completed" if event.phase == "final_answer" else "thinking.completed"
624
+ elif event_type == EventType.TOOL_CALL_BEGIN:
625
+ projected = "command.started" if payload.get("name") == "codex.command" else "tool.started"
626
+ if projected == "command.started":
627
+ raw_args = payload.get("args")
628
+ args: dict[str, Any] = raw_args if isinstance(raw_args, dict) else {}
629
+ payload = {
630
+ "callId": str(payload.get("call_id") or ""),
631
+ "command": str(args.get("command") or ""),
632
+ "cwd": str(args.get("cwd") or ""),
633
+ "commandActions": args.get("command_actions") or [],
634
+ }
635
+ else:
636
+ payload = {
637
+ "callId": str(payload.get("call_id") or ""),
638
+ "tool": str(payload.get("name") or ""),
639
+ "args": payload.get("args"),
640
+ }
641
+ elif event_type == EventType.TOOL_CALL_END:
642
+ projected = (
643
+ "command.completed" if payload.get("name") == "codex.command" else "tool.completed"
644
+ )
645
+ if projected == "command.completed":
646
+ raw_result = payload.get("result")
647
+ result: dict[str, Any] = raw_result if isinstance(raw_result, dict) else {}
648
+ payload = {
649
+ "callId": str(payload.get("call_id") or ""),
650
+ "status": str(result.get("status") or ""),
651
+ "exitCode": result.get("exit_code"),
652
+ "durationMs": result.get("duration_ms"),
653
+ "output": str(result.get("output") or ""),
654
+ }
655
+ else:
656
+ raw_tool_result = payload.get("result")
657
+ tool_result: dict[str, Any] = (
658
+ raw_tool_result if isinstance(raw_tool_result, dict) else {}
659
+ )
660
+ tool_status = str(tool_result.get("status") or "")
661
+ if tool_result.get("error"):
662
+ tool_status = "failed"
663
+ payload = {
664
+ "callId": str(payload.get("call_id") or ""),
665
+ "tool": str(payload.get("name") or ""),
666
+ "status": tool_status,
667
+ "durationMs": tool_result.get("duration_ms"),
668
+ "output": str(tool_result.get("output") or ""),
669
+ **({"error": str(tool_result["error"])} if tool_result.get("error") else {}),
670
+ }
671
+ elif event_type == EventType.RUN_COMPLETED:
672
+ projected = "run.completed"
673
+ elif event_type == EventType.RUN_FAILED:
674
+ projected = "run.failed"
675
+ elif event_type == EventType.RUN_CANCELED:
676
+ projected = "run.cancelled"
677
+ elif event_type == EventType.RUN_INTERRUPTED:
678
+ projected = (
679
+ "run.paused" if str(payload.get("status") or "") == "paused" else "run.interrupted"
680
+ )
681
+ elif event_type in {
682
+ EventType.A2UI_SURFACE_BEGIN,
683
+ EventType.A2UI_SURFACE_UPDATE,
684
+ EventType.A2UI_SURFACE_END,
685
+ EventType.A2UI_INTERACTION,
686
+ EventType.A2UI_ACTION,
687
+ }:
688
+ projected = str(event_type)
689
+ surface_id = str(payload.get("surface_id") or payload.get("surfaceId") or "")
690
+ if surface_id:
691
+ payload["surfaceId"] = surface_id
692
+ interaction_id = str(payload.get("interaction_id") or payload.get("interactionId") or "")
693
+ if interaction_id:
694
+ payload["interactionId"] = interaction_id
695
+ schema = payload.get("input_schema", payload.get("inputSchema"))
696
+ if isinstance(schema, dict):
697
+ payload["inputSchema"] = schema
698
+ operations = project_a2ui_operations(event_type, payload)
699
+ if operations:
700
+ payload["a2uiOperations"] = operations
701
+ else:
702
+ projected = str(event_type)
703
+ payload["runtimeEvent"] = event.to_dict()
704
+ return projected, payload
705
+
706
+
707
+ __all__ = ["StudioRunService", "StudioRunSpec", "project_runtime_event"]