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
@@ -18,8 +18,14 @@ from ksadk.conversations.contracts import (
18
18
  ConversationTextPart,
19
19
  validate_conversation_input,
20
20
  )
21
+ from ksadk.conversations.message_projection import project_session_messages
22
+ from ksadk.events.canonical import parse_runtime_event
23
+ from ksadk.events.canonical_store import session_event_to_runtime_event
24
+ from ksadk.sessions.base import Session
21
25
  from ksadk.studio.contracts import OperationStatus, RunRecord, RunStatus
22
26
  from ksadk.studio.errors import StudioError, not_found
27
+ from ksadk.studio.run_documents import link_run_documents
28
+ from ksadk.studio.run_service import project_runtime_event
23
29
  from ksadk.studio.service import StudioService
24
30
  from ksadk.tools.gateway import tool_approval_capability
25
31
 
@@ -62,6 +68,12 @@ class StudioSharedWebBridge:
62
68
  "ApiFormats": ["responses"],
63
69
  "Model": model,
64
70
  "Capabilities": {
71
+ "ConversationPresentation": {
72
+ "Timeline": "compact"
73
+ if self.studio.agent_runtime_type(agent_id) == "harness"
74
+ else "standard",
75
+ },
76
+ "RuntimePrewarm": self.studio.agent_runtime_type(agent_id) == "harness",
65
77
  "HostedChat": {
66
78
  "Enabled": True,
67
79
  "ApiFormats": ["responses"],
@@ -89,10 +101,12 @@ class StudioSharedWebBridge:
89
101
  "CheckpointResumePreview": False,
90
102
  },
91
103
  "ApprovalPolicy": tool_approval_capability(),
104
+ "InteractionV1": True,
92
105
  "WorkspaceFiles": {"Enabled": False},
93
106
  "NativeDashboard": {"Enabled": False},
94
107
  "NativeTerminal": {"Enabled": False},
95
108
  "Thinking": False,
109
+ "ContextCompaction": self.studio.is_codex_agent(agent_id),
96
110
  },
97
111
  }
98
112
 
@@ -110,14 +124,14 @@ class StudioSharedWebBridge:
110
124
 
111
125
  return self._select_model(agent_id, str(requested or ""))
112
126
 
113
- def list_sessions(
127
+ async def list_sessions(
114
128
  self,
115
129
  agent_id: str,
116
130
  *,
117
131
  page: int = 1,
118
132
  page_size: int = 30,
119
133
  ) -> dict[str, Any]:
120
- sessions = self._sessions(agent_id)
134
+ sessions = await self._sessions(agent_id)
121
135
  safe_page = max(1, page)
122
136
  safe_size = min(100, max(1, page_size))
123
137
  start = (safe_page - 1) * safe_size
@@ -128,29 +142,81 @@ class StudioSharedWebBridge:
128
142
  "PageSize": safe_size,
129
143
  }
130
144
 
131
- def create_session(self, agent_id: str) -> dict[str, Any]:
145
+ async def create_session(self, agent_id: str) -> dict[str, Any]:
132
146
  self._draft(agent_id)
133
147
  session_id = f"ses_{uuid4().hex}"
134
- now = datetime.now(timezone.utc).isoformat()
135
- return {
136
- "Session": {
137
- "SessionId": session_id,
138
- "AgentId": agent_id,
139
- "UserId": "local-user",
140
- "Title": "新会话",
141
- "CreatedAt": now,
142
- "UpdatedAt": now,
143
- }
144
- }
148
+ session = await self.studio.session_service.create_session(
149
+ agent_id,
150
+ "local-user",
151
+ session_id,
152
+ )
153
+ return {"Session": self._session_metadata_record(session)}
145
154
 
146
- def get_session(self, session_id: str) -> dict[str, Any]:
155
+ async def get_session(self, session_id: str) -> dict[str, Any]:
156
+ self.studio._require_direct_session(session_id)
147
157
  runs = self.studio.event_store.list_runs(session_id=session_id)
158
+ if runs:
159
+ return {"Session": self._session_record(runs)}
160
+ session = await self.studio.session_service.get_session_metadata(session_id)
161
+ if session is None:
162
+ raise not_found("session", session_id)
163
+ return {"Session": self._session_metadata_record(session)}
164
+
165
+ async def compact_session(self, agent_id: str, session_id: str) -> dict[str, Any]:
166
+ self.studio._require_direct_session(session_id)
167
+ from ksadk.codex.runtime import CodexRuntimeAdapter
168
+
169
+ runs = self.studio.event_store.list_runs(session_id=session_id, agent_id=agent_id)
148
170
  if not runs:
149
171
  raise not_found("session", session_id)
150
- return {"Session": self._session_record(runs)}
172
+ latest = runs[-1]
173
+ if latest.runtime_type != "codex":
174
+ raise StudioError("COMPACTION_UNSUPPORTED", "此运行时尚未提供手动压缩", status_code=409)
175
+ key = (agent_id, session_id)
176
+ service = self.studio.run_service
177
+ if key in service._active_sessions or any(self._active_status(run.status) for run in runs):
178
+ raise StudioError(
179
+ "SESSION_RUN_ACTIVE", "请等待当前运行完成后压缩上下文", status_code=409
180
+ )
181
+ thread_id = str((latest.runtime_handle.get("native_ref") or {}).get("thread_id") or "")
182
+ if not thread_id:
183
+ raise StudioError(
184
+ "CONTEXT_UNAVAILABLE", "此会话尚无可压缩的原生上下文", status_code=409
185
+ )
186
+ service._active_sessions.add(key)
187
+ adapter = None
188
+ try:
189
+ spec = self.studio.resolve_run_spec(latest.build_id, model=latest.model or None)
190
+ adapter = self.studio.runtime_executor.create_adapter(spec.launch_context)
191
+ if not isinstance(adapter, CodexRuntimeAdapter):
192
+ raise StudioError(
193
+ "COMPACTION_UNSUPPORTED", "此运行时尚未提供手动压缩", status_code=409
194
+ )
195
+ usage = await adapter.compact_session(thread_id, dict(spec.request_config))
196
+ last = usage.get("last") or {}
197
+ context_usage = {
198
+ "used_tokens": last.get("totalTokens"),
199
+ "source": "runtime",
200
+ "model": latest.model,
201
+ }
202
+ self.studio.event_store.append(
203
+ latest.id,
204
+ "context.compaction.completed",
205
+ {
206
+ "trigger": "manual",
207
+ "contextUsage": context_usage,
208
+ },
209
+ )
210
+ return {"Status": "completed", "ContextUsage": context_usage}
211
+ finally:
212
+ try:
213
+ if adapter is not None:
214
+ await adapter.close_all()
215
+ finally:
216
+ service._active_sessions.discard(key)
151
217
 
152
- def delete_session(self, session_id: str) -> dict[str, Any]:
153
- self.studio.event_store.delete_session(session_id)
218
+ async def delete_session(self, session_id: str) -> dict[str, Any]:
219
+ await self.studio.delete_session(session_id)
154
220
  return {}
155
221
 
156
222
  async def list_messages(
@@ -161,6 +227,7 @@ class StudioSharedWebBridge:
161
227
  before_seq_id: int | None = None,
162
228
  limit: int = 50,
163
229
  ) -> dict[str, Any]:
230
+ self.studio._require_direct_session(session_id)
164
231
  runs = self.studio.event_store.list_runs(session_id=session_id)
165
232
  messages: list[dict[str, Any]] = []
166
233
  sequence = 0
@@ -181,7 +248,20 @@ class StudioSharedWebBridge:
181
248
  {
182
249
  "MessageId": f"{run.id}:assistant",
183
250
  "Role": "assistant",
184
- "Content": {"text": self._run_output(run)},
251
+ "Content": {
252
+ # Run status is metadata, not an assistant reply. An
253
+ # empty pending reply lets canonical reasoning/tools
254
+ # restore without a synthetic status text shadowing them.
255
+ "text": (
256
+ link_run_documents(
257
+ self.studio,
258
+ run,
259
+ run.output
260
+ if self._active_status(run.status)
261
+ else self._run_output(run),
262
+ )
263
+ )
264
+ },
185
265
  "Timestamp": self._timestamp(run.completed_at or run.started_at),
186
266
  "SeqId": sequence,
187
267
  "InvocationId": run.id,
@@ -189,6 +269,16 @@ class StudioSharedWebBridge:
189
269
  }
190
270
  )
191
271
 
272
+ extra_events = await self._untracked_runtime_events(session_id, runs)
273
+ if extra_events:
274
+ messages.extend(project_session_messages(extra_events))
275
+ messages.sort(key=lambda item: self._timestamp_value(item["Timestamp"]))
276
+ for sequence, message in enumerate(messages, 1):
277
+ message["SeqId"] = sequence
278
+ if isinstance(message["Timestamp"], (int, float)):
279
+ message["Timestamp"] = self._timestamp(message["Timestamp"])
280
+ message.pop("StartSeqId", None)
281
+
192
282
  latest_seq_id = sequence
193
283
  if after_seq_id is not None:
194
284
  messages = [item for item in messages if item["SeqId"] > after_seq_id]
@@ -205,6 +295,7 @@ class StudioSharedWebBridge:
205
295
  }
206
296
 
207
297
  async def list_session_events(self, session_id: str) -> dict[str, Any]:
298
+ self.studio._require_direct_session(session_id)
208
299
  runs = self.studio.event_store.list_runs(session_id=session_id)
209
300
  events: list[dict[str, Any]] = []
210
301
  sequence = 0
@@ -214,12 +305,31 @@ class StudioSharedWebBridge:
214
305
  events.append(
215
306
  {
216
307
  "SeqId": sequence,
217
- "EventType": event.type,
308
+ "EventType": self._shared_event_type(event.type, event.data),
218
309
  "InvocationId": run.id,
219
- "Content": event.data,
310
+ "Content": self._presentation_event_content(event.data, run),
220
311
  "Timestamp": self._timestamp(event.created_at),
221
312
  }
222
313
  )
314
+ extra_events = await self._untracked_runtime_events(session_id, runs)
315
+ for event in extra_events:
316
+ native = event["Content"]["runtime_event"]
317
+ event_type, content = project_runtime_event(
318
+ parse_runtime_event(native), session_id=session_id
319
+ )
320
+ events.append(
321
+ {
322
+ "SeqId": 0,
323
+ "EventType": self._shared_event_type(event_type, content),
324
+ "InvocationId": event["InvocationId"],
325
+ "Content": content,
326
+ "Timestamp": self._timestamp(event["Timestamp"]),
327
+ }
328
+ )
329
+ if extra_events:
330
+ events.sort(key=lambda item: self._timestamp_value(item["Timestamp"]))
331
+ for sequence, event in enumerate(events, 1):
332
+ event["SeqId"] = sequence
223
333
  return {
224
334
  "Events": events,
225
335
  "Total": len(events),
@@ -227,19 +337,231 @@ class StudioSharedWebBridge:
227
337
  "Limit": len(events),
228
338
  }
229
339
 
230
- def cancel_run(self, invocation_id: str) -> dict[str, Any]:
340
+ async def _untracked_runtime_events(
341
+ self, session_id: str, runs: list[RunRecord]
342
+ ) -> list[dict[str, Any]]:
343
+ """Read Kernel-owned runs absent from Studio's foreground run index.
344
+
345
+ Scheduled runs already have a durable canonical transcript. Project
346
+ that log through the shared message contract, including in sessions
347
+ that also contain foreground turns, without manufacturing RunRecords.
348
+ """
349
+ tracked = {run.id for run in runs}
350
+ for run in runs:
351
+ tracked.add(str(run.runtime_handle.get("run_id") or ""))
352
+ for event in await self.studio.run_service.events(run.id):
353
+ native = event.data.get("runtimeEvent")
354
+ if isinstance(native, dict):
355
+ tracked.add(str(native.get("run_id") or ""))
356
+ result = []
357
+ for row in await self.studio.session_service.get_events(session_id):
358
+ native = session_event_to_runtime_event(row)
359
+ if native is None or native.run_id in tracked:
360
+ continue
361
+ result.append(
362
+ {
363
+ "EventId": native.event_id,
364
+ "SessionId": session_id,
365
+ "SeqId": row.seq_id,
366
+ "EventType": native.event_type,
367
+ "InvocationId": native.run_id,
368
+ "Timestamp": row.timestamp,
369
+ "Content": {"runtime_event": native.model_dump(mode="json")},
370
+ "Metadata": {"ksadk_canonical_runtime_event": True},
371
+ }
372
+ )
373
+ return result
374
+
375
+ @staticmethod
376
+ def _timestamp_value(value: str | float) -> float:
377
+ if isinstance(value, (float, int)):
378
+ return value
379
+ return datetime.fromisoformat(value.replace("Z", "+00:00")).timestamp() if value else 0
380
+
381
+ @staticmethod
382
+ def _shared_event_type(event_type: str, data: dict[str, Any]) -> str:
383
+ native = data.get("runtimeEvent")
384
+ if (
385
+ event_type == "run.interrupted"
386
+ and isinstance(native, dict)
387
+ and native.get("interaction_id")
388
+ ):
389
+ # A resumable interaction is waiting, not a terminal interruption.
390
+ return "run.waiting"
391
+ return event_type
392
+
393
+ @staticmethod
394
+ def _shared_event_content(data: dict[str, Any], run_id: str) -> dict[str, Any]:
395
+ """Use the public Studio run identity in shared-Web history projections.
396
+
397
+ The persisted canonical event retains the adapter's native run ID.
398
+ ListSessionMessages uses the Studio ID, so its event projection must
399
+ use the same ID or hydration retains both copies of the answer.
400
+ """
401
+ native = data.get("runtimeEvent")
402
+ if not isinstance(native, dict):
403
+ return data
404
+ return {**data, "runtimeEvent": {**native, "run_id": run_id}}
405
+
406
+ def _presentation_event_content(self, data: dict[str, Any], run: RunRecord) -> dict[str, Any]:
407
+ content = self._shared_event_content(data, run.id)
408
+ native = content.get("runtimeEvent")
409
+ if run.runtime_type != "harness" or not isinstance(native, dict):
410
+ return content
411
+ native = dict(native)
412
+ native_type = native.get("source", {}).get("metadata", {}).get("native_event_type")
413
+ if native_type == "run.progress" and native.get("item_kind") == "message":
414
+ # Progress is an activity, never assistant answer prose. This also
415
+ # repairs historical runs without rewriting their audit transcript.
416
+ native["item_kind"] = "reasoning"
417
+ if native_type == "text.completed" and native.get("snapshot"):
418
+ native["snapshot"] = {
419
+ **native["snapshot"],
420
+ "parts": [
421
+ {**part, "text": link_run_documents(self.studio, run, part["text"])}
422
+ if part.get("content_type") == "text"
423
+ else part
424
+ for part in native["snapshot"].get("parts", [])
425
+ ],
426
+ }
427
+ return {**content, "runtimeEvent": native}
428
+
429
+ async def subscription_run_id(self, session_id: str, invocation_id: str) -> str:
430
+ self.studio._require_direct_session(session_id)
431
+ run_id = self._run_ids_by_invocation.get(invocation_id, invocation_id)
432
+ try:
433
+ run = self.studio.event_store.get(run_id)
434
+ except StudioError as error:
435
+ if error.code != "RUN_NOT_FOUND":
436
+ raise
437
+ else:
438
+ if run.session_id != session_id:
439
+ raise not_found("run", invocation_id)
440
+ return run_id
441
+ for row in await self.studio.session_service.get_events(session_id):
442
+ native = session_event_to_runtime_event(row)
443
+ if native is not None and native.run_id == run_id:
444
+ return run_id
445
+ raise not_found("run", invocation_id)
446
+
447
+ async def subscribe_run_events(
448
+ self,
449
+ session_id: str,
450
+ invocation_id: str,
451
+ *,
452
+ after_seq_id: int = 0,
453
+ ) -> AsyncIterator[str]:
454
+ run_id = await self.subscription_run_id(session_id, invocation_id)
455
+ runs = self.studio.event_store.list_runs(session_id=session_id)
456
+ if await self._untracked_runtime_events(session_id, runs):
457
+ cursor = after_seq_id
458
+ while True:
459
+ history = await self.list_session_events(session_id)
460
+ run_events = [
461
+ event for event in history["Events"] if event["InvocationId"] == run_id
462
+ ]
463
+ for event in run_events:
464
+ if event["SeqId"] > cursor:
465
+ yield self._sse("message", {**event, "SessionId": session_id})
466
+ cursor = event["SeqId"]
467
+ if any(
468
+ event["EventType"]
469
+ in {"run.completed", "run.failed", "run.cancelled", "run.interrupted"}
470
+ for event in run_events
471
+ ):
472
+ yield "event: done\ndata: [DONE]\n\n"
473
+ return
474
+ yield ": ping\n\n"
475
+ await asyncio.sleep(0.25)
476
+ # Match ListSessionEvents' session cursor without rereading every old
477
+ # run on every live poll. Only the subscribed run can still grow.
478
+ offset = 0
479
+ for record in self.studio.event_store.list_runs(session_id=session_id):
480
+ if record.id == run_id:
481
+ break
482
+ offset += len(self.studio.event_store.events(record.id))
483
+ cursor = max(0, after_seq_id - offset)
484
+ while True:
485
+ for event in await self.studio.run_service.events(run_id, after=cursor):
486
+ cursor = max(cursor, event.id)
487
+ yield self._sse(
488
+ "message",
489
+ {
490
+ "SeqId": offset + event.id,
491
+ "SessionId": session_id,
492
+ "InvocationId": invocation_id,
493
+ "EventType": self._shared_event_type(event.type, event.data),
494
+ "Content": self._presentation_event_content(
495
+ event.data, self.studio.event_store.get(run_id)
496
+ ),
497
+ "Timestamp": self._timestamp(event.created_at),
498
+ },
499
+ )
500
+ record = self.studio.event_store.get(run_id)
501
+ if not self._active_status(record.status):
502
+ yield "event: done\ndata: [DONE]\n\n"
503
+ return
504
+ yield ": ping\n\n"
505
+ await asyncio.sleep(0.25)
506
+
507
+ async def cancel_run(self, invocation_id: str) -> dict[str, Any]:
231
508
  operation_id = self._operations_by_invocation.get(invocation_id)
232
- if operation_id:
509
+ run_id = self._run_ids_by_invocation.get(invocation_id)
510
+ if run_id is None and operation_id is None:
511
+ # get_session reports the canonical run id; accept it as a cancel
512
+ # reference by resolving back to the invoking client id.
513
+ client_id = next((
514
+ client_id
515
+ for client_id, canonical_id in self._run_ids_by_invocation.items()
516
+ if canonical_id == invocation_id and client_id in self._operations_by_invocation
517
+ ), None)
518
+ if client_id is not None:
519
+ operation_id = self._operations_by_invocation[client_id]
520
+ run_id = invocation_id
521
+ self.studio._require_direct_run(run_id or invocation_id)
522
+ if run_id:
523
+ # Preserve the canonical Run terminal event. Cancelling only the
524
+ # outer Operation can strand the already-created Run in CREATED.
525
+ await self.studio.run_service.cancel_run(run_id)
526
+ # ListSessions is refreshed as soon as this response returns. Give
527
+ # the run task a short bounded window to persist its terminal state
528
+ # so the sidebar does not keep a stale "running" indicator.
529
+ event_store = getattr(self.studio, "event_store", None)
530
+ if event_store is not None:
531
+ # Provider cancellation may need to unwind an in-flight model
532
+ # request before RunService can append run.canceled. Keep the
533
+ # CancelRun response pending for a bounded 10 seconds so the
534
+ # refresh issued by ksadk-web observes the terminal record
535
+ # instead of permanently caching a transient RUNNING badge.
536
+ for _ in range(200):
537
+ try:
538
+ status = event_store.get(run_id).status
539
+ except Exception: # noqa: BLE001 - cancellation already accepted
540
+ break
541
+ if status not in {
542
+ RunStatus.CREATED,
543
+ RunStatus.RUNNING,
544
+ RunStatus.WAITING_INPUT,
545
+ }:
546
+ break
547
+ await asyncio.sleep(0.05)
548
+ elif operation_id:
233
549
  self.studio.operations.cancel(operation_id)
234
- return {"InvocationId": invocation_id, "Cancelled": bool(operation_id)}
550
+ return {
551
+ "InvocationId": invocation_id,
552
+ "RunId": run_id or "",
553
+ "Cancelled": bool(run_id or operation_id),
554
+ }
235
555
 
236
556
  async def pause_run(self, invocation_id: str) -> dict[str, Any]:
557
+ self.studio._require_direct_run(invocation_id)
237
558
  run_id = self._run_ids_by_invocation.get(invocation_id)
238
559
  if not run_id:
239
560
  raise StudioError("RUN_NOT_READY", "运行尚未创建,请稍后重试", status_code=409)
240
561
  return await self.studio.run_service.pause_run(run_id)
241
562
 
242
563
  async def resume_run(self, invocation_id: str) -> dict[str, Any]:
564
+ self.studio._require_direct_run(invocation_id)
243
565
  run_id = self._run_ids_by_invocation.get(invocation_id)
244
566
  if not run_id:
245
567
  raise StudioError("RUN_NOT_FOUND", "未找到可继续的运行", status_code=404)
@@ -249,19 +571,32 @@ class StudioSharedWebBridge:
249
571
  run_id = self._response_runs.get(response_id, response_id)
250
572
  return self.studio.event_store.get(run_id).session_id
251
573
 
252
- async def stream_run(self, payload: dict[str, Any]) -> AsyncIterator[str]:
253
- agent_id = self.resolve_agent_id(str(payload.get("AgentId") or "") or None)
574
+ def resolve_run_reference(self, reference: str) -> str:
575
+ """Resolve a live Responses invocation without guessing the latest run."""
576
+ return (
577
+ self._run_ids_by_invocation.get(reference)
578
+ or self._response_runs.get(reference)
579
+ or reference
580
+ )
581
+
582
+ async def stream_run(
583
+ self, payload: dict[str, Any], *, shared_ui: bool = False
584
+ ) -> AsyncIterator[str]:
254
585
  session_id = str(payload.get("SessionId") or f"ses_{uuid4().hex}")
255
586
  invocation_id = str(payload.get("InvocationId") or f"resp_{uuid4().hex}")
256
- prompt = self._input_text(payload)
257
- runtime_input = self._runtime_input(payload)
258
- model = self._select_model(agent_id, str(payload.get("Model") or ""))
259
- model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
260
- approval_mode = str(payload.get("ApprovalMode") or "")
261
- collaboration_mode = str(payload.get("CollaborationMode") or "")
262
- goal_objective = str(payload.get("GoalObjective") or "")
263
- reasoning_effort = str(payload.get("ReasoningEffort") or "")
587
+ # Keep the client correlation key through the operation layer. It is
588
+ # only an idempotency key when the caller explicitly supplies one;
589
+ # otherwise each invocation remains independently executable.
590
+ idempotency_key = str(payload.get("IdempotencyKey") or f"responses:{invocation_id}")
264
591
  try:
592
+ agent_id = self.resolve_agent_id(str(payload.get("AgentId") or "") or None)
593
+ prompt = self._input_text(payload)
594
+ runtime_input = self._runtime_input(payload)
595
+ model = self._select_model(agent_id, str(payload.get("Model") or ""))
596
+ model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
597
+ approval_mode, collaboration_mode, goal_objective, reasoning_effort = (
598
+ self._request_controls(payload)
599
+ )
265
600
  build = await self._ensure_build(agent_id)
266
601
  self._validate_conversation_turn(
267
602
  build_id=build.id,
@@ -298,6 +633,7 @@ class StudioSharedWebBridge:
298
633
  collaboration_mode=collaboration_mode,
299
634
  goal_objective=goal_objective,
300
635
  reasoning_effort=reasoning_effort,
636
+ idempotency_key=idempotency_key,
301
637
  )
302
638
  )
303
639
 
@@ -339,6 +675,9 @@ class StudioSharedWebBridge:
339
675
  if event_name == "response.output_text.delta":
340
676
  emitted_text += str(event_payload.get("delta") or "")
341
677
  yield self._sse(event_name, event_payload)
678
+ # A form pauses the Agent, not its response stream.
679
+ # Keep delivery attached through input and emit the
680
+ # eventual terminal frame after the same run resumes.
342
681
  else:
343
682
  idle_polls += 1
344
683
  if idle_polls >= 20:
@@ -389,12 +728,12 @@ class StudioSharedWebBridge:
389
728
  agent_id = self.resolve_agent_id(str(payload.get("AgentId") or "") or None)
390
729
  session_id = str(payload.get("SessionId") or f"ses_{uuid4().hex}")
391
730
  invocation_id = str(payload.get("InvocationId") or f"resp_{uuid4().hex}")
731
+ idempotency_key = str(payload.get("IdempotencyKey") or f"responses:{invocation_id}")
392
732
  model = self._select_model(agent_id, str(payload.get("Model") or ""))
393
733
  model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
394
- approval_mode = str(payload.get("ApprovalMode") or "")
395
- collaboration_mode = str(payload.get("CollaborationMode") or "")
396
- goal_objective = str(payload.get("GoalObjective") or "")
397
- reasoning_effort = str(payload.get("ReasoningEffort") or "")
734
+ approval_mode, collaboration_mode, goal_objective, reasoning_effort = (
735
+ self._request_controls(payload)
736
+ )
398
737
  build = await self._ensure_build(agent_id)
399
738
  prompt = self._input_text(payload)
400
739
  runtime_input = self._runtime_input(payload)
@@ -423,6 +762,7 @@ class StudioSharedWebBridge:
423
762
  collaboration_mode=collaboration_mode,
424
763
  goal_objective=goal_objective,
425
764
  reasoning_effort=reasoning_effort,
765
+ idempotency_key=idempotency_key,
426
766
  )
427
767
  return self._response_payload(
428
768
  run,
@@ -446,12 +786,11 @@ class StudioSharedWebBridge:
446
786
  collaboration_mode: str = "",
447
787
  goal_objective: str = "",
448
788
  reasoning_effort: str = "",
789
+ idempotency_key: str = "",
449
790
  ) -> RunRecord:
450
791
  if build is None:
451
792
  build = await self._ensure_build(agent_id)
452
- bound_agent = str(
453
- getattr(build, "agent_name", None) or getattr(build, "agent_id", "")
454
- )
793
+ bound_agent = str(getattr(build, "agent_name", None) or getattr(build, "agent_id", ""))
455
794
  if bound_agent != agent_id:
456
795
  raise StudioError(
457
796
  "CONVERSATION_BUILD_MISMATCH",
@@ -475,7 +814,7 @@ class StudioSharedWebBridge:
475
814
  goal_objective=goal_objective or None,
476
815
  reasoning_effort=reasoning_effort or None,
477
816
  runtime_input=runtime_input or None,
478
- idempotency_key=f"responses:{invocation_id}",
817
+ idempotency_key=idempotency_key or f"responses:{invocation_id}",
479
818
  on_event=observe,
480
819
  )
481
820
  self._operations_by_invocation[invocation_id] = operation.id
@@ -533,9 +872,14 @@ class StudioSharedWebBridge:
533
872
  delta = str(event.data.get("text") or event.data.get("delta") or "")
534
873
  if not delta:
535
874
  continue
875
+ native = event.data.get("runtimeEvent") or {}
876
+ is_activity = run.runtime_type == "harness" and (
877
+ native.get("source", {}).get("metadata", {}).get("native_event_type")
878
+ == "run.progress"
879
+ )
536
880
  event_name = (
537
881
  "response.output_text.delta"
538
- if event.type == "message.delta"
882
+ if event.type == "message.delta" and not is_activity
539
883
  else "response.reasoning_summary_text.delta"
540
884
  )
541
885
  projected.append(
@@ -544,7 +888,7 @@ class StudioSharedWebBridge:
544
888
  self._response_delta_payload(
545
889
  event_name,
546
890
  invocation_id=invocation_id,
547
- delta=delta,
891
+ delta=f"\n{delta}\n" if is_activity else delta,
548
892
  ),
549
893
  )
550
894
  )
@@ -585,6 +929,23 @@ class StudioSharedWebBridge:
585
929
  )
586
930
  )
587
931
  continue
932
+ if event.type == "approval.resolved":
933
+ projected.append(
934
+ (
935
+ "response.ksadk.approval_resolved",
936
+ {
937
+ "type": "response.ksadk.approval_resolved",
938
+ "approvalRequestId": event.data.get("approvalId")
939
+ or event.data.get("interactionId"),
940
+ "decision": event.data.get("decision")
941
+ or event.data.get("name")
942
+ or "approved",
943
+ "revision": event.data.get("revision") or 2,
944
+ "runId": run.id,
945
+ },
946
+ )
947
+ )
948
+ continue
588
949
  item_event = self._response_item_event(event.type, event.data, starts)
589
950
  if item_event is not None:
590
951
  projected.append(item_event)
@@ -613,7 +974,9 @@ class StudioSharedWebBridge:
613
974
  "status": (
614
975
  "failed"
615
976
  if event_type.endswith("failed") or data.get("exitCode") not in {None, 0}
616
- else "completed" if done else "in_progress"
977
+ else "completed"
978
+ if done
979
+ else "in_progress"
617
980
  ),
618
981
  "action": {
619
982
  "commands": [command],
@@ -634,17 +997,24 @@ class StudioSharedWebBridge:
634
997
  "status": (
635
998
  "failed"
636
999
  if event_type.endswith("failed")
637
- else "completed" if done else "in_progress"
1000
+ else "completed"
1001
+ if done
1002
+ else "in_progress"
638
1003
  ),
639
1004
  "output": data.get("output") or data.get("result") or "",
640
1005
  }
641
1006
  elif event_type == "approval.requested":
1007
+ approval_id = str(data.get("approvalId") or data.get("interactionId") or call_id or "")
1008
+ detail = data.get("detail")
1009
+ arguments = detail if isinstance(detail, dict) else {"detail": detail}
642
1010
  item = {
643
- "id": call_id or f"approval_{uuid4().hex}",
1011
+ "id": approval_id or f"approval_{uuid4().hex}",
644
1012
  "call_id": call_id,
645
- "type": "approval_request",
1013
+ "type": "mcp_approval_request",
1014
+ "name": str(data.get("kind") or started.get("tool") or "人工确认"),
1015
+ "arguments": json.dumps(arguments, ensure_ascii=False),
1016
+ "run_id": str(data.get("runId") or ""),
646
1017
  "status": "in_progress",
647
- "action": data,
648
1018
  }
649
1019
  else:
650
1020
  return None
@@ -681,8 +1051,8 @@ class StudioSharedWebBridge:
681
1051
  "delta": delta,
682
1052
  }
683
1053
 
684
- @staticmethod
685
1054
  def _response_payload(
1055
+ self,
686
1056
  run: RunRecord,
687
1057
  *,
688
1058
  model: str,
@@ -702,7 +1072,7 @@ class StudioSharedWebBridge:
702
1072
  "content": [
703
1073
  {
704
1074
  "type": "output_text",
705
- "text": run.output,
1075
+ "text": link_run_documents(self.studio, run, run.output),
706
1076
  "annotations": [],
707
1077
  }
708
1078
  ],
@@ -811,15 +1181,53 @@ class StudioSharedWebBridge:
811
1181
  return media_type
812
1182
  return fallback
813
1183
 
814
- def _sessions(self, agent_id: str) -> list[dict[str, Any]]:
1184
+ async def _sessions(self, agent_id: str) -> list[dict[str, Any]]:
1185
+ persisted = await self.studio.session_service.list_session_metadata(
1186
+ agent_id=agent_id,
1187
+ )
1188
+ records = {
1189
+ session.id: self._session_metadata_record(session)
1190
+ for session in persisted
1191
+ if session.user_id in {"local-user", "local-studio"}
1192
+ and not self.studio.execution_host.is_reserved_session(session.id)
1193
+ }
815
1194
  grouped: dict[str, list[RunRecord]] = {}
816
- for run in self.studio.event_store.list_runs():
817
- if run.agent_id != agent_id:
818
- continue
1195
+ for run in self.studio.event_store.list_runs(agent_id=agent_id):
819
1196
  grouped.setdefault(run.session_id, []).append(run)
820
- records = [self._session_record(runs) for runs in grouped.values()]
821
- records.sort(key=lambda item: item["UpdatedAt"], reverse=True)
822
- return records
1197
+ for session_id, runs in grouped.items():
1198
+ records[session_id] = self._session_record(runs)
1199
+ ordered = list(records.values())
1200
+ # UpdatedAt 相同(同一秒创建的"新会话"、毫秒级并发会话)时以 SessionId
1201
+ # 定序,避免两次 ListSessions 之间插入顺序漂移导致前端列表"乱跳"。
1202
+ ordered.sort(
1203
+ key=lambda item: (item["UpdatedAt"], item["SessionId"]),
1204
+ reverse=True,
1205
+ )
1206
+ return ordered
1207
+
1208
+ def _session_metadata_record(self, session: Session) -> dict[str, Any]:
1209
+ title = session.title
1210
+ if not title and session.first_prompt:
1211
+ title = self._short_title(session.first_prompt)
1212
+ return {
1213
+ "SessionId": session.id,
1214
+ "AgentId": session.agent_id,
1215
+ "UserId": session.user_id or "local-user",
1216
+ "Title": title or "新会话",
1217
+ "FirstPrompt": session.first_prompt,
1218
+ "LastPrompt": session.last_prompt,
1219
+ "CreatedAt": self._timestamp(session.created_at),
1220
+ "UpdatedAt": self._timestamp(session.updated_at),
1221
+ "ActiveRunStatus": "",
1222
+ "ActiveInvocationId": "",
1223
+ "TokenUsage": {
1224
+ "input_tokens": 0,
1225
+ "output_tokens": 0,
1226
+ "total_tokens": 0,
1227
+ "turns": 0,
1228
+ "last_response_id": "",
1229
+ },
1230
+ }
823
1231
 
824
1232
  def _session_record(self, runs: list[RunRecord]) -> dict[str, Any]:
825
1233
  ordered = sorted(
@@ -830,6 +1238,7 @@ class StudioSharedWebBridge:
830
1238
  )
831
1239
  first = ordered[0]
832
1240
  latest = ordered[-1]
1241
+ active = next((run for run in reversed(ordered) if self._active_status(run.status)), None)
833
1242
  usage = {
834
1243
  "input_tokens": sum(run.usage.input_tokens for run in ordered),
835
1244
  "output_tokens": sum(run.usage.output_tokens for run in ordered),
@@ -846,11 +1255,26 @@ class StudioSharedWebBridge:
846
1255
  "LastPrompt": latest.input,
847
1256
  "CreatedAt": self._timestamp(first.started_at),
848
1257
  "UpdatedAt": self._timestamp(latest.completed_at or latest.started_at),
849
- "ActiveRunStatus": self._active_status(latest.status),
850
- "ActiveInvocationId": latest.id if latest.status == RunStatus.RUNNING else "",
1258
+ "ActiveRunStatus": self._active_status(active.status) if active else "",
1259
+ "ActiveInvocationId": active.id if active else "",
851
1260
  "TokenUsage": usage,
1261
+ "ContextUsage": self._context_usage(latest),
852
1262
  }
853
1263
 
1264
+ def _context_usage(self, latest: RunRecord) -> dict[str, Any] | None:
1265
+ if latest.runtime_type != "codex":
1266
+ return None
1267
+ for event in reversed(self.studio.event_store.events(latest.id)):
1268
+ if event.type == "context.compaction.completed":
1269
+ return event.data.get("contextUsage")
1270
+ if latest.runtime_type == "codex" and latest.usage.input_tokens > 0:
1271
+ return {
1272
+ "used_tokens": latest.usage.input_tokens,
1273
+ "source": "last_request",
1274
+ "model": latest.model,
1275
+ }
1276
+ return None
1277
+
854
1278
  def _model_descriptor(
855
1279
  self, agent_id: str, models: list[dict[str, Any]] | None = None
856
1280
  ) -> dict[str, Any]:
@@ -882,11 +1306,17 @@ class StudioSharedWebBridge:
882
1306
  binding_ids = [draft.spec.bindings.model_profile_id]
883
1307
  descriptors: list[dict[str, Any]] = []
884
1308
  for binding_id in binding_ids:
885
- spec = self.studio.catalog.resolve_model(
886
- draft.spec.bindings.model_copy(
887
- update={"model_profile_id": binding_id, "model_profile_ids": []}
1309
+ try:
1310
+ spec = self.studio.catalog.resolve_model(
1311
+ draft.spec.bindings.model_copy(
1312
+ update={"model_profile_id": binding_id, "model_profile_ids": []}
1313
+ )
888
1314
  )
889
- )
1315
+ except StudioError:
1316
+ # provider 目录是惰性发现的;绑定指向尚未发现/已失效的
1317
+ # model:provider:* 资源时跳过该绑定,回退到后续描述符,
1318
+ # 而不是让整个 bootstrap 404(前端只能无限转圈)。
1319
+ continue
890
1320
  if spec is not None:
891
1321
  descriptors.append(
892
1322
  self._model_descriptor_from_spec(
@@ -927,7 +1357,7 @@ class StudioSharedWebBridge:
927
1357
  "id": model_name,
928
1358
  "display_name": model_name,
929
1359
  "source": "agentkit-studio",
930
- "context_window_tokens": draft.spec.context.max_input_tokens,
1360
+ "input_budget_tokens": draft.spec.context.max_input_tokens,
931
1361
  "max_output_tokens": 2048,
932
1362
  "capabilities": {
933
1363
  "function_calling": True,
@@ -952,8 +1382,8 @@ class StudioSharedWebBridge:
952
1382
  "id": model_id,
953
1383
  "display_name": resolved_display_name,
954
1384
  "source": "agentkit-studio",
955
- "context_window_tokens": metadata.get("context_window_tokens")
956
- or draft.spec.context.max_input_tokens,
1385
+ "context_window_tokens": metadata.get("context_window_tokens"),
1386
+ "input_budget_tokens": draft.spec.context.max_input_tokens,
957
1387
  "max_output_tokens": max_output_tokens,
958
1388
  "capabilities": {
959
1389
  **dict(metadata.get("capabilities") or {}),
@@ -971,7 +1401,7 @@ class StudioSharedWebBridge:
971
1401
  "id": model_id,
972
1402
  "display_name": model_id if model_id != "unconfigured-model" else "未配置模型",
973
1403
  "source": "agentkit-studio",
974
- "context_window_tokens": draft.spec.context.max_input_tokens,
1404
+ "input_budget_tokens": draft.spec.context.max_input_tokens,
975
1405
  "max_output_tokens": 2048,
976
1406
  "capabilities": {
977
1407
  "function_calling": True,
@@ -997,7 +1427,7 @@ class StudioSharedWebBridge:
997
1427
  return self.studio.agent_detail(agent_id)["draft"]
998
1428
 
999
1429
  async def _run_activities(self, run: RunRecord) -> list[dict[str, Any]]:
1000
- activities: list[dict[str, Any]] = []
1430
+ activities: dict[str, dict[str, Any]] = {}
1001
1431
  for event in await self.studio.run_service.events(run.id):
1002
1432
  operations = (
1003
1433
  event.data.get("a2uiOperations")
@@ -1009,16 +1439,78 @@ class StudioSharedWebBridge:
1009
1439
  surface_id = str(
1010
1440
  event.data.get("surfaceId") or event.data.get("surface_id") or f"{run.id}-surface"
1011
1441
  )
1012
- activities.append(
1013
- {
1014
- "SeqId": event.id,
1015
- "Type": event.type,
1016
- "MessageId": f"{run.id}:assistant",
1017
- "SurfaceId": surface_id,
1018
- "Content": {"a2ui_operations": operations},
1019
- }
1442
+ previous = activities.get(surface_id)
1443
+ # Snapshot updates may repeat createSurface; only the latest full
1444
+ # snapshot should become a history row. Delta-only batches append.
1445
+ reset = any(isinstance(op, dict) and "createSurface" in op for op in operations)
1446
+ previous_operations = (
1447
+ previous["Content"]["a2ui_operations"] if previous and not reset else []
1020
1448
  )
1021
- return activities
1449
+ activities[surface_id] = {
1450
+ "SeqId": event.id,
1451
+ "Type": event.type,
1452
+ "MessageId": f"{run.id}:assistant",
1453
+ "SurfaceId": surface_id,
1454
+ "Content": {"a2ui_operations": [*previous_operations, *operations]},
1455
+ }
1456
+ return list(activities.values())
1457
+
1458
+ @staticmethod
1459
+ def _request_controls(payload: dict[str, Any]) -> tuple[str, str, str, str]:
1460
+ """Read turn controls from both legacy and shared-Web request shapes."""
1461
+
1462
+ metadata = payload.get("Metadata") or payload.get("metadata")
1463
+ metadata = metadata if isinstance(metadata, dict) else {}
1464
+ agentengine = metadata.get("agentengine")
1465
+ agentengine = agentengine if isinstance(agentengine, dict) else {}
1466
+ model_options = payload.get("ModelOptions") or payload.get("model_options")
1467
+ model_options = model_options if isinstance(model_options, dict) else {}
1468
+
1469
+ approval_mode = (
1470
+ str(
1471
+ payload.get("ApprovalMode")
1472
+ or payload.get("approval_mode")
1473
+ or metadata.get("approval_mode")
1474
+ or metadata.get("approvalMode")
1475
+ or agentengine.get("tool_approval_mode")
1476
+ or agentengine.get("approval_mode")
1477
+ or ""
1478
+ )
1479
+ .strip()
1480
+ .lower()
1481
+ )
1482
+ collaboration_mode = (
1483
+ str(
1484
+ payload.get("CollaborationMode")
1485
+ or payload.get("collaboration_mode")
1486
+ or metadata.get("collaboration_mode")
1487
+ or metadata.get("collaborationMode")
1488
+ or agentengine.get("collaboration_mode")
1489
+ or ""
1490
+ )
1491
+ .strip()
1492
+ .lower()
1493
+ )
1494
+ goal_objective = str(
1495
+ payload.get("GoalObjective")
1496
+ or payload.get("goal_objective")
1497
+ or metadata.get("goal_objective")
1498
+ or metadata.get("goalObjective")
1499
+ or agentengine.get("goal_objective")
1500
+ or ""
1501
+ ).strip()
1502
+ reasoning_effort = (
1503
+ str(
1504
+ payload.get("ReasoningEffort")
1505
+ or payload.get("reasoning_effort")
1506
+ or model_options.get("reasoning_effort")
1507
+ or model_options.get("reasoningEffort")
1508
+ or ""
1509
+ )
1510
+ .strip()
1511
+ .lower()
1512
+ )
1513
+ return approval_mode, collaboration_mode, goal_objective, reasoning_effort
1022
1514
 
1023
1515
  @staticmethod
1024
1516
  def _input_text(payload: dict[str, Any]) -> str:
@@ -1100,7 +1592,7 @@ class StudioSharedWebBridge:
1100
1592
 
1101
1593
  @staticmethod
1102
1594
  def _active_status(status: RunStatus) -> str:
1103
- return "running" if status == RunStatus.RUNNING else ""
1595
+ return "running" if status in {RunStatus.RUNNING, RunStatus.WAITING_INPUT} else ""
1104
1596
 
1105
1597
  @staticmethod
1106
1598
  def _run_output(run: RunRecord) -> str:
@@ -1108,7 +1600,8 @@ class StudioSharedWebBridge:
1108
1600
  return run.output
1109
1601
  if run.error:
1110
1602
  return str(run.error.get("message") or "Agent 运行失败")
1111
- return f"运行状态:{run.status.value}"
1603
+ status = run.status.value if isinstance(run.status, RunStatus) else str(run.status)
1604
+ return f"运行状态:{status}"
1112
1605
 
1113
1606
  @staticmethod
1114
1607
  def _short_title(value: str, limit: int = 36) -> str:
@@ -1116,8 +1609,12 @@ class StudioSharedWebBridge:
1116
1609
  return text if len(text) <= limit else f"{text[:limit]}..."
1117
1610
 
1118
1611
  @staticmethod
1119
- def _timestamp(value: datetime | None) -> str:
1120
- return (value or datetime.now(timezone.utc)).isoformat()
1612
+ def _timestamp(value: datetime | float | int | None) -> str:
1613
+ if isinstance(value, datetime):
1614
+ return value.isoformat()
1615
+ if isinstance(value, (float, int)):
1616
+ return datetime.fromtimestamp(value, tz=timezone.utc).isoformat()
1617
+ return datetime.now(timezone.utc).isoformat()
1121
1618
 
1122
1619
  @staticmethod
1123
1620
  def _sse(event: str, payload: dict[str, Any]) -> str: