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,543 @@
1
+ """Safe OpenAI-compatible model client for local Studio runs."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import ipaddress
7
+ import os
8
+ import socket
9
+ from dataclasses import dataclass, field
10
+ from threading import RLock
11
+ from typing import Any, Awaitable, Callable
12
+ from urllib.parse import urlparse
13
+
14
+ import httpx
15
+
16
+ from ksadk.studio.contracts import NetworkPolicy, ResolvedModel, Usage
17
+ from ksadk.studio.errors import StudioError
18
+
19
+ _DENIED_METADATA_HOSTS = {
20
+ "169.254.169.254",
21
+ "metadata.google.internal",
22
+ "metadata.azure.internal",
23
+ "fd00:ec2::254",
24
+ }
25
+
26
+
27
+ @dataclass(frozen=True)
28
+ class ToolCall:
29
+ id: str
30
+ name: str
31
+ arguments: str
32
+ raw: dict[str, Any] = field(default_factory=dict)
33
+
34
+
35
+ @dataclass(frozen=True)
36
+ class ModelResponse:
37
+ content: str
38
+ finish_reason: str
39
+ usage: Usage
40
+ tool_calls: list[ToolCall]
41
+ raw_message: dict[str, Any]
42
+
43
+
44
+ class CredentialResolver:
45
+ """Resolve immutable Secret references with a workspace-persisted overlay.
46
+
47
+ Resolution order: in-memory session values → workspace secrets file
48
+ (``.agentkit/secrets.env``) → process environment (with paired fallback).
49
+ """
50
+
51
+ _FALLBACK_PAIRS: tuple[tuple[str, str], ...] = (
52
+ ("AGENTKIT_MODEL_API_KEY", "OPENAI_API_KEY"),
53
+ ("OPENAI_API_KEY", "AGENTKIT_MODEL_API_KEY"),
54
+ )
55
+
56
+ def __init__(self, workspace: Any = None) -> None:
57
+ self._session_values: dict[str, bytearray] = {}
58
+ self._lock = RLock()
59
+ self._workspace = workspace
60
+ self._persisted: dict[str, str] | None = None
61
+
62
+ def _secrets_path(self) -> Any | None:
63
+ if self._workspace is None:
64
+ return None
65
+ try:
66
+ return self._workspace.resolve(".agentkit/secrets.env")
67
+ except Exception:
68
+ return None
69
+
70
+ def _load_persisted(self) -> dict[str, str]:
71
+ if self._persisted is not None:
72
+ return self._persisted
73
+ self._persisted = {}
74
+ path = self._secrets_path()
75
+ if path is not None and path.is_file():
76
+ try:
77
+ for line in path.read_text(encoding="utf-8").splitlines():
78
+ if not line or line.startswith("#") or "=" not in line:
79
+ continue
80
+ key, _, value = line.partition("=")
81
+ key = key.strip()
82
+ if key:
83
+ self._persisted[key] = value
84
+ except Exception:
85
+ pass
86
+ return self._persisted
87
+
88
+ def _write_persisted(self) -> None:
89
+ path = self._secrets_path()
90
+ if path is None:
91
+ return
92
+ lines = [f"{k}={v}" for k, v in sorted(self._persisted.items())]
93
+ try:
94
+ path.parent.mkdir(parents=True, exist_ok=True)
95
+ path.write_text("\n".join(lines) + ("\n" if lines else ""), encoding="utf-8")
96
+ try:
97
+ path.chmod(0o600)
98
+ except Exception:
99
+ pass
100
+ except Exception:
101
+ pass
102
+
103
+ @staticmethod
104
+ def _validate_name(name: str) -> str:
105
+ allowed = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_"
106
+ if not name or any(char not in allowed for char in name):
107
+ raise StudioError(
108
+ "SECRET_REFERENCE_INVALID",
109
+ "环境变量 Secret 引用格式无效",
110
+ status_code=422,
111
+ field="credentialName",
112
+ )
113
+ return name
114
+
115
+ @classmethod
116
+ def _environment_name(cls, reference: str) -> str:
117
+ if not reference.startswith("env://"):
118
+ raise StudioError(
119
+ "SECRET_BACKEND_UNAVAILABLE",
120
+ "当前本地 Runtime 仅支持 env:// Secret 引用",
121
+ status_code=501,
122
+ details={"scheme": reference.partition("://")[0]},
123
+ )
124
+ return cls._validate_name(reference.removeprefix("env://"))
125
+
126
+ @staticmethod
127
+ def _zero(value: bytearray | None) -> None:
128
+ if value is not None:
129
+ value[:] = b"\x00" * len(value)
130
+
131
+ def put_session(self, name: str, value: str) -> dict[str, str | bool]:
132
+ name = self._validate_name(name)
133
+ if (
134
+ not value
135
+ or len(value) > 16_384
136
+ or value != value.strip()
137
+ or any(ord(char) < 32 or ord(char) == 127 for char in value)
138
+ ):
139
+ raise StudioError(
140
+ "SECRET_VALUE_INVALID",
141
+ "凭证不能为空、包含控制字符或超过 16 KiB",
142
+ status_code=422,
143
+ field="value",
144
+ )
145
+ encoded = bytearray(value.encode("utf-8"))
146
+ with self._lock:
147
+ previous = self._session_values.get(name)
148
+ self._session_values[name] = encoded
149
+ self._zero(previous)
150
+ if self._secrets_path() is not None:
151
+ persisted = self._load_persisted()
152
+ if persisted.get(name) != value:
153
+ persisted[name] = value
154
+ self._write_persisted()
155
+ return self.status(f"env://{name}")
156
+
157
+ def delete_session(self, name: str) -> dict[str, str | bool]:
158
+ name = self._validate_name(name)
159
+ with self._lock:
160
+ previous = self._session_values.pop(name, None)
161
+ self._zero(previous)
162
+ if self._secrets_path() is not None:
163
+ persisted = self._load_persisted()
164
+ if name in persisted:
165
+ persisted.pop(name, None)
166
+ self._write_persisted()
167
+ return self.status(f"env://{name}")
168
+
169
+ def clear_session(self) -> None:
170
+ with self._lock:
171
+ values = list(self._session_values.values())
172
+ self._session_values.clear()
173
+ for value in values:
174
+ self._zero(value)
175
+
176
+ def _fallback_name(self, name: str) -> str | None:
177
+ for primary, alternate in self._FALLBACK_PAIRS:
178
+ if name == primary and alternate != primary:
179
+ return alternate
180
+ return None
181
+
182
+ def _resolve_source(self, name: str) -> tuple[bool, str]:
183
+ """Return (configured, source) considering session, persisted file, env, and fallback."""
184
+ fallback = self._fallback_name(name)
185
+ with self._lock:
186
+ if name in self._session_values:
187
+ return True, "session"
188
+ if fallback and fallback in self._session_values:
189
+ return True, "session-alias"
190
+ persisted = self._load_persisted()
191
+ if name in persisted:
192
+ return True, "workspace"
193
+ if fallback and fallback in persisted:
194
+ return True, "workspace-alias"
195
+ if os.environ.get(name):
196
+ return True, "environment"
197
+ if fallback and os.environ.get(fallback):
198
+ return True, "fallback"
199
+ return False, "missing"
200
+
201
+ def _session_value(self, name: str) -> str | None:
202
+ with self._lock:
203
+ value = self._session_values.get(name)
204
+ return value.decode("utf-8") if value is not None else None
205
+
206
+ def status(self, reference: str) -> dict[str, str | bool]:
207
+ name = self._environment_name(reference)
208
+ configured, source = self._resolve_source(name)
209
+ return {
210
+ "reference": reference,
211
+ "name": name,
212
+ "configured": configured,
213
+ "source": source,
214
+ "persistence": source,
215
+ }
216
+
217
+ def resolve(self, reference: str) -> str:
218
+ name = self._environment_name(reference)
219
+ fallback = self._fallback_name(name)
220
+ aliases = [name, *([fallback] if fallback else [])]
221
+ for candidate in aliases:
222
+ value = self._session_value(candidate)
223
+ if value is not None:
224
+ return value
225
+ persisted = self._load_persisted()
226
+ for candidate in aliases:
227
+ if candidate in persisted:
228
+ return persisted[candidate]
229
+ for candidate in aliases:
230
+ value = os.environ.get(candidate)
231
+ if value:
232
+ return value
233
+ raise StudioError(
234
+ "SECRET_NOT_FOUND",
235
+ "模型凭证尚未配置",
236
+ status_code=422,
237
+ details={"reference": reference},
238
+ )
239
+
240
+ def exists(self, reference: str) -> bool:
241
+ try:
242
+ return bool(self.status(reference)["configured"])
243
+ except StudioError:
244
+ return False
245
+
246
+
247
+ class NetworkGuard:
248
+ async def check(self, endpoint_url: str, policy: NetworkPolicy) -> None:
249
+ parsed = urlparse(endpoint_url)
250
+ host = (parsed.hostname or "").lower().rstrip(".")
251
+ if parsed.scheme not in {"http", "https"} or not host:
252
+ raise StudioError(
253
+ "MODEL_ENDPOINT_INVALID",
254
+ "模型地址必须是有效的 HTTP(S) URL",
255
+ status_code=422,
256
+ )
257
+ allowed = {value.lower().rstrip(".") for value in policy.allowed_hosts}
258
+ if policy.mode == "restricted" and host not in allowed:
259
+ raise StudioError(
260
+ "NETWORK_TARGET_DENIED",
261
+ "目标 hostname 不在网络允许清单中",
262
+ status_code=403,
263
+ details={"host": host},
264
+ )
265
+ if host in _DENIED_METADATA_HOSTS:
266
+ raise self._denied(host)
267
+ port = parsed.port or (443 if parsed.scheme == "https" else 80)
268
+ try:
269
+ records = await asyncio.to_thread(
270
+ socket.getaddrinfo,
271
+ host,
272
+ port,
273
+ 0,
274
+ socket.SOCK_STREAM,
275
+ )
276
+ except socket.gaierror as exc:
277
+ raise StudioError(
278
+ "NETWORK_TARGET_UNRESOLVED",
279
+ "模型 hostname 无法解析",
280
+ status_code=422,
281
+ details={"host": host},
282
+ ) from exc
283
+ for record in records:
284
+ address = str(record[4][0]).split("%", 1)[0]
285
+ ip = ipaddress.ip_address(address)
286
+ if str(ip) in _DENIED_METADATA_HOSTS or ip.is_link_local or ip.is_multicast:
287
+ raise self._denied(host)
288
+ if (
289
+ ip.is_private or ip.is_loopback or ip.is_reserved or ip.is_unspecified
290
+ ) and not policy.allow_private_network:
291
+ raise self._denied(host)
292
+
293
+ @staticmethod
294
+ def _denied(host: str) -> StudioError:
295
+ return StudioError(
296
+ "NETWORK_TARGET_DENIED",
297
+ "目标地址不满足本地 Runtime 网络策略",
298
+ status_code=403,
299
+ details={"host": host},
300
+ )
301
+
302
+
303
+ class OpenAICompatibleModelClient:
304
+ def __init__(
305
+ self,
306
+ *,
307
+ credential_resolver: CredentialResolver | None = None,
308
+ network_guard: NetworkGuard | None = None,
309
+ transport: httpx.AsyncBaseTransport | None = None,
310
+ sleep: Callable[[float], Awaitable[None]] = asyncio.sleep,
311
+ ) -> None:
312
+ self.credential_resolver = credential_resolver or CredentialResolver()
313
+ self.network_guard = network_guard or NetworkGuard()
314
+ self.transport = transport
315
+ self.sleep = sleep
316
+
317
+ async def complete(
318
+ self,
319
+ model: ResolvedModel,
320
+ *,
321
+ messages: list[dict[str, Any]],
322
+ network_policy: NetworkPolicy,
323
+ timeout_seconds: int,
324
+ max_attempts: int,
325
+ backoff_seconds: float,
326
+ tools: list[dict[str, Any]] | None = None,
327
+ allow_empty: bool = False,
328
+ ) -> ModelResponse:
329
+ await self.network_guard.check(model.endpoint_url, network_policy)
330
+ credential = self.credential_resolver.resolve(model.credential_ref)
331
+ wire_api = (model.wire_api or "chat").strip().lower()
332
+ if wire_api == "responses":
333
+ payload = self._responses_payload(model, messages, tools)
334
+ else:
335
+ payload = {
336
+ "model": model.model,
337
+ "messages": messages,
338
+ "temperature": model.parameters.temperature,
339
+ "max_tokens": model.parameters.max_tokens,
340
+ "stream": False,
341
+ }
342
+ if model.parameters.top_p is not None:
343
+ payload["top_p"] = model.parameters.top_p
344
+ if tools:
345
+ payload["tools"] = tools
346
+ payload["tool_choice"] = "auto"
347
+ headers = {
348
+ "Authorization": f"Bearer {credential}",
349
+ "Content-Type": "application/json",
350
+ }
351
+ timeout = httpx.Timeout(timeout_seconds, connect=min(10, timeout_seconds))
352
+ async with httpx.AsyncClient(
353
+ transport=self.transport,
354
+ timeout=timeout,
355
+ follow_redirects=False,
356
+ ) as client:
357
+ for attempt in range(1, max_attempts + 1):
358
+ try:
359
+ response = await client.post(
360
+ model.endpoint_url,
361
+ headers=headers,
362
+ json=payload,
363
+ )
364
+ except (httpx.TimeoutException, httpx.TransportError) as exc:
365
+ if attempt >= max_attempts:
366
+ raise StudioError(
367
+ "MODEL_REQUEST_FAILED",
368
+ "模型请求网络失败",
369
+ status_code=502,
370
+ details={"attempts": attempt, "errorType": type(exc).__name__},
371
+ ) from exc
372
+ await self.sleep(backoff_seconds * attempt)
373
+ continue
374
+ if response.is_redirect:
375
+ raise StudioError(
376
+ "NETWORK_TARGET_DENIED",
377
+ "模型 endpoint 不允许重定向",
378
+ status_code=403,
379
+ details={"statusCode": response.status_code},
380
+ )
381
+ if response.status_code == 429 or response.status_code >= 500:
382
+ if attempt < max_attempts:
383
+ await self.sleep(backoff_seconds * attempt)
384
+ continue
385
+ if response.status_code >= 400:
386
+ raise StudioError(
387
+ "MODEL_REQUEST_FAILED",
388
+ "模型服务返回错误",
389
+ status_code=502,
390
+ details={"upstreamStatus": response.status_code},
391
+ )
392
+ if wire_api == "responses":
393
+ return self._parse_responses_response(response, allow_empty=allow_empty)
394
+ return self._parse_response(response, allow_empty=allow_empty)
395
+ raise AssertionError("unreachable")
396
+
397
+ @staticmethod
398
+ def _responses_payload(
399
+ model: ResolvedModel,
400
+ messages: list[dict[str, Any]],
401
+ tools: list[dict[str, Any]] | None,
402
+ ) -> dict[str, Any]:
403
+ """把 chat 语义消息映射到 Responses API 最小可用载荷。"""
404
+ if tools:
405
+ raise StudioError(
406
+ "MODEL_REQUEST_FAILED",
407
+ "Responses 端点暂不支持 tools 参数",
408
+ status_code=422,
409
+ )
410
+ instructions: list[str] = []
411
+ items: list[dict[str, Any]] = []
412
+ for message in messages:
413
+ role = str(message.get("role") or "user")
414
+ text = str(message.get("content") or "")
415
+ if role == "system":
416
+ instructions.append(text)
417
+ continue
418
+ part_type = "output_text" if role == "assistant" else "input_text"
419
+ items.append({"role": role, "content": [{"type": part_type, "text": text}]})
420
+ payload: dict[str, Any] = {
421
+ "model": model.model,
422
+ "input": items,
423
+ "max_output_tokens": model.parameters.max_tokens,
424
+ }
425
+ if instructions:
426
+ payload["instructions"] = "\n\n".join(instructions)
427
+ return payload
428
+
429
+ @staticmethod
430
+ def _parse_responses_response(
431
+ response: httpx.Response, allow_empty: bool = False
432
+ ) -> ModelResponse:
433
+ if len(response.content) > 16 * 1024 * 1024:
434
+ raise StudioError(
435
+ "MODEL_RESPONSE_TOO_LARGE",
436
+ "模型响应超过 16 MiB 限制",
437
+ status_code=502,
438
+ )
439
+ try:
440
+ payload = response.json()
441
+ except ValueError as exc:
442
+ raise StudioError(
443
+ "MODEL_RESPONSE_INVALID",
444
+ "模型响应不符合 Responses 协议",
445
+ status_code=502,
446
+ ) from exc
447
+ content = payload.get("output_text")
448
+ if not isinstance(content, str) or not content:
449
+ parts: list[str] = []
450
+ for item in payload.get("output") or []:
451
+ if not isinstance(item, dict):
452
+ continue
453
+ for part in item.get("content") or []:
454
+ if isinstance(part, dict) and part.get("type") in {"output_text", "text"}:
455
+ parts.append(str(part.get("text") or ""))
456
+ content = "".join(parts)
457
+ status = str(payload.get("status") or "")
458
+ if not content and not allow_empty:
459
+ raise StudioError(
460
+ "MODEL_EMPTY_RESPONSE",
461
+ "模型未返回可用内容",
462
+ status_code=502,
463
+ details={"status": status},
464
+ )
465
+ raw_usage = payload.get("usage") or {}
466
+ usage = Usage(
467
+ input_tokens=int(raw_usage.get("input_tokens") or 0),
468
+ output_tokens=int(raw_usage.get("output_tokens") or 0),
469
+ total_tokens=int(raw_usage.get("total_tokens") or 0),
470
+ cached_input_tokens=int(
471
+ (raw_usage.get("input_tokens_details") or {}).get("cached_tokens") or 0
472
+ ),
473
+ reasoning_output_tokens=int(
474
+ (raw_usage.get("output_tokens_details") or {}).get("reasoning_tokens") or 0
475
+ ),
476
+ )
477
+ return ModelResponse(
478
+ content=content,
479
+ finish_reason="stop" if status == "completed" else status,
480
+ usage=usage,
481
+ tool_calls=[],
482
+ raw_message={"output": payload.get("output")},
483
+ )
484
+
485
+ @staticmethod
486
+ def _parse_response(response: httpx.Response, allow_empty: bool = False) -> ModelResponse:
487
+ if len(response.content) > 16 * 1024 * 1024:
488
+ raise StudioError(
489
+ "MODEL_RESPONSE_TOO_LARGE",
490
+ "模型响应超过 16 MiB 限制",
491
+ status_code=502,
492
+ )
493
+ try:
494
+ payload = response.json()
495
+ choice = payload["choices"][0]
496
+ message = choice["message"]
497
+ except (ValueError, KeyError, IndexError, TypeError) as exc:
498
+ raise StudioError(
499
+ "MODEL_RESPONSE_INVALID",
500
+ "模型响应不符合 OpenAI-compatible 协议",
501
+ status_code=502,
502
+ ) from exc
503
+ calls = []
504
+ for raw in message.get("tool_calls") or []:
505
+ function = raw.get("function") or {}
506
+ calls.append(
507
+ ToolCall(
508
+ id=str(raw.get("id") or ""),
509
+ name=str(function.get("name") or ""),
510
+ arguments=str(function.get("arguments") or "{}"),
511
+ raw=raw,
512
+ )
513
+ )
514
+ content = str(message.get("content") or "")
515
+ finish_reason = str(choice.get("finish_reason") or "")
516
+ if not content and not calls and not allow_empty:
517
+ raise StudioError(
518
+ "MODEL_EMPTY_RESPONSE",
519
+ "模型未返回可用内容",
520
+ status_code=502,
521
+ details={"finishReason": finish_reason},
522
+ )
523
+ raw_usage = payload.get("usage") or {}
524
+ usage = Usage(
525
+ input_tokens=int(raw_usage.get("prompt_tokens") or 0),
526
+ output_tokens=int(raw_usage.get("completion_tokens") or 0),
527
+ total_tokens=int(raw_usage.get("total_tokens") or 0),
528
+ cached_input_tokens=int(
529
+ (raw_usage.get("prompt_tokens_details") or {}).get("cached_tokens") or 0
530
+ ),
531
+ reasoning_output_tokens=int(
532
+ (raw_usage.get("completion_tokens_details") or {}).get("reasoning_tokens") or 0
533
+ ),
534
+ reported=bool(raw_usage),
535
+ source="model-provider" if raw_usage else None,
536
+ )
537
+ return ModelResponse(
538
+ content=content,
539
+ finish_reason=finish_reason,
540
+ usage=usage,
541
+ tool_calls=calls,
542
+ raw_message=message,
543
+ )