agentengine-sdk-python 0.7.0__py3-none-any.whl → 0.8.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (450) hide show
  1. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/METADATA +52 -20
  2. agentengine_sdk_python-0.8.1.dist-info/RECORD +644 -0
  3. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/WHEEL +1 -1
  4. ksadk/a2a/__init__.py +180 -11
  5. ksadk/a2a/bootstrap.py +332 -0
  6. ksadk/a2a/card.py +15 -0
  7. ksadk/a2a/context_store.py +203 -0
  8. ksadk/a2a/control_plane.py +1056 -0
  9. ksadk/a2a/credential.py +99 -0
  10. ksadk/a2a/event_adapter.py +149 -0
  11. ksadk/a2a/executor.py +361 -137
  12. ksadk/a2a/external_transport.py +516 -0
  13. ksadk/a2a/identity.py +304 -0
  14. ksadk/a2a/ids.py +22 -0
  15. ksadk/a2a/langgraph.py +285 -0
  16. ksadk/a2a/resume_store.py +201 -0
  17. ksadk/a2a/routes.py +112 -0
  18. ksadk/a2a/server.py +102 -62
  19. ksadk/a2a/service_env.py +33 -0
  20. ksadk/a2a/space_client.py +1122 -0
  21. ksadk/a2a/task_adapter.py +423 -0
  22. ksadk/a2a/task_event_dispatcher.py +167 -0
  23. ksadk/a2a/task_event_outbox.py +326 -0
  24. ksadk/a2a/task_store.py +206 -0
  25. ksadk/a2a_card.py +101 -0
  26. ksadk/a2ui/__init__.py +27 -0
  27. ksadk/a2ui/core.py +186 -0
  28. ksadk/a2ui/models.py +166 -0
  29. ksadk/a2ui/renderer.py +198 -0
  30. ksadk/agui/__init__.py +9 -0
  31. ksadk/agui/a2ui_projection.py +92 -0
  32. ksadk/agui/agent.py +872 -0
  33. ksadk/agui/config.py +92 -0
  34. ksadk/agui/routes.py +47 -0
  35. ksadk/api/client.py +238 -204
  36. ksadk/api/environment.py +27 -0
  37. ksadk/builders/__init__.py +2 -0
  38. ksadk/builders/base.py +16 -14
  39. ksadk/builders/code_builder.py +375 -270
  40. ksadk/builders/container_builder.py +240 -200
  41. ksadk/builders/framework_requirements.py +31 -12
  42. ksadk/builders/ks3_uploader.py +60 -29
  43. ksadk/builders/managed_runtime_builder.py +173 -0
  44. ksadk/builders/mcp_builder.py +91 -92
  45. ksadk/builders/requirements_utils.py +1 -5
  46. ksadk/cli/__init__.py +97 -171
  47. ksadk/cli/cmd_a2a.py +255 -84
  48. ksadk/cli/cmd_agent.py +19 -5
  49. ksadk/cli/cmd_build.py +158 -29
  50. ksadk/cli/cmd_completion.py +47 -35
  51. ksadk/cli/cmd_config.py +267 -198
  52. ksadk/cli/cmd_create.py +507 -740
  53. ksadk/cli/cmd_dashboard.py +120 -45
  54. ksadk/cli/cmd_deploy.py +135 -59
  55. ksadk/cli/cmd_destroy.py +44 -14
  56. ksadk/cli/cmd_eval.py +386 -0
  57. ksadk/cli/cmd_files.py +63 -24
  58. ksadk/cli/cmd_hermes.py +313 -135
  59. ksadk/cli/cmd_invoke.py +184 -122
  60. ksadk/cli/cmd_launch.py +76 -28
  61. ksadk/cli/cmd_mcp.py +98 -64
  62. ksadk/cli/cmd_model.py +14 -5
  63. ksadk/cli/cmd_openclaw.py +564 -268
  64. ksadk/cli/cmd_replay.py +71 -0
  65. ksadk/cli/cmd_run.py +58 -73
  66. ksadk/cli/cmd_status.py +80 -31
  67. ksadk/cli/cmd_studio.py +110 -0
  68. ksadk/cli/cmd_version.py +20 -13
  69. ksadk/cli/cmd_web.py +95 -18
  70. ksadk/cli/deploy_utils.py +20 -20
  71. ksadk/cli/dry_run.py +7 -4
  72. ksadk/cli/env_options.py +83 -0
  73. ksadk/cli/error_utils.py +37 -12
  74. ksadk/cli/global_options.py +4 -3
  75. ksadk/cli/local_runtime.py +1 -2
  76. ksadk/cli/model_catalog.py +6 -2
  77. ksadk/cli/network_options.py +41 -19
  78. ksadk/cli/resource_common.py +6 -2
  79. ksadk/cli/runtime_bootstrap.py +51 -0
  80. ksadk/cli/storage.py +0 -1
  81. ksadk/cli/ui.py +11 -3
  82. ksadk/cli/workflow_common.py +52 -18
  83. ksadk/codex/__init__.py +12 -0
  84. ksadk/codex/client.py +1042 -0
  85. ksadk/codex/phase.py +143 -0
  86. ksadk/codex/runtime.py +940 -0
  87. ksadk/common/aicp_env.py +0 -1
  88. ksadk/common/auth.py +2 -2
  89. ksadk/common/constants.py +1 -3
  90. ksadk/common/kop_client.py +232 -0
  91. ksadk/common/llm_utils.py +17 -13
  92. ksadk/compat/__init__.py +5 -0
  93. ksadk/compat/adk_compat.py +200 -0
  94. ksadk/compat/copilotkit_a2ui.py +330 -0
  95. ksadk/configs/__init__.py +12 -14
  96. ksadk/configs/env_registry.py +661 -116
  97. ksadk/configs/global_config.py +3 -2
  98. ksadk/configs/settings.py +133 -209
  99. ksadk/conversations/__init__.py +85 -92
  100. ksadk/conversations/attachment_storage.py +16 -11
  101. ksadk/conversations/attachments.py +44 -36
  102. ksadk/conversations/compaction_pipeline.py +12 -12
  103. ksadk/conversations/compaction_prompt.py +9 -5
  104. ksadk/conversations/context.py +221 -6
  105. ksadk/conversations/message_projection.py +438 -51
  106. ksadk/conversations/model_context.py +12 -6
  107. ksadk/conversations/model_options.py +0 -1
  108. ksadk/conversations/normalize.py +20 -16
  109. ksadk/conversations/reasoning_markup.py +1 -1
  110. ksadk/conversations/runtime.py +339 -5255
  111. ksadk/conversations/runtime_compaction.py +333 -0
  112. ksadk/conversations/runtime_constants.py +27 -0
  113. ksadk/conversations/runtime_governance.py +185 -0
  114. ksadk/conversations/runtime_input.py +660 -0
  115. ksadk/conversations/runtime_invocation.py +395 -0
  116. ksadk/conversations/runtime_metadata.py +475 -0
  117. ksadk/conversations/runtime_observability.py +367 -0
  118. ksadk/conversations/runtime_payloads.py +272 -0
  119. ksadk/conversations/runtime_persistence.py +440 -0
  120. ksadk/conversations/runtime_preparation.py +426 -0
  121. ksadk/conversations/runtime_resume.py +836 -0
  122. ksadk/conversations/runtime_stream_events.py +902 -0
  123. ksadk/conversations/runtime_streaming.py +700 -0
  124. ksadk/conversations/semantic_summary.py +17 -5
  125. ksadk/conversations/session_title.py +6 -3
  126. ksadk/deployment/__init__.py +15 -16
  127. ksadk/deployment/agent_access.py +12 -23
  128. ksadk/deployment/base.py +51 -38
  129. ksadk/deployment/managed_runtime.py +33 -0
  130. ksadk/deployment/manager.py +85 -71
  131. ksadk/deployment/providers/serverless.py +379 -210
  132. ksadk/deployment/registry.py +38 -32
  133. ksadk/deployment/state.py +11 -11
  134. ksadk/deployment/ui_config.py +1 -1
  135. ksadk/detection/__init__.py +1 -1
  136. ksadk/detection/detector.py +146 -83
  137. ksadk/detection/mcp_detector.py +9 -6
  138. ksadk/evaluation/__init__.py +84 -0
  139. ksadk/evaluation/a2a_adapter.py +444 -0
  140. ksadk/evaluation/adapters.py +54 -0
  141. ksadk/evaluation/contracts.py +409 -0
  142. ksadk/evaluation/evalset.py +351 -0
  143. ksadk/evaluation/evaluators.py +461 -0
  144. ksadk/evaluation/executor.py +118 -0
  145. ksadk/evaluation/storage.py +68 -0
  146. ksadk/evaluation/target.py +73 -0
  147. ksadk/events/__init__.py +25 -0
  148. ksadk/events/parser.py +191 -0
  149. ksadk/events/replay.py +37 -0
  150. ksadk/events/runtime_event.py +273 -0
  151. ksadk/events/store.py +317 -0
  152. ksadk/harness/__init__.py +35 -0
  153. ksadk/harness/app.py +269 -0
  154. ksadk/harness/config.py +181 -0
  155. ksadk/harness/reasoner.py +105 -0
  156. ksadk/harness/runtime.py +364 -0
  157. ksadk/harness/sandbox.py +141 -0
  158. ksadk/harness/tools.py +222 -0
  159. ksadk/hermes_terminal.py +28 -12
  160. ksadk/identity/resolver.py +15 -9
  161. ksadk/ids.py +32 -0
  162. ksadk/knowledge_base/adk_tool.py +1 -1
  163. ksadk/knowledge_base/client.py +38 -33
  164. ksadk/managed_a2a_card.py +160 -0
  165. ksadk/managed_runtime.py +195 -0
  166. ksadk/markdown.py +5 -2
  167. ksadk/mcp_runtime/__init__.py +9 -6
  168. ksadk/memory/__init__.py +1 -1
  169. ksadk/memory/adk/__init__.py +2 -0
  170. ksadk/memory/adk/backends/base_ltm_backend.py +2 -6
  171. ksadk/memory/adk/backends/http_ltm_backend.py +13 -21
  172. ksadk/memory/adk/backends/inmemory_ltm_backend.py +7 -13
  173. ksadk/memory/adk/backends/sdk_ltm_backend.py +36 -36
  174. ksadk/memory/adk/long_term_memory.py +34 -37
  175. ksadk/memory/adk/resilient_session_service.py +4 -5
  176. ksadk/memory/adk/short_term_memory.py +12 -21
  177. ksadk/memory/adk_tool.py +3 -2
  178. ksadk/memory/backends/base.py +19 -19
  179. ksadk/memory/backends/memory.py +24 -25
  180. ksadk/memory/backends/redis.py +31 -30
  181. ksadk/memory/langchain_tool.py +2 -1
  182. ksadk/memory/manager.py +52 -47
  183. ksadk/memory/service.py +16 -6
  184. ksadk/memory/tool.py +4 -0
  185. ksadk/model_policy.py +15 -7
  186. ksadk/model_proxy/__init__.py +51 -0
  187. ksadk/model_proxy/bootstrap.py +80 -0
  188. ksadk/model_proxy/cache.py +165 -0
  189. ksadk/model_proxy/config.py +66 -0
  190. ksadk/model_proxy/demo_webui.py +115 -0
  191. ksadk/model_proxy/detect.py +145 -0
  192. ksadk/model_proxy/gate.py +68 -0
  193. ksadk/model_proxy/namespace.py +201 -0
  194. ksadk/model_proxy/protocol_proxy.py +22 -0
  195. ksadk/model_proxy/server.py +443 -0
  196. ksadk/model_proxy/transform.py +735 -0
  197. ksadk/openclaw_gateway.py +29 -14
  198. ksadk/runners/adk_runner.py +354 -146
  199. ksadk/runners/base_runner.py +71 -29
  200. ksadk/runners/deepagents_runner.py +0 -1
  201. ksadk/runners/factory.py +18 -5
  202. ksadk/runners/langchain_runner.py +29 -742
  203. ksadk/runners/langgraph_runner.py +417 -97
  204. ksadk/runners/patch_langchain.py +16 -16
  205. ksadk/runners/remote_runner.py +134 -33
  206. ksadk/runners/usage_accumulator.py +1 -0
  207. ksadk/runners/utils/__init__.py +0 -10
  208. ksadk/runners/utils/loader.py +23 -7
  209. ksadk/runtime/__init__.py +67 -0
  210. ksadk/runtime/adapter.py +412 -0
  211. ksadk/runtime/conversation_execution.py +553 -0
  212. ksadk/runtime/executor.py +251 -0
  213. ksadk/runtime/factory.py +156 -0
  214. ksadk/runtime/framework_adapters.py +118 -0
  215. ksadk/runtime/launch.py +48 -0
  216. ksadk/runtime/preprocessing.py +131 -0
  217. ksadk/runtime/runner_adapter.py +1032 -0
  218. ksadk/runtime/runner_loading.py +36 -0
  219. ksadk/runtime_context.py +18 -3
  220. ksadk/runtime_state.py +0 -1
  221. ksadk/sandbox/__init__.py +4 -1
  222. ksadk/sandbox/backends/__init__.py +4 -1
  223. ksadk/sandbox/backends/e2b.py +13 -5
  224. ksadk/sandbox/backends/local_process.py +11 -3
  225. ksadk/sandbox/base.py +10 -15
  226. ksadk/sandbox/factory.py +14 -4
  227. ksadk/sandbox/registry.py +57 -6
  228. ksadk/server/__init__.py +39 -4
  229. ksadk/server/api_models.py +15 -5
  230. ksadk/server/app.py +24 -3928
  231. ksadk/server/composition.py +47 -0
  232. ksadk/server/factory.py +622 -0
  233. ksadk/server/routes/__init__.py +1 -0
  234. ksadk/server/routes/checkpoint_resolution.py +116 -0
  235. ksadk/server/routes/common.py +682 -0
  236. ksadk/server/routes/control.py +331 -0
  237. ksadk/server/routes/dependencies.py +98 -0
  238. ksadk/server/routes/misc.py +425 -0
  239. ksadk/server/routes/models.py +451 -0
  240. ksadk/server/routes/openai_compat.py +229 -0
  241. ksadk/server/routes/projection.py +848 -0
  242. ksadk/server/routes/routers.py +52 -0
  243. ksadk/server/routes/run.py +519 -0
  244. ksadk/server/routes/sessions.py +644 -0
  245. ksadk/server/routes/streaming.py +265 -0
  246. ksadk/server/routes/workspace.py +414 -0
  247. ksadk/server/static/assets/{ArtifactsPanel-D-SSn2ee.js → ArtifactsPanel-CakCqxEN.js} +1 -1
  248. ksadk/server/static/assets/CodeBlock-CynLknyO.js +9 -0
  249. ksadk/server/static/assets/MathMessageMarkdown-3sQdOysS.js +8 -0
  250. ksadk/server/static/assets/MermaidBlock-NERD_ef7.js +303 -0
  251. ksadk/server/static/assets/NativeTerminalPanel-CiHWf82q.js +1 -0
  252. ksadk/server/static/assets/{arc-BA13sHc9.js → arc-DrgjcKhl.js} +1 -1
  253. ksadk/server/static/assets/architecture-7EHR7CIX-CpZLRCcY.js +1 -0
  254. ksadk/server/static/assets/{architectureDiagram-3BPJPVTR-DzJzgVoL.js → architectureDiagram-3BPJPVTR-BXoVRbQ6.js} +1 -1
  255. ksadk/server/static/assets/{blockDiagram-GPEHLZMM-UTdVcZhn.js → blockDiagram-GPEHLZMM-BnaB3Ywv.js} +1 -1
  256. ksadk/server/static/assets/{c4Diagram-AAUBKEIU-Dix0GD4m.js → c4Diagram-AAUBKEIU-Dw4weZcp.js} +1 -1
  257. ksadk/server/static/assets/channel-Dt3rQTFI.js +1 -0
  258. ksadk/server/static/assets/{chunk-2J33WTMH-C2JxuZ42.js → chunk-2J33WTMH-ChjpLK7j.js} +1 -1
  259. ksadk/server/static/assets/{chunk-4BX2VUAB-Be57QPgD.js → chunk-4BX2VUAB-B9drTgOW.js} +1 -1
  260. ksadk/server/static/assets/{chunk-55IACEB6-WjSuy4nv.js → chunk-55IACEB6-CK4ROATy.js} +1 -1
  261. ksadk/server/static/assets/{chunk-727SXJPM-BOovP-b5.js → chunk-727SXJPM-B9KtTTgw.js} +1 -1
  262. ksadk/server/static/assets/{chunk-AQP2D5EJ-DOmZNmWj.js → chunk-AQP2D5EJ-1O1mki3m.js} +1 -1
  263. ksadk/server/static/assets/{chunk-FMBD7UC4-DzwlodkU.js → chunk-FMBD7UC4-B_fH2YuH.js} +1 -1
  264. ksadk/server/static/assets/{chunk-ND2GUHAM-DMqAikEU.js → chunk-ND2GUHAM-D6rFLaVV.js} +1 -1
  265. ksadk/server/static/assets/chunk-QZHKN3VN-iXEZtKQc.js +1 -0
  266. ksadk/server/static/assets/classDiagram-4FO5ZUOK-DIveV17Q.js +1 -0
  267. ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-DIveV17Q.js +1 -0
  268. ksadk/server/static/assets/{cose-bilkent-S5V4N54A-Zhy2GBnP.js → cose-bilkent-S5V4N54A-ChNs_Mdk.js} +1 -1
  269. ksadk/server/static/assets/{dagre-BM42HDAG-CbKrtIUz.js → dagre-BM42HDAG-D0QXg_MQ.js} +1 -1
  270. ksadk/server/static/assets/{diagram-2AECGRRQ-BRApgQRK.js → diagram-2AECGRRQ-DBDDKwBQ.js} +1 -1
  271. ksadk/server/static/assets/{diagram-5GNKFQAL-D0xbnDiK.js → diagram-5GNKFQAL-BkwDOxmO.js} +1 -1
  272. ksadk/server/static/assets/{diagram-KO2AKTUF-CVugVI9L.js → diagram-KO2AKTUF-Bv8waYvY.js} +1 -1
  273. ksadk/server/static/assets/{diagram-LMA3HP47-DozUGgee.js → diagram-LMA3HP47-e1VECDdu.js} +1 -1
  274. ksadk/server/static/assets/{diagram-OG6HWLK6-ZOYsKlru.js → diagram-OG6HWLK6-Ds9adfRl.js} +1 -1
  275. ksadk/server/static/assets/{dist-DpKtt4Bo.js → dist-4N2NMVYg.js} +1 -1
  276. ksadk/server/static/assets/{dist-CkEKJFtk.js → dist-B-jNR6Vn.js} +1 -1
  277. ksadk/server/static/assets/{dist-D57wnGWd.js → dist-B5J2uhNk.js} +1 -1
  278. ksadk/server/static/assets/{dist-8_SfK1IP.js → dist-B5oS1zcj.js} +1 -1
  279. ksadk/server/static/assets/{dist-DMezvBGJ.js → dist-BB3-OwTQ.js} +1 -1
  280. ksadk/server/static/assets/{dist-2hInLS_J.js → dist-BIlKoW0k.js} +1 -1
  281. ksadk/server/static/assets/{dist-BrCcQ47T.js → dist-BjOdlDjj.js} +1 -1
  282. ksadk/server/static/assets/{dist-BmlMPsCc.js → dist-C1sz5Eo3.js} +1 -1
  283. ksadk/server/static/assets/{dist-B0NP_Z0z.js → dist-CWV4lDr1.js} +1 -1
  284. ksadk/server/static/assets/{dist-D-xOD048.js → dist-CmZHzlwZ.js} +1 -1
  285. ksadk/server/static/assets/{dist-DL_NKc_z.js → dist-D6MpCZtz.js} +1 -1
  286. ksadk/server/static/assets/{dist-DyOkZmze.js → dist-DJN_6Y39.js} +1 -1
  287. ksadk/server/static/assets/{dist-DmFaq_Iy.js → dist-DQU9EWw-.js} +1 -1
  288. ksadk/server/static/assets/{dist-gX6GOLKq.js → dist-DWKByxWV.js} +1 -1
  289. ksadk/server/static/assets/{dist-DyWsb78Q.js → dist-Dli7qW-B.js} +1 -1
  290. ksadk/server/static/assets/{dist-BIJVDMuB.js → dist-DsHPdk3W.js} +1 -1
  291. ksadk/server/static/assets/{dist-Dp0k7bWI.js → dist-X4TnqwOK.js} +1 -1
  292. ksadk/server/static/assets/{dist-8EEyGgDx.js → dist-_pHPTyZ-.js} +1 -1
  293. ksadk/server/static/assets/{dist-CPBtqRTW.js → dist-fhOuWds5.js} +1 -1
  294. ksadk/server/static/assets/{dist-D-JMdWPQ.js → dist-gLnrGsoU.js} +1 -1
  295. ksadk/server/static/assets/{dist-BssVmjIo.js → dist-j6Dxmf_j.js} +1 -1
  296. ksadk/server/static/assets/{dist-C3HIIaN5.js → dist-o2OVmKvt.js} +1 -1
  297. ksadk/server/static/assets/{erDiagram-TEJ5UH35-Bk-9bgE5.js → erDiagram-TEJ5UH35-BPItFKH6.js} +1 -1
  298. ksadk/server/static/assets/eventmodeling-FCH6USID-DYFSxbqr.js +1 -0
  299. ksadk/server/static/assets/{flowDiagram-I6XJVG4X-Dn9kZVuZ.js → flowDiagram-I6XJVG4X-BbYB9w5Y.js} +1 -1
  300. ksadk/server/static/assets/{ganttDiagram-6RSMTGT7-BGxXlJqm.js → ganttDiagram-6RSMTGT7-TQXa0KXv.js} +1 -1
  301. ksadk/server/static/assets/gitGraph-WXDBUCRP-DyNYp6BN.js +1 -0
  302. ksadk/server/static/assets/{gitGraphDiagram-PVQCEYII-C7Q0X-wi.js → gitGraphDiagram-PVQCEYII-bKblCnpa.js} +1 -1
  303. ksadk/server/static/assets/index-R52pJJvg.js +177 -0
  304. ksadk/server/static/assets/index-jJr3_955.css +2 -0
  305. ksadk/server/static/assets/info-J43DQDTF-WUx7qTde.js +1 -0
  306. ksadk/server/static/assets/{infoDiagram-5YYISTIA-BO_CSqq5.js → infoDiagram-5YYISTIA-BGVT7J_i.js} +1 -1
  307. ksadk/server/static/assets/{ishikawaDiagram-YF4QCWOH-eYLPLd46.js → ishikawaDiagram-YF4QCWOH-K0OOfVna.js} +1 -1
  308. ksadk/server/static/assets/{journeyDiagram-JHISSGLW-De9geSb0.js → journeyDiagram-JHISSGLW-8LeOJaZp.js} +1 -1
  309. ksadk/server/static/assets/{kanban-definition-UN3LZRKU-Cs80kQto.js → kanban-definition-UN3LZRKU-C6uCgZrW.js} +1 -1
  310. ksadk/server/static/assets/{katex-DSrCFD8n.js → katex-CYWseY5E.js} +1 -1
  311. ksadk/server/static/assets/{linear-CN9sbKTF.js → linear-hdBcYzM8.js} +1 -1
  312. ksadk/server/static/assets/{mermaid-parser.core-DlgSBU8l.js → mermaid-parser.core-BWrDjSZM.js} +2 -2
  313. ksadk/server/static/assets/{mindmap-definition-RKZ34NQL-9afz7Oug.js → mindmap-definition-RKZ34NQL-Bjy_2v4_.js} +1 -1
  314. ksadk/server/static/assets/packet-YPE3B663-BN13y_xl.js +1 -0
  315. ksadk/server/static/assets/pie-LRSECV5Y-ftSLXhhc.js +1 -0
  316. ksadk/server/static/assets/{pieDiagram-4H26LBE5-DPv_VstN.js → pieDiagram-4H26LBE5-GmmqNiVH.js} +1 -1
  317. ksadk/server/static/assets/{quadrantDiagram-W4KKPZXB-o77wZ1XK.js → quadrantDiagram-W4KKPZXB-BmkRbwCg.js} +1 -1
  318. ksadk/server/static/assets/radar-GUYGQ44K-jaICkIeO.js +1 -0
  319. ksadk/server/static/assets/{requirementDiagram-4Y6WPE33-BYVw81VC.js → requirementDiagram-4Y6WPE33-DSWFqL7c.js} +1 -1
  320. ksadk/server/static/assets/{sankeyDiagram-5OEKKPKP-B7nZFMKT.js → sankeyDiagram-5OEKKPKP-l6iXmU65.js} +1 -1
  321. ksadk/server/static/assets/{sequenceDiagram-3UESZ5HK-BGRRrFw5.js → sequenceDiagram-3UESZ5HK-Cq6UBeQB.js} +1 -1
  322. ksadk/server/static/assets/{stateDiagram-AJRCARHV-BUfHCoPs.js → stateDiagram-AJRCARHV-qzTQpg3Y.js} +1 -1
  323. ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-BYCoYGAN.js +1 -0
  324. ksadk/server/static/assets/{timeline-definition-PNZ67QCA-FbCTGrf9.js → timeline-definition-PNZ67QCA-DEz24vV0.js} +1 -1
  325. ksadk/server/static/assets/treeView-BLDUP644-Cpib_vlz.js +1 -0
  326. ksadk/server/static/assets/treemap-LRROVOQU-DQxfmVHK.js +1 -0
  327. ksadk/server/static/assets/{vennDiagram-CIIHVFJN-DWgwtPsJ.js → vennDiagram-CIIHVFJN-CMCixki2.js} +1 -1
  328. ksadk/server/static/assets/wardley-L42UT6IY-BQYHnnkU.js +1 -0
  329. ksadk/server/static/assets/{wardleyDiagram-YWT4CUSO-2x8G-tTM.js → wardleyDiagram-YWT4CUSO-CVzB8F9K.js} +1 -1
  330. ksadk/server/static/assets/{xychartDiagram-2RQKCTM6-Drma3AYl.js → xychartDiagram-2RQKCTM6-BFBqBLc1.js} +1 -1
  331. ksadk/server/static/index.html +2 -2
  332. ksadk/server/terminal_sessions.py +111 -58
  333. ksadk/sessions/__init__.py +69 -19
  334. ksadk/sessions/base.py +31 -11
  335. ksadk/sessions/continuity.py +2 -3
  336. ksadk/sessions/in_memory.py +46 -2
  337. ksadk/sessions/local_service.py +148 -17
  338. ksadk/sessions/postgres_service.py +143 -25
  339. ksadk/sessions/resilient.py +36 -8
  340. ksadk/skills/models.py +17 -5
  341. ksadk/skills/package_store.py +5 -2
  342. ksadk/skills/runtime/agent.py +20 -5
  343. ksadk/skills/runtime/artifacts.py +1 -5
  344. ksadk/skills/runtime/backends/e2b.py +10 -4
  345. ksadk/skills/runtime/backends/local.py +15 -3
  346. ksadk/skills/runtime/base.py +1 -2
  347. ksadk/skills/runtime/executor.py +10 -3
  348. ksadk/skills/runtime/factory.py +4 -2
  349. ksadk/skills/runtime/loader.py +1 -2
  350. ksadk/skills/runtime/registry.py +15 -10
  351. ksadk/skills/runtime/request.py +3 -1
  352. ksadk/skills/service_client.py +47 -16
  353. ksadk/skills/tool_defs.py +15 -10
  354. ksadk/studio/__init__.py +5 -0
  355. ksadk/studio/agent_avatar_assets.py +120 -0
  356. ksadk/studio/agent_lifecycle.py +51 -0
  357. ksadk/studio/api.py +1046 -0
  358. ksadk/studio/api_catalog_routes.py +324 -0
  359. ksadk/studio/api_contracts.py +177 -0
  360. ksadk/studio/api_helpers.py +132 -0
  361. ksadk/studio/authoring.py +524 -0
  362. ksadk/studio/authoring_coordinator.py +285 -0
  363. ksadk/studio/builder.py +320 -0
  364. ksadk/studio/capabilities.py +351 -0
  365. ksadk/studio/cloud.py +278 -0
  366. ksadk/studio/codex_agent_service.py +583 -0
  367. ksadk/studio/codex_builder.py +324 -0
  368. ksadk/studio/codex_manifest.py +278 -0
  369. ksadk/studio/codex_run.py +352 -0
  370. ksadk/studio/compiler.py +189 -0
  371. ksadk/studio/contracts.py +644 -0
  372. ksadk/studio/errors.py +47 -0
  373. ksadk/studio/evaluation.py +192 -0
  374. ksadk/studio/event_store.py +284 -0
  375. ksadk/studio/framework_run.py +114 -0
  376. ksadk/studio/identifiers.py +33 -0
  377. ksadk/studio/mcp_runtime.py +229 -0
  378. ksadk/studio/model_client.py +543 -0
  379. ksadk/studio/model_profile_service.py +214 -0
  380. ksadk/studio/operations.py +243 -0
  381. ksadk/studio/otel_trace.py +754 -0
  382. ksadk/studio/pagination.py +182 -0
  383. ksadk/studio/python_tool_inspection.py +183 -0
  384. ksadk/studio/repository.py +306 -0
  385. ksadk/studio/resource_catalog.py +1217 -0
  386. ksadk/studio/run_service.py +707 -0
  387. ksadk/studio/runtime_catalog.py +74 -0
  388. ksadk/studio/runtime_source.py +339 -0
  389. ksadk/studio/service.py +1141 -0
  390. ksadk/studio/shared_web.py +994 -0
  391. ksadk/studio/skill_discovery.py +628 -0
  392. ksadk/studio/static/assets/PrismRenderer-IYN-ffww.js +3 -0
  393. ksadk/studio/static/assets/index-CaEN0eTR.css +1 -0
  394. ksadk/studio/static/assets/index-DI2eY_NH.js +252 -0
  395. ksadk/studio/static/assets/react-vendor-BNmTiJ-I.js +9 -0
  396. ksadk/studio/static/assets/rolldown-runtime-hePW80VL.js +1 -0
  397. ksadk/studio/static/index.html +15 -0
  398. ksadk/studio/templates.py +630 -0
  399. ksadk/studio/validator.py +246 -0
  400. ksadk/studio/workspace.py +137 -0
  401. ksadk/terminal_exec_policy.py +3 -4
  402. ksadk/tools/gateway.py +101 -15
  403. ksadk/tools/result_budget.py +12 -4
  404. ksadk/toolsets/__init__.py +161 -37
  405. ksadk/toolsets/a2a.py +426 -0
  406. ksadk/toolsets/platform.py +21 -5
  407. ksadk/toolsets/sandbox.py +82 -16
  408. ksadk/toolsets/skills.py +200 -39
  409. ksadk/toolsets/web.py +123 -26
  410. ksadk/toolsets/workspace.py +212 -101
  411. ksadk/tracing/__init__.py +19 -21
  412. ksadk/tracing/exporters/inmemory_exporter.py +62 -51
  413. ksadk/tracing/setup.py +135 -506
  414. ksadk/tracing/span_utils.py +0 -41
  415. ksadk/tui/loop.py +78 -30
  416. ksadk/tui/stream_render.py +1 -0
  417. ksadk/ui_config.py +5 -3
  418. ksadk/version.py +1 -1
  419. ksadk_runtime_common/memory_backend/registry.py +56 -56
  420. ksadk_runtime_common/schemas/runtime_event_v1.json +95 -0
  421. ksadk_runtime_common/workspace_files/router.py +8 -2
  422. agentengine_sdk_python-0.7.0.dist-info/RECORD +0 -482
  423. ksadk/a2a/card_builder.py +0 -64
  424. ksadk/a2a/client.py +0 -309
  425. ksadk/runners/utils/langfuse.py +0 -230
  426. ksadk/server/static/assets/CodeBlock-P16VOLYi.js +0 -9
  427. ksadk/server/static/assets/MathMessageMarkdown-CdGiQWHR.js +0 -8
  428. ksadk/server/static/assets/MermaidBlock-IOcal8cm.js +0 -303
  429. ksadk/server/static/assets/NativeTerminalPanel-DGSDWsei.js +0 -1
  430. ksadk/server/static/assets/architecture-7EHR7CIX-BvUlsA6l.js +0 -1
  431. ksadk/server/static/assets/channel-CTuydARX.js +0 -1
  432. ksadk/server/static/assets/chunk-QZHKN3VN-BnCydivS.js +0 -1
  433. ksadk/server/static/assets/classDiagram-4FO5ZUOK-BNHg45Be.js +0 -1
  434. ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-BNHg45Be.js +0 -1
  435. ksadk/server/static/assets/eventmodeling-FCH6USID-DsAgWnlf.js +0 -1
  436. ksadk/server/static/assets/gitGraph-WXDBUCRP-BIao9Yjg.js +0 -1
  437. ksadk/server/static/assets/index-C00Lwg3L.js +0 -165
  438. ksadk/server/static/assets/index-DAURbCsP.css +0 -1
  439. ksadk/server/static/assets/info-J43DQDTF-CyipqGxU.js +0 -1
  440. ksadk/server/static/assets/packet-YPE3B663-CGkyRxlg.js +0 -1
  441. ksadk/server/static/assets/pie-LRSECV5Y-M0uWAf4n.js +0 -1
  442. ksadk/server/static/assets/radar-GUYGQ44K-Bdbm24-x.js +0 -1
  443. ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-8xBN_gLM.js +0 -1
  444. ksadk/server/static/assets/treeView-BLDUP644-npMo0ak1.js +0 -1
  445. ksadk/server/static/assets/treemap-LRROVOQU-CHdzrrdo.js +0 -1
  446. ksadk/server/static/assets/wardley-L42UT6IY-BEQz7wyy.js +0 -1
  447. ksadk/tracing/exporters/langfuse_exporter.py +0 -445
  448. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/entry_points.txt +0 -0
  449. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/licenses/LICENSE +0 -0
  450. {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,324 @@
1
+ """Catalog, credential and capability routes for Studio."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Awaitable, Callable, Literal
6
+
7
+ from fastapi import FastAPI, File, Query, UploadFile
8
+ from jsonschema import Draft202012Validator # type: ignore[import-untyped]
9
+ from jsonschema.exceptions import SchemaError # type: ignore[import-untyped]
10
+
11
+ from ksadk.studio.api_contracts import (
12
+ CredentialPutRequest,
13
+ MCPResourceCreateRequest,
14
+ ModelEndpointProbeRequest,
15
+ ModelProfileCreateRequest,
16
+ PythonToolCommitRequest,
17
+ SecretReferenceCheckRequest,
18
+ SkillDiscoveryCommitRequest,
19
+ SkillDiscoveryRequest,
20
+ ToolPolicyPreviewRequest,
21
+ ToolResourceCreateRequest,
22
+ ToolSchemaValidationRequest,
23
+ )
24
+ from ksadk.studio.contracts import MCPServerRef
25
+ from ksadk.studio.errors import StudioError
26
+ from ksadk.studio.model_profile_service import probe_model_endpoint
27
+ from ksadk.studio.service import StudioService
28
+
29
+ ModelCatalogLoader = Callable[[], Awaitable[tuple[list, str]]]
30
+
31
+
32
+ def register_catalog_routes(
33
+ app: FastAPI,
34
+ studio: StudioService,
35
+ *,
36
+ runtime_model_catalog: ModelCatalogLoader,
37
+ ) -> None:
38
+ """Register resource routes without expanding the main HTTP composition."""
39
+
40
+ @app.get("/api/v1/capabilities")
41
+ async def capabilities(kind: str | None = None, query: str = ""):
42
+ return {"items": studio.list_capabilities(kind=kind, query=query)}
43
+
44
+ @app.get("/api/v1/catalog/resources")
45
+ async def catalog_resources(
46
+ kind: Literal["model", "tool", "mcp", "skill"] | None = None,
47
+ query: str = "",
48
+ source: Literal["builtin", "provider", "local", "market"] | None = None,
49
+ status: str | None = None,
50
+ installed: bool | None = None,
51
+ limit: int = Query(default=50, ge=1, le=200),
52
+ cursor: str | None = None,
53
+ sort: Literal["default", "displayName:asc", "displayName:desc"] = "default",
54
+ ):
55
+ if kind == "model":
56
+ await runtime_model_catalog()
57
+
58
+ def effective_status(resource) -> str:
59
+ if resource.kind != "model":
60
+ return resource.status
61
+ references = list(resource.required_secret_refs or [])
62
+ reference = references[0] if references else resource.contract.get("credentialRef")
63
+ if not reference:
64
+ return resource.status
65
+ return (
66
+ "ready"
67
+ if studio.credentials.status(str(reference))["configured"]
68
+ else "missing-secret"
69
+ )
70
+
71
+ return studio.catalog.list_page(
72
+ kind=kind,
73
+ query=query,
74
+ source=source,
75
+ status=status,
76
+ installed=installed,
77
+ limit=limit,
78
+ cursor=cursor,
79
+ sort=sort,
80
+ status_resolver=effective_status,
81
+ )
82
+
83
+ @app.get("/api/v1/catalog/models")
84
+ async def catalog_models():
85
+ items, source = await runtime_model_catalog()
86
+ return {"items": items, "source": source, "nextCursor": None}
87
+
88
+ @app.get("/api/v1/catalog/runtimes")
89
+ async def catalog_runtimes():
90
+ return {"items": studio.runtime_catalog(), "nextCursor": None}
91
+
92
+ @app.get("/api/v1/catalog/resources/{resource_id}")
93
+ async def get_catalog_resource(resource_id: str):
94
+ return studio.catalog.get(resource_id)
95
+
96
+ @app.post("/api/v1/catalog/model-profiles", status_code=201)
97
+ async def create_model_profile(payload: ModelProfileCreateRequest):
98
+ return studio.catalog.create_model_profile(
99
+ name=payload.name,
100
+ display_name=payload.display_name,
101
+ version=payload.version,
102
+ description=payload.description,
103
+ spec=payload.spec,
104
+ )
105
+
106
+ @app.post("/api/v1/catalog/mcp-servers", status_code=201)
107
+ async def create_mcp_resource(payload: MCPResourceCreateRequest):
108
+ return studio.catalog.create_mcp_server(
109
+ display_name=payload.display_name,
110
+ description=payload.description,
111
+ server=payload.server,
112
+ )
113
+
114
+ @app.post("/api/v1/catalog/mcp-servers/{resource_id}:probe")
115
+ async def probe_mcp_resource(
116
+ resource_id: str,
117
+ timeout_seconds: int = Query(default=10, alias="timeoutSeconds", ge=1, le=60),
118
+ ):
119
+ descriptor = studio.catalog.get(resource_id)
120
+ if descriptor.kind != "mcp":
121
+ raise StudioError(
122
+ "RESOURCE_KIND_INVALID",
123
+ "该 Resource 不是 MCP Server",
124
+ status_code=422,
125
+ details={"resourceId": resource_id},
126
+ )
127
+ server_payload = {
128
+ key: value for key, value in descriptor.contract.items() if key != "discoveredTools"
129
+ }
130
+ server = MCPServerRef.model_validate(server_payload)
131
+ try:
132
+ result = await studio.mcp_runtime.probe(server, timeout_seconds=timeout_seconds)
133
+ except StudioError as exc:
134
+ detail = str((exc.details or {}).get("detail") or exc.message)
135
+ studio.catalog.mark_probe_failed(resource_id, code=exc.code, detail=detail)
136
+ raise
137
+ return studio.catalog.save_probe(resource_id, result=result)
138
+
139
+ @app.delete("/api/v1/catalog/resources/{resource_id}", status_code=204)
140
+ async def delete_catalog_resource(resource_id: str):
141
+ descriptor = studio.catalog.get(resource_id)
142
+ if descriptor.kind not in {"mcp", "tool", "model", "skill"}:
143
+ raise StudioError(
144
+ "RESOURCE_KIND_INVALID",
145
+ "只支持删除 MCP / Tool / Model / Skill 资源",
146
+ status_code=422,
147
+ details={"kind": descriptor.kind},
148
+ )
149
+ if descriptor.kind == "model" and descriptor.source != "local":
150
+ raise StudioError(
151
+ "RESOURCE_KIND_INVALID",
152
+ "内置或上游发现的模型不可删除;仅支持删除手动添加的模型",
153
+ status_code=422,
154
+ details={"kind": descriptor.kind, "source": descriptor.source},
155
+ )
156
+ studio.catalog.delete_resource(resource_id)
157
+ return None
158
+
159
+ @app.post("/api/v1/catalog/tools", status_code=201)
160
+ async def create_tool_resource(payload: ToolResourceCreateRequest):
161
+ return studio.catalog.create_tool(
162
+ display_name=payload.display_name,
163
+ category=payload.category,
164
+ contract=payload.contract,
165
+ )
166
+
167
+ @app.post("/api/v1/catalog/python-tools:inspect")
168
+ async def inspect_python_tool(file: UploadFile = File(...)):
169
+ content = await file.read(1024 * 1024 + 1)
170
+ return studio.catalog.inspect_python_tool(
171
+ content,
172
+ filename=file.filename or "tool.py",
173
+ )
174
+
175
+ @app.post(
176
+ "/api/v1/catalog/python-tools/{inspection_token}:commit",
177
+ status_code=201,
178
+ )
179
+ async def commit_python_tool(
180
+ inspection_token: str,
181
+ payload: PythonToolCommitRequest,
182
+ ):
183
+ return studio.catalog.commit_python_tool(
184
+ inspection_token,
185
+ display_name=payload.display_name,
186
+ name=payload.name,
187
+ callable_name=payload.callable_name,
188
+ description=payload.description,
189
+ )
190
+
191
+ @app.post("/api/v1/catalog/skills:import", status_code=201)
192
+ async def import_skill(file: UploadFile = File(...)):
193
+ content = await file.read(50 * 1024 * 1024 + 1)
194
+ return studio.catalog.import_skill_zip(content, filename=file.filename or "skill.zip")
195
+
196
+ @app.post("/api/v1/catalog/skills:discover")
197
+ async def discover_skills(payload: SkillDiscoveryRequest):
198
+ return studio.catalog.discover_skills(scan_paths=payload.scan_paths or None)
199
+
200
+ @app.get(
201
+ "/api/v1/catalog/skills/discoveries/{inspection_token}/candidates/{candidate_id}/files"
202
+ )
203
+ async def preview_discovered_skill(
204
+ inspection_token: str,
205
+ candidate_id: str,
206
+ path: str | None = Query(default=None, max_length=1024),
207
+ ):
208
+ return studio.catalog.preview_discovered_skill(
209
+ inspection_token,
210
+ candidate_id,
211
+ path=path,
212
+ )
213
+
214
+ @app.get("/api/v1/catalog/skills/{resource_id}/files")
215
+ async def preview_installed_skill(
216
+ resource_id: str,
217
+ path: str | None = Query(default=None, max_length=1024),
218
+ ):
219
+ return studio.catalog.preview_installed_skill(resource_id, path=path)
220
+
221
+ @app.post(
222
+ "/api/v1/catalog/skills/discoveries/{inspection_token}:commit",
223
+ status_code=201,
224
+ )
225
+ async def commit_discovered_skill(
226
+ inspection_token: str,
227
+ payload: SkillDiscoveryCommitRequest,
228
+ ):
229
+ return studio.catalog.commit_discovered_skill(
230
+ inspection_token,
231
+ payload.candidate_id,
232
+ overwrite=payload.overwrite,
233
+ )
234
+
235
+ @app.post("/api/v1/tool-schemas:validate")
236
+ async def validate_tool_schema(payload: ToolSchemaValidationRequest):
237
+ try:
238
+ Draft202012Validator.check_schema(payload.schema_definition)
239
+ except SchemaError as exc:
240
+ return {
241
+ "valid": False,
242
+ "diagnostics": [
243
+ {
244
+ "code": "TOOL_SCHEMA_INVALID",
245
+ "message": exc.message,
246
+ "path": list(exc.path),
247
+ }
248
+ ],
249
+ }
250
+ errors = sorted(
251
+ Draft202012Validator(payload.schema_definition).iter_errors(payload.sample),
252
+ key=lambda error: list(error.absolute_path),
253
+ )
254
+ return {
255
+ "valid": not errors,
256
+ "diagnostics": [
257
+ {
258
+ "code": "TOOL_SAMPLE_INVALID",
259
+ "message": error.message,
260
+ "path": list(error.absolute_path),
261
+ }
262
+ for error in errors
263
+ ],
264
+ }
265
+
266
+ @app.post("/api/v1/tool-policies:preview")
267
+ async def preview_tool_policy(payload: ToolPolicyPreviewRequest):
268
+ tools, permissions = studio.catalog.policy_preview(payload.bindings)
269
+ return {"tools": tools, "allowedPermissions": permissions}
270
+
271
+ @app.post("/api/v1/mcp-servers:probe")
272
+ async def probe_mcp_server(
273
+ payload: MCPServerRef,
274
+ timeout_seconds: int = Query(default=10, alias="timeoutSeconds", ge=1, le=60),
275
+ ):
276
+ return await studio.mcp_runtime.probe(payload, timeout_seconds=timeout_seconds)
277
+
278
+ @app.post("/api/v1/secret-references:check")
279
+ async def check_secret_reference(payload: SecretReferenceCheckRequest):
280
+ status = studio.credentials.status(payload.ref)
281
+ return {
282
+ "exists": status["configured"],
283
+ "scheme": payload.ref.partition("://")[0],
284
+ "source": status["source"],
285
+ }
286
+
287
+ @app.get("/api/v1/credentials/{credential_name}")
288
+ async def get_credential_status(credential_name: str):
289
+ return studio.credentials.status(f"env://{credential_name}")
290
+
291
+ @app.put("/api/v1/credentials/{credential_name}")
292
+ async def put_credential(credential_name: str, payload: CredentialPutRequest):
293
+ return studio.credentials.put_session(
294
+ credential_name,
295
+ payload.value.get_secret_value(),
296
+ )
297
+
298
+ @app.delete("/api/v1/credentials/{credential_name}")
299
+ async def delete_credential(credential_name: str):
300
+ return studio.credentials.delete_session(credential_name)
301
+
302
+ @app.post("/api/v1/model-profiles/{resource_id}:test")
303
+ async def test_model_profile(resource_id: str):
304
+ return await studio.test_model_profile(resource_id)
305
+
306
+ @app.post("/api/v1/model-endpoints:probe")
307
+ async def probe_model_endpoint_route(payload: ModelEndpointProbeRequest):
308
+ credential: str | None = None
309
+ if payload.api_key is not None:
310
+ credential = payload.api_key.get_secret_value()
311
+ elif payload.credential_ref:
312
+ try:
313
+ credential = studio.credentials.resolve(payload.credential_ref)
314
+ except Exception:
315
+ credential = None # 未配置凭证时降级为匿名探测
316
+ guard = getattr(studio.model_client, "network_guard", None)
317
+ return await probe_model_endpoint(
318
+ url=payload.url,
319
+ credential=credential,
320
+ network_guard=guard,
321
+ )
322
+
323
+
324
+ __all__ = ["register_catalog_routes"]
@@ -0,0 +1,177 @@
1
+ """HTTP request contracts used by the AgentKit Studio control plane."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any, Literal
6
+
7
+ from pydantic import Field, SecretStr
8
+
9
+ from ksadk.evaluation import EvaluationConfig as PublicEvaluationConfig
10
+ from ksadk.evaluation import TargetRef
11
+ from ksadk.studio.contracts import (
12
+ AgentBindings,
13
+ AgentSpec,
14
+ ContractModel,
15
+ MCPServerRef,
16
+ ModelSpec,
17
+ RuntimeRef,
18
+ ToolContract,
19
+ )
20
+
21
+
22
+ class SessionExchangeRequest(ContractModel):
23
+ token: str = Field(min_length=16, max_length=512)
24
+
25
+
26
+ class WorkspaceOpenRequest(ContractModel):
27
+ path: str
28
+ create: bool = False
29
+
30
+
31
+ class CreateAgentRequest(ContractModel):
32
+ id: str = Field(pattern=r"^[a-z][a-z0-9-]{2,62}$")
33
+ name: str = Field(min_length=1, max_length=128)
34
+ description: str = Field(default="", max_length=1024)
35
+ template: str = "blank"
36
+ runtime: RuntimeRef | None = None
37
+ spec: AgentSpec | None = None
38
+
39
+
40
+ class ValidationRequest(ContractModel):
41
+ revision: int = Field(ge=1)
42
+ level: Literal["schema", "build", "release"] = "build"
43
+
44
+
45
+ class BuildRequest(ContractModel):
46
+ revision: int = Field(ge=1)
47
+ run_evaluation: bool = False
48
+ evaluation_suite_refs: list[str] = Field(default_factory=list)
49
+
50
+
51
+ class MessageInput(ContractModel):
52
+ role: str = "user"
53
+ content: str = Field(min_length=1, max_length=1_000_000)
54
+
55
+
56
+ class QuickAuthoringRequest(ContractModel):
57
+ name: str = Field(min_length=1, max_length=128)
58
+ slug: str | None = Field(default=None, min_length=1, max_length=63)
59
+ runtime_type: Literal["codex", "adk", "langgraph"]
60
+ template: Literal["blank", "research"] = "blank"
61
+ description: str = Field(default="", max_length=1024)
62
+ spec: AgentSpec | None = None
63
+
64
+
65
+ class AuthoringConversationMessage(ContractModel):
66
+ role: Literal["user", "assistant"]
67
+ content: str = Field(min_length=1, max_length=32768)
68
+
69
+
70
+ class ConversationAuthoringRequest(ContractModel):
71
+ messages: list[AuthoringConversationMessage] = Field(min_length=1, max_length=100)
72
+ model_profile_id: str = Field(min_length=3, max_length=256)
73
+
74
+
75
+ class AuthoringCommitRequest(ContractModel):
76
+ name: str | None = Field(default=None, min_length=1, max_length=128)
77
+ slug: str | None = Field(default=None, min_length=1, max_length=63)
78
+ model_profile_id: str | None = Field(default=None, min_length=3, max_length=256)
79
+
80
+
81
+ class ProjectInspectRequest(ContractModel):
82
+ path: str = Field(min_length=1, max_length=4096)
83
+
84
+
85
+ class RunRequest(ContractModel):
86
+ session_id: str | None = None
87
+ model: str | None = Field(default=None, min_length=1, max_length=256)
88
+ input: MessageInput
89
+ environment: str = "local"
90
+ stream: bool = True
91
+ sandbox: str | None = None
92
+
93
+
94
+ class InteractionSubmitRequest(ContractModel):
95
+ name: str = Field(min_length=1, max_length=64)
96
+ data: dict[str, Any] = Field(default_factory=dict)
97
+
98
+
99
+ class EvaluationRequest(ContractModel):
100
+ suite_refs: list[str] = Field(min_length=1)
101
+ concurrency: int = Field(default=1, ge=1, le=4)
102
+ fail_fast: bool = False
103
+
104
+
105
+ class StudioEvaluationCreate(ContractModel):
106
+ """Request for the shared CLI/Studio evaluation executor."""
107
+
108
+ evalset_file: str = Field(min_length=1, max_length=4096)
109
+ target: TargetRef
110
+ config: PublicEvaluationConfig = Field(default_factory=PublicEvaluationConfig)
111
+
112
+
113
+ class SecretReferenceCheckRequest(ContractModel):
114
+ ref: str
115
+
116
+
117
+ class CredentialPutRequest(ContractModel):
118
+ value: SecretStr = Field(min_length=1, max_length=16_384)
119
+ persistence: Literal["session"] = "session"
120
+
121
+
122
+ class RollbackRequest(ContractModel):
123
+ target_build_id: str
124
+
125
+
126
+ class ModelProfileCreateRequest(ContractModel):
127
+ name: str = Field(pattern=r"^[a-z][a-z0-9._-]{1,127}$")
128
+ display_name: str = Field(min_length=1, max_length=128)
129
+ version: str = Field(default="1.0.0", min_length=1, max_length=64)
130
+ description: str = Field(default="", max_length=4096)
131
+ spec: ModelSpec
132
+
133
+
134
+ class ModelEndpointProbeRequest(ContractModel):
135
+ url: str = Field(min_length=8, max_length=1024)
136
+ credential_ref: str | None = Field(default=None, max_length=512)
137
+ api_key: SecretStr | None = None
138
+
139
+
140
+ class MCPResourceCreateRequest(ContractModel):
141
+ display_name: str = Field(min_length=1, max_length=128)
142
+ description: str = Field(default="", max_length=4096)
143
+ server: MCPServerRef
144
+
145
+
146
+ class ToolResourceCreateRequest(ContractModel):
147
+ display_name: str = Field(min_length=1, max_length=128)
148
+ category: str = Field(default="custom", max_length=64)
149
+ contract: ToolContract
150
+
151
+
152
+ class PythonToolCommitRequest(ContractModel):
153
+ display_name: str = Field(min_length=1, max_length=128)
154
+ name: str = Field(pattern=r"^[A-Za-z_][A-Za-z0-9_]{0,127}$")
155
+ callable_name: str = Field(pattern=r"^[A-Za-z_][A-Za-z0-9_]{0,127}$")
156
+ description: str = Field(default="", max_length=1024)
157
+
158
+
159
+ class ToolSchemaValidationRequest(ContractModel):
160
+ schema_definition: dict[str, Any] = Field(alias="schema")
161
+ sample: Any = None
162
+
163
+
164
+ class ToolPolicyPreviewRequest(ContractModel):
165
+ bindings: AgentBindings
166
+
167
+
168
+ class SkillDiscoveryRequest(ContractModel):
169
+ scan_paths: list[str] = Field(default_factory=list, max_length=20)
170
+
171
+
172
+ class SkillDiscoveryCommitRequest(ContractModel):
173
+ candidate_id: str = Field(min_length=1, max_length=128)
174
+ overwrite: bool = False
175
+
176
+
177
+ __all__ = [name for name in globals() if name.endswith("Request")]
@@ -0,0 +1,132 @@
1
+ """Small protocol helpers shared by Studio HTTP route composition."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import re
7
+ from typing import Any
8
+ from urllib.parse import urlparse
9
+
10
+ from fastapi import Request
11
+ from fastapi.responses import JSONResponse, StreamingResponse
12
+
13
+ from ksadk.studio.errors import StudioError
14
+ from ksadk.studio.shared_web import StudioSharedWebBridge
15
+
16
+
17
+ def is_local_origin(origin: str, *, local_hosts: set[str]) -> bool:
18
+ parsed = urlparse(origin)
19
+ return parsed.scheme in {"http", "https"} and (parsed.hostname or "").lower() in local_hosts
20
+
21
+
22
+ def responses_input(value: Any) -> list[dict[str, Any]]:
23
+ if isinstance(value, str) and value.strip():
24
+ return [
25
+ {
26
+ "role": "user",
27
+ "content": [{"type": "input_text", "text": value.strip()}],
28
+ }
29
+ ]
30
+ if isinstance(value, list) and value:
31
+ return value
32
+ raise StudioError(
33
+ "RUN_INPUT_REQUIRED",
34
+ "Responses input 必须是非空字符串或消息数组",
35
+ status_code=422,
36
+ field="input",
37
+ )
38
+
39
+
40
+ def responses_session_id(
41
+ payload: dict[str, Any],
42
+ *,
43
+ bridge: StudioSharedWebBridge,
44
+ ) -> str | None:
45
+ metadata = payload.get("metadata")
46
+ if isinstance(metadata, dict):
47
+ candidate = metadata.get("session_id") or metadata.get("sessionId")
48
+ if candidate:
49
+ return str(candidate)
50
+ conversation = payload.get("conversation")
51
+ if isinstance(conversation, str) and conversation.strip():
52
+ return conversation.strip()
53
+ if isinstance(conversation, dict) and conversation.get("id"):
54
+ return str(conversation["id"])
55
+ previous_response_id = payload.get("previous_response_id")
56
+ if previous_response_id:
57
+ return bridge.response_session_id(str(previous_response_id))
58
+ return None
59
+
60
+
61
+ def error_response(exc: StudioError, request: Request) -> JSONResponse:
62
+ request_id = getattr(request.state, "request_id", None)
63
+ return JSONResponse(
64
+ status_code=exc.status_code,
65
+ content=exc.as_dict(request_id=request_id),
66
+ headers={"X-Request-Id": request_id or ""},
67
+ )
68
+
69
+
70
+ def require_idempotency_key(value: str | None) -> str:
71
+ if not value or not re.fullmatch(r"[A-Za-z0-9._:-]{1,200}", value):
72
+ raise StudioError(
73
+ "IDEMPOTENCY_KEY_REQUIRED",
74
+ "异步创建接口必须提供合法 Idempotency-Key",
75
+ status_code=400,
76
+ )
77
+ return value
78
+
79
+
80
+ def parse_revision(value: str | None) -> int:
81
+ if not value:
82
+ raise StudioError(
83
+ "AGENT_REVISION_REQUIRED",
84
+ "更新 Agent 必须提供 If-Match revision",
85
+ status_code=428,
86
+ )
87
+ try:
88
+ return int(value.strip().strip('"'))
89
+ except ValueError as exc:
90
+ raise StudioError(
91
+ "AGENT_REVISION_INVALID",
92
+ "If-Match 必须是整数 revision",
93
+ status_code=400,
94
+ ) from exc
95
+
96
+
97
+ def optional_int(value: Any) -> int | None:
98
+ if value is None or value == "":
99
+ return None
100
+ try:
101
+ return int(value)
102
+ except (TypeError, ValueError) as exc:
103
+ raise StudioError(
104
+ "REQUEST_VALIDATION_FAILED",
105
+ "分页游标必须是整数",
106
+ status_code=422,
107
+ ) from exc
108
+
109
+
110
+ def sse(events: list[Any]) -> StreamingResponse:
111
+ def render():
112
+ for event in events:
113
+ data = json.dumps(event.data, ensure_ascii=False, separators=(",", ":"))
114
+ yield f"id: {event.id}\nevent: {event.type}\ndata: {data}\n\n"
115
+
116
+ return StreamingResponse(
117
+ render(),
118
+ media_type="text/event-stream",
119
+ headers={"Cache-Control": "no-store", "X-Accel-Buffering": "no"},
120
+ )
121
+
122
+
123
+ __all__ = [
124
+ "error_response",
125
+ "is_local_origin",
126
+ "optional_int",
127
+ "parse_revision",
128
+ "require_idempotency_key",
129
+ "responses_input",
130
+ "responses_session_id",
131
+ "sse",
132
+ ]