agentengine-sdk-python 0.8.3__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 (819) hide show
  1. {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/METADATA +13 -9
  2. agentengine_sdk_python-0.8.5.dist-info/RECORD +1296 -0
  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 +111 -91
  8. ksadk/builders/code_builder.py +74 -21
  9. ksadk/builders/framework_requirements.py +22 -3
  10. ksadk/builders/ks3_uploader.py +36 -7
  11. ksadk/builders/managed_runtime_builder.py +1 -0
  12. ksadk/cli/__init__.py +68 -3
  13. ksadk/cli/cmd_config.py +4 -4
  14. ksadk/cli/cmd_create.py +12 -12
  15. ksadk/cli/cmd_hermes.py +24 -2
  16. ksadk/cli/cmd_invoke.py +28 -5
  17. ksadk/cli/cmd_managed_runtime.py +13 -1
  18. ksadk/cli/cmd_openclaw.py +26 -1
  19. ksadk/cli/cmd_plugin.py +76 -13
  20. ksadk/cli/cmd_studio.py +64 -16
  21. ksadk/cli/cmd_web.py +2 -5
  22. ksadk/cli/openclaw_env.py +1 -1
  23. ksadk/cli/resource_common.py +26 -0
  24. ksadk/cli/runtime_bootstrap.py +23 -1
  25. ksadk/codex/client.py +425 -96
  26. ksadk/codex/projection.py +24 -0
  27. ksadk/codex/runtime.py +56 -298
  28. ksadk/common/auth.py +16 -10
  29. ksadk/configs/__init__.py +1 -1
  30. ksadk/configs/env_registry.py +153 -31
  31. ksadk/configs/env_registry_studio.py +86 -0
  32. ksadk/configs/global_config.py +1 -1
  33. ksadk/configs/settings.py +3 -3
  34. ksadk/connector/__init__.py +17 -0
  35. ksadk/connector/channel.py +477 -0
  36. ksadk/context_engine/capabilities.py +52 -4
  37. ksadk/conversations/attachment_storage.py +10 -3
  38. ksadk/conversations/attachments.py +16 -5
  39. ksadk/conversations/message_projection.py +133 -21
  40. ksadk/conversations/normalize.py +28 -10
  41. ksadk/conversations/projector.py +4 -6
  42. ksadk/conversations/runtime_baseline.py +37 -0
  43. ksadk/conversations/runtime_invocation.py +22 -4
  44. ksadk/conversations/runtime_observability.py +39 -10
  45. ksadk/conversations/runtime_payloads.py +9 -0
  46. ksadk/conversations/runtime_persistence.py +105 -9
  47. ksadk/conversations/runtime_preparation.py +42 -33
  48. ksadk/conversations/runtime_resume.py +50 -2
  49. ksadk/conversations/runtime_stream_events.py +34 -35
  50. ksadk/conversations/runtime_streaming.py +33 -7
  51. ksadk/deployment/env_forward.py +2 -2
  52. ksadk/deployment/providers/serverless.py +1 -1
  53. ksadk/events/adapters/_codex_items.py +16 -8
  54. ksadk/events/adapters/_codex_validators.py +18 -7
  55. ksadk/events/adapters/_langgraph_support.py +34 -0
  56. ksadk/events/adapters/langgraph.py +15 -1
  57. ksadk/events/canonical_store.py +3 -1
  58. ksadk/events/projections.py +1 -1
  59. ksadk/events/session_event.py +2 -2
  60. ksadk/harness/__init__.py +14 -0
  61. ksadk/harness/app.py +11 -0
  62. ksadk/harness/artifact_store.py +213 -0
  63. ksadk/harness/capabilities.py +115 -0
  64. ksadk/harness/capability_runtime.py +237 -0
  65. ksadk/harness/closure_contract.py +92 -0
  66. ksadk/harness/compaction_record.py +122 -0
  67. ksadk/harness/compiler.py +284 -0
  68. ksadk/harness/config.py +2 -2
  69. ksadk/harness/conformance/__init__.py +33 -0
  70. ksadk/harness/conformance/contract.py +506 -0
  71. ksadk/harness/conformance/fixtures.py +102 -0
  72. ksadk/harness/context_engine.py +403 -0
  73. ksadk/harness/context_maintenance.py +259 -0
  74. ksadk/harness/context_manifest.py +188 -0
  75. ksadk/harness/context_tuning.py +168 -0
  76. ksadk/harness/draft_runtime.py +322 -0
  77. ksadk/harness/engine/__init__.py +40 -0
  78. ksadk/harness/engine/base.py +122 -0
  79. ksadk/harness/engine/budgets.py +108 -0
  80. ksadk/harness/engine/capability_declarations.py +59 -0
  81. ksadk/harness/engine/completion_guard.py +42 -0
  82. ksadk/harness/engine/context_pipeline.py +579 -0
  83. ksadk/harness/engine/graph_builder.py +859 -0
  84. ksadk/harness/engine/langgraph.py +931 -0
  85. ksadk/harness/engine/mcp_disclosure.py +750 -0
  86. ksadk/harness/engine/policy_runtime.py +70 -0
  87. ksadk/harness/engine/postgres_checkpointer.py +63 -0
  88. ksadk/harness/engine/run_control_bridge.py +80 -0
  89. ksadk/harness/engine/run_types.py +88 -0
  90. ksadk/harness/engine/skill_disclosure.py +189 -0
  91. ksadk/harness/engine/spans.py +41 -0
  92. ksadk/harness/engine/subagents.py +343 -0
  93. ksadk/harness/engine/thread_ids.py +112 -0
  94. ksadk/harness/engine/tool_dispatch.py +144 -0
  95. ksadk/harness/event_tree.py +212 -0
  96. ksadk/harness/events.py +461 -0
  97. ksadk/harness/execution_policy.py +94 -0
  98. ksadk/harness/insights.py +210 -0
  99. ksadk/harness/lifecycle.py +578 -0
  100. ksadk/harness/lifecycle_conformance.py +233 -0
  101. ksadk/harness/lifecycle_local_plane.py +104 -0
  102. ksadk/harness/loop/__init__.py +44 -0
  103. ksadk/harness/loop/reason.py +454 -0
  104. ksadk/harness/loop/tools.py +762 -0
  105. ksadk/harness/managed_runtime.py +884 -0
  106. ksadk/harness/mcp_matrix.py +474 -0
  107. ksadk/harness/mcp_runtime.py +471 -0
  108. ksadk/harness/memory_consolidation.py +157 -0
  109. ksadk/harness/memory_loop.py +156 -0
  110. ksadk/harness/memory_runtime.py +541 -0
  111. ksadk/harness/metrics.py +90 -0
  112. ksadk/harness/model_capability.py +253 -0
  113. ksadk/harness/model_provider.py +220 -0
  114. ksadk/harness/observability/__init__.py +29 -0
  115. ksadk/harness/observability/inspection.py +528 -0
  116. ksadk/harness/observability/metrics.py +167 -0
  117. ksadk/harness/observability/otel_exporter.py +218 -0
  118. ksadk/harness/prompt_cache.py +70 -0
  119. ksadk/harness/public_activity.py +154 -0
  120. ksadk/harness/readiness.py +249 -0
  121. ksadk/harness/reasoner.py +466 -13
  122. ksadk/harness/release_readiness.py +140 -0
  123. ksadk/harness/resource_ref.py +69 -0
  124. ksadk/harness/run_control.py +668 -0
  125. ksadk/harness/runtime.py +171 -136
  126. ksadk/harness/runtime_capabilities.py +158 -0
  127. ksadk/harness/runtime_server.py +514 -0
  128. ksadk/harness/sandbox_adapters.py +739 -0
  129. ksadk/harness/sandbox_backend.py +530 -0
  130. ksadk/harness/sandbox_conformance.py +288 -0
  131. ksadk/harness/sandbox_lease.py +77 -0
  132. ksadk/harness/sandbox_lease_conformance.py +259 -0
  133. ksadk/harness/sandbox_matrix.py +170 -0
  134. ksadk/harness/sandbox_reconciliation.py +140 -0
  135. ksadk/harness/sandbox_recovery.py +586 -0
  136. ksadk/harness/sandbox_recovery_conformance.py +246 -0
  137. ksadk/harness/session_store.py +243 -0
  138. ksadk/harness/skill_composition.py +212 -0
  139. ksadk/harness/skill_feedback.py +123 -0
  140. ksadk/harness/skill_matrix.py +233 -0
  141. ksadk/harness/skill_runtime.py +259 -0
  142. ksadk/harness/spec.py +332 -0
  143. ksadk/harness/state.py +153 -0
  144. ksadk/harness/strategies.py +149 -0
  145. ksadk/harness/subagent.py +253 -0
  146. ksadk/harness/tool_policy.py +131 -0
  147. ksadk/harness/tool_receipts.py +96 -0
  148. ksadk/harness/tool_reliability.py +81 -0
  149. ksadk/harness/tools.py +38 -13
  150. ksadk/harness/user_errors.py +69 -0
  151. ksadk/harness/working_context.py +81 -0
  152. ksadk/harness/working_context_patch.py +99 -0
  153. ksadk/identity/resolver.py +18 -0
  154. ksadk/interaction/__init__.py +1 -1
  155. ksadk/interaction/ledger.py +1 -1
  156. ksadk/interaction/provider.py +2 -1
  157. ksadk/interaction/providers/__init__.py +3 -1
  158. ksadk/interaction/providers/adk.py +1 -1
  159. ksadk/interaction/providers/codex.py +1 -1
  160. ksadk/interaction/providers/harness.py +50 -0
  161. ksadk/interaction/providers/langgraph.py +2 -1
  162. ksadk/kernel/__init__.py +10 -0
  163. ksadk/kernel/approval_presentation.py +91 -0
  164. ksadk/kernel/authorization.py +1 -1
  165. ksadk/kernel/bootstrap.py +114 -106
  166. ksadk/kernel/contract_fingerprints.py +1 -1
  167. ksadk/kernel/contracts.py +5 -0
  168. ksadk/kernel/control.py +32 -1
  169. ksadk/kernel/execution_grants.py +221 -0
  170. ksadk/kernel/execution_grants_memory.py +133 -0
  171. ksadk/kernel/execution_grants_postgres.py +217 -0
  172. ksadk/kernel/execution_grants_sqlite.py +209 -0
  173. ksadk/kernel/ingress.py +42 -29
  174. ksadk/kernel/mapping.py +1 -1
  175. ksadk/kernel/memory_store.py +24 -11
  176. ksadk/kernel/postgres_store.py +63 -33
  177. ksadk/kernel/recovery.py +78 -14
  178. ksadk/kernel/sql/001_agent_kernel.sql +23 -0
  179. ksadk/kernel/sqlite_store.py +331 -25
  180. ksadk/kernel/state.py +2 -3
  181. ksadk/kernel/store.py +72 -2
  182. ksadk/kernel/worker.py +144 -51
  183. ksadk/kernel/worker_history.py +72 -0
  184. ksadk/kernel/worker_identity.py +47 -0
  185. ksadk/knowledge_base/client.py +57 -27
  186. ksadk/mcp_runtime/__init__.py +12 -4
  187. ksadk/memory/adk/backends/sdk_ltm_backend.py +161 -41
  188. ksadk/memory/adk/resilient_session_service.py +25 -17
  189. ksadk/memory/adk/short_term_memory.py +26 -9
  190. ksadk/memory/coordinator.py +22 -6
  191. ksadk/memory/extraction.py +40 -1
  192. ksadk/memory/models.py +84 -5
  193. ksadk/memory/provider_resolver.py +8 -0
  194. ksadk/memory/providers/local_postgres.py +200 -0
  195. ksadk/memory/providers/local_sqlite.py +42 -3
  196. ksadk/memory/retrieval.py +189 -0
  197. ksadk/memory/store_adapter.py +150 -0
  198. ksadk/model_policy.py +2 -2
  199. ksadk/model_proxy/detect.py +254 -0
  200. ksadk/model_proxy/server.py +14 -7
  201. ksadk/model_proxy/transform.py +40 -2
  202. ksadk/plugins/__init__.py +5 -1
  203. ksadk/plugins/artifacts.py +275 -0
  204. ksadk/plugins/bridges/__init__.py +4 -2
  205. ksadk/plugins/bridges/codex.py +120 -13
  206. ksadk/plugins/bridges/dsh.py +351 -156
  207. ksadk/plugins/builtins.py +72 -35
  208. ksadk/plugins/bundle_security.py +28 -4
  209. ksadk/plugins/codex_manifest.py +983 -0
  210. ksadk/plugins/companion_artifacts.py +83 -0
  211. ksadk/plugins/companions.py +368 -0
  212. ksadk/plugins/composition.py +8 -0
  213. ksadk/plugins/contracts.py +119 -1
  214. ksadk/plugins/delivery.py +153 -0
  215. ksadk/plugins/dsh_channels.py +156 -0
  216. ksadk/plugins/dsh_home.py +140 -0
  217. ksadk/plugins/dsh_installation_digest.py +71 -0
  218. ksadk/plugins/dsh_teams.py +105 -0
  219. ksadk/plugins/dsh_toolchain.py +203 -32
  220. ksadk/plugins/ecosystem_probe.py +6 -6
  221. ksadk/plugins/execution_host.py +99 -0
  222. ksadk/plugins/host.py +102 -39
  223. ksadk/plugins/kernel_adapter.py +205 -0
  224. ksadk/plugins/providers/__init__.py +23 -0
  225. ksadk/plugins/providers/bundles/dsh-channels-client/client.js +19 -0
  226. ksadk/plugins/providers/bundles/dsh-channels-client/cordis.patch.yml +3 -0
  227. ksadk/plugins/providers/bundles/dsh-channels-client/index.mjs +7 -0
  228. ksadk/plugins/providers/bundles/dsh-channels-client/package.json +12 -0
  229. ksadk/plugins/providers/bundles/dsh-knowledge/cordis.patch.yml +3 -0
  230. ksadk/plugins/providers/bundles/dsh-knowledge/index.mjs +53 -0
  231. ksadk/plugins/providers/bundles/dsh-knowledge/package.json +16 -0
  232. ksadk/plugins/providers/bundles/dsh-memory/cordis.patch.yml +3 -0
  233. ksadk/plugins/providers/bundles/dsh-memory/index.mjs +175 -0
  234. ksadk/plugins/providers/bundles/dsh-memory/package.json +16 -0
  235. ksadk/plugins/providers/bundles/dsh-platform-resources/client.mjs +166 -0
  236. ksadk/plugins/providers/bundles/dsh-platform-resources/cordis.patch.yml +3 -0
  237. ksadk/plugins/providers/bundles/dsh-platform-resources/index.mjs +9 -0
  238. ksadk/plugins/providers/bundles/dsh-platform-resources/package.json +12 -0
  239. ksadk/plugins/providers/bundles/dsh-skill-center/cordis.patch.yml +3 -0
  240. ksadk/plugins/providers/bundles/dsh-skill-center/index.mjs +125 -0
  241. ksadk/plugins/providers/bundles/dsh-skill-center/package.json +16 -0
  242. ksadk/plugins/providers/bundles/dsh-teams-client/client.js +29 -0
  243. ksadk/plugins/providers/bundles/dsh-teams-client/cordis.patch.yml +3 -0
  244. ksadk/plugins/providers/bundles/dsh-teams-client/index.mjs +11 -0
  245. ksadk/plugins/providers/bundles/dsh-teams-client/package.json +35 -0
  246. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/cordis.patch.yml +3 -0
  247. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/index.mjs +13 -0
  248. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/package.json +27 -0
  249. ksadk/plugins/providers/bundles/dsh-teams-profile/cordis.patch.yml +3 -0
  250. ksadk/plugins/providers/bundles/dsh-teams-profile/index.mjs +12 -0
  251. ksadk/plugins/providers/bundles/dsh-teams-profile/package.json +26 -0
  252. ksadk/plugins/providers/bundles/dsh-teams-router/cordis.patch.yml +3 -0
  253. ksadk/plugins/providers/bundles/dsh-teams-router/index.mjs +16 -0
  254. ksadk/plugins/providers/bundles/dsh-teams-router/package.json +27 -0
  255. ksadk/plugins/providers/bundles/dsh-teams-tasks/cordis.patch.yml +3 -0
  256. ksadk/plugins/providers/bundles/dsh-teams-tasks/index.mjs +16 -0
  257. ksadk/plugins/providers/bundles/dsh-teams-tasks/package.json +27 -0
  258. ksadk/plugins/providers/bundles/dsh-teams-tools/cordis.patch.yml +3 -0
  259. ksadk/plugins/providers/bundles/dsh-teams-tools/index.mjs +25 -0
  260. ksadk/plugins/providers/bundles/dsh-teams-tools/package.json +29 -0
  261. ksadk/plugins/providers/bundles/dsh-teams-tools/tools.json +235 -0
  262. ksadk/plugins/providers/bundles/ksadk-codex/index.mjs +1 -1
  263. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/cordis.patch.yml +3 -0
  264. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/index.mjs +920 -0
  265. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/package.json +27 -0
  266. ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/client.mjs +133 -0
  267. ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/index.mjs +14 -0
  268. ksadk/plugins/providers/bundles/ksadk-dsh-studio/client.js +115 -0
  269. ksadk/plugins/providers/bundles/ksadk-dsh-studio/index.mjs +19 -0
  270. ksadk/plugins/providers/bundles/ksadk-dsh-studio/package.json +7 -0
  271. ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +1 -1
  272. ksadk/plugins/providers/codex.py +344 -70
  273. ksadk/plugins/providers/codex_native.py +368 -0
  274. ksadk/plugins/providers/codex_turn.py +301 -0
  275. ksadk/plugins/providers/dsh_capabilities.py +1450 -0
  276. ksadk/plugins/providers/dsh_mcp.py +467 -0
  277. ksadk/plugins/providers/harness.py +294 -141
  278. ksadk/plugins/providers/harness_delegation.py +593 -0
  279. ksadk/plugins/providers/harness_managed.py +456 -0
  280. ksadk/plugins/providers/harness_tools.py +326 -0
  281. ksadk/plugins/providers/mcp_projection.py +150 -0
  282. ksadk/plugins/providers/platform_resources.py +657 -0
  283. ksadk/plugins/providers/shipped_dsh.py +4 -1
  284. ksadk/plugins/resolver.py +8 -1
  285. ksadk/plugins/subagent_providers/codex.py +28 -6
  286. ksadk/plugins/teams/__init__.py +5 -0
  287. ksadk/plugins/teams/api.py +405 -0
  288. ksadk/plugins/teams/application.py +680 -0
  289. ksadk/plugins/teams/artifacts.py +60 -0
  290. ksadk/plugins/teams/context.py +96 -0
  291. ksadk/plugins/teams/contracts.py +136 -0
  292. ksadk/plugins/teams/domain.py +1427 -0
  293. ksadk/plugins/teams/domain_values.py +24 -0
  294. ksadk/plugins/teams/errors.py +13 -0
  295. ksadk/plugins/teams/migration.py +311 -0
  296. ksadk/plugins/teams/migration_cli.py +322 -0
  297. ksadk/plugins/teams/postgres_store.py +138 -0
  298. ksadk/plugins/teams/runtime.py +777 -0
  299. ksadk/plugins/teams/source_projection.py +84 -0
  300. ksadk/plugins/teams/store.py +311 -0
  301. ksadk/plugins/teams/task_decisions.py +423 -0
  302. ksadk/plugins/teams/transport.py +91 -0
  303. ksadk/plugins/teams/workspaces.py +255 -0
  304. ksadk/resource_runtime/__init__.py +4 -0
  305. ksadk/resource_runtime/broker.py +616 -0
  306. ksadk/resource_runtime/build_artifacts.py +165 -0
  307. ksadk/resource_runtime/contracts.py +138 -0
  308. ksadk/resource_runtime/discovery_receipts.py +100 -0
  309. ksadk/resource_runtime/discovery_skills.py +172 -0
  310. ksadk/resource_runtime/errors.py +6 -0
  311. ksadk/resource_runtime/ipc.py +142 -0
  312. ksadk/resource_runtime/kernel_approval.py +165 -0
  313. ksadk/resource_runtime/knowledge.py +114 -0
  314. ksadk/resource_runtime/langgraph.py +94 -0
  315. ksadk/resource_runtime/leases.py +191 -0
  316. ksadk/resource_runtime/managed_projection.py +186 -0
  317. ksadk/resource_runtime/mcp_server.py +138 -0
  318. ksadk/resource_runtime/memory_provider.py +318 -0
  319. ksadk/resource_runtime/memory_receipts.py +34 -0
  320. ksadk/resource_runtime/operation_ledger.py +211 -0
  321. ksadk/resource_runtime/plugin_config.py +48 -0
  322. ksadk/resource_runtime/policy_authorization.py +54 -0
  323. ksadk/resource_runtime/process.py +110 -0
  324. ksadk/resource_runtime/skill_artifacts.py +153 -0
  325. ksadk/resource_runtime/skill_runtime.py +42 -0
  326. ksadk/resource_runtime/skill_workspace.py +118 -0
  327. ksadk/resource_runtime/skills.py +215 -0
  328. ksadk/resource_runtime/snapshots.py +180 -0
  329. ksadk/resource_runtime/socket_server.py +103 -0
  330. ksadk/resource_runtime/supervisor.py +380 -0
  331. ksadk/resource_runtime/worker.py +504 -0
  332. ksadk/runners/_langgraph_runner_streams.py +182 -38
  333. ksadk/runners/_langgraph_state_reader.py +106 -0
  334. ksadk/runners/_session_identity.py +285 -0
  335. ksadk/runners/adk_runner.py +166 -63
  336. ksadk/runners/base_runner.py +29 -1
  337. ksadk/runners/langgraph_runner.py +542 -195
  338. ksadk/runners/patch_langchain.py +47 -0
  339. ksadk/runners/usage_accumulator.py +11 -3
  340. ksadk/runtime/_runner_adapter/stream_mapping.py +194 -20
  341. ksadk/runtime/adapter.py +2 -0
  342. ksadk/runtime/conversation_execution.py +117 -17
  343. ksadk/runtime/executor.py +87 -3
  344. ksadk/runtime/factory.py +65 -274
  345. ksadk/runtime/framework_adapters.py +23 -0
  346. ksadk/runtime/preprocessing.py +21 -5
  347. ksadk/runtime/runner_adapter.py +106 -18
  348. ksadk/runtime/skill_eval_result.py +36 -0
  349. ksadk/runtime/timing.py +46 -0
  350. ksadk/runtime/usage.py +49 -18
  351. ksadk/runtime_context.py +142 -2
  352. ksadk/sandbox/backends/e2b.py +288 -25
  353. ksadk/sandbox/backends/local_process.py +72 -39
  354. ksadk/sandbox/base.py +64 -1
  355. ksadk/sandbox/diagnostics.py +82 -0
  356. ksadk/sandbox/e2b_connection.py +66 -0
  357. ksadk/sandbox/local_controls.py +746 -0
  358. ksadk/sandbox/local_launcher.py +90 -0
  359. ksadk/scheduler/dispatcher.py +1 -1
  360. ksadk/scheduler/sqlite_store.py +18 -0
  361. ksadk/server/composition.py +2 -0
  362. ksadk/server/factory.py +5 -0
  363. ksadk/server/invocation_identity.py +118 -0
  364. ksadk/server/persistence_capability.py +516 -0
  365. ksadk/server/routes/common.py +32 -3
  366. ksadk/server/routes/control.py +271 -52
  367. ksadk/server/routes/dependencies.py +16 -0
  368. ksadk/server/routes/kernel_ingress.py +9 -1
  369. ksadk/server/routes/misc.py +233 -25
  370. ksadk/server/routes/models.py +47 -4
  371. ksadk/server/routes/openai_compat.py +76 -13
  372. ksadk/server/routes/projection.py +252 -12
  373. ksadk/server/routes/run.py +106 -35
  374. ksadk/server/routes/sessions.py +491 -138
  375. ksadk/server/routes/streaming.py +43 -9
  376. ksadk/server/routes/workspace.py +130 -21
  377. ksadk/server/static/assets/{ArtifactsPanel-10GPXIJ6.js → ArtifactsPanel-C1YoaKhx.js} +1 -1
  378. ksadk/server/static/assets/{CodeBlock-BXk1l-G1.js → CodeBlock-DHuAWfr5.js} +10 -7
  379. ksadk/server/static/assets/MathMessageMarkdown-cvdrBwYr.js +8 -0
  380. ksadk/server/static/assets/{MermaidBlock--OEYoXIJ.js → MermaidBlock-DeBkbJvI.js} +9 -9
  381. ksadk/server/static/assets/{NativeTerminalPanel-DrEe1syq.js → NativeTerminalPanel-oJj44_sV.js} +1 -1
  382. ksadk/server/static/assets/{abnfDiagram-VCTEODGH-eeTFJLvo.js → abnfDiagram-VCTEODGH-Dhfv25o2.js} +1 -1
  383. ksadk/server/static/assets/{arc-S3ZNbIAd.js → arc-C35w-pn1.js} +1 -1
  384. ksadk/server/static/assets/architecture-7GRP2DOG-BCsa26zi.js +1 -0
  385. ksadk/server/static/assets/{architectureDiagram-5GKGNRK7-CRjgEJDX.js → architectureDiagram-5GKGNRK7-FoMY_u6D.js} +1 -1
  386. ksadk/server/static/assets/{blockDiagram-NRAW4CY4-C7bsBoNH.js → blockDiagram-NRAW4CY4-zD4Rt7oE.js} +1 -1
  387. ksadk/server/static/assets/{c4Diagram-UCG6FXSJ-BX3c33Ob.js → c4Diagram-UCG6FXSJ-BCtGGkhN.js} +1 -1
  388. ksadk/server/static/assets/channel-_KDifNys.js +1 -0
  389. ksadk/server/static/assets/chunk-2Q5K7J3B-HdVkJ9F0.js +1 -0
  390. ksadk/server/static/assets/{chunk-5VM5RSS4-bZ7ws-8m.js → chunk-5VM5RSS4-C2Ms13_k.js} +1 -1
  391. ksadk/server/static/assets/{chunk-F27PBJKO-D2r0pvhY.js → chunk-F27PBJKO-BoTj-qgx.js} +1 -1
  392. ksadk/server/static/assets/{chunk-G27WJ6UU-CZwF3oUP.js → chunk-G27WJ6UU-DOMyyjHH.js} +1 -1
  393. ksadk/server/static/assets/{chunk-JWPE2WC7-DigFYCML.js → chunk-JWPE2WC7-DbJJqDli.js} +1 -1
  394. ksadk/server/static/assets/{chunk-LCL6LL3I-CnorGV5q.js → chunk-LCL6LL3I-CLuRCt_W.js} +1 -1
  395. ksadk/server/static/assets/{chunk-POPQ4Y6H-CexntQA-.js → chunk-POPQ4Y6H-D0Dz847e.js} +1 -1
  396. ksadk/server/static/assets/{chunk-RHFEMEQ7-CHTC7UxA.js → chunk-RHFEMEQ7-BWSRzEcd.js} +1 -1
  397. ksadk/server/static/assets/{chunk-SVP7TREG-BC1EWt_-.js → chunk-SVP7TREG-CPoHqkCY.js} +1 -1
  398. ksadk/server/static/assets/{chunk-XXDRQBXY-BTG24xN0.js → chunk-XXDRQBXY-Bx1jS-X-.js} +1 -1
  399. ksadk/server/static/assets/classDiagram-DTDB5LWJ-BVCW3ZqZ.js +1 -0
  400. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-BVCW3ZqZ.js +1 -0
  401. ksadk/server/static/assets/{cose-bilkent-JH36ORCC-CkonRdAS.js → cose-bilkent-JH36ORCC-LzyWm4m0.js} +1 -1
  402. ksadk/server/static/assets/cynefin-OW5HDTMX-CNXjFctL.js +1 -0
  403. ksadk/server/static/assets/{cynefinDiagram-5FMLGOSQ-DEOCBe15.js → cynefinDiagram-5FMLGOSQ-BlW_bHED.js} +1 -1
  404. ksadk/server/static/assets/{dagre-3AP2YEHR-DBThPuLa.js → dagre-3AP2YEHR-Bu_S86_i.js} +1 -1
  405. ksadk/server/static/assets/{dagre-ClTPrTht.js → dagre-B7nCawed.js} +1 -1
  406. ksadk/server/static/assets/{diagram-S7CK7UJ4-DsZHrnpJ.js → diagram-S7CK7UJ4-W_Zow2Km.js} +1 -1
  407. ksadk/server/static/assets/{diagram-UQ7AKVKN-BJR4nhVr.js → diagram-UQ7AKVKN-CLIKAHON.js} +1 -1
  408. ksadk/server/static/assets/{diagram-VSXAHHWV-xzcERX0a.js → diagram-VSXAHHWV-Dv6_QAlN.js} +1 -1
  409. ksadk/server/static/assets/{diagram-VX7I27RA-tn2xM1xu.js → diagram-VX7I27RA-BWAWRDtZ.js} +1 -1
  410. ksadk/server/static/assets/{diagram-Z3DM3KII-BZPGBkw5.js → diagram-Z3DM3KII-XA_rWMss.js} +1 -1
  411. ksadk/server/static/assets/dist-0X_j2Rcc.js +1 -0
  412. ksadk/server/static/assets/{dist-4zN1_tq5.js → dist-1nXCdsej.js} +1 -1
  413. ksadk/server/static/assets/{dist-M67Hwu0n.js → dist-2vL2sAdF.js} +1 -1
  414. ksadk/server/static/assets/{dist-BJLUwH6W.js → dist-B3bA05-e.js} +1 -1
  415. ksadk/server/static/assets/{dist-8VWI-2bZ.js → dist-BLpRy_Yx.js} +1 -1
  416. ksadk/server/static/assets/{dist-D1V3f1B4.js → dist-BO_UwatH.js} +1 -1
  417. ksadk/server/static/assets/{dist-Cq4OL6nO.js → dist-BdNFAney.js} +1 -1
  418. ksadk/server/static/assets/{dist-DfGFrb0v.js → dist-C0J5_3qM.js} +1 -1
  419. ksadk/server/static/assets/{dist-DyqV4fL4.js → dist-CGt_UGeO.js} +1 -1
  420. ksadk/server/static/assets/{dist-DjhwGUgZ.js → dist-CIRMvUM4.js} +1 -1
  421. ksadk/server/static/assets/{dist-B1oWRmrH.js → dist-CIpWk_5f.js} +1 -1
  422. ksadk/server/static/assets/{dist-CXpH_Rdd.js → dist-CPyieXEf.js} +1 -1
  423. ksadk/server/static/assets/{dist-Btyo4vX4.js → dist-D-92S-Fd.js} +1 -1
  424. ksadk/server/static/assets/{dist-u8tVH5Ak.js → dist-DNKuMzWc.js} +1 -1
  425. ksadk/server/static/assets/{dist-DQAB0qn_.js → dist-DWfdmz9s.js} +2 -2
  426. ksadk/server/static/assets/{dist-B-46q3Hk.js → dist-DppE_r-D.js} +1 -1
  427. ksadk/server/static/assets/{dist-C71CsujO.js → dist-DyG6Ya-z.js} +1 -1
  428. ksadk/server/static/assets/{dist-DJmCPRVB.js → dist-M-SrdhhZ.js} +1 -1
  429. ksadk/server/static/assets/{dist-Bbwqa8TG.js → dist-mqD5TZup.js} +1 -1
  430. ksadk/server/static/assets/{dist-BI1qQH4n.js → dist-n3n6t_FO.js} +1 -1
  431. ksadk/server/static/assets/{dist-DUwKa_l6.js → dist-qe8xjesy.js} +1 -1
  432. ksadk/server/static/assets/{dist-B0gdk4rl.js → dist-t6MzE0jU.js} +1 -1
  433. ksadk/server/static/assets/{ebnfDiagram-PWID7BFC-DVfMsLge.js → ebnfDiagram-PWID7BFC-BfCzF1Xi.js} +1 -1
  434. ksadk/server/static/assets/{erDiagram-SSCWMZ5O-CWEZSYaw.js → erDiagram-SSCWMZ5O-Dpz9_0zn.js} +1 -1
  435. ksadk/server/static/assets/eventmodeling-NTZA5JFV-B5-8RH9c.js +1 -0
  436. ksadk/server/static/assets/flowDiagram-A5DVABFB-BppFxEKw.js +1 -0
  437. ksadk/server/static/assets/{ganttDiagram-EL5Y4UJY-TWIxoyYL.js → ganttDiagram-EL5Y4UJY-DDaG1f4_.js} +1 -1
  438. ksadk/server/static/assets/gitGraph-4MIJSDKK-B-AhYj4C.js +1 -0
  439. ksadk/server/static/assets/{gitGraphDiagram-WWUBYQGX-DDh2hd2S.js → gitGraphDiagram-WWUBYQGX-DcxzRwYC.js} +1 -1
  440. ksadk/server/static/assets/index-BMd2mucF.css +2 -0
  441. ksadk/server/static/assets/index-D5qyyhTH.js +244 -0
  442. ksadk/server/static/assets/info-A6RAGUB7-0uiKrC35.js +1 -0
  443. ksadk/server/static/assets/{infoDiagram-RXCK75RN-CgoyWiDR.js → infoDiagram-RXCK75RN-CYMdn6lQ.js} +1 -1
  444. ksadk/server/static/assets/{ishikawaDiagram-5VMMS53U-CyRIu_om.js → ishikawaDiagram-5VMMS53U-CLHFAD6c.js} +1 -1
  445. ksadk/server/static/assets/{journeyDiagram-EYS64GPL-DN5JXHzN.js → journeyDiagram-EYS64GPL-BHSKQGAl.js} +1 -1
  446. ksadk/server/static/assets/{kanban-definition-3QL26DDD-CNP3ui66.js → kanban-definition-3QL26DDD-D5W3tjTT.js} +1 -1
  447. ksadk/server/static/assets/{katex-DWEzQy1d.js → katex-mtjOi4KM.js} +1 -1
  448. ksadk/server/static/assets/{linear-C-qHp7d2.js → linear-BETqsxE_.js} +1 -1
  449. ksadk/server/static/assets/{mermaid-parser.core-Cl-K943T.js → mermaid-parser.core-DPWrvs90.js} +2 -2
  450. ksadk/server/static/assets/{mindmap-definition-FBJOCRG2-D5DB5mYm.js → mindmap-definition-FBJOCRG2-CJG2mfBP.js} +1 -1
  451. ksadk/server/static/assets/packet-AYTQ26CC-BVTmZ_cw.js +1 -0
  452. ksadk/server/static/assets/{pegDiagram-XKGWAZYB-BQVc9ia_.js → pegDiagram-XKGWAZYB-GjAPNaqn.js} +1 -1
  453. ksadk/server/static/assets/pie-WAS4IAKB-DyfxBU7V.js +1 -0
  454. ksadk/server/static/assets/{pieDiagram-E7YTZNPT-B6UCAvtY.js → pieDiagram-E7YTZNPT-ToIewrqr.js} +1 -1
  455. ksadk/server/static/assets/{quadrantDiagram-AXDQQJYC-mIr2d3eb.js → quadrantDiagram-AXDQQJYC-4d78KiEY.js} +1 -1
  456. ksadk/server/static/assets/radar-RG4KPBEZ-FFontjL2.js +1 -0
  457. ksadk/server/static/assets/railroad-74A4TZTK-D0Uidzen.js +1 -0
  458. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-BOo_9T2h.js +1 -0
  459. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-D6-BjW7Z.js +1 -0
  460. ksadk/server/static/assets/railroad-peg-WCYAUIDC-CXx__yMm.js +1 -0
  461. ksadk/server/static/assets/{railroadDiagram-O6MQD6OU-Dt3FFDmK.js → railroadDiagram-O6MQD6OU-DKzx4xfv.js} +1 -1
  462. ksadk/server/static/assets/{requirementDiagram-EFPCY7ZU-Cz_vQtgF.js → requirementDiagram-EFPCY7ZU-CJYljxQS.js} +1 -1
  463. ksadk/server/static/assets/{sankeyDiagram-P5KCCOFB-wlO1TsH5.js → sankeyDiagram-P5KCCOFB-DLU2fV1w.js} +1 -1
  464. ksadk/server/static/assets/{sequenceDiagram-WJ2MYXX4-CHRbElYq.js → sequenceDiagram-WJ2MYXX4-CVqysrA9.js} +1 -1
  465. ksadk/server/static/assets/{sizeCapture-X5ZJPWSS-DXX54iyO.js → sizeCapture-X5ZJPWSS-BUxfmTHc.js} +1 -1
  466. ksadk/server/static/assets/{stateDiagram-HBIQ2CUA-Dp_lw9II.js → stateDiagram-HBIQ2CUA-CNFgYI9E.js} +1 -1
  467. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BXAFScz8.js +1 -0
  468. ksadk/server/static/assets/{swimlanes-XN3QIQJK-D8O5UlLG.js → swimlanes-XN3QIQJK-B6qCMe8N.js} +1 -1
  469. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uIQ2lJKH.js +8 -0
  470. ksadk/server/static/assets/{timeline-definition-24CTP7MA-8mfKcxvG.js → timeline-definition-24CTP7MA-CMD3x_U_.js} +1 -1
  471. ksadk/server/static/assets/treeView-Q6P3EWNA-CK5GgucZ.js +1 -0
  472. ksadk/server/static/assets/treemap-WGGIJYW6-Bq1u1SpG.js +1 -0
  473. ksadk/server/static/assets/{vennDiagram-4TSXK5OY-EnNl0DE7.js → vennDiagram-4TSXK5OY-BqtUqvXM.js} +1 -1
  474. ksadk/server/static/assets/wardley-WFR3VGLG-QAt06uEz.js +1 -0
  475. ksadk/server/static/assets/{wardleyDiagram-VM6X3IG4-DBu5fbYr.js → wardleyDiagram-VM6X3IG4-B5KfDjI-.js} +1 -1
  476. ksadk/server/static/assets/{xychartDiagram-S5SC5T6Z-BSVXs4IY.js → xychartDiagram-S5SC5T6Z-BaUlSZrn.js} +1 -1
  477. ksadk/server/static/index.html +2 -2
  478. ksadk/server/terminal_sessions.py +34 -2
  479. ksadk/session_context.py +66 -0
  480. ksadk/sessions/__init__.py +11 -21
  481. ksadk/sessions/_local_service_sync.py +263 -1
  482. ksadk/sessions/base.py +176 -0
  483. ksadk/sessions/errors.py +4 -0
  484. ksadk/sessions/in_memory.py +309 -19
  485. ksadk/sessions/invocation_identity.py +235 -0
  486. ksadk/sessions/local_service.py +83 -1
  487. ksadk/sessions/persistence.py +275 -0
  488. ksadk/sessions/postgres_service.py +358 -0
  489. ksadk/sessions/resilience.py +8 -0
  490. ksadk/sessions/resilient.py +362 -4
  491. ksadk/sessions/topology.py +135 -0
  492. ksadk/skills/__init__.py +26 -0
  493. ksadk/skills/events.py +464 -0
  494. ksadk/skills/manifest_cache.py +263 -0
  495. ksadk/skills/mcp_server/__init__.py +0 -0
  496. ksadk/skills/mcp_server/_registry.py +33 -0
  497. ksadk/skills/mcp_server/_routing.py +26 -0
  498. ksadk/skills/mcp_server/_workspace_files.py +160 -0
  499. ksadk/skills/mcp_server/register.py +415 -0
  500. ksadk/skills/mcp_server/server.py +218 -0
  501. ksadk/skills/models.py +37 -4
  502. ksadk/skills/observability.py +132 -0
  503. ksadk/skills/package_store.py +261 -40
  504. ksadk/skills/runtime/agent.py +67 -9
  505. ksadk/skills/runtime/artifact_delivery.py +139 -0
  506. ksadk/skills/runtime/artifacts.py +87 -0
  507. ksadk/skills/runtime/backends/e2b.py +460 -27
  508. ksadk/skills/runtime/backends/local.py +629 -62
  509. ksadk/skills/runtime/base.py +81 -7
  510. ksadk/skills/runtime/executor.py +268 -1
  511. ksadk/skills/runtime/loader.py +118 -5
  512. ksadk/skills/runtime/pinned.py +114 -0
  513. ksadk/skills/runtime/request.py +49 -0
  514. ksadk/skills/service_client.py +167 -28
  515. ksadk/skills/tool_defs.py +108 -3
  516. ksadk/studio/api.py +810 -93
  517. ksadk/studio/api_catalog_routes.py +18 -0
  518. ksadk/studio/api_contracts.py +8 -2
  519. ksadk/studio/api_plugin_routes.py +562 -104
  520. ksadk/studio/api_resource_connections.py +221 -0
  521. ksadk/studio/authoring.py +12 -6
  522. ksadk/studio/authoring_coordinator.py +23 -16
  523. ksadk/studio/builder.py +88 -0
  524. ksadk/studio/capabilities.py +23 -6
  525. ksadk/studio/channel_connections.py +333 -0
  526. ksadk/studio/cloud.py +370 -112
  527. ksadk/studio/cloud_shared_web.py +638 -0
  528. ksadk/studio/codex_agent_service.py +130 -28
  529. ksadk/studio/codex_builder.py +242 -3
  530. ksadk/studio/codex_credentials.py +90 -0
  531. ksadk/studio/codex_manifest.py +31 -4
  532. ksadk/studio/codex_plugin_store.py +746 -0
  533. ksadk/studio/codex_provider_build.py +231 -0
  534. ksadk/studio/codex_run.py +190 -26
  535. ksadk/studio/compatibility_report.py +12 -1
  536. ksadk/studio/compiler.py +88 -14
  537. ksadk/studio/configuration.py +182 -0
  538. ksadk/studio/contracts.py +165 -11
  539. ksadk/studio/dsh_application.py +247 -0
  540. ksadk/studio/dsh_capability_service.py +1374 -0
  541. ksadk/studio/dsh_lifecycle.py +58 -0
  542. ksadk/studio/dsh_models.py +59 -0
  543. ksadk/studio/dsh_provider_registration.py +367 -21
  544. ksadk/studio/entry.py +53 -0
  545. ksadk/studio/event_store.py +36 -5
  546. ksadk/studio/execution_host.py +525 -0
  547. ksadk/studio/framework_run.py +32 -10
  548. ksadk/studio/hosted_kernel.py +89 -14
  549. ksadk/studio/kernel_registry.py +418 -0
  550. ksadk/studio/kernel_sqlite_migration.py +181 -0
  551. ksadk/studio/mcp_runtime.py +11 -3
  552. ksadk/studio/model_client.py +1180 -66
  553. ksadk/studio/model_profile_service.py +26 -11
  554. ksadk/studio/native_documents.py +172 -0
  555. ksadk/studio/plugin_composition.py +202 -24
  556. ksadk/studio/plugin_kernel_adapter.py +21 -106
  557. ksadk/studio/plugin_lifecycle.py +80 -0
  558. ksadk/studio/plugin_runtime.py +448 -56
  559. ksadk/studio/provider_recovery.py +59 -0
  560. ksadk/studio/recovery_page.py +70 -0
  561. ksadk/studio/resource_authority.py +664 -0
  562. ksadk/studio/resource_binding_validation.py +77 -0
  563. ksadk/studio/resource_build_admission.py +196 -0
  564. ksadk/studio/resource_build_materializer.py +149 -0
  565. ksadk/studio/resource_catalog.py +149 -2
  566. ksadk/studio/resource_connections.py +220 -0
  567. ksadk/studio/run_activity.py +895 -0
  568. ksadk/studio/run_documents.py +127 -0
  569. ksadk/studio/run_service.py +789 -83
  570. ksadk/studio/runtime_catalog.py +53 -10
  571. ksadk/studio/runtime_source.py +16 -8
  572. ksadk/studio/scheduler_assistant.py +317 -0
  573. ksadk/studio/scheduler_runtime.py +32 -280
  574. ksadk/studio/scheduler_service.py +3 -0
  575. ksadk/studio/service.py +861 -120
  576. ksadk/studio/shared_web.py +579 -82
  577. ksadk/studio/static/assets/ChannelsPage-D_PGmKVq.js +8 -0
  578. ksadk/studio/static/assets/CodeBlock-DMIf4h33-UIqo-BPW.js +44 -0
  579. ksadk/studio/static/assets/ExecutionTree-v3HexvPo-Bk8wzGSy.js +1 -0
  580. ksadk/studio/static/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
  581. ksadk/studio/static/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
  582. ksadk/studio/static/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
  583. ksadk/studio/static/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
  584. ksadk/studio/static/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
  585. ksadk/studio/static/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
  586. ksadk/studio/static/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
  587. ksadk/studio/static/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
  588. ksadk/studio/static/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
  589. ksadk/studio/static/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
  590. ksadk/studio/static/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
  591. ksadk/studio/static/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
  592. ksadk/studio/static/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
  593. ksadk/studio/static/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
  594. ksadk/studio/static/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
  595. ksadk/studio/static/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
  596. ksadk/studio/static/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
  597. ksadk/studio/static/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
  598. ksadk/studio/static/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
  599. ksadk/studio/static/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
  600. ksadk/studio/static/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
  601. ksadk/studio/static/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
  602. ksadk/studio/static/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
  603. ksadk/studio/static/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
  604. ksadk/studio/static/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
  605. ksadk/studio/static/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
  606. ksadk/studio/static/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
  607. ksadk/studio/static/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
  608. ksadk/studio/static/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
  609. ksadk/studio/static/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
  610. ksadk/studio/static/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
  611. ksadk/studio/static/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
  612. ksadk/studio/static/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
  613. ksadk/studio/static/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
  614. ksadk/studio/static/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
  615. ksadk/studio/static/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
  616. ksadk/studio/static/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
  617. ksadk/studio/static/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
  618. ksadk/studio/static/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
  619. ksadk/studio/static/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
  620. ksadk/studio/static/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
  621. ksadk/studio/static/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
  622. ksadk/studio/static/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
  623. ksadk/studio/static/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
  624. ksadk/studio/static/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
  625. ksadk/studio/static/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
  626. ksadk/studio/static/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
  627. ksadk/studio/static/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
  628. ksadk/studio/static/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
  629. ksadk/studio/static/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
  630. ksadk/studio/static/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
  631. ksadk/studio/static/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
  632. ksadk/studio/static/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
  633. ksadk/studio/static/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
  634. ksadk/studio/static/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
  635. ksadk/studio/static/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
  636. ksadk/studio/static/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
  637. ksadk/studio/static/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
  638. ksadk/studio/static/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
  639. ksadk/studio/static/assets/MathMessageMarkdown-BesSeCYl-BEOyPC3w.css +1 -0
  640. ksadk/studio/static/assets/MathMessageMarkdown-BesSeCYl-OhNwH4K9.js +8 -0
  641. ksadk/studio/static/assets/MermaidBlock-H_0qzQDf-BdXtxug_.js +11 -0
  642. ksadk/studio/static/assets/MessageMarkdown-CwMTvgFj-g0I-I4dD.js +59 -0
  643. ksadk/studio/static/assets/PrismRenderer-5pK6tUdb.js +3 -0
  644. ksadk/studio/static/assets/TeamsPage-DqX4HWKQ.js +3 -0
  645. ksadk/studio/static/assets/abnfDiagram-VCTEODGH-Bnb1O3tA.js +1 -0
  646. ksadk/studio/static/assets/arc-Pry-7G1_.js +1 -0
  647. ksadk/studio/static/assets/architecture-7GRP2DOG-BMOPAkUC.js +1 -0
  648. ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-5Zn1gqJv.js +36 -0
  649. ksadk/studio/static/assets/array-BifhSqXX.js +1 -0
  650. ksadk/studio/static/assets/blockDiagram-I7D4REHJ-CLB4L11u.js +129 -0
  651. ksadk/studio/static/assets/c4Diagram-7LVT6UL2-BOma_Z_F.js +38 -0
  652. ksadk/studio/static/assets/channel-r8itPEik.js +1 -0
  653. ksadk/studio/static/assets/chunk-2E4U76K2-BFf_huql.js +2 -0
  654. ksadk/studio/static/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  655. ksadk/studio/static/assets/chunk-2ZTRR5NV-C2qZJila.js +2 -0
  656. ksadk/studio/static/assets/chunk-3Z5EZCMW-DMniOlPd.js +1 -0
  657. ksadk/studio/static/assets/chunk-4HAMMTFA-DVtDP4rm.js +62 -0
  658. ksadk/studio/static/assets/chunk-5V3GS4D5-i-ZDOEnP.js +1 -0
  659. ksadk/studio/static/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
  660. ksadk/studio/static/assets/chunk-6AZGARVD-BB6FqMl-.js +1 -0
  661. ksadk/studio/static/assets/chunk-6EIED4P4-DdUJkP0f.js +1 -0
  662. ksadk/studio/static/assets/chunk-6K3QC6MW-CqVsVn-y.js +1 -0
  663. ksadk/studio/static/assets/chunk-6TQVIW2G-DKlLbNIP.js +1 -0
  664. ksadk/studio/static/assets/chunk-747NJXEK-BFkZPlab.js +2 -0
  665. ksadk/studio/static/assets/chunk-75Z2AOVW-BZNhM4vB.js +2 -0
  666. ksadk/studio/static/assets/chunk-CLGD4ZFX-D-GTtyKs.js +1 -0
  667. ksadk/studio/static/assets/chunk-DU6HZSFF-CpEZCUgg.js +128 -0
  668. ksadk/studio/static/assets/chunk-F27PBJKO-D7pvKf0C.js +1 -0
  669. ksadk/studio/static/assets/chunk-FOHPRMQF-DHwB1DNv.js +161 -0
  670. ksadk/studio/static/assets/chunk-GMAD6QVW-DE_8H717.js +72 -0
  671. ksadk/studio/static/assets/chunk-GVQU2GXP-BfEB0lNv.js +1 -0
  672. ksadk/studio/static/assets/chunk-I5DQTOEV-Hm2LfiYI.js +1 -0
  673. ksadk/studio/static/assets/chunk-ICYGCRZG-749o-pGJ.js +1 -0
  674. ksadk/studio/static/assets/chunk-IH6LHLGP-CC6I9F3i.js +1 -0
  675. ksadk/studio/static/assets/chunk-IMKFNOWR-D38axYOR.js +231 -0
  676. ksadk/studio/static/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  677. ksadk/studio/static/assets/chunk-KI3K4JFJ-Rma-0k_M.js +1 -0
  678. ksadk/studio/static/assets/chunk-L3NEJ4N5-Dq5xn7aL.js +1 -0
  679. ksadk/studio/static/assets/chunk-LNGE3PJU-DWpGwHrW.js +34 -0
  680. ksadk/studio/static/assets/chunk-OSK3NFVY-DiCQjx9b.js +10 -0
  681. ksadk/studio/static/assets/chunk-OUJLGHUK-D0j2JRSg.js +2 -0
  682. ksadk/studio/static/assets/chunk-P2QGCYS3-VdhKmfYq.js +1 -0
  683. ksadk/studio/static/assets/chunk-POPQ4Y6H-C1_rzO5M.js +1 -0
  684. ksadk/studio/static/assets/chunk-PWAF6VOD-B45HvflI.js +1 -0
  685. ksadk/studio/static/assets/chunk-SHT3W25Y-DsCFnRVE.js +168 -0
  686. ksadk/studio/static/assets/chunk-SVP7TREG-DljApgRX.js +88 -0
  687. ksadk/studio/static/assets/chunk-TICWLB2K-DWqRtyqa.js +206 -0
  688. ksadk/studio/static/assets/chunk-TLUHSLCS-DUeGgnD5.js +2 -0
  689. ksadk/studio/static/assets/chunk-UY3FDG6J-CnmaAkG5.js +1 -0
  690. ksadk/studio/static/assets/chunk-XHIXRSVI-BFQ6B8BE.js +1 -0
  691. ksadk/studio/static/assets/chunk-XXDRQBXY-DqAYeljN.js +1 -0
  692. ksadk/studio/static/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  693. ksadk/studio/static/assets/classDiagram-ZZMXUADV-DjeMNJmu.js +1 -0
  694. ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-DjeMNJmu.js +1 -0
  695. ksadk/studio/static/assets/clsx-DB0hHKMi.js +1 -0
  696. ksadk/studio/static/assets/cose-bilkent-JH36ORCC-om8AY0Mc.js +1 -0
  697. ksadk/studio/static/assets/createLucideIcon-DR0LGTP5.js +1 -0
  698. ksadk/studio/static/assets/cynefin-OW5HDTMX-7tP7QfM3.js +1 -0
  699. ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-6BrmK52S.js +62 -0
  700. ksadk/studio/static/assets/cytoscape.esm-CGd-uY3x.js +321 -0
  701. ksadk/studio/static/assets/dagre-GXQ25YYZ-buZBRlwz.js +4 -0
  702. ksadk/studio/static/assets/dagre-PrKaheQc.js +1 -0
  703. ksadk/studio/static/assets/defaultLocale-BFoDCU3G.js +1 -0
  704. ksadk/studio/static/assets/diagram-S7CK7UJ4-C6aH78c4.js +30 -0
  705. ksadk/studio/static/assets/diagram-UQ7AKVKN-DY_tQ6C_.js +41 -0
  706. ksadk/studio/static/assets/diagram-VSXAHHWV-DX9p5cQT.js +3 -0
  707. ksadk/studio/static/assets/diagram-VX7I27RA-DB2WSH8X.js +24 -0
  708. ksadk/studio/static/assets/diagram-Z3DM3KII-Ce1BJwHE.js +24 -0
  709. ksadk/studio/static/assets/dist-v5Q1xZ2K.js +1 -0
  710. ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-Daukxwqf.js +1 -0
  711. ksadk/studio/static/assets/erDiagram-RLTQ6QDP-CGthTMmJ.js +99 -0
  712. ksadk/studio/static/assets/eventmodeling-NTZA5JFV-BR2FzK4R.js +1 -0
  713. ksadk/studio/static/assets/flowDiagram-HODETNUW-CZ1tEenp.js +1 -0
  714. ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BfoAZW9X.js +292 -0
  715. ksadk/studio/static/assets/gitGraph-4MIJSDKK-DYlXv_yJ.js +1 -0
  716. ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-S985OIJF.js +106 -0
  717. ksadk/studio/static/assets/graphlib-DS17s2tU.js +1 -0
  718. ksadk/studio/static/assets/iconfont-4HN3C9Pg.woff2 +0 -0
  719. ksadk/studio/static/assets/index-CfEnms6Y.css +2 -0
  720. ksadk/studio/static/assets/index-Dp61rOWZ.js +0 -0
  721. ksadk/studio/static/assets/index.dom-BQenBtFm.js +1 -0
  722. ksadk/studio/static/assets/info-A6RAGUB7-BlU-8_xu.js +1 -0
  723. ksadk/studio/static/assets/infoDiagram-27XIBGKW-CO3W8tFn.js +2 -0
  724. ksadk/studio/static/assets/init-C-OQMol4.js +1 -0
  725. ksadk/studio/static/assets/ishikawaDiagram-5VMMS53U-BUGEl8cO.js +70 -0
  726. ksadk/studio/static/assets/journeyDiagram-3NMN7TZE-Ch2ZYxvr.js +139 -0
  727. ksadk/studio/static/assets/kanban-definition-UXKFOSKX-Da-Fp4vC.js +89 -0
  728. ksadk/studio/static/assets/katex-DhON-x74.js +257 -0
  729. ksadk/studio/static/assets/kingsoft-cloud-BOcLiQ3e.ico +0 -0
  730. ksadk/studio/static/assets/line-BDaeq300.js +1 -0
  731. ksadk/studio/static/assets/linear-DmucvK78.js +1 -0
  732. ksadk/studio/static/assets/mermaid-parser.core-Cj5mYdBi.js +4 -0
  733. ksadk/studio/static/assets/mindmap-definition-YA3MSWOX-CvlsVQ38.js +96 -0
  734. ksadk/studio/static/assets/ordinal-BDEzSJ7C.js +1 -0
  735. ksadk/studio/static/assets/packet-AYTQ26CC-BSJEH9Lb.js +1 -0
  736. ksadk/studio/static/assets/path-fybaL0A-.js +1 -0
  737. ksadk/studio/static/assets/pegDiagram-XKGWAZYB-BuHuNgT5.js +1 -0
  738. ksadk/studio/static/assets/pie-WAS4IAKB-qxv01Y8W.js +1 -0
  739. ksadk/studio/static/assets/pieDiagram-E7YTZNPT-DlrWiSOv.js +39 -0
  740. ksadk/studio/static/assets/preload-helper-CO68xz6u.js +1 -0
  741. ksadk/studio/static/assets/presentation-yYw7xK60-BmcZriri.js +1 -0
  742. ksadk/studio/static/assets/quadrantDiagram-AXDQQJYC-BA3hpUZM.js +7 -0
  743. ksadk/studio/static/assets/radar-RG4KPBEZ-B6h6pWOs.js +1 -0
  744. ksadk/studio/static/assets/railroad-74A4TZTK-CGtTWdGc.js +1 -0
  745. ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-Cq7y22IA.js +1 -0
  746. ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-V0aQVv9m.js +1 -0
  747. ksadk/studio/static/assets/railroad-peg-WCYAUIDC-BQiIsX_p.js +1 -0
  748. ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-BxpAazym.js +1 -0
  749. ksadk/studio/static/assets/requirementDiagram-BXWQKSXE-E-Ge0FcV.js +84 -0
  750. ksadk/studio/static/assets/rolldown-runtime-Dy4uBu1J-DK3Fl9T5.js +1 -0
  751. ksadk/studio/static/assets/rough.esm-Dy-Kn_BL.js +1 -0
  752. ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-CA6YKhQ3.js +40 -0
  753. ksadk/studio/static/assets/sequenceDiagram-WJ2MYXX4-CcElXGg4.js +162 -0
  754. ksadk/studio/static/assets/sizeCapture-INFHLROL-B0uUizjq.js +1 -0
  755. ksadk/studio/static/assets/src-B6xuSHsQ.js +1 -0
  756. ksadk/studio/static/assets/stateDiagram-D77RDMKH-DdXZOFqY.js +1 -0
  757. ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-CJbOM-QK.js +1 -0
  758. ksadk/studio/static/assets/swimlanes-42K2YHIH-NtgEEHLY.js +1 -0
  759. ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-D-AVlW8B.js +8 -0
  760. ksadk/studio/static/assets/timeline-definition-24CTP7MA-CIuYhNy3.js +120 -0
  761. ksadk/studio/static/assets/treeView-Q6P3EWNA-BTTYcvrF.js +1 -0
  762. ksadk/studio/static/assets/treemap-WGGIJYW6-Cg7tyfH8.js +1 -0
  763. ksadk/studio/static/assets/vennDiagram-4TSXK5OY-7HbApbrv.js +34 -0
  764. ksadk/studio/static/assets/wardley-WFR3VGLG-C6N1rULY.js +1 -0
  765. ksadk/studio/static/assets/wardleyDiagram-VM6X3IG4-CMJiaedy.js +78 -0
  766. ksadk/studio/static/assets/xychartDiagram-S5SC5T6Z-BdgtMvW2.js +7 -0
  767. ksadk/studio/static/index.html +8 -2
  768. ksadk/studio/teams_catalog.py +133 -0
  769. ksadk/studio/teams_installation.py +214 -0
  770. ksadk/studio/teams_node.py +545 -0
  771. ksadk/studio/teams_node_runner.py +69 -0
  772. ksadk/studio/teams_remote.py +274 -0
  773. ksadk/studio/templates.py +40 -19
  774. ksadk/studio/validator.py +13 -0
  775. ksadk/studio/workspace.py +19 -4
  776. ksadk/studio/workspace_plugins.py +136 -0
  777. ksadk/studio/workspace_registry.py +286 -0
  778. ksadk/toolsets/__init__.py +11 -0
  779. ksadk/toolsets/skills.py +446 -378
  780. ksadk/toolsets/workspace.py +3 -3
  781. ksadk/toolsets/workspace_identity.py +15 -0
  782. ksadk/version.py +1 -1
  783. ksadk_runtime_common/memory_backend/providers/lancedb.py +56 -2
  784. ksadk_runtime_common/schemas/memory_backend_manifest.schema.json +148 -148
  785. ksadk_runtime_common/workspace_files/router.py +26 -13
  786. agentengine_sdk_python-0.8.3.dist-info/RECORD +0 -833
  787. ksadk/server/static/assets/MathMessageMarkdown-D9uB55Oh.js +0 -8
  788. ksadk/server/static/assets/architecture-7GRP2DOG-Dk9nRQ6-.js +0 -1
  789. ksadk/server/static/assets/channel-s354Yo6o.js +0 -1
  790. ksadk/server/static/assets/chunk-2Q5K7J3B-CDpPpKR5.js +0 -1
  791. ksadk/server/static/assets/classDiagram-DTDB5LWJ-Dd0nucl9.js +0 -1
  792. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Dd0nucl9.js +0 -1
  793. ksadk/server/static/assets/cynefin-OW5HDTMX-BBlT4uMf.js +0 -1
  794. ksadk/server/static/assets/dist-DdRBIceA.js +0 -1
  795. ksadk/server/static/assets/eventmodeling-NTZA5JFV-Dr5okd8V.js +0 -1
  796. ksadk/server/static/assets/flowDiagram-A5DVABFB-VEO-cVcO.js +0 -1
  797. ksadk/server/static/assets/gitGraph-4MIJSDKK-CKiKY9Cf.js +0 -1
  798. ksadk/server/static/assets/index-B2k_urY8.js +0 -241
  799. ksadk/server/static/assets/index-ILPt6IWF.css +0 -2
  800. ksadk/server/static/assets/info-A6RAGUB7-ubA4Nm_p.js +0 -1
  801. ksadk/server/static/assets/packet-AYTQ26CC-C7R3NUlK.js +0 -1
  802. ksadk/server/static/assets/pie-WAS4IAKB-BIT6qjr3.js +0 -1
  803. ksadk/server/static/assets/radar-RG4KPBEZ-l5noef9X.js +0 -1
  804. ksadk/server/static/assets/railroad-74A4TZTK-Baea6ZvM.js +0 -1
  805. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-OKn8zZnU.js +0 -1
  806. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-DdKAKC4l.js +0 -1
  807. ksadk/server/static/assets/railroad-peg-WCYAUIDC-Bds8udlG.js +0 -1
  808. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-5b-8o2iS.js +0 -1
  809. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uf6WPRA4.js +0 -8
  810. ksadk/server/static/assets/treeView-Q6P3EWNA-CK5CSrSO.js +0 -1
  811. ksadk/server/static/assets/treemap-WGGIJYW6-Ch2BKgAM.js +0 -1
  812. ksadk/server/static/assets/wardley-WFR3VGLG-YW3Q0ml_.js +0 -1
  813. ksadk/studio/static/assets/PrismRenderer-IYN-ffww.js +0 -3
  814. ksadk/studio/static/assets/index-DXs1Eq4M.css +0 -1
  815. ksadk/studio/static/assets/index-DeDqwTsD.js +0 -283
  816. {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/WHEEL +0 -0
  817. {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/entry_points.txt +0 -0
  818. {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/licenses/LICENSE +0 -0
  819. {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/top_level.txt +0 -0
ksadk/studio/cloud.py CHANGED
@@ -3,16 +3,19 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  import hashlib
6
+ import io
6
7
  import json
7
8
  import logging
8
9
  import os
9
10
  import tempfile
11
+ import zipfile
10
12
  from collections.abc import AsyncIterator
11
13
  from dataclasses import dataclass
12
14
  from pathlib import Path
13
15
  from typing import Any, Callable, Protocol, cast
14
16
  from uuid import uuid4
15
17
 
18
+ import yaml
16
19
  from pydantic import ValidationError
17
20
 
18
21
  from ksadk.api import AgentEngineAPIError, AgentEngineClient
@@ -110,9 +113,7 @@ class CloudDeploymentGateway(Protocol):
110
113
  self, agent_id: str, *, version_id: str
111
114
  ) -> dict[str, Any]: ...
112
115
 
113
- async def get_account_agent_dashboard_access(
114
- self, agent_id: str
115
- ) -> dict[str, str | None]: ...
116
+ async def get_account_agent_dashboard_access(self, agent_id: str) -> dict[str, str | None]: ...
116
117
 
117
118
  async def delete_account_agent(self, agent_id: str) -> bool: ...
118
119
 
@@ -226,9 +227,7 @@ class UnavailableCloudGateway:
226
227
  status_code=501,
227
228
  )
228
229
 
229
- async def get_account_agent_dashboard_access(
230
- self, _agent_id: str
231
- ) -> dict[str, str | None]:
230
+ async def get_account_agent_dashboard_access(self, _agent_id: str) -> dict[str, str | None]:
232
231
  raise StudioError(
233
232
  "CLOUD_DASHBOARD_UNAVAILABLE",
234
233
  "当前未配置可用的云端签名账号,不能打开云端 Agent UI",
@@ -383,9 +382,7 @@ class InMemoryCloudGateway:
383
382
  "noop": False,
384
383
  }
385
384
 
386
- async def get_account_agent_dashboard_access(
387
- self, agent_id: str
388
- ) -> dict[str, str | None]:
385
+ async def get_account_agent_dashboard_access(self, agent_id: str) -> dict[str, str | None]:
389
386
  return {
390
387
  "access_url": f"memory://dashboard/{agent_id}",
391
388
  "agent_id": agent_id,
@@ -450,6 +447,7 @@ class DirectAgentEngineCloudDeploymentGateway:
450
447
  region: str,
451
448
  client: Any | None = None,
452
449
  stream_client: Any | None = None,
450
+ managed_runtime_client: Any | None = None,
453
451
  uploader_factory: Callable[..., Any] = KS3Uploader,
454
452
  bucket: str | None = None,
455
453
  ks3_credentials: dict[str, str] | None = None,
@@ -488,8 +486,37 @@ class DirectAgentEngineCloudDeploymentGateway:
488
486
  # complete response body even when RunAgent returns SSE; both clients
489
487
  # still use the same process-only V4 credentials and Server admission.
490
488
  self.stream_client = stream_client or self.client
489
+ # Native ManagedRuntime and plugin-delivery actions may be available
490
+ # on Server before KOP publishes their Action names. Studio composes
491
+ # this client explicitly from its environment instead of inferring the
492
+ # deployment environment from the physical Region selected in UI.
493
+ self._native_runtime_client = managed_runtime_client
491
494
  self._bundles: dict[str, dict[str, str]] = {}
492
495
 
496
+ def _managed_runtime_client(self) -> Any:
497
+ """Use the deployed Server ingress for pre-online native runtime actions.
498
+
499
+ KOP remains the ordinary control-plane entry point. Pre-online may
500
+ publish a new ManagedRuntime or plugin-delivery action against a
501
+ different Server revision, while Studio's dedicated Server client is
502
+ already V4-signed and points at the deployment being validated.
503
+ """
504
+
505
+ if self._native_runtime_client is not None:
506
+ return self._native_runtime_client
507
+ if self.region.lower() == "pre-online":
508
+ return self.stream_client
509
+ return self.client
510
+
511
+ def cached_identity(self) -> dict[str, str] | None:
512
+ """Read the SDK's per-AK identity cache without making an IAM request."""
513
+ from ksadk.identity import get_cached_identity
514
+
515
+ identity = get_cached_identity(self._ks3_credentials["access_key"])
516
+ if not identity or not identity.user_uuid or not identity.user_name:
517
+ return None
518
+ return {"userName": identity.user_name, "userId": identity.user_uuid}
519
+
493
520
  async def upload_bundle(self, **kwargs) -> str:
494
521
  bundle = bytes(kwargs["bundle"])
495
522
  provenance = dict(kwargs["provenance"])
@@ -510,7 +537,12 @@ class DirectAgentEngineCloudDeploymentGateway:
510
537
  status_code=422,
511
538
  )
512
539
  object_key = f"studio-bundles/{_safe_object_component(agent_id)}/{archive_sha}/bundle.zip"
513
- uploader = self.uploader_factory(region=self.ks3_region, bucket=self.bucket)
540
+ uploader = self.uploader_factory(
541
+ region=self.ks3_region,
542
+ bucket=self.bucket,
543
+ access_key=self._ks3_credentials["access_key"],
544
+ secret_key=self._ks3_credentials["secret_key"],
545
+ )
514
546
  local_path: Path | None = None
515
547
  try:
516
548
  with tempfile.NamedTemporaryFile(
@@ -741,9 +773,7 @@ class DirectAgentEngineCloudDeploymentGateway:
741
773
  return False
742
774
 
743
775
  @classmethod
744
- def _cloud_chat_route(
745
- cls, *, runtime_type: str, capabilities: Any
746
- ) -> tuple[str, str]:
776
+ def _cloud_chat_route(cls, *, runtime_type: str, capabilities: Any) -> tuple[str, str]:
747
777
  if cls._session_event_chat_declared(capabilities):
748
778
  return (
749
779
  "studio-session-events",
@@ -767,9 +797,7 @@ class DirectAgentEngineCloudDeploymentGateway:
767
797
  else {}
768
798
  )
769
799
  deployment = (
770
- payload.get("deployment")
771
- if isinstance(payload.get("deployment"), dict)
772
- else {}
800
+ payload.get("deployment") if isinstance(payload.get("deployment"), dict) else {}
773
801
  )
774
802
  runtime_config = (
775
803
  deployment.get("runtime_config")
@@ -801,21 +829,24 @@ class DirectAgentEngineCloudDeploymentGateway:
801
829
  return None
802
830
 
803
831
  agent_id = str(
804
- first("agent_id", "agentId", "agent_runtime_id", "agentRuntimeId", "id")
805
- or fallback_id
832
+ first("agent_id", "agentId", "agent_runtime_id", "agentRuntimeId", "id") or fallback_id
806
833
  ).strip()
807
- runtime_type = str(
808
- first(
809
- "framework",
810
- "runtime_kind",
811
- "runtimeKind",
812
- "runtime_type",
813
- "runtimeType",
814
- "runtime_name",
815
- "runtimeName",
816
- )
817
- or ""
818
- ).strip().lower()
834
+ runtime_type = (
835
+ str(
836
+ first(
837
+ "framework",
838
+ "runtime_kind",
839
+ "runtimeKind",
840
+ "runtime_type",
841
+ "runtimeType",
842
+ "runtime_name",
843
+ "runtimeName",
844
+ )
845
+ or ""
846
+ )
847
+ .strip()
848
+ .lower()
849
+ )
819
850
  capabilities = first("capabilities", "Capabilities")
820
851
  chat_transport, chat_routing_reason = (
821
852
  DirectAgentEngineCloudDeploymentGateway._cloud_chat_route(
@@ -824,11 +855,14 @@ class DirectAgentEngineCloudDeploymentGateway:
824
855
  )
825
856
  )
826
857
  version_id = str(first("version_id", "versionId", "revision") or "").strip()
827
- manifest_sha256 = str(
828
- runtime_config.get("manifest_sha256")
829
- or runtime_config.get("manifestSha256")
830
- or ""
831
- ).strip().lower()
858
+ manifest_sha256 = (
859
+ str(runtime_config.get("manifest_sha256") or runtime_config.get("manifestSha256") or "")
860
+ .strip()
861
+ .lower()
862
+ )
863
+ kernel_ready_value = first("agent_kernel_ready", "agentKernelReady")
864
+ kernel_report_value = first("agent_kernel_runtime", "agentKernelRuntime")
865
+ kernel_report = kernel_report_value if isinstance(kernel_report_value, dict) else {}
832
866
  if not version_id and len(manifest_sha256) == 64:
833
867
  try:
834
868
  bytes.fromhex(manifest_sha256)
@@ -860,7 +894,8 @@ class DirectAgentEngineCloudDeploymentGateway:
860
894
  or quick_access.get("privateEndpoint")
861
895
  or lifecycle_first("endpoint")
862
896
  or ""
863
- ).strip() or None,
897
+ ).strip()
898
+ or None,
864
899
  "framework": runtime_type or None,
865
900
  "runtimeType": runtime_type or None,
866
901
  "capabilities": capabilities if isinstance(capabilities, dict) else None,
@@ -873,21 +908,26 @@ class DirectAgentEngineCloudDeploymentGateway:
873
908
  lifecycle_first("updated_at", "updatedAt", "update_time", "updateTime") or ""
874
909
  ).strip()
875
910
  or None,
911
+ # Keep cloud lifecycle and AgentKernel readiness separate. A Pod
912
+ # can be RUNNING while control admission still rejects chat; these
913
+ # fields let Studio explain that state without exposing credentials
914
+ # or the full Server deployment record.
915
+ "kernelReady": (kernel_ready_value if isinstance(kernel_ready_value, bool) else None),
916
+ "deploymentPhase": str(first("deployment_phase", "deploymentPhase") or "").strip()
917
+ or None,
918
+ "statusMessage": str(first("message", "Message") or "").strip() or None,
919
+ "kernelReason": str(kernel_report.get("reason") or "").strip() or None,
920
+ "kernelObservedAt": str(
921
+ kernel_report.get("observed_at") or kernel_report.get("observedAt") or ""
922
+ ).strip()
923
+ or None,
876
924
  }
877
925
 
878
926
  async def list_account_agents(self, *, page: int, size: int) -> dict[str, Any]:
879
927
  payload = await self.client.list_agents(page=page, page_size=size)
880
928
  raw_items = payload.get("agents") or payload.get("Agents") or []
881
- items = [
882
- self._account_agent_view(item)
883
- for item in raw_items
884
- if isinstance(item, dict)
885
- ]
886
- items = [
887
- item
888
- for item in items
889
- if item["agentId"] and item["status"] != "DELETED"
890
- ]
929
+ items = [self._account_agent_view(item) for item in raw_items if isinstance(item, dict)]
930
+ items = [item for item in items if item["agentId"] and item["status"] != "DELETED"]
891
931
  return {
892
932
  "items": items,
893
933
  "total": len(items),
@@ -912,9 +952,7 @@ class DirectAgentEngineCloudDeploymentGateway:
912
952
 
913
953
  return {
914
954
  "versionId": str(first("version_id", "VersionId", default="") or "").strip(),
915
- "versionName": str(
916
- first("version_name", "VersionName", default="") or ""
917
- ).strip(),
955
+ "versionName": str(first("version_name", "VersionName", default="") or "").strip(),
918
956
  "tag": str(first("tag", "Tag", default="") or "").strip(),
919
957
  "status": str(first("status", "Status", default="") or "").strip(),
920
958
  "trafficPercentage": int(
@@ -929,8 +967,7 @@ class DirectAgentEngineCloudDeploymentGateway:
929
967
  )
930
968
  or ""
931
969
  ).strip(),
932
- "createdAt": str(first("created_at", "CreatedAt", default="") or "").strip()
933
- or None,
970
+ "createdAt": str(first("created_at", "CreatedAt", default="") or "").strip() or None,
934
971
  "createdBy": str(first("created_by", "CreatedBy", default="") or "").strip(),
935
972
  }
936
973
 
@@ -958,9 +995,7 @@ class DirectAgentEngineCloudDeploymentGateway:
958
995
  ) from exc
959
996
  raw_items = payload.get("versions") or payload.get("Versions") or []
960
997
  items = [
961
- self._account_agent_version_view(item)
962
- for item in raw_items
963
- if isinstance(item, dict)
998
+ self._account_agent_version_view(item) for item in raw_items if isinstance(item, dict)
964
999
  ]
965
1000
  items = [item for item in items if item["versionId"]]
966
1001
  current = next(
@@ -973,11 +1008,7 @@ class DirectAgentEngineCloudDeploymentGateway:
973
1008
  )
974
1009
  return {
975
1010
  "items": items,
976
- "total": int(
977
- payload.get("total_count")
978
- or payload.get("TotalCount")
979
- or len(items)
980
- ),
1011
+ "total": int(payload.get("total_count") or payload.get("TotalCount") or len(items)),
981
1012
  "currentVersionId": current,
982
1013
  }
983
1014
 
@@ -1016,16 +1047,12 @@ class DirectAgentEngineCloudDeploymentGateway:
1016
1047
  ) from exc
1017
1048
  return {
1018
1049
  "agentId": str(payload.get("agent_id") or normalized_id),
1019
- "targetVersionId": str(
1020
- payload.get("target_version_id") or normalized_version_id
1021
- ),
1050
+ "targetVersionId": str(payload.get("target_version_id") or normalized_version_id),
1022
1051
  "status": str(payload.get("status") or "UPDATING"),
1023
1052
  "noop": bool(payload.get("noop")),
1024
1053
  }
1025
1054
 
1026
- async def get_account_agent_dashboard_access(
1027
- self, agent_id: str
1028
- ) -> dict[str, str | None]:
1055
+ async def get_account_agent_dashboard_access(self, agent_id: str) -> dict[str, str | None]:
1029
1056
  detail = await self.get_account_agent(agent_id)
1030
1057
  path = (
1031
1058
  _NATIVE_DASHBOARD_UI_PATH
@@ -1067,9 +1094,7 @@ class DirectAgentEngineCloudDeploymentGateway:
1067
1094
  )
1068
1095
  return True
1069
1096
 
1070
- def _chat_agent_id(
1071
- self, deployment: DeploymentRecord | AccountCloudAgentReference
1072
- ) -> str:
1097
+ def _chat_agent_id(self, deployment: DeploymentRecord | AccountCloudAgentReference) -> str:
1073
1098
  """Bind local cloud chat to an immutable Studio deployment receipt.
1074
1099
 
1075
1100
  In particular, the browser cannot provide an arbitrary AgentId and
@@ -1109,6 +1134,7 @@ class DirectAgentEngineCloudDeploymentGateway:
1109
1134
  *,
1110
1135
  session_id: str,
1111
1136
  after_seq_id: int | None = None,
1137
+ before_seq_id: int | None = None,
1112
1138
  limit: int = 100,
1113
1139
  ) -> dict[str, Any]:
1114
1140
  """Return the Server/Runtime message projection for a bound session."""
@@ -1118,6 +1144,7 @@ class DirectAgentEngineCloudDeploymentGateway:
1118
1144
  agent_id=self._chat_agent_id(deployment),
1119
1145
  session_id=session_id,
1120
1146
  after_seq_id=after_seq_id,
1147
+ before_seq_id=before_seq_id,
1121
1148
  limit=limit,
1122
1149
  )
1123
1150
  except AgentEngineAPIError as exc:
@@ -1242,14 +1269,10 @@ class DirectAgentEngineCloudDeploymentGateway:
1242
1269
  },
1243
1270
  ) from exc
1244
1271
 
1245
- async def list_deployment_chat_models(
1246
- self, deployment: DeploymentRecord
1247
- ) -> dict[str, Any]:
1272
+ async def list_deployment_chat_models(self, deployment: DeploymentRecord) -> dict[str, Any]:
1248
1273
  """Read the Server-authoritative model catalog for this Agent."""
1249
1274
 
1250
- return await self.client.list_agent_models(
1251
- agent_id=self._chat_agent_id(deployment)
1252
- )
1275
+ return await self.client.list_agent_models(agent_id=self._chat_agent_id(deployment))
1253
1276
 
1254
1277
  async def submit_deployment_chat_interaction(
1255
1278
  self,
@@ -1264,32 +1287,136 @@ class DirectAgentEngineCloudDeploymentGateway:
1264
1287
  idempotency_key: str,
1265
1288
  ) -> dict[str, Any]:
1266
1289
  """Forward only Interaction/v1's caller-visible response fields."""
1290
+ try:
1291
+ # Match the transport used by the active cloud run. Pre-online
1292
+ # uses the private Server ingress because its public KOP action
1293
+ # catalog can lag the Server revision; production remains on the
1294
+ # account-scoped KOP client. Both are AgentEngineClient instances
1295
+ # and therefore reuse the same AWS V4 and verified IAM identity
1296
+ # header construction.
1297
+ return await self.stream_client.submit_interaction(
1298
+ agent_id=self._chat_agent_id(deployment),
1299
+ session_id=session_id,
1300
+ run_id=run_id,
1301
+ interaction_id=interaction_id,
1302
+ expected_revision=expected_revision,
1303
+ action=action,
1304
+ response=response,
1305
+ idempotency_key=idempotency_key,
1306
+ )
1307
+ except AgentEngineAPIError as exc:
1308
+ logger.warning(
1309
+ "cloud interaction submit rejected: agent=%s session=%s run=%s "
1310
+ "interaction=%s revision=%s action=%s reason=%s",
1311
+ self._chat_agent_id(deployment),
1312
+ session_id,
1313
+ run_id,
1314
+ interaction_id,
1315
+ expected_revision,
1316
+ action,
1317
+ AgentEngineClient._safe_log_error_summary(
1318
+ details={"code": exc.raw_code, "message": exc.message}
1319
+ ),
1320
+ )
1321
+ raise StudioError(
1322
+ "CLOUD_INTERACTION_SUBMIT_FAILED",
1323
+ exc.message,
1324
+ status_code=502,
1325
+ details={
1326
+ "serverCode": exc.raw_code,
1327
+ **{
1328
+ key: value
1329
+ for key, value in exc.details.items()
1330
+ if key in {"request_id", "action", "http_status"}
1331
+ },
1332
+ },
1333
+ ) from exc
1267
1334
 
1268
- return await self.client.submit_interaction(
1269
- agent_id=self._chat_agent_id(deployment),
1270
- session_id=session_id,
1271
- run_id=run_id,
1272
- interaction_id=interaction_id,
1273
- expected_revision=expected_revision,
1274
- action=action,
1275
- response=response,
1276
- idempotency_key=idempotency_key,
1335
+ async def prepare_plugin_delivery(
1336
+ self, workspace: Workspace, build_id: str, manifest: str, runtime_version: str
1337
+ ) -> list[dict[str, Any]]:
1338
+ from ksadk.plugins.delivery import PluginDelivery
1339
+ from ksadk.studio.codex_builder import CodexStudioBuilder
1340
+
1341
+ builder = CodexStudioBuilder(workspace)
1342
+ build = builder.repository.get(build_id)
1343
+ if (
1344
+ build.runtime_version != runtime_version
1345
+ or build.manifest_sha256 != hashlib.sha256(manifest.encode()).hexdigest()
1346
+ ):
1347
+ raise StudioError(
1348
+ "PLUGIN_BUILD_MISMATCH", "部署声明与冻结 Build 不一致", status_code=409
1349
+ )
1350
+ receipt, archive = builder.export_plugin_artifact(build_id)
1351
+ object_key = f"plugin-artifacts/v1/{receipt.artifact_digest[7:]}.zip"
1352
+ uploader = self.uploader_factory(
1353
+ region=self.ks3_region,
1354
+ bucket=self.bucket,
1355
+ access_key=self._ks3_credentials["access_key"],
1356
+ secret_key=self._ks3_credentials["secret_key"],
1357
+ public_read=False,
1358
+ )
1359
+ artifact_path = await uploader.upload(archive, object_key)
1360
+ if not artifact_path:
1361
+ raise StudioError(
1362
+ "PLUGIN_UPLOAD_FAILED",
1363
+ "插件归档上传到 Agent 代码包 KS3 桶失败",
1364
+ status_code=502,
1365
+ )
1366
+ pinned = build.plugin_marketplace
1367
+ delivery = PluginDelivery(
1368
+ artifact_path=str(artifact_path),
1369
+ storage_region=self.ks3_region,
1370
+ receipt=receipt,
1371
+ build_id=build_id,
1372
+ manifest_sha256=build.manifest_sha256,
1373
+ marketplace_name=pinned.marketplace_name,
1374
+ plugin_names=list(pinned.plugin_names),
1375
+ snapshot_digest=pinned.marketplace_digest,
1376
+ bindings=[
1377
+ b
1378
+ for b in yaml.safe_load(manifest).get("plugins", [])
1379
+ if b.get("enabled", True) and b.get("ecosystem") == "codex"
1380
+ ],
1277
1381
  )
1382
+ delivery.validate_manifest(yaml.safe_load(manifest))
1383
+ return [delivery.model_dump()]
1278
1384
 
1279
1385
  async def create_managed_runtime_deployment(self, **kwargs) -> DeploymentRecord:
1280
1386
  request: DeploymentRequest = kwargs["request"]
1281
1387
  digest = str(kwargs["manifest_digest"])
1282
1388
  runtime_environment = dict(kwargs.get("runtime_environment") or {})
1283
- result = await self.client.create_agent(
1284
- self._managed_runtime_payload(
1285
- agent_name=str(kwargs["agent_name"]),
1286
- manifest=str(kwargs["manifest"]),
1287
- runtime_name=str(kwargs["runtime_name"]),
1288
- runtime_version=str(kwargs["runtime_version"]),
1289
- request=request,
1290
- runtime_environment=runtime_environment,
1291
- )
1389
+ payload = self._managed_runtime_payload(
1390
+ agent_name=str(kwargs["agent_name"]),
1391
+ manifest=str(kwargs["manifest"]),
1392
+ runtime_name=str(kwargs["runtime_name"]),
1393
+ runtime_version=str(kwargs["runtime_version"]),
1394
+ request=request,
1395
+ runtime_environment=runtime_environment,
1396
+ plugin_artifacts=kwargs.get("plugin_artifacts"),
1292
1397
  )
1398
+ try:
1399
+ result = await self._managed_runtime_client().create_agent(payload)
1400
+ except AgentEngineAPIError as error:
1401
+ message = str(error)
1402
+ if error.code in {400, 404} and (
1403
+ "资源不存在" in message or "not found in catalog" in message.lower()
1404
+ ):
1405
+ runtime = f"{kwargs['runtime_name']}@{kwargs['runtime_version']}"
1406
+ request_id = str(error.details.get("request_id") or "")
1407
+ raise StudioError(
1408
+ "CLOUD_RUNTIME_RESOURCE_UNAVAILABLE",
1409
+ f"云端创建 {runtime} 失败:{message} 请核对当前云环境的运行时版本和镜像登记。"
1410
+ + (f" 请求 ID:{request_id}" if request_id else ""),
1411
+ status_code=error.code,
1412
+ details={
1413
+ **error.details,
1414
+ "buildId": kwargs["build_id"],
1415
+ "runtimeName": kwargs["runtime_name"],
1416
+ "runtimeVersion": kwargs["runtime_version"],
1417
+ },
1418
+ ) from error
1419
+ raise
1293
1420
  agent_id = str(result.get("agent_id") or "").strip()
1294
1421
  if not agent_id:
1295
1422
  raise StudioError(
@@ -1334,12 +1461,16 @@ class DirectAgentEngineCloudDeploymentGateway:
1334
1461
  "manifest": str(kwargs["manifest"]),
1335
1462
  },
1336
1463
  }
1464
+ if kwargs.get("plugin_artifacts"):
1465
+ update_payload["managed_runtime_config"]["plugin_artifacts"] = kwargs[
1466
+ "plugin_artifacts"
1467
+ ]
1337
1468
  if runtime_environment:
1338
1469
  # A changed MCP/model binding can introduce a new credential ref.
1339
1470
  # Re-resolve it for every immutable revision instead of relying on
1340
1471
  # the environment captured by the first CreateAgent call.
1341
1472
  update_payload["environment_variables"] = runtime_environment
1342
- await self.client.update_agent(
1473
+ await self._managed_runtime_client().update_agent(
1343
1474
  deployment.agent_id,
1344
1475
  update_payload,
1345
1476
  )
@@ -1398,6 +1529,7 @@ class DirectAgentEngineCloudDeploymentGateway:
1398
1529
  runtime_version: str,
1399
1530
  request: DeploymentRequest,
1400
1531
  runtime_environment: dict[str, str] | None = None,
1532
+ plugin_artifacts: list[dict[str, Any]] | None = None,
1401
1533
  ) -> dict[str, Any]:
1402
1534
  payload = {
1403
1535
  "name": _server_agent_name(agent_name),
@@ -1420,6 +1552,8 @@ class DirectAgentEngineCloudDeploymentGateway:
1420
1552
  "scaling": {"min_replicas": 1, "max_replicas": 1, "concurrency": 20},
1421
1553
  "auth_type": "ApiKey",
1422
1554
  }
1555
+ if plugin_artifacts:
1556
+ payload["managed_runtime_config"]["plugin_artifacts"] = plugin_artifacts
1423
1557
  if runtime_environment:
1424
1558
  # Model credentials are resolved only for this in-memory deployment
1425
1559
  # request. They are never written into the YAML build or local
@@ -1527,6 +1661,28 @@ class CloudDeploymentService:
1527
1661
  status_code=409,
1528
1662
  details={"deploymentId": replacing.id},
1529
1663
  )
1664
+ plugin_artifacts = None
1665
+ if runtime_name == "codex":
1666
+ declaration = yaml.safe_load(manifest) or {}
1667
+ bindings = [
1668
+ b
1669
+ for b in declaration.get("plugins", [])
1670
+ if (
1671
+ not isinstance(b, dict)
1672
+ or (b.get("enabled", True) and b.get("ecosystem") == "codex")
1673
+ )
1674
+ ]
1675
+ if bindings:
1676
+ prepare = getattr(self.gateway, "prepare_plugin_delivery", None)
1677
+ if prepare is None:
1678
+ raise StudioError(
1679
+ "NATIVE_PLUGIN_DELIVERY_UNAVAILABLE",
1680
+ "云端尚未声明插件交付能力",
1681
+ status_code=409,
1682
+ )
1683
+ plugin_artifacts = await prepare(
1684
+ self.workspace, build_id, manifest, runtime_version
1685
+ )
1530
1686
  if replacing is None:
1531
1687
  record = await self.gateway.create_managed_runtime_deployment(
1532
1688
  build_id=build_id,
@@ -1537,18 +1693,45 @@ class CloudDeploymentService:
1537
1693
  manifest_digest=manifest_digest,
1538
1694
  request=request,
1539
1695
  runtime_environment=runtime_environment,
1696
+ plugin_artifacts=plugin_artifacts,
1540
1697
  )
1541
1698
  else:
1542
- record = await self.gateway.replace_managed_runtime_deployment(
1543
- replacing,
1544
- build_id=build_id,
1545
- manifest=manifest,
1546
- runtime_name=runtime_name,
1547
- runtime_version=runtime_version,
1548
- manifest_digest=manifest_digest,
1549
- request=request,
1550
- runtime_environment=runtime_environment,
1551
- )
1699
+ try:
1700
+ record = await self.gateway.replace_managed_runtime_deployment(
1701
+ replacing,
1702
+ build_id=build_id,
1703
+ manifest=manifest,
1704
+ runtime_name=runtime_name,
1705
+ runtime_version=runtime_version,
1706
+ manifest_digest=manifest_digest,
1707
+ request=request,
1708
+ runtime_environment=runtime_environment,
1709
+ plugin_artifacts=plugin_artifacts,
1710
+ )
1711
+ except (AgentEngineAPIError, StudioError) as error:
1712
+ status_code = (
1713
+ error.status_code
1714
+ if isinstance(error, StudioError)
1715
+ else error.details.get("http_status", error.code)
1716
+ )
1717
+ if status_code != 404:
1718
+ raise
1719
+ # Local receipts may outlive an Agent removed through the
1720
+ # console or another client. The authoritative 404 means this
1721
+ # is a fresh create, while all other update failures remain
1722
+ # fail-closed to avoid duplicate Agents.
1723
+ record = await self.gateway.create_managed_runtime_deployment(
1724
+ build_id=build_id,
1725
+ agent_name=agent_name,
1726
+ manifest=manifest,
1727
+ runtime_name=runtime_name,
1728
+ runtime_version=runtime_version,
1729
+ manifest_digest=manifest_digest,
1730
+ request=request,
1731
+ runtime_environment=runtime_environment,
1732
+ plugin_artifacts=plugin_artifacts,
1733
+ )
1734
+ record = self._capture_creator(record, replacing)
1552
1735
  self._save(record, request)
1553
1736
  return record
1554
1737
 
@@ -1586,9 +1769,30 @@ class CloudDeploymentService:
1586
1769
  bundle_digest=build.bundle_digest,
1587
1770
  request=request,
1588
1771
  )
1772
+ record = self._capture_creator(record, replacing)
1589
1773
  self._save(record, request)
1590
1774
  return record
1591
1775
 
1776
+ def cached_identity(self) -> dict[str, str] | None:
1777
+ reader = getattr(self.gateway, "cached_identity", None)
1778
+ return reader() if reader else None
1779
+
1780
+ def _capture_creator(
1781
+ self, record: DeploymentRecord, replacing: DeploymentRecord | None
1782
+ ) -> DeploymentRecord:
1783
+ if replacing is not None:
1784
+ return record.model_copy(update={
1785
+ "created_by_name": replacing.created_by_name,
1786
+ "created_by_user_id": replacing.created_by_user_id,
1787
+ })
1788
+ identity = self.cached_identity()
1789
+ if not identity:
1790
+ return record
1791
+ return record.model_copy(update={
1792
+ "created_by_name": identity["userName"],
1793
+ "created_by_user_id": identity["userId"],
1794
+ })
1795
+
1592
1796
  def _prepared_build(self, build_id: str) -> tuple[BuildRecord, bytes, dict[str, Any]]:
1593
1797
  build = self.build_repository.get(build_id)
1594
1798
  if build.status != BuildStatus.SUCCEEDED or not build.artifact_path:
@@ -1599,6 +1803,7 @@ class CloudDeploymentService:
1599
1803
  )
1600
1804
  archive = self.workspace.resolve(build.artifact_path, must_exist=True)
1601
1805
  bundle = archive.read_bytes()
1806
+ self._reject_local_only_materializers(bundle, artifact_name=archive.name)
1602
1807
  checked_bundle = (
1603
1808
  preflight_hosted_kernel_bundle(bundle)
1604
1809
  if getattr(self.gateway, "requires_hosted_kernel_bundle_preflight", False)
@@ -1637,6 +1842,63 @@ class CloudDeploymentService:
1637
1842
  provenance["runtimeType"] = str(manifest.get("runtimeType") or build.runtime_type)
1638
1843
  return build, bundle, provenance
1639
1844
 
1845
+ @staticmethod
1846
+ def _reject_local_only_materializers(
1847
+ bundle_bytes: bytes,
1848
+ *,
1849
+ artifact_name: str,
1850
+ ) -> None:
1851
+ """Check the exact bytes that will be uploaded for local-only materializers."""
1852
+
1853
+ try:
1854
+ with zipfile.ZipFile(io.BytesIO(bundle_bytes)) as bundle:
1855
+
1856
+ def load_optional(name: str) -> dict[str, Any]:
1857
+ try:
1858
+ info = bundle.getinfo(name)
1859
+ except KeyError:
1860
+ return {}
1861
+ if info.file_size > 8 * 1024 * 1024:
1862
+ raise ValueError(f"{name} is too large")
1863
+ payload = json.loads(bundle.read(info).decode("utf-8"))
1864
+ if not isinstance(payload, dict):
1865
+ raise ValueError(f"{name} must be an object")
1866
+ return payload
1867
+
1868
+ composition = load_optional("composition-profile.json")
1869
+ resolved = load_optional("resolved-agent-spec.json")
1870
+ except (
1871
+ OSError,
1872
+ UnicodeError,
1873
+ ValueError,
1874
+ zipfile.BadZipFile,
1875
+ json.JSONDecodeError,
1876
+ ) as error:
1877
+ raise StudioError(
1878
+ "BUILD_ARTIFACT_INVALID",
1879
+ "部署前无法验证 Bundle 的本地运行时依赖",
1880
+ status_code=422,
1881
+ details={"buildArtifact": artifact_name},
1882
+ ) from error
1883
+
1884
+ dynamic_ref = any(
1885
+ isinstance(item, dict)
1886
+ and str(item.get("ref") or "").startswith("plugin://io.ksadk.mcp.dsh-profile@")
1887
+ for item in composition.get("capabilities", [])
1888
+ )
1889
+ resolved_capabilities = resolved.get("capabilities")
1890
+ dynamic_server = isinstance(resolved_capabilities, dict) and any(
1891
+ isinstance(item, dict) and item.get("materialization") == "dsh-profile"
1892
+ for item in resolved_capabilities.get("mcpServers", [])
1893
+ )
1894
+ if dynamic_ref or dynamic_server:
1895
+ raise StudioError(
1896
+ "DSH_MCP_DEPLOYMENT_UNSUPPORTED",
1897
+ "DSH Profile MCP 当前只能由本地 Studio 按 activation 物化,尚不能部署到云端",
1898
+ status_code=422,
1899
+ details={"materialization": "dsh-profile"},
1900
+ )
1901
+
1640
1902
  def get(self, deployment_id: str) -> DeploymentRecord:
1641
1903
  path = self.workspace.resolve(Path(".agentkit/deployments") / f"{deployment_id}.json")
1642
1904
  if not path.is_file():
@@ -1751,9 +2013,7 @@ class CloudDeploymentService:
1751
2013
  )
1752
2014
  await deleter(deployment)
1753
2015
 
1754
- deleted_receipts = self._delete_receipts_for_agent(
1755
- agent_id, required=deployment
1756
- )
2016
+ deleted_receipts = self._delete_receipts_for_agent(agent_id, required=deployment)
1757
2017
  return {"agentId": agent_id, "deletedReceiptIds": deleted_receipts}
1758
2018
 
1759
2019
  def _delete_receipts_for_agent(
@@ -1818,9 +2078,7 @@ class CloudDeploymentService:
1818
2078
  )
1819
2079
  return await rollback(agent_id, version_id=version_id)
1820
2080
 
1821
- async def account_agent_dashboard_access(
1822
- self, agent_id: str
1823
- ) -> dict[str, str | None]:
2081
+ async def account_agent_dashboard_access(self, agent_id: str) -> dict[str, str | None]:
1824
2082
  reader = getattr(self.gateway, "get_account_agent_dashboard_access", None)
1825
2083
  if reader is None:
1826
2084
  raise StudioError(
@@ -1844,9 +2102,7 @@ class CloudDeploymentService:
1844
2102
  "deletedReceiptIds": self._delete_receipts_for_agent(agent_id),
1845
2103
  }
1846
2104
 
1847
- async def _chat_target(
1848
- self, target_id: str
1849
- ) -> DeploymentRecord | AccountCloudAgentReference:
2105
+ async def _chat_target(self, target_id: str) -> DeploymentRecord | AccountCloudAgentReference:
1850
2106
  if not target_id.startswith("account:"):
1851
2107
  return self.get(target_id)
1852
2108
  agent_id = target_id.removeprefix("account:").strip()
@@ -1901,6 +2157,7 @@ class CloudDeploymentService:
1901
2157
  *,
1902
2158
  session_id: str,
1903
2159
  after_seq_id: int | None = None,
2160
+ before_seq_id: int | None = None,
1904
2161
  limit: int = 100,
1905
2162
  ) -> dict[str, Any]:
1906
2163
  deployment = await self._chat_target(deployment_id)
@@ -1915,6 +2172,7 @@ class CloudDeploymentService:
1915
2172
  deployment,
1916
2173
  session_id=session_id,
1917
2174
  after_seq_id=after_seq_id,
2175
+ before_seq_id=before_seq_id,
1918
2176
  limit=limit,
1919
2177
  )
1920
2178