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,352 @@
1
+ """Resolve an immutable Codex build into a canonical StudioRunSpec."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import os
6
+ import zipfile
7
+ from typing import Any, cast
8
+
9
+ import yaml # type: ignore[import-untyped]
10
+
11
+ from ksadk.configs import ModelConfig
12
+ from ksadk.runtime import RuntimeLaunchContext
13
+ from ksadk.studio.codex_builder import CodexBuildRepository
14
+ from ksadk.studio.codex_manifest import CodexAgentManifest, CodexManifestRepository
15
+ from ksadk.studio.contracts import ModelSpec
16
+ from ksadk.studio.errors import StudioError
17
+ from ksadk.studio.run_service import StudioRunSpec
18
+ from ksadk.studio.workspace import Workspace
19
+ from ksadk.tools.gateway import normalize_tool_approval_mode
20
+
21
+
22
+ class CodexRunSpecResolver:
23
+ """Validate a build snapshot without creating another Runtime abstraction."""
24
+
25
+ def __init__(
26
+ self,
27
+ workspace: Workspace,
28
+ *,
29
+ build_repository: CodexBuildRepository | None = None,
30
+ manifest_repository: CodexManifestRepository | None = None,
31
+ credential_resolver: Any = None,
32
+ resource_catalog: Any = None,
33
+ draft_repository: Any = None,
34
+ ) -> None:
35
+ self.workspace = workspace
36
+ self.builds = build_repository or CodexBuildRepository(workspace)
37
+ self.manifests = manifest_repository or CodexManifestRepository(workspace)
38
+ self.credentials = credential_resolver
39
+ self.catalog = resource_catalog
40
+ self.drafts = draft_repository
41
+
42
+ def resolve(
43
+ self,
44
+ build_id: str,
45
+ *,
46
+ model: str | None = None,
47
+ sandbox: str | None = None,
48
+ approval_mode: str | None = None,
49
+ ) -> StudioRunSpec:
50
+ build = self.builds.get(build_id)
51
+ current = self.manifests.load(build.agent_name)
52
+ if build.manifest_sha256 != current.manifest_sha256:
53
+ raise StudioError(
54
+ "CODEX_BUILD_STALE",
55
+ "agentengine.yaml 已修改,请重新构建后再运行",
56
+ status_code=409,
57
+ details={
58
+ "buildManifestSha256": build.manifest_sha256,
59
+ "currentManifestSha256": current.manifest_sha256,
60
+ },
61
+ )
62
+ manifest = self._load_build_manifest(build.artifact_path)
63
+ selected_model = self._select_model(manifest, model)
64
+ project_dir = self.workspace.root.resolve()
65
+ skills = self._skill_inputs(manifest)
66
+ codex_overrides = self._mcp_overrides(manifest)
67
+ approval_profile = normalize_tool_approval_mode(approval_mode) if approval_mode else ""
68
+ sandbox, approval = self._resolve_sandbox(
69
+ manifest,
70
+ override=sandbox,
71
+ approval_mode=approval_profile or None,
72
+ )
73
+ if sandbox == "workspace-write":
74
+ # workspace-write 默认断网;MCP/搜索类工具需要显式放行网络
75
+ codex_overrides = [*codex_overrides, "sandbox_workspace_write.network_access=true"]
76
+ launch_config: dict[str, Any] = {
77
+ "sandbox_read_only": sandbox == "read-only",
78
+ "sandbox": sandbox,
79
+ "approval_mode": approval,
80
+ }
81
+ if codex_overrides:
82
+ launch_config["codex_overrides"] = codex_overrides
83
+ runtime_env = {
84
+ **self._resolve_model_env(build, manifest, selected_model),
85
+ **self._resolve_mcp_env(manifest),
86
+ }
87
+ if runtime_env:
88
+ launch_config["env"] = runtime_env
89
+ request_config: dict[str, Any] = {
90
+ "base_instructions": manifest.prompt,
91
+ "cwd": str(project_dir),
92
+ "skills": skills,
93
+ "sandbox_read_only": sandbox == "read-only",
94
+ "sandbox": sandbox,
95
+ "approval_mode": approval,
96
+ "summary": "auto",
97
+ # Studio sessions resume the same native Codex thread across turns.
98
+ "ephemeral": False,
99
+ }
100
+ if approval_profile:
101
+ request_config["tool_approval_mode"] = approval_profile
102
+ return StudioRunSpec(
103
+ launch_context=RuntimeLaunchContext(
104
+ runtime_type="codex",
105
+ project_dir=project_dir,
106
+ config=launch_config,
107
+ ),
108
+ build_id=build.id,
109
+ agent_id=manifest.name,
110
+ model=selected_model,
111
+ request_config=request_config,
112
+ manifest_sha256=build.manifest_sha256,
113
+ )
114
+
115
+ def _resolve_model_env(
116
+ self,
117
+ build: Any,
118
+ manifest: CodexAgentManifest,
119
+ selected_model: str,
120
+ ) -> dict[str, str]:
121
+ resolver = self.credentials
122
+ if resolver is None:
123
+ from ksadk.studio.model_client import CredentialResolver
124
+
125
+ resolver = CredentialResolver(self.workspace)
126
+ self.credentials = resolver
127
+ profile = self._resolve_model_profile(build, manifest, selected_model)
128
+ credential_ref = profile.credential_ref if profile else "env://OPENAI_API_KEY"
129
+ try:
130
+ credential = resolver.resolve(credential_ref)
131
+ except StudioError:
132
+ return {}
133
+ base_url = (
134
+ self._model_base_url(profile)
135
+ if profile is not None
136
+ else ModelConfig().api_base.rstrip("/")
137
+ )
138
+ return {
139
+ "OPENAI_API_KEY": credential,
140
+ "OPENAI_BASE_URL": base_url,
141
+ "OPENAI_API_BASE": base_url,
142
+ "OPENAI_MODEL_NAME": selected_model,
143
+ }
144
+
145
+ def _resolve_model_profile(
146
+ self,
147
+ build: Any,
148
+ manifest: CodexAgentManifest,
149
+ selected_model: str,
150
+ ) -> ModelSpec | None:
151
+ # New build records own an immutable connection snapshot. An empty
152
+ # mapping explicitly means this build uses the process/workspace
153
+ # default connection; only legacy records may consult live Catalog
154
+ # state for backward compatibility.
155
+ snapshots = getattr(build, "model_profiles", None)
156
+ if snapshots is not None:
157
+ payload = snapshots.get(selected_model)
158
+ return ModelSpec.model_validate(payload) if payload is not None else None
159
+
160
+ if self.catalog is None:
161
+ from ksadk.studio.resource_catalog import LocalResourceCatalog
162
+
163
+ self.catalog = LocalResourceCatalog(self.workspace)
164
+ if self.drafts is None:
165
+ from ksadk.studio.codex_agent_service import CodexDraftRepository
166
+
167
+ self.drafts = CodexDraftRepository(self.workspace)
168
+
169
+ draft = self.drafts.get(manifest.name)
170
+ if draft is not None:
171
+ bindings = draft.spec.bindings
172
+ resource_ids = list(bindings.model_profile_ids)
173
+ if not resource_ids and bindings.model_profile_id:
174
+ resource_ids = [bindings.model_profile_id]
175
+ for resource_id in resource_ids:
176
+ try:
177
+ descriptor = self.catalog.get(resource_id)
178
+ profile = ModelSpec.model_validate(descriptor.contract)
179
+ except (StudioError, ValueError):
180
+ continue
181
+ if profile.model == selected_model:
182
+ return profile
183
+
184
+ matches: list[ModelSpec] = []
185
+ for descriptor in self.catalog.list(kind="model", limit=500):
186
+ try:
187
+ profile = ModelSpec.model_validate(descriptor.contract)
188
+ except ValueError:
189
+ continue
190
+ if profile.model == selected_model:
191
+ matches.append(profile)
192
+ return matches[0] if len(matches) == 1 else None
193
+
194
+ @staticmethod
195
+ def _model_base_url(profile: ModelSpec) -> str:
196
+ raw = str(profile.base_url or profile.endpoint_url or "").rstrip("/")
197
+ for suffix in ("/chat/completions", "/responses"):
198
+ if raw.endswith(suffix):
199
+ return raw[: -len(suffix)]
200
+ return raw
201
+
202
+ @staticmethod
203
+ def _mcp_overrides(manifest: CodexAgentManifest) -> list[str]:
204
+ """Translate bound MCP servers into codex --config overrides."""
205
+ overrides: list[str] = []
206
+ for server in manifest.mcp_servers or []:
207
+ name = str(server.get("name") or "").strip()
208
+ url = str(server.get("url") or "").strip()
209
+ if not name or not url:
210
+ continue
211
+ overrides.append(f"mcp_servers.{name}.url={url}")
212
+ env_key = str(server.get("env_key") or "").strip()
213
+ if env_key:
214
+ overrides.append(f"mcp_servers.{name}.bearer_token_env_var={env_key}")
215
+ return overrides
216
+
217
+ def _resolve_mcp_env(self, manifest: CodexAgentManifest) -> dict[str, str]:
218
+ """把 manifest 中 MCP 的 env_key 解析为真实值,注入 codex 子进程环境。
219
+
220
+ codex app-server 的 bearer_token_env_var 直接读子进程环境变量,不经过
221
+ Studio 的凭证解析链(session → 工作区 secrets.env → 环境变量),必须在
222
+ 启动前完成解析。缺凭证时快速失败并指出具体引用。
223
+ """
224
+ env: dict[str, str] = {}
225
+ for server in manifest.mcp_servers or []:
226
+ env_key = str(server.get("env_key") or "").strip()
227
+ if not env_key:
228
+ continue
229
+ if env_key in env:
230
+ continue
231
+ resolver = self.credentials
232
+ if resolver is None:
233
+ from ksadk.studio.model_client import CredentialResolver
234
+
235
+ resolver = CredentialResolver(self.workspace)
236
+ self.credentials = resolver
237
+ try:
238
+ env[env_key] = resolver.resolve(f"env://{env_key}")
239
+ except Exception as exc:
240
+ raise StudioError(
241
+ "MCP_CREDENTIAL_MISSING",
242
+ f"MCP Server「{server.get('name')}」需要凭证 {env_key},"
243
+ "请先在 MCP 页连接时保存该环境变量的值",
244
+ status_code=422,
245
+ details={
246
+ "server": str(server.get("name") or ""),
247
+ "reference": f"env://{env_key}",
248
+ },
249
+ ) from exc
250
+ return env
251
+
252
+ @staticmethod
253
+ def _resolve_sandbox(
254
+ manifest: CodexAgentManifest,
255
+ override: str | None = None,
256
+ approval_mode: str | None = None,
257
+ ) -> tuple[str, str]:
258
+ """Resolve (sandbox, approval_mode): per-run override > manifest > env > default.
259
+
260
+ UI 4 档: read_only / workspace_write / workspace_write_auto / full_access
261
+ """
262
+ presets = {
263
+ "read_only": ("read-only", "deny_all"),
264
+ "read-only": ("read-only", "deny_all"),
265
+ "workspace_write": ("workspace-write", "deny_all"),
266
+ "workspace-write": ("workspace-write", "deny_all"),
267
+ "workspace_write_auto": ("workspace-write", "auto_review"),
268
+ "workspace-write-auto": ("workspace-write", "auto_review"),
269
+ "full_access": ("full-access", "deny_all"),
270
+ "full-access": ("full-access", "deny_all"),
271
+ }
272
+ approval_presets = {
273
+ "ask": ("workspace-write", "manual"),
274
+ "risk": ("workspace-write", "auto_review"),
275
+ "full": ("full-access", "deny_all"),
276
+ }
277
+ if approval_mode:
278
+ return approval_presets[normalize_tool_approval_mode(approval_mode)]
279
+ raw = (
280
+ (override or os.environ.get("KSADK_CODEX_SANDBOX") or manifest.sandbox or "read_only")
281
+ .strip()
282
+ .lower()
283
+ )
284
+ return presets.get(raw, ("read-only", "deny_all"))
285
+
286
+ def _skill_inputs(self, manifest: CodexAgentManifest) -> list[dict[str, str]]:
287
+ """Resolve bound skill resource ids to codex SkillInput wire dicts."""
288
+ if not manifest.skills:
289
+ return []
290
+ skills_root = self.workspace.resolve("capabilities/skills")
291
+ inputs: list[dict[str, str]] = []
292
+ for sid in manifest.skills:
293
+ name = self._skill_name_from_id(sid)
294
+ if not name:
295
+ continue
296
+ skill_dir = skills_root / name
297
+ if not skill_dir.is_dir():
298
+ continue
299
+ inputs.append({"name": name, "path": str(skill_dir.resolve())})
300
+ return inputs
301
+
302
+ @staticmethod
303
+ def _skill_name_from_id(resource_id: str) -> str:
304
+ parts = str(resource_id).split(":")
305
+ if len(parts) >= 4 and parts[0] == "skill":
306
+ return parts[2]
307
+ if len(parts) == 2:
308
+ return parts[1]
309
+ return ""
310
+
311
+ @staticmethod
312
+ def _select_model(manifest: CodexAgentManifest, requested: str | None) -> str:
313
+ selected = str(requested or manifest.model).strip()
314
+ if selected not in manifest.allowed_models:
315
+ raise StudioError(
316
+ "MODEL_NOT_BOUND",
317
+ "请求模型未绑定到当前 Agent Build",
318
+ status_code=422,
319
+ details={
320
+ "model": selected,
321
+ "allowedModels": list(manifest.allowed_models),
322
+ },
323
+ )
324
+ environment_allowlist = {
325
+ item.strip()
326
+ for item in os.environ.get("AGENTENGINE_MODEL_ALLOWLIST", "").split(",")
327
+ if item.strip()
328
+ }
329
+ if environment_allowlist and selected not in environment_allowlist:
330
+ raise StudioError(
331
+ "MODEL_NOT_AVAILABLE",
332
+ "请求模型不在当前运行环境的模型白名单中",
333
+ status_code=422,
334
+ details={"model": selected},
335
+ )
336
+ return selected
337
+
338
+ def _load_build_manifest(self, artifact_path: str) -> CodexAgentManifest:
339
+ archive_path = self.workspace.resolve(artifact_path, must_exist=True)
340
+ try:
341
+ with zipfile.ZipFile(archive_path) as archive:
342
+ payload = yaml.safe_load(archive.read("agentengine.yaml"))
343
+ return cast(CodexAgentManifest, CodexAgentManifest.model_validate(payload))
344
+ except (OSError, KeyError, ValueError, zipfile.BadZipFile) as exc:
345
+ raise StudioError(
346
+ "CODEX_BUILD_INVALID",
347
+ "Codex Build 缺少有效的 agentengine.yaml",
348
+ status_code=500,
349
+ ) from exc
350
+
351
+
352
+ __all__ = ["CodexRunSpecResolver"]
@@ -0,0 +1,189 @@
1
+ """Deterministic compilation from AgentDraft to ResolvedAgentSpec."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from dataclasses import dataclass
6
+ from typing import Any
7
+ from urllib.parse import urlparse
8
+
9
+ from ksadk.studio.capabilities import (
10
+ CapabilityResolver,
11
+ LocalCapabilityResolver,
12
+ canonical_json,
13
+ sha256_digest,
14
+ )
15
+ from ksadk.studio.contracts import (
16
+ AgentDraft,
17
+ CapabilitiesSpec,
18
+ ResolvedAgentSpec,
19
+ ResolvedCapabilities,
20
+ )
21
+ from ksadk.studio.errors import StudioError
22
+ from ksadk.studio.resource_catalog import LocalResourceCatalog
23
+ from ksadk.studio.validator import AgentValidator
24
+ from ksadk.studio.workspace import Workspace
25
+
26
+
27
+ @dataclass(frozen=True)
28
+ class CompileResult:
29
+ resolved: ResolvedAgentSpec
30
+ dependency_lock: dict[str, Any]
31
+
32
+
33
+ class AgentCompiler:
34
+ def __init__(
35
+ self,
36
+ workspace: Workspace,
37
+ *,
38
+ resolver: CapabilityResolver | None = None,
39
+ validator: AgentValidator | None = None,
40
+ catalog: LocalResourceCatalog | None = None,
41
+ ) -> None:
42
+ self.workspace = workspace
43
+ self.resolver = resolver or LocalCapabilityResolver(workspace)
44
+ self.validator = validator or AgentValidator()
45
+ self.catalog = catalog or LocalResourceCatalog(workspace)
46
+
47
+ def compile(self, draft: AgentDraft) -> CompileResult:
48
+ source_payload = draft.model_dump(by_alias=True, exclude_none=True, mode="json")
49
+ source_digest = sha256_digest(canonical_json(source_payload))
50
+ materialized = self._materialize_bindings(draft)
51
+ self.validator.validate(materialized, level="build", raise_on_error=True)
52
+ assert materialized.spec.model is not None
53
+
54
+ skills = [
55
+ self.resolver.resolve_skill(ref)
56
+ for ref in materialized.spec.capabilities.skills
57
+ if ref.enabled
58
+ ]
59
+ mcp_servers = [
60
+ self.resolver.resolve_mcp(ref)
61
+ for ref in materialized.spec.capabilities.mcp_servers
62
+ if ref.enabled
63
+ ]
64
+ tools = [
65
+ self.resolver.resolve_tool(tool)
66
+ for tool in materialized.spec.capabilities.tools
67
+ ]
68
+ skills.sort(key=lambda item: (item["name"], item["version"], item["digest"]))
69
+ mcp_servers.sort(key=lambda item: (item["name"], item["version"], item["digest"]))
70
+ tools.sort(key=lambda item: (item.name, item.version, item.digest or ""))
71
+
72
+ resolved = ResolvedAgentSpec(
73
+ agent_id=draft.metadata.id,
74
+ source_revision=draft.metadata.revision,
75
+ instructions=materialized.spec.instructions,
76
+ model=self.resolver.resolve_model(materialized.spec.model),
77
+ capabilities=ResolvedCapabilities(
78
+ skills=skills,
79
+ mcp_servers=mcp_servers,
80
+ tools=tools,
81
+ ),
82
+ execution=materialized.spec.execution,
83
+ context=materialized.spec.context,
84
+ security=materialized.spec.security,
85
+ evaluation=materialized.spec.evaluation,
86
+ source_digest=source_digest,
87
+ )
88
+ digest_payload = resolved.model_dump(
89
+ by_alias=True,
90
+ exclude={"resolved_digest"},
91
+ exclude_none=True,
92
+ mode="json",
93
+ )
94
+ resolved.resolved_digest = sha256_digest(canonical_json(digest_payload))
95
+ dependency_lock = {
96
+ "lockVersion": "agentkit.lock/v1",
97
+ "agentId": draft.metadata.id,
98
+ "sourceRevision": draft.metadata.revision,
99
+ "resolvedDigest": resolved.resolved_digest,
100
+ "model": resolved.model.model_dump(
101
+ by_alias=True,
102
+ exclude_none=True,
103
+ mode="json",
104
+ ),
105
+ "skills": skills,
106
+ "mcpServers": mcp_servers,
107
+ "tools": [
108
+ tool.model_dump(by_alias=True, exclude_none=True, mode="json")
109
+ for tool in tools
110
+ ],
111
+ }
112
+ return CompileResult(resolved=resolved, dependency_lock=dependency_lock)
113
+
114
+ def _materialize_bindings(self, draft: AgentDraft) -> AgentDraft:
115
+ bindings = draft.spec.bindings
116
+ if (
117
+ not bindings.model_profile_id
118
+ and not bindings.tools
119
+ and not bindings.mcp_servers
120
+ and not bindings.skills
121
+ ):
122
+ return draft
123
+ materialized = draft.model_copy(deep=True)
124
+ model = self.catalog.resolve_model(bindings) or materialized.spec.model
125
+ if model is None:
126
+ raise StudioError(
127
+ "AGENT_MODEL_REQUIRED",
128
+ "必须选择一个可用的 Model Profile",
129
+ status_code=422,
130
+ field="spec.bindings.modelProfileId",
131
+ )
132
+ bound_tools, permissions = self.catalog.policy_preview(bindings)
133
+ bound_mcp_tools = self.catalog.resolve_mcp_tools(bindings)
134
+ capabilities = CapabilitiesSpec(
135
+ skills=[
136
+ *materialized.spec.capabilities.skills,
137
+ *self.catalog.resolve_skills(bindings),
138
+ ],
139
+ mcp_servers=[
140
+ *materialized.spec.capabilities.mcp_servers,
141
+ *self.catalog.resolve_mcp_servers(bindings),
142
+ ],
143
+ tools=[
144
+ *materialized.spec.capabilities.tools,
145
+ *bound_tools,
146
+ *bound_mcp_tools,
147
+ ],
148
+ )
149
+ self._require_unique(
150
+ [item.name for item in capabilities.skills],
151
+ kind="Skill",
152
+ )
153
+ self._require_unique(
154
+ [item.name for item in capabilities.mcp_servers],
155
+ kind="MCP Server",
156
+ )
157
+ self._require_unique(
158
+ [item.name for item in capabilities.tools],
159
+ kind="Tool",
160
+ )
161
+ materialized.spec.model = model
162
+ materialized.spec.capabilities = capabilities
163
+ materialized.spec.security.allowed_permissions = sorted(
164
+ set(materialized.spec.security.allowed_permissions)
165
+ | set(permissions)
166
+ | {
167
+ permission
168
+ for tool in bound_mcp_tools
169
+ for permission in tool.permissions
170
+ }
171
+ )
172
+ endpoint = model.endpoint_url or model.base_url or ""
173
+ hostname = (urlparse(endpoint).hostname or "").lower().rstrip(".")
174
+ if hostname and materialized.spec.security.network.mode == "restricted":
175
+ materialized.spec.security.network.allowed_hosts = sorted(
176
+ set(materialized.spec.security.network.allowed_hosts) | {hostname}
177
+ )
178
+ return materialized
179
+
180
+ @staticmethod
181
+ def _require_unique(names: list[str], *, kind: str) -> None:
182
+ duplicates = sorted({name for name in names if names.count(name) > 1})
183
+ if duplicates:
184
+ raise StudioError(
185
+ "CAPABILITY_DUPLICATE",
186
+ f"{kind} binding 重复",
187
+ status_code=422,
188
+ details={"names": duplicates},
189
+ )