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
@@ -71,44 +71,3 @@ def prepare_trace_metadata(
71
71
  pass
72
72
 
73
73
  return user_id, tags, version, agent_name
74
-
75
-
76
- def get_langfuse_callback(
77
- session_id: str,
78
- user_id: Optional[str] = None,
79
- tags: Optional[List[str]] = None,
80
- version: Optional[str] = None,
81
- trace_name: Optional[str] = None,
82
- ) -> Optional[Any]:
83
- """获取 Langfuse Callback Handler
84
-
85
- Args:
86
- session_id: 会话 ID
87
- user_id: 用户 ID
88
- tags: 标签列表
89
- version: 版本号
90
- trace_name: Trace 名称
91
-
92
- Returns:
93
- Langfuse callback handler 或 None
94
- """
95
- try:
96
- from ksadk.tracing import get_langfuse_callback_handler
97
-
98
- handler = get_langfuse_callback_handler()
99
- if handler:
100
- # 设置 session 和 metadata
101
- handler.session_id = session_id
102
- if user_id:
103
- handler.user_id = user_id
104
- if tags:
105
- handler.tags = tags
106
- if version:
107
- handler.version = version
108
- if trace_name:
109
- handler.trace_name = trace_name
110
- return handler
111
- except ImportError:
112
- return None
113
- except Exception:
114
- return None
ksadk/tui/loop.py CHANGED
@@ -3,6 +3,7 @@
3
3
  Transcript 使用 ANSI 保留 rich 颜色和 Markdown 落定格式,composer 紧跟内容,
4
4
  终端原生 scrollback 保留。支持键盘滚动、流式跟底和输入排队。
5
5
  """
6
+
6
7
  from __future__ import annotations
7
8
 
8
9
  import asyncio
@@ -105,7 +106,11 @@ def _codex_surface_rgb(
105
106
  # so 4% black on a light terminal is visually imperceptible; 8% gives the
106
107
  # input surface a stable edge without introducing a border.
107
108
  alpha = 0.08 if is_light and composer else 0.04 if is_light else 0.12
108
- return tuple(int(top[i] * alpha + background[i] * (1.0 - alpha)) for i in range(3))
109
+ return (
110
+ int(top[0] * alpha + background[0] * (1.0 - alpha)),
111
+ int(top[1] * alpha + background[1] * (1.0 - alpha)),
112
+ int(top[2] * alpha + background[2] * (1.0 - alpha)),
113
+ )
109
114
 
110
115
 
111
116
  def _codex_surface_style(background: tuple[int, int, int] | None) -> str:
@@ -319,12 +324,16 @@ class SlashCommandCompleter(Completer):
319
324
  return
320
325
  # /model <prefix> → 补全可选模型 id
321
326
  if prefix.startswith("/model ") and self.runner is not None:
322
- model_prefix = prefix[len("/model "):].strip()
327
+ model_prefix = prefix[len("/model ") :].strip()
323
328
  available = getattr(self.runner, "available_models", None) or []
324
329
  for m in available:
325
330
  mid = str(m.get("id") or m.get("name") or "")
326
331
  if mid and mid.startswith(model_prefix):
327
- yield Completion(mid, start_position=-len(model_prefix), display_meta=m.get("display_name") or "")
332
+ yield Completion(
333
+ mid,
334
+ start_position=-len(model_prefix),
335
+ display_meta=m.get("display_name") or "",
336
+ )
328
337
  return
329
338
  for command, meta in self._COMMANDS.items():
330
339
  if command.startswith(prefix):
@@ -372,7 +381,7 @@ class RichLiveRenderer:
372
381
  self.assistant_entry.content = full_text
373
382
  self.assistant_entry.status = "streaming"
374
383
  if full_text.startswith(self._last_full_text):
375
- delta = full_text[len(self._last_full_text):]
384
+ delta = full_text[len(self._last_full_text) :]
376
385
  else:
377
386
  # A final/snapshot event can replace the cumulative text. Preserve
378
387
  # ordering when possible; without tools it is safe to replace the
@@ -398,7 +407,9 @@ class RichLiveRenderer:
398
407
  self.assistant_entry.thinking = full_thinking
399
408
  # thinking 不进动态区,落定时随 assistant 一起渲染(show_thinking)
400
409
 
401
- async def on_tool_call(self, tool_name: str, status: str, args: Any = None, call_id: str = "") -> None:
410
+ async def on_tool_call(
411
+ self, tool_name: str, status: str, args: Any = None, call_id: str = ""
412
+ ) -> None:
402
413
  if self.loop is None:
403
414
  return
404
415
  content = f"{tool_name} [{status}]"
@@ -441,7 +452,7 @@ class RichLiveRenderer:
441
452
  def final_entries(self, response: str) -> list[TranscriptEntry]:
442
453
  """Return finalized display cells in the original stream event order."""
443
454
  if response and response.startswith(self._last_full_text):
444
- delta = response[len(self._last_full_text):]
455
+ delta = response[len(self._last_full_text) :]
445
456
  if delta:
446
457
  if self._active_text_entry is None:
447
458
  self._active_text_entry = TranscriptEntry(role="assistant")
@@ -507,7 +518,9 @@ class InteractionLoop:
507
518
  self._pin_to_bottom = True
508
519
  self._last_max_scroll = 0
509
520
  self._history_pager_active = False
510
- self._entry_ansi_cache: dict[int, str] = {} # 历史 entries ANSI 缓存(避免 streaming 全量重渲)
521
+ self._entry_ansi_cache: dict[int, str] = (
522
+ {}
523
+ ) # 历史 entries ANSI 缓存(避免 streaming 全量重渲)
511
524
  self._last_usage: dict[str, Any] | None = None
512
525
  self._showed_help = False # 首次运行显示帮助列表
513
526
  self._welcome_ansi: str | None = None
@@ -600,6 +613,7 @@ class InteractionLoop:
600
613
  multiline=True,
601
614
  history=InMemoryHistory(),
602
615
  )
616
+ input_buffer = self._input_buffer
603
617
 
604
618
  # Codex uses an inline, content-first viewport: short transcripts keep
605
619
  # the composer directly below the content and a filler absorbs the rest
@@ -771,13 +785,13 @@ class InteractionLoop:
771
785
 
772
786
  @bindings.add("enter")
773
787
  def _submit(event) -> None:
774
- text = self._input_buffer.text
775
- self._input_buffer.reset(append_to_history=bool(text.strip()))
788
+ text = input_buffer.text
789
+ input_buffer.reset(append_to_history=bool(text.strip()))
776
790
  self._submit_text(text)
777
791
 
778
792
  @bindings.add("escape", "enter")
779
793
  def _newline(event) -> None:
780
- self._input_buffer.insert_text("\n")
794
+ input_buffer.insert_text("\n")
781
795
 
782
796
  @bindings.add("c-c")
783
797
  def _interrupt_or_exit(event) -> None:
@@ -796,7 +810,7 @@ class InteractionLoop:
796
810
 
797
811
  @bindings.add("c-d")
798
812
  def _exit_on_empty(event) -> None:
799
- if not self._input_buffer.text:
813
+ if not input_buffer.text:
800
814
  event.app.exit()
801
815
 
802
816
  @bindings.add("pageup")
@@ -835,14 +849,18 @@ class InteractionLoop:
835
849
  @bindings.add("up", filter=self._picker_condition)
836
850
  def _picker_up(event) -> None:
837
851
  if self._model_picker_models:
838
- self._model_picker_index = (self._model_picker_index - 1) % len(self._model_picker_models)
852
+ self._model_picker_index = (self._model_picker_index - 1) % len(
853
+ self._model_picker_models
854
+ )
839
855
  self._scroll_picker_to_selected()
840
856
  event.app.invalidate()
841
857
 
842
858
  @bindings.add("down", filter=self._picker_condition)
843
859
  def _picker_down(event) -> None:
844
860
  if self._model_picker_models:
845
- self._model_picker_index = (self._model_picker_index + 1) % len(self._model_picker_models)
861
+ self._model_picker_index = (self._model_picker_index + 1) % len(
862
+ self._model_picker_models
863
+ )
846
864
  self._scroll_picker_to_selected()
847
865
  event.app.invalidate()
848
866
 
@@ -850,7 +868,11 @@ class InteractionLoop:
850
868
  def _picker_select(event) -> None:
851
869
  models = self._model_picker_models
852
870
  if models and 0 <= self._model_picker_index < len(models):
853
- mid = str(models[self._model_picker_index].get("id") or models[self._model_picker_index].get("name") or "")
871
+ mid = str(
872
+ models[self._model_picker_index].get("id")
873
+ or models[self._model_picker_index].get("name")
874
+ or ""
875
+ )
854
876
  if mid:
855
877
  self._apply_model_switch(mid)
856
878
  self._close_model_picker()
@@ -980,7 +1002,9 @@ class InteractionLoop:
980
1002
  for entry in renderer.final_entries(renderer._last_full_text):
981
1003
  await self._commit_entry(entry)
982
1004
  if is_resume:
983
- await self._commit_entry(TranscriptEntry(role="system", content="该 runtime 暂不支持审批续跑,已取消"))
1005
+ await self._commit_entry(
1006
+ TranscriptEntry(role="system", content="该 runtime 暂不支持审批续跑,已取消")
1007
+ )
984
1008
  self._clear_current_task()
985
1009
  self._drain_queue()
986
1010
  else:
@@ -992,7 +1016,9 @@ class InteractionLoop:
992
1016
  assistant_entry.status = ""
993
1017
  for entry in renderer.final_entries(renderer._last_full_text):
994
1018
  await self._commit_entry(entry)
995
- await self._commit_entry(TranscriptEntry(role="system", content="已取消(保留已产生内容)"))
1019
+ await self._commit_entry(
1020
+ TranscriptEntry(role="system", content="已取消(保留已产生内容)")
1021
+ )
996
1022
  self._clear_current_task()
997
1023
  self._drain_queue()
998
1024
  return
@@ -1018,7 +1044,9 @@ class InteractionLoop:
1018
1044
 
1019
1045
  async def _prompt():
1020
1046
  await self._commit_entry(
1021
- TranscriptEntry(role="system", content=f"确认执行 {tool_name}? 输入 y 确认,其他内容取消")
1047
+ TranscriptEntry(
1048
+ role="system", content=f"确认执行 {tool_name}? 输入 y 确认,其他内容取消"
1049
+ )
1022
1050
  )
1023
1051
 
1024
1052
  self._create_background_task(_prompt())
@@ -1032,7 +1060,9 @@ class InteractionLoop:
1032
1060
  if user_input.lower() in {"y", "yes"}:
1033
1061
 
1034
1062
  async def _resume():
1035
- await self._commit_entry(TranscriptEntry(role="system", content="已确认,尝试续跑..."))
1063
+ await self._commit_entry(
1064
+ TranscriptEntry(role="system", content="已确认,尝试续跑...")
1065
+ )
1036
1066
  self._start_turn(
1037
1067
  "",
1038
1068
  input_data={**input_data, "resume": True},
@@ -1049,7 +1079,11 @@ class InteractionLoop:
1049
1079
  self._create_background_task(_cancel())
1050
1080
 
1051
1081
  def _drain_queue(self) -> None:
1052
- if self._pending_interrupt is not None or self._has_active_turn() or not self._queued_inputs:
1082
+ if (
1083
+ self._pending_interrupt is not None
1084
+ or self._has_active_turn()
1085
+ or not self._queued_inputs
1086
+ ):
1053
1087
  return
1054
1088
  item = self._queued_inputs.pop(0)
1055
1089
  self._start_turn(item.text, user_entry=item.entry)
@@ -1167,7 +1201,7 @@ class InteractionLoop:
1167
1201
 
1168
1202
  def _handle_model_command(self, user_input: str) -> None:
1169
1203
  """/model:弹出交互式选择器(↑↓ Enter Esc);/model <name>:直接切换(runnable 级,下轮生效)。"""
1170
- arg = user_input[len("/model"):].strip()
1204
+ arg = user_input[len("/model") :].strip()
1171
1205
  if arg:
1172
1206
  # 直接切换:改 runner.model,下轮请求带新 model
1173
1207
  self._apply_model_switch(arg)
@@ -1192,7 +1226,9 @@ class InteractionLoop:
1192
1226
  """
1193
1227
  self.runner.model = model_id
1194
1228
  available = getattr(self.runner, "available_models", None) or []
1195
- matched = next((m for m in available if str(m.get("id") or m.get("name") or "") == model_id), None)
1229
+ matched = next(
1230
+ (m for m in available if str(m.get("id") or m.get("name") or "") == model_id), None
1231
+ )
1196
1232
  if matched:
1197
1233
  self.runner.model_metadata = matched
1198
1234
  # 清旧观察名,让 _current_model_name 用新 runner.model
@@ -1263,8 +1299,8 @@ class InteractionLoop:
1263
1299
  frags: list[tuple[str, str]] = []
1264
1300
  for i, m in enumerate(self._model_picker_models):
1265
1301
  mid = str(m.get("id") or m.get("name") or "")
1266
- is_cur_model = (mid == current)
1267
- is_selected = (i == self._model_picker_index)
1302
+ is_cur_model = mid == current
1303
+ is_selected = i == self._model_picker_index
1268
1304
  marker = "›" if is_selected else " "
1269
1305
  line = f"{marker} {i + 1}. {mid}"
1270
1306
  if is_cur_model:
@@ -1276,7 +1312,7 @@ class InteractionLoop:
1276
1312
  # ---- streaming / transcript 渲染 ----
1277
1313
 
1278
1314
  def _set_streaming(self, full_text: str) -> None:
1279
- """streaming 文本更新到当前 streaming entry(动态区 = transcript 末尾的 streaming entry)。"""
1315
+ """更新 transcript 末尾的 streaming entry。"""
1280
1316
  if self._streaming_entry is not None:
1281
1317
  self._streaming_entry.content = full_text
1282
1318
  self._streaming_entry.status = "streaming"
@@ -1365,6 +1401,7 @@ class InteractionLoop:
1365
1401
  height = int(getattr(ri, "window_height", 0) or 0)
1366
1402
  if height <= 0:
1367
1403
  import shutil
1404
+
1368
1405
  height = max(10, (shutil.get_terminal_size(fallback=(80, 24)).lines or 24) - 6)
1369
1406
  line_count = self._transcript_line_count()
1370
1407
  return max(0, line_count - height)
@@ -1522,18 +1559,22 @@ def _resolve_model_name(runner) -> str:
1522
1559
  return str(meta["id"])
1523
1560
  observed = getattr(runner, "_observed_model", None)
1524
1561
  if observed:
1525
- return observed
1526
- return getattr(runner, "model", None) or os.getenv("MODEL_NAME") or "unknown"
1562
+ return str(observed)
1563
+ return str(getattr(runner, "model", None) or os.getenv("MODEL_NAME") or "unknown")
1527
1564
 
1528
1565
 
1529
1566
  def _help_text() -> str:
1530
- return "命令: /new 新会话 · /clear 清屏 · /session 查看 · /tools 展开工具 · exit 退出 · Ctrl-C 中断/退出"
1567
+ return (
1568
+ "命令: /new 新会话 · /clear 清屏 · /session 查看 · /tools 展开工具 "
1569
+ "· exit 退出 · Ctrl-C 中断/退出"
1570
+ )
1531
1571
 
1532
1572
 
1533
1573
  def _welcome_block(session_id: str, model_name: str, project_dir: Path, *, show_help: bool) -> str:
1534
1574
  """Render the compact Codex-style session card and one-line tip."""
1535
1575
  try:
1536
1576
  from ksadk.version import VERSION
1577
+
1537
1578
  version = VERSION
1538
1579
  except Exception:
1539
1580
  version = ""
@@ -1552,6 +1593,7 @@ def _welcome_block(session_id: str, model_name: str, project_dir: Path, *, show_
1552
1593
  # 按终端宽度算框宽,留 transcript 左缩进 2 + 右 margin 2,上限 56(Codex 同款)。
1553
1594
  try:
1554
1595
  import shutil
1596
+
1555
1597
  cols = shutil.get_terminal_size(fallback=(80, 24)).columns
1556
1598
  except Exception:
1557
1599
  cols = 80
@@ -1698,7 +1740,9 @@ def _render_entry_ansi(
1698
1740
  else:
1699
1741
  console.print(Markdown(_normalize_markdown(f"{body}{suffix}")))
1700
1742
  else:
1701
- console.print(Text(suffix.lstrip(), style="dim") if suffix else Text("...", style="dim"))
1743
+ console.print(
1744
+ Text(suffix.lstrip(), style="dim") if suffix else Text("...", style="dim")
1745
+ )
1702
1746
  return _strip_ansi_backgrounds(console.export_text(styles=True)).rstrip() + "\n"
1703
1747
 
1704
1748
  if entry.role == "tool":
@@ -1718,6 +1762,7 @@ def _render_entry_ansi(
1718
1762
  display_output = output
1719
1763
  try:
1720
1764
  import json as _json
1765
+
1721
1766
  parsed = _json.loads(output)
1722
1767
  # Tool adapters often JSON-encode an already serialized result.
1723
1768
  # Unwrap that second layer so structured output folds by fields
@@ -1729,7 +1774,7 @@ def _render_entry_ansi(
1729
1774
  if nested.startswith("content="):
1730
1775
  import ast as _ast
1731
1776
 
1732
- quote = nested[len("content="):len("content=") + 1]
1777
+ quote = nested[len("content=") : len("content=") + 1]
1733
1778
  if quote in {"'", '"'}:
1734
1779
  body_start = len("content=") + 1
1735
1780
  body_end = body_start
@@ -1756,6 +1801,7 @@ def _render_entry_ansi(
1756
1801
  pass
1757
1802
  # 估算显示行数:每行按 console width 折算(长字符串占多行)
1758
1803
  import shutil as _su
1804
+
1759
1805
  cw = max(40, (_su.get_terminal_size(fallback=(80, 24)).columns or 80) - 6)
1760
1806
  logical_lines = display_output.split("\n")
1761
1807
  # 估算显示行数:按显示宽度(CJK 占 2)折算,非 len
@@ -1864,7 +1910,9 @@ def _strip_ansi_backgrounds(text: str) -> str:
1864
1910
  return re.sub(r"\x1b\[([0-9;]*)m", _clean, text)
1865
1911
 
1866
1912
 
1867
- def run_tui(runner, *, show_thinking: bool = False, project_dir: str = ".", no_alt_screen: bool = False) -> None:
1913
+ def run_tui(
1914
+ runner, *, show_thinking: bool = False, project_dir: str = ".", no_alt_screen: bool = False
1915
+ ) -> None:
1868
1916
  """TUI 入口:被 cmd_invoke._invoke_tui / cmd_run._run_custom 调用。
1869
1917
 
1870
1918
  ``no_alt_screen`` 作为兼容参数保留;TUI 现在默认使用 Codex-style inline viewport。
@@ -3,6 +3,7 @@
3
3
  从 RemoteRunner.stream 的归一化 chunk 提取 delta/usage/终止信号,格式化 usage 文本。
4
4
  被 loop.py(交互 TUI)和 cmd_invoke._invoke_once(-m 单次)共用,保证两路径渲染口径一致。
5
5
  """
6
+
6
7
  from __future__ import annotations
7
8
 
8
9
  import re
ksadk/ui_config.py CHANGED
@@ -6,7 +6,6 @@ from dataclasses import dataclass
6
6
  from typing import Any, Dict, Optional, Tuple
7
7
  from urllib.parse import urlsplit
8
8
 
9
-
10
9
  UI_PROFILE_AUTO = "auto"
11
10
  UI_PROFILE_ADK = "adk"
12
11
  UI_PROFILE_LANGCHAIN = "langchain"
@@ -89,11 +88,14 @@ def default_ui_path(profile: str) -> str:
89
88
  return _DEFAULT_PATH_BY_PROFILE.get(profile, "/")
90
89
 
91
90
 
92
- def extract_ui_state(state: Optional[Dict[str, Any]]) -> Tuple[Optional[str], Optional[str], Optional[str]]:
91
+ def extract_ui_state(
92
+ state: Optional[Dict[str, Any]],
93
+ ) -> Tuple[Optional[str], Optional[str], Optional[str]]:
93
94
  if not isinstance(state, dict):
94
95
  return None, None, None
95
96
 
96
- nested = state.get("ui") if isinstance(state.get("ui"), dict) else {}
97
+ nested_value = state.get("ui")
98
+ nested: Dict[str, Any] = nested_value if isinstance(nested_value, dict) else {}
97
99
 
98
100
  profile = state.get("ui_profile") or nested.get("profile")
99
101
  path = state.get("ui_path") or nested.get("path")
ksadk/version.py CHANGED
@@ -1,4 +1,4 @@
1
1
  """KsADK 版本信息"""
2
2
 
3
- VERSION = "0.7.0"
3
+ VERSION = "0.8.1"
4
4
  __version__ = VERSION
@@ -1,56 +1,56 @@
1
- """Memory backend provider registry."""
2
-
3
- from __future__ import annotations
4
-
5
- from typing import Any, Protocol
6
-
7
- from pydantic import BaseModel, Field
8
-
9
- from ksadk_runtime_common.memory_backend.manifest import MemoryBackendManifest
10
-
11
-
12
- class RenderResult(BaseModel):
13
- """Result from rendering a memory backend config."""
14
-
15
- backend_type: str
16
- config_patch: dict[str, Any] = Field(default_factory=dict)
17
- required_env: list[str] = Field(default_factory=list)
18
- plugin_ids: list[str] = Field(default_factory=list)
19
- disabled_plugin_ids: list[str] = Field(default_factory=list)
20
- clear_plugin_slots: list[str] = Field(default_factory=list)
21
-
22
-
23
- class ProviderProtocol(Protocol):
24
- """Protocol for memory backend providers."""
25
-
26
- def render(self, manifest: MemoryBackendManifest) -> RenderResult: ...
27
-
28
-
29
- _PROVIDERS: dict[str, ProviderProtocol] = {}
30
-
31
-
32
- def register_provider(backend_type: str, provider: ProviderProtocol) -> None:
33
- """Register a memory backend provider."""
34
- _PROVIDERS[backend_type] = provider
35
-
36
-
37
- def get_provider(backend_type: str) -> ProviderProtocol | None:
38
- """Get a registered provider by backend type."""
39
- return _PROVIDERS.get(backend_type)
40
-
41
-
42
- def list_providers() -> list[str]:
43
- """List registered backend type identifiers."""
44
- return list(_PROVIDERS.keys())
45
-
46
-
47
- def _register_builtin_providers() -> None:
48
- """Register providers shipped in this repo copy."""
49
- from ksadk_runtime_common.memory_backend.providers.mem0 import Mem0Provider
50
- from ksadk_runtime_common.memory_backend.providers.lancedb import LanceDBProvider
51
-
52
- register_provider("mem0", Mem0Provider())
53
- register_provider("lancedb", LanceDBProvider())
54
-
55
-
56
- _register_builtin_providers()
1
+ """Memory backend provider registry."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any, Protocol
6
+
7
+ from pydantic import BaseModel, Field
8
+
9
+ from ksadk_runtime_common.memory_backend.manifest import MemoryBackendManifest
10
+
11
+
12
+ class RenderResult(BaseModel):
13
+ """Result from rendering a memory backend config."""
14
+
15
+ backend_type: str
16
+ config_patch: dict[str, Any] = Field(default_factory=dict)
17
+ required_env: list[str] = Field(default_factory=list)
18
+ plugin_ids: list[str] = Field(default_factory=list)
19
+ disabled_plugin_ids: list[str] = Field(default_factory=list)
20
+ clear_plugin_slots: list[str] = Field(default_factory=list)
21
+
22
+
23
+ class ProviderProtocol(Protocol):
24
+ """Protocol for memory backend providers."""
25
+
26
+ def render(self, manifest: MemoryBackendManifest) -> RenderResult: ...
27
+
28
+
29
+ _PROVIDERS: dict[str, ProviderProtocol] = {}
30
+
31
+
32
+ def register_provider(backend_type: str, provider: ProviderProtocol) -> None:
33
+ """Register a memory backend provider."""
34
+ _PROVIDERS[backend_type] = provider
35
+
36
+
37
+ def get_provider(backend_type: str) -> ProviderProtocol | None:
38
+ """Get a registered provider by backend type."""
39
+ return _PROVIDERS.get(backend_type)
40
+
41
+
42
+ def list_providers() -> list[str]:
43
+ """List registered backend type identifiers."""
44
+ return list(_PROVIDERS.keys())
45
+
46
+
47
+ def _register_builtin_providers() -> None:
48
+ """Register providers shipped in this repo copy."""
49
+ from ksadk_runtime_common.memory_backend.providers.lancedb import LanceDBProvider
50
+ from ksadk_runtime_common.memory_backend.providers.mem0 import Mem0Provider
51
+
52
+ register_provider("mem0", Mem0Provider())
53
+ register_provider("lancedb", LanceDBProvider())
54
+
55
+
56
+ _register_builtin_providers()
@@ -0,0 +1,95 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://kingsoftcloud.github.io/ksadk-python/schemas/runtime_event_v1.json",
4
+ "title": "RuntimeEvent v1",
5
+ "description": "RuntimeEvent v1 信封 (goal-02 / G0.2 冻结)。additive 演进:只增字段/事件类型,不改既有字段语义。",
6
+ "type": "object",
7
+ "required": [
8
+ "schema_version",
9
+ "event_id",
10
+ "event_type",
11
+ "timestamp",
12
+ "agent_id",
13
+ "user_id",
14
+ "session_id",
15
+ "invocation_id",
16
+ "seq_id",
17
+ "payload"
18
+ ],
19
+ "properties": {
20
+ "schema_version": {"const": 1},
21
+ "event_id": {"type": "string", "minLength": 1},
22
+ "event_type": {"type": "string", "minLength": 1},
23
+ "timestamp": {"type": "number"},
24
+ "agent_id": {"type": "string"},
25
+ "user_id": {"type": "string"},
26
+ "session_id": {"type": "string"},
27
+ "invocation_id": {"type": "string"},
28
+ "seq_id": {"type": "integer"},
29
+ "phase": {"enum": ["commentary", "final_answer"]},
30
+ "payload": {"type": "object"}
31
+ },
32
+ "additionalProperties": false,
33
+ "allOf": [
34
+ {
35
+ "if": {"properties": {"event_type": {"enum": ["text.delta", "text.completed"]}}},
36
+ "then": {"properties": {"payload": {"required": ["text"]}}}
37
+ },
38
+ {
39
+ "if": {"properties": {"event_type": {"enum": ["reasoning.delta", "reasoning.completed"]}}},
40
+ "then": {"properties": {"payload": {"required": ["text"]}}}
41
+ },
42
+ {
43
+ "if": {"properties": {"event_type": {"enum": ["tool.call.begin", "tool.call.end"]}}},
44
+ "then": {"properties": {"payload": {"required": ["call_id", "name"]}}}
45
+ },
46
+ {
47
+ "if": {"properties": {"event_type": {"enum": ["artifact.created", "artifact.updated"]}}},
48
+ "then": {"properties": {"payload": {"required": ["name", "version"]}}}
49
+ },
50
+ {
51
+ "if": {"properties": {"event_type": {"const": "approval.requested"}}},
52
+ "then": {"properties": {"payload": {"required": ["approval_id", "call_id", "kind"]}}}
53
+ },
54
+ {
55
+ "if": {"properties": {"event_type": {"const": "approval.resolved"}}},
56
+ "then": {"properties": {"payload": {"required": ["approval_id", "call_id", "decision"]}}}
57
+ },
58
+ {
59
+ "if": {"properties": {"event_type": {"enum": ["run.started", "run.progress", "run.interrupted", "run.completed", "run.canceled"]}}},
60
+ "then": {"properties": {"payload": {"required": ["status"]}}}
61
+ },
62
+ {
63
+ "if": {"properties": {"event_type": {"const": "run.failed"}}},
64
+ "then": {"properties": {"payload": {"required": ["status", "error"]}}}
65
+ },
66
+ {
67
+ "if": {"properties": {"event_type": {"const": "checkpoint.created"}}},
68
+ "then": {"properties": {"payload": {"required": ["checkpoint_id", "granularity"]}}}
69
+ },
70
+ {
71
+ "if": {"properties": {"event_type": {"const": "checkpoint.resumed"}}},
72
+ "then": {"properties": {"payload": {"required": ["checkpoint_id"]}}}
73
+ },
74
+ {
75
+ "if": {"properties": {"event_type": {"const": "usage.reported"}}},
76
+ "then": {"properties": {"payload": {"required": ["input_tokens", "output_tokens", "total_tokens"]}}}
77
+ },
78
+ {
79
+ "if": {"properties": {"event_type": {"enum": ["a2ui.surface.begin", "a2ui.surface.update", "a2ui.surface.end", "a2ui.interaction", "a2ui.action"]}}},
80
+ "then": {"properties": {"payload": {"required": ["surface_id"]}}}
81
+ },
82
+ {
83
+ "if": {"properties": {"event_type": {"const": "a2a.task.created"}}},
84
+ "then": {"properties": {"payload": {"required": ["task_id", "origin"]}}}
85
+ },
86
+ {
87
+ "if": {"properties": {"event_type": {"const": "a2a.task.status"}}},
88
+ "then": {"properties": {"payload": {"required": ["task_id", "origin", "status"]}}}
89
+ },
90
+ {
91
+ "if": {"properties": {"event_type": {"const": "a2a.task.artifact"}}},
92
+ "then": {"properties": {"payload": {"required": ["task_id", "origin"]}}}
93
+ }
94
+ ]
95
+ }
@@ -139,7 +139,11 @@ def create_workspace_files_router(
139
139
  archive.write(resolved_entry, resolved_entry.relative_to(root).as_posix())
140
140
 
141
141
  buf.seek(0)
142
- zip_name = f"workspace-{normalized.replace('/', '-')}.zip" if normalized != "." else "workspace.zip"
142
+ zip_name = (
143
+ f"workspace-{normalized.replace('/', '-')}.zip"
144
+ if normalized != "."
145
+ else "workspace.zip"
146
+ )
143
147
  return StreamingResponse(
144
148
  buf,
145
149
  media_type="application/zip",
@@ -173,7 +177,9 @@ def create_workspace_files_router(
173
177
  if not target.exists() or not target.is_file():
174
178
  raise HTTPException(status_code=404, detail="workspace file not found")
175
179
  media_type, _ = mimetypes.guess_type(target.name)
176
- is_html = (media_type or "").split(";")[0].lower() == "text/html" or target.suffix.lower() in {
180
+ is_html = (media_type or "").split(";")[
181
+ 0
182
+ ].lower() == "text/html" or target.suffix.lower() in {
177
183
  ".html",
178
184
  ".htm",
179
185
  }