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,251 @@
1
+ """RuntimeAdapter 的统一生命周期路由与 Handle 所有权。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ from contextlib import suppress
6
+ from dataclasses import dataclass
7
+
8
+ from ksadk.runtime.adapter import (
9
+ CancelResult,
10
+ CheckpointDescriptor,
11
+ PauseResult,
12
+ ResumePayload,
13
+ ResumeTarget,
14
+ RunHandle,
15
+ RuntimeAdapter,
16
+ RuntimeRegistry,
17
+ StartRequest,
18
+ )
19
+ from ksadk.runtime.launch import RuntimeLaunchContext
20
+
21
+ _HandleKey = tuple[str, str, str]
22
+
23
+
24
+ @dataclass
25
+ class _OwnedRun:
26
+ adapter: RuntimeAdapter
27
+ handle: RunHandle
28
+
29
+
30
+ @dataclass
31
+ class RuntimeStartPreparation:
32
+ """One adapter instance preflighted for exactly one subsequent start."""
33
+
34
+ context: RuntimeLaunchContext
35
+ adapter: RuntimeAdapter
36
+ consumed: bool = False
37
+
38
+
39
+ class RuntimeExecutor:
40
+ """让每个 Handle 始终回到创建或恢复它的 Adapter 实例。"""
41
+
42
+ def __init__(self, registry: RuntimeRegistry) -> None:
43
+ self._registry = registry
44
+ self._runs: dict[_HandleKey, _OwnedRun] = {}
45
+
46
+ async def prepare_start(self, context: RuntimeLaunchContext) -> RuntimeStartPreparation:
47
+ """Preflight a fresh adapter and retain it for the matching ``start``.
48
+
49
+ A response streaming endpoint must learn about lazy import/configuration
50
+ failures before its SSE headers are committed. Retaining the instance
51
+ matters: creating a second adapter after preflight could execute user
52
+ agent initialization twice.
53
+ """
54
+
55
+ adapter = self._registry.create(context)
56
+ await adapter.preflight()
57
+ return RuntimeStartPreparation(context=context, adapter=adapter)
58
+
59
+ async def start(
60
+ self,
61
+ context: RuntimeLaunchContext,
62
+ request: StartRequest,
63
+ *,
64
+ preparation: RuntimeStartPreparation | None = None,
65
+ ) -> RunHandle:
66
+ adapter = self._take_prepared_adapter(context, preparation)
67
+ handle = await adapter.start(request)
68
+ expected_type = _normalize_runtime_type(context.runtime_type)
69
+ if _normalize_runtime_type(handle.runtime_type) != expected_type:
70
+ with suppress(Exception):
71
+ await adapter.close(handle)
72
+ raise ValueError(
73
+ "adapter returned a handle with the wrong runtime type: "
74
+ f"expected {expected_type!r}, got {handle.runtime_type!r}"
75
+ )
76
+ if handle.session_id != request.session_id:
77
+ with suppress(Exception):
78
+ await adapter.close(handle)
79
+ raise ValueError(
80
+ "adapter returned a handle for the wrong session: "
81
+ f"expected {request.session_id!r}, got {handle.session_id!r}"
82
+ )
83
+ if _handle_key(handle) in self._runs:
84
+ with suppress(Exception):
85
+ await adapter.close(handle)
86
+ raise RuntimeError(f"runtime handle is already attached: {_handle_key(handle)!r}")
87
+ self._record_owner(adapter, handle)
88
+ return handle
89
+
90
+ def stream(self, handle: RunHandle):
91
+ owned = self._resolve(handle)
92
+ return owned.adapter.stream(owned.handle)
93
+
94
+ async def cancel(self, handle: RunHandle) -> CancelResult:
95
+ owned = self._resolve(handle)
96
+ return await owned.adapter.cancel(owned.handle)
97
+
98
+ async def pause(self, handle: RunHandle) -> PauseResult:
99
+ owned = self._resolve(handle)
100
+ return await owned.adapter.pause(owned.handle)
101
+
102
+ async def submit(self, handle: RunHandle, payload: ResumePayload) -> None:
103
+ owned = self._resolve(handle)
104
+ await owned.adapter.submit(owned.handle, payload)
105
+
106
+ async def resume(
107
+ self,
108
+ handle: RunHandle,
109
+ target: ResumeTarget,
110
+ payload: ResumePayload | None,
111
+ ) -> RunHandle:
112
+ old_key = _handle_key(handle)
113
+ owned = self._resolve(handle)
114
+ resumed = await owned.adapter.resume(owned.handle, target, payload)
115
+ if _normalize_runtime_type(resumed.runtime_type) != old_key[0]:
116
+ raise ValueError("resumed handle changed runtime type")
117
+ if resumed.session_id != old_key[2]:
118
+ raise ValueError("resumed handle changed session")
119
+
120
+ new_key = _handle_key(resumed)
121
+ if new_key != old_key:
122
+ existing = self._runs.get(new_key)
123
+ if existing is not None and existing.adapter is not owned.adapter:
124
+ raise RuntimeError(f"runtime handle is already attached: {new_key!r}")
125
+ self._runs.pop(old_key, None)
126
+ self._runs[new_key] = _OwnedRun(adapter=owned.adapter, handle=resumed)
127
+ return resumed
128
+
129
+ async def checkpoint(self, handle: RunHandle) -> CheckpointDescriptor:
130
+ owned = self._resolve(handle)
131
+ return await owned.adapter.checkpoint(owned.handle)
132
+
133
+ async def close(self, handle: RunHandle) -> None:
134
+ key = _handle_key(handle)
135
+ owned = self._resolve(handle)
136
+ try:
137
+ await owned.adapter.close(owned.handle)
138
+ finally:
139
+ self._runs.pop(key, None)
140
+
141
+ async def close_all(self) -> None:
142
+ """Release every attached adapter while preserving best-effort cleanup."""
143
+
144
+ first_error: BaseException | None = None
145
+ for key, owned in list(self._runs.items()):
146
+ try:
147
+ await owned.adapter.close(owned.handle)
148
+ except BaseException as exc: # cleanup must continue for the other runtimes
149
+ if first_error is None:
150
+ first_error = exc
151
+ finally:
152
+ self._runs.pop(key, None)
153
+ if first_error is not None:
154
+ raise first_error
155
+
156
+ async def attach(
157
+ self,
158
+ context: RuntimeLaunchContext,
159
+ handle: RunHandle,
160
+ ) -> RunHandle:
161
+ expected_type = _normalize_runtime_type(context.runtime_type)
162
+ if _normalize_runtime_type(handle.runtime_type) != expected_type:
163
+ raise ValueError("launch context and persisted handle runtime type differ")
164
+ if self.is_attached(handle):
165
+ return handle
166
+
167
+ adapter = self._registry.create(context)
168
+ restored = await adapter.attach(handle)
169
+ if restored != handle:
170
+ with suppress(Exception):
171
+ await adapter.close(restored)
172
+ raise ValueError("adapter attach must preserve persisted handle identity")
173
+ self._record_owner(adapter, restored)
174
+ return restored
175
+
176
+ def is_attached(self, handle: RunHandle) -> bool:
177
+ owned = self._runs.get(_handle_key(handle))
178
+ return owned is not None and owned.handle == handle
179
+
180
+ def find_handle(
181
+ self,
182
+ runtime_type: str,
183
+ run_id: str,
184
+ session_id: str,
185
+ ) -> RunHandle | None:
186
+ """Return the attached handle for one exact runtime/run/session scope."""
187
+
188
+ owned = self._runs.get(
189
+ (
190
+ _normalize_runtime_type(runtime_type),
191
+ str(run_id),
192
+ str(session_id),
193
+ )
194
+ )
195
+ return owned.handle if owned is not None else None
196
+
197
+ def native_capabilities(self, context: RuntimeLaunchContext) -> dict[str, object]:
198
+ """Read the capability declaration from the registered Runtime implementation."""
199
+
200
+ adapter = self._registry.create(context)
201
+ return dict(adapter.runtime.native_capabilities())
202
+
203
+ def registered_runtime_types(self) -> list[str]:
204
+ """Expose Registry membership without leaking or duplicating the Registry."""
205
+
206
+ return self._registry.registered_types()
207
+
208
+ def _resolve(self, handle: RunHandle) -> _OwnedRun:
209
+ key = _handle_key(handle)
210
+ try:
211
+ owned = self._runs[key]
212
+ except KeyError:
213
+ raise KeyError(f"runtime handle is not attached: {key!r}") from None
214
+ if owned.handle != handle:
215
+ raise ValueError(f"runtime handle payload does not match owner: {key!r}")
216
+ return owned
217
+
218
+ def _record_owner(self, adapter: RuntimeAdapter, handle: RunHandle) -> None:
219
+ key = _handle_key(handle)
220
+ if key in self._runs:
221
+ raise RuntimeError(f"runtime handle is already attached: {key!r}")
222
+ self._runs[key] = _OwnedRun(adapter=adapter, handle=handle)
223
+
224
+ def _take_prepared_adapter(
225
+ self,
226
+ context: RuntimeLaunchContext,
227
+ preparation: RuntimeStartPreparation | None,
228
+ ) -> RuntimeAdapter:
229
+ if preparation is None:
230
+ return self._registry.create(context)
231
+ if preparation.consumed:
232
+ raise RuntimeError("runtime start preparation was already consumed")
233
+ if preparation.context != context:
234
+ raise ValueError("runtime start preparation does not match launch context")
235
+ preparation.consumed = True
236
+ return preparation.adapter
237
+
238
+
239
+ def _normalize_runtime_type(runtime_type: str) -> str:
240
+ return runtime_type.strip().lower()
241
+
242
+
243
+ def _handle_key(handle: RunHandle) -> _HandleKey:
244
+ return (
245
+ _normalize_runtime_type(handle.runtime_type),
246
+ handle.run_id,
247
+ handle.session_id,
248
+ )
249
+
250
+
251
+ __all__ = ["RuntimeExecutor", "RuntimeStartPreparation"]
@@ -0,0 +1,156 @@
1
+ """内置 RuntimeAdapter 的唯一默认 Factory Registry。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ import dataclasses
6
+ import os
7
+ from pathlib import Path
8
+ from typing import Any
9
+
10
+ from ksadk.codex.client import AsyncCodexClient
11
+ from ksadk.codex.runtime import CodexRuntimeAdapter
12
+ from ksadk.runners.base_runner import BaseRunner
13
+ from ksadk.runtime.adapter import RuntimeAdapter, RuntimeRegistry
14
+ from ksadk.runtime.framework_adapters import ADKRuntimeAdapter, LangGraphRuntimeAdapter
15
+ from ksadk.runtime.launch import RuntimeLaunchContext
16
+
17
+
18
+ def _create_codex(context: RuntimeLaunchContext) -> RuntimeAdapter:
19
+ client_factory = context.services.codex_client_factory or AsyncCodexClient
20
+ overrides = list(context.config.get("codex_overrides") or [])
21
+ # Studio's default collaboration mode must expose Codex's structured
22
+ # request_user_input tool; the upstream feature is intentionally off by
23
+ # default outside Plan mode. This stays process-local to the isolated
24
+ # runtime and does not mutate the user's global Codex configuration.
25
+ interaction_override = "features.default_mode_request_user_input=true"
26
+ if interaction_override not in overrides:
27
+ overrides.append(interaction_override)
28
+ try:
29
+ from openai_codex import CodexConfig
30
+
31
+ base_cfg = CodexConfig()
32
+ if overrides:
33
+ base_cfg = dataclasses.replace(
34
+ base_cfg,
35
+ config_overrides=tuple(getattr(base_cfg, "config_overrides", ()) or ())
36
+ + tuple(str(o) for o in overrides),
37
+ )
38
+ env = dict(getattr(base_cfg, "env", None) or {})
39
+ isolated_home = _isolated_codex_home(context.project_dir)
40
+ env.setdefault("CODEX_HOME", str(isolated_home))
41
+ # HOME 级隔离:codex app-server 还会按约定扫 ~/.agents/skills、
42
+ # ~/.claude/skills 等宿主目录,仅设 CODEX_HOME 挡不住。隔离 HOME 后这些
43
+ # 路径全部落在工作区内,宿主 skills/MCP/凭证不再进入 Agent 上下文。
44
+ # 设 KSADK_CODEX_ISOLATE_HOME=0 可关闭(调试用)。
45
+ if os.environ.get("KSADK_CODEX_ISOLATE_HOME", "1") != "0":
46
+ env.setdefault("HOME", str(isolated_home))
47
+ # 运行期解析出的凭证值(如 MCP bearer_token_env_var 所需)注入子进程环境
48
+ env.update({str(k): str(v) for k, v in (context.config.get("env") or {}).items()})
49
+ base_cfg = dataclasses.replace(base_cfg, env=env)
50
+ try:
51
+ client: Any = client_factory(config=base_cfg)
52
+ except TypeError:
53
+ # 自定义/测试工厂可能不接受 config 参数:退化为无参构造,
54
+ # config_overrides 事后注入(自定义工厂自行承担 env 隔离)。
55
+ client = client_factory()
56
+ if overrides:
57
+ _apply_codex_overrides(client, overrides)
58
+ except ImportError:
59
+ client: Any = client_factory()
60
+ if overrides:
61
+ _apply_codex_overrides(client, overrides)
62
+ timeout = context.config.get("turn_timeout_seconds")
63
+ return CodexRuntimeAdapter(
64
+ client,
65
+ sandbox_read_only=bool(context.config.get("sandbox_read_only", True)),
66
+ turn_timeout_seconds=float(timeout) if timeout is not None else None,
67
+ )
68
+
69
+
70
+ def _isolated_codex_home(project_dir: Any) -> Path:
71
+ """Studio 运行 Agent 使用工作区级隔离 CODEX_HOME。
72
+
73
+ 避免 codex app-server 继承宿主环境(~/.codex / ~/.wework/codex)里的
74
+ skills、MCP 配置、插件与凭证,污染 Agent 上下文甚至泄漏宿主能力。
75
+ 可用 KSADK_CODEX_HOME 显式覆盖。
76
+ """
77
+ override = os.environ.get("KSADK_CODEX_HOME")
78
+ if override:
79
+ return Path(override).expanduser()
80
+ home = Path(str(project_dir)) / ".agentkit" / "codex-home"
81
+ home.mkdir(parents=True, exist_ok=True)
82
+ return home
83
+
84
+
85
+ def _apply_codex_overrides(client: Any, overrides: Any) -> None:
86
+ """Append MCP server --config overrides to the client's CodexConfig."""
87
+ try:
88
+ from openai_codex import CodexConfig
89
+ except ImportError:
90
+ return
91
+ # ksadk AsyncCodexClient -> AsyncCodex -> inner AsyncCodexClient.config
92
+ inner_codex = getattr(client, "_codex", None)
93
+ inner_client = getattr(inner_codex, "_client", None) or inner_codex
94
+ cfg = getattr(inner_client, "config", None)
95
+ if cfg is None or not isinstance(cfg, CodexConfig):
96
+ return
97
+ base_overrides = tuple(getattr(cfg, "config_overrides", ()) or ())
98
+ new_overrides = tuple(str(o) for o in overrides if o not in base_overrides)
99
+ if not new_overrides:
100
+ return
101
+ new_cfg = dataclasses.replace(cfg, config_overrides=base_overrides + new_overrides)
102
+ setattr(inner_client, "config", new_cfg)
103
+
104
+
105
+ def _create_framework_runner(context: RuntimeLaunchContext, runtime_type: str) -> BaseRunner:
106
+ try:
107
+ from ksadk.runners.patch_langchain import apply_patch
108
+
109
+ apply_patch()
110
+ except ImportError:
111
+ pass
112
+ detection = context.detection
113
+ if detection is None:
114
+ raise ValueError(f"{runtime_type} runtime requires framework detection")
115
+ if context.services.runner_factory is not None:
116
+ runner = context.services.runner_factory(detection, str(context.project_dir))
117
+ else:
118
+ # 复用 runners.factory.create_runner:它优先读 detection.runner_class
119
+ # (agentengine.yaml 的 runner_class 字段),否则按 detection.type 分发到
120
+ # ADKRunner/LangGraphRunner 等。直接硬编码 LangGraphRunner 会绕过自定义
121
+ # runner,导致 root_agent=None 的项目在 preflight 阶段误报"不是有效 CompiledGraph"。
122
+ from ksadk.runners.factory import create_runner
123
+
124
+ runner = create_runner(detection, str(context.project_dir))
125
+ if not isinstance(runner, BaseRunner):
126
+ raise TypeError(
127
+ f"{runtime_type} runner factory must return BaseRunner, got {type(runner).__name__}"
128
+ )
129
+ return runner
130
+
131
+
132
+ def _create_adk(context: RuntimeLaunchContext) -> RuntimeAdapter:
133
+ return ADKRuntimeAdapter(_create_framework_runner(context, "adk"))
134
+
135
+
136
+ def _create_langgraph(context: RuntimeLaunchContext) -> RuntimeAdapter:
137
+ return LangGraphRuntimeAdapter(_create_framework_runner(context, "langgraph"))
138
+
139
+
140
+ def build_default_runtime_registry() -> RuntimeRegistry:
141
+ """注册内置 Codex、ADK 和 LangGraph Runtime Factory。"""
142
+
143
+ registry = RuntimeRegistry()
144
+ registry.register("codex", _create_codex)
145
+ registry.register("adk", _create_adk)
146
+ registry.register("langgraph", _create_langgraph)
147
+ return registry
148
+
149
+
150
+ def create_runtime_adapter(context: RuntimeLaunchContext) -> RuntimeAdapter:
151
+ """通过唯一默认 Registry 创建 RuntimeAdapter。"""
152
+
153
+ return build_default_runtime_registry().create(context)
154
+
155
+
156
+ __all__ = ["build_default_runtime_registry", "create_runtime_adapter"]
@@ -0,0 +1,118 @@
1
+ """ADK / LangGraph 两个框架的 RuntimeAdapter (goal-07)。
2
+
3
+ 在通用 :class:`~ksadk.runtime.runner_adapter.RunnerRuntimeAdapter` 之上,只声明
4
+ 框架差异(resume 目标 + checkpoint 粒度),诚实暴露,不开接口后门:
5
+
6
+ - ADK:**forward-only**,resume 经 ``invocation_id``;不支持 time-travel/fork。
7
+ - LangGraph:**time-travel**,resume 经 ``checkpoint_id``;可按 turn 回滚/fork。
8
+
9
+ 默认注册由 :mod:`ksadk.runtime.factory` 统一负责。
10
+ """
11
+
12
+ from __future__ import annotations
13
+
14
+ from typing import Optional
15
+
16
+ from ksadk.runners.base_runner import BaseRunner
17
+ from ksadk.runtime.adapter import (
18
+ CheckpointCapability,
19
+ ResumePayload,
20
+ ResumeTarget,
21
+ RunHandle,
22
+ )
23
+ from ksadk.runtime.runner_adapter import RunnerRuntimeAdapter
24
+
25
+
26
+ class ADKRuntimeAdapter(RunnerRuntimeAdapter):
27
+ """ADK 框架 adapter(forward-only resume)。"""
28
+
29
+ def __init__(self, runner: BaseRunner) -> None:
30
+ super().__init__(runner, runtime_type="adk")
31
+
32
+ async def _resume_native(
33
+ self,
34
+ handle: RunHandle,
35
+ target: ResumeTarget,
36
+ payload: Optional[ResumePayload],
37
+ ) -> Optional[dict]:
38
+ # ADK forward-only:恢复目标 = invocation_id。注入 adk_runner 真消费的
39
+ # ``checkpoint_resume`` + ``framework_ref.adk.invocation_id`` → run_async(invocation_id)。
40
+ return {
41
+ "checkpoint_resume": True,
42
+ "run_id": target.id,
43
+ "framework_ref": {"adk": {"invocation_id": target.id}},
44
+ "input": payload.data if payload else None,
45
+ }
46
+
47
+ def _checkpoint_capability(self) -> CheckpointCapability:
48
+ capability = super()._checkpoint_capability()
49
+ if not capability.supported:
50
+ return capability
51
+ return capability.model_copy(
52
+ update={
53
+ "granularity": "delta",
54
+ "rollback_scope": "invocation",
55
+ "fork_supported": False,
56
+ }
57
+ )
58
+
59
+
60
+ class LangGraphRuntimeAdapter(RunnerRuntimeAdapter):
61
+ """LangGraph 框架 adapter(time-travel resume)。"""
62
+
63
+ def __init__(self, runner: BaseRunner) -> None:
64
+ super().__init__(runner, runtime_type="langgraph")
65
+
66
+ async def _resume_native(
67
+ self,
68
+ handle: RunHandle,
69
+ target: ResumeTarget,
70
+ payload: Optional[ResumePayload],
71
+ ) -> Optional[dict]:
72
+ if target.kind != "checkpoint_id":
73
+ raise ValueError(f"LangGraph resume requires checkpoint_id target, got {target.kind!r}")
74
+ known_checkpoint_ids = {
75
+ str(checkpoint_id)
76
+ for checkpoint_id in handle.native_ref.get("known_checkpoint_ids", [])
77
+ }
78
+ if target.id not in known_checkpoint_ids:
79
+ raise ValueError(f"checkpoint {target.id!r} does not belong to run {handle.run_id!r}")
80
+ if payload is not None and payload.call_id:
81
+ pending_approval_ids = {
82
+ str(call_id) for call_id in handle.native_ref.get("pending_approval_ids", [])
83
+ }
84
+ if payload.call_id not in pending_approval_ids:
85
+ raise ValueError(f"unknown interrupt {payload.call_id!r}")
86
+ # LangGraph time-travel:恢复目标 = checkpoint_id。注入 langgraph_runner 真消费的
87
+ # ``checkpoint_resume`` + ``framework_ref.langgraph.{checkpoint_id,thread_id}``。
88
+ return {
89
+ "checkpoint_resume": True,
90
+ "run_id": handle.run_id,
91
+ "resume_payload_provided": payload is not None,
92
+ "resume_interrupt_id": payload.call_id if payload else None,
93
+ "framework_ref": {
94
+ "langgraph": {
95
+ "checkpoint_id": target.id,
96
+ "thread_id": str(handle.native_ref.get("thread_id") or handle.session_id),
97
+ }
98
+ },
99
+ "input": payload.data if payload else None,
100
+ }
101
+
102
+ def _checkpoint_capability(self) -> CheckpointCapability:
103
+ capability = super()._checkpoint_capability()
104
+ if not capability.supported:
105
+ return capability
106
+ return capability.model_copy(
107
+ update={
108
+ "granularity": "snapshot",
109
+ "rollback_scope": "turn",
110
+ "fork_supported": True,
111
+ }
112
+ )
113
+
114
+
115
+ __all__ = [
116
+ "ADKRuntimeAdapter",
117
+ "LangGraphRuntimeAdapter",
118
+ ]
@@ -0,0 +1,48 @@
1
+ """RuntimeAdapter Factory 的启动上下文与可注入依赖。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ from collections.abc import Callable, Mapping
6
+ from dataclasses import dataclass, field
7
+ from pathlib import Path
8
+ from types import MappingProxyType
9
+ from typing import Any
10
+
11
+ _RUNTIME_TYPE_ALIASES = {
12
+ # LangChain and DeepAgents are source-framework variants. They share the
13
+ # LangGraph execution/checkpoint contract and must not create new top-level
14
+ # runtime types in the RuntimeAdapter registry.
15
+ "langchain": "langgraph",
16
+ "deepagents": "langgraph",
17
+ }
18
+
19
+
20
+ @dataclass(frozen=True)
21
+ class RuntimeServices:
22
+ """创建 RuntimeAdapter 时可替换的进程级依赖。"""
23
+
24
+ codex_client_factory: Callable[[], Any] | None = None
25
+ runner_factory: Callable[[Any, str], Any] | None = None
26
+
27
+
28
+ @dataclass(frozen=True)
29
+ class RuntimeLaunchContext:
30
+ """一次 RuntimeAdapter 创建所需的框架无关输入。"""
31
+
32
+ runtime_type: str
33
+ project_dir: Path
34
+ detection: Any | None = None
35
+ config: Mapping[str, Any] = field(default_factory=dict)
36
+ services: RuntimeServices = field(default_factory=RuntimeServices)
37
+
38
+ def __post_init__(self) -> None:
39
+ runtime_type = str(self.runtime_type or "").strip().lower()
40
+ canonical_runtime_type = _RUNTIME_TYPE_ALIASES.get(
41
+ runtime_type, runtime_type
42
+ )
43
+ object.__setattr__(self, "runtime_type", canonical_runtime_type)
44
+ object.__setattr__(self, "project_dir", Path(self.project_dir))
45
+ object.__setattr__(self, "config", MappingProxyType(dict(self.config)))
46
+
47
+
48
+ __all__ = ["RuntimeLaunchContext", "RuntimeServices"]