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,52 @@
1
+ """Stable route-group registry for runtime app composition."""
2
+
3
+ import importlib
4
+
5
+ from fastapi import APIRouter
6
+
7
+ health_meta_router = APIRouter()
8
+ sessions_router = APIRouter()
9
+ sessions_adk_compat_router = APIRouter()
10
+ run_router = APIRouter()
11
+ openai_compat_router = APIRouter()
12
+ workspace_router = APIRouter()
13
+ models_router = APIRouter()
14
+ feedback_router = APIRouter()
15
+ tools_router = APIRouter()
16
+ ui_bootstrap_router = APIRouter()
17
+ control_router = APIRouter()
18
+ builder_router = APIRouter()
19
+ debug_router = APIRouter()
20
+
21
+ GROUP_ROUTERS: dict[str, APIRouter] = {
22
+ "builder": builder_router,
23
+ "control": control_router,
24
+ "debug": debug_router,
25
+ "feedback": feedback_router,
26
+ "models": models_router,
27
+ "openai_compat": openai_compat_router,
28
+ "run": run_router,
29
+ "sessions": sessions_router,
30
+ "sessions_adk_compat": sessions_adk_compat_router,
31
+ "tools": tools_router,
32
+ "ui_bootstrap": ui_bootstrap_router,
33
+ "workspace": workspace_router,
34
+ "health_meta": health_meta_router,
35
+ }
36
+
37
+ _ROUTE_MODULES = (
38
+ "common",
39
+ "sessions",
40
+ "control",
41
+ "workspace",
42
+ "run",
43
+ "misc",
44
+ "openai_compat",
45
+ )
46
+
47
+
48
+ def load_route_modules() -> None:
49
+ """Import each domain module once so its decorators populate the routers."""
50
+ package = __package__ or "ksadk.server.routes"
51
+ for module_name in _ROUTE_MODULES:
52
+ importlib.import_module(f"{package}.{module_name}")
@@ -0,0 +1,519 @@
1
+ """RunAgent, legacy SSE, and builder-cancel execution routes."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import logging
7
+ import time
8
+ import uuid
9
+ from collections.abc import Mapping
10
+ from typing import TYPE_CHECKING, Any
11
+
12
+ from fastapi.responses import StreamingResponse
13
+
14
+ from ksadk.conversations.normalize import (
15
+ normalize_kop_messages,
16
+ normalize_parts_content,
17
+ normalize_responses_input,
18
+ )
19
+ from ksadk.conversations.run_kinds import (
20
+ RUN_MODE_BACKGROUND,
21
+ RUN_MODE_FOREGROUND,
22
+ trigger_from_resume_input,
23
+ )
24
+ from ksadk.conversations.runtime_metadata import prime_session_metadata_for_user_turn
25
+ from ksadk.conversations.runtime_payloads import (
26
+ build_chat_completions_payload,
27
+ build_responses_payload,
28
+ extract_responses_resume_input,
29
+ )
30
+ from ksadk.conversations.runtime_persistence import (
31
+ append_run_status_event,
32
+ ensure_conversation_session,
33
+ )
34
+ from ksadk.conversations.runtime_streaming import (
35
+ stream_runtime_conversation_turn,
36
+ stream_runtime_responses_conversation_turn,
37
+ )
38
+
39
+ if TYPE_CHECKING:
40
+ pass
41
+ from ksadk.ids import new_run_id
42
+ from ksadk.runtime.conversation_execution import (
43
+ invoke_runtime_conversation_once,
44
+ iter_runtime_conversation_semantic_events,
45
+ )
46
+ from ksadk.server.api_models import AgentRunRequest
47
+ from ksadk.server.factory import get_runtime_execution
48
+
49
+ from . import dependencies as deps
50
+ from .checkpoint_resolution import _resolve_checkpoint_resume_input_from_session
51
+ from .common import (
52
+ _action_response,
53
+ )
54
+ from .models import (
55
+ RunAgentActionRequest,
56
+ _clean_optional_string,
57
+ _run_agent_response_metadata,
58
+ _runtime_agent_id,
59
+ _split_custom_metadata,
60
+ )
61
+ from .routers import control_router, run_router
62
+ from .streaming import (
63
+ _clear_detached_resume_key,
64
+ _detached_resume_key_from_input,
65
+ _DetachedSSEStream,
66
+ _reject_if_detached_resume_active,
67
+ )
68
+
69
+ logger = logging.getLogger(__name__)
70
+
71
+
72
+ @run_router.post("/agentengine/api/v1/RunAgent")
73
+ async def run_agent_action(request: RunAgentActionRequest):
74
+ executor, launch_context = get_runtime_execution()
75
+ api_format = (request.ApiFormat or "responses").strip().lower()
76
+ run_user_id = _clean_optional_string(request.UserId) or "user"
77
+ account_id = _clean_optional_string(request.AccountId)
78
+ service = deps.resolve_session_service()
79
+ resume_input = (
80
+ extract_responses_resume_input(request.ResponsesInput)
81
+ if request.ResponsesInput is not None
82
+ else None
83
+ )
84
+ resume_input = await _resolve_checkpoint_resume_input_from_session(
85
+ service=service,
86
+ agent_id=request.AgentId,
87
+ session_id=request.SessionId,
88
+ resume_input=resume_input,
89
+ )
90
+ if resume_input is not None:
91
+ messages = []
92
+ elif request.ResponsesInput is not None and api_format == "responses":
93
+ messages = normalize_responses_input(request.ResponsesInput)
94
+ else:
95
+ messages = normalize_kop_messages(request.Messages)
96
+ request_metadata: dict[str, Any] = (
97
+ {"previous_response_id": request.PreviousResponseId} if request.PreviousResponseId else {}
98
+ )
99
+ custom_metadata, metadata_runtime_controls = _split_custom_metadata(request.Metadata)
100
+ request_metadata.update(metadata_runtime_controls)
101
+ if api_format == "responses":
102
+ request_metadata["responses_conversation"] = True
103
+
104
+ if request.Background:
105
+ runtime_preparation = (
106
+ None
107
+ if resume_input is not None
108
+ else await executor.prepare_start(launch_context)
109
+ )
110
+ invocation_id = request.InvocationId or new_run_id(request.SessionId)
111
+ # 后台 stream 在 detached task 里才被消费(lazy),此时 session 尚未创建。
112
+ # 先 ensure 出 session,才能立刻写 run_status=in_progress(供 SubscribeRunEvents
113
+ # 拉到起始态),并把 resolved session_id 回填给 detached stream 的终态写入与 SubscribeUrl。
114
+ background_session = await ensure_conversation_session(
115
+ agent_id=request.AgentId,
116
+ user_id=run_user_id,
117
+ session_id=request.SessionId,
118
+ session_service_provider=deps.resolve_session_service,
119
+ )
120
+ resolved_background_session_id = background_session.id
121
+ if resume_input is None:
122
+ await prime_session_metadata_for_user_turn(
123
+ service=service,
124
+ session=background_session,
125
+ messages=messages,
126
+ )
127
+ await append_run_status_event(
128
+ session_id=resolved_background_session_id,
129
+ author=_runtime_agent_id(launch_context),
130
+ status="in_progress",
131
+ invocation_id=invocation_id,
132
+ session_service_provider=deps.resolve_session_service,
133
+ run_mode=RUN_MODE_BACKGROUND,
134
+ run_trigger=trigger_from_resume_input(resume_input),
135
+ )
136
+ resume_key = _detached_resume_key_from_input(resolved_background_session_id, resume_input)
137
+ _reject_if_detached_resume_active(resume_key)
138
+ detached = _DetachedSSEStream(
139
+ stream_runtime_responses_conversation_turn(
140
+ executor=executor,
141
+ launch_context=launch_context,
142
+ agent_id=request.AgentId,
143
+ user_id=run_user_id,
144
+ messages=messages,
145
+ session_id=resolved_background_session_id,
146
+ model=request.Model,
147
+ model_metadata=request.ModelMetadata,
148
+ model_options=request.ModelOptions,
149
+ request_metadata=request_metadata or None,
150
+ custom_metadata=custom_metadata,
151
+ include_agentengine_metadata=True,
152
+ resume_input=resume_input,
153
+ account_id=account_id,
154
+ invocation_id=invocation_id,
155
+ session_service_provider=deps.resolve_session_service,
156
+ run_mode=RUN_MODE_BACKGROUND,
157
+ runtime_preparation=runtime_preparation,
158
+ ),
159
+ invocation_id=invocation_id,
160
+ session_id=resolved_background_session_id,
161
+ run_mode=RUN_MODE_BACKGROUND,
162
+ run_trigger=trigger_from_resume_input(resume_input),
163
+ )
164
+ if invocation_id and resume_key:
165
+ resolved_resume_key = resume_key
166
+ registry = detached._registry
167
+ registry.resume_keys_by_invocation[invocation_id] = resolved_resume_key
168
+ registry.active_resume_invocation_by_key[resolved_resume_key] = invocation_id
169
+
170
+ def clear_resume_key(_task: Any) -> None:
171
+ _clear_detached_resume_key(registry, invocation_id, resolved_resume_key)
172
+
173
+ detached._task.add_done_callback(clear_resume_key)
174
+ return _action_response(
175
+ "RunAgent",
176
+ {
177
+ "SessionId": resolved_background_session_id,
178
+ "InvocationId": invocation_id,
179
+ "Status": "running",
180
+ "Background": True,
181
+ "SubscribeUrl": (
182
+ "/agentengine/api/v1/SubscribeRunEvents"
183
+ f"?SessionId={resolved_background_session_id}"
184
+ f"&InvocationId={invocation_id}"
185
+ ),
186
+ },
187
+ )
188
+
189
+ if request.Stream:
190
+ runtime_preparation = (
191
+ None
192
+ if resume_input is not None
193
+ else await executor.prepare_start(launch_context)
194
+ )
195
+ if api_format == "chat_completions":
196
+ return StreamingResponse(
197
+ stream_runtime_conversation_turn(
198
+ executor=executor,
199
+ launch_context=launch_context,
200
+ agent_id=_runtime_agent_id(launch_context),
201
+ user_id=run_user_id,
202
+ messages=messages,
203
+ session_id=request.SessionId,
204
+ model=request.Model,
205
+ model_metadata=request.ModelMetadata,
206
+ model_options=request.ModelOptions,
207
+ request_metadata=request_metadata or None,
208
+ custom_metadata=custom_metadata,
209
+ account_id=account_id,
210
+ invocation_id=request.InvocationId,
211
+ session_service_provider=deps.resolve_session_service,
212
+ run_mode=RUN_MODE_FOREGROUND,
213
+ runtime_preparation=runtime_preparation,
214
+ ),
215
+ media_type="text/event-stream",
216
+ )
217
+ resume_key = _detached_resume_key_from_input(request.SessionId, resume_input)
218
+ _reject_if_detached_resume_active(resume_key)
219
+ return deps.detached_streaming_response(
220
+ stream_runtime_responses_conversation_turn(
221
+ executor=executor,
222
+ launch_context=launch_context,
223
+ agent_id=request.AgentId,
224
+ user_id=run_user_id,
225
+ messages=messages,
226
+ session_id=request.SessionId,
227
+ model=request.Model,
228
+ model_metadata=request.ModelMetadata,
229
+ model_options=request.ModelOptions,
230
+ request_metadata=request_metadata or None,
231
+ custom_metadata=custom_metadata,
232
+ include_agentengine_metadata=True,
233
+ resume_input=resume_input,
234
+ account_id=account_id,
235
+ invocation_id=request.InvocationId,
236
+ session_service_provider=deps.resolve_session_service,
237
+ run_mode=RUN_MODE_FOREGROUND,
238
+ runtime_preparation=runtime_preparation,
239
+ ),
240
+ invocation_id=request.InvocationId,
241
+ resume_key=resume_key,
242
+ run_mode=RUN_MODE_FOREGROUND,
243
+ run_trigger=trigger_from_resume_input(resume_input),
244
+ )
245
+
246
+ responses_response_id = f"resp_{uuid.uuid4().hex}" if api_format != "chat_completions" else None
247
+ resolved_session_id, result = await invoke_runtime_conversation_once(
248
+ executor=executor,
249
+ launch_context=launch_context,
250
+ agent_id=request.AgentId,
251
+ user_id=run_user_id,
252
+ messages=messages,
253
+ session_id=request.SessionId,
254
+ model=request.Model,
255
+ model_metadata=request.ModelMetadata,
256
+ model_options=request.ModelOptions,
257
+ request_metadata=request_metadata or None,
258
+ custom_metadata=custom_metadata,
259
+ resume_input=resume_input,
260
+ response_id=responses_response_id,
261
+ account_id=account_id,
262
+ invocation_id=request.InvocationId,
263
+ session_service_provider=deps.resolve_session_service,
264
+ run_mode=RUN_MODE_FOREGROUND,
265
+ )
266
+ output_text = result["output_text"]
267
+ if api_format == "chat_completions":
268
+ payload = build_chat_completions_payload(
269
+ output_text=output_text,
270
+ model=request.Model,
271
+ session_id=resolved_session_id,
272
+ metadata=result.get("metadata"),
273
+ )
274
+ else:
275
+ payload = build_responses_payload(
276
+ output_text=output_text,
277
+ model=request.Model,
278
+ session_id=resolved_session_id,
279
+ response_id=responses_response_id,
280
+ metadata=_run_agent_response_metadata(custom_metadata, result),
281
+ usage=result.get("usage") if isinstance(result.get("usage"), Mapping) else None,
282
+ )
283
+ return _action_response("RunAgent", payload)
284
+
285
+
286
+ # ============================================================
287
+ # Session Management API (ADK Web Compatible)
288
+ # ============================================================
289
+
290
+
291
+ def _adk_sse_event(payload: Mapping[str, Any], *, event: str | None = None) -> str:
292
+ prefix = f"event: {event}\n" if event else ""
293
+ return f"{prefix}data: {json.dumps(dict(payload), ensure_ascii=False)}\n\n"
294
+
295
+
296
+ def _adk_usage_metadata(usage: Mapping[str, Any] | None) -> dict[str, int] | None:
297
+ if not isinstance(usage, Mapping):
298
+ return None
299
+ prompt = usage.get("input_tokens", usage.get("prompt_tokens"))
300
+ candidates = usage.get("output_tokens", usage.get("completion_tokens"))
301
+ if not isinstance(prompt, int) or not isinstance(candidates, int):
302
+ return None
303
+ return {
304
+ "promptTokenCount": prompt,
305
+ "candidatesTokenCount": candidates,
306
+ "totalTokenCount": prompt + candidates,
307
+ }
308
+
309
+
310
+ async def _runtime_run_sse(request: AgentRunRequest) -> StreamingResponse:
311
+ executor, launch_context = get_runtime_execution()
312
+ # Validate explicit ownership before StreamingResponse commits HTTP 200.
313
+ # Also resolve an omitted id exactly once so preparation cannot create a
314
+ # second, orphaned session after the response generator starts.
315
+ execution_session = await ensure_conversation_session(
316
+ agent_id=request.appName,
317
+ user_id=request.userId,
318
+ session_id=request.sessionId,
319
+ session_service_provider=deps.resolve_session_service,
320
+ )
321
+ execution_session_id = execution_session.id
322
+ normalized = normalize_parts_content(request.newMessage.parts)
323
+ message = {
324
+ "role": "user",
325
+ "content": str(normalized.get("content") or ""),
326
+ "display_content": str(normalized.get("display_content") or ""),
327
+ "parts": list(normalized.get("parts") or []),
328
+ "attachments": list(normalized.get("attachments") or []),
329
+ "attachment_results": list(normalized.get("attachment_results") or []),
330
+ }
331
+ invocation_id = request.invocationId or new_run_id(execution_session_id)
332
+ author = _runtime_agent_id(launch_context)
333
+
334
+ async def event_generator():
335
+ if not request.streaming:
336
+ try:
337
+ session_id, result = await invoke_runtime_conversation_once(
338
+ executor=executor,
339
+ launch_context=launch_context,
340
+ agent_id=request.appName,
341
+ user_id=request.userId,
342
+ messages=[message],
343
+ session_id=execution_session_id,
344
+ model=request.model,
345
+ state_delta=request.stateDelta or {},
346
+ invocation_id=invocation_id,
347
+ session_service_provider=deps.resolve_session_service,
348
+ run_mode=RUN_MODE_FOREGROUND,
349
+ )
350
+ output_text = str(result.get("output_text") or "")
351
+ payload: dict[str, Any] = {
352
+ "id": str(uuid.uuid4()),
353
+ "author": author,
354
+ "sessionId": session_id,
355
+ "invocationId": invocation_id,
356
+ "content": {"role": "model", "parts": [{"text": output_text}]},
357
+ "actions": {"finishReason": "STOP"},
358
+ "modelVersion": request.model or "models/unknown",
359
+ "timestamp": int(time.time() * 1000),
360
+ }
361
+ usage_metadata = _adk_usage_metadata(result.get("usage"))
362
+ if usage_metadata is not None:
363
+ payload["usageMetadata"] = usage_metadata
364
+ yield _adk_sse_event(payload)
365
+ except Exception:
366
+ logger.exception("Error in RuntimeAdapter invoke")
367
+ yield _adk_sse_event(
368
+ {
369
+ "id": str(uuid.uuid4()),
370
+ "sessionId": execution_session_id,
371
+ "invocationId": invocation_id,
372
+ "error": "agent_run_failed",
373
+ "errorMessage": "The agent run failed. See server logs for details.",
374
+ "timestamp": int(time.time() * 1000),
375
+ }
376
+ )
377
+ return
378
+
379
+ session_id = execution_session_id
380
+ visible_text = ""
381
+ try:
382
+ async for event in iter_runtime_conversation_semantic_events(
383
+ executor=executor,
384
+ launch_context=launch_context,
385
+ agent_id=request.appName,
386
+ user_id=request.userId,
387
+ messages=[message],
388
+ session_id=execution_session_id,
389
+ model=request.model,
390
+ state_delta=request.stateDelta or {},
391
+ invocation_id=invocation_id,
392
+ session_service_provider=deps.resolve_session_service,
393
+ run_mode=RUN_MODE_FOREGROUND,
394
+ ):
395
+ event_type = event.get("type")
396
+ session_id = str(event.get("session_id") or session_id)
397
+ if event_type == "thinking":
398
+ yield _adk_sse_event(
399
+ {"delta": str(event.get("delta") or "")},
400
+ event="response.reasoning.delta",
401
+ )
402
+ elif event_type == "compaction":
403
+ phase = str(event.get("phase") or "done")
404
+ yield _adk_sse_event(
405
+ {
406
+ key: value
407
+ for key, value in event.items()
408
+ if key not in {"type", "phase"} and value is not None
409
+ },
410
+ event=f"response.compaction.{phase}",
411
+ )
412
+ elif event_type == "text":
413
+ delta = str(event.get("delta") or "")
414
+ replace = bool(event.get("replace"))
415
+ visible_text = delta if replace else visible_text + delta
416
+ text_payload: dict[str, Any] = {
417
+ "id": str(uuid.uuid4()),
418
+ "author": author,
419
+ "sessionId": session_id,
420
+ "invocationId": invocation_id,
421
+ "content": {"role": "model", "parts": [{"text": delta}]},
422
+ "timestamp": int(time.time() * 1000),
423
+ }
424
+ if replace:
425
+ # A replacement snapshot is authoritative final output,
426
+ # not another partial token. Keep the replacement hint
427
+ # so clients can discard previously rendered deltas.
428
+ text_payload.update(
429
+ {
430
+ "replace": True,
431
+ "actions": {"finishReason": "STOP"},
432
+ "modelVersion": request.model or "models/unknown",
433
+ }
434
+ )
435
+ else:
436
+ text_payload.update({"partial": True, "replace": False})
437
+ yield _adk_sse_event(
438
+ text_payload
439
+ )
440
+ elif event_type == "tool_call":
441
+ yield _adk_sse_event(
442
+ {"name": event.get("name"), "args": event.get("args") or {}},
443
+ event="response.tool_call",
444
+ )
445
+ elif event_type == "tool_result":
446
+ yield _adk_sse_event(
447
+ {"name": event.get("name"), "output": event.get("output")},
448
+ event="response.tool_result",
449
+ )
450
+ elif event_type == "interrupt":
451
+ yield _adk_sse_event(
452
+ {"interrupt_info": event.get("interrupt_info")},
453
+ event="response.approval_request",
454
+ )
455
+ elif event_type == "completed":
456
+ final_text = str(event.get("output_text") or visible_text)
457
+ if final_text != visible_text:
458
+ yield _adk_sse_event(
459
+ {
460
+ "id": str(uuid.uuid4()),
461
+ "author": author,
462
+ "sessionId": session_id,
463
+ "invocationId": invocation_id,
464
+ "content": {
465
+ "role": "model",
466
+ "parts": [{"text": final_text}],
467
+ },
468
+ "actions": {"finishReason": "STOP"},
469
+ "modelVersion": request.model or "models/unknown",
470
+ "timestamp": int(time.time() * 1000),
471
+ }
472
+ )
473
+ elif event_type == "error":
474
+ yield _adk_sse_event(
475
+ {
476
+ "id": str(uuid.uuid4()),
477
+ "sessionId": session_id,
478
+ "invocationId": invocation_id,
479
+ "error": "agent_run_failed",
480
+ "errorMessage": str(event.get("message") or "Agent run failed"),
481
+ "timestamp": int(time.time() * 1000),
482
+ }
483
+ )
484
+ except Exception:
485
+ logger.exception("Error in RuntimeAdapter stream")
486
+ yield _adk_sse_event(
487
+ {
488
+ "id": str(uuid.uuid4()),
489
+ "sessionId": session_id,
490
+ "invocationId": invocation_id,
491
+ "error": "agent_run_failed",
492
+ "errorMessage": "The agent run failed. See server logs for details.",
493
+ "timestamp": int(time.time() * 1000),
494
+ }
495
+ )
496
+
497
+ return StreamingResponse(event_generator(), media_type="text/event-stream")
498
+
499
+
500
+ @run_router.post("/run_sse")
501
+ async def run_sse(request: AgentRunRequest):
502
+ """Unified Streaming Endpoint compatible with ADK Web
503
+
504
+ Respects the `streaming` parameter:
505
+ - streaming=False: Accumulate full response, send as single event
506
+ - streaming=True: Stream tokens as they arrive (real-time)
507
+ """
508
+ return await _runtime_run_sse(request)
509
+
510
+
511
+ # ============================================================
512
+ # Trace / Debug API (ADK Web Compatible)
513
+ # ============================================================
514
+
515
+
516
+ @control_router.post("/builder/app/{app_name}/cancel")
517
+ async def cancel_agent_changes(app_name: str):
518
+ """Cancel agent builder changes - stub for ADK-Web"""
519
+ return True