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,47 @@
1
+ """Runtime app route composition independent from the default app facade."""
2
+
3
+ from fastapi import FastAPI
4
+
5
+ from ksadk.server.factory import RuntimeAppState, get_state
6
+ from ksadk.server.routes.common import _register_integrated_routers, _resolve_agent_ui_spec
7
+ from ksadk.server.routes.routers import GROUP_ROUTERS, load_route_modules
8
+
9
+
10
+ def configure_runtime_app(app: FastAPI, state: RuntimeAppState, groups: set[str]) -> None:
11
+ """Attach integrated resources and the selected route groups to one app."""
12
+ load_route_modules()
13
+ _configure_route_dependencies()
14
+ _register_integrated_routers(app, state)
15
+
16
+ ordered = sorted(group for group in groups if group != "health_meta")
17
+ if "health_meta" in groups:
18
+ ordered.append("health_meta")
19
+ for group in ordered:
20
+ router = GROUP_ROUTERS.get(group)
21
+ if router is not None:
22
+ app.include_router(router)
23
+
24
+
25
+ def _configure_route_dependencies() -> None:
26
+ """Install dynamic providers that always resolve the request-bound app state."""
27
+
28
+ import ksadk.conversations as conversation
29
+ from ksadk.server.routes import dependencies
30
+ from ksadk.server.routes.streaming import (
31
+ SSE_HEARTBEAT_INTERVAL_SECONDS,
32
+ _DetachedSSEStream,
33
+ detached_streaming_response,
34
+ )
35
+
36
+ dependencies.configure(
37
+ dependencies.ServerRouteDependencies(
38
+ resolve_session_service=lambda: get_state().resolve_session_service(),
39
+ describe_session_backend=lambda: get_state().describe_session_backend(),
40
+ resolve_agent_ui_spec=_resolve_agent_ui_spec,
41
+ conversation=lambda: conversation,
42
+ detached_streaming_response=detached_streaming_response,
43
+ detached_stream_class=lambda: _DetachedSSEStream,
44
+ heartbeat_interval=lambda: SSE_HEARTBEAT_INTERVAL_SECONDS,
45
+ runtime_app=lambda: get_state().app,
46
+ )
47
+ )
@@ -0,0 +1,622 @@
1
+ """create_runtime_app — 普通 runtime 与 HarnessApp 共用的 app factory (goal-01)。
2
+
3
+ H2 §4.2:这是三线公共装配入口,替代 `ksadk/server/app.py` 的模块级单例 +
4
+ `set_runner` 全局态。纯结构性重构,不动业务逻辑。
5
+
6
+ 设计要点:
7
+
8
+ - **per-app state**:RuntimeExecutor / RuntimeLaunchContext / detached-stream registry 全部挂在
9
+ `app.state.runtime`(:class:`RuntimeAppState`)上,每个 app 实例一份,普通 app 与
10
+ HarnessApp 互不共享。不再有模块级 ``runner`` / ``_DETACHED_*`` 全局可变态。
11
+ - **请求级桥接**:中间件把当前 app 的 state 写入 :data:`current_state` 的
12
+ contextvar,handler 内既有辅助函数经 :func:`get_state` 取 state,从而**不必逐个
13
+ 改写约 30 个 handler 的签名**。后台 detached task 脱离请求上下文,在创建时
14
+ 从 state 捕获 registry(见 ``_detached_streaming_response``)。
15
+ - **route group 化**:路由按域拆成 APIRouter,factory 按 ``config.route_groups``
16
+ 可插拔装配;数据面 group 进 HarnessApp,控制面(cancel/resume/builder/debug)
17
+ 不进。
18
+ - **薄兼容壳**:`ksadk/server/app.py` 仍以 ``app`` / ``set_runner`` 暴露,内部
19
+ 改为调用本 factory,老调用方(TestClient / run_server / builders / deploy
20
+ manager)零改动。
21
+ """
22
+
23
+ from __future__ import annotations
24
+
25
+ import asyncio
26
+ import contextvars
27
+ import logging
28
+ from contextlib import contextmanager
29
+ from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional
30
+
31
+ from fastapi import FastAPI
32
+
33
+ from ksadk.runtime.adapter import RuntimeAdapter, RuntimeLaunchContext
34
+ from ksadk.runtime.executor import RuntimeExecutor
35
+ from ksadk.sandbox.registry import (
36
+ SandboxRegistry,
37
+ bind_sandbox_registry,
38
+ set_fallback_sandbox_registry,
39
+ )
40
+
41
+ logger = logging.getLogger(__name__)
42
+
43
+ if TYPE_CHECKING:
44
+ from ksadk.server.terminal_sessions import TerminalSessionManager
45
+
46
+
47
+ # ---------------------------------------------------------------------------
48
+ # route group 注册表(冻结稿 G0.1):数据面 vs 控制面
49
+ # ---------------------------------------------------------------------------
50
+
51
+ #: 数据面 route group —— 可插拔装配进 HarnessApp。
52
+ DATA_PLANE_GROUPS: frozenset[str] = frozenset(
53
+ {
54
+ "health_meta",
55
+ "sessions",
56
+ "sessions_adk_compat",
57
+ "run",
58
+ "openai_compat",
59
+ "workspace",
60
+ "models",
61
+ "feedback",
62
+ "tools",
63
+ "ui_bootstrap",
64
+ "agui",
65
+ }
66
+ )
67
+
68
+ #: 控制面 route group —— 不进入 HarnessApp(H2 §4.2:控制面 action 不进入)。
69
+ CONTROL_PLANE_GROUPS: frozenset[str] = frozenset(
70
+ {
71
+ "control", # cancel / resume / checkpoint-resume-preview
72
+ "builder",
73
+ "debug",
74
+ }
75
+ )
76
+
77
+ #: 全部 group(普通 runtime app 默认装配)。
78
+ ALL_GROUPS: frozenset[str] = DATA_PLANE_GROUPS | CONTROL_PLANE_GROUPS
79
+
80
+
81
+ class StreamRegistry:
82
+ """per-app detached SSE stream + resume-key 状态。
83
+
84
+ 替代 `app.py` 曾经的模块级 ``_DETACHED_STREAMS`` / ``_DETACHED_STREAMS_BY_INVOCATION``
85
+ / ``_DETACHED_RESUME_KEYS_BY_INVOCATION`` / ``_ACTIVE_DETACHED_RESUME_INVOCATION_BY_KEY``。
86
+ 生命周期绑定所属 app(lifespan 清理)。SSE/cancel 行为与旧模块级实现逐点一致。
87
+ """
88
+
89
+ def __init__(self) -> None:
90
+ self.streams: set[asyncio.Task[Any]] = set()
91
+ self.streams_by_invocation: dict[str, Any] = {}
92
+ self.resume_keys_by_invocation: dict[str, tuple[str, str]] = {}
93
+ self.active_resume_invocation_by_key: dict[tuple[str, str], str] = {}
94
+
95
+ def clear(self) -> None:
96
+ self.streams.clear()
97
+ self.streams_by_invocation.clear()
98
+ self.resume_keys_by_invocation.clear()
99
+ self.active_resume_invocation_by_key.clear()
100
+
101
+
102
+ class RuntimeAppState:
103
+ """per-app 运行时状态及其拥有的可清理资源。"""
104
+
105
+ def __init__(
106
+ self,
107
+ *,
108
+ executor: RuntimeExecutor | None = None,
109
+ launch_context: RuntimeLaunchContext | None = None,
110
+ session_service_provider: Callable[[], Any] | None = None,
111
+ session_backend_provider: Callable[[], dict[str, Any]] | None = None,
112
+ ) -> None:
113
+ self.app: Optional[FastAPI] = None
114
+ self.executor = executor
115
+ self.launch_context = launch_context
116
+ self.stream_registry = StreamRegistry()
117
+ self.sandbox_registry = SandboxRegistry()
118
+ self.session_service: Any = None
119
+ self._session_services_by_loop: dict[asyncio.AbstractEventLoop, Any] = {}
120
+ self._sync_session_service: Any = None
121
+ # The legacy ``server.app`` facade exposes monkeypatchable providers.
122
+ # New factory callers leave these unset and get per-app owned services.
123
+ self._session_service_provider = session_service_provider
124
+ self._session_backend_provider = session_backend_provider
125
+ # app.py 在装配 terminal routes 时创建,避免 factory 反向依赖 server。
126
+ self.terminal_manager: Optional[TerminalSessionManager] = None
127
+ # A2A 装配产物(config.a2a.enabled 时由 _wire_a2a_if_enabled 写入)。
128
+ self.a2a_server: Any = None
129
+ self.a2a_bootstrap: Any = None
130
+ # AG-UI endpoint 及其 app-owned RuntimeAdapter handle registry。
131
+ self.agui_agent: Any = None
132
+ self.agui_config: Any = None
133
+
134
+ def resolve_session_service(self) -> Any:
135
+ """Return this app's session service for the current execution loop."""
136
+ if self.session_service is not None:
137
+ return self.session_service
138
+ if self._session_service_provider is not None:
139
+ return self._session_service_provider()
140
+
141
+ from ksadk.sessions import create_session_service
142
+
143
+ try:
144
+ loop = asyncio.get_running_loop()
145
+ except RuntimeError:
146
+ if self._sync_session_service is None:
147
+ self._sync_session_service = create_session_service()
148
+ return self._sync_session_service
149
+
150
+ service = self._session_services_by_loop.get(loop)
151
+ if service is None:
152
+ service = create_session_service()
153
+ self._session_services_by_loop[loop] = service
154
+ return service
155
+
156
+ def session_services(self) -> list[Any]:
157
+ """Return all unique services owned by this app for shutdown."""
158
+ candidates = [
159
+ self.session_service,
160
+ self._sync_session_service,
161
+ *self._session_services_by_loop.values(),
162
+ ]
163
+ services: list[Any] = []
164
+ for service in candidates:
165
+ if service is not None and all(service is not item for item in services):
166
+ services.append(service)
167
+ return services
168
+
169
+ def describe_session_backend(self) -> dict[str, Any]:
170
+ if self._session_backend_provider is not None:
171
+ return dict(self._session_backend_provider())
172
+ from ksadk.sessions import describe_session_backend
173
+
174
+ return dict(describe_session_backend())
175
+
176
+
177
+ class RuntimeAppConfig:
178
+ """create_runtime_app 的装配配置。
179
+
180
+ - ``runtime_executor``:统一 Runtime 生命周期入口。
181
+ - ``launch_context``:当前 Runtime 与项目的不可变启动上下文。
182
+ - ``runtime_type``:runtime 类型标识(普通 / harness / codex ...)。
183
+ - ``route_groups``:要装配的 route group 集合;默认 :data:`ALL_GROUPS`,
184
+ HarnessApp 传 :data:`DATA_PLANE_GROUPS`。
185
+ """
186
+
187
+ def __init__(
188
+ self,
189
+ *,
190
+ runtime_type: str = "local",
191
+ route_groups: Optional[set[str]] = None,
192
+ a2a: Optional[Any] = None,
193
+ a2a_runtime_adapter: RuntimeAdapter | None = None,
194
+ agui: Optional[Any] = None,
195
+ runtime_executor: RuntimeExecutor | None = None,
196
+ launch_context: RuntimeLaunchContext | None = None,
197
+ session_service_provider: Callable[[], Any] | None = None,
198
+ session_backend_provider: Callable[[], dict[str, Any]] | None = None,
199
+ ) -> None:
200
+ self.runtime_type = runtime_type
201
+ self.route_groups: set[str] = (
202
+ set(route_groups) if route_groups is not None else set(ALL_GROUPS)
203
+ )
204
+ # A2A 协议装配配置(``ksadk.a2a.routes.A2AConfig``);enabled 时 factory 装配
205
+ # A2A 数据面端点(契约 §8)。用 Any 避免本模块硬依赖可选的 a2a-sdk。
206
+ self.a2a = a2a
207
+ self.a2a_runtime_adapter = a2a_runtime_adapter
208
+ self.agui = agui
209
+ self.runtime_executor = runtime_executor
210
+ self.launch_context = launch_context
211
+ self.session_service_provider = session_service_provider
212
+ self.session_backend_provider = session_backend_provider
213
+
214
+
215
+ # ---------------------------------------------------------------------------
216
+ # 请求级 state 桥接
217
+ # ---------------------------------------------------------------------------
218
+
219
+ _current_state: contextvars.ContextVar[Optional[RuntimeAppState]] = contextvars.ContextVar(
220
+ "ksadk_runtime_app_state", default=None
221
+ )
222
+
223
+ # 非请求上下文(直接调用内部 helper 的测试 / run_server 启动前)的兜底 state。
224
+ # 由 app.py 在 factory 建 app 后指向 ``app.state.runtime``。
225
+ _fallback_state: RuntimeAppState = RuntimeAppState()
226
+
227
+
228
+ def set_fallback_state(state: RuntimeAppState) -> None:
229
+ """把兜底 state 指向某个 app 的 state(兼容壳用)。"""
230
+ global _fallback_state
231
+ _fallback_state = state
232
+ set_fallback_sandbox_registry(state.sandbox_registry)
233
+
234
+
235
+ def get_state() -> RuntimeAppState:
236
+ """取当前请求对应的 app state;非请求上下文退回兜底 state。"""
237
+ state = _current_state.get()
238
+ return state if state is not None else _fallback_state
239
+
240
+
241
+ def get_runtime_execution() -> tuple[RuntimeExecutor, RuntimeLaunchContext]:
242
+ """Resolve the current app's canonical runtime execution dependencies."""
243
+
244
+ from fastapi import HTTPException
245
+
246
+ state = get_state()
247
+ if state.executor is None or state.launch_context is None:
248
+ raise HTTPException(status_code=500, detail="RuntimeExecutor 未初始化")
249
+ return state.executor, state.launch_context
250
+
251
+
252
+ @contextmanager
253
+ def bind_runtime_state(state: RuntimeAppState) -> Iterator[None]:
254
+ """Bind one app state for non-HTTP scopes such as WebSockets."""
255
+ token = _current_state.set(state)
256
+ try:
257
+ with bind_sandbox_registry(state.sandbox_registry):
258
+ yield
259
+ finally:
260
+ _current_state.reset(token)
261
+
262
+
263
+ # ---------------------------------------------------------------------------
264
+ # factory
265
+ # ---------------------------------------------------------------------------
266
+
267
+ # configure 回调签名:由 app.py 提供,负责把各 domain router 挂到 app 上。
268
+ ConfigureApp = Callable[[FastAPI, RuntimeAppState, set[str]], None]
269
+
270
+
271
+ async def shutdown_runtime_resources(state: RuntimeAppState) -> None:
272
+ """Close only resources owned by one runtime app."""
273
+ manager = state.terminal_manager
274
+ if manager is not None:
275
+ try:
276
+ await manager.close()
277
+ except Exception:
278
+ logger.exception("failed to close terminal sessions on shutdown")
279
+
280
+ registry = state.stream_registry
281
+ pending_streams = list(registry.streams)
282
+ for task in pending_streams:
283
+ task.cancel()
284
+ if pending_streams:
285
+ await asyncio.gather(*pending_streams, return_exceptions=True)
286
+ registry.clear()
287
+
288
+ if state.executor is not None:
289
+ try:
290
+ await state.executor.close_all()
291
+ except Exception:
292
+ logger.exception("failed to close runtime adapters on shutdown")
293
+
294
+ for service in state.session_services():
295
+ close = getattr(service, "aclose", None)
296
+ if callable(close):
297
+ try:
298
+ await close()
299
+ except Exception:
300
+ logger.exception("failed to close app session service on shutdown")
301
+
302
+ try:
303
+ state.sandbox_registry.close()
304
+ except Exception:
305
+ logger.exception("failed to clear sandbox registry on shutdown")
306
+
307
+
308
+ def _is_agent_execution_path(path: str, method: str) -> bool:
309
+ """是否 agent 执行类请求(需要 root span 兜底,让 tool 内 outbound 挂到该 trace)。
310
+
311
+ session 管理(GetAgentUiBootstrap/ListSessionMessages 等轮询)与 UI/health 不建 span。
312
+ """
313
+ m = (method or "").upper()
314
+ p = (path or "").strip()
315
+ if m == "POST" and p in {
316
+ "/v1/responses",
317
+ "/v1/chat/completions",
318
+ "/run",
319
+ "/run_sse",
320
+ "/agentengine/api/v1/RunAgent",
321
+ }:
322
+ return True
323
+ if m == "GET" and p in {"/agentengine/api/v1/SubscribeRunEvents"}:
324
+ return True
325
+ return False
326
+
327
+
328
+ def create_runtime_app(
329
+ config: RuntimeAppConfig,
330
+ configure: Optional[ConfigureApp] = None,
331
+ ) -> FastAPI:
332
+ """装配一个 runtime app。
333
+
334
+ 参数:
335
+ config: :class:`RuntimeAppConfig`(executor / launch_context / route_groups)。
336
+ configure: 路由装配回调 ``configure(app, state, route_groups)``;由
337
+ ``ksadk/server/app.py`` 提供,负责按 group 把 domain router include 进 app。
338
+ factory 自身只负责 FastAPI 实例、state、中间件、lifespan、异常处理器,
339
+ 不 import 全局 ``base_app`` 再过滤复制路由(H2 禁止)。
340
+ """
341
+ from contextlib import asynccontextmanager
342
+ from typing import AsyncIterator
343
+
344
+ from fastapi.middleware.cors import CORSMiddleware
345
+ from fastapi.responses import Response
346
+
347
+ state = RuntimeAppState(
348
+ executor=config.runtime_executor,
349
+ launch_context=config.launch_context,
350
+ session_service_provider=config.session_service_provider,
351
+ session_backend_provider=config.session_backend_provider,
352
+ )
353
+
354
+ @asynccontextmanager
355
+ async def _lifespan(app: FastAPI) -> AsyncIterator[None]:
356
+ try:
357
+ if state.a2a_bootstrap is not None:
358
+ await state.a2a_bootstrap.start()
359
+ yield
360
+ finally:
361
+ if state.a2a_bootstrap is not None:
362
+ await state.a2a_bootstrap.stop()
363
+ await shutdown_runtime_resources(state)
364
+
365
+ app = FastAPI(
366
+ title="ADK Core API",
367
+ description="Agent Development Kit HTTP API",
368
+ version="1.0.0",
369
+ lifespan=_lifespan,
370
+ )
371
+ state.app = app
372
+ app.state.runtime = state
373
+
374
+ # 中间件:把当前 app 的 state 写入请求级 contextvar(handler 经 get_state() 取)。
375
+ @app.middleware("http")
376
+ async def _runtime_state_bridge(request, call_next):
377
+ from ksadk.server.routes.dependencies import bind_session_service
378
+
379
+ with (
380
+ bind_runtime_state(state),
381
+ bind_session_service(
382
+ state.resolve_session_service(),
383
+ backend=state.describe_session_backend(),
384
+ ),
385
+ ):
386
+ # 提取 inbound OTel trace context(traceparent);无有效 inbound 时建一个
387
+ # 覆盖整个请求的 root server span,让 langchain/openinference 的 agent span 与
388
+ # tool 内 outbound(A2A)调用都挂到这条 trace 上(openinference 只在 LLM 调用
389
+ # 期间建 span,tool 执行时其 span 已 detach,需一个贯穿 span 兜底)。
390
+ # 只对 agent 执行类路径建 root span;session/UI 管理路径(GetAgentUiBootstrap/
391
+ # ListSessionMessages 等轮询)不建,避免一次问答产生一堆独立 trace。
392
+ try:
393
+ from opentelemetry import context as _otel_ctx
394
+ from opentelemetry import propagate
395
+ from opentelemetry import trace as _otel_trace
396
+
397
+ _carrier = dict(request.headers)
398
+ _parent = propagate.extract(_carrier)
399
+ _parent_span_ctx = _otel_trace.get_current_span(_parent).get_span_context()
400
+ except Exception:
401
+ logger.exception("failed to initialize request tracing; continuing without OTel")
402
+ response = await call_next(request)
403
+ else:
404
+ if _parent_span_ctx.is_valid:
405
+ try:
406
+ _token = _otel_ctx.attach(_parent)
407
+ except Exception:
408
+ logger.exception(
409
+ "failed to attach inbound trace context; continuing without OTel"
410
+ )
411
+ response = await call_next(request)
412
+ else:
413
+ try:
414
+ response = await call_next(request)
415
+ finally:
416
+ try:
417
+ _otel_ctx.detach(_token)
418
+ except Exception:
419
+ logger.exception("failed to detach inbound trace context")
420
+ elif _is_agent_execution_path(request.url.path, request.method):
421
+ try:
422
+ _tracer = _otel_trace.get_tracer("ksadk.server")
423
+ _span_scope = _tracer.start_as_current_span(
424
+ f"{request.method} {request.url.path}"
425
+ )
426
+ _span_scope.__enter__()
427
+ except Exception:
428
+ logger.exception(
429
+ "failed to start request span; continuing without OTel"
430
+ )
431
+ response = await call_next(request)
432
+ else:
433
+ try:
434
+ response = await call_next(request)
435
+ except BaseException as exc:
436
+ try:
437
+ _span_scope.__exit__(type(exc), exc, exc.__traceback__)
438
+ except Exception:
439
+ logger.exception("failed to close request span after handler error")
440
+ raise
441
+ else:
442
+ try:
443
+ _span_scope.__exit__(None, None, None)
444
+ except Exception:
445
+ logger.exception("failed to close request span")
446
+ else:
447
+ response = await call_next(request)
448
+ path = request.url.path
449
+ if path == "/" or path.endswith(".html"):
450
+ response.headers["Cache-Control"] = "no-cache, no-store, must-revalidate"
451
+ response.headers["Pragma"] = "no-cache"
452
+ response.headers["Expires"] = "0"
453
+ return response
454
+
455
+ # CORS(与旧 app 一致,默认对 ADK 工具放开)。
456
+ app.add_middleware(
457
+ CORSMiddleware,
458
+ allow_origins=["*"],
459
+ allow_credentials=True,
460
+ allow_methods=["*"],
461
+ allow_headers=["*"],
462
+ )
463
+
464
+ # 异常处理器(与旧 app 一致)。
465
+ import json as _json
466
+
467
+ from ksadk.sessions.errors import SessionBackendUnavailable
468
+
469
+ @app.exception_handler(SessionBackendUnavailable)
470
+ async def session_backend_unavailable_handler(_request, exc: SessionBackendUnavailable):
471
+ return Response(
472
+ content=_json.dumps(
473
+ {"detail": {"code": "session_backend_unavailable", "message": str(exc)}},
474
+ ensure_ascii=False,
475
+ ),
476
+ status_code=503,
477
+ media_type="application/json",
478
+ )
479
+
480
+ # A2A 端点须在 configure 之前装配:health_meta 含 GET catch-all ``/{requested_path:path}``,
481
+ # 若 A2A 后挂,A2A 的 GET 路由(agent-card / tasks/{id})会被 catch-all 遮蔽成 404。
482
+ _wire_a2a_if_enabled(app, state, config)
483
+ _wire_agui_if_enabled(app, state, config)
484
+
485
+ if configure is not None:
486
+ configure(app, state, set(config.route_groups))
487
+
488
+ return app
489
+
490
+
491
+ def _wire_a2a_if_enabled(app: FastAPI, state: RuntimeAppState, config: RuntimeAppConfig) -> None:
492
+ """Mount A2A with an explicitly injected RuntimeAdapter.
493
+
494
+ The server composition root never resolves or wraps a Runner. Framework
495
+ internals may still use one behind their adapter factory, but A2A only sees
496
+ the frozen RuntimeAdapter contract.
497
+ """
498
+ a2a_cfg = config.a2a
499
+ if a2a_cfg is None:
500
+ return
501
+ from ksadk.managed_a2a_card import ManagedA2ACardMount
502
+
503
+ if isinstance(a2a_cfg, ManagedA2ACardMount):
504
+ a2a_cfg.mount(app)
505
+ state.a2a_bootstrap = a2a_cfg
506
+ logger.info(
507
+ "managed A2A discovery card mounted(agent_name=%s base_url=%s)",
508
+ a2a_cfg.config.agent_name,
509
+ a2a_cfg.config.base_url,
510
+ )
511
+ return
512
+ from ksadk.a2a.bootstrap import AgentEngineA2ABootstrap
513
+
514
+ adapter = config.a2a_runtime_adapter
515
+ if adapter is None:
516
+ raise ValueError("A2A requires an explicitly injected RuntimeAdapter")
517
+ runtime_type = adapter.runtime.runtime_type or config.runtime_type
518
+
519
+ if isinstance(a2a_cfg, AgentEngineA2ABootstrap):
520
+ server = a2a_cfg.mount(
521
+ app,
522
+ runtime_adapter=adapter,
523
+ runtime_type=runtime_type,
524
+ )
525
+ state.a2a_bootstrap = a2a_cfg
526
+ state.a2a_server = server
527
+ logger.info(
528
+ "managed A2A Runtime mounted(agent=%s inbound_enabled=%s)",
529
+ a2a_cfg.runtime_metadata.agent_id,
530
+ a2a_cfg.inbound_enabled,
531
+ )
532
+ return
533
+ if not getattr(a2a_cfg, "enabled", False):
534
+ return
535
+ from ksadk.a2a.routes import add_a2a_protocol_routes
536
+ from ksadk.a2a.task_adapter import A2ARuntimeTaskAdapter
537
+
538
+ task_adapter = A2ARuntimeTaskAdapter(adapter, runtime_type=runtime_type)
539
+ server = add_a2a_protocol_routes(app, a2a_cfg, task_adapter=task_adapter)
540
+ state.a2a_server = server
541
+ logger.info("A2A 协议端点已装配进 runtime app(agent=%s)", a2a_cfg.agent_name)
542
+
543
+
544
+ def _wire_agui_if_enabled(app: FastAPI, state: RuntimeAppState, config: RuntimeAppConfig) -> None:
545
+ """Mount the optional official AG-UI endpoint before the static catch-all."""
546
+ agui_cfg = config.agui
547
+ if (
548
+ agui_cfg is None
549
+ or not getattr(agui_cfg, "enabled", False)
550
+ or "agui" not in config.route_groups
551
+ ):
552
+ return
553
+
554
+ from ksadk.agui.config import require_agui_dependencies
555
+
556
+ require_agui_dependencies()
557
+
558
+ from ksadk.agui.routes import add_ksadk_agui_endpoint
559
+ from ksadk.events.store import RuntimeEventStore
560
+ from ksadk.server.routes import dependencies as route_dependencies
561
+
562
+ if state.executor is None or state.launch_context is None:
563
+ raise ValueError("AG-UI requires RuntimeExecutor and RuntimeLaunchContext")
564
+
565
+ class _AutoSessionRuntimeEventStore:
566
+ """Create a session on first AG-UI event when HttpAgent starts fresh."""
567
+
568
+ def __init__(self, service: Any) -> None:
569
+ self._service = service
570
+ self._store = RuntimeEventStore(service)
571
+
572
+ async def append_one(self, event: Any) -> Any:
573
+ existing = await self._service.get_session(event.session_id)
574
+ if existing is None:
575
+ await self._service.create_session(
576
+ event.agent_id,
577
+ event.user_id,
578
+ event.session_id,
579
+ )
580
+ return await self._store.append_one(event)
581
+
582
+ async def reserve_once(self, event: Any) -> Any:
583
+ existing = await self._service.get_session(event.session_id)
584
+ if existing is None:
585
+ await self._service.create_session(
586
+ event.agent_id,
587
+ event.user_id,
588
+ event.session_id,
589
+ )
590
+ return await self._store.reserve_once(event)
591
+
592
+ async def list(self, session_id: str, **kwargs: Any) -> Any:
593
+ return await self._store.list(session_id, **kwargs)
594
+
595
+ agent = add_ksadk_agui_endpoint(
596
+ app,
597
+ state.executor,
598
+ state.launch_context,
599
+ agui_cfg,
600
+ event_store_factory=lambda: _AutoSessionRuntimeEventStore(
601
+ route_dependencies.resolve_session_service()
602
+ ),
603
+ session_service_factory=route_dependencies.resolve_session_service,
604
+ )
605
+ state.agui_agent = agent
606
+ state.agui_config = agui_cfg
607
+ logger.info("AG-UI endpoint mounted at %s", agui_cfg.path)
608
+
609
+
610
+ __all__ = [
611
+ "ALL_GROUPS",
612
+ "CONTROL_PLANE_GROUPS",
613
+ "DATA_PLANE_GROUPS",
614
+ "RuntimeAppConfig",
615
+ "RuntimeAppState",
616
+ "bind_runtime_state",
617
+ "StreamRegistry",
618
+ "create_runtime_app",
619
+ "get_runtime_execution",
620
+ "get_state",
621
+ "set_fallback_state",
622
+ ]
@@ -0,0 +1 @@
1
+ """Domain routers used by the runtime app composition root."""