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,324 @@
1
+ """Codex Studio 的本地 ManagedRuntime 审计构建。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import os
7
+ import shutil
8
+ from datetime import datetime, timezone
9
+ from pathlib import Path
10
+ from typing import Any, Callable, Literal, cast
11
+
12
+ from pydantic import ValidationError
13
+
14
+ from ksadk.builders.managed_runtime_builder import ManagedRuntimeBuilder
15
+ from ksadk.managed_runtime import (
16
+ ResolvedRuntime,
17
+ validate_installed_runtime,
18
+ validate_runtime_binary,
19
+ )
20
+ from ksadk.studio.codex_manifest import CodexManifestRepository
21
+ from ksadk.studio.contracts import ContractModel, ModelSpec
22
+ from ksadk.studio.errors import StudioError, not_found
23
+ from ksadk.studio.workspace import Workspace
24
+ from ksadk.version import VERSION as SDK_VERSION
25
+
26
+ RuntimeInspector = Callable[[ResolvedRuntime], tuple[str, str, str]]
27
+
28
+
29
+ class CodexBuildRecord(ContractModel):
30
+ id: str
31
+ status: Literal["SUCCEEDED"] = "SUCCEEDED"
32
+ agent_name: str
33
+ agent_version: str
34
+ source_revision: int = 1
35
+ artifact_path: str
36
+ manifest_sha256: str
37
+ runtime_name: Literal["codex"] = "codex"
38
+ runtime_version: str
39
+ sdk_version: str
40
+ cli_version: str
41
+ proxy_mode: Literal["forced", "auto", "direct"]
42
+ runtime_lock: dict
43
+ # ``None`` identifies legacy records that predate connection snapshots.
44
+ # New builds always persist a mapping (possibly empty), so run resolution
45
+ # never consults mutable Catalog state after the build has been created.
46
+ model_profiles: dict[str, dict[str, Any]] | None = None
47
+ created_at: datetime
48
+
49
+
50
+ class CodexBuildRepository:
51
+ def __init__(self, workspace: Workspace) -> None:
52
+ self.workspace = workspace
53
+
54
+ def _path(self, build_id: str) -> Path:
55
+ return self.workspace.resolve(Path(".agentkit/codex-builds") / f"{build_id}.json")
56
+
57
+ def save(self, record: CodexBuildRecord) -> CodexBuildRecord:
58
+ payload = record.model_dump(
59
+ by_alias=True,
60
+ exclude_none=True,
61
+ mode="json",
62
+ )
63
+ self.workspace.atomic_write_text(
64
+ self._path(record.id),
65
+ json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True) + "\n",
66
+ )
67
+ return record
68
+
69
+ def get(self, build_id: str) -> CodexBuildRecord:
70
+ path = self._path(build_id)
71
+ if not path.is_file():
72
+ raise not_found("codex build", build_id)
73
+ try:
74
+ return cast(
75
+ CodexBuildRecord,
76
+ CodexBuildRecord.model_validate_json(path.read_text(encoding="utf-8")),
77
+ )
78
+ except (OSError, ValidationError) as exc:
79
+ raise StudioError(
80
+ "CODEX_BUILD_RECORD_INVALID",
81
+ "Codex Build 记录损坏",
82
+ status_code=500,
83
+ details={"id": build_id},
84
+ ) from exc
85
+
86
+ def list(self) -> list[CodexBuildRecord]:
87
+ directory = self.workspace.resolve(".agentkit/codex-builds")
88
+ records: list[CodexBuildRecord] = []
89
+ for path in directory.glob("build_*.json"):
90
+ try:
91
+ records.append(
92
+ CodexBuildRecord.model_validate_json(path.read_text(encoding="utf-8"))
93
+ )
94
+ except (OSError, ValidationError):
95
+ continue
96
+ return sorted(records, key=lambda item: item.created_at, reverse=True)
97
+
98
+ def delete_for_agent(
99
+ self,
100
+ agent_id: str,
101
+ *,
102
+ purge: bool,
103
+ trash_directory: Path | None = None,
104
+ ) -> int:
105
+ records = [item for item in self.list() if item.agent_name == agent_id]
106
+ artifacts = {
107
+ self.workspace.resolve(item.artifact_path) for item in records if item.artifact_path
108
+ }
109
+ for artifact in artifacts:
110
+ self._remove_file(
111
+ artifact,
112
+ purge=purge,
113
+ destination=(
114
+ None
115
+ if trash_directory is None
116
+ else trash_directory / "artifacts" / artifact.name
117
+ ),
118
+ )
119
+ for record in records:
120
+ path = self._path(record.id)
121
+ self._remove_file(
122
+ path,
123
+ purge=purge,
124
+ destination=(
125
+ None if trash_directory is None else trash_directory / "builds" / path.name
126
+ ),
127
+ )
128
+ return len(records)
129
+
130
+ def _remove_file(
131
+ self,
132
+ source: Path,
133
+ *,
134
+ purge: bool,
135
+ destination: Path | None,
136
+ ) -> None:
137
+ if not source.is_file():
138
+ return
139
+ if purge:
140
+ source.unlink()
141
+ return
142
+ if destination is None:
143
+ raise ValueError("recoverable deletion requires a trash destination")
144
+ target = self.workspace.resolve(destination)
145
+ target.parent.mkdir(parents=True, exist_ok=True)
146
+ shutil.move(str(source), str(target))
147
+
148
+
149
+ def current_proxy_mode() -> Literal["forced", "auto", "direct"]:
150
+ override = os.environ.get("KSADK_CODEX_USE_PROXY")
151
+ if override == "1":
152
+ return "forced"
153
+ if override == "0":
154
+ return "direct"
155
+ return "auto"
156
+
157
+
158
+ def _inspect_runtime(runtime: ResolvedRuntime) -> tuple[str, str, str]:
159
+ installed = validate_installed_runtime(runtime)
160
+ cli = validate_runtime_binary(runtime)
161
+ return SDK_VERSION, installed, cli
162
+
163
+
164
+ class CodexStudioBuilder:
165
+ def __init__(
166
+ self,
167
+ workspace: Workspace,
168
+ *,
169
+ manifest_repository: CodexManifestRepository | None = None,
170
+ build_repository: CodexBuildRepository | None = None,
171
+ runtime_inspector: RuntimeInspector = _inspect_runtime,
172
+ resource_catalog: Any = None,
173
+ draft_repository: Any = None,
174
+ ) -> None:
175
+ self.workspace = workspace
176
+ self.manifests = manifest_repository or CodexManifestRepository(workspace)
177
+ self.repository = build_repository or CodexBuildRepository(workspace)
178
+ self.runtime_inspector = runtime_inspector
179
+ self.catalog = resource_catalog
180
+ self.drafts = draft_repository
181
+
182
+ def build(
183
+ self,
184
+ agent_id: str | None = None,
185
+ *,
186
+ source_revision: int = 1,
187
+ ) -> CodexBuildRecord:
188
+ snapshot = self.manifests.load(agent_id)
189
+ model_profiles = self._model_profile_snapshot(
190
+ snapshot.manifest.name,
191
+ allowed_models=snapshot.manifest.allowed_models,
192
+ )
193
+ build_id = self._build_id(snapshot.manifest_sha256, model_profiles)
194
+ try:
195
+ existing = self.repository.get(build_id)
196
+ except StudioError as exc:
197
+ if exc.status_code != 404:
198
+ raise
199
+ else:
200
+ return existing
201
+
202
+ runtime = ResolvedRuntime(
203
+ name=snapshot.manifest.runtime.name,
204
+ version=snapshot.manifest.runtime.version,
205
+ source="manifest",
206
+ )
207
+ sdk_version, installed_runtime, cli_version = self.runtime_inspector(runtime)
208
+ if installed_runtime != runtime.version:
209
+ raise StudioError(
210
+ "CODEX_RUNTIME_VERSION_MISMATCH",
211
+ "本地 Codex Runtime 与 agentengine.yaml 锁定版本不一致",
212
+ status_code=422,
213
+ details={"expected": runtime.version, "installed": installed_runtime},
214
+ )
215
+
216
+ result = ManagedRuntimeBuilder(
217
+ self.workspace.root,
218
+ config=snapshot.manifest.model_dump(mode="python", exclude_none=True),
219
+ runtime_version=runtime.version,
220
+ ).build()
221
+ if not result.success or result.artifact_path is None:
222
+ raise StudioError(
223
+ "CODEX_BUILD_FAILED",
224
+ result.error_message or "Codex ManagedRuntime 构建失败",
225
+ status_code=422,
226
+ )
227
+ lock = self._runtime_lock(result.artifact_path)
228
+ lock_sha = str(lock.get("manifest_sha256") or "")
229
+ if lock_sha != snapshot.manifest_sha256:
230
+ raise StudioError(
231
+ "CODEX_BUILD_DIGEST_MISMATCH",
232
+ "构建产物与当前 agentengine.yaml 摘要不一致",
233
+ status_code=500,
234
+ )
235
+ record = CodexBuildRecord(
236
+ id=build_id,
237
+ agent_name=snapshot.manifest.name,
238
+ agent_version=snapshot.manifest.version,
239
+ source_revision=source_revision,
240
+ artifact_path=self.workspace.relative(result.artifact_path),
241
+ manifest_sha256=snapshot.manifest_sha256,
242
+ runtime_version=runtime.version,
243
+ sdk_version=sdk_version,
244
+ cli_version=cli_version,
245
+ proxy_mode=current_proxy_mode(),
246
+ runtime_lock=lock,
247
+ model_profiles=model_profiles,
248
+ created_at=datetime.now(timezone.utc),
249
+ )
250
+ return self.repository.save(record)
251
+
252
+ def is_current(self, record: CodexBuildRecord) -> bool:
253
+ snapshot = self.manifests.load(record.agent_name)
254
+ if record.manifest_sha256 != snapshot.manifest_sha256:
255
+ return False
256
+ if record.model_profiles is None:
257
+ return True
258
+ return record.model_profiles == self._model_profile_snapshot(
259
+ snapshot.manifest.name,
260
+ allowed_models=snapshot.manifest.allowed_models,
261
+ )
262
+
263
+ @staticmethod
264
+ def _build_id(
265
+ manifest_sha256: str,
266
+ model_profiles: dict[str, dict[str, Any]],
267
+ ) -> str:
268
+ if not model_profiles:
269
+ return f"build_{manifest_sha256[:20]}"
270
+ fingerprint = json.dumps(
271
+ model_profiles,
272
+ ensure_ascii=False,
273
+ sort_keys=True,
274
+ separators=(",", ":"),
275
+ )
276
+ import hashlib
277
+
278
+ digest = hashlib.sha256(f"{manifest_sha256}\n{fingerprint}".encode()).hexdigest()
279
+ return f"build_{digest[:20]}"
280
+
281
+ def _model_profile_snapshot(
282
+ self,
283
+ agent_id: str,
284
+ *,
285
+ allowed_models: tuple[str, ...],
286
+ ) -> dict[str, dict[str, Any]]:
287
+ if self.catalog is None or self.drafts is None:
288
+ return {}
289
+ draft = self.drafts.get(agent_id)
290
+ if draft is None:
291
+ return {}
292
+ bindings = draft.spec.bindings
293
+ resource_ids = list(getattr(bindings, "model_profile_ids", []) or [])
294
+ default_id = getattr(bindings, "model_profile_id", None)
295
+ if not resource_ids and default_id:
296
+ resource_ids = [default_id]
297
+ profiles: dict[str, dict[str, Any]] = {}
298
+ for resource_id in resource_ids:
299
+ descriptor = self.catalog.get(resource_id)
300
+ profile = ModelSpec.model_validate(descriptor.contract)
301
+ if profile.model not in allowed_models or profile.model in profiles:
302
+ continue
303
+ profiles[profile.model] = profile.model_dump(
304
+ by_alias=True,
305
+ exclude_defaults=True,
306
+ exclude_none=True,
307
+ mode="json",
308
+ )
309
+ return profiles
310
+
311
+ @staticmethod
312
+ def _runtime_lock(artifact_path: Path) -> dict:
313
+ import zipfile
314
+
315
+ with zipfile.ZipFile(artifact_path) as archive:
316
+ return cast(dict, json.loads(archive.read("runtime-lock.json")))
317
+
318
+
319
+ __all__ = [
320
+ "CodexBuildRecord",
321
+ "CodexBuildRepository",
322
+ "CodexStudioBuilder",
323
+ "current_proxy_mode",
324
+ ]
@@ -0,0 +1,278 @@
1
+ """Codex Studio 的单一 ``agentengine.yaml`` 合同与文件仓储。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ import hashlib
6
+ import re
7
+ import shutil
8
+ from dataclasses import dataclass
9
+ from pathlib import Path
10
+ from typing import Any, Literal, cast
11
+
12
+ import yaml # type: ignore[import-untyped]
13
+ from pydantic import BaseModel, ConfigDict, Field, ValidationError, model_validator
14
+
15
+ from ksadk.builders.managed_runtime_builder import serialize_managed_runtime_manifest
16
+ from ksadk.studio.errors import StudioError, not_found
17
+ from ksadk.studio.workspace import Workspace
18
+
19
+
20
+ class CodexRuntimeRef(BaseModel):
21
+ """平台托管的 Codex runtime 锁定信息。"""
22
+
23
+ model_config = ConfigDict(extra="forbid")
24
+
25
+ name: Literal["codex"] = "codex"
26
+ version: str = Field(min_length=1, max_length=64)
27
+
28
+
29
+ class CodexAgentManifest(BaseModel):
30
+ """本地演示允许进入 ``agentengine.yaml`` 的完整字段集合。"""
31
+
32
+ model_config = ConfigDict(extra="forbid")
33
+
34
+ name: str = Field(pattern=r"^[a-z][a-z0-9-]{2,62}$")
35
+ version: str = Field(min_length=1, max_length=64)
36
+ framework: Literal["codex"] = "codex"
37
+ artifact_type: Literal["ManagedRuntime"] = "ManagedRuntime"
38
+ runtime: CodexRuntimeRef
39
+ model: str = Field(min_length=1, max_length=256)
40
+ models: list[str] | None = None
41
+ prompt: str = Field(min_length=1, max_length=32768)
42
+ skills: list[str] | None = None
43
+ mcp_servers: list[dict[str, Any]] | None = None
44
+ sandbox: str | None = None
45
+ approval_mode: str | None = None
46
+
47
+ @model_validator(mode="after")
48
+ def validate_models(self) -> "CodexAgentManifest":
49
+ if self.models is None:
50
+ return self
51
+ normalized: list[str] = []
52
+ for value in self.models:
53
+ model = str(value).strip()
54
+ if not model or len(model) > 256:
55
+ raise ValueError("models 中的模型名称长度必须为 1..256")
56
+ if model in normalized:
57
+ raise ValueError("models 不能包含重复模型")
58
+ normalized.append(model)
59
+ if not normalized:
60
+ raise ValueError("models 至少包含一个模型")
61
+ if self.model not in normalized:
62
+ raise ValueError("默认模型 model 必须包含在 models 中")
63
+ self.models = normalized
64
+ if self.skills is not None:
65
+ seen: set[str] = set()
66
+ deduped: list[str] = []
67
+ for sid in self.skills:
68
+ sid = str(sid).strip()
69
+ if not sid:
70
+ raise ValueError("skills 不能包含空值")
71
+ if sid in seen:
72
+ raise ValueError("skills 不能包含重复资源")
73
+ seen.add(sid)
74
+ deduped.append(sid)
75
+ self.skills = deduped
76
+ if self.mcp_servers is not None:
77
+ mcp_seen: set[str] = set()
78
+ mcp_deduped: list[dict[str, Any]] = []
79
+ for server in self.mcp_servers:
80
+ if not isinstance(server, dict):
81
+ raise ValueError("mcp_servers 必须是对象列表")
82
+ name = str(server.get("name") or "").strip()
83
+ url = str(server.get("url") or "").strip()
84
+ if not name:
85
+ raise ValueError("mcp_servers 每项必须有 name")
86
+ if not url:
87
+ raise ValueError("mcp_servers 每项必须有 url")
88
+ if name in mcp_seen:
89
+ raise ValueError("mcp_servers 不能包含重复 name")
90
+ mcp_seen.add(name)
91
+ mcp_deduped.append(server)
92
+ self.mcp_servers = mcp_deduped
93
+ return self
94
+
95
+ @property
96
+ def allowed_models(self) -> tuple[str, ...]:
97
+ return tuple(self.models or [self.model])
98
+
99
+
100
+ def normalized_manifest_bytes(manifest: CodexAgentManifest) -> bytes:
101
+ """生成构建、SHA 和磁盘写入共同使用的规范化 YAML。"""
102
+
103
+ payload = manifest.model_dump(mode="python", exclude_none=True)
104
+ return serialize_managed_runtime_manifest(payload)
105
+
106
+
107
+ @dataclass(frozen=True)
108
+ class CodexManifestSnapshot:
109
+ manifest: CodexAgentManifest
110
+ manifest_sha256: str
111
+ source_path: Path
112
+ source_bytes: bytes
113
+
114
+
115
+ _AGENT_NAME = re.compile(r"^[a-z][a-z0-9-]{2,62}$")
116
+
117
+
118
+ class CodexManifestRepository:
119
+ """每个本地 Agent 一份 YAML,首个 Agent 兼容工作区根路径。"""
120
+
121
+ def __init__(self, workspace: Workspace) -> None:
122
+ self.workspace = workspace
123
+ self.path = workspace.resolve("agentengine.yaml")
124
+ self.agents_path = workspace.resolve("agents")
125
+
126
+ def exists(self, agent_id: str | None = None) -> bool:
127
+ if agent_id is None:
128
+ return self.path.is_file()
129
+ try:
130
+ self.load(agent_id)
131
+ except StudioError as exc:
132
+ if exc.status_code == 404:
133
+ return False
134
+ raise
135
+ return True
136
+
137
+ def load(self, agent_id: str | None = None) -> CodexManifestSnapshot:
138
+ if agent_id is None:
139
+ return self._load_path(self.path)
140
+ self._validate_agent_id(agent_id)
141
+ if self.path.is_file():
142
+ root = self._load_path(self.path)
143
+ if root.manifest.name == agent_id:
144
+ return root
145
+ path = self._agent_path(agent_id)
146
+ snapshot = self._load_path(path, agent_id=agent_id)
147
+ if snapshot.manifest.name != agent_id:
148
+ raise StudioError(
149
+ "CODEX_MANIFEST_ID_MISMATCH",
150
+ "Agent 目录与 agentengine.yaml 中的 name 不一致",
151
+ status_code=422,
152
+ details={"agentId": agent_id, "manifestName": snapshot.manifest.name},
153
+ )
154
+ return snapshot
155
+
156
+ def list(self) -> list[CodexManifestSnapshot]:
157
+ snapshots: list[CodexManifestSnapshot] = []
158
+ seen: set[str] = set()
159
+ if self.path.is_file():
160
+ root = self._load_path(self.path)
161
+ snapshots.append(root)
162
+ seen.add(root.manifest.name)
163
+ for path in sorted(self.agents_path.glob("*/agentengine.yaml")):
164
+ try:
165
+ snapshot = self._load_path(path)
166
+ except StudioError:
167
+ continue
168
+ if snapshot.manifest.name in seen:
169
+ continue
170
+ snapshots.append(snapshot)
171
+ seen.add(snapshot.manifest.name)
172
+ return snapshots
173
+
174
+ def _load_path(
175
+ self,
176
+ path: Path,
177
+ *,
178
+ agent_id: str | None = None,
179
+ ) -> CodexManifestSnapshot:
180
+ if not path.is_file():
181
+ if agent_id is not None:
182
+ raise not_found("agent", agent_id)
183
+ raise StudioError(
184
+ "CODEX_MANIFEST_NOT_FOUND",
185
+ "当前工作区还没有 agentengine.yaml",
186
+ status_code=404,
187
+ )
188
+ try:
189
+ payload = yaml.safe_load(path.read_text(encoding="utf-8-sig"))
190
+ manifest = cast(
191
+ CodexAgentManifest,
192
+ CodexAgentManifest.model_validate(payload),
193
+ )
194
+ except (OSError, yaml.YAMLError, ValidationError) as exc:
195
+ raise StudioError(
196
+ "CODEX_MANIFEST_INVALID",
197
+ "agentengine.yaml 不符合 Codex ManagedRuntime 合同",
198
+ status_code=422,
199
+ details={"reason": str(exc)},
200
+ ) from exc
201
+ source = normalized_manifest_bytes(manifest)
202
+ return CodexManifestSnapshot(
203
+ manifest=manifest,
204
+ manifest_sha256=hashlib.sha256(source).hexdigest(),
205
+ source_path=path,
206
+ source_bytes=source,
207
+ )
208
+
209
+ def save(self, manifest: CodexAgentManifest) -> CodexManifestSnapshot:
210
+ source = normalized_manifest_bytes(manifest)
211
+ path = self._save_path(manifest.name)
212
+ self.workspace.atomic_write_text(path, source.decode("utf-8"))
213
+ return CodexManifestSnapshot(
214
+ manifest=manifest,
215
+ manifest_sha256=hashlib.sha256(source).hexdigest(),
216
+ source_path=path,
217
+ source_bytes=source,
218
+ )
219
+
220
+ def delete(
221
+ self,
222
+ agent_id: str,
223
+ *,
224
+ purge: bool,
225
+ trash_directory: Path | None = None,
226
+ ) -> None:
227
+ """Remove one Agent source without ever deleting the workspace root."""
228
+
229
+ snapshot = self.load(agent_id)
230
+ source = snapshot.source_path
231
+ if source == self.path:
232
+ if purge:
233
+ source.unlink()
234
+ return
235
+ if trash_directory is None:
236
+ raise ValueError("recoverable deletion requires a trash directory")
237
+ destination = self.workspace.resolve(trash_directory / "source/agentengine.yaml")
238
+ destination.parent.mkdir(parents=True, exist_ok=True)
239
+ shutil.move(str(source), str(destination))
240
+ return
241
+
242
+ agent_directory = source.parent
243
+ if purge:
244
+ shutil.rmtree(agent_directory)
245
+ return
246
+ if trash_directory is None:
247
+ raise ValueError("recoverable deletion requires a trash directory")
248
+ destination = self.workspace.resolve(
249
+ trash_directory / "source/agents" / agent_id
250
+ )
251
+ destination.parent.mkdir(parents=True, exist_ok=True)
252
+ shutil.move(str(agent_directory), str(destination))
253
+
254
+ def _save_path(self, agent_id: str) -> Path:
255
+ self._validate_agent_id(agent_id)
256
+ if not self.path.is_file():
257
+ return self.path
258
+ if self._load_path(self.path).manifest.name == agent_id:
259
+ return self.path
260
+ return self._agent_path(agent_id)
261
+
262
+ def _agent_path(self, agent_id: str) -> Path:
263
+ self._validate_agent_id(agent_id)
264
+ return self.workspace.resolve(Path("agents") / agent_id / "agentengine.yaml")
265
+
266
+ @staticmethod
267
+ def _validate_agent_id(agent_id: str) -> None:
268
+ if not _AGENT_NAME.fullmatch(agent_id):
269
+ raise not_found("agent", agent_id)
270
+
271
+
272
+ __all__ = [
273
+ "CodexAgentManifest",
274
+ "CodexManifestRepository",
275
+ "CodexManifestSnapshot",
276
+ "CodexRuntimeRef",
277
+ "normalized_manifest_bytes",
278
+ ]