agentengine-sdk-python 0.8.1__py3-none-any.whl → 0.8.3__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 (476) hide show
  1. {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/METADATA +25 -12
  2. {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/RECORD +421 -232
  3. ksadk/_build_provenance.json +1 -0
  4. ksadk/a2a/_space_client_events.py +381 -0
  5. ksadk/a2a/event_adapter.py +156 -64
  6. ksadk/a2a/executor.py +179 -63
  7. ksadk/a2a/space_client.py +6 -333
  8. ksadk/a2ui/core.py +222 -53
  9. ksadk/agui/_agent_helpers.py +247 -0
  10. ksadk/agui/a2ui_projection.py +12 -5
  11. ksadk/agui/agent.py +443 -259
  12. ksadk/api/client.py +528 -27
  13. ksadk/builders/code_builder.py +284 -8
  14. ksadk/builders/container_builder.py +8 -1
  15. ksadk/builders/managed_runtime_builder.py +42 -35
  16. ksadk/cli/__init__.py +23 -0
  17. ksadk/cli/cmd_dashboard.py +15 -1
  18. ksadk/cli/cmd_deploy.py +10 -2
  19. ksadk/cli/cmd_eval.py +66 -9
  20. ksadk/cli/cmd_evalset.py +284 -0
  21. ksadk/cli/cmd_files.py +5 -1
  22. ksadk/cli/cmd_hermes.py +1 -126
  23. ksadk/cli/cmd_invoke.py +28 -38
  24. ksadk/cli/cmd_managed_runtime.py +95 -0
  25. ksadk/cli/cmd_observe.py +85 -0
  26. ksadk/cli/cmd_openclaw.py +1 -435
  27. ksadk/cli/cmd_plugin.py +657 -0
  28. ksadk/cli/cmd_replay.py +28 -4
  29. ksadk/cli/cmd_studio.py +99 -8
  30. ksadk/cli/cmd_web.py +10 -2
  31. ksadk/cli/hermes_env.py +151 -0
  32. ksadk/cli/invoke_payload.py +49 -0
  33. ksadk/cli/openclaw_env.py +458 -0
  34. ksadk/codex/client.py +180 -30
  35. ksadk/codex/runtime.py +475 -331
  36. ksadk/configs/env_registry.py +94 -12
  37. ksadk/configs/env_registry_pcm.py +181 -0
  38. ksadk/configs/env_var_spec.py +18 -0
  39. ksadk/configs/global_config.py +5 -0
  40. ksadk/configs/settings.py +9 -0
  41. ksadk/context_engine/__init__.py +98 -0
  42. ksadk/context_engine/assembler.py +176 -0
  43. ksadk/context_engine/baseline.py +419 -0
  44. ksadk/context_engine/cache_observability.py +228 -0
  45. ksadk/context_engine/capabilities.py +443 -0
  46. ksadk/context_engine/contributors.py +409 -0
  47. ksadk/context_engine/hosted_pipeline.py +417 -0
  48. ksadk/context_engine/models.py +117 -0
  49. ksadk/context_engine/planner.py +698 -0
  50. ksadk/context_engine/policies.py +319 -0
  51. ksadk/context_engine/projection.py +31 -0
  52. ksadk/context_engine/shadow_plan.py +266 -0
  53. ksadk/context_engine/tokenizer.py +164 -0
  54. ksadk/conversations/__init__.py +19 -0
  55. ksadk/conversations/context.py +230 -30
  56. ksadk/conversations/contracts.py +266 -0
  57. ksadk/conversations/message_projection.py +308 -26
  58. ksadk/conversations/model_context.py +49 -3
  59. ksadk/conversations/projector.py +616 -0
  60. ksadk/conversations/reducer.py +98 -0
  61. ksadk/conversations/runtime_compaction.py +207 -5
  62. ksadk/conversations/runtime_input.py +184 -2
  63. ksadk/conversations/runtime_invocation.py +81 -3
  64. ksadk/conversations/runtime_observability.py +141 -0
  65. ksadk/conversations/runtime_payloads.py +42 -0
  66. ksadk/conversations/runtime_preparation.py +272 -2
  67. ksadk/conversations/runtime_resume.py +20 -1
  68. ksadk/conversations/runtime_stream_events.py +94 -9
  69. ksadk/conversations/semantic_summary.py +311 -1
  70. ksadk/conversations/session_lock.py +51 -0
  71. ksadk/deployment/env_forward.py +72 -0
  72. ksadk/deployment/managed_runtime.py +5 -0
  73. ksadk/deployment/providers/serverless.py +143 -69
  74. ksadk/evaluation/__init__.py +32 -0
  75. ksadk/evaluation/a2a_adapter.py +9 -1
  76. ksadk/evaluation/adapters.py +18 -5
  77. ksadk/evaluation/agent_eval_client.py +395 -0
  78. ksadk/evaluation/cloud_binding.py +80 -0
  79. ksadk/evaluation/cloud_converter.py +194 -0
  80. ksadk/evaluation/cloud_service.py +199 -0
  81. ksadk/evaluation/contracts.py +73 -4
  82. ksadk/evaluation/evaluators.py +183 -17
  83. ksadk/evaluation/evidence.py +258 -0
  84. ksadk/evaluation/executor.py +31 -6
  85. ksadk/evaluation/local_adapter.py +550 -0
  86. ksadk/evaluation/service_env.py +27 -0
  87. ksadk/evaluation/studio_build_adapter.py +253 -0
  88. ksadk/evaluation/target.py +15 -6
  89. ksadk/events/__init__.py +13 -13
  90. ksadk/events/_v1_compat/__init__.py +1 -0
  91. ksadk/events/_v1_compat/models.py +299 -0
  92. ksadk/events/_v1_compat/parser.py +247 -0
  93. ksadk/events/_v1_compat/projection.py +755 -0
  94. ksadk/events/adapters/__init__.py +34 -0
  95. ksadk/events/adapters/_a2a_snapshot.py +622 -0
  96. ksadk/events/adapters/_a2a_support.py +275 -0
  97. ksadk/events/adapters/_codex_interactions.py +375 -0
  98. ksadk/events/adapters/_codex_items.py +801 -0
  99. ksadk/events/adapters/_codex_validators.py +311 -0
  100. ksadk/events/adapters/_langgraph_support.py +785 -0
  101. ksadk/events/adapters/a2a.py +841 -0
  102. ksadk/events/adapters/adk.py +503 -0
  103. ksadk/events/adapters/codex.py +907 -0
  104. ksadk/events/adapters/langgraph.py +745 -0
  105. ksadk/events/canonical.py +440 -0
  106. ksadk/events/canonical_replay.py +497 -0
  107. ksadk/events/canonical_store.py +468 -0
  108. ksadk/events/cold_recovery.py +257 -0
  109. ksadk/events/content.py +89 -0
  110. ksadk/events/identity.py +86 -0
  111. ksadk/events/pipeline.py +455 -0
  112. ksadk/events/projections.py +66 -0
  113. ksadk/events/reducer.py +661 -0
  114. ksadk/events/replay.py +3 -36
  115. ksadk/events/runtime_event.py +20 -265
  116. ksadk/events/session_event.py +324 -0
  117. ksadk/events/store.py +3 -316
  118. ksadk/events/v1_compat.py +41 -0
  119. ksadk/harness/__init__.py +45 -35
  120. ksadk/harness/runtime.py +220 -58
  121. ksadk/identity/resolver.py +4 -3
  122. ksadk/interaction/__init__.py +28 -0
  123. ksadk/interaction/contracts.py +136 -0
  124. ksadk/interaction/ledger.py +189 -0
  125. ksadk/interaction/provider.py +122 -0
  126. ksadk/interaction/providers/__init__.py +52 -0
  127. ksadk/interaction/providers/adk.py +40 -0
  128. ksadk/interaction/providers/codex.py +94 -0
  129. ksadk/interaction/providers/langgraph.py +58 -0
  130. ksadk/kernel/__init__.py +117 -0
  131. ksadk/kernel/authorization.py +258 -0
  132. ksadk/kernel/bootstrap.py +1074 -0
  133. ksadk/kernel/contract_fingerprints.py +62 -0
  134. ksadk/kernel/contracts.py +370 -0
  135. ksadk/kernel/control.py +220 -0
  136. ksadk/kernel/errors.py +79 -0
  137. ksadk/kernel/ingress.py +1123 -0
  138. ksadk/kernel/mapping.py +111 -0
  139. ksadk/kernel/memory_store.py +1134 -0
  140. ksadk/kernel/postgres_store.py +1757 -0
  141. ksadk/kernel/recovery.py +452 -0
  142. ksadk/kernel/runtime_identity.py +103 -0
  143. ksadk/kernel/sql/001_agent_kernel.sql +120 -0
  144. ksadk/kernel/sqlite_store.py +1411 -0
  145. ksadk/kernel/state.py +145 -0
  146. ksadk/kernel/store.py +232 -0
  147. ksadk/kernel/worker.py +964 -0
  148. ksadk/knowledge_base/client.py +7 -0
  149. ksadk/knowledge_base/service.py +32 -5
  150. ksadk/memory/__init__.py +61 -0
  151. ksadk/memory/adk/backends/base_ltm_backend.py +96 -1
  152. ksadk/memory/adk/backends/http_ltm_backend.py +14 -5
  153. ksadk/memory/adk/backends/inmemory_ltm_backend.py +136 -3
  154. ksadk/memory/adk/backends/sdk_ltm_backend.py +384 -2
  155. ksadk/memory/adk/backends/sqlite_ltm_backend.py +95 -0
  156. ksadk/memory/coordinator.py +461 -0
  157. ksadk/memory/events.py +202 -0
  158. ksadk/memory/extraction.py +228 -0
  159. ksadk/memory/ltm_backend_factory.py +16 -3
  160. ksadk/memory/models.py +316 -0
  161. ksadk/memory/policy.py +215 -0
  162. ksadk/memory/provider.py +47 -0
  163. ksadk/memory/provider_adapter.py +159 -0
  164. ksadk/memory/provider_resolver.py +71 -0
  165. ksadk/memory/providers/__init__.py +5 -0
  166. ksadk/memory/providers/local_sqlite.py +497 -0
  167. ksadk/memory/resolved_policy.py +145 -0
  168. ksadk/memory/service.py +188 -6
  169. ksadk/model_proxy/bootstrap.py +16 -9
  170. ksadk/model_proxy/detect.py +202 -9
  171. ksadk/model_proxy/namespace.py +39 -15
  172. ksadk/model_proxy/server.py +24 -5
  173. ksadk/model_proxy/transform.py +60 -2
  174. ksadk/observability/__init__.py +25 -0
  175. ksadk/observability/session_log.py +420 -0
  176. ksadk/observability/trajectory.py +105 -0
  177. ksadk/plugins/__init__.py +167 -0
  178. ksadk/plugins/bridges/__init__.py +45 -0
  179. ksadk/plugins/bridges/codex.py +552 -0
  180. ksadk/plugins/bridges/dsh.py +1116 -0
  181. ksadk/plugins/builtins.py +747 -0
  182. ksadk/plugins/bundle.py +246 -0
  183. ksadk/plugins/bundle_security.py +167 -0
  184. ksadk/plugins/composition.py +529 -0
  185. ksadk/plugins/context_contributor.py +437 -0
  186. ksadk/plugins/contracts.py +451 -0
  187. ksadk/plugins/dsh_toolchain.py +935 -0
  188. ksadk/plugins/ecosystem_bridge.py +1105 -0
  189. ksadk/plugins/ecosystem_probe.py +191 -0
  190. ksadk/plugins/host.py +724 -0
  191. ksadk/plugins/providers/__init__.py +85 -0
  192. ksadk/plugins/providers/bundles/ksadk-codex/cordis.patch.yml +3 -0
  193. ksadk/plugins/providers/bundles/ksadk-codex/index.mjs +18 -0
  194. ksadk/plugins/providers/bundles/ksadk-codex/package.json +19 -0
  195. ksadk/plugins/providers/bundles/ksadk-harness/cordis.patch.yml +3 -0
  196. ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +19 -0
  197. ksadk/plugins/providers/bundles/ksadk-harness/package.json +19 -0
  198. ksadk/plugins/providers/codex.py +722 -0
  199. ksadk/plugins/providers/codex_dsh.py +83 -0
  200. ksadk/plugins/providers/dsh.py +951 -0
  201. ksadk/plugins/providers/dsh_descriptor_host.py +226 -0
  202. ksadk/plugins/providers/harness.py +627 -0
  203. ksadk/plugins/providers/harness_dsh.py +91 -0
  204. ksadk/plugins/providers/legacy.py +215 -0
  205. ksadk/plugins/providers/legacy_catalog.py +100 -0
  206. ksadk/plugins/providers/shipped_dsh.py +370 -0
  207. ksadk/plugins/resolver.py +331 -0
  208. ksadk/plugins/subagent_providers/__init__.py +12 -0
  209. ksadk/plugins/subagent_providers/codex.py +443 -0
  210. ksadk/plugins/subagents.py +333 -0
  211. ksadk/prompts/__init__.py +71 -0
  212. ksadk/prompts/compiler.py +215 -0
  213. ksadk/prompts/models.py +82 -0
  214. ksadk/prompts/projection.py +89 -0
  215. ksadk/prompts/resolved.py +137 -0
  216. ksadk/prompts/sources.py +233 -0
  217. ksadk/runners/_langgraph_runner_streams.py +822 -0
  218. ksadk/runners/adk_runner.py +5 -5
  219. ksadk/runners/base_runner.py +16 -0
  220. ksadk/runners/factory.py +1 -2
  221. ksadk/runners/langgraph_runner.py +198 -437
  222. ksadk/runtime/_runner_adapter/__init__.py +1 -0
  223. ksadk/runtime/_runner_adapter/stream_mapping.py +797 -0
  224. ksadk/runtime/adapter.py +119 -2
  225. ksadk/runtime/conversation_execution.py +316 -182
  226. ksadk/runtime/executor.py +144 -3
  227. ksadk/runtime/factory.py +268 -8
  228. ksadk/runtime/framework_adapters.py +18 -0
  229. ksadk/runtime/hosted_finalizer.py +268 -0
  230. ksadk/runtime/launch.py +14 -1
  231. ksadk/runtime/preprocessing.py +25 -3
  232. ksadk/runtime/runner_adapter.py +293 -508
  233. ksadk/runtime/usage.py +33 -0
  234. ksadk/sandbox/__init__.py +2 -1
  235. ksadk/sandbox/backends/e2b.py +35 -2
  236. ksadk/sandbox/factory.py +72 -0
  237. ksadk/scheduler/__init__.py +18 -0
  238. ksadk/scheduler/calendar.py +102 -0
  239. ksadk/scheduler/contracts.py +254 -0
  240. ksadk/scheduler/dispatcher.py +129 -0
  241. ksadk/scheduler/engine.py +416 -0
  242. ksadk/scheduler/sqlite_store.py +563 -0
  243. ksadk/server/composition.py +8 -0
  244. ksadk/server/factory.py +69 -6
  245. ksadk/server/routes/kernel_ingress.py +258 -0
  246. ksadk/server/routes/openai_compat.py +88 -8
  247. ksadk/server/routes/projection.py +35 -20
  248. ksadk/server/routes/run.py +94 -0
  249. ksadk/server/routes/sessions.py +2 -0
  250. ksadk/server/routes/streaming.py +5 -2
  251. ksadk/server/static/assets/{ArtifactsPanel-CakCqxEN.js → ArtifactsPanel-10GPXIJ6.js} +1 -1
  252. ksadk/server/static/assets/{CodeBlock-CynLknyO.js → CodeBlock-BXk1l-G1.js} +4 -4
  253. ksadk/server/static/assets/MathMessageMarkdown-BorAY7qD.css +1 -0
  254. ksadk/server/static/assets/{MathMessageMarkdown-3sQdOysS.js → MathMessageMarkdown-D9uB55Oh.js} +4 -4
  255. ksadk/server/static/assets/MermaidBlock--OEYoXIJ.js +312 -0
  256. ksadk/server/static/assets/NativeTerminalPanel-DrEe1syq.js +1 -0
  257. ksadk/server/static/assets/abnfDiagram-VCTEODGH-eeTFJLvo.js +1 -0
  258. ksadk/server/static/assets/arc-S3ZNbIAd.js +1 -0
  259. ksadk/server/static/assets/architecture-7GRP2DOG-Dk9nRQ6-.js +1 -0
  260. ksadk/server/static/assets/architectureDiagram-5GKGNRK7-CRjgEJDX.js +36 -0
  261. ksadk/server/static/assets/blockDiagram-NRAW4CY4-C7bsBoNH.js +129 -0
  262. ksadk/server/static/assets/c4Diagram-UCG6FXSJ-BX3c33Ob.js +38 -0
  263. ksadk/server/static/assets/channel-s354Yo6o.js +1 -0
  264. ksadk/server/static/assets/chunk-2Q5K7J3B-CDpPpKR5.js +1 -0
  265. ksadk/server/static/assets/{chunk-FMBD7UC4-B_fH2YuH.js → chunk-5VM5RSS4-bZ7ws-8m.js} +1 -1
  266. ksadk/server/static/assets/{chunk-ND2GUHAM-D6rFLaVV.js → chunk-F27PBJKO-D2r0pvhY.js} +1 -1
  267. ksadk/server/static/assets/chunk-G27WJ6UU-CZwF3oUP.js +231 -0
  268. ksadk/server/static/assets/{chunk-4BX2VUAB-B9drTgOW.js → chunk-JWPE2WC7-DigFYCML.js} +1 -1
  269. ksadk/server/static/assets/chunk-LCL6LL3I-CnorGV5q.js +206 -0
  270. ksadk/server/static/assets/chunk-POPQ4Y6H-CexntQA-.js +1 -0
  271. ksadk/server/static/assets/chunk-RHFEMEQ7-CHTC7UxA.js +168 -0
  272. ksadk/server/static/assets/chunk-SVP7TREG-BC1EWt_-.js +88 -0
  273. ksadk/server/static/assets/chunk-XXDRQBXY-BTG24xN0.js +1 -0
  274. ksadk/server/static/assets/classDiagram-DTDB5LWJ-Dd0nucl9.js +1 -0
  275. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Dd0nucl9.js +1 -0
  276. ksadk/server/static/assets/{cose-bilkent-S5V4N54A-ChNs_Mdk.js → cose-bilkent-JH36ORCC-CkonRdAS.js} +1 -1
  277. ksadk/server/static/assets/cynefin-OW5HDTMX-BBlT4uMf.js +1 -0
  278. ksadk/server/static/assets/cynefinDiagram-5FMLGOSQ-DEOCBe15.js +62 -0
  279. ksadk/server/static/assets/cytoscape.esm-CyCl8rPi.js +321 -0
  280. ksadk/server/static/assets/dagre-3AP2YEHR-DBThPuLa.js +4 -0
  281. ksadk/server/static/assets/dagre-ClTPrTht.js +1 -0
  282. ksadk/server/static/assets/diagram-S7CK7UJ4-DsZHrnpJ.js +30 -0
  283. ksadk/server/static/assets/diagram-UQ7AKVKN-BJR4nhVr.js +41 -0
  284. ksadk/server/static/assets/diagram-VSXAHHWV-xzcERX0a.js +3 -0
  285. ksadk/server/static/assets/diagram-VX7I27RA-tn2xM1xu.js +24 -0
  286. ksadk/server/static/assets/diagram-Z3DM3KII-BZPGBkw5.js +24 -0
  287. ksadk/server/static/assets/{dist-gLnrGsoU.js → dist-4zN1_tq5.js} +1 -1
  288. ksadk/server/static/assets/{dist-C1sz5Eo3.js → dist-8VWI-2bZ.js} +1 -1
  289. ksadk/server/static/assets/{dist-BjOdlDjj.js → dist-B-46q3Hk.js} +1 -1
  290. ksadk/server/static/assets/{dist-o2OVmKvt.js → dist-B0gdk4rl.js} +1 -1
  291. ksadk/server/static/assets/{dist-4N2NMVYg.js → dist-B1oWRmrH.js} +1 -1
  292. ksadk/server/static/assets/{dist-CmZHzlwZ.js → dist-BI1qQH4n.js} +1 -1
  293. ksadk/server/static/assets/{dist-X4TnqwOK.js → dist-BJLUwH6W.js} +1 -1
  294. ksadk/server/static/assets/{dist-B5oS1zcj.js → dist-Bbwqa8TG.js} +1 -1
  295. ksadk/server/static/assets/{dist-j6Dxmf_j.js → dist-Btyo4vX4.js} +1 -1
  296. ksadk/server/static/assets/{dist-DQU9EWw-.js → dist-C71CsujO.js} +1 -1
  297. ksadk/server/static/assets/{dist-BIlKoW0k.js → dist-CXpH_Rdd.js} +1 -1
  298. ksadk/server/static/assets/{dist-DJN_6Y39.js → dist-Cq4OL6nO.js} +1 -1
  299. ksadk/server/static/assets/{dist-Dli7qW-B.js → dist-D1V3f1B4.js} +1 -1
  300. ksadk/server/static/assets/{dist-fhOuWds5.js → dist-DJmCPRVB.js} +1 -1
  301. ksadk/server/static/assets/{dist-CWV4lDr1.js → dist-DQAB0qn_.js} +2 -2
  302. ksadk/server/static/assets/{dist-D6MpCZtz.js → dist-DUwKa_l6.js} +1 -1
  303. ksadk/server/static/assets/dist-DdRBIceA.js +1 -0
  304. ksadk/server/static/assets/{dist-DWKByxWV.js → dist-DfGFrb0v.js} +1 -1
  305. ksadk/server/static/assets/{dist-DsHPdk3W.js → dist-DjhwGUgZ.js} +1 -1
  306. ksadk/server/static/assets/{dist-B-jNR6Vn.js → dist-DyqV4fL4.js} +1 -1
  307. ksadk/server/static/assets/{dist-BB3-OwTQ.js → dist-M67Hwu0n.js} +1 -1
  308. ksadk/server/static/assets/{dist-_pHPTyZ-.js → dist-u8tVH5Ak.js} +1 -1
  309. ksadk/server/static/assets/ebnfDiagram-PWID7BFC-DVfMsLge.js +1 -0
  310. ksadk/server/static/assets/erDiagram-SSCWMZ5O-CWEZSYaw.js +99 -0
  311. ksadk/server/static/assets/eventmodeling-NTZA5JFV-Dr5okd8V.js +1 -0
  312. ksadk/server/static/assets/flowDiagram-A5DVABFB-VEO-cVcO.js +1 -0
  313. ksadk/server/static/assets/ganttDiagram-EL5Y4UJY-TWIxoyYL.js +292 -0
  314. ksadk/server/static/assets/gitGraph-4MIJSDKK-CKiKY9Cf.js +1 -0
  315. ksadk/server/static/assets/gitGraphDiagram-WWUBYQGX-DDh2hd2S.js +106 -0
  316. ksadk/server/static/assets/index-B2k_urY8.js +241 -0
  317. ksadk/server/static/assets/index-ILPt6IWF.css +2 -0
  318. ksadk/server/static/assets/info-A6RAGUB7-ubA4Nm_p.js +1 -0
  319. ksadk/server/static/assets/infoDiagram-RXCK75RN-CgoyWiDR.js +2 -0
  320. ksadk/server/static/assets/{ishikawaDiagram-YF4QCWOH-K0OOfVna.js → ishikawaDiagram-5VMMS53U-CyRIu_om.js} +6 -6
  321. ksadk/server/static/assets/{journeyDiagram-JHISSGLW-8LeOJaZp.js → journeyDiagram-EYS64GPL-DN5JXHzN.js} +6 -6
  322. ksadk/server/static/assets/{kanban-definition-UN3LZRKU-C6uCgZrW.js → kanban-definition-3QL26DDD-CNP3ui66.js} +10 -10
  323. ksadk/server/static/assets/katex-DWEzQy1d.js +257 -0
  324. ksadk/server/static/assets/{linear-hdBcYzM8.js → linear-C-qHp7d2.js} +1 -1
  325. ksadk/server/static/assets/mermaid-parser.core-Cl-K943T.js +166 -0
  326. ksadk/server/static/assets/{mindmap-definition-RKZ34NQL-Bjy_2v4_.js → mindmap-definition-FBJOCRG2-D5DB5mYm.js} +29 -29
  327. ksadk/server/static/assets/packet-AYTQ26CC-C7R3NUlK.js +1 -0
  328. ksadk/server/static/assets/pegDiagram-XKGWAZYB-BQVc9ia_.js +1 -0
  329. ksadk/server/static/assets/pie-WAS4IAKB-BIT6qjr3.js +1 -0
  330. ksadk/server/static/assets/pieDiagram-E7YTZNPT-B6UCAvtY.js +39 -0
  331. ksadk/server/static/assets/{quadrantDiagram-W4KKPZXB-BmkRbwCg.js → quadrantDiagram-AXDQQJYC-mIr2d3eb.js} +6 -6
  332. ksadk/server/static/assets/radar-RG4KPBEZ-l5noef9X.js +1 -0
  333. ksadk/server/static/assets/railroad-74A4TZTK-Baea6ZvM.js +1 -0
  334. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-OKn8zZnU.js +1 -0
  335. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-DdKAKC4l.js +1 -0
  336. ksadk/server/static/assets/railroad-peg-WCYAUIDC-Bds8udlG.js +1 -0
  337. ksadk/server/static/assets/railroadDiagram-O6MQD6OU-Dt3FFDmK.js +1 -0
  338. ksadk/server/static/assets/requirementDiagram-EFPCY7ZU-Cz_vQtgF.js +84 -0
  339. ksadk/server/static/assets/{sankeyDiagram-5OEKKPKP-l6iXmU65.js → sankeyDiagram-P5KCCOFB-wlO1TsH5.js} +7 -7
  340. ksadk/server/static/assets/{sequenceDiagram-3UESZ5HK-Cq6UBeQB.js → sequenceDiagram-WJ2MYXX4-CHRbElYq.js} +10 -10
  341. ksadk/server/static/assets/sizeCapture-X5ZJPWSS-DXX54iyO.js +1 -0
  342. ksadk/server/static/assets/stateDiagram-HBIQ2CUA-Dp_lw9II.js +1 -0
  343. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-5b-8o2iS.js +1 -0
  344. ksadk/server/static/assets/swimlanes-XN3QIQJK-D8O5UlLG.js +1 -0
  345. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uf6WPRA4.js +8 -0
  346. ksadk/server/static/assets/{timeline-definition-PNZ67QCA-DEz24vV0.js → timeline-definition-24CTP7MA-8mfKcxvG.js} +7 -7
  347. ksadk/server/static/assets/treeView-Q6P3EWNA-CK5CSrSO.js +1 -0
  348. ksadk/server/static/assets/treemap-WGGIJYW6-Ch2BKgAM.js +1 -0
  349. ksadk/server/static/assets/vennDiagram-4TSXK5OY-EnNl0DE7.js +34 -0
  350. ksadk/server/static/assets/wardley-WFR3VGLG-YW3Q0ml_.js +1 -0
  351. ksadk/server/static/assets/wardleyDiagram-VM6X3IG4-DBu5fbYr.js +78 -0
  352. ksadk/server/static/assets/xychartDiagram-S5SC5T6Z-BSVXs4IY.js +7 -0
  353. ksadk/server/static/index.html +2 -2
  354. ksadk/sessions/__init__.py +26 -9
  355. ksadk/sessions/_local_service_sync.py +688 -0
  356. ksadk/sessions/_local_tables.py +21 -0
  357. ksadk/sessions/_postgres_schema.py +305 -0
  358. ksadk/sessions/_postgres_tables.py +15 -0
  359. ksadk/sessions/base.py +80 -1
  360. ksadk/sessions/in_memory.py +53 -2
  361. ksadk/sessions/local_service.py +63 -604
  362. ksadk/sessions/postgres_service.py +58 -148
  363. ksadk/sessions/resilient.py +35 -1
  364. ksadk/skills/service_client.py +48 -0
  365. ksadk/studio/agent_lifecycle.py +26 -20
  366. ksadk/studio/api.py +1063 -69
  367. ksadk/studio/api_catalog_routes.py +5 -0
  368. ksadk/studio/api_contracts.py +148 -6
  369. ksadk/studio/api_memory_routes.py +82 -0
  370. ksadk/studio/api_plugin_routes.py +480 -0
  371. ksadk/studio/attachment_store.py +187 -0
  372. ksadk/studio/authoring.py +259 -28
  373. ksadk/studio/authoring_coordinator.py +809 -67
  374. ksadk/studio/builder.py +197 -40
  375. ksadk/studio/capabilities.py +17 -0
  376. ksadk/studio/cloud.py +1920 -95
  377. ksadk/studio/codex_agent_service.py +137 -15
  378. ksadk/studio/codex_authoring.py +469 -0
  379. ksadk/studio/codex_builder.py +177 -25
  380. ksadk/studio/codex_manifest.py +71 -22
  381. ksadk/studio/codex_run.py +59 -4
  382. ksadk/studio/compatibility_report.py +445 -0
  383. ksadk/studio/compiler.py +7 -1
  384. ksadk/studio/contracts.py +234 -4
  385. ksadk/studio/dsh_provider_registration.py +768 -0
  386. ksadk/studio/event_store.py +79 -101
  387. ksadk/studio/framework_run.py +264 -3
  388. ksadk/studio/hosted_kernel.py +317 -0
  389. ksadk/studio/manifest_resolver.py +131 -0
  390. ksadk/studio/model_client.py +95 -9
  391. ksadk/studio/model_profile_service.py +1 -1
  392. ksadk/studio/operations.py +47 -5
  393. ksadk/studio/otel_trace.py +348 -42
  394. ksadk/studio/pcm_memory.py +85 -0
  395. ksadk/studio/plugin_composition.py +301 -0
  396. ksadk/studio/plugin_kernel_adapter.py +128 -0
  397. ksadk/studio/plugin_runtime.py +652 -0
  398. ksadk/studio/repository.py +23 -2
  399. ksadk/studio/resource_catalog.py +49 -1
  400. ksadk/studio/run_service.py +1266 -202
  401. ksadk/studio/runtime_source.py +51 -17
  402. ksadk/studio/scheduler_runtime.py +374 -0
  403. ksadk/studio/scheduler_service.py +211 -0
  404. ksadk/studio/service.py +1815 -117
  405. ksadk/studio/shared_web.py +199 -50
  406. ksadk/studio/soul.py +52 -0
  407. ksadk/studio/static/assets/index-DXs1Eq4M.css +1 -0
  408. ksadk/studio/static/assets/index-DeDqwTsD.js +283 -0
  409. ksadk/studio/static/index.html +2 -2
  410. ksadk/studio/templates.py +100 -8
  411. ksadk/studio/validator.py +20 -1
  412. ksadk/studio/workspace.py +31 -32
  413. ksadk/tracing/setup.py +304 -3
  414. ksadk/version.py +1 -1
  415. ksadk_runtime_common/schemas/runtime_event_v1.json +37 -0
  416. ksadk_runtime_common/schemas/runtime_event_v2.json +271 -0
  417. ksadk_runtime_common/workspace_files/path_utils.py +41 -0
  418. ksadk/events/parser.py +0 -191
  419. ksadk/server/static/assets/MathMessageMarkdown-DeYh8QPr.css +0 -1
  420. ksadk/server/static/assets/MermaidBlock-NERD_ef7.js +0 -303
  421. ksadk/server/static/assets/NativeTerminalPanel-CiHWf82q.js +0 -1
  422. ksadk/server/static/assets/arc-DrgjcKhl.js +0 -1
  423. ksadk/server/static/assets/architecture-7EHR7CIX-CpZLRCcY.js +0 -1
  424. ksadk/server/static/assets/architectureDiagram-3BPJPVTR-BXoVRbQ6.js +0 -36
  425. ksadk/server/static/assets/blockDiagram-GPEHLZMM-BnaB3Ywv.js +0 -132
  426. ksadk/server/static/assets/c4Diagram-AAUBKEIU-Dw4weZcp.js +0 -10
  427. ksadk/server/static/assets/channel-Dt3rQTFI.js +0 -1
  428. ksadk/server/static/assets/chunk-2J33WTMH-ChjpLK7j.js +0 -1
  429. ksadk/server/static/assets/chunk-55IACEB6-CK4ROATy.js +0 -1
  430. ksadk/server/static/assets/chunk-727SXJPM-B9KtTTgw.js +0 -206
  431. ksadk/server/static/assets/chunk-AQP2D5EJ-1O1mki3m.js +0 -231
  432. ksadk/server/static/assets/chunk-QZHKN3VN-iXEZtKQc.js +0 -1
  433. ksadk/server/static/assets/classDiagram-4FO5ZUOK-DIveV17Q.js +0 -1
  434. ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-DIveV17Q.js +0 -1
  435. ksadk/server/static/assets/cytoscape.esm-DelgaX4f.js +0 -321
  436. ksadk/server/static/assets/dagre-BM42HDAG-D0QXg_MQ.js +0 -4
  437. ksadk/server/static/assets/dagre-Bx709z4p.js +0 -1
  438. ksadk/server/static/assets/diagram-2AECGRRQ-DBDDKwBQ.js +0 -43
  439. ksadk/server/static/assets/diagram-5GNKFQAL-BkwDOxmO.js +0 -10
  440. ksadk/server/static/assets/diagram-KO2AKTUF-Bv8waYvY.js +0 -3
  441. ksadk/server/static/assets/diagram-LMA3HP47-e1VECDdu.js +0 -24
  442. ksadk/server/static/assets/diagram-OG6HWLK6-Ds9adfRl.js +0 -24
  443. ksadk/server/static/assets/dist-B5J2uhNk.js +0 -1
  444. ksadk/server/static/assets/erDiagram-TEJ5UH35-BPItFKH6.js +0 -85
  445. ksadk/server/static/assets/eventmodeling-FCH6USID-DYFSxbqr.js +0 -1
  446. ksadk/server/static/assets/flowDiagram-I6XJVG4X-BbYB9w5Y.js +0 -162
  447. ksadk/server/static/assets/ganttDiagram-6RSMTGT7-TQXa0KXv.js +0 -292
  448. ksadk/server/static/assets/gitGraph-WXDBUCRP-DyNYp6BN.js +0 -1
  449. ksadk/server/static/assets/gitGraphDiagram-PVQCEYII-bKblCnpa.js +0 -106
  450. ksadk/server/static/assets/graphlib-B8gBHxth.js +0 -1
  451. ksadk/server/static/assets/index-R52pJJvg.js +0 -177
  452. ksadk/server/static/assets/index-jJr3_955.css +0 -2
  453. ksadk/server/static/assets/info-J43DQDTF-WUx7qTde.js +0 -1
  454. ksadk/server/static/assets/infoDiagram-5YYISTIA-BGVT7J_i.js +0 -2
  455. ksadk/server/static/assets/katex-CYWseY5E.js +0 -265
  456. ksadk/server/static/assets/mermaid-parser.core-BWrDjSZM.js +0 -161
  457. ksadk/server/static/assets/packet-YPE3B663-BN13y_xl.js +0 -1
  458. ksadk/server/static/assets/pie-LRSECV5Y-ftSLXhhc.js +0 -1
  459. ksadk/server/static/assets/pieDiagram-4H26LBE5-GmmqNiVH.js +0 -30
  460. ksadk/server/static/assets/radar-GUYGQ44K-jaICkIeO.js +0 -1
  461. ksadk/server/static/assets/requirementDiagram-4Y6WPE33-DSWFqL7c.js +0 -84
  462. ksadk/server/static/assets/stateDiagram-AJRCARHV-qzTQpg3Y.js +0 -1
  463. ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-BYCoYGAN.js +0 -1
  464. ksadk/server/static/assets/treeView-BLDUP644-Cpib_vlz.js +0 -1
  465. ksadk/server/static/assets/treemap-LRROVOQU-DQxfmVHK.js +0 -1
  466. ksadk/server/static/assets/vennDiagram-CIIHVFJN-CMCixki2.js +0 -34
  467. ksadk/server/static/assets/wardley-L42UT6IY-BQYHnnkU.js +0 -1
  468. ksadk/server/static/assets/wardleyDiagram-YWT4CUSO-CVzB8F9K.js +0 -78
  469. ksadk/server/static/assets/xychartDiagram-2RQKCTM6-BFBqBLc1.js +0 -7
  470. ksadk/studio/evaluation.py +0 -192
  471. ksadk/studio/static/assets/index-CaEN0eTR.css +0 -1
  472. ksadk/studio/static/assets/index-DI2eY_NH.js +0 -252
  473. {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/WHEEL +0 -0
  474. {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/entry_points.txt +0 -0
  475. {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/licenses/LICENSE +0 -0
  476. {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/top_level.txt +0 -0
@@ -9,7 +9,16 @@ from datetime import datetime, timezone
9
9
  from typing import Any
10
10
  from uuid import uuid4
11
11
 
12
- from ksadk.studio.contracts import BuildStatus, OperationStatus, RunRecord, RunStatus
12
+ from ksadk.conversations.contracts import (
13
+ APPROVAL_MODE_EXTENSION,
14
+ COLLABORATION_MODE_EXTENSION,
15
+ GOAL_OBJECTIVE_EXTENSION,
16
+ ConversationAttachmentPart,
17
+ ConversationInput,
18
+ ConversationTextPart,
19
+ validate_conversation_input,
20
+ )
21
+ from ksadk.studio.contracts import OperationStatus, RunRecord, RunStatus
13
22
  from ksadk.studio.errors import StudioError, not_found
14
23
  from ksadk.studio.service import StudioService
15
24
  from ksadk.tools.gateway import tool_approval_capability
@@ -144,7 +153,7 @@ class StudioSharedWebBridge:
144
153
  self.studio.event_store.delete_session(session_id)
145
154
  return {}
146
155
 
147
- def list_messages(
156
+ async def list_messages(
148
157
  self,
149
158
  session_id: str,
150
159
  *,
@@ -176,7 +185,7 @@ class StudioSharedWebBridge:
176
185
  "Timestamp": self._timestamp(run.completed_at or run.started_at),
177
186
  "SeqId": sequence,
178
187
  "InvocationId": run.id,
179
- "Activities": self._run_activities(run),
188
+ "Activities": await self._run_activities(run),
180
189
  }
181
190
  )
182
191
 
@@ -195,12 +204,12 @@ class StudioSharedWebBridge:
195
204
  "NextCursor": selected[0]["SeqId"] if has_more and selected else None,
196
205
  }
197
206
 
198
- def list_session_events(self, session_id: str) -> dict[str, Any]:
207
+ async def list_session_events(self, session_id: str) -> dict[str, Any]:
199
208
  runs = self.studio.event_store.list_runs(session_id=session_id)
200
209
  events: list[dict[str, Any]] = []
201
210
  sequence = 0
202
211
  for run in runs:
203
- for event in self.studio.event_store.events(run.id):
212
+ for event in await self.studio.run_service.events(run.id):
204
213
  sequence += 1
205
214
  events.append(
206
215
  {
@@ -247,11 +256,38 @@ class StudioSharedWebBridge:
247
256
  prompt = self._input_text(payload)
248
257
  runtime_input = self._runtime_input(payload)
249
258
  model = self._select_model(agent_id, str(payload.get("Model") or ""))
259
+ model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
250
260
  approval_mode = str(payload.get("ApprovalMode") or "")
251
261
  collaboration_mode = str(payload.get("CollaborationMode") or "")
252
262
  goal_objective = str(payload.get("GoalObjective") or "")
263
+ reasoning_effort = str(payload.get("ReasoningEffort") or "")
264
+ try:
265
+ build = await self._ensure_build(agent_id)
266
+ self._validate_conversation_turn(
267
+ build_id=build.id,
268
+ session_id=session_id,
269
+ invocation_id=invocation_id,
270
+ prompt=prompt,
271
+ runtime_input=runtime_input,
272
+ model=model if model_explicit else "",
273
+ approval_mode=approval_mode,
274
+ collaboration_mode=collaboration_mode,
275
+ goal_objective=goal_objective,
276
+ reasoning_effort=reasoning_effort,
277
+ )
278
+ except StudioError as exc:
279
+ # StreamingResponse starts the HTTP response before advancing this
280
+ # generator. Preflight failures therefore belong in the stream;
281
+ # raising here would turn an actionable Studio error into Starlette's
282
+ # "response already started" RuntimeError.
283
+ yield self._failed_sse(invocation_id, exc.message)
284
+ return
285
+ except Exception:
286
+ yield self._failed_sse(invocation_id, "本地 Agent 运行失败")
287
+ return
253
288
  execution = asyncio.create_task(
254
289
  self._execute_run(
290
+ build=build,
255
291
  agent_id=agent_id,
256
292
  session_id=session_id,
257
293
  invocation_id=invocation_id,
@@ -261,6 +297,7 @@ class StudioSharedWebBridge:
261
297
  approval_mode=approval_mode,
262
298
  collaboration_mode=collaboration_mode,
263
299
  goal_objective=goal_objective,
300
+ reasoning_effort=reasoning_effort,
264
301
  )
265
302
  )
266
303
 
@@ -290,7 +327,7 @@ class StudioSharedWebBridge:
290
327
  emitted_text = ""
291
328
  idle_polls = 0
292
329
  while not execution.done():
293
- projected = self._project_response_events(
330
+ projected = await self._project_response_events(
294
331
  session_id=session_id,
295
332
  agent_id=agent_id,
296
333
  invocation_id=invocation_id,
@@ -309,7 +346,7 @@ class StudioSharedWebBridge:
309
346
  yield ": keep-alive\n\n"
310
347
  await asyncio.sleep(0.05)
311
348
  run = await execution
312
- for event_name, event_payload in self._project_response_events(
349
+ for event_name, event_payload in await self._project_response_events(
313
350
  session_id=session_id,
314
351
  agent_id=agent_id,
315
352
  invocation_id=invocation_id,
@@ -353,20 +390,39 @@ class StudioSharedWebBridge:
353
390
  session_id = str(payload.get("SessionId") or f"ses_{uuid4().hex}")
354
391
  invocation_id = str(payload.get("InvocationId") or f"resp_{uuid4().hex}")
355
392
  model = self._select_model(agent_id, str(payload.get("Model") or ""))
393
+ model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
356
394
  approval_mode = str(payload.get("ApprovalMode") or "")
357
395
  collaboration_mode = str(payload.get("CollaborationMode") or "")
358
396
  goal_objective = str(payload.get("GoalObjective") or "")
397
+ reasoning_effort = str(payload.get("ReasoningEffort") or "")
398
+ build = await self._ensure_build(agent_id)
399
+ prompt = self._input_text(payload)
400
+ runtime_input = self._runtime_input(payload)
401
+ self._validate_conversation_turn(
402
+ build_id=build.id,
403
+ session_id=session_id,
404
+ invocation_id=invocation_id,
405
+ prompt=prompt,
406
+ runtime_input=runtime_input,
407
+ model=model if model_explicit else "",
408
+ approval_mode=approval_mode,
409
+ collaboration_mode=collaboration_mode,
410
+ goal_objective=goal_objective,
411
+ reasoning_effort=reasoning_effort,
412
+ )
359
413
  try:
360
414
  run = await self._execute_run(
415
+ build=build,
361
416
  agent_id=agent_id,
362
417
  session_id=session_id,
363
418
  invocation_id=invocation_id,
364
- prompt=self._input_text(payload),
365
- runtime_input=self._runtime_input(payload),
419
+ prompt=prompt,
420
+ runtime_input=runtime_input,
366
421
  model=model,
367
422
  approval_mode=approval_mode,
368
423
  collaboration_mode=collaboration_mode,
369
424
  goal_objective=goal_objective,
425
+ reasoning_effort=reasoning_effort,
370
426
  )
371
427
  return self._response_payload(
372
428
  run,
@@ -379,6 +435,7 @@ class StudioSharedWebBridge:
379
435
  async def _execute_run(
380
436
  self,
381
437
  *,
438
+ build: Any = None,
382
439
  agent_id: str,
383
440
  session_id: str,
384
441
  invocation_id: str,
@@ -388,8 +445,19 @@ class StudioSharedWebBridge:
388
445
  approval_mode: str = "",
389
446
  collaboration_mode: str = "",
390
447
  goal_objective: str = "",
448
+ reasoning_effort: str = "",
391
449
  ) -> RunRecord:
392
- build = await self._ensure_build(agent_id)
450
+ if build is None:
451
+ build = await self._ensure_build(agent_id)
452
+ bound_agent = str(
453
+ getattr(build, "agent_name", None) or getattr(build, "agent_id", "")
454
+ )
455
+ if bound_agent != agent_id:
456
+ raise StudioError(
457
+ "CONVERSATION_BUILD_MISMATCH",
458
+ "会话 Build 不属于当前 Agent",
459
+ status_code=409,
460
+ )
393
461
 
394
462
  def observe(event: Any) -> None:
395
463
  if event.type == "run.created":
@@ -405,6 +473,7 @@ class StudioSharedWebBridge:
405
473
  approval_mode=approval_mode or None,
406
474
  collaboration_mode=collaboration_mode or None,
407
475
  goal_objective=goal_objective or None,
476
+ reasoning_effort=reasoning_effort or None,
408
477
  runtime_input=runtime_input or None,
409
478
  idempotency_key=f"responses:{invocation_id}",
410
479
  on_event=observe,
@@ -434,7 +503,7 @@ class StudioSharedWebBridge:
434
503
  "output": [],
435
504
  }
436
505
 
437
- def _project_response_events(
506
+ async def _project_response_events(
438
507
  self,
439
508
  *,
440
509
  session_id: str,
@@ -449,7 +518,7 @@ class StudioSharedWebBridge:
449
518
  for run in self.studio.event_store.list_runs(session_id=session_id):
450
519
  if run.agent_id != agent_id or run.id != current_run_id:
451
520
  continue
452
- events = self.studio.event_store.events(run.id)
521
+ events = await self.studio.run_service.events(run.id)
453
522
  starts = {
454
523
  str(event.data.get("callId") or event.data.get("call_id") or ""): event.data
455
524
  for event in events
@@ -541,11 +610,11 @@ class StudioSharedWebBridge:
541
610
  "id": call_id or f"shell_{uuid4().hex}",
542
611
  "call_id": call_id,
543
612
  "type": "shell_call",
544
- "status": "failed"
545
- if event_type.endswith("failed") or data.get("exitCode") not in {None, 0}
546
- else "completed"
547
- if done
548
- else "in_progress",
613
+ "status": (
614
+ "failed"
615
+ if event_type.endswith("failed") or data.get("exitCode") not in {None, 0}
616
+ else "completed" if done else "in_progress"
617
+ ),
549
618
  "action": {
550
619
  "commands": [command],
551
620
  "cwd": data.get("cwd") or started.get("cwd") or "",
@@ -562,11 +631,11 @@ class StudioSharedWebBridge:
562
631
  "type": "function_call",
563
632
  "name": name,
564
633
  "arguments": json.dumps(args, ensure_ascii=False) if args is not None else "",
565
- "status": "failed"
566
- if event_type.endswith("failed")
567
- else "completed"
568
- if done
569
- else "in_progress",
634
+ "status": (
635
+ "failed"
636
+ if event_type.endswith("failed")
637
+ else "completed" if done else "in_progress"
638
+ ),
570
639
  "output": data.get("output") or data.get("result") or "",
571
640
  }
572
641
  elif event_type == "approval.requested":
@@ -653,29 +722,94 @@ class StudioSharedWebBridge:
653
722
  }
654
723
 
655
724
  async def _ensure_build(self, agent_id: str):
656
- if self.studio.is_codex_agent(agent_id):
657
- self.studio.codex_agent_detail(agent_id)
658
- builds = [
659
- record
660
- for record in self.studio.codex_builds.list()
661
- if record.agent_name == agent_id and self.studio.codex_builder.is_current(record)
662
- ]
663
- if builds:
664
- return builds[0]
665
- return await asyncio.to_thread(self.studio.codex_builder.build, agent_id)
666
- for record in self.studio.builds.list_for_agent(agent_id):
667
- if record.status == BuildStatus.SUCCEEDED:
668
- return record
669
- draft = self.studio.drafts.get(agent_id)
670
- if draft.spec.model is None and not draft.spec.bindings.model_profile_id:
725
+ return await self.studio.ensure_current_build(agent_id)
726
+
727
+ def _validate_conversation_turn(
728
+ self,
729
+ *,
730
+ build_id: str,
731
+ session_id: str,
732
+ invocation_id: str,
733
+ prompt: str,
734
+ runtime_input: Any,
735
+ model: str,
736
+ approval_mode: str,
737
+ collaboration_mode: str,
738
+ goal_objective: str,
739
+ reasoning_effort: str,
740
+ ) -> None:
741
+ """Revalidate compatibility requests against the active Surface.
742
+
743
+ `/v1/responses` and the legacy RunAgent action remain supported wire
744
+ shapes, but neither may smuggle provider-only input past the shared
745
+ ConversationInput contract.
746
+ """
747
+
748
+ surface = self.studio.conversation_surface(build_id, session_id=session_id)
749
+ parts: list[ConversationTextPart | ConversationAttachmentPart] = [
750
+ ConversationTextPart(text=prompt)
751
+ ]
752
+ for index, item in enumerate(runtime_input if isinstance(runtime_input, list) else []):
753
+ if not isinstance(item, dict):
754
+ continue
755
+ kind = str(item.get("type") or "")
756
+ if kind in {"image", "input_image"}:
757
+ media_type = self._data_url_media_type(
758
+ str(item.get("url") or item.get("image_url") or ""),
759
+ fallback="image/*",
760
+ )
761
+ parts.append(
762
+ ConversationAttachmentPart(
763
+ attachment_ref=f"attachment://inline/{invocation_id}/{index}",
764
+ media_type=media_type,
765
+ name=str(item.get("filename") or "image"),
766
+ )
767
+ )
768
+ elif kind == "input_file":
769
+ parts.append(
770
+ ConversationAttachmentPart(
771
+ attachment_ref=f"attachment://inline/{invocation_id}/{index}",
772
+ media_type=self._data_url_media_type(
773
+ str(item.get("file_data") or item.get("file_url") or ""),
774
+ fallback="application/octet-stream",
775
+ ),
776
+ name=str(item.get("filename") or "attachment"),
777
+ )
778
+ )
779
+ conversation_input = ConversationInput(
780
+ input_id=invocation_id,
781
+ session_id=session_id,
782
+ idempotency_key=f"responses:{invocation_id}",
783
+ parts=tuple(parts),
784
+ model_ref=model or None,
785
+ reasoning=reasoning_effort or None,
786
+ extensions={
787
+ key: value
788
+ for key, value in (
789
+ (APPROVAL_MODE_EXTENSION, approval_mode or None),
790
+ (COLLABORATION_MODE_EXTENSION, collaboration_mode or None),
791
+ (GOAL_OBJECTIVE_EXTENSION, goal_objective or None),
792
+ )
793
+ if value is not None
794
+ },
795
+ )
796
+ try:
797
+ validate_conversation_input(surface, conversation_input)
798
+ except ValueError as exc:
671
799
  raise StudioError(
672
- "AGENT_MODEL_REQUIRED",
673
- "当前 Agent 未绑定 Model Profile,请先在 Agent 配置中选择模型;"
674
- "API Key 只提供访问凭证,不会自动绑定模型。",
800
+ "CONVERSATION_INPUT_UNSUPPORTED",
801
+ "当前 Agent 不支持此会话输入",
675
802
  status_code=422,
676
- field="spec.bindings.modelProfileId",
677
- )
678
- return await asyncio.to_thread(self.studio.builder.build, draft)
803
+ details={"reason": str(exc), "surfaceId": surface.surface_id},
804
+ ) from exc
805
+
806
+ @staticmethod
807
+ def _data_url_media_type(value: str, *, fallback: str) -> str:
808
+ if value.startswith("data:"):
809
+ media_type = value[5:].split(";", 1)[0].strip().lower()
810
+ if media_type:
811
+ return media_type
812
+ return fallback
679
813
 
680
814
  def _sessions(self, agent_id: str) -> list[dict[str, Any]]:
681
815
  grouped: dict[str, list[RunRecord]] = {}
@@ -812,7 +946,7 @@ class StudioSharedWebBridge:
812
946
  model_id = spec.model
813
947
  metadata = dict(spec.metadata or {})
814
948
  resolved_display_name = display_name or spec.model
815
- max_output_tokens = spec.parameters.max_tokens
949
+ max_output_tokens = spec.parameters.max_tokens or 4096
816
950
  return {
817
951
  **metadata,
818
952
  "id": model_id,
@@ -862,10 +996,14 @@ class StudioSharedWebBridge:
862
996
  def _draft(self, agent_id: str):
863
997
  return self.studio.agent_detail(agent_id)["draft"]
864
998
 
865
- def _run_activities(self, run: RunRecord) -> list[dict[str, Any]]:
999
+ async def _run_activities(self, run: RunRecord) -> list[dict[str, Any]]:
866
1000
  activities: list[dict[str, Any]] = []
867
- for event in self.studio.event_store.events(run.id):
868
- operations = event.data.get("a2ui_operations") or event.data.get("operations")
1001
+ for event in await self.studio.run_service.events(run.id):
1002
+ operations = (
1003
+ event.data.get("a2uiOperations")
1004
+ or event.data.get("a2ui_operations")
1005
+ or event.data.get("operations")
1006
+ )
869
1007
  if not isinstance(operations, list):
870
1008
  continue
871
1009
  surface_id = str(
@@ -929,7 +1067,7 @@ class StudioSharedWebBridge:
929
1067
  if not isinstance(content, list):
930
1068
  continue
931
1069
  items: list[dict[str, str]] = []
932
- has_image = False
1070
+ has_attachment = False
933
1071
  for part in content:
934
1072
  if not isinstance(part, dict):
935
1073
  continue
@@ -944,8 +1082,19 @@ class StudioSharedWebBridge:
944
1082
  )
945
1083
  if url:
946
1084
  items.append({"type": "image", "url": url})
947
- has_image = True
948
- if items and has_image:
1085
+ has_attachment = True
1086
+ elif kind == "input_file":
1087
+ data = str(part.get("file_data") or part.get("file_url") or "")
1088
+ if data:
1089
+ items.append(
1090
+ {
1091
+ "type": "input_file",
1092
+ "file_data": data,
1093
+ "filename": str(part.get("filename") or "attachment"),
1094
+ }
1095
+ )
1096
+ has_attachment = True
1097
+ if items and has_attachment:
949
1098
  return items
950
1099
  return []
951
1100
 
ksadk/studio/soul.py ADDED
@@ -0,0 +1,52 @@
1
+ """Deterministic SoulDocument rendering and prompt compilation helpers."""
2
+ from __future__ import annotations
3
+
4
+ import hashlib
5
+ import json
6
+
7
+ from ksadk.studio.contracts import Instructions, SoulDocument
8
+
9
+
10
+ def render_soul_markdown(soul: SoulDocument) -> str:
11
+ """Render a portable ``soul.md`` snapshot without executable directives."""
12
+
13
+ lines = ["# Soul", "", "## Identity", soul.identity.strip()]
14
+ if soul.principles:
15
+ lines.extend(["", "## Principles", *[f"- {item.strip()}" for item in soul.principles]])
16
+ if soul.boundaries:
17
+ lines.extend(["", "## Boundaries", *[f"- {item.strip()}" for item in soul.boundaries]])
18
+ if soul.tone:
19
+ lines.extend(["", "## Tone", soul.tone.strip()])
20
+ return "\n".join(lines).rstrip() + "\n"
21
+
22
+
23
+ def soul_digest(soul: SoulDocument) -> str:
24
+ """Content-address the reviewed structured source, not rendered whitespace."""
25
+
26
+ payload = soul.model_dump(by_alias=True, exclude_none=True, mode="json")
27
+ canonical = json.dumps(
28
+ payload, ensure_ascii=False, sort_keys=True, separators=(",", ":")
29
+ ).encode("utf-8")
30
+ return f"sha256:{hashlib.sha256(canonical).hexdigest()}"
31
+
32
+
33
+ def compose_system_instruction(
34
+ instructions: Instructions, soul: SoulDocument | None
35
+ ) -> Instructions:
36
+ """Put the reviewed identity before mutable task-specific system guidance."""
37
+
38
+ if soul is None:
39
+ return instructions
40
+ soul_section = render_soul_markdown(soul).rstrip()
41
+ system = "\n\n".join(
42
+ part
43
+ for part in (
44
+ soul_section,
45
+ instructions.system.strip(),
46
+ )
47
+ if part
48
+ )
49
+ return instructions.model_copy(update={"system": system})
50
+
51
+
52
+ __all__ = ["compose_system_instruction", "render_soul_markdown", "soul_digest"]