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,182 @@
1
+ """Signed keyset cursors shared by Studio list endpoints.
2
+
3
+ The cursor is intentionally opaque to clients. It binds the last stable sort
4
+ tuple to a namespace, a whitelisted sort name and the active filters so a
5
+ cursor cannot be replayed against a different query.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import base64
11
+ import hashlib
12
+ import hmac
13
+ import json
14
+ import secrets
15
+ from collections.abc import Callable, Mapping, Sequence
16
+ from typing import Any, TypeVar
17
+
18
+ from ksadk.studio.errors import StudioError
19
+
20
+ T = TypeVar("T")
21
+ CursorScalar = str | int | float | bool | None
22
+
23
+ _CURSOR_VERSION = 1
24
+ _CURSOR_SECRET = secrets.token_bytes(32)
25
+ _MAX_CURSOR_LENGTH = 4096
26
+
27
+
28
+ def _invalid_cursor() -> StudioError:
29
+ return StudioError(
30
+ "PAGINATION_CURSOR_INVALID",
31
+ "分页游标无效或已过期",
32
+ status_code=422,
33
+ field="cursor",
34
+ )
35
+
36
+
37
+ def _encode_part(value: bytes) -> str:
38
+ return base64.urlsafe_b64encode(value).decode("ascii").rstrip("=")
39
+
40
+
41
+ def _decode_part(value: str) -> bytes:
42
+ padding = "=" * (-len(value) % 4)
43
+ try:
44
+ return base64.b64decode(value + padding, altchars=b"-_", validate=True)
45
+ except (ValueError, TypeError) as exc:
46
+ raise _invalid_cursor() from exc
47
+
48
+
49
+ def _filter_fingerprint(filters: Mapping[str, Any]) -> str:
50
+ canonical = json.dumps(
51
+ dict(filters),
52
+ ensure_ascii=False,
53
+ sort_keys=True,
54
+ separators=(",", ":"),
55
+ ).encode("utf-8")
56
+ return hashlib.sha256(canonical).hexdigest()[:24]
57
+
58
+
59
+ def encode_cursor(
60
+ *,
61
+ namespace: str,
62
+ sort: str,
63
+ filters: Mapping[str, Any],
64
+ key: Sequence[CursorScalar],
65
+ ) -> str:
66
+ """Return an authenticated opaque cursor for the last emitted row."""
67
+
68
+ if not key or len(key) > 16:
69
+ raise ValueError("cursor key must contain between 1 and 16 values")
70
+ payload = {
71
+ "v": _CURSOR_VERSION,
72
+ "ns": namespace,
73
+ "sort": sort,
74
+ "filters": _filter_fingerprint(filters),
75
+ "key": list(key),
76
+ }
77
+ encoded = json.dumps(
78
+ payload,
79
+ ensure_ascii=False,
80
+ sort_keys=True,
81
+ separators=(",", ":"),
82
+ ).encode("utf-8")
83
+ signature = hmac.new(_CURSOR_SECRET, encoded, hashlib.sha256).digest()
84
+ return f"{_encode_part(encoded)}.{_encode_part(signature)}"
85
+
86
+
87
+ def decode_cursor(
88
+ cursor: str,
89
+ *,
90
+ namespace: str,
91
+ sort: str,
92
+ filters: Mapping[str, Any],
93
+ ) -> tuple[CursorScalar, ...]:
94
+ """Validate a cursor and return its stable sort tuple."""
95
+
96
+ if not cursor or len(cursor) > _MAX_CURSOR_LENGTH:
97
+ raise _invalid_cursor()
98
+ try:
99
+ encoded_part, signature_part = cursor.split(".", 1)
100
+ encoded = _decode_part(encoded_part)
101
+ signature = _decode_part(signature_part)
102
+ except ValueError as exc:
103
+ raise _invalid_cursor() from exc
104
+ expected_signature = hmac.new(_CURSOR_SECRET, encoded, hashlib.sha256).digest()
105
+ if not hmac.compare_digest(signature, expected_signature):
106
+ raise _invalid_cursor()
107
+ try:
108
+ payload = json.loads(encoded.decode("utf-8"))
109
+ except (UnicodeDecodeError, json.JSONDecodeError) as exc:
110
+ raise _invalid_cursor() from exc
111
+ if not isinstance(payload, dict) or set(payload) != {
112
+ "v",
113
+ "ns",
114
+ "sort",
115
+ "filters",
116
+ "key",
117
+ }:
118
+ raise _invalid_cursor()
119
+ if (
120
+ payload.get("v") != _CURSOR_VERSION
121
+ or payload.get("ns") != namespace
122
+ or payload.get("sort") != sort
123
+ or payload.get("filters") != _filter_fingerprint(filters)
124
+ ):
125
+ raise _invalid_cursor()
126
+ key = payload.get("key")
127
+ if not isinstance(key, list) or not key or len(key) > 16:
128
+ raise _invalid_cursor()
129
+ if any(value is not None and not isinstance(value, (str, int, float, bool)) for value in key):
130
+ raise _invalid_cursor()
131
+ return tuple(key)
132
+
133
+
134
+ def keyset_page(
135
+ items: Sequence[T],
136
+ *,
137
+ key: Callable[[T], Sequence[CursorScalar]],
138
+ reverse: bool,
139
+ limit: int,
140
+ cursor: str | None,
141
+ namespace: str,
142
+ sort: str,
143
+ filters: Mapping[str, Any],
144
+ ) -> dict[str, Any]:
145
+ """Sort and page records using a unique stable tuple.
146
+
147
+ Callers must include a unique identifier as the final key component.
148
+ Filters are expected to have been applied before this function is called.
149
+ """
150
+
151
+ page_limit = max(1, limit)
152
+ ordered = sorted(items, key=lambda item: tuple(key(item)), reverse=reverse)
153
+ remaining = ordered
154
+ if cursor is not None:
155
+ cursor_key = decode_cursor(
156
+ cursor,
157
+ namespace=namespace,
158
+ sort=sort,
159
+ filters=filters,
160
+ )
161
+ try:
162
+ remaining = [
163
+ item
164
+ for item in ordered
165
+ if (tuple(key(item)) < cursor_key if reverse else tuple(key(item)) > cursor_key)
166
+ ]
167
+ except TypeError as exc:
168
+ raise _invalid_cursor() from exc
169
+ page_items = remaining[:page_limit]
170
+ next_cursor = None
171
+ if len(remaining) > page_limit and page_items:
172
+ next_cursor = encode_cursor(
173
+ namespace=namespace,
174
+ sort=sort,
175
+ filters=filters,
176
+ key=key(page_items[-1]),
177
+ )
178
+ return {
179
+ "items": page_items,
180
+ "nextCursor": next_cursor,
181
+ "total": len(ordered),
182
+ }
@@ -0,0 +1,183 @@
1
+ """AST-only, inspect-before-commit staging for uploaded Python tools."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import ast
6
+ import hashlib
7
+ import json
8
+ import re
9
+ import shutil
10
+ from pathlib import Path, PurePath
11
+ from typing import Any
12
+ from uuid import uuid4
13
+
14
+ from ksadk.studio.errors import StudioError
15
+ from ksadk.studio.workspace import Workspace
16
+
17
+ _MAX_SOURCE_BYTES = 1024 * 1024
18
+ _TOKEN = re.compile(r"^pyti_[0-9a-f]{32}$")
19
+
20
+
21
+ class PythonToolInspector:
22
+ """Stage Python source and expose declarations without importing it."""
23
+
24
+ def __init__(self, workspace: Workspace) -> None:
25
+ self.workspace = workspace
26
+ self.root = workspace.resolve(".agentkit/catalog/python-tool-inspections")
27
+ self.root.mkdir(parents=True, exist_ok=True)
28
+
29
+ def inspect(self, content: bytes, *, filename: str) -> dict[str, Any]:
30
+ normalized_filename = str(filename or "").strip()
31
+ if (
32
+ not normalized_filename
33
+ or PurePath(normalized_filename).name != normalized_filename
34
+ or not normalized_filename.endswith(".py")
35
+ ):
36
+ raise StudioError(
37
+ "PYTHON_TOOL_FILENAME_INVALID",
38
+ "Python Tool 必须是单个 .py 文件",
39
+ status_code=422,
40
+ field="file",
41
+ )
42
+ if not content:
43
+ raise StudioError(
44
+ "PYTHON_TOOL_EMPTY",
45
+ "Python Tool 文件不能为空",
46
+ status_code=422,
47
+ field="file",
48
+ )
49
+ if len(content) > _MAX_SOURCE_BYTES:
50
+ raise StudioError(
51
+ "PYTHON_TOOL_TOO_LARGE",
52
+ "Python Tool 源码不能超过 1 MiB",
53
+ status_code=413,
54
+ field="file",
55
+ )
56
+ try:
57
+ source = content.decode("utf-8")
58
+ except UnicodeDecodeError as exc:
59
+ raise StudioError(
60
+ "PYTHON_TOOL_ENCODING_INVALID",
61
+ "Python Tool 源码必须使用 UTF-8 编码",
62
+ status_code=422,
63
+ field="file",
64
+ ) from exc
65
+ try:
66
+ tree = ast.parse(source, filename=normalized_filename)
67
+ except SyntaxError as exc:
68
+ raise StudioError(
69
+ "PYTHON_TOOL_SYNTAX_INVALID",
70
+ f"Python 语法错误:第 {exc.lineno or 1} 行",
71
+ status_code=422,
72
+ field="file",
73
+ details={"line": exc.lineno, "offset": exc.offset},
74
+ ) from exc
75
+
76
+ callables = [
77
+ self._callable(node)
78
+ for node in tree.body
79
+ if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef))
80
+ and not node.name.startswith("_")
81
+ ]
82
+ if not callables:
83
+ raise StudioError(
84
+ "PYTHON_TOOL_CALLABLE_REQUIRED",
85
+ "文件中没有可导入的顶层公开函数",
86
+ status_code=422,
87
+ field="file",
88
+ )
89
+
90
+ token = f"pyti_{uuid4().hex}"
91
+ directory = self.root / token
92
+ directory.mkdir(parents=True, exist_ok=False)
93
+ digest = hashlib.sha256(content).hexdigest()
94
+ try:
95
+ self.workspace.atomic_write_text(directory / "tool.py", source)
96
+ record = {
97
+ "format": "agentkit.python-tool-inspection/v1",
98
+ "inspectionToken": token,
99
+ "filename": normalized_filename,
100
+ "sha256": digest,
101
+ "size": len(content),
102
+ "callables": callables,
103
+ }
104
+ self.workspace.atomic_write_text(
105
+ directory / "inspection.json",
106
+ json.dumps(record, ensure_ascii=False, sort_keys=True, indent=2) + "\n",
107
+ )
108
+ except BaseException:
109
+ shutil.rmtree(directory, ignore_errors=True)
110
+ raise
111
+ return dict(record)
112
+
113
+ def load(self, token: str) -> dict[str, Any]:
114
+ directory = self._directory(token)
115
+ record_path = directory / "inspection.json"
116
+ source_path = directory / "tool.py"
117
+ try:
118
+ record = json.loads(record_path.read_text(encoding="utf-8"))
119
+ content = source_path.read_bytes()
120
+ except (OSError, ValueError) as exc:
121
+ raise StudioError(
122
+ "PYTHON_TOOL_INSPECTION_NOT_FOUND",
123
+ "Python Tool 检查不存在或已失效",
124
+ status_code=404,
125
+ ) from exc
126
+ actual = hashlib.sha256(content).hexdigest()
127
+ if actual != str(record.get("sha256") or ""):
128
+ raise StudioError(
129
+ "PYTHON_TOOL_INSPECTION_CHANGED",
130
+ "Python Tool 暂存内容在确认前发生变化,请重新检查",
131
+ status_code=409,
132
+ )
133
+ record["sourcePath"] = self.workspace.relative(source_path)
134
+ return record
135
+
136
+ def consume(self, token: str) -> None:
137
+ shutil.rmtree(self._directory(token), ignore_errors=True)
138
+
139
+ def _directory(self, token: str) -> Path:
140
+ if not _TOKEN.fullmatch(str(token or "")):
141
+ raise StudioError(
142
+ "PYTHON_TOOL_INSPECTION_NOT_FOUND",
143
+ "Python Tool 检查不存在或已失效",
144
+ status_code=404,
145
+ )
146
+ directory = (self.root / token).resolve()
147
+ try:
148
+ directory.relative_to(self.root.resolve())
149
+ except ValueError as exc:
150
+ raise StudioError(
151
+ "PYTHON_TOOL_INSPECTION_NOT_FOUND",
152
+ "Python Tool 检查不存在或已失效",
153
+ status_code=404,
154
+ ) from exc
155
+ return directory
156
+
157
+ @staticmethod
158
+ def _callable(node: ast.FunctionDef | ast.AsyncFunctionDef) -> dict[str, Any]:
159
+ positional = [*node.args.posonlyargs, *node.args.args]
160
+ required_count = max(0, len(positional) - len(node.args.defaults))
161
+ required = [argument.arg for argument in positional[:required_count]]
162
+ required.extend(
163
+ argument.arg
164
+ for argument, default in zip(node.args.kwonlyargs, node.args.kw_defaults)
165
+ if default is None
166
+ )
167
+ parameters = [argument.arg for argument in positional]
168
+ if node.args.vararg is not None:
169
+ parameters.append(f"*{node.args.vararg.arg}")
170
+ parameters.extend(argument.arg for argument in node.args.kwonlyargs)
171
+ if node.args.kwarg is not None:
172
+ parameters.append(f"**{node.args.kwarg.arg}")
173
+ return {
174
+ "name": node.name,
175
+ "async": isinstance(node, ast.AsyncFunctionDef),
176
+ "description": ast.get_docstring(node) or "",
177
+ "parameters": parameters,
178
+ "required": required,
179
+ "line": node.lineno,
180
+ }
181
+
182
+
183
+ __all__ = ["PythonToolInspector"]
@@ -0,0 +1,306 @@
1
+ """File-backed repositories for Agent drafts and immutable build records."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import shutil
7
+ from datetime import datetime, timezone
8
+ from pathlib import Path
9
+ from typing import Any, cast
10
+
11
+ import yaml # type: ignore[import-untyped]
12
+ from pydantic import ValidationError
13
+
14
+ from ksadk.studio.contracts import (
15
+ AgentAppearance,
16
+ AgentDraft,
17
+ AgentMetadata,
18
+ AgentSpec,
19
+ BuildRecord,
20
+ Instructions,
21
+ )
22
+ from ksadk.studio.errors import StudioError, not_found
23
+ from ksadk.studio.workspace import Workspace
24
+
25
+
26
+ class AgentDraftRepository:
27
+ def __init__(self, workspace: Workspace) -> None:
28
+ self.workspace = workspace
29
+
30
+ def _agent_dir(self, agent_id: str) -> Path:
31
+ return self.workspace.resolve(Path("agents") / agent_id)
32
+
33
+ def _agent_file(self, agent_id: str) -> Path:
34
+ return self._agent_dir(agent_id) / "agent.yaml"
35
+
36
+ def create(
37
+ self,
38
+ *,
39
+ agent_id: str,
40
+ name: str,
41
+ description: str = "",
42
+ template: str = "blank",
43
+ spec: AgentSpec | None = None,
44
+ labels: dict[str, str] | None = None,
45
+ ) -> AgentDraft:
46
+ if template not in {"blank", "research"}:
47
+ raise StudioError(
48
+ "AGENT_TEMPLATE_UNSUPPORTED",
49
+ "不支持的 Agent 模板",
50
+ status_code=422,
51
+ field="template",
52
+ details={"template": template},
53
+ )
54
+ draft = AgentDraft(
55
+ metadata=AgentMetadata(
56
+ id=agent_id,
57
+ name=name,
58
+ labels={
59
+ "agentkit.ksyun.com/template": template,
60
+ **dict(labels or {}),
61
+ },
62
+ ),
63
+ spec=spec
64
+ or AgentSpec(
65
+ description=description,
66
+ instructions=Instructions(
67
+ system="你是一个可靠的企业智能助手。",
68
+ task="",
69
+ ),
70
+ ),
71
+ )
72
+ path = self._agent_file(agent_id)
73
+ if path.exists():
74
+ raise StudioError(
75
+ "AGENT_ALREADY_EXISTS",
76
+ "Agent ID 已存在",
77
+ status_code=409,
78
+ details={"id": agent_id},
79
+ )
80
+ path.parent.mkdir(parents=True, exist_ok=False)
81
+ (path.parent / "instructions").mkdir()
82
+ (path.parent / "evaluations").mkdir()
83
+ self._write(path, draft)
84
+ return draft
85
+
86
+ def list(self, *, query: str = "", limit: int = 50) -> list[AgentDraft]:
87
+ normalized = query.strip().lower()
88
+ results: list[AgentDraft] = []
89
+ agents_dir = self.workspace.resolve("agents")
90
+ for path in sorted(agents_dir.glob("*/agent.yaml")):
91
+ try:
92
+ draft = self._read(path)
93
+ except StudioError:
94
+ continue
95
+ if (
96
+ normalized
97
+ and normalized not in draft.metadata.id.lower()
98
+ and normalized not in (draft.metadata.name.lower())
99
+ ):
100
+ continue
101
+ results.append(draft)
102
+ if len(results) >= limit:
103
+ break
104
+ return results
105
+
106
+ def get(self, agent_id: str) -> AgentDraft:
107
+ path = self._agent_file(agent_id)
108
+ if not path.is_file():
109
+ raise not_found("agent", agent_id)
110
+ return self._read(path)
111
+
112
+ def update(self, agent_id: str, spec: AgentSpec, *, expected_revision: int) -> AgentDraft:
113
+ current = self.get(agent_id)
114
+ if current.metadata.revision != expected_revision:
115
+ raise StudioError(
116
+ "AGENT_REVISION_CONFLICT",
117
+ "Agent 已被其他操作更新",
118
+ status_code=409,
119
+ field="metadata.revision",
120
+ details={
121
+ "expected": expected_revision,
122
+ "actual": current.metadata.revision,
123
+ },
124
+ )
125
+ updated = cast(AgentDraft, current.model_copy(deep=True))
126
+ updated.metadata.revision += 1
127
+ updated.spec = spec
128
+ self._write(self._agent_file(agent_id), updated)
129
+ return updated
130
+
131
+ def update_appearance(
132
+ self,
133
+ agent_id: str,
134
+ appearance: AgentAppearance,
135
+ *,
136
+ expected_revision: int,
137
+ ) -> AgentDraft:
138
+ current = self.get(agent_id)
139
+ if current.metadata.revision != expected_revision:
140
+ raise StudioError(
141
+ "AGENT_REVISION_CONFLICT",
142
+ "Agent 已被其他操作更新",
143
+ status_code=409,
144
+ field="metadata.revision",
145
+ details={"expected": expected_revision, "actual": current.metadata.revision},
146
+ )
147
+ updated = cast(AgentDraft, current.model_copy(deep=True))
148
+ updated.metadata.revision += 1
149
+ updated.metadata.appearance = appearance
150
+ self._write(self._agent_file(agent_id), updated)
151
+ return updated
152
+
153
+ def replace(self, draft: AgentDraft) -> AgentDraft:
154
+ """Persist metadata-only creation state without creating a Revision."""
155
+
156
+ current = self.get(draft.metadata.id)
157
+ if draft.metadata.revision != current.metadata.revision:
158
+ raise StudioError(
159
+ "AGENT_REVISION_CONFLICT",
160
+ "Agent metadata replacement revision mismatch",
161
+ status_code=409,
162
+ )
163
+ self._write(self._agent_file(draft.metadata.id), draft)
164
+ return draft
165
+
166
+ def delete(
167
+ self,
168
+ agent_id: str,
169
+ *,
170
+ purge: bool = False,
171
+ trash_directory: Path | None = None,
172
+ ) -> None:
173
+ agent_dir = self._agent_dir(agent_id)
174
+ if not agent_dir.is_dir():
175
+ raise not_found("agent", agent_id)
176
+ if purge:
177
+ shutil.rmtree(agent_dir)
178
+ return
179
+ if trash_directory is None:
180
+ timestamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
181
+ trash = self.workspace.resolve(Path(".agentkit/trash") / f"{agent_id}-{timestamp}")
182
+ else:
183
+ trash = self.workspace.resolve(trash_directory / "source" / "agents" / agent_id)
184
+ trash.parent.mkdir(parents=True, exist_ok=True)
185
+ shutil.move(str(agent_dir), str(trash))
186
+
187
+ def _read(self, path: Path) -> AgentDraft:
188
+ try:
189
+ payload = yaml.safe_load(path.read_text(encoding="utf-8-sig"))
190
+ return cast(AgentDraft, AgentDraft.model_validate(payload))
191
+ except (OSError, yaml.YAMLError, ValidationError) as exc:
192
+ raise StudioError(
193
+ "AGENT_SCHEMA_INVALID",
194
+ "Agent YAML 无法解析",
195
+ status_code=422,
196
+ details={"path": self.workspace.relative(path), "reason": str(exc)},
197
+ ) from exc
198
+
199
+ def _write(self, path: Path, draft: AgentDraft) -> None:
200
+ self.workspace.atomic_write_yaml(
201
+ path,
202
+ draft.model_dump(by_alias=True, exclude_none=True, mode="json"),
203
+ )
204
+
205
+
206
+ class BuildRepository:
207
+ def __init__(self, workspace: Workspace) -> None:
208
+ self.workspace = workspace
209
+
210
+ def _path(self, build_id: str) -> Path:
211
+ return self.workspace.resolve(Path(".agentkit/builds") / f"{build_id}.json")
212
+
213
+ def save(self, record: BuildRecord) -> BuildRecord:
214
+ payload = record.model_dump(by_alias=True, exclude_none=True, mode="json")
215
+ self.workspace.atomic_write_text(
216
+ self._path(record.id),
217
+ json.dumps(payload, ensure_ascii=False, sort_keys=True, indent=2) + "\n",
218
+ )
219
+ return record
220
+
221
+ def get(self, build_id: str) -> BuildRecord:
222
+ path = self._path(build_id)
223
+ if not path.is_file():
224
+ raise not_found("build", build_id)
225
+ try:
226
+ return cast(
227
+ BuildRecord,
228
+ BuildRecord.model_validate_json(path.read_text(encoding="utf-8")),
229
+ )
230
+ except (OSError, ValidationError) as exc:
231
+ raise StudioError(
232
+ "BUILD_RECORD_INVALID",
233
+ "Build 记录损坏",
234
+ status_code=500,
235
+ details={"id": build_id},
236
+ ) from exc
237
+
238
+ def list_for_agent(self, agent_id: str) -> list[BuildRecord]:
239
+ records: list[BuildRecord] = []
240
+ directory = self.workspace.resolve(".agentkit/builds")
241
+ for path in sorted(directory.glob("build_*.json"), reverse=True):
242
+ try:
243
+ record = BuildRecord.model_validate_json(path.read_text(encoding="utf-8"))
244
+ except (OSError, ValidationError):
245
+ continue
246
+ if record.agent_id == agent_id:
247
+ records.append(record)
248
+ return records
249
+
250
+ def delete_for_agent(
251
+ self,
252
+ agent_id: str,
253
+ *,
254
+ purge: bool,
255
+ trash_directory: Path | None = None,
256
+ ) -> int:
257
+ records = self.list_for_agent(agent_id)
258
+ artifact_directories: set[Path] = set()
259
+ for record in records:
260
+ if record.artifact_path:
261
+ archive = self.workspace.resolve(record.artifact_path)
262
+ artifact_directories.add(archive.parent)
263
+ for directory in artifact_directories:
264
+ if not directory.is_dir():
265
+ continue
266
+ if purge:
267
+ shutil.rmtree(directory)
268
+ else:
269
+ if trash_directory is None:
270
+ raise ValueError("recoverable deletion requires a trash directory")
271
+ destination = self.workspace.resolve(trash_directory / "artifacts" / directory.name)
272
+ destination.parent.mkdir(parents=True, exist_ok=True)
273
+ shutil.move(str(directory), str(destination))
274
+ for record in records:
275
+ path = self._path(record.id)
276
+ if not path.is_file():
277
+ continue
278
+ if purge:
279
+ path.unlink()
280
+ else:
281
+ if trash_directory is None:
282
+ raise ValueError("recoverable deletion requires a trash directory")
283
+ destination = self.workspace.resolve(trash_directory / "builds" / path.name)
284
+ destination.parent.mkdir(parents=True, exist_ok=True)
285
+ shutil.move(str(path), str(destination))
286
+ return len(records)
287
+
288
+
289
+ def load_yaml_file(path: Path) -> dict[str, Any]:
290
+ try:
291
+ payload = yaml.safe_load(path.read_text(encoding="utf-8-sig")) or {}
292
+ except (OSError, yaml.YAMLError) as exc:
293
+ raise StudioError(
294
+ "WORKSPACE_INVALID",
295
+ "YAML 文件无法解析",
296
+ status_code=422,
297
+ details={"path": str(path), "reason": str(exc)},
298
+ ) from exc
299
+ if not isinstance(payload, dict):
300
+ raise StudioError(
301
+ "WORKSPACE_INVALID",
302
+ "YAML 根节点必须是对象",
303
+ status_code=422,
304
+ details={"path": str(path)},
305
+ )
306
+ return cast(dict[str, Any], payload)