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,754 @@
1
+ """OTLP-first trace persistence and Studio read models.
2
+
3
+ RuntimeEvent remains the live interaction contract. This module is the only
4
+ place that projects those events into telemetry: persisted Trace data is OTLP
5
+ JSON, while ``TraceView`` is a lossless, UI-oriented read model derived from
6
+ that canonical document.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import hashlib
12
+ import json
13
+ import os
14
+ import re
15
+ import shutil
16
+ from datetime import datetime, timedelta, timezone
17
+ from pathlib import Path
18
+ from typing import Any, Iterable
19
+ from urllib.parse import quote
20
+
21
+ from ksadk.studio.contracts import RunEvent, RunRecord
22
+ from ksadk.studio.errors import StudioError, not_found
23
+ from ksadk.studio.pagination import keyset_page
24
+ from ksadk.studio.workspace import Workspace
25
+
26
+ _TRACE_ID = re.compile(r"^[0-9a-f]{32}$")
27
+ _SPAN_KIND = {1: "INTERNAL", 2: "SERVER", 3: "CLIENT", 4: "PRODUCER", 5: "CONSUMER"}
28
+ _STATUS_CODE = {0: "UNSET", 1: "OK", 2: "ERROR"}
29
+ _SENSITIVE_KEYS = {
30
+ "args",
31
+ "command",
32
+ "content",
33
+ "cwd",
34
+ "input",
35
+ "output",
36
+ "prompt",
37
+ "runtimeEvent",
38
+ "secret",
39
+ "text",
40
+ "token",
41
+ }
42
+
43
+ # 内容类字段:本地 Studio 默认放行(localhost 单用户调试),secret/token 永远脱敏
44
+ _CONTENT_KEYS = {"args", "command", "content", "input", "output", "prompt", "text", "delta"}
45
+
46
+
47
+ def _trace_content_enabled() -> bool:
48
+ return os.environ.get("KSADK_STUDIO_TRACE_CONTENT", "1") != "0"
49
+
50
+
51
+ def _canonical_trace_id(value: str) -> str:
52
+ normalized = value.strip().lower()
53
+ if _TRACE_ID.fullmatch(normalized):
54
+ return normalized
55
+ return hashlib.sha256(value.encode("utf-8")).hexdigest()[:32]
56
+
57
+
58
+ def _span_id(trace_id: str, identity: str) -> str:
59
+ return hashlib.sha256(f"{trace_id}:{identity}".encode()).hexdigest()[:16]
60
+
61
+
62
+ def _unix_nano(value: datetime) -> int:
63
+ normalized = value.astimezone(timezone.utc)
64
+ return int(normalized.timestamp()) * 1_000_000_000 + normalized.microsecond * 1000
65
+
66
+
67
+ def _iso(value: datetime | None) -> str | None:
68
+ if value is None:
69
+ return None
70
+ return value.astimezone(timezone.utc).isoformat().replace("+00:00", "Z")
71
+
72
+
73
+ def _stringify(value: Any) -> str:
74
+ if isinstance(value, str):
75
+ return value
76
+ try:
77
+ return json.dumps(value, ensure_ascii=False, default=str)
78
+ except Exception:
79
+ return str(value)
80
+
81
+
82
+ def _truncate(text: str, limit: int = 4096) -> str:
83
+ if len(text) <= limit:
84
+ return text
85
+ return text[:limit] + "…"
86
+
87
+
88
+ def _otlp_value(value: Any) -> dict[str, Any]:
89
+ if isinstance(value, bool):
90
+ return {"boolValue": value}
91
+ if isinstance(value, int):
92
+ return {"intValue": str(value)}
93
+ if isinstance(value, float):
94
+ return {"doubleValue": value}
95
+ return {"stringValue": str(value)}
96
+
97
+
98
+ def _attributes(values: dict[str, Any]) -> list[dict[str, Any]]:
99
+ return [
100
+ {"key": key, "value": _otlp_value(value)}
101
+ for key, value in sorted(values.items())
102
+ if value is not None and value != ""
103
+ ]
104
+
105
+
106
+ def _decode_value(value: dict[str, Any]) -> Any:
107
+ if "intValue" in value:
108
+ return int(value["intValue"])
109
+ if "doubleValue" in value:
110
+ return float(value["doubleValue"])
111
+ if "boolValue" in value:
112
+ return bool(value["boolValue"])
113
+ if "arrayValue" in value:
114
+ return [_decode_value(item) for item in value["arrayValue"].get("values", [])]
115
+ return value.get("stringValue", "")
116
+
117
+
118
+ def _decoded_attributes(items: Iterable[dict[str, Any]]) -> dict[str, Any]:
119
+ return {item["key"]: _decode_value(item["value"]) for item in items}
120
+
121
+
122
+ def _safe_event_attributes(data: dict[str, Any]) -> dict[str, Any]:
123
+ safe: dict[str, Any] = {}
124
+ include_content = _trace_content_enabled()
125
+ for key, value in data.items():
126
+ if any(token in key.lower() for token in ("secret", "token")):
127
+ continue
128
+ if key in _SENSITIVE_KEYS:
129
+ if (
130
+ include_content
131
+ and key in _CONTENT_KEYS
132
+ and isinstance(value, (str, int, float, bool))
133
+ ):
134
+ safe[f"agentkit.event.{key}"] = _truncate(_stringify(value), 2048)
135
+ continue
136
+ if isinstance(value, (str, int, float, bool)):
137
+ safe[f"agentkit.event.{key}"] = value
138
+ return safe
139
+
140
+
141
+ def _duration_from(data: dict[str, Any]) -> int | None:
142
+ value = data.get("durationMs", data.get("duration_ms"))
143
+ return max(0, int(value)) if value is not None else None
144
+
145
+
146
+ def _enum_string(value: Any) -> str:
147
+ """Normalize both validated strings and assignment-time ``str`` enums."""
148
+
149
+ return str(getattr(value, "value", value))
150
+
151
+
152
+ class OtlpTraceStore:
153
+ """Persist one canonical OTLP JSON document per local Trace."""
154
+
155
+ def __init__(self, workspace: Workspace) -> None:
156
+ self.workspace = workspace
157
+
158
+ def _path(self, trace_id: str) -> Path:
159
+ canonical = _canonical_trace_id(trace_id)
160
+ return self.workspace.resolve(Path(".agentkit/traces") / f"{canonical}.otlp.json")
161
+
162
+ def sync(self, record: RunRecord, events: list[RunEvent]) -> dict[str, Any]:
163
+ payload = self._build_otlp(record, events)
164
+ self.workspace.atomic_write_text(
165
+ self._path(record.trace_id),
166
+ json.dumps(payload, ensure_ascii=False, sort_keys=True, indent=2) + "\n",
167
+ )
168
+ return payload
169
+
170
+ def get_otlp(self, trace_id: str) -> dict[str, Any]:
171
+ path = self._path(trace_id)
172
+ if not path.is_file():
173
+ raise not_found("trace", trace_id)
174
+ try:
175
+ payload = json.loads(path.read_text(encoding="utf-8"))
176
+ except (OSError, ValueError) as exc:
177
+ raise not_found("trace", trace_id) from exc
178
+ if not isinstance(payload, dict) or not isinstance(payload.get("resourceSpans"), list):
179
+ raise not_found("trace", trace_id)
180
+ return payload
181
+
182
+ def get_trace_view(self, trace_id: str) -> dict[str, Any]:
183
+ raw = self.get_otlp(trace_id)
184
+ spans = self._spans(raw)
185
+ if not spans:
186
+ raise not_found("trace", trace_id)
187
+ root = next((span for span in spans if not span.get("parentSpanId")), spans[0])
188
+ root_attributes = _decoded_attributes(root.get("attributes", []))
189
+ canonical = root["traceId"]
190
+ duration = root_attributes.get("agentkit.duration.ms")
191
+ usage_reported = bool(root_attributes.get("agentkit.usage.reported", False))
192
+ metrics = {
193
+ "durationMs": int(duration) if duration is not None else None,
194
+ "durationSource": root_attributes.get("agentkit.duration.source"),
195
+ "inputTokens": (
196
+ int(root_attributes["gen_ai.usage.input_tokens"])
197
+ if usage_reported and "gen_ai.usage.input_tokens" in root_attributes
198
+ else None
199
+ ),
200
+ "outputTokens": (
201
+ int(root_attributes["gen_ai.usage.output_tokens"])
202
+ if usage_reported and "gen_ai.usage.output_tokens" in root_attributes
203
+ else None
204
+ ),
205
+ "totalTokens": (
206
+ int(root_attributes["agentkit.usage.total_tokens"])
207
+ if usage_reported and "agentkit.usage.total_tokens" in root_attributes
208
+ else None
209
+ ),
210
+ "cachedInputTokens": (
211
+ int(root_attributes.get("gen_ai.usage.cached_input_tokens", 0))
212
+ if usage_reported
213
+ else None
214
+ ),
215
+ "reasoningOutputTokens": (
216
+ int(root_attributes.get("gen_ai.usage.reasoning_tokens", 0))
217
+ if usage_reported
218
+ else None
219
+ ),
220
+ "usageReported": usage_reported,
221
+ "usageSource": root_attributes.get("agentkit.usage.source"),
222
+ }
223
+ first_resource = (raw.get("resourceSpans") or [{}])[0]
224
+ first_scope = (first_resource.get("scopeSpans") or [{}])[0]
225
+ return {
226
+ "traceId": canonical,
227
+ "rootSpanId": root["spanId"],
228
+ "runId": root_attributes.get("agentkit.run.id", ""),
229
+ "agentId": root_attributes.get("gen_ai.agent.id", ""),
230
+ "sessionId": root_attributes.get("gen_ai.conversation.id", ""),
231
+ "runtimeType": root_attributes.get("agentkit.runtime.type", ""),
232
+ "model": root_attributes.get("gen_ai.request.model", ""),
233
+ "status": root_attributes.get("agentkit.run.status", ""),
234
+ "startedAt": root_attributes.get("agentkit.run.started_at"),
235
+ "target": {"type": "local", "name": "本地工作区"},
236
+ "resource": _decoded_attributes(
237
+ (first_resource.get("resource") or {}).get("attributes", [])
238
+ ),
239
+ "scope": dict(first_scope.get("scope") or {}),
240
+ "metrics": metrics,
241
+ "spans": [self._span_view(span) for span in spans],
242
+ "rawOtlpPath": f"/api/v1/traces/{quote(canonical, safe='')}/otlp",
243
+ }
244
+
245
+ def list_trace_summaries(
246
+ self,
247
+ *,
248
+ agent_id: str | None = None,
249
+ status: str | None = None,
250
+ limit: int = 200,
251
+ ) -> list[dict[str, Any]]:
252
+ summaries = self._trace_summaries(agent_id=agent_id, status=status)
253
+ summaries.sort(
254
+ key=lambda item: (item["startedAt"] or "", item["traceId"]),
255
+ reverse=True,
256
+ )
257
+ return summaries[: max(1, min(limit, 1000))]
258
+
259
+ def paginate_trace_summaries(
260
+ self,
261
+ *,
262
+ agent_id: str | None = None,
263
+ status: str | None = None,
264
+ query: str = "",
265
+ limit: int = 50,
266
+ cursor: str | None = None,
267
+ sort: str = "startedAt:desc",
268
+ ) -> dict[str, Any]:
269
+ if sort not in {"startedAt:desc", "startedAt:asc"}:
270
+ raise StudioError(
271
+ "PAGINATION_SORT_INVALID",
272
+ "Trace 排序字段无效",
273
+ status_code=422,
274
+ field="sort",
275
+ )
276
+ summaries = self._trace_summaries(
277
+ agent_id=agent_id,
278
+ status=status,
279
+ query=query,
280
+ )
281
+ filters = {
282
+ "agentId": agent_id or "",
283
+ "status": status or "",
284
+ "query": query.strip().lower(),
285
+ }
286
+ return keyset_page(
287
+ summaries,
288
+ key=lambda item: (item["startedAt"] or "", item["traceId"]),
289
+ reverse=sort.endswith(":desc"),
290
+ limit=max(1, min(limit, 1000)),
291
+ cursor=cursor,
292
+ namespace="traces",
293
+ sort=sort,
294
+ filters=filters,
295
+ )
296
+
297
+ def _trace_summaries(
298
+ self,
299
+ *,
300
+ agent_id: str | None = None,
301
+ status: str | None = None,
302
+ query: str = "",
303
+ ) -> list[dict[str, Any]]:
304
+ directory = self.workspace.resolve(".agentkit/traces")
305
+ summaries: list[dict[str, Any]] = []
306
+ normalized_query = query.strip().lower()
307
+ for path in directory.glob("*.otlp.json"):
308
+ try:
309
+ view = self.get_trace_view(path.name.removesuffix(".otlp.json"))
310
+ except Exception: # noqa: BLE001 - a corrupt local trace must not hide valid traces
311
+ continue
312
+ if agent_id and view["agentId"] != agent_id:
313
+ continue
314
+ if status and view["status"] != status:
315
+ continue
316
+ if normalized_query and not any(
317
+ normalized_query in str(view.get(field) or "").lower()
318
+ for field in (
319
+ "traceId",
320
+ "runId",
321
+ "agentId",
322
+ "sessionId",
323
+ "runtimeType",
324
+ "model",
325
+ "status",
326
+ )
327
+ ):
328
+ continue
329
+ metrics = view["metrics"]
330
+ summaries.append(
331
+ {
332
+ "traceId": view["traceId"],
333
+ "runId": view["runId"],
334
+ "agentId": view["agentId"],
335
+ "sessionId": view["sessionId"],
336
+ "runtimeType": view["runtimeType"],
337
+ "model": view["model"],
338
+ "status": view["status"],
339
+ "startedAt": view["startedAt"],
340
+ "durationMs": metrics["durationMs"],
341
+ "durationSource": metrics["durationSource"],
342
+ "inputTokens": metrics["inputTokens"],
343
+ "outputTokens": metrics["outputTokens"],
344
+ "totalTokens": metrics["totalTokens"],
345
+ "usageReported": metrics["usageReported"],
346
+ "spanCount": len(view["spans"]),
347
+ "target": view["target"],
348
+ }
349
+ )
350
+ return summaries
351
+
352
+ def trace_overview(
353
+ self,
354
+ *,
355
+ range_name: str = "24h",
356
+ agent_id: str | None = None,
357
+ status: str | None = None,
358
+ now: datetime | None = None,
359
+ ) -> dict[str, Any]:
360
+ if range_name not in {"24h", "7d"}:
361
+ raise StudioError(
362
+ "TRACE_RANGE_INVALID",
363
+ "Trace 时间范围无效",
364
+ status_code=422,
365
+ field="range",
366
+ )
367
+ current = (now or datetime.now(timezone.utc)).astimezone(timezone.utc)
368
+ if range_name == "24h":
369
+ bucket_delta = timedelta(hours=1)
370
+ bucket_count = 24
371
+ bucket_start = current.replace(minute=0, second=0, microsecond=0)
372
+ else:
373
+ bucket_delta = timedelta(days=1)
374
+ bucket_count = 7
375
+ bucket_start = current.replace(hour=0, minute=0, second=0, microsecond=0)
376
+ starts = [bucket_start - bucket_delta * index for index in range(bucket_count - 1, -1, -1)]
377
+ buckets = [
378
+ {
379
+ "startedAt": _iso(start),
380
+ "runs": 0,
381
+ "completed": 0,
382
+ }
383
+ for start in starts
384
+ ]
385
+ cutoff = starts[0]
386
+ summaries = self._trace_summaries(agent_id=agent_id, status=status)
387
+ in_range: list[dict[str, Any]] = []
388
+ for item in summaries:
389
+ raw_started_at = item.get("startedAt")
390
+ if not raw_started_at:
391
+ continue
392
+ try:
393
+ started_at = datetime.fromisoformat(
394
+ str(raw_started_at).replace("Z", "+00:00")
395
+ ).astimezone(timezone.utc)
396
+ except ValueError:
397
+ continue
398
+ if started_at < cutoff or started_at > current:
399
+ continue
400
+ index = int((started_at - cutoff) // bucket_delta)
401
+ if index < 0 or index >= bucket_count:
402
+ continue
403
+ in_range.append(item)
404
+ buckets[index]["runs"] += 1
405
+ if item["status"] == "COMPLETED":
406
+ buckets[index]["completed"] += 1
407
+
408
+ completed = [item for item in in_range if item["status"] == "COMPLETED"]
409
+ durations = [
410
+ int(item["durationMs"]) for item in completed if item.get("durationMs") is not None
411
+ ]
412
+ total = len(in_range)
413
+ return {
414
+ "range": range_name,
415
+ "total": total,
416
+ "completed": len(completed),
417
+ "successRate": len(completed) / total if total else None,
418
+ "averageDurationMs": (sum(durations) / len(durations) if durations else None),
419
+ "inputTokens": sum(int(item.get("inputTokens") or 0) for item in in_range),
420
+ "outputTokens": sum(int(item.get("outputTokens") or 0) for item in in_range),
421
+ "totalTokens": sum(int(item.get("totalTokens") or 0) for item in in_range),
422
+ "buckets": buckets,
423
+ }
424
+
425
+ def delete(
426
+ self,
427
+ trace_id: str,
428
+ *,
429
+ purge: bool,
430
+ trash_directory: Path | None = None,
431
+ ) -> None:
432
+ path = self._path(trace_id)
433
+ if not path.is_file():
434
+ return
435
+ if purge:
436
+ path.unlink()
437
+ return
438
+ if trash_directory is None:
439
+ raise ValueError("recoverable deletion requires a trash directory")
440
+ destination = self.workspace.resolve(trash_directory / "traces" / path.name)
441
+ destination.parent.mkdir(parents=True, exist_ok=True)
442
+ shutil.move(str(path), str(destination))
443
+
444
+ def _build_otlp(self, record: RunRecord, events: list[RunEvent]) -> dict[str, Any]:
445
+ trace_id = _canonical_trace_id(record.trace_id)
446
+ root_id = _span_id(trace_id, "root")
447
+ started_at = record.started_at or (
448
+ events[0].created_at if events else datetime.now(timezone.utc)
449
+ )
450
+ root_start = _unix_nano(started_at)
451
+ root_end = (
452
+ root_start + record.duration_ms * 1_000_000
453
+ if record.duration_ms is not None
454
+ else _unix_nano(record.completed_at)
455
+ if record.completed_at is not None
456
+ else _unix_nano(events[-1].created_at)
457
+ if events
458
+ else root_start
459
+ )
460
+ run_status = _enum_string(record.status)
461
+ root_attributes: dict[str, Any] = {
462
+ "gen_ai.operation.name": "invoke_agent",
463
+ "gen_ai.agent.id": record.agent_id,
464
+ "gen_ai.agent.name": record.agent_id,
465
+ "gen_ai.conversation.id": record.session_id,
466
+ "gen_ai.request.model": record.model,
467
+ "agentkit.run.id": record.id,
468
+ "agentkit.build.id": record.build_id,
469
+ "agentkit.run.status": run_status,
470
+ "agentkit.run.started_at": _iso(record.started_at),
471
+ "agentkit.runtime.type": record.runtime_type,
472
+ "agentkit.manifest.sha256": record.manifest_sha256,
473
+ "agentkit.usage.reported": record.usage.reported,
474
+ "agentkit.usage.source": record.usage.source,
475
+ "agentkit.duration.ms": record.duration_ms,
476
+ "agentkit.duration.source": record.duration_source,
477
+ }
478
+ if record.usage.reported:
479
+ root_attributes.update(
480
+ {
481
+ "gen_ai.usage.input_tokens": record.usage.input_tokens,
482
+ "gen_ai.usage.output_tokens": record.usage.output_tokens,
483
+ "gen_ai.usage.cached_input_tokens": record.usage.cached_input_tokens,
484
+ "gen_ai.usage.reasoning_tokens": record.usage.reasoning_output_tokens,
485
+ "agentkit.usage.total_tokens": record.usage.total_tokens,
486
+ }
487
+ )
488
+ root = {
489
+ "traceId": trace_id,
490
+ "spanId": root_id,
491
+ "name": f"invoke_agent {record.agent_id}",
492
+ "kind": 1,
493
+ "startTimeUnixNano": str(root_start),
494
+ "endTimeUnixNano": str(root_end),
495
+ "attributes": _attributes(root_attributes),
496
+ "events": self._root_events(events),
497
+ "status": {
498
+ "code": (
499
+ 1
500
+ if run_status == "COMPLETED"
501
+ else 2
502
+ if run_status in {"FAILED", "TIMED_OUT", "CANCELLED"}
503
+ else 0
504
+ )
505
+ },
506
+ }
507
+ spans = [
508
+ root,
509
+ *self._model_spans(trace_id, root_id, events, root_end),
510
+ *self._tool_spans(trace_id, root_id, events, root_end),
511
+ ]
512
+ spans.sort(key=lambda span: (int(span["startTimeUnixNano"]), span["spanId"]))
513
+ return {
514
+ "resourceSpans": [
515
+ {
516
+ "resource": {
517
+ "attributes": _attributes(
518
+ {
519
+ "service.name": "agentkit-studio",
520
+ "service.namespace": "ksadk",
521
+ "deployment.environment.name": "local",
522
+ "agentkit.runtime.target": "local",
523
+ }
524
+ )
525
+ },
526
+ "scopeSpans": [
527
+ {
528
+ "scope": {"name": "ksadk.studio.trace-adapter", "version": "1"},
529
+ "spans": spans,
530
+ }
531
+ ],
532
+ }
533
+ ]
534
+ }
535
+
536
+ @staticmethod
537
+ def _root_events(events: list[RunEvent]) -> list[dict[str, Any]]:
538
+ excluded = {
539
+ "proxy.requested",
540
+ "proxy.completed",
541
+ "model.requested",
542
+ "model.completed",
543
+ "command.started",
544
+ "command.completed",
545
+ "tool.started",
546
+ "tool.requested",
547
+ "tool.completed",
548
+ }
549
+ return [
550
+ {
551
+ "timeUnixNano": str(_unix_nano(event.created_at)),
552
+ "name": event.type,
553
+ "attributes": _attributes(_safe_event_attributes(event.data)),
554
+ }
555
+ for event in events
556
+ if event.type not in excluded
557
+ ]
558
+
559
+ def _model_spans(
560
+ self, trace_id: str, root_id: str, events: list[RunEvent], root_end: int
561
+ ) -> list[dict[str, Any]]:
562
+ starts: list[RunEvent] = []
563
+ by_response: dict[str, RunEvent] = {}
564
+ spans: list[dict[str, Any]] = []
565
+ for event in events:
566
+ if event.type in {"proxy.requested", "model.requested"}:
567
+ starts.append(event)
568
+ response_id = str(event.data.get("responseId") or "")
569
+ if response_id:
570
+ by_response[response_id] = event
571
+ continue
572
+ if event.type not in {"proxy.completed", "model.completed"}:
573
+ continue
574
+ response_id = str(event.data.get("responseId") or "")
575
+ start = by_response.pop(response_id, None) if response_id else None
576
+ if start is None and starts:
577
+ start = starts.pop(0)
578
+ elif start in starts:
579
+ starts.remove(start)
580
+ if start is None:
581
+ continue
582
+ spans.append(self._model_span(trace_id, root_id, start, event, root_end))
583
+ for start in starts:
584
+ spans.append(self._model_span(trace_id, root_id, start, None, root_end))
585
+ return spans
586
+
587
+ @staticmethod
588
+ def _model_span(
589
+ trace_id: str,
590
+ root_id: str,
591
+ start: RunEvent,
592
+ end: RunEvent | None,
593
+ root_end: int,
594
+ ) -> dict[str, Any]:
595
+ model = str(start.data.get("model") or "unknown")
596
+ response_id = str(start.data.get("responseId") or "")
597
+ start_ns = _unix_nano(start.created_at)
598
+ duration = _duration_from(end.data) if end is not None else None
599
+ end_ns = (
600
+ start_ns + duration * 1_000_000
601
+ if duration is not None
602
+ else _unix_nano(end.created_at)
603
+ if end is not None
604
+ else root_end
605
+ )
606
+ attrs: dict[str, Any] = {
607
+ "gen_ai.operation.name": "chat",
608
+ "gen_ai.request.model": model,
609
+ "gen_ai.response.id": response_id,
610
+ }
611
+ if end is not None:
612
+ raw_usage = end.data.get("usage")
613
+ usage: dict[str, Any] = raw_usage if isinstance(raw_usage, dict) else {}
614
+ for source_key, target_key in (
615
+ ("inputTokens", "gen_ai.usage.input_tokens"),
616
+ ("outputTokens", "gen_ai.usage.output_tokens"),
617
+ ("cachedInputTokens", "gen_ai.usage.cached_input_tokens"),
618
+ ("reasoningOutputTokens", "gen_ai.usage.reasoning_tokens"),
619
+ ):
620
+ if usage.get(source_key) is not None:
621
+ attrs[target_key] = int(usage[source_key])
622
+ status_code = int(end.data.get("statusCode") or 200) if end is not None else 0
623
+ return {
624
+ "traceId": trace_id,
625
+ "spanId": _span_id(trace_id, f"model:{start.id}:{response_id}"),
626
+ "parentSpanId": root_id,
627
+ "name": f"chat {model}",
628
+ "kind": 3,
629
+ "startTimeUnixNano": str(start_ns),
630
+ "endTimeUnixNano": str(max(start_ns, end_ns)),
631
+ "attributes": _attributes(attrs),
632
+ "events": [],
633
+ "status": {"code": 1 if 200 <= status_code < 400 else 2 if status_code else 0},
634
+ }
635
+
636
+ def _tool_spans(
637
+ self, trace_id: str, root_id: str, events: list[RunEvent], root_end: int
638
+ ) -> list[dict[str, Any]]:
639
+ starts: dict[str, RunEvent] = {}
640
+ spans: list[dict[str, Any]] = []
641
+ for event in events:
642
+ if event.type in {"command.started", "tool.started", "tool.requested"}:
643
+ call_id = str(event.data.get("callId") or event.data.get("call_id") or event.id)
644
+ starts[call_id] = event
645
+ continue
646
+ if event.type not in {"command.completed", "tool.completed"}:
647
+ continue
648
+ call_id = str(event.data.get("callId") or event.data.get("call_id") or "")
649
+ start = starts.pop(call_id, None)
650
+ if start is None:
651
+ continue
652
+ spans.append(self._tool_span(trace_id, root_id, call_id, start, event, root_end))
653
+ for call_id, start in starts.items():
654
+ spans.append(self._tool_span(trace_id, root_id, call_id, start, None, root_end))
655
+ return spans
656
+
657
+ @staticmethod
658
+ def _tool_span(
659
+ trace_id: str,
660
+ root_id: str,
661
+ call_id: str,
662
+ start: RunEvent,
663
+ end: RunEvent | None,
664
+ root_end: int,
665
+ ) -> dict[str, Any]:
666
+ name = str(
667
+ start.data.get("tool")
668
+ or ("codex.command" if start.type == "command.started" else "tool")
669
+ )
670
+ start_ns = _unix_nano(start.created_at)
671
+ duration = _duration_from(end.data) if end is not None else None
672
+ end_ns = (
673
+ start_ns + duration * 1_000_000
674
+ if duration is not None
675
+ else _unix_nano(end.created_at)
676
+ if end is not None
677
+ else root_end
678
+ )
679
+ exit_code = end.data.get("exitCode") if end is not None else None
680
+ status = str(end.data.get("status") or "") if end is not None else ""
681
+ failed = (exit_code not in (None, 0)) or status.lower() in {"failed", "error"}
682
+ include_content = _trace_content_enabled()
683
+ tool_input: Any = None
684
+ if include_content:
685
+ if start.type == "command.started":
686
+ tool_input = start.data.get("command") or start.data.get("commandActions")
687
+ elif start.type == "tool.started":
688
+ tool_input = (
689
+ start.data.get("args") or start.data.get("arguments") or start.data.get("input")
690
+ )
691
+ tool_output: Any = None
692
+ if include_content and end is not None:
693
+ tool_output = (
694
+ end.data.get("result") or end.data.get("output") or end.data.get("content")
695
+ )
696
+ attrs: dict[str, Any] = {
697
+ "gen_ai.operation.name": "execute_tool",
698
+ "gen_ai.tool.name": name,
699
+ "gen_ai.tool.call.id": call_id,
700
+ "agentkit.tool.exit_code": exit_code,
701
+ "agentkit.tool.status": status,
702
+ }
703
+ if tool_input is not None:
704
+ attrs["agentkit.tool.input"] = _truncate(_stringify(tool_input))
705
+ if tool_output is not None:
706
+ attrs["agentkit.tool.output"] = _truncate(_stringify(tool_output))
707
+ return {
708
+ "traceId": trace_id,
709
+ "spanId": _span_id(trace_id, f"tool:{call_id}:{start.id}"),
710
+ "parentSpanId": root_id,
711
+ "name": f"execute_tool {name}",
712
+ "kind": 1,
713
+ "startTimeUnixNano": str(start_ns),
714
+ "endTimeUnixNano": str(max(start_ns, end_ns)),
715
+ "attributes": _attributes(attrs),
716
+ "events": [],
717
+ "status": {"code": 2 if failed else 1 if end is not None else 0},
718
+ }
719
+
720
+ @staticmethod
721
+ def _spans(raw: dict[str, Any]) -> list[dict[str, Any]]:
722
+ spans: list[dict[str, Any]] = []
723
+ for resource in raw.get("resourceSpans", []):
724
+ for scope in resource.get("scopeSpans", []):
725
+ spans.extend(scope.get("spans", []))
726
+ return spans
727
+
728
+ @staticmethod
729
+ def _span_view(span: dict[str, Any]) -> dict[str, Any]:
730
+ start_ns = int(span.get("startTimeUnixNano") or 0)
731
+ end_ns = int(span.get("endTimeUnixNano") or start_ns)
732
+ return {
733
+ "spanId": span["spanId"],
734
+ "parentSpanId": span.get("parentSpanId"),
735
+ "name": span.get("name", ""),
736
+ "kind": _SPAN_KIND.get(int(span.get("kind") or 0), "UNSPECIFIED"),
737
+ "status": _STATUS_CODE.get(int((span.get("status") or {}).get("code") or 0), "UNSET"),
738
+ "startTimeUnixNano": str(start_ns),
739
+ "endTimeUnixNano": str(end_ns),
740
+ "durationMs": max(0, round((end_ns - start_ns) / 1_000_000, 3)),
741
+ "attributes": _decoded_attributes(span.get("attributes", [])),
742
+ "events": [
743
+ {
744
+ "name": event.get("name", ""),
745
+ "timeUnixNano": event.get("timeUnixNano", "0"),
746
+ "attributes": _decoded_attributes(event.get("attributes", [])),
747
+ }
748
+ for event in span.get("events", [])
749
+ ],
750
+ "links": span.get("links", []),
751
+ }
752
+
753
+
754
+ __all__ = ["OtlpTraceStore"]