agentengine-sdk-python 0.8.4__py3-none-any.whl → 0.8.5__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 (673) hide show
  1. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/METADATA +6 -3
  2. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/RECORD +591 -365
  3. ksadk/_build_provenance.json +1 -1
  4. ksadk/_process.py +83 -0
  5. ksadk/_str_enum.py +17 -0
  6. ksadk/a2ui/core.py +3 -3
  7. ksadk/api/client.py +6 -0
  8. ksadk/builders/code_builder.py +38 -12
  9. ksadk/builders/framework_requirements.py +20 -2
  10. ksadk/cli/__init__.py +36 -0
  11. ksadk/cli/cmd_config.py +4 -4
  12. ksadk/cli/cmd_create.py +12 -12
  13. ksadk/cli/cmd_hermes.py +24 -2
  14. ksadk/cli/cmd_invoke.py +28 -5
  15. ksadk/cli/cmd_openclaw.py +26 -1
  16. ksadk/cli/cmd_plugin.py +70 -12
  17. ksadk/cli/cmd_studio.py +64 -16
  18. ksadk/cli/openclaw_env.py +1 -1
  19. ksadk/cli/resource_common.py +26 -0
  20. ksadk/codex/client.py +3 -2
  21. ksadk/configs/__init__.py +1 -1
  22. ksadk/configs/env_registry.py +125 -31
  23. ksadk/configs/env_registry_studio.py +86 -0
  24. ksadk/configs/global_config.py +1 -1
  25. ksadk/configs/settings.py +3 -3
  26. ksadk/connector/__init__.py +17 -0
  27. ksadk/connector/channel.py +477 -0
  28. ksadk/context_engine/capabilities.py +52 -4
  29. ksadk/conversations/attachment_storage.py +10 -3
  30. ksadk/conversations/attachments.py +16 -5
  31. ksadk/conversations/message_projection.py +23 -32
  32. ksadk/conversations/normalize.py +28 -10
  33. ksadk/conversations/runtime_baseline.py +37 -0
  34. ksadk/conversations/runtime_invocation.py +17 -4
  35. ksadk/conversations/runtime_observability.py +39 -10
  36. ksadk/conversations/runtime_payloads.py +8 -0
  37. ksadk/conversations/runtime_persistence.py +105 -9
  38. ksadk/conversations/runtime_preparation.py +13 -7
  39. ksadk/conversations/runtime_stream_events.py +29 -35
  40. ksadk/conversations/runtime_streaming.py +8 -0
  41. ksadk/events/adapters/_codex_items.py +16 -8
  42. ksadk/events/adapters/_langgraph_support.py +34 -0
  43. ksadk/events/session_event.py +2 -2
  44. ksadk/harness/__init__.py +14 -0
  45. ksadk/harness/app.py +11 -0
  46. ksadk/harness/artifact_store.py +213 -0
  47. ksadk/harness/capabilities.py +115 -0
  48. ksadk/harness/capability_runtime.py +237 -0
  49. ksadk/harness/closure_contract.py +92 -0
  50. ksadk/harness/compaction_record.py +122 -0
  51. ksadk/harness/compiler.py +284 -0
  52. ksadk/harness/conformance/__init__.py +33 -0
  53. ksadk/harness/conformance/contract.py +506 -0
  54. ksadk/harness/conformance/fixtures.py +102 -0
  55. ksadk/harness/context_engine.py +403 -0
  56. ksadk/harness/context_maintenance.py +259 -0
  57. ksadk/harness/context_manifest.py +188 -0
  58. ksadk/harness/context_tuning.py +168 -0
  59. ksadk/harness/draft_runtime.py +322 -0
  60. ksadk/harness/engine/__init__.py +40 -0
  61. ksadk/harness/engine/base.py +122 -0
  62. ksadk/harness/engine/budgets.py +108 -0
  63. ksadk/harness/engine/capability_declarations.py +59 -0
  64. ksadk/harness/engine/completion_guard.py +42 -0
  65. ksadk/harness/engine/context_pipeline.py +579 -0
  66. ksadk/harness/engine/graph_builder.py +859 -0
  67. ksadk/harness/engine/langgraph.py +931 -0
  68. ksadk/harness/engine/mcp_disclosure.py +750 -0
  69. ksadk/harness/engine/policy_runtime.py +70 -0
  70. ksadk/harness/engine/postgres_checkpointer.py +63 -0
  71. ksadk/harness/engine/run_control_bridge.py +80 -0
  72. ksadk/harness/engine/run_types.py +88 -0
  73. ksadk/harness/engine/skill_disclosure.py +189 -0
  74. ksadk/harness/engine/spans.py +41 -0
  75. ksadk/harness/engine/subagents.py +343 -0
  76. ksadk/harness/engine/thread_ids.py +112 -0
  77. ksadk/harness/engine/tool_dispatch.py +144 -0
  78. ksadk/harness/event_tree.py +212 -0
  79. ksadk/harness/events.py +461 -0
  80. ksadk/harness/execution_policy.py +94 -0
  81. ksadk/harness/insights.py +210 -0
  82. ksadk/harness/lifecycle.py +578 -0
  83. ksadk/harness/lifecycle_conformance.py +233 -0
  84. ksadk/harness/lifecycle_local_plane.py +104 -0
  85. ksadk/harness/loop/__init__.py +44 -0
  86. ksadk/harness/loop/reason.py +454 -0
  87. ksadk/harness/loop/tools.py +762 -0
  88. ksadk/harness/managed_runtime.py +884 -0
  89. ksadk/harness/mcp_matrix.py +474 -0
  90. ksadk/harness/mcp_runtime.py +471 -0
  91. ksadk/harness/memory_consolidation.py +157 -0
  92. ksadk/harness/memory_loop.py +156 -0
  93. ksadk/harness/memory_runtime.py +541 -0
  94. ksadk/harness/metrics.py +90 -0
  95. ksadk/harness/model_capability.py +253 -0
  96. ksadk/harness/model_provider.py +220 -0
  97. ksadk/harness/observability/__init__.py +29 -0
  98. ksadk/harness/observability/inspection.py +528 -0
  99. ksadk/harness/observability/metrics.py +167 -0
  100. ksadk/harness/observability/otel_exporter.py +218 -0
  101. ksadk/harness/prompt_cache.py +70 -0
  102. ksadk/harness/public_activity.py +154 -0
  103. ksadk/harness/readiness.py +249 -0
  104. ksadk/harness/reasoner.py +466 -13
  105. ksadk/harness/release_readiness.py +140 -0
  106. ksadk/harness/resource_ref.py +69 -0
  107. ksadk/harness/run_control.py +668 -0
  108. ksadk/harness/runtime.py +146 -111
  109. ksadk/harness/runtime_capabilities.py +158 -0
  110. ksadk/harness/runtime_server.py +514 -0
  111. ksadk/harness/sandbox_adapters.py +739 -0
  112. ksadk/harness/sandbox_backend.py +530 -0
  113. ksadk/harness/sandbox_conformance.py +288 -0
  114. ksadk/harness/sandbox_lease.py +77 -0
  115. ksadk/harness/sandbox_lease_conformance.py +259 -0
  116. ksadk/harness/sandbox_matrix.py +170 -0
  117. ksadk/harness/sandbox_reconciliation.py +140 -0
  118. ksadk/harness/sandbox_recovery.py +586 -0
  119. ksadk/harness/sandbox_recovery_conformance.py +246 -0
  120. ksadk/harness/session_store.py +243 -0
  121. ksadk/harness/skill_composition.py +212 -0
  122. ksadk/harness/skill_feedback.py +123 -0
  123. ksadk/harness/skill_matrix.py +233 -0
  124. ksadk/harness/skill_runtime.py +259 -0
  125. ksadk/harness/spec.py +332 -0
  126. ksadk/harness/state.py +153 -0
  127. ksadk/harness/strategies.py +149 -0
  128. ksadk/harness/subagent.py +253 -0
  129. ksadk/harness/tool_policy.py +131 -0
  130. ksadk/harness/tool_receipts.py +96 -0
  131. ksadk/harness/tool_reliability.py +81 -0
  132. ksadk/harness/user_errors.py +69 -0
  133. ksadk/harness/working_context.py +81 -0
  134. ksadk/harness/working_context_patch.py +99 -0
  135. ksadk/identity/resolver.py +18 -0
  136. ksadk/interaction/__init__.py +1 -1
  137. ksadk/interaction/ledger.py +1 -1
  138. ksadk/interaction/provider.py +1 -1
  139. ksadk/interaction/providers/__init__.py +3 -1
  140. ksadk/interaction/providers/adk.py +1 -1
  141. ksadk/interaction/providers/codex.py +1 -1
  142. ksadk/interaction/providers/harness.py +50 -0
  143. ksadk/interaction/providers/langgraph.py +1 -1
  144. ksadk/kernel/__init__.py +10 -0
  145. ksadk/kernel/approval_presentation.py +91 -0
  146. ksadk/kernel/authorization.py +1 -1
  147. ksadk/kernel/bootstrap.py +86 -102
  148. ksadk/kernel/contract_fingerprints.py +1 -1
  149. ksadk/kernel/contracts.py +5 -0
  150. ksadk/kernel/control.py +32 -1
  151. ksadk/kernel/execution_grants.py +221 -0
  152. ksadk/kernel/execution_grants_memory.py +133 -0
  153. ksadk/kernel/execution_grants_postgres.py +217 -0
  154. ksadk/kernel/execution_grants_sqlite.py +209 -0
  155. ksadk/kernel/ingress.py +27 -27
  156. ksadk/kernel/mapping.py +1 -1
  157. ksadk/kernel/memory_store.py +24 -11
  158. ksadk/kernel/postgres_store.py +63 -33
  159. ksadk/kernel/recovery.py +78 -14
  160. ksadk/kernel/sql/001_agent_kernel.sql +23 -0
  161. ksadk/kernel/sqlite_store.py +304 -25
  162. ksadk/kernel/state.py +2 -3
  163. ksadk/kernel/store.py +69 -2
  164. ksadk/kernel/worker.py +79 -41
  165. ksadk/kernel/worker_history.py +72 -0
  166. ksadk/kernel/worker_identity.py +47 -0
  167. ksadk/memory/coordinator.py +22 -6
  168. ksadk/memory/extraction.py +40 -1
  169. ksadk/memory/models.py +77 -1
  170. ksadk/memory/provider_resolver.py +5 -0
  171. ksadk/memory/providers/local_postgres.py +200 -0
  172. ksadk/memory/providers/local_sqlite.py +42 -3
  173. ksadk/memory/retrieval.py +189 -0
  174. ksadk/memory/store_adapter.py +150 -0
  175. ksadk/model_policy.py +2 -2
  176. ksadk/model_proxy/detect.py +254 -0
  177. ksadk/model_proxy/server.py +4 -2
  178. ksadk/model_proxy/transform.py +40 -2
  179. ksadk/plugins/__init__.py +1 -1
  180. ksadk/plugins/bridges/dsh.py +11 -0
  181. ksadk/plugins/builtins.py +40 -2
  182. ksadk/plugins/companion_artifacts.py +83 -0
  183. ksadk/plugins/companions.py +368 -0
  184. ksadk/plugins/contracts.py +1 -1
  185. ksadk/plugins/dsh_channels.py +156 -0
  186. ksadk/plugins/dsh_home.py +140 -0
  187. ksadk/plugins/dsh_teams.py +105 -0
  188. ksadk/plugins/dsh_toolchain.py +101 -19
  189. ksadk/plugins/execution_host.py +99 -0
  190. ksadk/plugins/providers/bundles/dsh-channels-client/client.js +19 -0
  191. ksadk/plugins/providers/bundles/dsh-channels-client/cordis.patch.yml +3 -0
  192. ksadk/plugins/providers/bundles/dsh-channels-client/index.mjs +7 -0
  193. ksadk/plugins/providers/bundles/dsh-channels-client/package.json +12 -0
  194. ksadk/plugins/providers/bundles/dsh-knowledge/package.json +1 -1
  195. ksadk/plugins/providers/bundles/dsh-memory/package.json +1 -1
  196. ksadk/plugins/providers/bundles/dsh-skill-center/package.json +1 -1
  197. ksadk/plugins/providers/bundles/dsh-teams-client/client.js +29 -0
  198. ksadk/plugins/providers/bundles/dsh-teams-client/cordis.patch.yml +3 -0
  199. ksadk/plugins/providers/bundles/dsh-teams-client/index.mjs +11 -0
  200. ksadk/plugins/providers/bundles/dsh-teams-client/package.json +35 -0
  201. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/cordis.patch.yml +3 -0
  202. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/index.mjs +13 -0
  203. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/package.json +27 -0
  204. ksadk/plugins/providers/bundles/dsh-teams-profile/cordis.patch.yml +3 -0
  205. ksadk/plugins/providers/bundles/dsh-teams-profile/index.mjs +12 -0
  206. ksadk/plugins/providers/bundles/dsh-teams-profile/package.json +26 -0
  207. ksadk/plugins/providers/bundles/dsh-teams-router/cordis.patch.yml +3 -0
  208. ksadk/plugins/providers/bundles/dsh-teams-router/index.mjs +16 -0
  209. ksadk/plugins/providers/bundles/dsh-teams-router/package.json +27 -0
  210. ksadk/plugins/providers/bundles/dsh-teams-tasks/cordis.patch.yml +3 -0
  211. ksadk/plugins/providers/bundles/dsh-teams-tasks/index.mjs +16 -0
  212. ksadk/plugins/providers/bundles/dsh-teams-tasks/package.json +27 -0
  213. ksadk/plugins/providers/bundles/dsh-teams-tools/cordis.patch.yml +3 -0
  214. ksadk/plugins/providers/bundles/dsh-teams-tools/index.mjs +25 -0
  215. ksadk/plugins/providers/bundles/dsh-teams-tools/package.json +29 -0
  216. ksadk/plugins/providers/bundles/dsh-teams-tools/tools.json +235 -0
  217. ksadk/plugins/providers/bundles/ksadk-codex/index.mjs +1 -1
  218. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/index.mjs +51 -1
  219. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/package.json +2 -2
  220. ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/client.mjs +133 -0
  221. ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/index.mjs +14 -0
  222. ksadk/plugins/providers/bundles/ksadk-dsh-studio/client.js +27 -4
  223. ksadk/plugins/providers/bundles/ksadk-dsh-studio/index.mjs +9 -5
  224. ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +1 -1
  225. ksadk/plugins/providers/codex.py +10 -2
  226. ksadk/plugins/providers/dsh_capabilities.py +61 -0
  227. ksadk/plugins/providers/harness.py +181 -33
  228. ksadk/plugins/providers/harness_delegation.py +593 -0
  229. ksadk/plugins/providers/harness_managed.py +456 -0
  230. ksadk/plugins/providers/harness_tools.py +326 -0
  231. ksadk/plugins/providers/shipped_dsh.py +4 -1
  232. ksadk/plugins/subagent_providers/codex.py +28 -6
  233. ksadk/plugins/teams/__init__.py +5 -0
  234. ksadk/plugins/teams/api.py +405 -0
  235. ksadk/plugins/teams/application.py +680 -0
  236. ksadk/plugins/teams/artifacts.py +60 -0
  237. ksadk/plugins/teams/context.py +96 -0
  238. ksadk/plugins/teams/contracts.py +136 -0
  239. ksadk/plugins/teams/domain.py +1427 -0
  240. ksadk/plugins/teams/domain_values.py +24 -0
  241. ksadk/plugins/teams/errors.py +13 -0
  242. ksadk/plugins/teams/migration.py +311 -0
  243. ksadk/plugins/teams/migration_cli.py +322 -0
  244. ksadk/plugins/teams/postgres_store.py +138 -0
  245. ksadk/plugins/teams/runtime.py +777 -0
  246. ksadk/plugins/teams/source_projection.py +84 -0
  247. ksadk/plugins/teams/store.py +311 -0
  248. ksadk/plugins/teams/task_decisions.py +423 -0
  249. ksadk/plugins/teams/transport.py +91 -0
  250. ksadk/plugins/teams/workspaces.py +255 -0
  251. ksadk/runners/_langgraph_runner_streams.py +121 -45
  252. ksadk/runners/_langgraph_state_reader.py +106 -0
  253. ksadk/runners/_session_identity.py +285 -0
  254. ksadk/runners/adk_runner.py +25 -60
  255. ksadk/runners/langgraph_runner.py +128 -111
  256. ksadk/runners/patch_langchain.py +47 -0
  257. ksadk/runners/usage_accumulator.py +11 -3
  258. ksadk/runtime/_runner_adapter/stream_mapping.py +52 -2
  259. ksadk/runtime/conversation_execution.py +25 -1
  260. ksadk/runtime/executor.py +9 -1
  261. ksadk/runtime/factory.py +36 -1
  262. ksadk/runtime/preprocessing.py +11 -3
  263. ksadk/runtime/runner_adapter.py +38 -9
  264. ksadk/runtime/skill_eval_result.py +36 -0
  265. ksadk/runtime/timing.py +46 -0
  266. ksadk/runtime/usage.py +49 -18
  267. ksadk/runtime_context.py +103 -1
  268. ksadk/sandbox/backends/e2b.py +245 -23
  269. ksadk/sandbox/backends/local_process.py +63 -39
  270. ksadk/sandbox/base.py +62 -1
  271. ksadk/sandbox/diagnostics.py +82 -0
  272. ksadk/sandbox/local_controls.py +746 -0
  273. ksadk/sandbox/local_launcher.py +90 -0
  274. ksadk/scheduler/dispatcher.py +1 -1
  275. ksadk/server/invocation_identity.py +118 -0
  276. ksadk/server/routes/common.py +32 -3
  277. ksadk/server/routes/control.py +64 -9
  278. ksadk/server/routes/dependencies.py +2 -1
  279. ksadk/server/routes/kernel_ingress.py +9 -1
  280. ksadk/server/routes/misc.py +233 -25
  281. ksadk/server/routes/models.py +3 -3
  282. ksadk/server/routes/openai_compat.py +76 -13
  283. ksadk/server/routes/run.py +106 -35
  284. ksadk/server/routes/sessions.py +244 -68
  285. ksadk/server/routes/workspace.py +130 -21
  286. ksadk/server/static/assets/{ArtifactsPanel-CGbWlMNh.js → ArtifactsPanel-C1YoaKhx.js} +1 -1
  287. ksadk/server/static/assets/{CodeBlock-b4C7upmO.js → CodeBlock-DHuAWfr5.js} +10 -7
  288. ksadk/server/static/assets/MathMessageMarkdown-cvdrBwYr.js +8 -0
  289. ksadk/server/static/assets/{MermaidBlock-BEBN4Ksz.js → MermaidBlock-DeBkbJvI.js} +9 -9
  290. ksadk/server/static/assets/{NativeTerminalPanel-zvL-WpAn.js → NativeTerminalPanel-oJj44_sV.js} +1 -1
  291. ksadk/server/static/assets/{abnfDiagram-VCTEODGH-BYafW7Za.js → abnfDiagram-VCTEODGH-Dhfv25o2.js} +1 -1
  292. ksadk/server/static/assets/{arc-bTohInsS.js → arc-C35w-pn1.js} +1 -1
  293. ksadk/server/static/assets/architecture-7GRP2DOG-BCsa26zi.js +1 -0
  294. ksadk/server/static/assets/{architectureDiagram-5GKGNRK7-Ch5Lbzsi.js → architectureDiagram-5GKGNRK7-FoMY_u6D.js} +1 -1
  295. ksadk/server/static/assets/{blockDiagram-NRAW4CY4-kqF4MDOG.js → blockDiagram-NRAW4CY4-zD4Rt7oE.js} +1 -1
  296. ksadk/server/static/assets/{c4Diagram-UCG6FXSJ-8uSRIODv.js → c4Diagram-UCG6FXSJ-BCtGGkhN.js} +1 -1
  297. ksadk/server/static/assets/channel-_KDifNys.js +1 -0
  298. ksadk/server/static/assets/chunk-2Q5K7J3B-HdVkJ9F0.js +1 -0
  299. ksadk/server/static/assets/{chunk-5VM5RSS4-DkhehZDr.js → chunk-5VM5RSS4-C2Ms13_k.js} +1 -1
  300. ksadk/server/static/assets/{chunk-F27PBJKO-BdXhtPe9.js → chunk-F27PBJKO-BoTj-qgx.js} +1 -1
  301. ksadk/server/static/assets/{chunk-G27WJ6UU-DPTpvpwi.js → chunk-G27WJ6UU-DOMyyjHH.js} +1 -1
  302. ksadk/server/static/assets/{chunk-JWPE2WC7-Pqoh38el.js → chunk-JWPE2WC7-DbJJqDli.js} +1 -1
  303. ksadk/server/static/assets/{chunk-LCL6LL3I-DeU00qC-.js → chunk-LCL6LL3I-CLuRCt_W.js} +1 -1
  304. ksadk/server/static/assets/{chunk-POPQ4Y6H-CzxScFkr.js → chunk-POPQ4Y6H-D0Dz847e.js} +1 -1
  305. ksadk/server/static/assets/{chunk-RHFEMEQ7-DpqMx-ux.js → chunk-RHFEMEQ7-BWSRzEcd.js} +1 -1
  306. ksadk/server/static/assets/{chunk-SVP7TREG-C6t0SypQ.js → chunk-SVP7TREG-CPoHqkCY.js} +1 -1
  307. ksadk/server/static/assets/{chunk-XXDRQBXY-DVaeafZk.js → chunk-XXDRQBXY-Bx1jS-X-.js} +1 -1
  308. ksadk/server/static/assets/classDiagram-DTDB5LWJ-BVCW3ZqZ.js +1 -0
  309. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-BVCW3ZqZ.js +1 -0
  310. ksadk/server/static/assets/{cose-bilkent-JH36ORCC-Bf9D3tzJ.js → cose-bilkent-JH36ORCC-LzyWm4m0.js} +1 -1
  311. ksadk/server/static/assets/cynefin-OW5HDTMX-CNXjFctL.js +1 -0
  312. ksadk/server/static/assets/{cynefinDiagram-5FMLGOSQ-B9cY3iTz.js → cynefinDiagram-5FMLGOSQ-BlW_bHED.js} +1 -1
  313. ksadk/server/static/assets/{dagre-3AP2YEHR-CSwlx3CB.js → dagre-3AP2YEHR-Bu_S86_i.js} +1 -1
  314. ksadk/server/static/assets/{dagre-UBpgon5q.js → dagre-B7nCawed.js} +1 -1
  315. ksadk/server/static/assets/{diagram-S7CK7UJ4-C9akhN9a.js → diagram-S7CK7UJ4-W_Zow2Km.js} +1 -1
  316. ksadk/server/static/assets/{diagram-UQ7AKVKN-CgedhTPI.js → diagram-UQ7AKVKN-CLIKAHON.js} +1 -1
  317. ksadk/server/static/assets/{diagram-VSXAHHWV-Cjucz5BY.js → diagram-VSXAHHWV-Dv6_QAlN.js} +1 -1
  318. ksadk/server/static/assets/{diagram-VX7I27RA-Dd4Vleyn.js → diagram-VX7I27RA-BWAWRDtZ.js} +1 -1
  319. ksadk/server/static/assets/{diagram-Z3DM3KII-CZ2jGtYW.js → diagram-Z3DM3KII-XA_rWMss.js} +1 -1
  320. ksadk/server/static/assets/dist-0X_j2Rcc.js +1 -0
  321. ksadk/server/static/assets/{dist-DiixqL0J.js → dist-1nXCdsej.js} +1 -1
  322. ksadk/server/static/assets/{dist-BIr4DSRq.js → dist-2vL2sAdF.js} +1 -1
  323. ksadk/server/static/assets/{dist-D_ctSS2i.js → dist-B3bA05-e.js} +1 -1
  324. ksadk/server/static/assets/{dist-ClYUxfeK.js → dist-BLpRy_Yx.js} +1 -1
  325. ksadk/server/static/assets/{dist-QfkEHOlb.js → dist-BO_UwatH.js} +1 -1
  326. ksadk/server/static/assets/{dist-B3FR1SKK.js → dist-BdNFAney.js} +1 -1
  327. ksadk/server/static/assets/{dist-BnaTiyzN.js → dist-C0J5_3qM.js} +1 -1
  328. ksadk/server/static/assets/{dist-Bj730Ib4.js → dist-CGt_UGeO.js} +1 -1
  329. ksadk/server/static/assets/{dist-CFzsn6BG.js → dist-CIRMvUM4.js} +1 -1
  330. ksadk/server/static/assets/{dist-BgV_owcB.js → dist-CIpWk_5f.js} +1 -1
  331. ksadk/server/static/assets/{dist-C5_ZAZsG.js → dist-CPyieXEf.js} +1 -1
  332. ksadk/server/static/assets/{dist-btbmmX5O.js → dist-D-92S-Fd.js} +1 -1
  333. ksadk/server/static/assets/{dist-fBO2v5Kt.js → dist-DNKuMzWc.js} +1 -1
  334. ksadk/server/static/assets/{dist-ufY3F5p6.js → dist-DWfdmz9s.js} +2 -2
  335. ksadk/server/static/assets/{dist-DVCOWtha.js → dist-DppE_r-D.js} +1 -1
  336. ksadk/server/static/assets/{dist-C1NMAY5a.js → dist-DyG6Ya-z.js} +1 -1
  337. ksadk/server/static/assets/{dist-CB9iJrvg.js → dist-M-SrdhhZ.js} +1 -1
  338. ksadk/server/static/assets/{dist-DvFK7p5S.js → dist-mqD5TZup.js} +1 -1
  339. ksadk/server/static/assets/{dist-Cf125P_m.js → dist-n3n6t_FO.js} +1 -1
  340. ksadk/server/static/assets/{dist-DFD6Qa6T.js → dist-qe8xjesy.js} +1 -1
  341. ksadk/server/static/assets/{dist-DoVSwoDb.js → dist-t6MzE0jU.js} +1 -1
  342. ksadk/server/static/assets/{ebnfDiagram-PWID7BFC-Ci8NqqZu.js → ebnfDiagram-PWID7BFC-BfCzF1Xi.js} +1 -1
  343. ksadk/server/static/assets/{erDiagram-SSCWMZ5O-CCIOhLZG.js → erDiagram-SSCWMZ5O-Dpz9_0zn.js} +1 -1
  344. ksadk/server/static/assets/eventmodeling-NTZA5JFV-B5-8RH9c.js +1 -0
  345. ksadk/server/static/assets/flowDiagram-A5DVABFB-BppFxEKw.js +1 -0
  346. ksadk/server/static/assets/{ganttDiagram-EL5Y4UJY-Cp_r9Hb6.js → ganttDiagram-EL5Y4UJY-DDaG1f4_.js} +1 -1
  347. ksadk/server/static/assets/gitGraph-4MIJSDKK-B-AhYj4C.js +1 -0
  348. ksadk/server/static/assets/{gitGraphDiagram-WWUBYQGX-Dlhc8Wr8.js → gitGraphDiagram-WWUBYQGX-DcxzRwYC.js} +1 -1
  349. ksadk/server/static/assets/index-BMd2mucF.css +2 -0
  350. ksadk/server/static/assets/index-D5qyyhTH.js +244 -0
  351. ksadk/server/static/assets/info-A6RAGUB7-0uiKrC35.js +1 -0
  352. ksadk/server/static/assets/{infoDiagram-RXCK75RN-CO0rRTRA.js → infoDiagram-RXCK75RN-CYMdn6lQ.js} +1 -1
  353. ksadk/server/static/assets/{ishikawaDiagram-5VMMS53U-CHiaedSS.js → ishikawaDiagram-5VMMS53U-CLHFAD6c.js} +1 -1
  354. ksadk/server/static/assets/{journeyDiagram-EYS64GPL-CHcCIB09.js → journeyDiagram-EYS64GPL-BHSKQGAl.js} +1 -1
  355. ksadk/server/static/assets/{kanban-definition-3QL26DDD-CJ_ebBZf.js → kanban-definition-3QL26DDD-D5W3tjTT.js} +1 -1
  356. ksadk/server/static/assets/{katex-B4weu383.js → katex-mtjOi4KM.js} +1 -1
  357. ksadk/server/static/assets/{linear-V-MgYHW1.js → linear-BETqsxE_.js} +1 -1
  358. ksadk/server/static/assets/{mermaid-parser.core-CBijEX_c.js → mermaid-parser.core-DPWrvs90.js} +2 -2
  359. ksadk/server/static/assets/{mindmap-definition-FBJOCRG2-Bc-pQvpp.js → mindmap-definition-FBJOCRG2-CJG2mfBP.js} +1 -1
  360. ksadk/server/static/assets/packet-AYTQ26CC-BVTmZ_cw.js +1 -0
  361. ksadk/server/static/assets/{pegDiagram-XKGWAZYB-D7genGLl.js → pegDiagram-XKGWAZYB-GjAPNaqn.js} +1 -1
  362. ksadk/server/static/assets/pie-WAS4IAKB-DyfxBU7V.js +1 -0
  363. ksadk/server/static/assets/{pieDiagram-E7YTZNPT-Bxj32zwD.js → pieDiagram-E7YTZNPT-ToIewrqr.js} +1 -1
  364. ksadk/server/static/assets/{quadrantDiagram-AXDQQJYC-BURv2mGh.js → quadrantDiagram-AXDQQJYC-4d78KiEY.js} +1 -1
  365. ksadk/server/static/assets/radar-RG4KPBEZ-FFontjL2.js +1 -0
  366. ksadk/server/static/assets/railroad-74A4TZTK-D0Uidzen.js +1 -0
  367. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-BOo_9T2h.js +1 -0
  368. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-D6-BjW7Z.js +1 -0
  369. ksadk/server/static/assets/railroad-peg-WCYAUIDC-CXx__yMm.js +1 -0
  370. ksadk/server/static/assets/{railroadDiagram-O6MQD6OU-CCsh3avW.js → railroadDiagram-O6MQD6OU-DKzx4xfv.js} +1 -1
  371. ksadk/server/static/assets/{requirementDiagram-EFPCY7ZU-_FRRBKEd.js → requirementDiagram-EFPCY7ZU-CJYljxQS.js} +1 -1
  372. ksadk/server/static/assets/{sankeyDiagram-P5KCCOFB-C-gr2o9M.js → sankeyDiagram-P5KCCOFB-DLU2fV1w.js} +1 -1
  373. ksadk/server/static/assets/{sequenceDiagram-WJ2MYXX4-D97NmfKg.js → sequenceDiagram-WJ2MYXX4-CVqysrA9.js} +1 -1
  374. ksadk/server/static/assets/{sizeCapture-X5ZJPWSS-DjrPC5FX.js → sizeCapture-X5ZJPWSS-BUxfmTHc.js} +1 -1
  375. ksadk/server/static/assets/{stateDiagram-HBIQ2CUA-DzMNg1hh.js → stateDiagram-HBIQ2CUA-CNFgYI9E.js} +1 -1
  376. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BXAFScz8.js +1 -0
  377. ksadk/server/static/assets/{swimlanes-XN3QIQJK-Cssf_CsU.js → swimlanes-XN3QIQJK-B6qCMe8N.js} +1 -1
  378. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uIQ2lJKH.js +8 -0
  379. ksadk/server/static/assets/{timeline-definition-24CTP7MA-BWTHzyS1.js → timeline-definition-24CTP7MA-CMD3x_U_.js} +1 -1
  380. ksadk/server/static/assets/treeView-Q6P3EWNA-CK5GgucZ.js +1 -0
  381. ksadk/server/static/assets/treemap-WGGIJYW6-Bq1u1SpG.js +1 -0
  382. ksadk/server/static/assets/{vennDiagram-4TSXK5OY-BSKgJsmR.js → vennDiagram-4TSXK5OY-BqtUqvXM.js} +1 -1
  383. ksadk/server/static/assets/wardley-WFR3VGLG-QAt06uEz.js +1 -0
  384. ksadk/server/static/assets/{wardleyDiagram-VM6X3IG4-eflHNoaZ.js → wardleyDiagram-VM6X3IG4-B5KfDjI-.js} +1 -1
  385. ksadk/server/static/assets/{xychartDiagram-S5SC5T6Z-eYqrQ-v4.js → xychartDiagram-S5SC5T6Z-BaUlSZrn.js} +1 -1
  386. ksadk/server/static/index.html +2 -2
  387. ksadk/server/terminal_sessions.py +34 -2
  388. ksadk/sessions/invocation_identity.py +235 -0
  389. ksadk/skills/__init__.py +26 -0
  390. ksadk/skills/events.py +464 -0
  391. ksadk/skills/manifest_cache.py +263 -0
  392. ksadk/skills/mcp_server/__init__.py +0 -0
  393. ksadk/skills/mcp_server/_registry.py +33 -0
  394. ksadk/skills/mcp_server/_routing.py +26 -0
  395. ksadk/skills/mcp_server/_workspace_files.py +160 -0
  396. ksadk/skills/mcp_server/register.py +415 -0
  397. ksadk/skills/mcp_server/server.py +218 -0
  398. ksadk/skills/models.py +11 -0
  399. ksadk/skills/observability.py +132 -0
  400. ksadk/skills/package_store.py +75 -2
  401. ksadk/skills/runtime/agent.py +38 -5
  402. ksadk/skills/runtime/artifacts.py +87 -0
  403. ksadk/skills/runtime/backends/e2b.py +393 -52
  404. ksadk/skills/runtime/backends/local.py +621 -119
  405. ksadk/skills/runtime/base.py +78 -7
  406. ksadk/skills/runtime/executor.py +266 -1
  407. ksadk/skills/runtime/loader.py +108 -3
  408. ksadk/skills/runtime/request.py +18 -0
  409. ksadk/skills/tool_defs.py +108 -3
  410. ksadk/studio/api.py +592 -57
  411. ksadk/studio/api_contracts.py +8 -2
  412. ksadk/studio/api_plugin_routes.py +39 -12
  413. ksadk/studio/api_resource_connections.py +79 -41
  414. ksadk/studio/authoring.py +12 -6
  415. ksadk/studio/authoring_coordinator.py +4 -2
  416. ksadk/studio/builder.py +12 -0
  417. ksadk/studio/capabilities.py +23 -6
  418. ksadk/studio/channel_connections.py +333 -0
  419. ksadk/studio/cloud.py +30 -10
  420. ksadk/studio/cloud_shared_web.py +75 -2
  421. ksadk/studio/codex_agent_service.py +2 -2
  422. ksadk/studio/codex_builder.py +1 -1
  423. ksadk/studio/codex_run.py +6 -1
  424. ksadk/studio/compiler.py +10 -0
  425. ksadk/studio/configuration.py +182 -0
  426. ksadk/studio/contracts.py +33 -5
  427. ksadk/studio/dsh_application.py +135 -25
  428. ksadk/studio/dsh_capability_service.py +287 -20
  429. ksadk/studio/dsh_lifecycle.py +58 -0
  430. ksadk/studio/dsh_provider_registration.py +55 -16
  431. ksadk/studio/entry.py +53 -0
  432. ksadk/studio/event_store.py +36 -5
  433. ksadk/studio/execution_host.py +525 -0
  434. ksadk/studio/framework_run.py +32 -10
  435. ksadk/studio/hosted_kernel.py +1 -1
  436. ksadk/studio/kernel_registry.py +418 -0
  437. ksadk/studio/kernel_sqlite_migration.py +181 -0
  438. ksadk/studio/model_client.py +1178 -64
  439. ksadk/studio/model_profile_service.py +26 -11
  440. ksadk/studio/native_documents.py +172 -0
  441. ksadk/studio/plugin_composition.py +13 -2
  442. ksadk/studio/plugin_kernel_adapter.py +15 -0
  443. ksadk/studio/plugin_lifecycle.py +80 -0
  444. ksadk/studio/plugin_runtime.py +230 -17
  445. ksadk/studio/provider_recovery.py +59 -0
  446. ksadk/studio/recovery_page.py +70 -0
  447. ksadk/studio/resource_authority.py +59 -32
  448. ksadk/studio/resource_catalog.py +6 -0
  449. ksadk/studio/run_activity.py +895 -0
  450. ksadk/studio/run_documents.py +127 -0
  451. ksadk/studio/run_service.py +329 -33
  452. ksadk/studio/runtime_catalog.py +53 -10
  453. ksadk/studio/runtime_source.py +1 -1
  454. ksadk/studio/scheduler_runtime.py +32 -289
  455. ksadk/studio/service.py +398 -103
  456. ksadk/studio/shared_web.py +149 -36
  457. ksadk/studio/static/assets/ChannelsPage-D_PGmKVq.js +8 -0
  458. ksadk/studio/static/assets/CodeBlock-DMIf4h33-UIqo-BPW.js +44 -0
  459. ksadk/studio/static/assets/ExecutionTree-v3HexvPo-Bk8wzGSy.js +1 -0
  460. ksadk/studio/static/assets/MathMessageMarkdown-BesSeCYl-OhNwH4K9.js +8 -0
  461. ksadk/studio/static/assets/MermaidBlock-H_0qzQDf-BdXtxug_.js +11 -0
  462. ksadk/studio/static/assets/MessageMarkdown-CwMTvgFj-g0I-I4dD.js +59 -0
  463. ksadk/studio/static/assets/PrismRenderer-5pK6tUdb.js +3 -0
  464. ksadk/studio/static/assets/TeamsPage-DqX4HWKQ.js +3 -0
  465. ksadk/studio/static/assets/abnfDiagram-VCTEODGH-Bnb1O3tA.js +1 -0
  466. ksadk/studio/static/assets/architecture-7GRP2DOG-BMOPAkUC.js +1 -0
  467. ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-5Zn1gqJv.js +36 -0
  468. ksadk/studio/static/assets/{blockDiagram-I7D4REHJ-CFmPl1de.js → blockDiagram-I7D4REHJ-CLB4L11u.js} +6 -6
  469. ksadk/studio/static/assets/{c4Diagram-7LVT6UL2-BRrGu8qt.js → c4Diagram-7LVT6UL2-BOma_Z_F.js} +7 -7
  470. ksadk/studio/static/assets/channel-r8itPEik.js +1 -0
  471. ksadk/studio/static/assets/chunk-2E4U76K2-BFf_huql.js +2 -0
  472. ksadk/studio/static/assets/chunk-2ZTRR5NV-C2qZJila.js +2 -0
  473. ksadk/studio/static/assets/chunk-3Z5EZCMW-DMniOlPd.js +1 -0
  474. ksadk/studio/static/assets/{chunk-4HAMMTFA-D220vUtq.js → chunk-4HAMMTFA-DVtDP4rm.js} +7 -7
  475. ksadk/studio/static/assets/chunk-5V3GS4D5-i-ZDOEnP.js +1 -0
  476. ksadk/studio/static/assets/chunk-6AZGARVD-BB6FqMl-.js +1 -0
  477. ksadk/studio/static/assets/chunk-6EIED4P4-DdUJkP0f.js +1 -0
  478. ksadk/studio/static/assets/chunk-6K3QC6MW-CqVsVn-y.js +1 -0
  479. ksadk/studio/static/assets/chunk-6TQVIW2G-DKlLbNIP.js +1 -0
  480. ksadk/studio/static/assets/chunk-747NJXEK-BFkZPlab.js +2 -0
  481. ksadk/studio/static/assets/chunk-75Z2AOVW-BZNhM4vB.js +2 -0
  482. ksadk/studio/static/assets/chunk-CLGD4ZFX-D-GTtyKs.js +1 -0
  483. ksadk/studio/static/assets/{chunk-DU6HZSFF-C4DtVpCu.js → chunk-DU6HZSFF-CpEZCUgg.js} +1 -1
  484. ksadk/studio/static/assets/chunk-F27PBJKO-D7pvKf0C.js +1 -0
  485. ksadk/studio/static/assets/{chunk-GMAD6QVW-DiQA-u2N.js → chunk-GMAD6QVW-DE_8H717.js} +6 -6
  486. ksadk/studio/static/assets/chunk-GVQU2GXP-BfEB0lNv.js +1 -0
  487. ksadk/studio/static/assets/chunk-I5DQTOEV-Hm2LfiYI.js +1 -0
  488. ksadk/studio/static/assets/chunk-ICYGCRZG-749o-pGJ.js +1 -0
  489. ksadk/studio/static/assets/chunk-IH6LHLGP-CC6I9F3i.js +1 -0
  490. ksadk/studio/static/assets/{chunk-IMKFNOWR-BSlbjT_b.js → chunk-IMKFNOWR-D38axYOR.js} +5 -5
  491. ksadk/studio/static/assets/chunk-KI3K4JFJ-Rma-0k_M.js +1 -0
  492. ksadk/studio/static/assets/chunk-L3NEJ4N5-Dq5xn7aL.js +1 -0
  493. ksadk/studio/static/assets/chunk-LNGE3PJU-DWpGwHrW.js +34 -0
  494. ksadk/studio/static/assets/{chunk-OSK3NFVY-M2m6G3j4.js → chunk-OSK3NFVY-DiCQjx9b.js} +5 -5
  495. ksadk/studio/static/assets/chunk-OUJLGHUK-D0j2JRSg.js +2 -0
  496. ksadk/studio/static/assets/{chunk-P2QGCYS3-DezaQxiK.js → chunk-P2QGCYS3-VdhKmfYq.js} +1 -1
  497. ksadk/studio/static/assets/chunk-POPQ4Y6H-C1_rzO5M.js +1 -0
  498. ksadk/studio/static/assets/chunk-PWAF6VOD-B45HvflI.js +1 -0
  499. ksadk/studio/static/assets/{chunk-SHT3W25Y-DAyIVp5H.js → chunk-SHT3W25Y-DsCFnRVE.js} +9 -9
  500. ksadk/studio/static/assets/{chunk-SVP7TREG-DulomOrS.js → chunk-SVP7TREG-DljApgRX.js} +1 -1
  501. ksadk/studio/static/assets/{chunk-TICWLB2K-bHJYoflj.js → chunk-TICWLB2K-DWqRtyqa.js} +6 -6
  502. ksadk/studio/static/assets/chunk-TLUHSLCS-DUeGgnD5.js +2 -0
  503. ksadk/studio/static/assets/chunk-UY3FDG6J-CnmaAkG5.js +1 -0
  504. ksadk/studio/static/assets/chunk-XHIXRSVI-BFQ6B8BE.js +1 -0
  505. ksadk/studio/static/assets/chunk-XXDRQBXY-DqAYeljN.js +1 -0
  506. ksadk/studio/static/assets/classDiagram-ZZMXUADV-DjeMNJmu.js +1 -0
  507. ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-DjeMNJmu.js +1 -0
  508. ksadk/studio/static/assets/clsx-DB0hHKMi.js +1 -0
  509. ksadk/studio/static/assets/cose-bilkent-JH36ORCC-om8AY0Mc.js +1 -0
  510. ksadk/studio/static/assets/createLucideIcon-DR0LGTP5.js +1 -0
  511. ksadk/studio/static/assets/cynefin-OW5HDTMX-7tP7QfM3.js +1 -0
  512. ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-6BrmK52S.js +62 -0
  513. ksadk/studio/static/assets/dagre-GXQ25YYZ-buZBRlwz.js +4 -0
  514. ksadk/studio/static/assets/{diagram-S7CK7UJ4-0BZ98mya.js → diagram-S7CK7UJ4-C6aH78c4.js} +3 -3
  515. ksadk/studio/static/assets/diagram-UQ7AKVKN-DY_tQ6C_.js +41 -0
  516. ksadk/studio/static/assets/diagram-VSXAHHWV-DX9p5cQT.js +3 -0
  517. ksadk/studio/static/assets/diagram-VX7I27RA-DB2WSH8X.js +24 -0
  518. ksadk/studio/static/assets/diagram-Z3DM3KII-Ce1BJwHE.js +24 -0
  519. ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-Daukxwqf.js +1 -0
  520. ksadk/studio/static/assets/{erDiagram-RLTQ6QDP-DLGry2Ap.js → erDiagram-RLTQ6QDP-CGthTMmJ.js} +6 -6
  521. ksadk/studio/static/assets/eventmodeling-NTZA5JFV-BR2FzK4R.js +1 -0
  522. ksadk/studio/static/assets/flowDiagram-HODETNUW-CZ1tEenp.js +1 -0
  523. ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BfoAZW9X.js +292 -0
  524. ksadk/studio/static/assets/gitGraph-4MIJSDKK-DYlXv_yJ.js +1 -0
  525. ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-S985OIJF.js +106 -0
  526. ksadk/studio/static/assets/iconfont-4HN3C9Pg.woff2 +0 -0
  527. ksadk/studio/static/assets/index-CfEnms6Y.css +2 -0
  528. ksadk/studio/static/assets/index-Dp61rOWZ.js +0 -0
  529. ksadk/studio/static/assets/index.dom-BQenBtFm.js +1 -0
  530. ksadk/studio/static/assets/info-A6RAGUB7-BlU-8_xu.js +1 -0
  531. ksadk/studio/static/assets/infoDiagram-27XIBGKW-CO3W8tFn.js +2 -0
  532. ksadk/studio/static/assets/{ishikawaDiagram-5VMMS53U-CljI2wyf.js → ishikawaDiagram-5VMMS53U-BUGEl8cO.js} +2 -2
  533. ksadk/studio/static/assets/{journeyDiagram-3NMN7TZE-D50Fo2sL.js → journeyDiagram-3NMN7TZE-Ch2ZYxvr.js} +6 -6
  534. ksadk/studio/static/assets/{kanban-definition-UXKFOSKX-DimfOTam.js → kanban-definition-UXKFOSKX-Da-Fp4vC.js} +3 -3
  535. ksadk/studio/static/assets/kingsoft-cloud-BOcLiQ3e.ico +0 -0
  536. ksadk/studio/static/assets/{line-CX5BOOUP.js → line-BDaeq300.js} +1 -1
  537. ksadk/studio/static/assets/linear-DmucvK78.js +1 -0
  538. ksadk/studio/static/assets/mermaid-parser.core-Cj5mYdBi.js +4 -0
  539. ksadk/studio/static/assets/{mindmap-definition-YA3MSWOX-Bizzqy5R.js → mindmap-definition-YA3MSWOX-CvlsVQ38.js} +1 -1
  540. ksadk/studio/static/assets/packet-AYTQ26CC-BSJEH9Lb.js +1 -0
  541. ksadk/studio/static/assets/pegDiagram-XKGWAZYB-BuHuNgT5.js +1 -0
  542. ksadk/studio/static/assets/pie-WAS4IAKB-qxv01Y8W.js +1 -0
  543. ksadk/studio/static/assets/{pieDiagram-E7YTZNPT-B9mrFSDF.js → pieDiagram-E7YTZNPT-DlrWiSOv.js} +1 -1
  544. ksadk/studio/static/assets/preload-helper-CO68xz6u.js +1 -0
  545. ksadk/studio/static/assets/presentation-yYw7xK60-BmcZriri.js +1 -0
  546. ksadk/studio/static/assets/{quadrantDiagram-AXDQQJYC-NzUfCbMR.js → quadrantDiagram-AXDQQJYC-BA3hpUZM.js} +6 -6
  547. ksadk/studio/static/assets/radar-RG4KPBEZ-B6h6pWOs.js +1 -0
  548. ksadk/studio/static/assets/railroad-74A4TZTK-CGtTWdGc.js +1 -0
  549. ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-Cq7y22IA.js +1 -0
  550. ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-V0aQVv9m.js +1 -0
  551. ksadk/studio/static/assets/railroad-peg-WCYAUIDC-BQiIsX_p.js +1 -0
  552. ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-BxpAazym.js +1 -0
  553. ksadk/studio/static/assets/{requirementDiagram-BXWQKSXE-BF3d103U.js → requirementDiagram-BXWQKSXE-E-Ge0FcV.js} +1 -1
  554. ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-CA6YKhQ3.js +40 -0
  555. ksadk/studio/static/assets/{sequenceDiagram-WJ2MYXX4-Dh4wZtUm.js → sequenceDiagram-WJ2MYXX4-CcElXGg4.js} +9 -9
  556. ksadk/studio/static/assets/src-B6xuSHsQ.js +1 -0
  557. ksadk/studio/static/assets/stateDiagram-D77RDMKH-DdXZOFqY.js +1 -0
  558. ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-CJbOM-QK.js +1 -0
  559. ksadk/studio/static/assets/swimlanes-42K2YHIH-NtgEEHLY.js +1 -0
  560. ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-D-AVlW8B.js +8 -0
  561. ksadk/studio/static/assets/{timeline-definition-24CTP7MA-DxmSSjRB.js → timeline-definition-24CTP7MA-CIuYhNy3.js} +7 -7
  562. ksadk/studio/static/assets/treeView-Q6P3EWNA-BTTYcvrF.js +1 -0
  563. ksadk/studio/static/assets/treemap-WGGIJYW6-Cg7tyfH8.js +1 -0
  564. ksadk/studio/static/assets/vennDiagram-4TSXK5OY-7HbApbrv.js +34 -0
  565. ksadk/studio/static/assets/wardley-WFR3VGLG-C6N1rULY.js +1 -0
  566. ksadk/studio/static/assets/{wardleyDiagram-VM6X3IG4-Ba1AOWoe.js → wardleyDiagram-VM6X3IG4-CMJiaedy.js} +1 -1
  567. ksadk/studio/static/assets/{xychartDiagram-S5SC5T6Z-Cr5pt5Y-.js → xychartDiagram-S5SC5T6Z-BdgtMvW2.js} +6 -6
  568. ksadk/studio/static/index.html +8 -2
  569. ksadk/studio/teams_catalog.py +133 -0
  570. ksadk/studio/teams_installation.py +214 -0
  571. ksadk/studio/teams_node.py +545 -0
  572. ksadk/studio/teams_node_runner.py +69 -0
  573. ksadk/studio/teams_remote.py +274 -0
  574. ksadk/studio/templates.py +40 -19
  575. ksadk/studio/validator.py +13 -0
  576. ksadk/studio/workspace.py +19 -4
  577. ksadk/studio/workspace_plugins.py +136 -0
  578. ksadk/studio/workspace_registry.py +286 -0
  579. ksadk/toolsets/__init__.py +11 -0
  580. ksadk/toolsets/skills.py +446 -378
  581. ksadk/toolsets/workspace.py +3 -3
  582. ksadk/toolsets/workspace_identity.py +15 -0
  583. ksadk/version.py +1 -1
  584. ksadk_runtime_common/memory_backend/providers/lancedb.py +56 -2
  585. ksadk_runtime_common/schemas/memory_backend_manifest.schema.json +148 -148
  586. ksadk_runtime_common/workspace_files/router.py +26 -13
  587. ksadk/server/static/assets/MathMessageMarkdown-DbdW5A4_.js +0 -8
  588. ksadk/server/static/assets/architecture-7GRP2DOG-BW5UtSnx.js +0 -1
  589. ksadk/server/static/assets/channel-CF5Up3hQ.js +0 -1
  590. ksadk/server/static/assets/chunk-2Q5K7J3B-KkXX47WI.js +0 -1
  591. ksadk/server/static/assets/classDiagram-DTDB5LWJ-Cz81acRQ.js +0 -1
  592. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Cz81acRQ.js +0 -1
  593. ksadk/server/static/assets/cynefin-OW5HDTMX-DVWs8a2t.js +0 -1
  594. ksadk/server/static/assets/dist-B2_CVgKv.js +0 -1
  595. ksadk/server/static/assets/eventmodeling-NTZA5JFV-CQqR2hg3.js +0 -1
  596. ksadk/server/static/assets/flowDiagram-A5DVABFB-DDRRbGPm.js +0 -1
  597. ksadk/server/static/assets/gitGraph-4MIJSDKK-fgWEf7UD.js +0 -1
  598. ksadk/server/static/assets/index-DcTML1Up.css +0 -2
  599. ksadk/server/static/assets/index-Dh2XHqPK.js +0 -244
  600. ksadk/server/static/assets/info-A6RAGUB7-BUecLTdt.js +0 -1
  601. ksadk/server/static/assets/packet-AYTQ26CC-BeW-btFv.js +0 -1
  602. ksadk/server/static/assets/pie-WAS4IAKB-X0xh4SaT.js +0 -1
  603. ksadk/server/static/assets/radar-RG4KPBEZ-DzRMSqjd.js +0 -1
  604. ksadk/server/static/assets/railroad-74A4TZTK-Cc44icX-.js +0 -1
  605. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-D6S4BdV-.js +0 -1
  606. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-vD3aVE2o.js +0 -1
  607. ksadk/server/static/assets/railroad-peg-WCYAUIDC-CYbW_b4T.js +0 -1
  608. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BIcjKFhF.js +0 -1
  609. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-tq3K3Ybl.js +0 -8
  610. ksadk/server/static/assets/treeView-Q6P3EWNA-DBXt3GdU.js +0 -1
  611. ksadk/server/static/assets/treemap-WGGIJYW6-DrCy4E_l.js +0 -1
  612. ksadk/server/static/assets/wardley-WFR3VGLG-CefhOliM.js +0 -1
  613. ksadk/studio/static/assets/CodeBlock-DCUUY0PL-BLjA7kbS.js +0 -41
  614. ksadk/studio/static/assets/MathMessageMarkdown-CBcDrAw--CUYIXwgI.js +0 -8
  615. ksadk/studio/static/assets/MermaidBlock-DBFTztfQ-BTYKWEbD.js +0 -44
  616. ksadk/studio/static/assets/PrismRenderer-wiXRHURw.js +0 -3
  617. ksadk/studio/static/assets/abnfDiagram-VCTEODGH-CLETGjKq.js +0 -1
  618. ksadk/studio/static/assets/architecture-7GRP2DOG-hXMiO_AU.js +0 -1
  619. ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-B5EQysk6.js +0 -36
  620. ksadk/studio/static/assets/channel-BqO-gtEw.js +0 -1
  621. ksadk/studio/static/assets/chunk-75Z2AOVW-C8lLv_qc.js +0 -2
  622. ksadk/studio/static/assets/chunk-F27PBJKO-Cpw14SNG.js +0 -1
  623. ksadk/studio/static/assets/chunk-GVQU2GXP-DUdNBUCi.js +0 -1
  624. ksadk/studio/static/assets/chunk-L3NEJ4N5-Db8Ab22W.js +0 -1
  625. ksadk/studio/static/assets/chunk-POPQ4Y6H-DOpufJ3t.js +0 -1
  626. ksadk/studio/static/assets/chunk-PWAF6VOD-CfLb1gSc.js +0 -1
  627. ksadk/studio/static/assets/chunk-XXDRQBXY-7PcdR2B1.js +0 -1
  628. ksadk/studio/static/assets/classDiagram-ZZMXUADV-D_bW8JjA.js +0 -1
  629. ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-D_bW8JjA.js +0 -1
  630. ksadk/studio/static/assets/cose-bilkent-JH36ORCC-snL88wkX.js +0 -1
  631. ksadk/studio/static/assets/cynefin-OW5HDTMX-Bd1YhRo1.js +0 -1
  632. ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-BBrIG_mI.js +0 -62
  633. ksadk/studio/static/assets/dagre-GXQ25YYZ-DtF1nGdY.js +0 -4
  634. ksadk/studio/static/assets/diagram-UQ7AKVKN-6mLKEo6L.js +0 -41
  635. ksadk/studio/static/assets/diagram-VSXAHHWV-CJBIaiZ2.js +0 -3
  636. ksadk/studio/static/assets/diagram-VX7I27RA-BohLEE1C.js +0 -24
  637. ksadk/studio/static/assets/diagram-Z3DM3KII-D8KIGonG.js +0 -24
  638. ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-C99HU61t.js +0 -1
  639. ksadk/studio/static/assets/eventmodeling-NTZA5JFV-B1_5Ac8j.js +0 -1
  640. ksadk/studio/static/assets/flowDiagram-HODETNUW-DD5hmicn.js +0 -1
  641. ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BPJrVLSG.js +0 -292
  642. ksadk/studio/static/assets/gitGraph-4MIJSDKK-Cy_ZQBGi.js +0 -1
  643. ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-CZCUz4MT.js +0 -106
  644. ksadk/studio/static/assets/index-CeHL9ARV.css +0 -2
  645. ksadk/studio/static/assets/index-D9QEcVpL.js +0 -320
  646. ksadk/studio/static/assets/info-A6RAGUB7-DBzDQB_I.js +0 -1
  647. ksadk/studio/static/assets/infoDiagram-27XIBGKW-B-sq07Hi.js +0 -2
  648. ksadk/studio/static/assets/linear-BCxN9JLv.js +0 -1
  649. ksadk/studio/static/assets/mermaid-parser.core-BdCz8fkS.js +0 -7
  650. ksadk/studio/static/assets/packet-AYTQ26CC-gPln-_kG.js +0 -1
  651. ksadk/studio/static/assets/pegDiagram-XKGWAZYB-Dy3fB-gW.js +0 -1
  652. ksadk/studio/static/assets/pie-WAS4IAKB-qZdHMr7B.js +0 -1
  653. ksadk/studio/static/assets/radar-RG4KPBEZ-BZlnaea9.js +0 -1
  654. ksadk/studio/static/assets/railroad-74A4TZTK-Ce3__H9c.js +0 -1
  655. ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-DqQn7EzD.js +0 -1
  656. ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-B55kCA8F.js +0 -1
  657. ksadk/studio/static/assets/railroad-peg-WCYAUIDC-DfQnvkHd.js +0 -1
  658. ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-DnhMjZCk.js +0 -1
  659. ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-Bo-JTwt0.js +0 -40
  660. ksadk/studio/static/assets/src-SFn9St9H.js +0 -1
  661. ksadk/studio/static/assets/stateDiagram-D77RDMKH-DH774G6d.js +0 -1
  662. ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-DZvVWPBo.js +0 -1
  663. ksadk/studio/static/assets/swimlanes-42K2YHIH-Bl13OvTX.js +0 -1
  664. ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-BnFOTALJ.js +0 -8
  665. ksadk/studio/static/assets/treeView-Q6P3EWNA-D5Nn9Swz.js +0 -1
  666. ksadk/studio/static/assets/treemap-WGGIJYW6-CgHgnQhE.js +0 -1
  667. ksadk/studio/static/assets/vennDiagram-4TSXK5OY-B9QEXcJq.js +0 -34
  668. ksadk/studio/static/assets/wardley-WFR3VGLG-DXrK2RRY.js +0 -1
  669. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/WHEEL +0 -0
  670. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/entry_points.txt +0 -0
  671. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/licenses/LICENSE +0 -0
  672. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/top_level.txt +0 -0
  673. /ksadk/studio/static/assets/{MathMessageMarkdown-CBcDrAw--BEOyPC3w.css → MathMessageMarkdown-BesSeCYl-BEOyPC3w.css} +0 -0
@@ -14,8 +14,9 @@ import json
14
14
  import os
15
15
  import re
16
16
  import secrets
17
+ import threading
17
18
  from collections.abc import Callable, Coroutine, Mapping, Sequence
18
- from dataclasses import dataclass
19
+ from dataclasses import dataclass, replace
19
20
  from dataclasses import field as dataclass_field
20
21
  from pathlib import Path
21
22
  from typing import Any, Literal, cast
@@ -28,6 +29,18 @@ from ksadk.plugins.bridges.dsh import (
28
29
  DshProfilePluginBridge,
29
30
  DshProfileProjection,
30
31
  )
32
+ from ksadk.plugins.companion_artifacts import DshCompanionArtifact, companion_artifact
33
+ from ksadk.plugins.companions import (
34
+ CompanionError,
35
+ DshCompanionDefinition,
36
+ DshPluginCompanionManager,
37
+ )
38
+ from ksadk.plugins.dsh_home import (
39
+ DshHomeVersionError,
40
+ default_studio_dsh_home,
41
+ prepare_studio_dsh_home,
42
+ studio_dsh_home,
43
+ )
31
44
  from ksadk.plugins.dsh_toolchain import DshToolchainManager
32
45
  from ksadk.plugins.host import PluginHostError
33
46
  from ksadk.plugins.providers.dsh_capabilities import (
@@ -49,6 +62,7 @@ from ksadk.resource_runtime.supervisor import (
49
62
  )
50
63
  from ksadk.resource_runtime.worker import WorkerInitialization
51
64
  from ksadk.studio.errors import StudioError
65
+ from ksadk.studio.dsh_lifecycle import DshStartupLifecycle
52
66
 
53
67
  _CALL_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$")
54
68
  _TOOL_NAME = re.compile(r"^[A-Za-z0-9_.:-]{1,128}$")
@@ -116,7 +130,7 @@ def _reject_non_finite(value: str) -> None:
116
130
  raise ValueError(f"non-finite JSON number: {value}")
117
131
 
118
132
 
119
- class StudioDshCapabilityService:
133
+ class StudioDshCapabilityService(DshStartupLifecycle):
120
134
  """Lazy, generation-fenced access to a DSH Profile's real MCP lease."""
121
135
 
122
136
  def __init__(
@@ -166,16 +180,101 @@ class StudioDshCapabilityService:
166
180
  self._active_calls: dict[str, _ActiveCall] = {}
167
181
  self._closed = False
168
182
  self.model_projection = None
183
+ self._companion_definitions: tuple[DshCompanionDefinition, ...] = ()
184
+ self._companion_manager: DshPluginCompanionManager | None = None
185
+ self._startup_stage = "not_started"
186
+ self._startup_failure: dict[str, Any] | None = None
187
+ # Cached result of ``has_enabled_profile_plugins`` keyed by the managed
188
+ # state file mtime (``None`` when the file is absent), so repeated page
189
+ # loads never re-run the Node bridge probe.
190
+ self._plugins_probe_cache: tuple[float | None, bool] | None = None
191
+ self._probe_warmup_tasks: set[asyncio.Task[None]] = set()
192
+ self._probe_inflight: asyncio.Task[bool] | None = None
193
+ self._resolved_command: tuple[str, ...] | None = None
194
+ self._resolve_lock = threading.Lock()
195
+
196
+ def schedule_plugin_probe_warmup(self) -> None:
197
+ """Warm the enabled-plugin probe once, off the request path.
198
+
199
+ Fire and forget: failures are swallowed because the entry point has
200
+ its own bounded fallback, and tasks are tracked so shutdown can
201
+ cancel them.
202
+ """
203
+
204
+ async def _warm() -> None:
205
+ try:
206
+ await self.has_enabled_profile_plugins()
207
+ except asyncio.CancelledError:
208
+ raise
209
+ except Exception:
210
+ return
211
+
212
+ task = asyncio.create_task(_warm())
213
+ self._probe_warmup_tasks.add(task)
214
+ task.add_done_callback(self._probe_warmup_tasks.discard)
215
+
216
+ def configure_companions(self, definitions: Sequence[DshCompanionDefinition]) -> None:
217
+ """Configure trusted lifecycle callbacks before this Profile starts."""
218
+ if self._host is not None or self._closed:
219
+ raise CompanionError("COMPANION_CONFIGURATION_BUSY")
220
+ if any(item.profile != self._profile for item in definitions):
221
+ raise CompanionError("COMPANION_PROFILE_MISMATCH")
222
+ self._companion_definitions = tuple(definitions)
223
+
224
+ @property
225
+ def companion_manager(self) -> DshPluginCompanionManager | None:
226
+ return self._companion_manager
227
+
228
+ async def call_companion_tool(
229
+ self, plugin_id: str, principal: Any, operation: str, arguments: Mapping[str, Any],
230
+ *, call_id: str, deadline_ms: int = 60_000,
231
+ ) -> dict[str, Any]:
232
+ """Run an actual Cordis tool with a host-issued opaque invocation scope."""
233
+ if not re.fullmatch(r"[A-Za-z0-9_.:-]{1,128}", call_id) or not 1 <= deadline_ms <= 120_000:
234
+ raise CompanionError("COMPANION_REQUEST_INVALID")
235
+ if _strict_json_size(arguments) > self._max_argument_bytes:
236
+ raise CompanionError("COMPANION_REQUEST_INVALID")
237
+ async with self._lock:
238
+ host, lease = await self._ensure_ready_locked()
239
+ manager = self._companion_manager
240
+ if manager is None or operation not in {tool.name for tool in host.descriptor.tools}:
241
+ raise CompanionError("COMPANION_UNAVAILABLE")
242
+ handle = manager.issue_invocation(
243
+ plugin_id, principal, operations=frozenset({operation}),
244
+ ttl_seconds=deadline_ms / 1000,
245
+ )
246
+ token = lease.companion_bearer_token(
247
+ plugin_id=plugin_id, generation_id=manager.generation_id,
248
+ handle=handle, tool_name=operation, call_id=call_id,
249
+ ttl_seconds=max(1, (deadline_ms + 999) // 1000),
250
+ )
251
+ scoped = replace(lease, _bearer_token=token, _browser_token="")
252
+ try:
253
+ result = await self._mcp_request(
254
+ scoped, request_id=call_id, method="tools/call",
255
+ params={"name": operation, "arguments": dict(arguments)},
256
+ timeout_seconds=deadline_ms / 1000,
257
+ )
258
+ if result.get("isError"):
259
+ code = result.get("_meta", {}).get("io.ksadk/dsh", {}).get("code", "")
260
+ raise CompanionError(code if isinstance(code, str) and re.fullmatch(
261
+ r"COMPANION_[A-Z_]{1,96}", code
262
+ ) else "COMPANION_TOOL_FAILED")
263
+ value = result.get("structuredContent")
264
+ if not isinstance(value, dict):
265
+ raise CompanionError("COMPANION_RESPONSE_INVALID")
266
+ return value
267
+ except (asyncio.TimeoutError, StudioError) as error:
268
+ # Preserve the caller's native call_id. A retry must reuse it so
269
+ # the domain can look up an already committed result.
270
+ raise CompanionError("COMPANION_OUTCOME_UNCERTAIN") from error
271
+ finally:
272
+ manager.revoke_invocation(handle)
169
273
 
170
274
  @classmethod
171
275
  def discover_or_create_workspace_default(cls, workspace: Path) -> "StudioDshCapabilityService":
172
276
  root = workspace.resolve()
173
- configured_home = os.environ.get("KSADK_DSH_HOME", "").strip()
174
- dsh_home = (
175
- Path(configured_home).expanduser()
176
- if configured_home
177
- else root / ".agentkit" / "dsh-home"
178
- )
277
+ dsh_home = studio_dsh_home(root)
179
278
  profile = os.environ.get("KSADK_DSH_PROFILE", "").strip() or "web"
180
279
  configured_bin = os.environ.get("KSADK_DSH_BIN", "").strip()
181
280
  command = (str(Path(configured_bin).expanduser()),) if configured_bin else None
@@ -195,7 +294,7 @@ class StudioDshCapabilityService:
195
294
  command = (str(Path(configured_bin).expanduser()),) if configured_bin else None
196
295
  return cls(
197
296
  root,
198
- dsh_home=root / ".agentkit" / "dsh-home",
297
+ dsh_home=default_studio_dsh_home(root),
199
298
  profile="agentkit-resources",
200
299
  dsh_command=command,
201
300
  mount_studio_app=False,
@@ -225,8 +324,69 @@ class StudioDshCapabilityService:
225
324
  "DSH capability service 已关闭",
226
325
  status_code=503,
227
326
  )
327
+ # This check is used by the HTTP entry point only to choose the
328
+ # initial document. Starting a Node/DSH bridge here made every
329
+ # fresh page and workspace switch wait several seconds. The
330
+ # managed state file is the same source consumed by
331
+ # ``DshProfilePluginBridge.list_plugins``; read it directly and
332
+ # fall back to the validated bridge only for legacy/incomplete
333
+ # profiles. The result is cached against the state file mtime so
334
+ # legacy profiles do not pay a cold Node bridge on every page.
335
+ state_mtime = self._profile_state_mtime()
336
+ cached = self._plugins_probe_cache
337
+ if cached is not None and cached[0] == state_mtime:
338
+ return cached[1]
339
+ fast = self._profile_has_enabled_plugins_from_state()
340
+ if fast is not None:
341
+ self._plugins_probe_cache = (state_mtime, fast)
342
+ return fast
343
+ if self._probe_inflight is None:
344
+ self._probe_inflight = asyncio.create_task(
345
+ self._run_bridge_probe(state_mtime)
346
+ )
347
+ inflight = self._probe_inflight
348
+ # The slow Node bridge probe must run WITHOUT ``self._lock`` held:
349
+ # every DSH-dependent request (session creation, /studio-core/ lease)
350
+ # queues on that lock, so pinning it for the whole cold probe turned
351
+ # warmup into a service-wide stall. ``shield`` keeps the shared
352
+ # probe alive when a bounded caller (index timeout) gives up.
353
+ return await asyncio.shield(inflight)
354
+
355
+ async def _run_bridge_probe(self, state_mtime: float | None) -> bool:
356
+ result: bool | None = None
357
+ try:
228
358
  command = await asyncio.to_thread(self._resolve_command)
229
- return await asyncio.to_thread(self._profile_has_enabled_plugins, command)
359
+ result = await asyncio.to_thread(self._profile_has_enabled_plugins, command)
360
+ finally:
361
+ async with self._lock:
362
+ self._probe_inflight = None
363
+ if result is not None and not self._closed:
364
+ self._plugins_probe_cache = (self._profile_state_mtime(), result)
365
+ return result
366
+
367
+ def _profile_state_mtime(self) -> float | None:
368
+ """Return the managed plugin state file mtime, or ``None`` if absent."""
369
+
370
+ try:
371
+ return self._profile_state_path().stat().st_mtime
372
+ except OSError:
373
+ return None
374
+
375
+ def _profile_state_path(self) -> Path:
376
+ return self._dsh_home / "profiles" / self._profile / ".ksadk-dsh-plugins.json"
377
+
378
+ def _profile_has_enabled_plugins_from_state(self) -> bool | None:
379
+ """Return enabled state without invoking npm/Node, or ``None`` if unavailable."""
380
+
381
+ try:
382
+ state = json.loads(self._profile_state_path().read_text(encoding="utf-8"))
383
+ order = state.get("order")
384
+ disabled = set(state.get("disabled") or ())
385
+ if not isinstance(order, list) or not all(isinstance(item, str) for item in order):
386
+ return None
387
+ return any(item not in disabled for item in order)
388
+ except (OSError, UnicodeError, ValueError, TypeError, AttributeError):
389
+ return None
230
390
 
231
391
  def capture_resource_build_snapshot(self) -> DshProfileBuildSnapshot:
232
392
  """Capture immutable Profile inputs for a caller-owned Build staging area.
@@ -517,6 +677,17 @@ class StudioDshCapabilityService:
517
677
  await self._dispose_generation_locked()
518
678
 
519
679
  async def aclose(self) -> None:
680
+ # Cancel tracked warmup probes first; a slow Node bridge probe must
681
+ # not delay shutdown. The shared in-flight probe is shielded from
682
+ # its awaiters, so cancel it explicitly here.
683
+ for task in tuple(self._probe_warmup_tasks):
684
+ task.cancel()
685
+ if self._probe_warmup_tasks:
686
+ await asyncio.gather(*self._probe_warmup_tasks, return_exceptions=True)
687
+ inflight = self._probe_inflight
688
+ if inflight is not None:
689
+ inflight.cancel()
690
+ await asyncio.gather(inflight, return_exceptions=True)
520
691
  async with self._lock:
521
692
  if self._closed:
522
693
  return
@@ -529,7 +700,7 @@ class StudioDshCapabilityService:
529
700
  async with self._lock:
530
701
  return await self._ensure_ready_locked()
531
702
 
532
- async def _ensure_ready_locked(
703
+ async def _ensure_ready_generation_locked(
533
704
  self,
534
705
  ) -> tuple[DshProfileCapabilityHost, DshMcpConnectorLease]:
535
706
  if self._closed:
@@ -554,8 +725,11 @@ class StudioDshCapabilityService:
554
725
  return await self._start_host_locked(host, projection)
555
726
 
556
727
  try:
728
+ self._startup_stage = "toolchain"
557
729
  command = await asyncio.to_thread(self._resolve_command)
730
+ self._startup_stage = "profile_projection"
558
731
  projection = await asyncio.to_thread(self._project_profile, command)
732
+ self._startup_stage = "host_configuration"
559
733
  host = self._host_factory(
560
734
  command,
561
735
  projection=projection,
@@ -591,10 +765,39 @@ class StudioDshCapabilityService:
591
765
  # A restarted Core must never inherit workers or resource handles from
592
766
  # the previous generation, including when the restart subsequently fails.
593
767
  self._resource_generation_snapshot = None
768
+ self._startup_stage = "previous_generation_cleanup"
769
+ await self._close_companions_locked()
594
770
  await self._close_resource_supervisor_locked()
595
771
  generation_id = f"dshgen_{secrets.token_urlsafe(24)}"
596
772
  try:
773
+ self._startup_stage = "companion_graph"
774
+ definitions = []
775
+ for definition in self._companion_definitions:
776
+ packages = set(definition.components.values())
777
+ present = packages.intersection(projection.bundles)
778
+ if present and present != packages:
779
+ raise CompanionError("COMPANION_GRAPH_INCOMPLETE")
780
+ if present:
781
+ definitions.append(definition)
782
+ if definitions:
783
+ self._startup_stage = "companion_artifact"
784
+ command = await asyncio.to_thread(self._resolve_command)
785
+ artifacts = await asyncio.to_thread(
786
+ self._capture_companion_artifacts, command, definitions, projection,
787
+ )
788
+ manager = DshPluginCompanionManager(
789
+ profile=self._profile, generation_id=generation_id,
790
+ definitions=tuple(definitions),
791
+ artifacts=artifacts,
792
+ )
793
+ self._companion_manager = manager
794
+ self._startup_stage = "companion_broker"
795
+ await manager.start_broker()
796
+ await host.configure_companions(manager.configuration)
797
+ elif self._companion_definitions:
798
+ await host.configure_companions(None)
597
799
  if "@kingsoftcloud/dsh-platform-resources" in projection.bundles:
800
+ self._startup_stage = "resource_broker"
598
801
  ledger = await asyncio.to_thread(
599
802
  OperationLedger, self._workspace / ".agentkit" / "resource-operations"
600
803
  )
@@ -603,7 +806,9 @@ class StudioDshCapabilityService:
603
806
  )
604
807
  socket_path = await self._resource_supervisor.start_broker()
605
808
  await host.configure_resource_socket(socket_path)
809
+ self._startup_stage = "core_start"
606
810
  lease = await host.lease()
811
+ self._startup_stage = "core_protocol"
607
812
  descriptor = host.descriptor
608
813
  if (
609
814
  lease.profile != projection.profile
@@ -612,18 +817,30 @@ class StudioDshCapabilityService:
612
817
  ):
613
818
  raise self._protocol_error()
614
819
  await self._initialize_lease(lease)
820
+ if self._companion_manager is not None:
821
+ self._startup_stage = "companion_artifact_verification"
822
+ verified = await asyncio.to_thread(
823
+ self._capture_companion_artifacts, command, definitions, projection,
824
+ )
825
+ if verified != artifacts:
826
+ raise CompanionError("COMPANION_ARTIFACT_CHANGED_DURING_BOOT")
827
+ self._startup_stage = "companion_start"
828
+ await self._companion_manager.confirm_core_ready()
615
829
  except StudioError as error:
616
830
  self._lease = None
831
+ await self._close_companions_locked()
617
832
  await self._close_resource_supervisor_locked()
618
833
  if error.code == "DSH_CAPABILITY_PROTOCOL_INVALID":
619
834
  await self._dispose_generation_locked()
620
835
  raise
621
836
  except (PluginHostError, OSError, ValueError) as error:
622
837
  self._lease = None
838
+ await self._close_companions_locked()
623
839
  await self._close_resource_supervisor_locked()
624
840
  raise self._unavailable(error) from error
625
841
  except BaseException:
626
842
  self._lease = None
843
+ await self._close_companions_locked()
627
844
  await self._close_resource_supervisor_locked()
628
845
  raise
629
846
  self._lease = lease
@@ -804,14 +1021,28 @@ class StudioDshCapabilityService:
804
1021
  await self._finish_cleanup(supervisor.aclose())
805
1022
 
806
1023
  def _resolve_command(self) -> tuple[str, ...]:
807
- try:
808
- return tuple(DshToolchainManager().require_command(self._explicit_dsh_executable))
809
- except Exception as error:
810
- raise StudioError(
811
- "DSH_CAPABILITY_HOST_UNAVAILABLE",
812
- "DSH capability host 未安装、版本不匹配或不可用",
813
- status_code=503,
814
- ) from error
1024
+ # pnpm/toolchain inspection is a multi-second cold subprocess chain;
1025
+ # the result is deterministic for this process, so memoize it — both
1026
+ # the warmup probe and the first Core startup otherwise re-pay it.
1027
+ if self._resolved_command is not None:
1028
+ return self._resolved_command
1029
+ with self._resolve_lock:
1030
+ if self._resolved_command is None:
1031
+ try:
1032
+ prepare_studio_dsh_home(self._dsh_home)
1033
+ command = tuple(
1034
+ DshToolchainManager().require_command(self._explicit_dsh_executable)
1035
+ )
1036
+ except DshHomeVersionError as error:
1037
+ raise self._unavailable(error) from error
1038
+ except Exception as error:
1039
+ raise StudioError(
1040
+ "DSH_CAPABILITY_HOST_UNAVAILABLE",
1041
+ "DSH capability host 未安装、版本不匹配或不可用",
1042
+ status_code=503,
1043
+ ) from error
1044
+ self._resolved_command = command
1045
+ return self._resolved_command
815
1046
 
816
1047
  def _project_profile(self, command: Sequence[str]) -> DshProfileProjection:
817
1048
  try:
@@ -837,6 +1068,34 @@ class StudioDshCapabilityService:
837
1068
  except Exception as error:
838
1069
  raise self._unavailable(error) from error
839
1070
 
1071
+ def _capture_companion_artifacts(
1072
+ self,
1073
+ command: Sequence[str],
1074
+ definitions: Sequence[DshCompanionDefinition],
1075
+ projection: DshProfileProjection,
1076
+ ) -> dict[str, DshCompanionArtifact]:
1077
+ with self._bridge_factory(
1078
+ dsh_home=self._dsh_home,
1079
+ profile=self._profile,
1080
+ dsh_command=command,
1081
+ cwd=self._workspace,
1082
+ ) as bridge:
1083
+ with bridge._profile_transaction(exclusive=False):
1084
+ snapshot = bridge.snapshot_for_build()
1085
+ if snapshot.projection != projection:
1086
+ raise CompanionError("COMPANION_ARTIFACT_PROFILE_MISMATCH")
1087
+ inventory = bridge.list_plugins()
1088
+ return {
1089
+ definition.plugin_id: companion_artifact(
1090
+ plugin_id=definition.plugin_id,
1091
+ components=definition.components,
1092
+ snapshot=snapshot,
1093
+ inventory=inventory,
1094
+ sources=definition.artifact_sources,
1095
+ )
1096
+ for definition in definitions
1097
+ }
1098
+
840
1099
  def _verify_resource_build_snapshot(
841
1100
  self, command: Sequence[str], expected: DshProfileBuildSnapshot
842
1101
  ) -> None:
@@ -914,7 +1173,10 @@ class StudioDshCapabilityService:
914
1173
  self._generation_id = None
915
1174
  self._active_calls.clear()
916
1175
  try:
917
- await self._close_resource_supervisor_locked()
1176
+ try:
1177
+ await self._close_companions_locked()
1178
+ finally:
1179
+ await self._close_resource_supervisor_locked()
918
1180
  finally:
919
1181
  if active:
920
1182
  await asyncio.gather(
@@ -1091,6 +1353,11 @@ class StudioDshCapabilityService:
1091
1353
 
1092
1354
  @staticmethod
1093
1355
  def _unavailable(error: BaseException) -> StudioError:
1356
+ if isinstance(error, DshHomeVersionError):
1357
+ return StudioError(
1358
+ "DSH_HOME_VERSION_UNVERIFIED", str(error), status_code=409,
1359
+ details=error.diagnostic,
1360
+ )
1094
1361
  reason = getattr(error, "code", None)
1095
1362
  return StudioError(
1096
1363
  "DSH_CAPABILITY_HOST_UNAVAILABLE",
@@ -0,0 +1,58 @@
1
+ """DSH startup diagnostics and companion lifecycle shared by Studio entry points."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from collections.abc import Sequence
6
+ from typing import Any
7
+
8
+ from ksadk.plugins.companions import CompanionError, DshCompanionDefinition, DshPluginCompanionManager
9
+ from ksadk.plugins.providers.dsh_capabilities import DshProfileCapabilityHost, DshMcpConnectorLease
10
+ from ksadk.studio.plugin_lifecycle import RECOVERY_URL, lifecycle_error, lifecycle_failure
11
+
12
+
13
+ class DshStartupLifecycle:
14
+ @property
15
+ def startup_status(self) -> dict[str, Any]:
16
+ """Inspect lifecycle without booting Core or resolving credentials."""
17
+ return {
18
+ "state": "closed" if self._closed else "failed" if self._startup_failure else (
19
+ "ready" if self._lease is not None else "not_ready"
20
+ ),
21
+ "stage": self._startup_stage,
22
+ "failure": dict(self._startup_failure) if self._startup_failure else None,
23
+ "generationId": self._generation_id,
24
+ "recoveryUrl": RECOVERY_URL,
25
+ }
26
+
27
+
28
+ def configure_companions(self, definitions: Sequence[DshCompanionDefinition]) -> None:
29
+ """Configure trusted lifecycle callbacks before this Profile starts."""
30
+ if self._host is not None or self._closed:
31
+ raise CompanionError("COMPANION_CONFIGURATION_BUSY")
32
+ if any(item.profile != self._profile for item in definitions):
33
+ raise CompanionError("COMPANION_PROFILE_MISMATCH")
34
+ self._companion_definitions = tuple(definitions)
35
+
36
+
37
+ @property
38
+ def companion_manager(self) -> DshPluginCompanionManager | None:
39
+ return self._companion_manager
40
+
41
+
42
+ async def _ensure_ready_locked(
43
+ self,
44
+ ) -> tuple[DshProfileCapabilityHost, DshMcpConnectorLease]:
45
+ try:
46
+ result = await self._ensure_ready_generation_locked()
47
+ except Exception as error:
48
+ self._startup_failure = lifecycle_failure(error, self._startup_stage)
49
+ raise lifecycle_error(error, self._startup_stage) from error
50
+ self._startup_failure = None
51
+ self._startup_stage = "ready"
52
+ return result
53
+
54
+
55
+ async def _close_companions_locked(self) -> None:
56
+ manager, self._companion_manager = self._companion_manager, None
57
+ if manager is not None:
58
+ await manager.close()
@@ -28,6 +28,7 @@ from ksadk.plugins.bridges.dsh import (
28
28
  DshProfileProjection,
29
29
  )
30
30
  from ksadk.plugins.contracts import CompositionProfile, PluginManifest
31
+ from ksadk.plugins.dsh_home import default_studio_dsh_home, prepare_studio_dsh_home, studio_dsh_home
31
32
  from ksadk.plugins.dsh_toolchain import DSH_CORE_PACKAGES, DshToolchainManager
32
33
  from ksadk.plugins.host import ManagedPlugin, PluginHostError
33
34
  from ksadk.plugins.providers.codex_dsh import (
@@ -252,12 +253,7 @@ class StudioDshProviderRegistrationManager:
252
253
  def discover(cls, workspace: Path) -> "StudioDshProviderRegistrationManager | None":
253
254
  """Discover an initialized managed Profile without downloading tools."""
254
255
 
255
- configured_home = os.environ.get("KSADK_DSH_HOME", "").strip()
256
- home = (
257
- Path(configured_home).expanduser()
258
- if configured_home
259
- else workspace / ".agentkit" / "dsh-home"
260
- )
256
+ home = studio_dsh_home(workspace)
261
257
  profile = os.environ.get("KSADK_DSH_PROFILE", "").strip() or "web"
262
258
  configured_bin = os.environ.get("KSADK_DSH_BIN", "").strip()
263
259
  manifest = home / "profiles" / profile / "package.json"
@@ -282,7 +278,7 @@ class StudioDshProviderRegistrationManager:
282
278
  """Discover DSH or prepare the isolated first-run Studio Profile.
283
279
 
284
280
  The default is deliberately narrower than :meth:`discover`: only the
285
- Studio-owned ``.agentkit/dsh-home`` and official ``web`` Profile qualify for
281
+ Studio-owned versioned home and official ``web`` Profile qualify for
286
282
  automatic official-provider bootstrap. Explicit DSH homes/profiles
287
283
  are user-owned and are never mutated by Studio startup.
288
284
  """
@@ -292,7 +288,7 @@ class StudioDshProviderRegistrationManager:
292
288
  if configured_home or configured_profile:
293
289
  return cls.discover(workspace)
294
290
  root = workspace.resolve()
295
- home = root / ".agentkit" / "dsh-home"
291
+ home = default_studio_dsh_home(root)
296
292
  configured_bin = os.environ.get("KSADK_DSH_BIN", "").strip()
297
293
  if configured_bin:
298
294
  command: Sequence[str] | None = (str(Path(configured_bin).expanduser()),)
@@ -326,7 +322,7 @@ class StudioDshProviderRegistrationManager:
326
322
  return None
327
323
  return cls(
328
324
  root,
329
- dsh_home=root / ".agentkit" / "dsh-home",
325
+ dsh_home=default_studio_dsh_home(root),
330
326
  profile="agentkit-resources",
331
327
  dsh_command=command,
332
328
  )
@@ -339,7 +335,7 @@ class StudioDshProviderRegistrationManager:
339
335
  def _owns_workspace_default_profile(self) -> bool:
340
336
  configured_home = os.environ.get("KSADK_DSH_HOME", "").strip()
341
337
  configured_profile = os.environ.get("KSADK_DSH_PROFILE", "").strip()
342
- expected_home = (self._workspace / ".agentkit" / "dsh-home").resolve()
338
+ expected_home = default_studio_dsh_home(self._workspace)
343
339
  return (
344
340
  not configured_home
345
341
  and not configured_profile
@@ -369,6 +365,7 @@ class StudioDshProviderRegistrationManager:
369
365
 
370
366
  if not self._owns_workspace_default_profile:
371
367
  return "skipped"
368
+ prepare_studio_dsh_home(self._dsh_home)
372
369
  marker = self._default_marker_path
373
370
  marker_payload = self._read_default_marker(marker)
374
371
  command = self._dsh_command or DshToolchainManager().require_command()
@@ -419,6 +416,48 @@ class StudioDshProviderRegistrationManager:
419
416
  )
420
417
  return result
421
418
 
419
+ async def bootstrap_official_harness_provider(
420
+ self,
421
+ ) -> Literal["installed", "already_enabled", "disabled", "skipped"]:
422
+ """Install and preflight the wheel-owned Harness provider in the managed profile."""
423
+ if not self._owns_workspace_default_profile:
424
+ return "skipped"
425
+ async with self._lock:
426
+ return await asyncio.to_thread(self._bootstrap_official_harness_provider_sync)
427
+
428
+ def _bootstrap_official_harness_provider_sync(
429
+ self,
430
+ ) -> Literal["installed", "already_enabled", "disabled", "skipped"]:
431
+ if not self._owns_workspace_default_profile:
432
+ return "skipped"
433
+ prepare_studio_dsh_home(self._dsh_home)
434
+ command = self._dsh_command or DshToolchainManager().require_command()
435
+ shipped = shipped_harness_dsh_bundle()
436
+ with self._bridge_factory(
437
+ dsh_home=self._dsh_home, profile=self._profile,
438
+ dsh_command=command, cwd=self._workspace,
439
+ ) as bridge:
440
+ self._repair_owned_profile_layout(bridge)
441
+ installed = {item.name: item for item in bridge.list_plugins()}
442
+ current = installed.get(SHIPPED_HARNESS_DSH_PACKAGE)
443
+ if current is None:
444
+ current = bridge.install_plugin(str(shipped.root), accept_host_permissions=True)
445
+ result = "installed"
446
+ else:
447
+ result = "already_enabled" if current.enabled else "disabled"
448
+ if (current.name != SHIPPED_HARNESS_DSH_PACKAGE
449
+ or current.version != SHIPPED_HARNESS_PROVIDER_VERSION):
450
+ raise StudioDshProviderRegistrationError(
451
+ "harness_dsh_bundle_not_active",
452
+ "the official Harness DSH Bundle version is not supported",
453
+ )
454
+ if result == "installed" and not current.enabled:
455
+ current = bridge.set_enabled(SHIPPED_HARNESS_DSH_PACKAGE, enabled=True)
456
+ if not current.enabled:
457
+ return "disabled"
458
+ self._verify_shipped_bundle_bytes(SHIPPED_HARNESS_DSH_PACKAGE)
459
+ return result
460
+
422
461
  async def bootstrap_official_resource_plugins(
423
462
  self,
424
463
  ) -> Literal["installed", "already_enabled", "disabled", "skipped"]:
@@ -434,6 +473,7 @@ class StudioDshProviderRegistrationManager:
434
473
  ) -> Literal["installed", "already_enabled", "disabled", "skipped"]:
435
474
  if not self._owns_workspace_default_profile:
436
475
  return "skipped"
476
+ prepare_studio_dsh_home(self._dsh_home)
437
477
  marker = self._default_marker_path
438
478
  marker_payload = self._read_default_marker(marker)
439
479
  command = self._dsh_command or DshToolchainManager().require_command()
@@ -581,12 +621,10 @@ class StudioDshProviderRegistrationManager:
581
621
 
582
622
  @property
583
623
  def _default_marker_path(self) -> Path:
584
- # Scope the bootstrap receipt to the owned Profile. Older Studio
585
- # builds used one workspace-wide marker while their default Profile
586
- # was ``studio``. Reusing that marker after the default moved to
587
- # official Core's ``web`` Profile incorrectly skipped first-run
588
- # installation and left Studio with no runnable DSH Profile.
589
- return self._workspace / ".agentkit" / f"official-dsh-defaults-{self._profile}.json"
624
+ # An old Core home's "already installed" receipt cannot suppress
625
+ # installation in a fresh version-isolated home. Keep explicit
626
+ # uninstall/disable decisions local to their actual Profile and Core.
627
+ return self._dsh_home / f"official-dsh-defaults-{self._profile}.json"
590
628
 
591
629
  @staticmethod
592
630
  def _read_default_marker(path: Path) -> dict[str, object]:
@@ -711,6 +749,7 @@ class StudioDshProviderRegistrationManager:
711
749
  )
712
750
 
713
751
  def _discover_profile(self) -> _ProfileSnapshot:
752
+ prepare_studio_dsh_home(self._dsh_home)
714
753
  command = self._dsh_command or DshToolchainManager().require_command()
715
754
  with self._bridge_factory(
716
755
  dsh_home=self._dsh_home,