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,644 @@
1
+ """Pydantic contracts for local authoring, builds, runs, and deployment."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import re
6
+ from datetime import datetime, timezone
7
+ from enum import Enum
8
+ from typing import Any, Literal
9
+
10
+ from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
11
+
12
+
13
+ def _to_camel(value: str) -> str:
14
+ head, *tail = value.split("_")
15
+ return head + "".join(part.capitalize() for part in tail)
16
+
17
+
18
+ class ContractModel(BaseModel):
19
+ model_config = ConfigDict(
20
+ alias_generator=_to_camel,
21
+ populate_by_name=True,
22
+ extra="forbid",
23
+ use_enum_values=True,
24
+ )
25
+
26
+
27
+ class DiagnosticSeverity(str, Enum):
28
+ INFO = "info"
29
+ WARNING = "warning"
30
+ ERROR = "error"
31
+
32
+
33
+ class Diagnostic(ContractModel):
34
+ severity: DiagnosticSeverity
35
+ code: str
36
+ message: str
37
+ field: str | None = None
38
+ hint: str | None = None
39
+
40
+
41
+ class Instructions(ContractModel):
42
+ system: str = Field(default="", max_length=32768)
43
+ task: str = Field(default="", max_length=32768)
44
+
45
+
46
+ class ModelParameters(ContractModel):
47
+ temperature: float = Field(default=0.2, ge=0, le=2)
48
+ max_tokens: int = Field(default=2048, ge=1, le=131072)
49
+ top_p: float | None = Field(default=None, gt=0, le=1)
50
+
51
+
52
+ class ModelSpec(ContractModel):
53
+ provider: str = Field(default="openai-compatible", min_length=1, max_length=64)
54
+ model: str = Field(min_length=1, max_length=256)
55
+ endpoint_url: str | None = None
56
+ base_url: str | None = None
57
+ wire_api: Literal["chat", "responses"] | None = None
58
+ credential_ref: str = Field(min_length=1, max_length=512)
59
+ parameters: ModelParameters = Field(default_factory=ModelParameters)
60
+ metadata: dict[str, Any] = Field(default_factory=dict)
61
+ discovery: dict[str, Any] = Field(default_factory=dict)
62
+
63
+ @model_validator(mode="after")
64
+ def validate_address(self) -> "ModelSpec":
65
+ if bool(self.endpoint_url) == bool(self.base_url):
66
+ raise ValueError("endpointUrl 和 baseUrl 必须且只能配置一个")
67
+ return self
68
+
69
+
70
+ class CapabilityRef(ContractModel):
71
+ name: str = Field(min_length=1, max_length=128)
72
+ version: str = Field(min_length=1, max_length=64)
73
+ digest: str | None = None
74
+ enabled: bool = True
75
+
76
+
77
+ class MCPServerRef(CapabilityRef):
78
+ transport: Literal["stdio", "http", "sse"] = "stdio"
79
+ command: str | None = None
80
+ args: list[str] = Field(default_factory=list)
81
+ endpoint_url: str | None = None
82
+ env_refs: dict[str, str] = Field(default_factory=dict)
83
+
84
+ @model_validator(mode="after")
85
+ def validate_transport(self) -> "MCPServerRef":
86
+ if self.transport == "stdio" and not self.command:
87
+ raise ValueError("stdio MCP 必须配置 command")
88
+ if self.transport in {"http", "sse"} and not self.endpoint_url:
89
+ raise ValueError("HTTP/SSE MCP 必须配置 endpointUrl")
90
+ return self
91
+
92
+
93
+ class ToolContract(ContractModel):
94
+ name: str = Field(min_length=1, max_length=128)
95
+ version: str = Field(min_length=1, max_length=64)
96
+ description: str = Field(default="", max_length=1024)
97
+ input_schema: dict[str, Any] = Field(
98
+ default_factory=lambda: {"type": "object", "properties": {}}
99
+ )
100
+ output_schema: dict[str, Any] = Field(
101
+ default_factory=lambda: {"type": "object", "properties": {}}
102
+ )
103
+ permissions: list[str] = Field(default_factory=list)
104
+ timeout_seconds: int = Field(default=20, ge=1, le=3600)
105
+ side_effect: Literal["none", "read", "write", "external"] = "none"
106
+ approval: Literal["never", "always", "policy"] = "never"
107
+ executor: Literal["builtin", "mcp", "deferred", "python"] = "builtin"
108
+ mcp_server: str | None = None
109
+ source_path: str | None = Field(default=None, min_length=1, max_length=1024)
110
+ callable_name: str | None = Field(default=None, min_length=1, max_length=256)
111
+ source_sha256: str | None = None
112
+ digest: str | None = None
113
+ group: str | None = None
114
+ risk_level: str | None = None
115
+ boundary: str | None = None
116
+ backend: str | None = None
117
+ enabled: bool = True
118
+
119
+ @model_validator(mode="after")
120
+ def validate_executor(self) -> "ToolContract":
121
+ if self.executor == "mcp" and not self.mcp_server:
122
+ raise ValueError("MCP Tool 必须配置 mcpServer")
123
+ if self.executor != "mcp" and self.mcp_server:
124
+ raise ValueError("只有 MCP Tool 可以配置 mcpServer")
125
+ if self.executor == "python":
126
+ if not self.source_path or not self.callable_name:
127
+ raise ValueError("Python Tool 必须配置 sourcePath 和 callableName")
128
+ normalized = self.source_path.strip().replace("\\", "/")
129
+ if (
130
+ normalized.startswith("/")
131
+ or normalized == ".."
132
+ or normalized.startswith("../")
133
+ or "/../" in normalized
134
+ ):
135
+ raise ValueError("Python Tool sourcePath 必须位于工作区内")
136
+ self.source_path = normalized
137
+ elif self.source_path or self.callable_name or self.source_sha256:
138
+ raise ValueError("只有 Python Tool 可以配置源码字段")
139
+ return self
140
+
141
+
142
+ class ResourceDescriptor(ContractModel):
143
+ resource_id: str = Field(min_length=3, max_length=256)
144
+ kind: Literal["model", "tool", "mcp", "skill"]
145
+ name: str = Field(min_length=1, max_length=128)
146
+ display_name: str = Field(min_length=1, max_length=128)
147
+ version: str = Field(min_length=1, max_length=64)
148
+ digest: str
149
+ source: Literal["builtin", "provider", "local", "market"] = "local"
150
+ status: Literal[
151
+ "ready",
152
+ "unhealthy",
153
+ "invalid",
154
+ "missing-secret",
155
+ "unresolved",
156
+ ] = "ready"
157
+ description: str = Field(default="", max_length=4096)
158
+ category: str = Field(default="general", max_length=64)
159
+ installed: bool = True
160
+ required_secret_refs: list[str] = Field(default_factory=list)
161
+ contract: dict[str, Any] = Field(default_factory=dict)
162
+ health: dict[str, Any] = Field(default_factory=dict)
163
+ created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
164
+ updated_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
165
+
166
+
167
+ class CapabilityBinding(ContractModel):
168
+ resource_id: str = Field(min_length=3, max_length=256)
169
+ enabled: bool = True
170
+ approval: Literal["never", "always", "policy"] | None = None
171
+ config: dict[str, Any] = Field(default_factory=dict)
172
+
173
+
174
+ class AgentBindings(ContractModel):
175
+ model_profile_id: str | None = None
176
+ model_profile_ids: list[str] = Field(default_factory=list)
177
+ model_parameters: ModelParameters | None = None
178
+ policy_template: Literal["loose", "strict", "custom"] = "strict"
179
+ tools: list[CapabilityBinding] = Field(default_factory=list)
180
+ mcp_servers: list[CapabilityBinding] = Field(default_factory=list)
181
+ skills: list[CapabilityBinding] = Field(default_factory=list)
182
+
183
+ @model_validator(mode="after")
184
+ def validate_model_profiles(self) -> "AgentBindings":
185
+ if len(set(self.model_profile_ids)) != len(self.model_profile_ids):
186
+ raise ValueError("modelProfileIds 不能包含重复资源")
187
+ if self.model_profile_ids and not self.model_profile_id:
188
+ raise ValueError("绑定多个模型时必须指定默认 modelProfileId")
189
+ if (
190
+ self.model_profile_id
191
+ and self.model_profile_ids
192
+ and self.model_profile_id not in self.model_profile_ids
193
+ ):
194
+ raise ValueError("默认 modelProfileId 必须包含在 modelProfileIds 中")
195
+ return self
196
+
197
+
198
+ class CapabilitiesSpec(ContractModel):
199
+ skills: list[CapabilityRef] = Field(default_factory=list)
200
+ mcp_servers: list[MCPServerRef] = Field(default_factory=list)
201
+ tools: list[ToolContract] = Field(default_factory=list)
202
+
203
+
204
+ class RetryPolicy(ContractModel):
205
+ max_attempts: int = Field(default=2, ge=1, le=10)
206
+ backoff_seconds: float = Field(default=1, ge=0, le=60)
207
+
208
+
209
+ class ExecutionSpec(ContractModel):
210
+ strategy: Literal["direct", "plan-act-observe"] = "direct"
211
+ max_steps: int = Field(default=12, ge=1, le=100)
212
+ timeout_seconds: int = Field(default=120, ge=1, le=3600)
213
+ retry: RetryPolicy = Field(default_factory=RetryPolicy)
214
+ sandbox: str | None = None
215
+ approval_mode: str | None = None
216
+
217
+
218
+ class CompactionSpec(ContractModel):
219
+ enabled: bool = True
220
+ threshold_ratio: float = Field(default=0.8, gt=0, le=1)
221
+
222
+
223
+ class ContextSpec(ContractModel):
224
+ max_input_tokens: int = Field(default=32000, ge=1024)
225
+ reserve_output_tokens: int = Field(default=4096, ge=1)
226
+ compaction: CompactionSpec = Field(default_factory=CompactionSpec)
227
+
228
+ @model_validator(mode="after")
229
+ def validate_budget(self) -> "ContextSpec":
230
+ if self.reserve_output_tokens >= self.max_input_tokens:
231
+ raise ValueError("reserveOutputTokens 必须小于 maxInputTokens")
232
+ return self
233
+
234
+
235
+ class NetworkPolicy(ContractModel):
236
+ mode: Literal["restricted", "open"] = "restricted"
237
+ allowed_hosts: list[str] = Field(default_factory=list)
238
+ allow_private_network: bool = False
239
+
240
+
241
+ class SecuritySpec(ContractModel):
242
+ tool_policy: Literal["deny-by-default", "allow-listed"] = "deny-by-default"
243
+ allowed_permissions: list[str] = Field(default_factory=list)
244
+ network: NetworkPolicy = Field(default_factory=NetworkPolicy)
245
+
246
+
247
+ class EvaluationSpec(ContractModel):
248
+ suite_refs: list[str] = Field(default_factory=list)
249
+ minimum_pass_rate: float = Field(default=1, ge=0, le=1)
250
+
251
+
252
+ class RuntimeRef(ContractModel):
253
+ """Per-Agent reference to one registered RuntimeAdapter implementation.
254
+
255
+ Studio is a control plane and therefore must not have a process-wide runtime
256
+ mode. Each Agent declares the adapter type and, for Python frameworks, the
257
+ project entrypoint that is snapshotted by its Build.
258
+ """
259
+
260
+ type: Literal["codex", "adk", "langgraph"]
261
+ project_path: str | None = Field(default=None, min_length=1, max_length=1024)
262
+ entry_point: str | None = Field(default=None, min_length=1, max_length=1024)
263
+ agent_variable: str = Field(default="root_agent", min_length=1, max_length=256)
264
+ version: str | None = Field(default=None, min_length=1, max_length=64)
265
+ detection: Literal["declared", "auto"] = "declared"
266
+
267
+ @field_validator("project_path", "entry_point")
268
+ @classmethod
269
+ def validate_relative_path(cls, value: str | None) -> str | None:
270
+ if value is None:
271
+ return None
272
+ normalized = value.strip().replace("\\", "/")
273
+ if (
274
+ not normalized
275
+ or normalized.startswith("/")
276
+ or normalized == ".."
277
+ or normalized.startswith("../")
278
+ or "/../" in normalized
279
+ ):
280
+ raise ValueError("Runtime 路径必须是工作区内的相对路径")
281
+ return normalized
282
+
283
+ @model_validator(mode="after")
284
+ def validate_framework_source(self) -> "RuntimeRef":
285
+ if self.type in {"adk", "langgraph"}:
286
+ if not self.project_path:
287
+ raise ValueError(f"{self.type} Runtime 必须配置 projectPath")
288
+ if self.detection == "declared" and not self.entry_point:
289
+ raise ValueError(f"{self.type} Runtime 使用 declared 检测时必须配置 entryPoint")
290
+ return self
291
+
292
+
293
+ class AgentSpec(ContractModel):
294
+ description: str = Field(default="", max_length=1024)
295
+ runtime: RuntimeRef | None = None
296
+ instructions: Instructions = Field(default_factory=Instructions)
297
+ model: ModelSpec | None = None
298
+ capabilities: CapabilitiesSpec = Field(default_factory=CapabilitiesSpec)
299
+ bindings: AgentBindings = Field(default_factory=AgentBindings)
300
+ execution: ExecutionSpec = Field(default_factory=ExecutionSpec)
301
+ context: ContextSpec = Field(default_factory=ContextSpec)
302
+ security: SecuritySpec = Field(default_factory=SecuritySpec)
303
+ evaluation: EvaluationSpec = Field(default_factory=EvaluationSpec)
304
+
305
+
306
+ _AGENT_ID_PATTERN = re.compile(r"^[a-z][a-z0-9-]{2,62}$")
307
+ _AGENT_AVATAR_URL_PATTERN = re.compile(r"^/api/v1/assets/agent-avatars/[0-9a-f]{64}\.(?:png|webp)$")
308
+
309
+
310
+ class AgentAppearance(ContractModel):
311
+ icon: Literal["bot", "sparkles", "search", "code", "workflow"] = "bot"
312
+ color: str = Field(default="#426ea8", pattern=r"^#[0-9a-fA-F]{6}$")
313
+ image_url: str | None = Field(default=None, max_length=160)
314
+
315
+ @field_validator("color")
316
+ @classmethod
317
+ def normalize_color(cls, value: str) -> str:
318
+ return value.lower()
319
+
320
+ @field_validator("image_url")
321
+ @classmethod
322
+ def validate_image_url(cls, value: str | None) -> str | None:
323
+ if value is not None and not _AGENT_AVATAR_URL_PATTERN.fullmatch(value):
324
+ raise ValueError("imageUrl 必须引用当前工作区的内容寻址头像资源")
325
+ return value
326
+
327
+
328
+ class AgentMetadata(ContractModel):
329
+ id: str
330
+ name: str = Field(min_length=1, max_length=128)
331
+ revision: int = Field(default=1, ge=1)
332
+ labels: dict[str, str] = Field(default_factory=dict)
333
+ appearance: AgentAppearance = Field(default_factory=AgentAppearance)
334
+
335
+ @field_validator("id")
336
+ @classmethod
337
+ def validate_agent_id(cls, value: str) -> str:
338
+ if not _AGENT_ID_PATTERN.fullmatch(value):
339
+ raise ValueError("id 必须以小写字母开头,仅包含小写字母、数字和连字符,长度 3..63")
340
+ return value
341
+
342
+
343
+ class AgentDraft(ContractModel):
344
+ api_version: Literal["agentkit.ksyun.com/v1alpha1"] = "agentkit.ksyun.com/v1alpha1"
345
+ kind: Literal["Agent"] = "Agent"
346
+ metadata: AgentMetadata
347
+ spec: AgentSpec = Field(default_factory=AgentSpec)
348
+
349
+
350
+ class AgentTemplateComposeRequest(ContractModel):
351
+ prompt: str = Field(default="", max_length=32768)
352
+ goal: str = Field(default="", max_length=4096)
353
+ description: str = Field(default="", max_length=1024)
354
+ task_prompt: str = Field(default="", max_length=32768)
355
+ audience: str = Field(default="技术与业务决策者", min_length=1, max_length=256)
356
+ language: Literal["zh-CN", "en-US"] = "zh-CN"
357
+ depth: Literal["focused", "standard", "deep"] = "deep"
358
+ output_format: Literal["brief", "report", "evidence-table"] = "report"
359
+ model_profile_id: str | None = None
360
+ model_profile_ids: list[str] = Field(default_factory=list)
361
+ tool_resource_ids: list[str] = Field(default_factory=list)
362
+ skill_resource_ids: list[str] = Field(default_factory=list)
363
+ mcp_resource_ids: list[str] = Field(default_factory=list)
364
+ policy_template: Literal["loose", "strict", "custom"] = "strict"
365
+ execution_strategy: Literal["direct", "plan-act-observe"] = "direct"
366
+ max_steps: int = Field(default=12, ge=1, le=100)
367
+ timeout_seconds: int = Field(default=120, ge=1, le=3600)
368
+ auto_bind_tools: bool = True
369
+ auto_bind_mcp: bool = True
370
+
371
+ @model_validator(mode="after")
372
+ def validate_authoring_prompt(self) -> "AgentTemplateComposeRequest":
373
+ if not self.prompt.strip() and not self.goal.strip():
374
+ raise ValueError("prompt 和 goal 至少填写一项")
375
+ return self
376
+
377
+
378
+ class AgentTemplateRecommendation(ContractModel):
379
+ kind: Literal["model", "tool", "mcp", "skill"]
380
+ status: Literal["bound", "available", "missing", "warning"]
381
+ title: str
382
+ reason: str
383
+ resource_id: str | None = None
384
+
385
+
386
+ class AgentTemplateComposition(ContractModel):
387
+ template_id: Literal["blank", "research"]
388
+ spec: AgentSpec
389
+ recommendations: list[AgentTemplateRecommendation] = Field(default_factory=list)
390
+ warnings: list[str] = Field(default_factory=list)
391
+
392
+
393
+ class ResolvedModel(ContractModel):
394
+ provider: str
395
+ model: str
396
+ endpoint_url: str
397
+ credential_ref: str
398
+ parameters: ModelParameters
399
+ wire_api: str | None = None
400
+
401
+
402
+ class ResolvedCapabilities(ContractModel):
403
+ skills: list[dict[str, Any]] = Field(default_factory=list)
404
+ mcp_servers: list[dict[str, Any]] = Field(default_factory=list)
405
+ tools: list[ToolContract] = Field(default_factory=list)
406
+
407
+
408
+ class ResolvedAgentSpec(ContractModel):
409
+ schema_version: Literal["agentkit.resolved/v1"] = "agentkit.resolved/v1"
410
+ agent_id: str
411
+ source_revision: int
412
+ compiler_version: str = "1"
413
+ instructions: Instructions
414
+ model: ResolvedModel
415
+ capabilities: ResolvedCapabilities
416
+ execution: ExecutionSpec
417
+ context: ContextSpec
418
+ security: SecuritySpec
419
+ evaluation: EvaluationSpec
420
+ source_digest: str
421
+ resolved_digest: str = ""
422
+
423
+
424
+ class ValidationResult(ContractModel):
425
+ valid: bool
426
+ level: Literal["schema", "build", "release"] = "build"
427
+ diagnostics: list[Diagnostic] = Field(default_factory=list)
428
+
429
+
430
+ class BuildStatus(str, Enum):
431
+ QUEUED = "QUEUED"
432
+ VALIDATING = "VALIDATING"
433
+ RESOLVING = "RESOLVING"
434
+ COMPILING = "COMPILING"
435
+ PACKAGING = "PACKAGING"
436
+ SUCCEEDED = "SUCCEEDED"
437
+ FAILED = "FAILED"
438
+ CANCELLED = "CANCELLED"
439
+ INTERRUPTED = "INTERRUPTED"
440
+
441
+
442
+ class FileEntry(ContractModel):
443
+ path: str
444
+ sha256: str
445
+ size: int = Field(ge=0)
446
+
447
+
448
+ class BundleManifest(ContractModel):
449
+ bundle_format: Literal["agentkit.bundle/v1"] = "agentkit.bundle/v1"
450
+ agent_id: str
451
+ source_revision: int
452
+ resolved_digest: str
453
+ runtime_type: str = ""
454
+ source_digest: str = ""
455
+ runtime_contract: Literal["agentkit.runtime/v1"] = "agentkit.runtime/v1"
456
+ files: list[FileEntry]
457
+ created_at: str = "1970-01-01T00:00:00Z"
458
+ bundle_digest: str = ""
459
+
460
+
461
+ class BuildRecord(ContractModel):
462
+ id: str
463
+ agent_id: str
464
+ source_revision: int
465
+ status: BuildStatus
466
+ resolved_digest: str = ""
467
+ runtime_type: str = ""
468
+ source_digest: str = ""
469
+ runtime_lock: dict[str, Any] = Field(default_factory=dict)
470
+ bundle_digest: str = ""
471
+ artifact_path: str | None = None
472
+ diagnostics: list[Diagnostic] = Field(default_factory=list)
473
+ created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
474
+ completed_at: datetime | None = None
475
+
476
+
477
+ class OperationKind(str, Enum):
478
+ BUILD = "BUILD"
479
+ RUN = "RUN"
480
+ EVALUATION = "EVALUATION"
481
+ DEPLOYMENT = "DEPLOYMENT"
482
+
483
+
484
+ class OperationStatus(str, Enum):
485
+ QUEUED = "QUEUED"
486
+ RUNNING = "RUNNING"
487
+ SUCCEEDED = "SUCCEEDED"
488
+ FAILED = "FAILED"
489
+ CANCELLED = "CANCELLED"
490
+ INTERRUPTED = "INTERRUPTED"
491
+
492
+
493
+ class Operation(ContractModel):
494
+ id: str
495
+ kind: OperationKind
496
+ status: OperationStatus = OperationStatus.QUEUED
497
+ resource_id: str
498
+ error: dict[str, Any] | None = None
499
+ created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
500
+ completed_at: datetime | None = None
501
+
502
+
503
+ class OperationEvent(ContractModel):
504
+ id: int = Field(ge=1)
505
+ operation_id: str
506
+ type: str
507
+ data: dict[str, Any] = Field(default_factory=dict)
508
+ created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
509
+
510
+
511
+ class RunStatus(str, Enum):
512
+ CREATED = "CREATED"
513
+ RUNNING = "RUNNING"
514
+ PAUSED = "PAUSED"
515
+ WAITING_INPUT = "WAITING_INPUT"
516
+ COMPLETED = "COMPLETED"
517
+ FAILED = "FAILED"
518
+ CANCELLED = "CANCELLED"
519
+ INTERRUPTED = "INTERRUPTED"
520
+ TIMED_OUT = "TIMED_OUT"
521
+
522
+
523
+ class Usage(ContractModel):
524
+ input_tokens: int = Field(default=0, ge=0)
525
+ output_tokens: int = Field(default=0, ge=0)
526
+ total_tokens: int = Field(default=0, ge=0)
527
+ cached_input_tokens: int = Field(default=0, ge=0)
528
+ reasoning_output_tokens: int = Field(default=0, ge=0)
529
+ reported: bool = False
530
+ source: str | None = None
531
+
532
+
533
+ class RunRecord(ContractModel):
534
+ id: str
535
+ build_id: str
536
+ agent_id: str
537
+ session_id: str
538
+ trace_id: str
539
+ manifest_sha256: str = ""
540
+ runtime_type: str = ""
541
+ model: str = ""
542
+ collaboration_mode: str = ""
543
+ goal_objective: str = ""
544
+ runtime_handle: dict[str, Any] = Field(default_factory=dict)
545
+ status: RunStatus = RunStatus.CREATED
546
+ input: str
547
+ output: str = ""
548
+ usage: Usage = Field(default_factory=Usage)
549
+ error: dict[str, Any] | None = None
550
+ started_at: datetime | None = None
551
+ completed_at: datetime | None = None
552
+ duration_ms: int | None = None
553
+ duration_source: Literal["runtime", "studio"] | None = None
554
+
555
+
556
+ class RunEvent(ContractModel):
557
+ id: int = Field(ge=1)
558
+ run_id: str
559
+ type: str
560
+ data: dict[str, Any] = Field(default_factory=dict)
561
+ created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
562
+
563
+
564
+ class AssertionSpec(ContractModel):
565
+ type: Literal[
566
+ "contains",
567
+ "equals",
568
+ "notContains",
569
+ "jsonSchema",
570
+ "maxLatencyMs",
571
+ "maxInputTokens",
572
+ "maxOutputTokens",
573
+ "toolCalled",
574
+ "toolNotCalled",
575
+ ]
576
+ value: Any
577
+
578
+
579
+ class EvaluationCase(ContractModel):
580
+ id: str = Field(min_length=1, max_length=128)
581
+ input: str
582
+ assertions: list[AssertionSpec] = Field(min_length=1)
583
+
584
+
585
+ class EvaluationSuite(ContractModel):
586
+ api_version: Literal["agentkit.ksyun.com/v1alpha1"] = "agentkit.ksyun.com/v1alpha1"
587
+ kind: Literal["EvaluationSuite"] = "EvaluationSuite"
588
+ metadata: dict[str, Any]
589
+ cases: list[EvaluationCase] = Field(min_length=1)
590
+
591
+
592
+ class AssertionResult(ContractModel):
593
+ assertion: AssertionSpec
594
+ passed: bool
595
+ message: str = ""
596
+
597
+
598
+ class EvaluationCaseResult(ContractModel):
599
+ case_id: str
600
+ run_id: str
601
+ passed: bool
602
+ assertions: list[AssertionResult]
603
+
604
+
605
+ class EvaluationRun(ContractModel):
606
+ id: str
607
+ build_id: str
608
+ status: RunStatus = RunStatus.CREATED
609
+ total: int = 0
610
+ passed: int = 0
611
+ failed: int = 0
612
+ pass_rate: float = 0
613
+ results: list[EvaluationCaseResult] = Field(default_factory=list)
614
+
615
+
616
+ class DeploymentTarget(ContractModel):
617
+ region: str = Field(min_length=1, max_length=64)
618
+ environment: str = Field(min_length=1, max_length=64)
619
+
620
+
621
+ class EnvironmentBinding(ContractModel):
622
+ model: dict[str, str] = Field(default_factory=dict)
623
+ secrets: dict[str, str] = Field(default_factory=dict)
624
+ mcp_servers: dict[str, str] = Field(default_factory=dict)
625
+
626
+
627
+ class ReleasePolicy(ContractModel):
628
+ strategy: Literal["rolling", "recreate"] = "rolling"
629
+ approval: Literal["none", "manual"] = "none"
630
+
631
+
632
+ class DeploymentRequest(ContractModel):
633
+ target: DeploymentTarget
634
+ binding: EnvironmentBinding = Field(default_factory=EnvironmentBinding)
635
+ release_policy: ReleasePolicy = Field(default_factory=ReleasePolicy)
636
+
637
+
638
+ class DeploymentRecord(ContractModel):
639
+ id: str
640
+ build_id: str
641
+ bundle_digest: str
642
+ version_id: str
643
+ status: Literal["ADMITTING", "DEPLOYING", "READY", "FAILED", "ROLLED_BACK"]
644
+ target: DeploymentTarget
ksadk/studio/errors.py ADDED
@@ -0,0 +1,47 @@
1
+ """Stable errors shared by the Studio service and HTTP API."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+
7
+
8
+ class StudioError(Exception):
9
+ """A user-safe error with a stable machine-readable code."""
10
+
11
+ def __init__(
12
+ self,
13
+ code: str,
14
+ message: str,
15
+ *,
16
+ status_code: int = 400,
17
+ field: str | None = None,
18
+ details: dict[str, Any] | None = None,
19
+ ) -> None:
20
+ super().__init__(message)
21
+ self.code = code
22
+ self.message = message
23
+ self.status_code = status_code
24
+ self.field = field
25
+ self.details = details or {}
26
+
27
+ def as_dict(self, *, request_id: str | None = None) -> dict[str, Any]:
28
+ payload: dict[str, Any] = {
29
+ "code": self.code,
30
+ "message": self.message,
31
+ }
32
+ if self.field:
33
+ payload["field"] = self.field
34
+ if self.details:
35
+ payload["details"] = self.details
36
+ if request_id:
37
+ payload["requestId"] = request_id
38
+ return {"error": payload}
39
+
40
+
41
+ def not_found(resource: str, resource_id: str) -> StudioError:
42
+ return StudioError(
43
+ f"{resource.upper()}_NOT_FOUND",
44
+ f"{resource} 不存在",
45
+ status_code=404,
46
+ details={"id": resource_id},
47
+ )