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
@@ -11,7 +11,11 @@ from ksadk.conversations.compaction_prompt import (
11
11
  build_compaction_prompt_messages,
12
12
  extract_summary_text,
13
13
  )
14
- from ksadk.conversations.context import canonical_event_type, extract_event_text, summarize_event_groups
14
+ from ksadk.conversations.context import (
15
+ canonical_event_type,
16
+ extract_event_text,
17
+ summarize_event_groups,
18
+ )
15
19
  from ksadk.sessions.base import SessionEvent
16
20
 
17
21
  SUMMARY_VERSION = "v1"
@@ -25,7 +29,8 @@ SUMMARY_PREFIX = "Earlier conversation summary:"
25
29
  # 已知局限(有意取舍,对齐 Claude Code 行为):
26
30
  # - 默认 0(opt-in),避免 transient 失败永久禁用 semantic;用户显式设 N>0 才启用。
27
31
  # - 打开后无 half-open 探测,需进程重启或显式 _reset_semantic_failures 恢复(CC 同样如此)。
28
- # - 计数为模块级全局,跨 session/model 共享;per-model key 化留作 follow-up(对齐 governance per-session 范式)。
32
+ # - 计数为模块级全局,跨 session/model 共享。
33
+ # - per-model key 化留作 follow-up(对齐 governance per-session 范式)。
29
34
  _semantic_summary_failures: int = 0
30
35
 
31
36
 
@@ -118,7 +123,9 @@ class SummaryModelClient:
118
123
  }
119
124
  timeout_seconds = max(1.0, float(timeout_ms) / 1000.0)
120
125
  async with httpx.AsyncClient(timeout=timeout_seconds) as client:
121
- response = await client.post(self._chat_completions_url(), headers=headers, json=payload)
126
+ response = await client.post(
127
+ self._chat_completions_url(), headers=headers, json=payload
128
+ )
122
129
  response.raise_for_status()
123
130
  data = response.json()
124
131
 
@@ -280,7 +287,9 @@ def _build_semantic_input(
280
287
  if len(selected_groups) > max_groups:
281
288
  skipped_groups = selected_groups[:-max_groups]
282
289
  selected_groups = selected_groups[-max_groups:]
283
- skipped_summary = summarize_event_groups(skipped_groups, previous_summary=merged_previous_summary)
290
+ skipped_summary = summarize_event_groups(
291
+ skipped_groups, previous_summary=merged_previous_summary
292
+ )
284
293
  merged_previous_summary = skipped_summary
285
294
  return merged_previous_summary, selected_groups
286
295
 
@@ -295,7 +304,10 @@ async def summarize_compaction(
295
304
  ) -> CompactionSummaryResult:
296
305
  """语义摘要优先,失败后自动回退到 extractive。"""
297
306
 
298
- fallback_summary = summarize_event_groups(list(groups_to_compact), previous_summary=previous_summary)
307
+ fallback_summary = summarize_event_groups(
308
+ [list(group) for group in groups_to_compact],
309
+ previous_summary=previous_summary,
310
+ )
299
311
  if semantic_compaction_disabled():
300
312
  return CompactionSummaryResult(
301
313
  summary_text=fallback_summary,
@@ -112,7 +112,6 @@ def build_heuristic_title(*, first_prompt: str, assistant_text: str) -> str:
112
112
  prompt = _normalize_source_text(first_prompt)
113
113
  assistant = _normalize_source_text(assistant_text)
114
114
  combined = f"{prompt} {assistant}".strip()
115
- prompt_lower = prompt.lower()
116
115
  combined_lower = combined.lower()
117
116
 
118
117
  if _SELF_INTRO_RE.search(prompt):
@@ -126,7 +125,9 @@ def build_heuristic_title(*, first_prompt: str, assistant_text: str) -> str:
126
125
  if _RECRUIT_RE.search(combined_lower):
127
126
  if "简历" in combined_lower or "候选人" in combined_lower:
128
127
  return "简历分析"
129
- if "面试" in combined_lower and (_ANALYZE_RE.search(combined) or _FILE_RE.search(combined_lower)):
128
+ if "面试" in combined_lower and (
129
+ _ANALYZE_RE.search(combined) or _FILE_RE.search(combined_lower)
130
+ ):
130
131
  return "面试分析"
131
132
 
132
133
  if _FILE_RE.search(combined_lower):
@@ -230,7 +231,9 @@ class SessionTitleClient:
230
231
  }
231
232
  timeout_seconds = max(1.0, float(timeout_ms) / 1000.0)
232
233
  async with httpx.AsyncClient(timeout=timeout_seconds) as client:
233
- response = await client.post(self._chat_completions_url(), headers=headers, json=payload)
234
+ response = await client.post(
235
+ self._chat_completions_url(), headers=headers, json=payload
236
+ )
234
237
  response.raise_for_status()
235
238
  data = response.json()
236
239
 
@@ -7,62 +7,61 @@
7
7
  - serverless: 金山云 Serverless 计算引擎
8
8
  """
9
9
 
10
+ # 导入并注册所有 Provider
11
+ from ksadk.deployment import providers as providers
10
12
  from ksadk.deployment.base import (
11
13
  BaseDeployProvider,
12
- DeployTarget,
13
14
  DeployResult,
14
15
  DeployStatus,
16
+ DeployTarget,
17
+ NetworkConfig,
15
18
  PackageInfo,
16
19
  ResourceSpec,
17
20
  ScalingConfig,
18
- NetworkConfig,
19
21
  )
20
22
  from ksadk.deployment.registry import DeployProviderRegistry
21
23
 
22
- # 导入并注册所有 Provider
23
- from ksadk.deployment import providers
24
-
25
24
 
26
25
  class DeploymentManager:
27
26
  """部署管理器 - 统一入口
28
-
27
+
29
28
  使用方式:
30
29
  manager = DeploymentManager()
31
30
  provider = manager.get_provider("docker")
32
31
  result = await provider.deploy(package_info, target)
33
32
  """
34
-
33
+
35
34
  @staticmethod
36
- def get_provider(name: str, config: dict = None) -> BaseDeployProvider:
35
+ def get_provider(name: str, config: dict | None = None) -> BaseDeployProvider:
37
36
  """获取部署 Provider
38
-
37
+
39
38
  Args:
40
39
  name: Provider 名称 (docker, k8s, serverless)
41
40
  config: Provider 配置
42
-
41
+
43
42
  Returns:
44
43
  Provider 实例
45
44
  """
46
45
  return DeployProviderRegistry.get(name, config)
47
-
46
+
48
47
  @staticmethod
49
48
  def list_providers() -> list:
50
49
  """列出所有可用 Provider"""
51
50
  return DeployProviderRegistry.get_provider_info()
52
-
51
+
53
52
  @staticmethod
54
53
  def has_provider(name: str) -> bool:
55
54
  """检查 Provider 是否存在"""
56
55
  return DeployProviderRegistry.has_provider(name)
57
-
56
+
58
57
  # 向后兼容: create() 方法
59
58
  @classmethod
60
- def create(cls, target: str) -> DeployTarget:
59
+ def create(cls, target: str) -> BaseDeployProvider:
61
60
  """创建部署目标
62
-
61
+
63
62
  Args:
64
63
  target: 部署目标 (docker, k8s, serverless)
65
-
64
+
66
65
  Returns:
67
66
  部署目标实例
68
67
  """
@@ -5,7 +5,6 @@ import inspect
5
5
  from contextlib import nullcontext
6
6
  from typing import Any, Awaitable, Callable, Mapping, Sequence
7
7
 
8
-
9
8
  AgentAccessDetailFetcher = Callable[[str, bool], Awaitable[dict[str, Any]]]
10
9
  AgentAccessErrorHandler = Callable[[Exception], None]
11
10
 
@@ -16,16 +15,13 @@ def canonicalize_agent_access_detail(detail: Mapping[str, Any] | None) -> dict[s
16
15
  return {}
17
16
 
18
17
  normalized = dict(detail)
19
- basic = normalized.get("basic") if isinstance(normalized.get("basic"), Mapping) else {}
20
- quick = (
21
- normalized.get("quick_access")
22
- if isinstance(normalized.get("quick_access"), Mapping)
23
- else {}
24
- )
25
- deployment = (
26
- normalized.get("deployment")
27
- if isinstance(normalized.get("deployment"), Mapping)
28
- else {}
18
+ basic_value = normalized.get("basic")
19
+ basic: Mapping[str, Any] = basic_value if isinstance(basic_value, Mapping) else {}
20
+ quick_value = normalized.get("quick_access")
21
+ quick: Mapping[str, Any] = quick_value if isinstance(quick_value, Mapping) else {}
22
+ deployment_value = normalized.get("deployment")
23
+ deployment: Mapping[str, Any] = (
24
+ deployment_value if isinstance(deployment_value, Mapping) else {}
29
25
  )
30
26
 
31
27
  def _pick(*values: Any) -> Any:
@@ -74,9 +70,8 @@ def is_agent_not_visible_yet_error(exc: Exception) -> bool:
74
70
  text = str(exc or "").lower()
75
71
  if not text:
76
72
  return False
77
- return (
78
- ("http 404" in text or "status=404" in text or "code: 404" in text)
79
- and ("未找到对应的 agent" in text or "not found" in text)
73
+ return ("http 404" in text or "status=404" in text or "code: 404" in text) and (
74
+ "未找到对应的 agent" in text or "not found" in text
80
75
  )
81
76
 
82
77
 
@@ -99,7 +94,7 @@ def is_agent_not_found_error(exc: Exception) -> bool:
99
94
  if isinstance(details, Mapping):
100
95
  http_status = details.get("http_status")
101
96
  try:
102
- if int(http_status) == 404:
97
+ if http_status is not None and int(http_status) == 404:
103
98
  return True
104
99
  except (TypeError, ValueError):
105
100
  pass
@@ -174,11 +169,7 @@ async def get_latest_agent_access(
174
169
 
175
170
  fetcher = detail_fetcher or _default_detail_fetcher
176
171
  retry_delay_values = [float(item) for item in (retry_delays or ())]
177
- attempts = (
178
- 1 + len(retry_delay_values)
179
- if retry_delay_values
180
- else max(1, int(attempts or 1))
181
- )
172
+ attempts = 1 + len(retry_delay_values) if retry_delay_values else max(1, int(attempts or 1))
182
173
  last_exc: Exception | None = None
183
174
 
184
175
  suppress_ctx = nullcontext()
@@ -205,9 +196,7 @@ async def get_latest_agent_access(
205
196
  if delay > 0:
206
197
  await asyncio.sleep(delay)
207
198
  try:
208
- detail = canonicalize_agent_access_detail(
209
- await fetcher(agent_ref, include_api_key)
210
- )
199
+ detail = canonicalize_agent_access_detail(await fetcher(agent_ref, include_api_key))
211
200
  except Exception as exc:
212
201
  last_exc = exc
213
202
  if attempt < attempts - 1 and is_agent_not_visible_yet_error(exc):
ksadk/deployment/base.py CHANGED
@@ -3,13 +3,15 @@
3
3
  """
4
4
 
5
5
  from abc import ABC, abstractmethod
6
- from typing import Dict, Any, Optional, List
7
- from pydantic import BaseModel, Field
8
6
  from enum import Enum
7
+ from typing import Any, Dict, List, Optional
8
+
9
+ from pydantic import BaseModel, Field
9
10
 
10
11
 
11
12
  class DeployStatus(str, Enum):
12
13
  """部署状态"""
14
+
13
15
  PENDING = "pending"
14
16
  PACKAGING = "packaging"
15
17
  BUILDING = "building"
@@ -26,12 +28,14 @@ class DeployStatus(str, Enum):
26
28
 
27
29
  class ResourceSpec(BaseModel):
28
30
  """资源规格"""
31
+
29
32
  cpu: str = "2"
30
33
  memory: str = "4Gi"
31
34
 
32
35
 
33
36
  class ScalingConfig(BaseModel):
34
37
  """扩缩容配置"""
38
+
35
39
  min_replicas: int = 1
36
40
  max_replicas: int = 10
37
41
  concurrency: int = 10
@@ -39,6 +43,7 @@ class ScalingConfig(BaseModel):
39
43
 
40
44
  class NetworkConfig(BaseModel):
41
45
  """网络配置"""
46
+
42
47
  access_type: str = "public" # public | private
43
48
  enable_https: bool = True
44
49
  enable_public_access: Optional[bool] = None
@@ -58,10 +63,11 @@ class StorageSpec(BaseModel):
58
63
 
59
64
  class DeployTarget(BaseModel):
60
65
  """部署目标配置"""
61
- provider: str # serverless | faas | k8s | docker
66
+
67
+ provider: str # serverless | faas | k8s | docker
62
68
  region: str = "cn-north-1"
63
69
  project_id: str = "default"
64
-
70
+
65
71
  # 通用配置
66
72
  resources: ResourceSpec = Field(default_factory=ResourceSpec)
67
73
  scaling: ScalingConfig = Field(default_factory=ScalingConfig)
@@ -74,22 +80,24 @@ class DeployTarget(BaseModel):
74
80
 
75
81
  class DeployResult(BaseModel):
76
82
  """部署结果"""
83
+
77
84
  status: DeployStatus = DeployStatus.UNKNOWN
78
85
  agent_id: Optional[str] = None
79
86
  agent_name: Optional[str] = None
80
87
  endpoint: Optional[str] = None
81
88
  api_key: Optional[str] = None
82
89
  message: str = ""
83
-
90
+
84
91
  # 额外元数据
85
92
  metadata: Dict[str, Any] = Field(default_factory=dict)
86
-
93
+
87
94
  def is_success(self) -> bool:
88
95
  return self.status in (DeployStatus.RUNNING, DeployStatus.DEPLOYING)
89
96
 
90
97
 
91
98
  class PackageInfo(BaseModel):
92
99
  """打包信息"""
100
+
93
101
  name: str
94
102
  framework: str
95
103
  build_dir: str
@@ -97,132 +105,137 @@ class PackageInfo(BaseModel):
97
105
  dockerfile: Optional[str] = None
98
106
  image: Optional[str] = None
99
107
  entry_point: str = "agent.py"
100
-
108
+
101
109
  # 额外信息
102
110
  metadata: Dict[str, Any] = Field(default_factory=dict)
103
111
 
104
112
 
105
113
  class BaseDeployProvider(ABC):
106
114
  """部署 Provider 基类
107
-
115
+
108
116
  所有部署 Provider 必须继承此类并实现抽象方法。
109
117
  """
110
-
118
+
111
119
  # Provider 标识
112
120
  name: str = "base"
113
121
  display_name: str = "Base Provider"
114
122
  description: str = ""
115
-
123
+
116
124
  # 能力标识
117
125
  supports_streaming: bool = False
118
126
  supports_scaling: bool = False
119
127
  requires_image_registry: bool = False
120
-
121
- def __init__(self, config: Dict[str, Any] = None):
128
+
129
+ def __init__(self, config: Optional[Dict[str, Any]] = None):
122
130
  """初始化 Provider
123
-
131
+
124
132
  Args:
125
133
  config: Provider 级别配置 (如 API Key、区域默认值等)
126
134
  """
127
135
  self.config = config or {}
128
-
136
+
129
137
  @abstractmethod
130
138
  async def validate_config(self, target: DeployTarget) -> tuple[bool, str]:
131
139
  """验证部署配置
132
-
140
+
133
141
  Args:
134
142
  target: 部署目标配置
135
-
143
+
136
144
  Returns:
137
145
  (is_valid, error_message)
138
146
  """
139
147
  pass
140
-
148
+
141
149
  @abstractmethod
142
- async def package(self, project_dir: str, detection_result: Any, config: Dict[str, Any] = None) -> PackageInfo:
150
+ async def package(
151
+ self,
152
+ project_dir: str,
153
+ detection_result: Any,
154
+ config: Optional[Dict[str, Any]] = None,
155
+ ) -> PackageInfo:
143
156
  """打包项目
144
-
157
+
145
158
  Args:
146
159
  project_dir: 项目目录
147
160
  detection_result: 框架检测结果
148
161
  config: 项目配置 (agentengine.yaml)
149
-
162
+
150
163
  Returns:
151
164
  打包信息
152
165
  """
153
166
  pass
154
-
167
+
155
168
  @abstractmethod
156
169
  async def build(self, package_info: PackageInfo, target: DeployTarget) -> PackageInfo:
157
170
  """构建镜像/代码包
158
-
171
+
159
172
  Args:
160
173
  package_info: 打包信息
161
174
  target: 部署目标
162
-
175
+
163
176
  Returns:
164
177
  更新后的打包信息 (含镜像地址等)
165
178
  """
166
179
  pass
167
-
180
+
168
181
  @abstractmethod
169
182
  async def deploy(self, package_info: PackageInfo, target: DeployTarget) -> DeployResult:
170
183
  """部署
171
-
184
+
172
185
  Args:
173
186
  package_info: 打包信息
174
187
  target: 部署目标
175
-
188
+
176
189
  Returns:
177
190
  部署结果
178
191
  """
179
192
  pass
180
-
193
+
181
194
  @abstractmethod
182
195
  async def get_status(self, agent_id: str, target: DeployTarget) -> DeployResult:
183
196
  """获取部署状态
184
-
197
+
185
198
  Args:
186
199
  agent_id: Agent ID
187
200
  target: 部署目标
188
-
201
+
189
202
  Returns:
190
203
  部署状态
191
204
  """
192
205
  pass
193
-
206
+
194
207
  @abstractmethod
195
208
  async def destroy(self, agent_id: str, target: DeployTarget) -> bool:
196
209
  """销毁部署
197
-
210
+
198
211
  Args:
199
212
  agent_id: Agent ID
200
213
  target: 部署目标
201
-
214
+
202
215
  Returns:
203
216
  是否成功
204
217
  """
205
218
  pass
206
-
219
+
207
220
  async def list_agents(self, target: DeployTarget) -> List[DeployResult]:
208
221
  """列出所有 Agent (可选实现)
209
-
222
+
210
223
  Args:
211
224
  target: 部署目标
212
-
225
+
213
226
  Returns:
214
227
  Agent 列表
215
228
  """
216
229
  raise NotImplementedError(f"{self.name} does not support list_agents")
217
-
230
+
218
231
  async def invoke(self, agent_id: str, message: str, target: DeployTarget) -> str:
219
232
  """调用 Agent (可选实现)
220
-
233
+
221
234
  Args:
222
235
  agent_id: Agent ID
223
236
  message: 输入消息
224
237
  target: 部署目标
225
-
238
+
226
239
  Returns:
227
240
  Agent 响应
228
241
  """
@@ -0,0 +1,33 @@
1
+ """Local manifest assembly for server-managed runtime deployments."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from pathlib import Path
6
+
7
+ from ksadk.builders.managed_runtime_builder import ManagedRuntimeBuilder
8
+ from ksadk.deployment.base import DeployTarget, PackageInfo
9
+
10
+
11
+ def build_managed_runtime_package(
12
+ package_info: PackageInfo, target: DeployTarget
13
+ ) -> PackageInfo:
14
+ """Build the canonical manifest and retain its integrity digest for deploy."""
15
+
16
+ builder = ManagedRuntimeBuilder(
17
+ Path(package_info.project_dir),
18
+ runtime_version=str(target.extra.get("runtime_version") or ""),
19
+ )
20
+ result = builder.build()
21
+ if not result.success:
22
+ raise RuntimeError(f"构建失败: {result.error_message}")
23
+
24
+ package_info.metadata.update(result.metadata)
25
+ manifest_sha256 = str(result.metadata.get("manifest_sha256") or "").strip()
26
+ if manifest_sha256:
27
+ target.extra["manifest_sha256"] = manifest_sha256
28
+ if result.artifact_path is not None:
29
+ package_info.metadata["managed_manifest_path"] = str(result.artifact_path)
30
+ return package_info
31
+
32
+
33
+ __all__ = ["build_managed_runtime_package"]