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
@@ -0,0 +1,652 @@
1
+ """Local Studio execution for immutable PluginHost AgentBundle v2 builds."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import json
7
+ from collections.abc import Mapping, Sequence
8
+ from dataclasses import dataclass
9
+ from pathlib import Path
10
+ from typing import Any, cast
11
+
12
+ from ksadk.harness.reasoner import (
13
+ HarnessReasoner,
14
+ HarnessReasoningTurn,
15
+ HarnessToolCall,
16
+ )
17
+ from ksadk.plugins.builtins import (
18
+ builtin_capability_factories,
19
+ builtin_capability_manifests,
20
+ )
21
+ from ksadk.plugins.bundle import PluginBundleError, PluginBundleResolver, ResolvedPluginBundle
22
+ from ksadk.plugins.contracts import CompositionProfile, PluginManifest
23
+ from ksadk.plugins.host import PluginHost, PluginHostError
24
+ from ksadk.plugins.providers.harness import (
25
+ HarnessTurnResult,
26
+ KsADKHarnessProviderFactory,
27
+ )
28
+ from ksadk.plugins.providers.legacy import (
29
+ LegacyBundleAdapter,
30
+ LegacyBundleCompatibilityError,
31
+ LegacyHarnessSource,
32
+ )
33
+ from ksadk.plugins.providers.legacy_catalog import (
34
+ KSADK_HARNESS_AGENT_PROVIDER_PLUGIN_ID,
35
+ builtin_agent_provider_manifests,
36
+ legacy_harness_agent_provider_manifest,
37
+ )
38
+ from ksadk.plugins.resolver import PluginRegistry
39
+ from ksadk.runtime import RuntimeLaunchContext
40
+ from ksadk.sessions.base import BaseSessionService
41
+ from ksadk.studio.contracts import (
42
+ BuildRecord,
43
+ NetworkPolicy,
44
+ ResolvedModel,
45
+ )
46
+ from ksadk.studio.errors import StudioError
47
+ from ksadk.studio.model_client import OpenAICompatibleModelClient
48
+ from ksadk.studio.plugin_kernel_adapter import StudioPluginKernelAdapter
49
+ from ksadk.studio.repository import BuildRepository
50
+ from ksadk.studio.run_service import StudioRunSpec
51
+ from ksadk.studio.workspace import Workspace
52
+
53
+ _COMPOSED_RUNTIME_TYPES = frozenset({"harness", "plugin"})
54
+
55
+
56
+ @dataclass(frozen=True)
57
+ class StudioPluginTurnResult:
58
+ """Normalized result retained at the Studio/third-party boundary."""
59
+
60
+ output_text: str
61
+ session_id: str
62
+ usage: Mapping[str, Any]
63
+ metadata: Mapping[str, Any]
64
+ raw: Any
65
+
66
+
67
+ @dataclass
68
+ class _HostEntry:
69
+ agent_id: str
70
+ bundle: ResolvedPluginBundle
71
+ host: PluginHost
72
+
73
+
74
+ class _StudioHarnessReasoner:
75
+ """Bind the Harness loop to the immutable Studio model/network policy."""
76
+
77
+ def __init__(
78
+ self,
79
+ client: OpenAICompatibleModelClient,
80
+ *,
81
+ model: ResolvedModel,
82
+ network_policy: NetworkPolicy,
83
+ timeout_seconds: int,
84
+ max_attempts: int,
85
+ backoff_seconds: float,
86
+ ) -> None:
87
+ self._client = client
88
+ self._model = model
89
+ self._network_policy = network_policy
90
+ self._timeout_seconds = timeout_seconds
91
+ self._max_attempts = max_attempts
92
+ self._backoff_seconds = backoff_seconds
93
+
94
+ async def complete(
95
+ self,
96
+ *,
97
+ model: str,
98
+ prompt: str,
99
+ messages: Sequence[dict[str, Any]],
100
+ tools: Sequence[Any],
101
+ ) -> HarnessReasoningTurn:
102
+ del prompt
103
+ if model != self._model.model:
104
+ raise PluginHostError(
105
+ "harness_model_not_bound",
106
+ f"Harness requested unbound model {model!r}",
107
+ )
108
+ response = await self._client.complete(
109
+ self._model,
110
+ messages=[dict(message) for message in messages],
111
+ network_policy=self._network_policy,
112
+ timeout_seconds=self._timeout_seconds,
113
+ max_attempts=self._max_attempts,
114
+ backoff_seconds=self._backoff_seconds,
115
+ tools=[dict(tool.openai_schema) for tool in tools],
116
+ allow_empty=bool(tools),
117
+ )
118
+ calls: list[HarnessToolCall] = []
119
+ for call in response.tool_calls:
120
+ try:
121
+ arguments = json.loads(call.arguments or "{}")
122
+ except json.JSONDecodeError as error:
123
+ raise PluginHostError(
124
+ "harness_tool_arguments_invalid",
125
+ f"model emitted invalid arguments for tool {call.name!r}",
126
+ ) from error
127
+ if not isinstance(arguments, dict):
128
+ raise PluginHostError(
129
+ "harness_tool_arguments_invalid",
130
+ f"model emitted non-object arguments for tool {call.name!r}",
131
+ )
132
+ calls.append(
133
+ HarnessToolCall(
134
+ call_id=call.id,
135
+ name=call.name,
136
+ arguments=arguments,
137
+ )
138
+ )
139
+ return HarnessReasoningTurn(
140
+ final_text=response.content or None,
141
+ tool_calls=tuple(calls),
142
+ )
143
+
144
+
145
+ class StudioPluginRuntime:
146
+ """Resolve, activate, and retain composed providers for Studio sessions."""
147
+
148
+ def __init__(
149
+ self,
150
+ workspace: Workspace,
151
+ *,
152
+ build_repository: BuildRepository,
153
+ session_service: BaseSessionService,
154
+ model_client: OpenAICompatibleModelClient,
155
+ secret_resolver: Any,
156
+ harness_reasoner: HarnessReasoner | None = None,
157
+ provider_manifests: Mapping[str, PluginManifest] | None = None,
158
+ provider_factories: Mapping[str, Any] | None = None,
159
+ legacy_harness_sources: Sequence[LegacyHarnessSource] = (),
160
+ ) -> None:
161
+ self.workspace = workspace
162
+ self.builds = build_repository
163
+ self._session_service = session_service
164
+ self._model_client = model_client
165
+ self._secret_resolver = secret_resolver
166
+ self._harness_reasoner = harness_reasoner
167
+ self._provider_manifests = dict(provider_manifests or {})
168
+ self._provider_factories = dict(provider_factories or {})
169
+ self._legacy_bundles = LegacyBundleAdapter(legacy_harness_sources)
170
+ self._lock = asyncio.Lock()
171
+ self._hosts: dict[str, _HostEntry] = {}
172
+
173
+ def replace_provider_registrations(
174
+ self,
175
+ provider_manifests: Mapping[str, PluginManifest],
176
+ provider_factories: Mapping[str, Any],
177
+ ) -> None:
178
+ """Bind one startup snapshot before any provider activation exists."""
179
+
180
+ manifests = dict(provider_manifests)
181
+ factories = dict(provider_factories)
182
+ if manifests.keys() != factories.keys():
183
+ raise ValueError(
184
+ "plugin provider manifests and factories must use the same exact references"
185
+ )
186
+ if self._hosts:
187
+ raise RuntimeError("cannot replace provider registrations after activation")
188
+ self._provider_manifests = manifests
189
+ self._provider_factories = factories
190
+
191
+ @property
192
+ def active_activation_count(self) -> int:
193
+ return sum(entry.host.activation_count for entry in self._hosts.values())
194
+
195
+ def resolve(self, build_id: str, *, model: str | None = None) -> StudioRunSpec:
196
+ build = self.builds.get(build_id)
197
+ runtime_type = build.runtime_type.strip().lower()
198
+ if runtime_type not in _COMPOSED_RUNTIME_TYPES:
199
+ raise StudioError(
200
+ "BUILD_RUNTIME_UNSUPPORTED",
201
+ "Build 不是 PluginHost Harness/Provider Runtime",
202
+ status_code=422,
203
+ details={"buildId": build_id, "runtimeType": runtime_type},
204
+ )
205
+ bundle_root = self._bundle_root(build)
206
+ bundle = self._resolve_bundle(bundle_root)
207
+ self._preflight_bundle(bundle)
208
+ selected_model = self._select_model(build, model)
209
+ resolved = bundle.resolved_agent_spec
210
+ instructions = resolved.get("instructions")
211
+ instructions = instructions if isinstance(instructions, Mapping) else {}
212
+ return StudioRunSpec(
213
+ launch_context=RuntimeLaunchContext(
214
+ runtime_type=runtime_type,
215
+ project_dir=bundle_root,
216
+ config={"plugin_bundle_digest": bundle.bundle_digest},
217
+ ),
218
+ build_id=build.id,
219
+ agent_id=build.agent_id,
220
+ model=selected_model,
221
+ request_config={
222
+ "agent_system": str(instructions.get("system") or ""),
223
+ "agent_task": str(instructions.get("task") or ""),
224
+ "plugin_bundle_digest": bundle.bundle_digest,
225
+ },
226
+ manifest_sha256=build.resolved_digest,
227
+ plugin_bundle_root=bundle_root,
228
+ )
229
+
230
+ async def execute(
231
+ self,
232
+ spec: StudioRunSpec,
233
+ request: Mapping[str, Any],
234
+ *,
235
+ session_id: str,
236
+ ) -> StudioPluginTurnResult:
237
+ if spec.plugin_bundle_root is None:
238
+ raise PluginHostError(
239
+ "plugin_bundle_unavailable", "Studio run has no PluginHost Bundle"
240
+ )
241
+ entry = await self._host_for(spec.plugin_bundle_root)
242
+ if entry.agent_id != spec.agent_id:
243
+ raise PluginHostError(
244
+ "plugin_bundle_agent_mismatch",
245
+ "Studio run Agent does not match its immutable PluginHost Bundle",
246
+ )
247
+ activation = await entry.host.open_activation(
248
+ entry.bundle,
249
+ activation_key=session_id,
250
+ )
251
+ raw = await activation.execute(dict(request))
252
+ return _normalize_result(raw, session_id=session_id)
253
+
254
+ def kernel_adapter_provider(self, spec: StudioRunSpec): # type: ignore[no-untyped-def]
255
+ """Return a lazy, Build-pinned adapter factory for Scheduler Kernel."""
256
+
257
+ if spec.plugin_bundle_root is None:
258
+ raise StudioError(
259
+ "PLUGIN_RUNTIME_UNAVAILABLE",
260
+ "Studio Build 没有 PluginHost Bundle",
261
+ status_code=409,
262
+ )
263
+ return lambda: StudioPluginKernelAdapter(self, spec)
264
+
265
+ async def kernel_adapter(
266
+ self,
267
+ spec: StudioRunSpec,
268
+ *,
269
+ session_id: str,
270
+ ) -> Any:
271
+ """Bind a Scheduler run to the provider-owned activation adapter."""
272
+
273
+ if spec.plugin_bundle_root is None:
274
+ raise StudioError(
275
+ "PLUGIN_RUNTIME_UNAVAILABLE",
276
+ "Studio Build 没有 PluginHost Bundle",
277
+ status_code=409,
278
+ )
279
+ entry = await self._host_for(spec.plugin_bundle_root)
280
+ if entry.agent_id != spec.agent_id:
281
+ raise PluginHostError(
282
+ "plugin_bundle_agent_mismatch",
283
+ "Studio run Agent does not match its immutable PluginHost Bundle",
284
+ )
285
+ activation = await entry.host.open_activation(
286
+ entry.bundle,
287
+ activation_key=session_id,
288
+ )
289
+ return await activation.runtime_adapter()
290
+
291
+ async def close_session(self, session_id: str) -> None:
292
+ async with self._lock:
293
+ entries = tuple(self._hosts.values())
294
+ for entry in entries:
295
+ await entry.host.close_activation(session_id)
296
+
297
+ async def aclose(self) -> None:
298
+ async with self._lock:
299
+ entries = tuple(self._hosts.values())
300
+ self._hosts.clear()
301
+ for entry in entries:
302
+ await entry.host.dispose()
303
+
304
+ async def _host_for(self, bundle_root: Path) -> _HostEntry:
305
+ # Re-resolve every turn. This deliberately rechecks enabled receipts and
306
+ # package digests rather than trusting a previously healthy child.
307
+ bundle = self._resolve_bundle(bundle_root)
308
+ key = bundle.bundle_digest
309
+ async with self._lock:
310
+ existing = self._hosts.get(key)
311
+ if existing is not None:
312
+ return existing
313
+
314
+ registry, factories, permissions = self._runtime_components(bundle)
315
+ verified = (
316
+ bundle
317
+ if bundle.manifest.bundle_format == "agentkit.bundle/v1"
318
+ else PluginBundleResolver(registry).resolve(bundle_root)
319
+ )
320
+ services: dict[str, Any] = {
321
+ "session_service": self._session_service,
322
+ # Providers resolve credential *references* at activation time.
323
+ # The DSH discovery host never receives this service.
324
+ "credential_resolver": self._secret_resolver,
325
+ }
326
+ provider_id, _provider_version = _parse_plugin_ref(
327
+ verified.composition.profile.agent_provider.ref
328
+ )
329
+ if provider_id == KSADK_HARNESS_AGENT_PROVIDER_PLUGIN_ID:
330
+ services["harness_reasoner"] = (
331
+ self._harness_reasoner or self._bound_harness_reasoner(verified)
332
+ )
333
+ host = PluginHost(
334
+ registry,
335
+ factories,
336
+ allowed_permissions=permissions,
337
+ services=services,
338
+ )
339
+ try:
340
+ await host.apply(verified.composition.profile)
341
+ except BaseException:
342
+ await host.dispose()
343
+ raise
344
+ candidate = _HostEntry(
345
+ agent_id=verified.manifest.agent_id,
346
+ bundle=verified,
347
+ host=host,
348
+ )
349
+ stale = [
350
+ (digest, entry)
351
+ for digest, entry in self._hosts.items()
352
+ if entry.agent_id == candidate.agent_id and digest != key
353
+ ]
354
+ self._hosts[key] = candidate
355
+ for digest, entry in stale:
356
+ self._hosts.pop(digest, None)
357
+ await entry.host.dispose()
358
+ return candidate
359
+
360
+ def _resolve_bundle(self, bundle_root: Path) -> ResolvedPluginBundle:
361
+ registered_ids = {
362
+ manifest.metadata.id for manifest in self._provider_manifests.values()
363
+ }
364
+ try:
365
+ manifest, selection = self._legacy_bundles.select_from_bundle(
366
+ bundle_root,
367
+ registered_provider_ids=registered_ids,
368
+ )
369
+ except LegacyBundleCompatibilityError as error:
370
+ code = (
371
+ "AGENT_PROVIDER_NOT_REGISTERED"
372
+ if error.code == "agent_provider_not_registered"
373
+ else "PLUGIN_BUNDLE_INVALID"
374
+ )
375
+ raise StudioError(
376
+ code,
377
+ "Harness Bundle 兼容性校验失败",
378
+ status_code=409,
379
+ details={"reason": error.code},
380
+ ) from error
381
+ if selection is not None and selection.route == "legacy":
382
+ assert selection.manifest is not None
383
+ profile = CompositionProfile.model_validate(
384
+ {
385
+ "agentProvider": {
386
+ "ref": (
387
+ f"plugin://{selection.manifest.metadata.id}"
388
+ f"@{selection.manifest.metadata.version}"
389
+ )
390
+ }
391
+ }
392
+ )
393
+ registry = PluginRegistry(
394
+ [selection.manifest, *builtin_capability_manifests()]
395
+ )
396
+ try:
397
+ resolved = json.loads(
398
+ (bundle_root / "resolved-agent-spec.json").read_text(encoding="utf-8")
399
+ )
400
+ except (OSError, UnicodeError, json.JSONDecodeError) as error:
401
+ raise StudioError(
402
+ "PLUGIN_BUNDLE_INVALID",
403
+ "Legacy Harness Bundle 缺少 resolved Agent spec",
404
+ status_code=409,
405
+ details={"reason": "legacy_resolved_spec_invalid"},
406
+ ) from error
407
+ if not isinstance(resolved, dict):
408
+ raise StudioError(
409
+ "PLUGIN_BUNDLE_INVALID",
410
+ "Legacy Harness resolved Agent spec 必须是对象",
411
+ status_code=409,
412
+ details={"reason": "legacy_resolved_spec_invalid"},
413
+ )
414
+ return ResolvedPluginBundle(
415
+ root=bundle_root,
416
+ manifest=manifest,
417
+ resolved_agent_spec=resolved,
418
+ composition=registry.resolve(profile),
419
+ )
420
+ profile = self._read_profile(bundle_root)
421
+ manifests = [
422
+ *builtin_agent_provider_manifests(),
423
+ *builtin_capability_manifests(),
424
+ ]
425
+ external = self._external_manifest(profile)
426
+ if external is not None:
427
+ manifests.append(external)
428
+ try:
429
+ return PluginBundleResolver(PluginRegistry(manifests)).resolve(bundle_root)
430
+ except PluginBundleError as error:
431
+ raise StudioError(
432
+ "PLUGIN_BUNDLE_INVALID",
433
+ "PluginHost Bundle 校验失败",
434
+ status_code=409,
435
+ details={"reason": error.code},
436
+ ) from error
437
+
438
+ def _runtime_components(
439
+ self,
440
+ bundle: ResolvedPluginBundle,
441
+ ) -> tuple[PluginRegistry, dict[str, Any], frozenset[str]]:
442
+ manifests: list[PluginManifest] = [
443
+ *builtin_agent_provider_manifests(),
444
+ *builtin_capability_manifests(),
445
+ ]
446
+ factories = builtin_capability_factories(
447
+ state_root=self.workspace.resolve(".agentkit/plugin-runtime/state"),
448
+ secret_resolver=self._secret_resolver.resolve,
449
+ )
450
+ provider_id, provider_version = _parse_plugin_ref(
451
+ bundle.composition.profile.agent_provider.ref
452
+ )
453
+ provider_ref = f"plugin://{provider_id}@{provider_version}"
454
+ if bundle.manifest.bundle_format == "agentkit.bundle/v1":
455
+ manifest = legacy_harness_agent_provider_manifest()
456
+ factory = KsADKHarnessProviderFactory(session_service=self._session_service)
457
+ else:
458
+ manifest = self._provider_manifests.get(provider_ref)
459
+ factory = self._provider_factories.get(provider_ref)
460
+ if manifest is None or factory is None:
461
+ raise StudioError(
462
+ "AGENT_PROVIDER_NOT_REGISTERED",
463
+ "AgentProvider 尚未由当前 DSH Profile 完成预检与注册",
464
+ status_code=409,
465
+ details={"provider": provider_ref},
466
+ )
467
+ manifests.append(manifest)
468
+ factories[provider_id] = factory
469
+
470
+ builtin_ids = {
471
+ manifest.metadata.id
472
+ for manifest in (
473
+ *builtin_agent_provider_manifests(),
474
+ *builtin_capability_manifests(),
475
+ )
476
+ }
477
+ allowed = {
478
+ permission
479
+ for manifest in manifests
480
+ if manifest.metadata.id in builtin_ids
481
+ for permission in manifest.spec.permissions
482
+ }
483
+ security = bundle.resolved_agent_spec.get("security")
484
+ if isinstance(security, Mapping):
485
+ raw = security.get("allowedPermissions") or security.get("allowed_permissions") or []
486
+ if isinstance(raw, Sequence) and not isinstance(raw, (str, bytes)):
487
+ allowed.update(str(item) for item in raw)
488
+ return PluginRegistry(manifests), factories, frozenset(allowed)
489
+
490
+ def _preflight_bundle(self, bundle: ResolvedPluginBundle) -> None:
491
+ """Reject an unusable composition before a Run or Schedule is admitted.
492
+
493
+ Provider activation is intentionally lazy, but permission and graph
494
+ admission are deterministic from the immutable Bundle. Delaying this
495
+ check until ``RuntimeAdapter.start`` lets an accepted Inbox message
496
+ repeatedly create PENDING Runs that can never become runnable.
497
+ """
498
+
499
+ registry, factories, permissions = self._runtime_components(bundle)
500
+ host = PluginHost(
501
+ registry,
502
+ factories,
503
+ allowed_permissions=permissions,
504
+ )
505
+ try:
506
+ host.preflight(bundle.composition.profile)
507
+ except PluginHostError as error:
508
+ code = (
509
+ "PLUGIN_PERMISSION_DENIED"
510
+ if error.code == "plugin_permission_denied"
511
+ else "PLUGIN_RUNTIME_PREFLIGHT_FAILED"
512
+ )
513
+ raise StudioError(
514
+ code,
515
+ "Agent 插件组合未通过运行前检查",
516
+ status_code=409,
517
+ details={"reason": error.code},
518
+ ) from error
519
+
520
+ def _bound_harness_reasoner(self, bundle: ResolvedPluginBundle) -> HarnessReasoner:
521
+ spec = bundle.resolved_agent_spec
522
+ model = ResolvedModel.model_validate(spec.get("model"))
523
+ security = spec.get("security")
524
+ security = security if isinstance(security, Mapping) else {}
525
+ network = NetworkPolicy.model_validate(security.get("network") or {})
526
+ execution = spec.get("execution")
527
+ execution = execution if isinstance(execution, Mapping) else {}
528
+ retry = execution.get("retry")
529
+ retry = retry if isinstance(retry, Mapping) else {}
530
+ return _StudioHarnessReasoner(
531
+ self._model_client,
532
+ model=model,
533
+ network_policy=network,
534
+ timeout_seconds=int(
535
+ execution.get("timeoutSeconds") or execution.get("timeout_seconds") or 120
536
+ ),
537
+ max_attempts=int(
538
+ retry.get("maxAttempts") or retry.get("max_attempts") or 2
539
+ ),
540
+ backoff_seconds=float(
541
+ retry.get("backoffSeconds") or retry.get("backoff_seconds") or 1
542
+ ),
543
+ )
544
+
545
+ def _external_manifest(self, profile: CompositionProfile) -> PluginManifest | None:
546
+ plugin_id, version = _parse_plugin_ref(profile.agent_provider.ref)
547
+ builtin_ids = {
548
+ manifest.metadata.id for manifest in builtin_agent_provider_manifests()
549
+ }
550
+ if plugin_id in builtin_ids:
551
+ return None
552
+ provider_ref = f"plugin://{plugin_id}@{version}"
553
+ manifest = self._provider_manifests.get(provider_ref)
554
+ if manifest is None:
555
+ raise StudioError(
556
+ "AGENT_PROVIDER_NOT_REGISTERED",
557
+ "AgentProvider 尚未由当前 DSH Profile 完成预检与注册",
558
+ status_code=409,
559
+ details={"provider": provider_ref},
560
+ )
561
+ return manifest
562
+
563
+ def _read_profile(self, bundle_root: Path) -> CompositionProfile:
564
+ try:
565
+ return cast(
566
+ CompositionProfile,
567
+ CompositionProfile.model_validate_json(
568
+ (bundle_root / "composition-profile.json").read_text(
569
+ encoding="utf-8"
570
+ )
571
+ ),
572
+ )
573
+ except (OSError, UnicodeError, ValueError) as error:
574
+ raise StudioError(
575
+ "PLUGIN_BUNDLE_INVALID",
576
+ "PluginHost Bundle 缺少有效的 Composition Profile",
577
+ status_code=409,
578
+ ) from error
579
+
580
+ def _bundle_root(self, build: BuildRecord) -> Path:
581
+ if not build.artifact_path:
582
+ raise StudioError("BUILD_NOT_READY", "Build 尚未生成制品", status_code=409)
583
+ archive = cast(
584
+ Path,
585
+ self.workspace.resolve(build.artifact_path, must_exist=True),
586
+ )
587
+ bundle_root = archive.parent / "agent-bundle"
588
+ if not bundle_root.is_dir():
589
+ raise StudioError(
590
+ "PLUGIN_BUNDLE_UNAVAILABLE",
591
+ "Build 缺少可运行的 PluginHost Bundle",
592
+ status_code=409,
593
+ )
594
+ return bundle_root
595
+
596
+ @staticmethod
597
+ def _select_model(build: BuildRecord, requested: str | None) -> str:
598
+ allowed = [
599
+ str(item) for item in build.runtime_lock.get("models") or [] if str(item)
600
+ ]
601
+ default = str(build.runtime_lock.get("model") or "").strip()
602
+ if default and default not in allowed:
603
+ allowed.insert(0, default)
604
+ selected = str(requested or default).strip()
605
+ if not selected:
606
+ raise StudioError(
607
+ "AGENT_MODEL_REQUIRED", "Build 没有绑定可运行模型", status_code=422
608
+ )
609
+ if allowed and selected not in allowed:
610
+ raise StudioError(
611
+ "MODEL_NOT_BOUND",
612
+ "请求模型未绑定到当前 Agent Build",
613
+ status_code=422,
614
+ details={"model": selected, "allowedModels": allowed},
615
+ )
616
+ return selected
617
+
618
+ def _parse_plugin_ref(value: str) -> tuple[str, str]:
619
+ plugin_id, version = value.removeprefix("plugin://").rsplit("@", 1)
620
+ return plugin_id, version
621
+
622
+
623
+ def _normalize_result(raw: Any, *, session_id: str) -> StudioPluginTurnResult:
624
+ if isinstance(raw, HarnessTurnResult):
625
+ return StudioPluginTurnResult(
626
+ output_text=raw.output_text,
627
+ session_id=raw.session_id,
628
+ usage=dict(raw.usage),
629
+ metadata=dict(raw.metadata),
630
+ raw=raw,
631
+ )
632
+ if not isinstance(raw, Mapping):
633
+ raise PluginHostError(
634
+ "provider_result_invalid", "AgentProvider result must be an object"
635
+ )
636
+ output_text = str(raw.get("outputText") or raw.get("output_text") or raw.get("output") or "")
637
+ if not output_text:
638
+ raise PluginHostError(
639
+ "provider_result_invalid", "AgentProvider result must contain outputText"
640
+ )
641
+ usage = raw.get("usage") if isinstance(raw.get("usage"), Mapping) else {}
642
+ metadata = raw.get("metadata") if isinstance(raw.get("metadata"), Mapping) else {}
643
+ return StudioPluginTurnResult(
644
+ output_text=output_text,
645
+ session_id=str(raw.get("sessionId") or raw.get("session_id") or session_id),
646
+ usage=dict(usage),
647
+ metadata=dict(metadata),
648
+ raw=raw,
649
+ )
650
+
651
+
652
+ __all__ = ["StudioPluginRuntime", "StudioPluginTurnResult"]
@@ -109,7 +109,14 @@ class AgentDraftRepository:
109
109
  raise not_found("agent", agent_id)
110
110
  return self._read(path)
111
111
 
112
- def update(self, agent_id: str, spec: AgentSpec, *, expected_revision: int) -> AgentDraft:
112
+ def update(
113
+ self,
114
+ agent_id: str,
115
+ spec: AgentSpec,
116
+ *,
117
+ expected_revision: int,
118
+ name: str | None = None,
119
+ ) -> AgentDraft:
113
120
  current = self.get(agent_id)
114
121
  if current.metadata.revision != expected_revision:
115
122
  raise StudioError(
@@ -124,6 +131,8 @@ class AgentDraftRepository:
124
131
  )
125
132
  updated = cast(AgentDraft, current.model_copy(deep=True))
126
133
  updated.metadata.revision += 1
134
+ if name is not None:
135
+ updated.metadata = updated.metadata.model_copy(update={"name": name})
127
136
  updated.spec = spec
128
137
  self._write(self._agent_file(agent_id), updated)
129
138
  return updated
@@ -245,7 +254,19 @@ class BuildRepository:
245
254
  continue
246
255
  if record.agent_id == agent_id:
247
256
  records.append(record)
248
- return records
257
+ return sorted(records, key=lambda item: item.created_at, reverse=True)
258
+
259
+ def list(self) -> list[BuildRecord]:
260
+ records: list[BuildRecord] = []
261
+ directory = self.workspace.resolve(".agentkit/builds")
262
+ for path in directory.glob("build_*.json"):
263
+ try:
264
+ records.append(
265
+ BuildRecord.model_validate_json(path.read_text(encoding="utf-8"))
266
+ )
267
+ except (OSError, ValidationError):
268
+ continue
269
+ return sorted(records, key=lambda item: item.created_at, reverse=True)
249
270
 
250
271
  def delete_for_agent(
251
272
  self,