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,475 @@
1
+ from __future__ import annotations
2
+
3
+ import asyncio
4
+ import os
5
+ import time
6
+ import uuid
7
+ from typing import Any, Dict, Mapping, Optional, Sequence
8
+
9
+ import httpx
10
+
11
+ from ksadk.conversations.attachments import compact_attachment_result_for_session
12
+ from ksadk.conversations.context import (
13
+ canonical_event_type,
14
+ )
15
+ from ksadk.conversations.model_context import (
16
+ normalize_model_metadata,
17
+ )
18
+ from ksadk.conversations.normalize import (
19
+ canonical_input_content_from_parts,
20
+ compact_attachment_for_session,
21
+ normalize_kop_messages,
22
+ )
23
+ from ksadk.conversations.reasoning_markup import strip_reasoning_markup
24
+ from ksadk.conversations.runtime_constants import (
25
+ _MODEL_CATALOG_CACHE,
26
+ _MODEL_CATALOG_CACHE_TTL_SECONDS,
27
+ ATTACHMENT_CONTEXT_STATE_KEY,
28
+ SESSION_SUMMARY_MAX_CHARS,
29
+ logger,
30
+ )
31
+ from ksadk.conversations.session_title import (
32
+ DEFAULT_SESSION_TITLE_TIMEOUT_MS,
33
+ HEURISTIC_SESSION_TITLE_SOURCE,
34
+ build_fallback_title,
35
+ build_heuristic_title,
36
+ build_session_title_messages,
37
+ is_low_quality_title,
38
+ resolve_session_title_client,
39
+ resolve_session_title_model,
40
+ )
41
+ from ksadk.sessions import Session, SessionEvent
42
+
43
+
44
+ def _truncate_text(text: str | None, limit: int) -> str:
45
+ raw = " ".join(str(text or "").strip().split())
46
+ if len(raw) <= limit:
47
+ return raw
48
+ return f"{raw[: max(limit - 1, 0)].rstrip()}…"
49
+
50
+
51
+ async def _update_session_metadata_after_user_turn(
52
+ *,
53
+ service: Any,
54
+ session: Session,
55
+ user_input: str,
56
+ ) -> None:
57
+ text = _truncate_text(user_input, SESSION_SUMMARY_MAX_CHARS)
58
+ if not text:
59
+ return
60
+ updates: dict[str, str] = {"last_prompt": text}
61
+ if not (session.first_prompt or "").strip():
62
+ updates["first_prompt"] = text
63
+ if not (session.title or "").strip():
64
+ updates["title"] = build_fallback_title(session.first_prompt or text)
65
+ updates["title_source"] = "fallback_first_prompt"
66
+ await service.update_session_metadata(session.id, **updates)
67
+
68
+
69
+ async def prime_session_metadata_for_user_turn(
70
+ *,
71
+ service: Any,
72
+ session: Session,
73
+ messages: Sequence[Mapping[str, Any]] | None = None,
74
+ user_input: str | None = None,
75
+ ) -> None:
76
+ text = str(user_input or "").strip()
77
+ if not text and messages:
78
+ text, _display, _content, _parts, _attachments, _attachment_results = _latest_user_turn(
79
+ messages
80
+ )
81
+ await _update_session_metadata_after_user_turn(
82
+ service=service,
83
+ session=session,
84
+ user_input=text,
85
+ )
86
+
87
+
88
+ async def _update_session_metadata_after_assistant_turn(
89
+ *,
90
+ service: Any,
91
+ session_id: str,
92
+ assistant_text: str,
93
+ model: str | None,
94
+ ) -> None:
95
+ summary = _truncate_text(strip_reasoning_markup(assistant_text), SESSION_SUMMARY_MAX_CHARS)
96
+ if summary:
97
+ await service.update_session_metadata(session_id, summary=summary)
98
+
99
+ session = await service.get_session(session_id)
100
+ if not session:
101
+ return
102
+ if (session.title_source or "").strip() != "fallback_first_prompt":
103
+ return
104
+ first_prompt = str(session.first_prompt or "").strip()
105
+ if not first_prompt or not summary:
106
+ return
107
+
108
+ next_title = build_heuristic_title(first_prompt=first_prompt, assistant_text=summary)
109
+ next_title_source = (
110
+ HEURISTIC_SESSION_TITLE_SOURCE
111
+ if next_title and next_title != (session.title or "").strip()
112
+ else ""
113
+ )
114
+ if next_title and next_title != (session.title or "").strip():
115
+ await service.update_session_metadata(
116
+ session_id,
117
+ title=next_title,
118
+ title_source=next_title_source,
119
+ )
120
+
121
+ title_client = resolve_session_title_client()
122
+ title_model = resolve_session_title_model(model)
123
+ if title_client.is_available and title_model:
124
+ asyncio.create_task(
125
+ _refine_session_title_in_background(
126
+ service=service,
127
+ session_id=session_id,
128
+ first_prompt=first_prompt,
129
+ assistant_text=summary,
130
+ model=title_model,
131
+ )
132
+ )
133
+
134
+
135
+ async def _refine_session_title_in_background(
136
+ *,
137
+ service: Any,
138
+ session_id: str,
139
+ first_prompt: str,
140
+ assistant_text: str,
141
+ model: str,
142
+ ) -> None:
143
+ title_client = resolve_session_title_client()
144
+ try:
145
+ title, _usage = await title_client.generate_title(
146
+ model=model,
147
+ messages=build_session_title_messages(
148
+ first_prompt=first_prompt,
149
+ assistant_text=assistant_text,
150
+ ),
151
+ timeout_ms=DEFAULT_SESSION_TITLE_TIMEOUT_MS,
152
+ )
153
+ except Exception:
154
+ logger.debug("failed to refine session title", exc_info=True)
155
+ return
156
+
157
+ if not title or is_low_quality_title(title, first_prompt=first_prompt):
158
+ return
159
+ session = await service.get_session(session_id)
160
+ if not session:
161
+ return
162
+ if title == (session.title or "").strip():
163
+ return
164
+ await service.update_session_metadata(
165
+ session_id,
166
+ title=title,
167
+ title_source="ai",
168
+ )
169
+
170
+
171
+ def _resolve_model_metadata(
172
+ model: Optional[str],
173
+ *,
174
+ model_metadata: Mapping[str, Any] | None = None,
175
+ ) -> dict[str, Any]:
176
+ """统一收口模型上下文配置。
177
+
178
+ 当前阶段还没把远端 /v1/models 的完整 metadata 缓存接进 runtime,
179
+ 所以这里只用默认值 + model id。后续模型目录接口上线 richer metadata
180
+ 后,只需要把这层改成真正的 resolver,compaction 逻辑本身不用再动。
181
+ """
182
+
183
+ if isinstance(model_metadata, Mapping):
184
+ resolved = dict(model_metadata)
185
+ if model and not str(resolved.get("id") or "").strip():
186
+ resolved["id"] = model
187
+ return dict(normalize_model_metadata(resolved))
188
+ return dict(normalize_model_metadata({"id": model or "agent"}))
189
+
190
+
191
+ def _model_catalog_endpoint(api_base: str) -> str:
192
+ base_url = str(api_base or "").rstrip("/")
193
+ if not base_url:
194
+ return ""
195
+ if base_url.endswith("/v1"):
196
+ return f"{base_url}/models"
197
+ return f"{base_url}/v1/models"
198
+
199
+
200
+ async def _fetch_remote_model_catalog(api_base: str, api_key: str) -> list[dict[str, Any]]:
201
+ url = _model_catalog_endpoint(api_base)
202
+ if not url:
203
+ return []
204
+
205
+ headers = {}
206
+ if api_key:
207
+ headers["Authorization"] = f"Bearer {api_key}"
208
+
209
+ async with httpx.AsyncClient(verify=False, timeout=10) as client:
210
+ response = await client.get(url, headers=headers)
211
+ response.raise_for_status()
212
+ payload = response.json()
213
+
214
+ raw_models = payload if isinstance(payload, list) else list(payload.get("data", []))
215
+ normalized: list[dict[str, Any]] = []
216
+ for item in raw_models:
217
+ if isinstance(item, Mapping) or isinstance(item, str):
218
+ normalized.append(normalize_model_metadata(item))
219
+ return normalized
220
+
221
+
222
+ async def _resolve_runtime_model_metadata(
223
+ model: Optional[str],
224
+ *,
225
+ model_metadata: Mapping[str, Any] | None = None,
226
+ ) -> dict[str, Any]:
227
+ resolved = _resolve_model_metadata(model, model_metadata=model_metadata)
228
+ if isinstance(model_metadata, Mapping) or not model:
229
+ return resolved
230
+
231
+ api_base = os.getenv("OPENAI_BASE_URL") or os.getenv("OPENAI_API_BASE") or ""
232
+ if not api_base:
233
+ return resolved
234
+
235
+ api_key = os.getenv("OPENAI_API_KEY", "")
236
+ cache_key = (api_base.rstrip("/"), api_key)
237
+ now = time.monotonic()
238
+ cached = _MODEL_CATALOG_CACHE.get(cache_key)
239
+ models: list[dict[str, Any]]
240
+ if cached and (now - cached[0]) < _MODEL_CATALOG_CACHE_TTL_SECONDS:
241
+ models = cached[1]
242
+ else:
243
+ try:
244
+ models = await _fetch_remote_model_catalog(api_base, api_key)
245
+ _MODEL_CATALOG_CACHE[cache_key] = (now, models)
246
+ except Exception as exc:
247
+ logger.debug("Failed to fetch remote model metadata for %s: %s", model, exc)
248
+ return resolved
249
+
250
+ target = str(model).strip()
251
+ for item in models:
252
+ if str(item.get("id") or "").strip() == target:
253
+ return item
254
+ return resolved
255
+
256
+
257
+ def _normalized_conversation_messages(messages: Sequence[Dict[str, Any]]) -> list[dict[str, Any]]:
258
+ """把不同入口的 message 形态收敛成统一内部格式。"""
259
+
260
+ normalized_messages: list[dict[str, Any]] = []
261
+ for message in list(messages or []):
262
+ if isinstance(message, dict) and any(
263
+ key in message
264
+ for key in ("display_content", "attachments", "attachment_results", "parts")
265
+ ):
266
+ normalized_messages.append(
267
+ {
268
+ "role": str(message.get("role") or "user"),
269
+ "content": str(message.get("content") or ""),
270
+ "display_content": str(
271
+ message.get("display_content") or message.get("content") or ""
272
+ ),
273
+ "parts": list(message.get("parts") or []),
274
+ "input_content": list(
275
+ message.get("input_content")
276
+ or canonical_input_content_from_parts(list(message.get("parts") or []))
277
+ ),
278
+ "attachments": list(message.get("attachments") or []),
279
+ "attachment_results": list(message.get("attachment_results") or []),
280
+ }
281
+ )
282
+ continue
283
+ normalized_messages.extend(normalize_kop_messages([message]))
284
+ return normalized_messages
285
+
286
+
287
+ def _latest_user_turn(
288
+ normalized_messages: Sequence[Mapping[str, Any]],
289
+ ) -> tuple[
290
+ str,
291
+ str,
292
+ list[dict[str, Any]],
293
+ list[dict[str, Any]],
294
+ list[dict[str, Any]],
295
+ list[dict[str, Any]],
296
+ ]:
297
+ latest_user_message = next(
298
+ (message for message in reversed(normalized_messages) if message.get("role") == "user"),
299
+ {},
300
+ )
301
+ user_input = str(latest_user_message.get("content") or "")
302
+ user_display_input = str(latest_user_message.get("display_content") or user_input)
303
+ input_content = list(latest_user_message.get("input_content") or [])
304
+ user_parts = list(latest_user_message.get("parts") or [])
305
+ attachments = list(latest_user_message.get("attachments") or [])
306
+ attachment_results = list(latest_user_message.get("attachment_results") or [])
307
+ return (
308
+ user_input,
309
+ user_display_input,
310
+ input_content,
311
+ user_parts,
312
+ attachments,
313
+ attachment_results,
314
+ )
315
+
316
+
317
+ def _canonical_input_messages(
318
+ normalized_messages: Sequence[Dict[str, Any]],
319
+ ) -> list[dict[str, Any]]:
320
+ input_messages: list[dict[str, Any]] = []
321
+ for message in normalized_messages or []:
322
+ role = str(message.get("role") or "user")
323
+ content = list(message.get("input_content") or [])
324
+ if not content:
325
+ text = str(message.get("content") or "")
326
+ if text:
327
+ content = [{"type": "input_text", "text": text}]
328
+ input_messages.append({"role": role, "content": content})
329
+ return input_messages
330
+
331
+
332
+ def _parts_include_file(parts: Sequence[dict[str, Any]]) -> bool:
333
+ for part in parts or []:
334
+ if not isinstance(part, dict):
335
+ continue
336
+ if part.get("inlineData") is not None or part.get("fileData") is not None:
337
+ return True
338
+ return False
339
+
340
+
341
+ def _latest_attachment_context_from_messages(
342
+ normalized_messages: Sequence[Dict[str, Any]],
343
+ ) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
344
+ attachments: list[dict[str, Any]] = []
345
+ attachment_results: list[dict[str, Any]] = []
346
+ for message in normalized_messages:
347
+ if str(message.get("role") or "user") != "user":
348
+ continue
349
+ message_attachments = list(message.get("attachments") or [])
350
+ message_attachment_results = list(message.get("attachment_results") or [])
351
+ if message_attachments or message_attachment_results:
352
+ attachments = message_attachments
353
+ attachment_results = message_attachment_results
354
+ return attachments, attachment_results
355
+
356
+
357
+ def _attachment_context_from_session(
358
+ session: Session | None,
359
+ ) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
360
+ state = getattr(session, "state", None) or {}
361
+ payload = state.get(ATTACHMENT_CONTEXT_STATE_KEY)
362
+ if not isinstance(payload, dict):
363
+ return [], []
364
+ return (
365
+ [
366
+ compact_attachment_for_session(item)
367
+ for item in payload.get("attachments") or []
368
+ if isinstance(item, dict)
369
+ ],
370
+ [
371
+ compact_attachment_result_for_session(item)
372
+ for item in payload.get("attachment_results") or []
373
+ if isinstance(item, dict)
374
+ ],
375
+ )
376
+
377
+
378
+ def _build_attachment_context_state_delta(
379
+ *,
380
+ base_state_delta: dict[str, Any] | None,
381
+ attachments: Sequence[dict[str, Any]],
382
+ attachment_results: Sequence[dict[str, Any]],
383
+ ) -> dict[str, Any]:
384
+ merged = dict(base_state_delta or {})
385
+ if attachments or attachment_results:
386
+ merged[ATTACHMENT_CONTEXT_STATE_KEY] = {
387
+ "attachments": [
388
+ compact_attachment_for_session(item)
389
+ for item in attachments
390
+ if isinstance(item, dict)
391
+ ],
392
+ "attachment_results": [
393
+ compact_attachment_result_for_session(item)
394
+ for item in attachment_results
395
+ if isinstance(item, dict)
396
+ ],
397
+ }
398
+ return merged
399
+
400
+
401
+ def _resolve_effective_attachment_context(
402
+ *,
403
+ normalized_messages: Sequence[Dict[str, Any]],
404
+ session: Session | None,
405
+ ) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
406
+ message_attachments, message_attachment_results = _latest_attachment_context_from_messages(
407
+ normalized_messages
408
+ )
409
+ if message_attachments or message_attachment_results:
410
+ return message_attachments, message_attachment_results
411
+
412
+ session_attachments, session_attachment_results = _attachment_context_from_session(session)
413
+ return session_attachments, session_attachment_results
414
+
415
+
416
+ def _transcript_event_type(event: SessionEvent) -> str:
417
+ return str(
418
+ canonical_event_type(
419
+ event.event_type,
420
+ author=event.author,
421
+ role=str((event.content or {}).get("role") or ""),
422
+ )
423
+ )
424
+
425
+
426
+ def _build_pending_user_event(
427
+ *,
428
+ session_id: str,
429
+ invocation_id: str,
430
+ user_input: str,
431
+ user_display_input: str,
432
+ attachments: Sequence[dict[str, Any]],
433
+ attachment_results: Sequence[dict[str, Any]],
434
+ ) -> SessionEvent:
435
+ """构造一条未落库的用户事件,专供 compaction 预览使用。"""
436
+
437
+ return SessionEvent.from_dict(
438
+ {
439
+ "id": f"preview-{uuid.uuid4()}",
440
+ "author": "user",
441
+ "event_type": "user_message",
442
+ "invocationId": invocation_id,
443
+ "content": {"role": "user", "parts": [{"text": user_display_input or user_input}]},
444
+ "timestamp": int(time.time() * 1000),
445
+ "metadata": {
446
+ "agent_input": user_input,
447
+ "attachments": [
448
+ compact_attachment_for_session(item) for item in attachments if item
449
+ ],
450
+ "attachment_results": [
451
+ compact_attachment_result_for_session(item)
452
+ for item in attachment_results
453
+ if item
454
+ ],
455
+ },
456
+ "stateDelta": {},
457
+ },
458
+ session_id=session_id,
459
+ )
460
+
461
+
462
+ def _user_event_content(
463
+ *,
464
+ user_input: str,
465
+ user_display_input: str,
466
+ input_content: Sequence[dict[str, Any]],
467
+ user_parts: Sequence[dict[str, Any]],
468
+ ) -> dict[str, Any]:
469
+ parts = list(input_content or [])
470
+ if not parts:
471
+ parts = canonical_input_content_from_parts(list(user_parts or []))
472
+ if not parts:
473
+ text = user_display_input or user_input
474
+ parts = [{"text": text}] if text else []
475
+ return {"role": "user", "parts": parts}