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,265 @@
1
+ """Detached streaming and per-app resource lifecycle."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import logging
7
+ import os
8
+ from collections.abc import AsyncIterator, Mapping
9
+ from typing import Any
10
+
11
+ from fastapi import HTTPException
12
+ from fastapi.responses import StreamingResponse
13
+
14
+ from ksadk.conversations.runtime_persistence import append_run_status_event
15
+ from ksadk.server.factory import get_state
16
+
17
+ from .models import _RUN_TERMINAL_STATUSES
18
+ from .projection import _latest_invocation_status
19
+
20
+ logger = logging.getLogger(__name__)
21
+ SSE_HEARTBEAT_INTERVAL_SECONDS = max(
22
+ 0.01,
23
+ float(os.getenv("AGENTENGINE_SSE_HEARTBEAT_SECONDS", "15")),
24
+ )
25
+
26
+ _RESERVED_UI_PATHS = {"/", "/chat", "/build", "/deploy"}
27
+ _CUSTOM_API_PROXY_ENV_KEYS = ("KSADK_USER_BACKEND_URL", "LUOLUO_USER_BACKEND_URL")
28
+ _HOP_BY_HOP_HEADERS = {
29
+ "connection",
30
+ "keep-alive",
31
+ "proxy-authenticate",
32
+ "proxy-authorization",
33
+ "te",
34
+ "trailer",
35
+ "transfer-encoding",
36
+ "upgrade",
37
+ "host",
38
+ "content-length",
39
+ }
40
+
41
+
42
+ def _observe_detached_task_result(task: asyncio.Task[Any]) -> None:
43
+ """Consume a detached task exception after ``_consume`` has logged it."""
44
+ if task.cancelled():
45
+ return
46
+ task.exception()
47
+
48
+
49
+ class _DetachedSSEStream:
50
+ _MAX_BACKLOG_CHUNKS = 256
51
+
52
+ def __init__(
53
+ self,
54
+ source: AsyncIterator[str],
55
+ *,
56
+ invocation_id: str | None = None,
57
+ session_id: str | None = None,
58
+ run_mode: str = "unknown",
59
+ run_trigger: str = "unknown",
60
+ ):
61
+ self._source = source
62
+ self.invocation_id = invocation_id
63
+ self.session_id = session_id
64
+ self._run_mode = run_mode
65
+ self._run_trigger = run_trigger
66
+ self._subscribers: set[asyncio.Queue[str | None]] = set()
67
+ self._backlog: list[str] = []
68
+ self._done = False
69
+ # 后台 task 脱离请求上下文,创建时捕获 per-app registry(goal-01)。
70
+ self._registry = get_state().stream_registry
71
+ self._task = asyncio.create_task(self._consume())
72
+ self._registry.streams.add(self._task)
73
+ self._task.add_done_callback(self._registry.streams.discard)
74
+ self._task.add_done_callback(_observe_detached_task_result)
75
+ if self.invocation_id:
76
+ self._registry.streams_by_invocation[self.invocation_id] = self
77
+ self._task.add_done_callback(
78
+ lambda _task: self._registry.streams_by_invocation.pop(
79
+ self.invocation_id or "", None
80
+ )
81
+ )
82
+
83
+ async def _has_terminal_run_status(self) -> bool:
84
+ if not self.session_id or not self.invocation_id:
85
+ return False
86
+ status = await _latest_invocation_status(
87
+ get_state().resolve_session_service(),
88
+ self.session_id,
89
+ self.invocation_id,
90
+ )
91
+ return status in _RUN_TERMINAL_STATUSES
92
+
93
+ async def _consume(self) -> None:
94
+ terminal_fallback_status: str | None = None
95
+ try:
96
+ async for chunk in self._source:
97
+ self._backlog.append(chunk)
98
+ if len(self._backlog) > self._MAX_BACKLOG_CHUNKS:
99
+ self._backlog = self._backlog[-self._MAX_BACKLOG_CHUNKS :]
100
+ subscribers = list(self._subscribers)
101
+ if not subscribers:
102
+ continue
103
+ await asyncio.gather(
104
+ *(subscriber.put(chunk) for subscriber in subscribers),
105
+ return_exceptions=True,
106
+ )
107
+ except asyncio.CancelledError:
108
+ terminal_fallback_status = "cancelled"
109
+ raise
110
+ except Exception:
111
+ terminal_fallback_status = "failed"
112
+ logger.exception("Detached SSE stream failed")
113
+ raise
114
+ finally:
115
+ self._done = True
116
+ subscribers = list(self._subscribers)
117
+ if subscribers:
118
+ await asyncio.gather(
119
+ *(subscriber.put(None) for subscriber in subscribers),
120
+ return_exceptions=True,
121
+ )
122
+ if terminal_fallback_status and self.session_id:
123
+ try:
124
+ if not await self._has_terminal_run_status():
125
+ await append_run_status_event(
126
+ session_id=self.session_id,
127
+ author="system",
128
+ status=terminal_fallback_status,
129
+ invocation_id=self.invocation_id or "",
130
+ detail=(
131
+ f"background_{terminal_fallback_status}:{self.invocation_id or ''}"
132
+ ),
133
+ session_service_provider=get_state().resolve_session_service,
134
+ run_mode=self._run_mode,
135
+ run_trigger=self._run_trigger,
136
+ )
137
+ except Exception:
138
+ logger.exception("failed to write background terminal status fallback")
139
+
140
+ def subscribe(self) -> asyncio.Queue[str | None]:
141
+ queue: asyncio.Queue[str | None] = asyncio.Queue()
142
+ for chunk in self._backlog:
143
+ queue.put_nowait(chunk)
144
+ if self._done:
145
+ queue.put_nowait(None)
146
+ else:
147
+ self._subscribers.add(queue)
148
+ return queue
149
+
150
+ def unsubscribe(self, queue: asyncio.Queue[str | None]) -> None:
151
+ self._subscribers.discard(queue)
152
+
153
+ def cancel(self) -> bool:
154
+ if self._task.done():
155
+ return False
156
+ return self._task.cancel()
157
+
158
+ async def iter_for_client(self) -> AsyncIterator[str]:
159
+ queue = self.subscribe()
160
+ try:
161
+ while True:
162
+ # 对 queue.get() 计时而不取消上游:cancel queue.get() 只影响本订阅者的等待,
163
+ # 不影响 _consume 后台 task;心跳直接发给当前客户端,不进 _backlog,
164
+ # 因此断线重连(SubscribeRunEvents)不会回放心跳帧。
165
+ try:
166
+ chunk = await asyncio.wait_for(
167
+ queue.get(),
168
+ timeout=SSE_HEARTBEAT_INTERVAL_SECONDS,
169
+ )
170
+ except asyncio.TimeoutError:
171
+ yield ": ping\n\n"
172
+ continue
173
+ if chunk is None:
174
+ break
175
+ yield chunk
176
+ finally:
177
+ self.unsubscribe(queue)
178
+
179
+
180
+ async def _cancel_detached_streams_for_session(session_id: str) -> None:
181
+ target_session_id = str(session_id or "").strip()
182
+ if not target_session_id:
183
+ return
184
+ registry = get_state().stream_registry
185
+ detached_streams = [
186
+ detached
187
+ for detached in list(registry.streams_by_invocation.values())
188
+ if detached.session_id == target_session_id
189
+ ]
190
+ for detached in detached_streams:
191
+ detached.cancel()
192
+ if detached_streams:
193
+ await asyncio.gather(
194
+ *(detached._task for detached in detached_streams),
195
+ return_exceptions=True,
196
+ )
197
+
198
+
199
+ def _clear_detached_resume_key(registry, invocation_id: str, resume_key: tuple[str, str]) -> None:
200
+ registry.resume_keys_by_invocation.pop(invocation_id, None)
201
+ if registry.active_resume_invocation_by_key.get(resume_key) == invocation_id:
202
+ registry.active_resume_invocation_by_key.pop(resume_key, None)
203
+
204
+
205
+ def _detached_resume_key_from_input(
206
+ session_id: str | None,
207
+ resume_input: Mapping[str, Any] | None,
208
+ ) -> tuple[str, str] | None:
209
+ if not isinstance(resume_input, Mapping):
210
+ return None
211
+ if str(resume_input.get("type") or "").strip() != "agentengine.resume_checkpoint":
212
+ return None
213
+ normalized_session_id = str(session_id or "").strip()
214
+ run_id = str(resume_input.get("run_id") or "").strip()
215
+ if not normalized_session_id or not run_id:
216
+ return None
217
+ return normalized_session_id, run_id
218
+
219
+
220
+ def _reject_if_detached_resume_active(resume_key: tuple[str, str] | None) -> None:
221
+ if resume_key is None:
222
+ return
223
+ active_resume_invocation_id = get_state().stream_registry.active_resume_invocation_by_key.get(
224
+ resume_key
225
+ )
226
+ if not active_resume_invocation_id:
227
+ return
228
+ raise HTTPException(
229
+ status_code=409,
230
+ detail={
231
+ "code": "resume_already_running",
232
+ "message": "A checkpoint resume is already running for this session and run.",
233
+ "invocation_id": active_resume_invocation_id,
234
+ "session_id": resume_key[0],
235
+ "run_id": resume_key[1],
236
+ },
237
+ )
238
+
239
+
240
+ def detached_streaming_response(
241
+ source: AsyncIterator[str],
242
+ *,
243
+ invocation_id: str | None = None,
244
+ session_id: str | None = None,
245
+ resume_key: tuple[str, str] | None = None,
246
+ run_mode: str = "unknown",
247
+ run_trigger: str = "unknown",
248
+ ) -> StreamingResponse:
249
+ """Create an app-owned detached SSE response with reconnectable backlog."""
250
+
251
+ detached = _DetachedSSEStream(
252
+ source,
253
+ invocation_id=invocation_id,
254
+ session_id=session_id,
255
+ run_mode=run_mode,
256
+ run_trigger=run_trigger,
257
+ )
258
+ registry = detached._registry
259
+ if invocation_id and resume_key:
260
+ registry.resume_keys_by_invocation[invocation_id] = resume_key
261
+ registry.active_resume_invocation_by_key[resume_key] = invocation_id
262
+ detached._task.add_done_callback(
263
+ lambda _task: _clear_detached_resume_key(registry, invocation_id, resume_key)
264
+ )
265
+ return StreamingResponse(detached.iter_for_client(), media_type="text/event-stream")
@@ -0,0 +1,414 @@
1
+ """Workspace, attachment upload, model catalog, and cancel routes."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import io
6
+ import logging
7
+ import time
8
+ import uuid
9
+ import zipfile
10
+ from pathlib import PurePosixPath
11
+ from typing import Any, Optional
12
+ from urllib.parse import quote
13
+
14
+ from fastapi import File, Form, HTTPException, Query, Request, UploadFile
15
+ from fastapi.responses import Response, StreamingResponse
16
+ from pydantic import BaseModel
17
+
18
+ from ksadk.conversations.attachment_storage import AttachmentStorageService
19
+ from ksadk.conversations.model_context import normalize_model_metadata
20
+ from ksadk.runtime.adapter import CancelResult
21
+ from ksadk.server.factory import get_runtime_execution, get_state
22
+ from ksadk_runtime_common.workspace_files.preview import (
23
+ build_workspace_file_base_href,
24
+ build_workspace_preview_csp,
25
+ inject_workspace_html_preview,
26
+ )
27
+
28
+ from . import dependencies as deps
29
+ from .common import (
30
+ _action_response,
31
+ _resolve_current_model,
32
+ _workspace_root_dir,
33
+ _workspace_runtime_request,
34
+ )
35
+ from .models import (
36
+ CancelRunActionRequest,
37
+ WorkspaceDeleteActionRequest,
38
+ WorkspaceListActionRequest,
39
+ )
40
+ from .projection import (
41
+ _agent_contains_invocation,
42
+ _require_action_session,
43
+ _session_contains_invocation,
44
+ )
45
+ from .routers import control_router, workspace_router
46
+
47
+ logger = logging.getLogger(__name__)
48
+
49
+
50
+ @workspace_router.post("/agentengine/api/v1/UploadFile")
51
+ async def upload_file_action(file: UploadFile = File(...)):
52
+ file_id = uuid.uuid4().hex
53
+ data = await file.read()
54
+ file_uri, _local_path = await AttachmentStorageService().store(
55
+ data=data,
56
+ file_id=file_id,
57
+ display_name=file.filename,
58
+ mime_type=file.content_type,
59
+ )
60
+
61
+ return _action_response(
62
+ "UploadFile",
63
+ {
64
+ "FileData": {
65
+ "fileUri": file_uri,
66
+ "displayName": file.filename or "uploaded_file",
67
+ "mimeType": file.content_type or "application/octet-stream",
68
+ "sizeBytes": len(data),
69
+ }
70
+ },
71
+ )
72
+
73
+
74
+ @workspace_router.get("/agentengine/api/v1/AttachmentContent", include_in_schema=False)
75
+ async def attachment_content_action(FileUri: str = Query(...)):
76
+ loaded = AttachmentStorageService().read(FileUri)
77
+ if loaded is None:
78
+ raise HTTPException(status_code=404, detail="Attachment not found")
79
+
80
+ return Response(
81
+ content=loaded.data,
82
+ media_type=loaded.mime_type or "application/octet-stream",
83
+ headers={"Content-Disposition": f'inline; filename="{loaded.display_name}"'},
84
+ )
85
+
86
+
87
+ @workspace_router.post("/agentengine/api/v1/ListWorkspaceFiles")
88
+ async def list_workspace_files_action(request: WorkspaceListActionRequest):
89
+ response = await _workspace_runtime_request(
90
+ "GET",
91
+ "/_ksadk/workspace/v1/entries",
92
+ params={
93
+ "path": request.Path,
94
+ "recursive": "true" if request.Recursive else "false",
95
+ },
96
+ )
97
+ return _action_response("ListWorkspaceFiles", response.json())
98
+
99
+
100
+ @workspace_router.post("/agentengine/api/v1/AddWorkspaceFile")
101
+ async def upload_workspace_file_action(
102
+ file: UploadFile = File(...),
103
+ AgentId: Optional[str] = Form(None),
104
+ Path: str = Form(...),
105
+ ):
106
+ del AgentId
107
+ try:
108
+ payload = await file.read()
109
+ finally:
110
+ await file.close()
111
+
112
+ file_name = file.filename or Path.rsplit("/", 1)[-1]
113
+ response = await _workspace_runtime_request(
114
+ "POST",
115
+ f"/_ksadk/workspace/v1/files/{quote(Path, safe='/')}",
116
+ files={
117
+ "file": (
118
+ file_name,
119
+ payload,
120
+ file.content_type or "application/octet-stream",
121
+ )
122
+ },
123
+ )
124
+ return _action_response("AddWorkspaceFile", response.json())
125
+
126
+
127
+ @workspace_router.post("/agentengine/api/v1/DeleteWorkspaceFile")
128
+ async def delete_workspace_file_action(request: WorkspaceDeleteActionRequest):
129
+ response = await _workspace_runtime_request(
130
+ "DELETE",
131
+ f"/_ksadk/workspace/v1/files/{quote(request.Path, safe='/')}",
132
+ )
133
+ return _action_response("DeleteWorkspaceFile", response.json())
134
+
135
+
136
+ @control_router.post("/agentengine/api/v1/CancelRun")
137
+ async def cancel_run_action(request: CancelRunActionRequest):
138
+ executor, launch_context = get_runtime_execution()
139
+ detached = get_state().stream_registry.streams_by_invocation.get(request.InvocationId)
140
+ service = deps.resolve_session_service()
141
+ scoped_session_id = str(request.SessionId or "").strip()
142
+ detached_session_id = str(detached.session_id or "").strip() if detached is not None else ""
143
+ if scoped_session_id and detached_session_id and scoped_session_id != detached_session_id:
144
+ raise HTTPException(
145
+ status_code=409,
146
+ detail="InvocationId does not belong to SessionId",
147
+ )
148
+ if not scoped_session_id and detached is not None:
149
+ scoped_session_id = detached_session_id
150
+ handle = (
151
+ executor.find_handle(
152
+ launch_context.runtime_type,
153
+ request.InvocationId,
154
+ scoped_session_id,
155
+ )
156
+ if scoped_session_id
157
+ else None
158
+ )
159
+ if scoped_session_id:
160
+ await _require_action_session(
161
+ service,
162
+ session_id=scoped_session_id,
163
+ agent_id=request.AgentId,
164
+ user_id=request.UserId,
165
+ )
166
+ if detached is None and handle is None and not await _session_contains_invocation(
167
+ service,
168
+ scoped_session_id,
169
+ request.InvocationId,
170
+ ):
171
+ raise HTTPException(
172
+ status_code=409,
173
+ detail="InvocationId does not belong to SessionId",
174
+ )
175
+ elif request.UserId:
176
+ if not request.AgentId:
177
+ raise HTTPException(status_code=400, detail="AgentId is required with UserId")
178
+ if not await _agent_contains_invocation(
179
+ service,
180
+ request.AgentId,
181
+ request.InvocationId,
182
+ user_id=request.UserId,
183
+ ):
184
+ raise HTTPException(status_code=404, detail="Invocation not found")
185
+ found = detached is not None or handle is not None
186
+ cancel_requested = False
187
+ if detached is not None:
188
+ cancel_requested = detached.cancel()
189
+ runtime_cancel_status = "detached_task_cancelled" if cancel_requested else "not_running"
190
+ if handle is not None and detached is None:
191
+ try:
192
+ runtime_result = await executor.cancel(handle)
193
+ runtime_cancel_status = runtime_result.value
194
+ except Exception as exc: # noqa: BLE001
195
+ runtime_cancel_status = CancelResult.FAILED.value
196
+ logger.warning("CancelRun failed: %s", exc)
197
+ runtime_accepted = runtime_cancel_status in {
198
+ "detached_task_cancelled",
199
+ CancelResult.INTERRUPTED_ACTIVE_TURN.value,
200
+ CancelResult.PENDING_CANCEL_RECORDED.value,
201
+ }
202
+ status = "cancelling" if runtime_accepted else runtime_cancel_status
203
+ return _action_response(
204
+ "CancelRun",
205
+ {
206
+ "Cancelled": bool(cancel_requested or runtime_accepted),
207
+ "Found": found,
208
+ "Status": status,
209
+ "RuntimeCancelStatus": runtime_cancel_status,
210
+ },
211
+ )
212
+
213
+
214
+ @workspace_router.get("/agentengine/api/v1/GetWorkspaceFileContent", include_in_schema=False)
215
+ async def get_workspace_file_content_action(
216
+ FilePath: str = Query(...),
217
+ AgentId: Optional[str] = Query(None),
218
+ ):
219
+ del AgentId
220
+ response = await _workspace_runtime_request(
221
+ "GET",
222
+ f"/_ksadk/workspace/v1/files/{quote(FilePath, safe='/')}",
223
+ )
224
+ headers = {}
225
+ for key in ("content-disposition", "last-modified"):
226
+ value = response.headers.get(key)
227
+ if value:
228
+ headers[key] = value
229
+ return Response(
230
+ content=response.content,
231
+ status_code=response.status_code,
232
+ headers=headers,
233
+ media_type=response.headers.get("content-type"),
234
+ )
235
+
236
+
237
+ @workspace_router.get("/agentengine/api/v1/ws/{agent_id}/{file_path:path}", include_in_schema=False)
238
+ async def workspace_file_path_route(request: Request, agent_id: str, file_path: str):
239
+ response = await _workspace_runtime_request(
240
+ "GET",
241
+ f"/_ksadk/workspace/v1/files/{quote(file_path, safe='/')}",
242
+ )
243
+ headers = {}
244
+ for key in ("content-disposition", "last-modified"):
245
+ value = response.headers.get(key)
246
+ if value:
247
+ headers[key] = value
248
+
249
+ content_type = response.headers.get("content-type", "")
250
+ is_html = "text/html" in content_type or file_path.lower().endswith((".html", ".htm"))
251
+
252
+ if is_html and response.status_code == 200:
253
+ del agent_id
254
+ base_href = build_workspace_file_base_href(file_path)
255
+ asset_source = f"{request.url.scheme}://{request.url.netloc}{base_href}"
256
+ html_doc = response.content.decode("utf-8", errors="replace")
257
+ html_doc = inject_workspace_html_preview(html_doc, file_path)
258
+ headers.pop("content-disposition", None)
259
+ headers["Content-Security-Policy"] = build_workspace_preview_csp(asset_source)
260
+ return Response(
261
+ content=html_doc.encode("utf-8"),
262
+ status_code=response.status_code,
263
+ headers=headers,
264
+ media_type="text/html; charset=utf-8",
265
+ )
266
+
267
+ return Response(
268
+ content=response.content,
269
+ status_code=response.status_code,
270
+ headers=headers,
271
+ media_type=content_type,
272
+ )
273
+
274
+
275
+ @workspace_router.get("/agentengine/api/v1/ExportWorkspaceZip", include_in_schema=False)
276
+ async def export_workspace_zip(
277
+ AgentId: Optional[str] = Query(None),
278
+ Path: str = Query("."),
279
+ ):
280
+ del AgentId
281
+ dir_path = Path.strip() or "."
282
+ response = await _workspace_runtime_request(
283
+ "GET",
284
+ "/_ksadk/workspace/v1/entries",
285
+ params={"path": dir_path, "recursive": "true"},
286
+ )
287
+ data = response.json() if response.status_code == 200 else {}
288
+ entries = data.get("Entries", []) if isinstance(data, dict) else []
289
+ root = _workspace_root_dir()
290
+ root_resolved = root.resolve()
291
+ buf = io.BytesIO()
292
+ with zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED) as zf:
293
+ for entry in entries:
294
+ if entry.get("Type") != "file":
295
+ continue
296
+ rel = entry.get("Path", "")
297
+ if not rel:
298
+ continue
299
+ rel_path = PurePosixPath(rel)
300
+ if rel_path.is_absolute() or ".." in rel_path.parts:
301
+ continue
302
+ target = root.joinpath(*rel_path.parts)
303
+ if target.is_symlink():
304
+ continue
305
+ try:
306
+ resolved_target = target.resolve(strict=True)
307
+ except OSError:
308
+ continue
309
+ if not resolved_target.is_relative_to(root_resolved):
310
+ continue
311
+ if resolved_target.is_file():
312
+ zf.writestr(rel_path.as_posix(), resolved_target.read_bytes())
313
+ buf.seek(0)
314
+ zip_name = f"workspace-{dir_path.replace('/', '-')}.zip" if dir_path != "." else "workspace.zip"
315
+ return StreamingResponse(
316
+ buf,
317
+ media_type="application/zip",
318
+ headers={"Content-Disposition": f'attachment; filename="{zip_name}"'},
319
+ )
320
+
321
+
322
+ def _normalize_model_catalog_items(raw_models: list[Any]) -> list[dict[str, Any]]:
323
+ """统一模型目录 shape,并按 id 去重。
324
+
325
+ 这里刻意保留上游原始 dict 字段,再补 canonical metadata。
326
+ 这样两周后模型服务扩展字段时,这一层不会再次把信息裁掉。
327
+ """
328
+
329
+ normalized_by_id: dict[str, dict[str, Any]] = {}
330
+ for raw_model in raw_models:
331
+ item = normalize_model_metadata(raw_model)
332
+ normalized_by_id[item["id"]] = item
333
+ return sorted(normalized_by_id.values(), key=lambda item: item["id"])
334
+
335
+
336
+ _MODELS_CATALOG_TTL_SECONDS = 60.0
337
+ # api_base -> (monotonic_ts, payload)。进程内短 TTL 缓存,见 _build_models_payload。
338
+ _MODELS_CATALOG_CACHE: dict[str, tuple[float, dict[str, Any]]] = {}
339
+
340
+
341
+ async def _build_models_payload() -> dict[str, Any]:
342
+ import os
343
+
344
+ import httpx
345
+
346
+ api_base = os.getenv("OPENAI_BASE_URL") or os.getenv("OPENAI_API_BASE")
347
+ api_key = os.getenv("OPENAI_API_KEY")
348
+ current_model, source = _resolve_current_model()
349
+
350
+ def _fallback_catalog() -> dict[str, Any]:
351
+ models = _normalize_model_catalog_items([current_model]) if current_model else []
352
+ return {
353
+ "data": models,
354
+ "current": current_model,
355
+ "source": source,
356
+ }
357
+
358
+ if not api_base:
359
+ return _fallback_catalog()
360
+
361
+ # 上游 /v1/models 是一次真实外网往返(数百毫秒),会话页初始化会
362
+ # 调用本接口,不能每次都同步打上游。做短 TTL 进程内缓存:
363
+ # 命中直接返回;上游失败时优先回退到过期的缓存值,避免模型列表
364
+ # 因上游抖动整体不可用。
365
+ cache_key = api_base.rstrip("/")
366
+ cached = _MODELS_CATALOG_CACHE.get(cache_key)
367
+ now = time.monotonic()
368
+ if cached is not None and now - cached[0] < _MODELS_CATALOG_TTL_SECONDS:
369
+ payload = dict(cached[1])
370
+ payload["cached"] = True
371
+ return payload
372
+
373
+ try:
374
+ base_url = api_base.rstrip("/")
375
+ if base_url.endswith("/v1"):
376
+ url = f"{base_url}/models"
377
+ else:
378
+ url = f"{base_url}/v1/models"
379
+
380
+ headers = {}
381
+ if api_key:
382
+ headers["Authorization"] = f"Bearer {api_key}"
383
+
384
+ async with httpx.AsyncClient(verify=False, timeout=10) as client:
385
+ resp = await client.get(url, headers=headers)
386
+ resp.raise_for_status()
387
+ data = resp.json()
388
+
389
+ if isinstance(data, list):
390
+ models = _normalize_model_catalog_items(list(data))
391
+ else:
392
+ models = _normalize_model_catalog_items(list(data.get("data", [])))
393
+ if current_model and all(
394
+ str(item.get("id") or "").strip() != current_model for item in models
395
+ ):
396
+ models = _normalize_model_catalog_items([*models, current_model])
397
+ payload = {"data": models, "current": current_model, "source": source}
398
+ _MODELS_CATALOG_CACHE[cache_key] = (now, payload)
399
+ return dict(payload)
400
+ except Exception as e:
401
+ logger.error(f"Failed to fetch models: {e}")
402
+ if cached is not None:
403
+ payload = dict(cached[1])
404
+ payload["stale"] = True
405
+ payload["error"] = str(e)
406
+ return payload
407
+ fallback = _fallback_catalog()
408
+ fallback["error"] = str(e)
409
+ return fallback
410
+
411
+
412
+ class ListAgentModelsRequest(BaseModel):
413
+ AgentId: Optional[str] = None
414
+ Name: Optional[str] = None
@@ -1 +1 @@
1
- import{bt as e,ct as t,gt as n,lt as r,n as i,t as a,ut as o,wt as s,xt as c}from"./index-C00Lwg3L.js";var l=s(c(),1),u=t();function d(){let t=e(e=>e.visible),s=e(e=>e.content),c=e(e=>e.type),d=e(e=>e.hide),f=(0,l.useRef)(null);if(i(f),!t||!s)return null;let p=a(s);return(0,u.jsxs)(`aside`,{className:r(`flex h-full flex-shrink-0 flex-col border-l border-slate-200/30 bg-white dark:border-slate-800/40 dark:bg-slate-950`,`w-[min(42rem,50vw)]`),children:[(0,u.jsxs)(`div`,{className:`flex h-14 flex-shrink-0 items-center justify-between border-b border-slate-200/30 px-4 dark:border-slate-800/40`,children:[(0,u.jsxs)(`div`,{className:`flex min-w-0 items-center gap-2`,children:[(0,u.jsx)(`span`,{className:`text-sm font-semibold text-slate-900 dark:text-slate-100`,children:`Artifact`}),(0,u.jsx)(`span`,{className:`rounded-md bg-slate-100 px-1.5 py-0.5 font-mono text-[11px] text-slate-500 dark:bg-slate-900 dark:text-slate-400`,children:c})]}),(0,u.jsxs)(`div`,{className:`flex items-center gap-1.5`,children:[(0,u.jsxs)(`button`,{type:`button`,onClick:()=>{let e=new Blob([s],{type:`text/html;charset=utf-8`}),t=URL.createObjectURL(e),n=document.createElement(`a`);n.href=t,n.download=`artifact.${c===`svg`?`svg`:`html`}`,document.body.appendChild(n),n.click(),document.body.removeChild(n),URL.revokeObjectURL(t)},className:`inline-flex items-center gap-1.5 rounded-lg px-2.5 py-1.5 text-xs font-medium text-slate-600 transition hover:bg-slate-100 dark:text-slate-300 dark:hover:bg-slate-900`,title:`Download`,children:[(0,u.jsx)(n,{className:`h-3.5 w-3.5`}),`Download`]}),(0,u.jsx)(`button`,{type:`button`,onClick:d,className:`rounded-lg p-1.5 text-slate-500 transition hover:bg-slate-100 hover:text-slate-900 dark:text-slate-400 dark:hover:bg-slate-900 dark:hover:text-slate-100`,"aria-label":`Close Artifact`,title:`Close`,children:(0,u.jsx)(o,{className:`h-4 w-4`})})]})]}),(0,u.jsx)(`div`,{className:`min-h-0 flex-1`,children:(0,u.jsx)(`iframe`,{ref:f,srcDoc:p,sandbox:`allow-scripts allow-downloads`,title:`Artifact Preview`,className:`h-full w-full border-0 bg-white`})})]})}export{d as ArtifactsPanel};
1
+ import{bt as e,ht as t,lt as n,n as r,t as i,ut as a,wt as o,xt as s,yt as c}from"./index-R52pJJvg.js";var l=o(s(),1),u=c();function d(){let o=e(e=>e.visible),s=e(e=>e.content),c=e(e=>e.type),d=e(e=>e.hide),f=(0,l.useRef)(null);if(r(f),!o||!s)return null;let p=i(s);return(0,u.jsxs)(`aside`,{className:n(`flex h-full flex-shrink-0 flex-col border-l border-slate-200/30 bg-white dark:border-slate-800/40 dark:bg-slate-950`,`w-[min(42rem,50vw)]`),children:[(0,u.jsxs)(`div`,{className:`flex h-14 flex-shrink-0 items-center justify-between border-b border-slate-200/30 px-4 dark:border-slate-800/40`,children:[(0,u.jsxs)(`div`,{className:`flex min-w-0 items-center gap-2`,children:[(0,u.jsx)(`span`,{className:`text-sm font-semibold text-slate-900 dark:text-slate-100`,children:`Artifact`}),(0,u.jsx)(`span`,{className:`rounded-md bg-slate-100 px-1.5 py-0.5 font-mono text-[11px] text-slate-500 dark:bg-slate-900 dark:text-slate-400`,children:c})]}),(0,u.jsxs)(`div`,{className:`flex items-center gap-1.5`,children:[(0,u.jsxs)(`button`,{type:`button`,onClick:()=>{let e=new Blob([s],{type:`text/html;charset=utf-8`}),t=URL.createObjectURL(e),n=document.createElement(`a`);n.href=t,n.download=`artifact.${c===`svg`?`svg`:`html`}`,document.body.appendChild(n),n.click(),document.body.removeChild(n),URL.revokeObjectURL(t)},className:`inline-flex items-center gap-1.5 rounded-lg px-2.5 py-1.5 text-xs font-medium text-slate-600 transition hover:bg-slate-100 dark:text-slate-300 dark:hover:bg-slate-900`,title:`Download`,children:[(0,u.jsx)(t,{className:`h-3.5 w-3.5`}),`Download`]}),(0,u.jsx)(`button`,{type:`button`,onClick:d,className:`rounded-lg p-1.5 text-slate-500 transition hover:bg-slate-100 hover:text-slate-900 dark:text-slate-400 dark:hover:bg-slate-900 dark:hover:text-slate-100`,"aria-label":`Close Artifact`,title:`Close`,children:(0,u.jsx)(a,{className:`h-4 w-4`})})]})]}),(0,u.jsx)(`div`,{className:`min-h-0 flex-1`,children:(0,u.jsx)(`iframe`,{ref:f,srcDoc:p,sandbox:`allow-scripts allow-downloads`,title:`Artifact Preview`,className:`h-full w-full border-0 bg-white`})})]})}export{d as ArtifactsPanel};