agentengine-sdk-python 0.8.4__py3-none-any.whl → 0.8.5__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (673) hide show
  1. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/METADATA +6 -3
  2. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/RECORD +591 -365
  3. ksadk/_build_provenance.json +1 -1
  4. ksadk/_process.py +83 -0
  5. ksadk/_str_enum.py +17 -0
  6. ksadk/a2ui/core.py +3 -3
  7. ksadk/api/client.py +6 -0
  8. ksadk/builders/code_builder.py +38 -12
  9. ksadk/builders/framework_requirements.py +20 -2
  10. ksadk/cli/__init__.py +36 -0
  11. ksadk/cli/cmd_config.py +4 -4
  12. ksadk/cli/cmd_create.py +12 -12
  13. ksadk/cli/cmd_hermes.py +24 -2
  14. ksadk/cli/cmd_invoke.py +28 -5
  15. ksadk/cli/cmd_openclaw.py +26 -1
  16. ksadk/cli/cmd_plugin.py +70 -12
  17. ksadk/cli/cmd_studio.py +64 -16
  18. ksadk/cli/openclaw_env.py +1 -1
  19. ksadk/cli/resource_common.py +26 -0
  20. ksadk/codex/client.py +3 -2
  21. ksadk/configs/__init__.py +1 -1
  22. ksadk/configs/env_registry.py +125 -31
  23. ksadk/configs/env_registry_studio.py +86 -0
  24. ksadk/configs/global_config.py +1 -1
  25. ksadk/configs/settings.py +3 -3
  26. ksadk/connector/__init__.py +17 -0
  27. ksadk/connector/channel.py +477 -0
  28. ksadk/context_engine/capabilities.py +52 -4
  29. ksadk/conversations/attachment_storage.py +10 -3
  30. ksadk/conversations/attachments.py +16 -5
  31. ksadk/conversations/message_projection.py +23 -32
  32. ksadk/conversations/normalize.py +28 -10
  33. ksadk/conversations/runtime_baseline.py +37 -0
  34. ksadk/conversations/runtime_invocation.py +17 -4
  35. ksadk/conversations/runtime_observability.py +39 -10
  36. ksadk/conversations/runtime_payloads.py +8 -0
  37. ksadk/conversations/runtime_persistence.py +105 -9
  38. ksadk/conversations/runtime_preparation.py +13 -7
  39. ksadk/conversations/runtime_stream_events.py +29 -35
  40. ksadk/conversations/runtime_streaming.py +8 -0
  41. ksadk/events/adapters/_codex_items.py +16 -8
  42. ksadk/events/adapters/_langgraph_support.py +34 -0
  43. ksadk/events/session_event.py +2 -2
  44. ksadk/harness/__init__.py +14 -0
  45. ksadk/harness/app.py +11 -0
  46. ksadk/harness/artifact_store.py +213 -0
  47. ksadk/harness/capabilities.py +115 -0
  48. ksadk/harness/capability_runtime.py +237 -0
  49. ksadk/harness/closure_contract.py +92 -0
  50. ksadk/harness/compaction_record.py +122 -0
  51. ksadk/harness/compiler.py +284 -0
  52. ksadk/harness/conformance/__init__.py +33 -0
  53. ksadk/harness/conformance/contract.py +506 -0
  54. ksadk/harness/conformance/fixtures.py +102 -0
  55. ksadk/harness/context_engine.py +403 -0
  56. ksadk/harness/context_maintenance.py +259 -0
  57. ksadk/harness/context_manifest.py +188 -0
  58. ksadk/harness/context_tuning.py +168 -0
  59. ksadk/harness/draft_runtime.py +322 -0
  60. ksadk/harness/engine/__init__.py +40 -0
  61. ksadk/harness/engine/base.py +122 -0
  62. ksadk/harness/engine/budgets.py +108 -0
  63. ksadk/harness/engine/capability_declarations.py +59 -0
  64. ksadk/harness/engine/completion_guard.py +42 -0
  65. ksadk/harness/engine/context_pipeline.py +579 -0
  66. ksadk/harness/engine/graph_builder.py +859 -0
  67. ksadk/harness/engine/langgraph.py +931 -0
  68. ksadk/harness/engine/mcp_disclosure.py +750 -0
  69. ksadk/harness/engine/policy_runtime.py +70 -0
  70. ksadk/harness/engine/postgres_checkpointer.py +63 -0
  71. ksadk/harness/engine/run_control_bridge.py +80 -0
  72. ksadk/harness/engine/run_types.py +88 -0
  73. ksadk/harness/engine/skill_disclosure.py +189 -0
  74. ksadk/harness/engine/spans.py +41 -0
  75. ksadk/harness/engine/subagents.py +343 -0
  76. ksadk/harness/engine/thread_ids.py +112 -0
  77. ksadk/harness/engine/tool_dispatch.py +144 -0
  78. ksadk/harness/event_tree.py +212 -0
  79. ksadk/harness/events.py +461 -0
  80. ksadk/harness/execution_policy.py +94 -0
  81. ksadk/harness/insights.py +210 -0
  82. ksadk/harness/lifecycle.py +578 -0
  83. ksadk/harness/lifecycle_conformance.py +233 -0
  84. ksadk/harness/lifecycle_local_plane.py +104 -0
  85. ksadk/harness/loop/__init__.py +44 -0
  86. ksadk/harness/loop/reason.py +454 -0
  87. ksadk/harness/loop/tools.py +762 -0
  88. ksadk/harness/managed_runtime.py +884 -0
  89. ksadk/harness/mcp_matrix.py +474 -0
  90. ksadk/harness/mcp_runtime.py +471 -0
  91. ksadk/harness/memory_consolidation.py +157 -0
  92. ksadk/harness/memory_loop.py +156 -0
  93. ksadk/harness/memory_runtime.py +541 -0
  94. ksadk/harness/metrics.py +90 -0
  95. ksadk/harness/model_capability.py +253 -0
  96. ksadk/harness/model_provider.py +220 -0
  97. ksadk/harness/observability/__init__.py +29 -0
  98. ksadk/harness/observability/inspection.py +528 -0
  99. ksadk/harness/observability/metrics.py +167 -0
  100. ksadk/harness/observability/otel_exporter.py +218 -0
  101. ksadk/harness/prompt_cache.py +70 -0
  102. ksadk/harness/public_activity.py +154 -0
  103. ksadk/harness/readiness.py +249 -0
  104. ksadk/harness/reasoner.py +466 -13
  105. ksadk/harness/release_readiness.py +140 -0
  106. ksadk/harness/resource_ref.py +69 -0
  107. ksadk/harness/run_control.py +668 -0
  108. ksadk/harness/runtime.py +146 -111
  109. ksadk/harness/runtime_capabilities.py +158 -0
  110. ksadk/harness/runtime_server.py +514 -0
  111. ksadk/harness/sandbox_adapters.py +739 -0
  112. ksadk/harness/sandbox_backend.py +530 -0
  113. ksadk/harness/sandbox_conformance.py +288 -0
  114. ksadk/harness/sandbox_lease.py +77 -0
  115. ksadk/harness/sandbox_lease_conformance.py +259 -0
  116. ksadk/harness/sandbox_matrix.py +170 -0
  117. ksadk/harness/sandbox_reconciliation.py +140 -0
  118. ksadk/harness/sandbox_recovery.py +586 -0
  119. ksadk/harness/sandbox_recovery_conformance.py +246 -0
  120. ksadk/harness/session_store.py +243 -0
  121. ksadk/harness/skill_composition.py +212 -0
  122. ksadk/harness/skill_feedback.py +123 -0
  123. ksadk/harness/skill_matrix.py +233 -0
  124. ksadk/harness/skill_runtime.py +259 -0
  125. ksadk/harness/spec.py +332 -0
  126. ksadk/harness/state.py +153 -0
  127. ksadk/harness/strategies.py +149 -0
  128. ksadk/harness/subagent.py +253 -0
  129. ksadk/harness/tool_policy.py +131 -0
  130. ksadk/harness/tool_receipts.py +96 -0
  131. ksadk/harness/tool_reliability.py +81 -0
  132. ksadk/harness/user_errors.py +69 -0
  133. ksadk/harness/working_context.py +81 -0
  134. ksadk/harness/working_context_patch.py +99 -0
  135. ksadk/identity/resolver.py +18 -0
  136. ksadk/interaction/__init__.py +1 -1
  137. ksadk/interaction/ledger.py +1 -1
  138. ksadk/interaction/provider.py +1 -1
  139. ksadk/interaction/providers/__init__.py +3 -1
  140. ksadk/interaction/providers/adk.py +1 -1
  141. ksadk/interaction/providers/codex.py +1 -1
  142. ksadk/interaction/providers/harness.py +50 -0
  143. ksadk/interaction/providers/langgraph.py +1 -1
  144. ksadk/kernel/__init__.py +10 -0
  145. ksadk/kernel/approval_presentation.py +91 -0
  146. ksadk/kernel/authorization.py +1 -1
  147. ksadk/kernel/bootstrap.py +86 -102
  148. ksadk/kernel/contract_fingerprints.py +1 -1
  149. ksadk/kernel/contracts.py +5 -0
  150. ksadk/kernel/control.py +32 -1
  151. ksadk/kernel/execution_grants.py +221 -0
  152. ksadk/kernel/execution_grants_memory.py +133 -0
  153. ksadk/kernel/execution_grants_postgres.py +217 -0
  154. ksadk/kernel/execution_grants_sqlite.py +209 -0
  155. ksadk/kernel/ingress.py +27 -27
  156. ksadk/kernel/mapping.py +1 -1
  157. ksadk/kernel/memory_store.py +24 -11
  158. ksadk/kernel/postgres_store.py +63 -33
  159. ksadk/kernel/recovery.py +78 -14
  160. ksadk/kernel/sql/001_agent_kernel.sql +23 -0
  161. ksadk/kernel/sqlite_store.py +304 -25
  162. ksadk/kernel/state.py +2 -3
  163. ksadk/kernel/store.py +69 -2
  164. ksadk/kernel/worker.py +79 -41
  165. ksadk/kernel/worker_history.py +72 -0
  166. ksadk/kernel/worker_identity.py +47 -0
  167. ksadk/memory/coordinator.py +22 -6
  168. ksadk/memory/extraction.py +40 -1
  169. ksadk/memory/models.py +77 -1
  170. ksadk/memory/provider_resolver.py +5 -0
  171. ksadk/memory/providers/local_postgres.py +200 -0
  172. ksadk/memory/providers/local_sqlite.py +42 -3
  173. ksadk/memory/retrieval.py +189 -0
  174. ksadk/memory/store_adapter.py +150 -0
  175. ksadk/model_policy.py +2 -2
  176. ksadk/model_proxy/detect.py +254 -0
  177. ksadk/model_proxy/server.py +4 -2
  178. ksadk/model_proxy/transform.py +40 -2
  179. ksadk/plugins/__init__.py +1 -1
  180. ksadk/plugins/bridges/dsh.py +11 -0
  181. ksadk/plugins/builtins.py +40 -2
  182. ksadk/plugins/companion_artifacts.py +83 -0
  183. ksadk/plugins/companions.py +368 -0
  184. ksadk/plugins/contracts.py +1 -1
  185. ksadk/plugins/dsh_channels.py +156 -0
  186. ksadk/plugins/dsh_home.py +140 -0
  187. ksadk/plugins/dsh_teams.py +105 -0
  188. ksadk/plugins/dsh_toolchain.py +101 -19
  189. ksadk/plugins/execution_host.py +99 -0
  190. ksadk/plugins/providers/bundles/dsh-channels-client/client.js +19 -0
  191. ksadk/plugins/providers/bundles/dsh-channels-client/cordis.patch.yml +3 -0
  192. ksadk/plugins/providers/bundles/dsh-channels-client/index.mjs +7 -0
  193. ksadk/plugins/providers/bundles/dsh-channels-client/package.json +12 -0
  194. ksadk/plugins/providers/bundles/dsh-knowledge/package.json +1 -1
  195. ksadk/plugins/providers/bundles/dsh-memory/package.json +1 -1
  196. ksadk/plugins/providers/bundles/dsh-skill-center/package.json +1 -1
  197. ksadk/plugins/providers/bundles/dsh-teams-client/client.js +29 -0
  198. ksadk/plugins/providers/bundles/dsh-teams-client/cordis.patch.yml +3 -0
  199. ksadk/plugins/providers/bundles/dsh-teams-client/index.mjs +11 -0
  200. ksadk/plugins/providers/bundles/dsh-teams-client/package.json +35 -0
  201. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/cordis.patch.yml +3 -0
  202. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/index.mjs +13 -0
  203. ksadk/plugins/providers/bundles/dsh-teams-leader-policy/package.json +27 -0
  204. ksadk/plugins/providers/bundles/dsh-teams-profile/cordis.patch.yml +3 -0
  205. ksadk/plugins/providers/bundles/dsh-teams-profile/index.mjs +12 -0
  206. ksadk/plugins/providers/bundles/dsh-teams-profile/package.json +26 -0
  207. ksadk/plugins/providers/bundles/dsh-teams-router/cordis.patch.yml +3 -0
  208. ksadk/plugins/providers/bundles/dsh-teams-router/index.mjs +16 -0
  209. ksadk/plugins/providers/bundles/dsh-teams-router/package.json +27 -0
  210. ksadk/plugins/providers/bundles/dsh-teams-tasks/cordis.patch.yml +3 -0
  211. ksadk/plugins/providers/bundles/dsh-teams-tasks/index.mjs +16 -0
  212. ksadk/plugins/providers/bundles/dsh-teams-tasks/package.json +27 -0
  213. ksadk/plugins/providers/bundles/dsh-teams-tools/cordis.patch.yml +3 -0
  214. ksadk/plugins/providers/bundles/dsh-teams-tools/index.mjs +25 -0
  215. ksadk/plugins/providers/bundles/dsh-teams-tools/package.json +29 -0
  216. ksadk/plugins/providers/bundles/dsh-teams-tools/tools.json +235 -0
  217. ksadk/plugins/providers/bundles/ksadk-codex/index.mjs +1 -1
  218. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/index.mjs +51 -1
  219. ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/package.json +2 -2
  220. ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/client.mjs +133 -0
  221. ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/index.mjs +14 -0
  222. ksadk/plugins/providers/bundles/ksadk-dsh-studio/client.js +27 -4
  223. ksadk/plugins/providers/bundles/ksadk-dsh-studio/index.mjs +9 -5
  224. ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +1 -1
  225. ksadk/plugins/providers/codex.py +10 -2
  226. ksadk/plugins/providers/dsh_capabilities.py +61 -0
  227. ksadk/plugins/providers/harness.py +181 -33
  228. ksadk/plugins/providers/harness_delegation.py +593 -0
  229. ksadk/plugins/providers/harness_managed.py +456 -0
  230. ksadk/plugins/providers/harness_tools.py +326 -0
  231. ksadk/plugins/providers/shipped_dsh.py +4 -1
  232. ksadk/plugins/subagent_providers/codex.py +28 -6
  233. ksadk/plugins/teams/__init__.py +5 -0
  234. ksadk/plugins/teams/api.py +405 -0
  235. ksadk/plugins/teams/application.py +680 -0
  236. ksadk/plugins/teams/artifacts.py +60 -0
  237. ksadk/plugins/teams/context.py +96 -0
  238. ksadk/plugins/teams/contracts.py +136 -0
  239. ksadk/plugins/teams/domain.py +1427 -0
  240. ksadk/plugins/teams/domain_values.py +24 -0
  241. ksadk/plugins/teams/errors.py +13 -0
  242. ksadk/plugins/teams/migration.py +311 -0
  243. ksadk/plugins/teams/migration_cli.py +322 -0
  244. ksadk/plugins/teams/postgres_store.py +138 -0
  245. ksadk/plugins/teams/runtime.py +777 -0
  246. ksadk/plugins/teams/source_projection.py +84 -0
  247. ksadk/plugins/teams/store.py +311 -0
  248. ksadk/plugins/teams/task_decisions.py +423 -0
  249. ksadk/plugins/teams/transport.py +91 -0
  250. ksadk/plugins/teams/workspaces.py +255 -0
  251. ksadk/runners/_langgraph_runner_streams.py +121 -45
  252. ksadk/runners/_langgraph_state_reader.py +106 -0
  253. ksadk/runners/_session_identity.py +285 -0
  254. ksadk/runners/adk_runner.py +25 -60
  255. ksadk/runners/langgraph_runner.py +128 -111
  256. ksadk/runners/patch_langchain.py +47 -0
  257. ksadk/runners/usage_accumulator.py +11 -3
  258. ksadk/runtime/_runner_adapter/stream_mapping.py +52 -2
  259. ksadk/runtime/conversation_execution.py +25 -1
  260. ksadk/runtime/executor.py +9 -1
  261. ksadk/runtime/factory.py +36 -1
  262. ksadk/runtime/preprocessing.py +11 -3
  263. ksadk/runtime/runner_adapter.py +38 -9
  264. ksadk/runtime/skill_eval_result.py +36 -0
  265. ksadk/runtime/timing.py +46 -0
  266. ksadk/runtime/usage.py +49 -18
  267. ksadk/runtime_context.py +103 -1
  268. ksadk/sandbox/backends/e2b.py +245 -23
  269. ksadk/sandbox/backends/local_process.py +63 -39
  270. ksadk/sandbox/base.py +62 -1
  271. ksadk/sandbox/diagnostics.py +82 -0
  272. ksadk/sandbox/local_controls.py +746 -0
  273. ksadk/sandbox/local_launcher.py +90 -0
  274. ksadk/scheduler/dispatcher.py +1 -1
  275. ksadk/server/invocation_identity.py +118 -0
  276. ksadk/server/routes/common.py +32 -3
  277. ksadk/server/routes/control.py +64 -9
  278. ksadk/server/routes/dependencies.py +2 -1
  279. ksadk/server/routes/kernel_ingress.py +9 -1
  280. ksadk/server/routes/misc.py +233 -25
  281. ksadk/server/routes/models.py +3 -3
  282. ksadk/server/routes/openai_compat.py +76 -13
  283. ksadk/server/routes/run.py +106 -35
  284. ksadk/server/routes/sessions.py +244 -68
  285. ksadk/server/routes/workspace.py +130 -21
  286. ksadk/server/static/assets/{ArtifactsPanel-CGbWlMNh.js → ArtifactsPanel-C1YoaKhx.js} +1 -1
  287. ksadk/server/static/assets/{CodeBlock-b4C7upmO.js → CodeBlock-DHuAWfr5.js} +10 -7
  288. ksadk/server/static/assets/MathMessageMarkdown-cvdrBwYr.js +8 -0
  289. ksadk/server/static/assets/{MermaidBlock-BEBN4Ksz.js → MermaidBlock-DeBkbJvI.js} +9 -9
  290. ksadk/server/static/assets/{NativeTerminalPanel-zvL-WpAn.js → NativeTerminalPanel-oJj44_sV.js} +1 -1
  291. ksadk/server/static/assets/{abnfDiagram-VCTEODGH-BYafW7Za.js → abnfDiagram-VCTEODGH-Dhfv25o2.js} +1 -1
  292. ksadk/server/static/assets/{arc-bTohInsS.js → arc-C35w-pn1.js} +1 -1
  293. ksadk/server/static/assets/architecture-7GRP2DOG-BCsa26zi.js +1 -0
  294. ksadk/server/static/assets/{architectureDiagram-5GKGNRK7-Ch5Lbzsi.js → architectureDiagram-5GKGNRK7-FoMY_u6D.js} +1 -1
  295. ksadk/server/static/assets/{blockDiagram-NRAW4CY4-kqF4MDOG.js → blockDiagram-NRAW4CY4-zD4Rt7oE.js} +1 -1
  296. ksadk/server/static/assets/{c4Diagram-UCG6FXSJ-8uSRIODv.js → c4Diagram-UCG6FXSJ-BCtGGkhN.js} +1 -1
  297. ksadk/server/static/assets/channel-_KDifNys.js +1 -0
  298. ksadk/server/static/assets/chunk-2Q5K7J3B-HdVkJ9F0.js +1 -0
  299. ksadk/server/static/assets/{chunk-5VM5RSS4-DkhehZDr.js → chunk-5VM5RSS4-C2Ms13_k.js} +1 -1
  300. ksadk/server/static/assets/{chunk-F27PBJKO-BdXhtPe9.js → chunk-F27PBJKO-BoTj-qgx.js} +1 -1
  301. ksadk/server/static/assets/{chunk-G27WJ6UU-DPTpvpwi.js → chunk-G27WJ6UU-DOMyyjHH.js} +1 -1
  302. ksadk/server/static/assets/{chunk-JWPE2WC7-Pqoh38el.js → chunk-JWPE2WC7-DbJJqDli.js} +1 -1
  303. ksadk/server/static/assets/{chunk-LCL6LL3I-DeU00qC-.js → chunk-LCL6LL3I-CLuRCt_W.js} +1 -1
  304. ksadk/server/static/assets/{chunk-POPQ4Y6H-CzxScFkr.js → chunk-POPQ4Y6H-D0Dz847e.js} +1 -1
  305. ksadk/server/static/assets/{chunk-RHFEMEQ7-DpqMx-ux.js → chunk-RHFEMEQ7-BWSRzEcd.js} +1 -1
  306. ksadk/server/static/assets/{chunk-SVP7TREG-C6t0SypQ.js → chunk-SVP7TREG-CPoHqkCY.js} +1 -1
  307. ksadk/server/static/assets/{chunk-XXDRQBXY-DVaeafZk.js → chunk-XXDRQBXY-Bx1jS-X-.js} +1 -1
  308. ksadk/server/static/assets/classDiagram-DTDB5LWJ-BVCW3ZqZ.js +1 -0
  309. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-BVCW3ZqZ.js +1 -0
  310. ksadk/server/static/assets/{cose-bilkent-JH36ORCC-Bf9D3tzJ.js → cose-bilkent-JH36ORCC-LzyWm4m0.js} +1 -1
  311. ksadk/server/static/assets/cynefin-OW5HDTMX-CNXjFctL.js +1 -0
  312. ksadk/server/static/assets/{cynefinDiagram-5FMLGOSQ-B9cY3iTz.js → cynefinDiagram-5FMLGOSQ-BlW_bHED.js} +1 -1
  313. ksadk/server/static/assets/{dagre-3AP2YEHR-CSwlx3CB.js → dagre-3AP2YEHR-Bu_S86_i.js} +1 -1
  314. ksadk/server/static/assets/{dagre-UBpgon5q.js → dagre-B7nCawed.js} +1 -1
  315. ksadk/server/static/assets/{diagram-S7CK7UJ4-C9akhN9a.js → diagram-S7CK7UJ4-W_Zow2Km.js} +1 -1
  316. ksadk/server/static/assets/{diagram-UQ7AKVKN-CgedhTPI.js → diagram-UQ7AKVKN-CLIKAHON.js} +1 -1
  317. ksadk/server/static/assets/{diagram-VSXAHHWV-Cjucz5BY.js → diagram-VSXAHHWV-Dv6_QAlN.js} +1 -1
  318. ksadk/server/static/assets/{diagram-VX7I27RA-Dd4Vleyn.js → diagram-VX7I27RA-BWAWRDtZ.js} +1 -1
  319. ksadk/server/static/assets/{diagram-Z3DM3KII-CZ2jGtYW.js → diagram-Z3DM3KII-XA_rWMss.js} +1 -1
  320. ksadk/server/static/assets/dist-0X_j2Rcc.js +1 -0
  321. ksadk/server/static/assets/{dist-DiixqL0J.js → dist-1nXCdsej.js} +1 -1
  322. ksadk/server/static/assets/{dist-BIr4DSRq.js → dist-2vL2sAdF.js} +1 -1
  323. ksadk/server/static/assets/{dist-D_ctSS2i.js → dist-B3bA05-e.js} +1 -1
  324. ksadk/server/static/assets/{dist-ClYUxfeK.js → dist-BLpRy_Yx.js} +1 -1
  325. ksadk/server/static/assets/{dist-QfkEHOlb.js → dist-BO_UwatH.js} +1 -1
  326. ksadk/server/static/assets/{dist-B3FR1SKK.js → dist-BdNFAney.js} +1 -1
  327. ksadk/server/static/assets/{dist-BnaTiyzN.js → dist-C0J5_3qM.js} +1 -1
  328. ksadk/server/static/assets/{dist-Bj730Ib4.js → dist-CGt_UGeO.js} +1 -1
  329. ksadk/server/static/assets/{dist-CFzsn6BG.js → dist-CIRMvUM4.js} +1 -1
  330. ksadk/server/static/assets/{dist-BgV_owcB.js → dist-CIpWk_5f.js} +1 -1
  331. ksadk/server/static/assets/{dist-C5_ZAZsG.js → dist-CPyieXEf.js} +1 -1
  332. ksadk/server/static/assets/{dist-btbmmX5O.js → dist-D-92S-Fd.js} +1 -1
  333. ksadk/server/static/assets/{dist-fBO2v5Kt.js → dist-DNKuMzWc.js} +1 -1
  334. ksadk/server/static/assets/{dist-ufY3F5p6.js → dist-DWfdmz9s.js} +2 -2
  335. ksadk/server/static/assets/{dist-DVCOWtha.js → dist-DppE_r-D.js} +1 -1
  336. ksadk/server/static/assets/{dist-C1NMAY5a.js → dist-DyG6Ya-z.js} +1 -1
  337. ksadk/server/static/assets/{dist-CB9iJrvg.js → dist-M-SrdhhZ.js} +1 -1
  338. ksadk/server/static/assets/{dist-DvFK7p5S.js → dist-mqD5TZup.js} +1 -1
  339. ksadk/server/static/assets/{dist-Cf125P_m.js → dist-n3n6t_FO.js} +1 -1
  340. ksadk/server/static/assets/{dist-DFD6Qa6T.js → dist-qe8xjesy.js} +1 -1
  341. ksadk/server/static/assets/{dist-DoVSwoDb.js → dist-t6MzE0jU.js} +1 -1
  342. ksadk/server/static/assets/{ebnfDiagram-PWID7BFC-Ci8NqqZu.js → ebnfDiagram-PWID7BFC-BfCzF1Xi.js} +1 -1
  343. ksadk/server/static/assets/{erDiagram-SSCWMZ5O-CCIOhLZG.js → erDiagram-SSCWMZ5O-Dpz9_0zn.js} +1 -1
  344. ksadk/server/static/assets/eventmodeling-NTZA5JFV-B5-8RH9c.js +1 -0
  345. ksadk/server/static/assets/flowDiagram-A5DVABFB-BppFxEKw.js +1 -0
  346. ksadk/server/static/assets/{ganttDiagram-EL5Y4UJY-Cp_r9Hb6.js → ganttDiagram-EL5Y4UJY-DDaG1f4_.js} +1 -1
  347. ksadk/server/static/assets/gitGraph-4MIJSDKK-B-AhYj4C.js +1 -0
  348. ksadk/server/static/assets/{gitGraphDiagram-WWUBYQGX-Dlhc8Wr8.js → gitGraphDiagram-WWUBYQGX-DcxzRwYC.js} +1 -1
  349. ksadk/server/static/assets/index-BMd2mucF.css +2 -0
  350. ksadk/server/static/assets/index-D5qyyhTH.js +244 -0
  351. ksadk/server/static/assets/info-A6RAGUB7-0uiKrC35.js +1 -0
  352. ksadk/server/static/assets/{infoDiagram-RXCK75RN-CO0rRTRA.js → infoDiagram-RXCK75RN-CYMdn6lQ.js} +1 -1
  353. ksadk/server/static/assets/{ishikawaDiagram-5VMMS53U-CHiaedSS.js → ishikawaDiagram-5VMMS53U-CLHFAD6c.js} +1 -1
  354. ksadk/server/static/assets/{journeyDiagram-EYS64GPL-CHcCIB09.js → journeyDiagram-EYS64GPL-BHSKQGAl.js} +1 -1
  355. ksadk/server/static/assets/{kanban-definition-3QL26DDD-CJ_ebBZf.js → kanban-definition-3QL26DDD-D5W3tjTT.js} +1 -1
  356. ksadk/server/static/assets/{katex-B4weu383.js → katex-mtjOi4KM.js} +1 -1
  357. ksadk/server/static/assets/{linear-V-MgYHW1.js → linear-BETqsxE_.js} +1 -1
  358. ksadk/server/static/assets/{mermaid-parser.core-CBijEX_c.js → mermaid-parser.core-DPWrvs90.js} +2 -2
  359. ksadk/server/static/assets/{mindmap-definition-FBJOCRG2-Bc-pQvpp.js → mindmap-definition-FBJOCRG2-CJG2mfBP.js} +1 -1
  360. ksadk/server/static/assets/packet-AYTQ26CC-BVTmZ_cw.js +1 -0
  361. ksadk/server/static/assets/{pegDiagram-XKGWAZYB-D7genGLl.js → pegDiagram-XKGWAZYB-GjAPNaqn.js} +1 -1
  362. ksadk/server/static/assets/pie-WAS4IAKB-DyfxBU7V.js +1 -0
  363. ksadk/server/static/assets/{pieDiagram-E7YTZNPT-Bxj32zwD.js → pieDiagram-E7YTZNPT-ToIewrqr.js} +1 -1
  364. ksadk/server/static/assets/{quadrantDiagram-AXDQQJYC-BURv2mGh.js → quadrantDiagram-AXDQQJYC-4d78KiEY.js} +1 -1
  365. ksadk/server/static/assets/radar-RG4KPBEZ-FFontjL2.js +1 -0
  366. ksadk/server/static/assets/railroad-74A4TZTK-D0Uidzen.js +1 -0
  367. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-BOo_9T2h.js +1 -0
  368. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-D6-BjW7Z.js +1 -0
  369. ksadk/server/static/assets/railroad-peg-WCYAUIDC-CXx__yMm.js +1 -0
  370. ksadk/server/static/assets/{railroadDiagram-O6MQD6OU-CCsh3avW.js → railroadDiagram-O6MQD6OU-DKzx4xfv.js} +1 -1
  371. ksadk/server/static/assets/{requirementDiagram-EFPCY7ZU-_FRRBKEd.js → requirementDiagram-EFPCY7ZU-CJYljxQS.js} +1 -1
  372. ksadk/server/static/assets/{sankeyDiagram-P5KCCOFB-C-gr2o9M.js → sankeyDiagram-P5KCCOFB-DLU2fV1w.js} +1 -1
  373. ksadk/server/static/assets/{sequenceDiagram-WJ2MYXX4-D97NmfKg.js → sequenceDiagram-WJ2MYXX4-CVqysrA9.js} +1 -1
  374. ksadk/server/static/assets/{sizeCapture-X5ZJPWSS-DjrPC5FX.js → sizeCapture-X5ZJPWSS-BUxfmTHc.js} +1 -1
  375. ksadk/server/static/assets/{stateDiagram-HBIQ2CUA-DzMNg1hh.js → stateDiagram-HBIQ2CUA-CNFgYI9E.js} +1 -1
  376. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BXAFScz8.js +1 -0
  377. ksadk/server/static/assets/{swimlanes-XN3QIQJK-Cssf_CsU.js → swimlanes-XN3QIQJK-B6qCMe8N.js} +1 -1
  378. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uIQ2lJKH.js +8 -0
  379. ksadk/server/static/assets/{timeline-definition-24CTP7MA-BWTHzyS1.js → timeline-definition-24CTP7MA-CMD3x_U_.js} +1 -1
  380. ksadk/server/static/assets/treeView-Q6P3EWNA-CK5GgucZ.js +1 -0
  381. ksadk/server/static/assets/treemap-WGGIJYW6-Bq1u1SpG.js +1 -0
  382. ksadk/server/static/assets/{vennDiagram-4TSXK5OY-BSKgJsmR.js → vennDiagram-4TSXK5OY-BqtUqvXM.js} +1 -1
  383. ksadk/server/static/assets/wardley-WFR3VGLG-QAt06uEz.js +1 -0
  384. ksadk/server/static/assets/{wardleyDiagram-VM6X3IG4-eflHNoaZ.js → wardleyDiagram-VM6X3IG4-B5KfDjI-.js} +1 -1
  385. ksadk/server/static/assets/{xychartDiagram-S5SC5T6Z-eYqrQ-v4.js → xychartDiagram-S5SC5T6Z-BaUlSZrn.js} +1 -1
  386. ksadk/server/static/index.html +2 -2
  387. ksadk/server/terminal_sessions.py +34 -2
  388. ksadk/sessions/invocation_identity.py +235 -0
  389. ksadk/skills/__init__.py +26 -0
  390. ksadk/skills/events.py +464 -0
  391. ksadk/skills/manifest_cache.py +263 -0
  392. ksadk/skills/mcp_server/__init__.py +0 -0
  393. ksadk/skills/mcp_server/_registry.py +33 -0
  394. ksadk/skills/mcp_server/_routing.py +26 -0
  395. ksadk/skills/mcp_server/_workspace_files.py +160 -0
  396. ksadk/skills/mcp_server/register.py +415 -0
  397. ksadk/skills/mcp_server/server.py +218 -0
  398. ksadk/skills/models.py +11 -0
  399. ksadk/skills/observability.py +132 -0
  400. ksadk/skills/package_store.py +75 -2
  401. ksadk/skills/runtime/agent.py +38 -5
  402. ksadk/skills/runtime/artifacts.py +87 -0
  403. ksadk/skills/runtime/backends/e2b.py +393 -52
  404. ksadk/skills/runtime/backends/local.py +621 -119
  405. ksadk/skills/runtime/base.py +78 -7
  406. ksadk/skills/runtime/executor.py +266 -1
  407. ksadk/skills/runtime/loader.py +108 -3
  408. ksadk/skills/runtime/request.py +18 -0
  409. ksadk/skills/tool_defs.py +108 -3
  410. ksadk/studio/api.py +592 -57
  411. ksadk/studio/api_contracts.py +8 -2
  412. ksadk/studio/api_plugin_routes.py +39 -12
  413. ksadk/studio/api_resource_connections.py +79 -41
  414. ksadk/studio/authoring.py +12 -6
  415. ksadk/studio/authoring_coordinator.py +4 -2
  416. ksadk/studio/builder.py +12 -0
  417. ksadk/studio/capabilities.py +23 -6
  418. ksadk/studio/channel_connections.py +333 -0
  419. ksadk/studio/cloud.py +30 -10
  420. ksadk/studio/cloud_shared_web.py +75 -2
  421. ksadk/studio/codex_agent_service.py +2 -2
  422. ksadk/studio/codex_builder.py +1 -1
  423. ksadk/studio/codex_run.py +6 -1
  424. ksadk/studio/compiler.py +10 -0
  425. ksadk/studio/configuration.py +182 -0
  426. ksadk/studio/contracts.py +33 -5
  427. ksadk/studio/dsh_application.py +135 -25
  428. ksadk/studio/dsh_capability_service.py +287 -20
  429. ksadk/studio/dsh_lifecycle.py +58 -0
  430. ksadk/studio/dsh_provider_registration.py +55 -16
  431. ksadk/studio/entry.py +53 -0
  432. ksadk/studio/event_store.py +36 -5
  433. ksadk/studio/execution_host.py +525 -0
  434. ksadk/studio/framework_run.py +32 -10
  435. ksadk/studio/hosted_kernel.py +1 -1
  436. ksadk/studio/kernel_registry.py +418 -0
  437. ksadk/studio/kernel_sqlite_migration.py +181 -0
  438. ksadk/studio/model_client.py +1178 -64
  439. ksadk/studio/model_profile_service.py +26 -11
  440. ksadk/studio/native_documents.py +172 -0
  441. ksadk/studio/plugin_composition.py +13 -2
  442. ksadk/studio/plugin_kernel_adapter.py +15 -0
  443. ksadk/studio/plugin_lifecycle.py +80 -0
  444. ksadk/studio/plugin_runtime.py +230 -17
  445. ksadk/studio/provider_recovery.py +59 -0
  446. ksadk/studio/recovery_page.py +70 -0
  447. ksadk/studio/resource_authority.py +59 -32
  448. ksadk/studio/resource_catalog.py +6 -0
  449. ksadk/studio/run_activity.py +895 -0
  450. ksadk/studio/run_documents.py +127 -0
  451. ksadk/studio/run_service.py +329 -33
  452. ksadk/studio/runtime_catalog.py +53 -10
  453. ksadk/studio/runtime_source.py +1 -1
  454. ksadk/studio/scheduler_runtime.py +32 -289
  455. ksadk/studio/service.py +398 -103
  456. ksadk/studio/shared_web.py +149 -36
  457. ksadk/studio/static/assets/ChannelsPage-D_PGmKVq.js +8 -0
  458. ksadk/studio/static/assets/CodeBlock-DMIf4h33-UIqo-BPW.js +44 -0
  459. ksadk/studio/static/assets/ExecutionTree-v3HexvPo-Bk8wzGSy.js +1 -0
  460. ksadk/studio/static/assets/MathMessageMarkdown-BesSeCYl-OhNwH4K9.js +8 -0
  461. ksadk/studio/static/assets/MermaidBlock-H_0qzQDf-BdXtxug_.js +11 -0
  462. ksadk/studio/static/assets/MessageMarkdown-CwMTvgFj-g0I-I4dD.js +59 -0
  463. ksadk/studio/static/assets/PrismRenderer-5pK6tUdb.js +3 -0
  464. ksadk/studio/static/assets/TeamsPage-DqX4HWKQ.js +3 -0
  465. ksadk/studio/static/assets/abnfDiagram-VCTEODGH-Bnb1O3tA.js +1 -0
  466. ksadk/studio/static/assets/architecture-7GRP2DOG-BMOPAkUC.js +1 -0
  467. ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-5Zn1gqJv.js +36 -0
  468. ksadk/studio/static/assets/{blockDiagram-I7D4REHJ-CFmPl1de.js → blockDiagram-I7D4REHJ-CLB4L11u.js} +6 -6
  469. ksadk/studio/static/assets/{c4Diagram-7LVT6UL2-BRrGu8qt.js → c4Diagram-7LVT6UL2-BOma_Z_F.js} +7 -7
  470. ksadk/studio/static/assets/channel-r8itPEik.js +1 -0
  471. ksadk/studio/static/assets/chunk-2E4U76K2-BFf_huql.js +2 -0
  472. ksadk/studio/static/assets/chunk-2ZTRR5NV-C2qZJila.js +2 -0
  473. ksadk/studio/static/assets/chunk-3Z5EZCMW-DMniOlPd.js +1 -0
  474. ksadk/studio/static/assets/{chunk-4HAMMTFA-D220vUtq.js → chunk-4HAMMTFA-DVtDP4rm.js} +7 -7
  475. ksadk/studio/static/assets/chunk-5V3GS4D5-i-ZDOEnP.js +1 -0
  476. ksadk/studio/static/assets/chunk-6AZGARVD-BB6FqMl-.js +1 -0
  477. ksadk/studio/static/assets/chunk-6EIED4P4-DdUJkP0f.js +1 -0
  478. ksadk/studio/static/assets/chunk-6K3QC6MW-CqVsVn-y.js +1 -0
  479. ksadk/studio/static/assets/chunk-6TQVIW2G-DKlLbNIP.js +1 -0
  480. ksadk/studio/static/assets/chunk-747NJXEK-BFkZPlab.js +2 -0
  481. ksadk/studio/static/assets/chunk-75Z2AOVW-BZNhM4vB.js +2 -0
  482. ksadk/studio/static/assets/chunk-CLGD4ZFX-D-GTtyKs.js +1 -0
  483. ksadk/studio/static/assets/{chunk-DU6HZSFF-C4DtVpCu.js → chunk-DU6HZSFF-CpEZCUgg.js} +1 -1
  484. ksadk/studio/static/assets/chunk-F27PBJKO-D7pvKf0C.js +1 -0
  485. ksadk/studio/static/assets/{chunk-GMAD6QVW-DiQA-u2N.js → chunk-GMAD6QVW-DE_8H717.js} +6 -6
  486. ksadk/studio/static/assets/chunk-GVQU2GXP-BfEB0lNv.js +1 -0
  487. ksadk/studio/static/assets/chunk-I5DQTOEV-Hm2LfiYI.js +1 -0
  488. ksadk/studio/static/assets/chunk-ICYGCRZG-749o-pGJ.js +1 -0
  489. ksadk/studio/static/assets/chunk-IH6LHLGP-CC6I9F3i.js +1 -0
  490. ksadk/studio/static/assets/{chunk-IMKFNOWR-BSlbjT_b.js → chunk-IMKFNOWR-D38axYOR.js} +5 -5
  491. ksadk/studio/static/assets/chunk-KI3K4JFJ-Rma-0k_M.js +1 -0
  492. ksadk/studio/static/assets/chunk-L3NEJ4N5-Dq5xn7aL.js +1 -0
  493. ksadk/studio/static/assets/chunk-LNGE3PJU-DWpGwHrW.js +34 -0
  494. ksadk/studio/static/assets/{chunk-OSK3NFVY-M2m6G3j4.js → chunk-OSK3NFVY-DiCQjx9b.js} +5 -5
  495. ksadk/studio/static/assets/chunk-OUJLGHUK-D0j2JRSg.js +2 -0
  496. ksadk/studio/static/assets/{chunk-P2QGCYS3-DezaQxiK.js → chunk-P2QGCYS3-VdhKmfYq.js} +1 -1
  497. ksadk/studio/static/assets/chunk-POPQ4Y6H-C1_rzO5M.js +1 -0
  498. ksadk/studio/static/assets/chunk-PWAF6VOD-B45HvflI.js +1 -0
  499. ksadk/studio/static/assets/{chunk-SHT3W25Y-DAyIVp5H.js → chunk-SHT3W25Y-DsCFnRVE.js} +9 -9
  500. ksadk/studio/static/assets/{chunk-SVP7TREG-DulomOrS.js → chunk-SVP7TREG-DljApgRX.js} +1 -1
  501. ksadk/studio/static/assets/{chunk-TICWLB2K-bHJYoflj.js → chunk-TICWLB2K-DWqRtyqa.js} +6 -6
  502. ksadk/studio/static/assets/chunk-TLUHSLCS-DUeGgnD5.js +2 -0
  503. ksadk/studio/static/assets/chunk-UY3FDG6J-CnmaAkG5.js +1 -0
  504. ksadk/studio/static/assets/chunk-XHIXRSVI-BFQ6B8BE.js +1 -0
  505. ksadk/studio/static/assets/chunk-XXDRQBXY-DqAYeljN.js +1 -0
  506. ksadk/studio/static/assets/classDiagram-ZZMXUADV-DjeMNJmu.js +1 -0
  507. ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-DjeMNJmu.js +1 -0
  508. ksadk/studio/static/assets/clsx-DB0hHKMi.js +1 -0
  509. ksadk/studio/static/assets/cose-bilkent-JH36ORCC-om8AY0Mc.js +1 -0
  510. ksadk/studio/static/assets/createLucideIcon-DR0LGTP5.js +1 -0
  511. ksadk/studio/static/assets/cynefin-OW5HDTMX-7tP7QfM3.js +1 -0
  512. ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-6BrmK52S.js +62 -0
  513. ksadk/studio/static/assets/dagre-GXQ25YYZ-buZBRlwz.js +4 -0
  514. ksadk/studio/static/assets/{diagram-S7CK7UJ4-0BZ98mya.js → diagram-S7CK7UJ4-C6aH78c4.js} +3 -3
  515. ksadk/studio/static/assets/diagram-UQ7AKVKN-DY_tQ6C_.js +41 -0
  516. ksadk/studio/static/assets/diagram-VSXAHHWV-DX9p5cQT.js +3 -0
  517. ksadk/studio/static/assets/diagram-VX7I27RA-DB2WSH8X.js +24 -0
  518. ksadk/studio/static/assets/diagram-Z3DM3KII-Ce1BJwHE.js +24 -0
  519. ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-Daukxwqf.js +1 -0
  520. ksadk/studio/static/assets/{erDiagram-RLTQ6QDP-DLGry2Ap.js → erDiagram-RLTQ6QDP-CGthTMmJ.js} +6 -6
  521. ksadk/studio/static/assets/eventmodeling-NTZA5JFV-BR2FzK4R.js +1 -0
  522. ksadk/studio/static/assets/flowDiagram-HODETNUW-CZ1tEenp.js +1 -0
  523. ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BfoAZW9X.js +292 -0
  524. ksadk/studio/static/assets/gitGraph-4MIJSDKK-DYlXv_yJ.js +1 -0
  525. ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-S985OIJF.js +106 -0
  526. ksadk/studio/static/assets/iconfont-4HN3C9Pg.woff2 +0 -0
  527. ksadk/studio/static/assets/index-CfEnms6Y.css +2 -0
  528. ksadk/studio/static/assets/index-Dp61rOWZ.js +0 -0
  529. ksadk/studio/static/assets/index.dom-BQenBtFm.js +1 -0
  530. ksadk/studio/static/assets/info-A6RAGUB7-BlU-8_xu.js +1 -0
  531. ksadk/studio/static/assets/infoDiagram-27XIBGKW-CO3W8tFn.js +2 -0
  532. ksadk/studio/static/assets/{ishikawaDiagram-5VMMS53U-CljI2wyf.js → ishikawaDiagram-5VMMS53U-BUGEl8cO.js} +2 -2
  533. ksadk/studio/static/assets/{journeyDiagram-3NMN7TZE-D50Fo2sL.js → journeyDiagram-3NMN7TZE-Ch2ZYxvr.js} +6 -6
  534. ksadk/studio/static/assets/{kanban-definition-UXKFOSKX-DimfOTam.js → kanban-definition-UXKFOSKX-Da-Fp4vC.js} +3 -3
  535. ksadk/studio/static/assets/kingsoft-cloud-BOcLiQ3e.ico +0 -0
  536. ksadk/studio/static/assets/{line-CX5BOOUP.js → line-BDaeq300.js} +1 -1
  537. ksadk/studio/static/assets/linear-DmucvK78.js +1 -0
  538. ksadk/studio/static/assets/mermaid-parser.core-Cj5mYdBi.js +4 -0
  539. ksadk/studio/static/assets/{mindmap-definition-YA3MSWOX-Bizzqy5R.js → mindmap-definition-YA3MSWOX-CvlsVQ38.js} +1 -1
  540. ksadk/studio/static/assets/packet-AYTQ26CC-BSJEH9Lb.js +1 -0
  541. ksadk/studio/static/assets/pegDiagram-XKGWAZYB-BuHuNgT5.js +1 -0
  542. ksadk/studio/static/assets/pie-WAS4IAKB-qxv01Y8W.js +1 -0
  543. ksadk/studio/static/assets/{pieDiagram-E7YTZNPT-B9mrFSDF.js → pieDiagram-E7YTZNPT-DlrWiSOv.js} +1 -1
  544. ksadk/studio/static/assets/preload-helper-CO68xz6u.js +1 -0
  545. ksadk/studio/static/assets/presentation-yYw7xK60-BmcZriri.js +1 -0
  546. ksadk/studio/static/assets/{quadrantDiagram-AXDQQJYC-NzUfCbMR.js → quadrantDiagram-AXDQQJYC-BA3hpUZM.js} +6 -6
  547. ksadk/studio/static/assets/radar-RG4KPBEZ-B6h6pWOs.js +1 -0
  548. ksadk/studio/static/assets/railroad-74A4TZTK-CGtTWdGc.js +1 -0
  549. ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-Cq7y22IA.js +1 -0
  550. ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-V0aQVv9m.js +1 -0
  551. ksadk/studio/static/assets/railroad-peg-WCYAUIDC-BQiIsX_p.js +1 -0
  552. ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-BxpAazym.js +1 -0
  553. ksadk/studio/static/assets/{requirementDiagram-BXWQKSXE-BF3d103U.js → requirementDiagram-BXWQKSXE-E-Ge0FcV.js} +1 -1
  554. ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-CA6YKhQ3.js +40 -0
  555. ksadk/studio/static/assets/{sequenceDiagram-WJ2MYXX4-Dh4wZtUm.js → sequenceDiagram-WJ2MYXX4-CcElXGg4.js} +9 -9
  556. ksadk/studio/static/assets/src-B6xuSHsQ.js +1 -0
  557. ksadk/studio/static/assets/stateDiagram-D77RDMKH-DdXZOFqY.js +1 -0
  558. ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-CJbOM-QK.js +1 -0
  559. ksadk/studio/static/assets/swimlanes-42K2YHIH-NtgEEHLY.js +1 -0
  560. ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-D-AVlW8B.js +8 -0
  561. ksadk/studio/static/assets/{timeline-definition-24CTP7MA-DxmSSjRB.js → timeline-definition-24CTP7MA-CIuYhNy3.js} +7 -7
  562. ksadk/studio/static/assets/treeView-Q6P3EWNA-BTTYcvrF.js +1 -0
  563. ksadk/studio/static/assets/treemap-WGGIJYW6-Cg7tyfH8.js +1 -0
  564. ksadk/studio/static/assets/vennDiagram-4TSXK5OY-7HbApbrv.js +34 -0
  565. ksadk/studio/static/assets/wardley-WFR3VGLG-C6N1rULY.js +1 -0
  566. ksadk/studio/static/assets/{wardleyDiagram-VM6X3IG4-Ba1AOWoe.js → wardleyDiagram-VM6X3IG4-CMJiaedy.js} +1 -1
  567. ksadk/studio/static/assets/{xychartDiagram-S5SC5T6Z-Cr5pt5Y-.js → xychartDiagram-S5SC5T6Z-BdgtMvW2.js} +6 -6
  568. ksadk/studio/static/index.html +8 -2
  569. ksadk/studio/teams_catalog.py +133 -0
  570. ksadk/studio/teams_installation.py +214 -0
  571. ksadk/studio/teams_node.py +545 -0
  572. ksadk/studio/teams_node_runner.py +69 -0
  573. ksadk/studio/teams_remote.py +274 -0
  574. ksadk/studio/templates.py +40 -19
  575. ksadk/studio/validator.py +13 -0
  576. ksadk/studio/workspace.py +19 -4
  577. ksadk/studio/workspace_plugins.py +136 -0
  578. ksadk/studio/workspace_registry.py +286 -0
  579. ksadk/toolsets/__init__.py +11 -0
  580. ksadk/toolsets/skills.py +446 -378
  581. ksadk/toolsets/workspace.py +3 -3
  582. ksadk/toolsets/workspace_identity.py +15 -0
  583. ksadk/version.py +1 -1
  584. ksadk_runtime_common/memory_backend/providers/lancedb.py +56 -2
  585. ksadk_runtime_common/schemas/memory_backend_manifest.schema.json +148 -148
  586. ksadk_runtime_common/workspace_files/router.py +26 -13
  587. ksadk/server/static/assets/MathMessageMarkdown-DbdW5A4_.js +0 -8
  588. ksadk/server/static/assets/architecture-7GRP2DOG-BW5UtSnx.js +0 -1
  589. ksadk/server/static/assets/channel-CF5Up3hQ.js +0 -1
  590. ksadk/server/static/assets/chunk-2Q5K7J3B-KkXX47WI.js +0 -1
  591. ksadk/server/static/assets/classDiagram-DTDB5LWJ-Cz81acRQ.js +0 -1
  592. ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Cz81acRQ.js +0 -1
  593. ksadk/server/static/assets/cynefin-OW5HDTMX-DVWs8a2t.js +0 -1
  594. ksadk/server/static/assets/dist-B2_CVgKv.js +0 -1
  595. ksadk/server/static/assets/eventmodeling-NTZA5JFV-CQqR2hg3.js +0 -1
  596. ksadk/server/static/assets/flowDiagram-A5DVABFB-DDRRbGPm.js +0 -1
  597. ksadk/server/static/assets/gitGraph-4MIJSDKK-fgWEf7UD.js +0 -1
  598. ksadk/server/static/assets/index-DcTML1Up.css +0 -2
  599. ksadk/server/static/assets/index-Dh2XHqPK.js +0 -244
  600. ksadk/server/static/assets/info-A6RAGUB7-BUecLTdt.js +0 -1
  601. ksadk/server/static/assets/packet-AYTQ26CC-BeW-btFv.js +0 -1
  602. ksadk/server/static/assets/pie-WAS4IAKB-X0xh4SaT.js +0 -1
  603. ksadk/server/static/assets/radar-RG4KPBEZ-DzRMSqjd.js +0 -1
  604. ksadk/server/static/assets/railroad-74A4TZTK-Cc44icX-.js +0 -1
  605. ksadk/server/static/assets/railroad-abnf-HS5TGJTU-D6S4BdV-.js +0 -1
  606. ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-vD3aVE2o.js +0 -1
  607. ksadk/server/static/assets/railroad-peg-WCYAUIDC-CYbW_b4T.js +0 -1
  608. ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BIcjKFhF.js +0 -1
  609. ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-tq3K3Ybl.js +0 -8
  610. ksadk/server/static/assets/treeView-Q6P3EWNA-DBXt3GdU.js +0 -1
  611. ksadk/server/static/assets/treemap-WGGIJYW6-DrCy4E_l.js +0 -1
  612. ksadk/server/static/assets/wardley-WFR3VGLG-CefhOliM.js +0 -1
  613. ksadk/studio/static/assets/CodeBlock-DCUUY0PL-BLjA7kbS.js +0 -41
  614. ksadk/studio/static/assets/MathMessageMarkdown-CBcDrAw--CUYIXwgI.js +0 -8
  615. ksadk/studio/static/assets/MermaidBlock-DBFTztfQ-BTYKWEbD.js +0 -44
  616. ksadk/studio/static/assets/PrismRenderer-wiXRHURw.js +0 -3
  617. ksadk/studio/static/assets/abnfDiagram-VCTEODGH-CLETGjKq.js +0 -1
  618. ksadk/studio/static/assets/architecture-7GRP2DOG-hXMiO_AU.js +0 -1
  619. ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-B5EQysk6.js +0 -36
  620. ksadk/studio/static/assets/channel-BqO-gtEw.js +0 -1
  621. ksadk/studio/static/assets/chunk-75Z2AOVW-C8lLv_qc.js +0 -2
  622. ksadk/studio/static/assets/chunk-F27PBJKO-Cpw14SNG.js +0 -1
  623. ksadk/studio/static/assets/chunk-GVQU2GXP-DUdNBUCi.js +0 -1
  624. ksadk/studio/static/assets/chunk-L3NEJ4N5-Db8Ab22W.js +0 -1
  625. ksadk/studio/static/assets/chunk-POPQ4Y6H-DOpufJ3t.js +0 -1
  626. ksadk/studio/static/assets/chunk-PWAF6VOD-CfLb1gSc.js +0 -1
  627. ksadk/studio/static/assets/chunk-XXDRQBXY-7PcdR2B1.js +0 -1
  628. ksadk/studio/static/assets/classDiagram-ZZMXUADV-D_bW8JjA.js +0 -1
  629. ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-D_bW8JjA.js +0 -1
  630. ksadk/studio/static/assets/cose-bilkent-JH36ORCC-snL88wkX.js +0 -1
  631. ksadk/studio/static/assets/cynefin-OW5HDTMX-Bd1YhRo1.js +0 -1
  632. ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-BBrIG_mI.js +0 -62
  633. ksadk/studio/static/assets/dagre-GXQ25YYZ-DtF1nGdY.js +0 -4
  634. ksadk/studio/static/assets/diagram-UQ7AKVKN-6mLKEo6L.js +0 -41
  635. ksadk/studio/static/assets/diagram-VSXAHHWV-CJBIaiZ2.js +0 -3
  636. ksadk/studio/static/assets/diagram-VX7I27RA-BohLEE1C.js +0 -24
  637. ksadk/studio/static/assets/diagram-Z3DM3KII-D8KIGonG.js +0 -24
  638. ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-C99HU61t.js +0 -1
  639. ksadk/studio/static/assets/eventmodeling-NTZA5JFV-B1_5Ac8j.js +0 -1
  640. ksadk/studio/static/assets/flowDiagram-HODETNUW-DD5hmicn.js +0 -1
  641. ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BPJrVLSG.js +0 -292
  642. ksadk/studio/static/assets/gitGraph-4MIJSDKK-Cy_ZQBGi.js +0 -1
  643. ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-CZCUz4MT.js +0 -106
  644. ksadk/studio/static/assets/index-CeHL9ARV.css +0 -2
  645. ksadk/studio/static/assets/index-D9QEcVpL.js +0 -320
  646. ksadk/studio/static/assets/info-A6RAGUB7-DBzDQB_I.js +0 -1
  647. ksadk/studio/static/assets/infoDiagram-27XIBGKW-B-sq07Hi.js +0 -2
  648. ksadk/studio/static/assets/linear-BCxN9JLv.js +0 -1
  649. ksadk/studio/static/assets/mermaid-parser.core-BdCz8fkS.js +0 -7
  650. ksadk/studio/static/assets/packet-AYTQ26CC-gPln-_kG.js +0 -1
  651. ksadk/studio/static/assets/pegDiagram-XKGWAZYB-Dy3fB-gW.js +0 -1
  652. ksadk/studio/static/assets/pie-WAS4IAKB-qZdHMr7B.js +0 -1
  653. ksadk/studio/static/assets/radar-RG4KPBEZ-BZlnaea9.js +0 -1
  654. ksadk/studio/static/assets/railroad-74A4TZTK-Ce3__H9c.js +0 -1
  655. ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-DqQn7EzD.js +0 -1
  656. ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-B55kCA8F.js +0 -1
  657. ksadk/studio/static/assets/railroad-peg-WCYAUIDC-DfQnvkHd.js +0 -1
  658. ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-DnhMjZCk.js +0 -1
  659. ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-Bo-JTwt0.js +0 -40
  660. ksadk/studio/static/assets/src-SFn9St9H.js +0 -1
  661. ksadk/studio/static/assets/stateDiagram-D77RDMKH-DH774G6d.js +0 -1
  662. ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-DZvVWPBo.js +0 -1
  663. ksadk/studio/static/assets/swimlanes-42K2YHIH-Bl13OvTX.js +0 -1
  664. ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-BnFOTALJ.js +0 -8
  665. ksadk/studio/static/assets/treeView-Q6P3EWNA-D5Nn9Swz.js +0 -1
  666. ksadk/studio/static/assets/treemap-WGGIJYW6-CgHgnQhE.js +0 -1
  667. ksadk/studio/static/assets/vennDiagram-4TSXK5OY-B9QEXcJq.js +0 -34
  668. ksadk/studio/static/assets/wardley-WFR3VGLG-DXrK2RRY.js +0 -1
  669. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/WHEEL +0 -0
  670. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/entry_points.txt +0 -0
  671. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/licenses/LICENSE +0 -0
  672. {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/top_level.txt +0 -0
  673. /ksadk/studio/static/assets/{MathMessageMarkdown-CBcDrAw--BEOyPC3w.css → MathMessageMarkdown-BesSeCYl-BEOyPC3w.css} +0 -0
@@ -0,0 +1,209 @@
1
+ """SQLite grants share BEGIN IMMEDIATE with admission and Inbox claim.
2
+
3
+ Receipts live in this same database, so a lost acknowledgement is resolved by
4
+ the original mutation key even after another transition or a process restart.
5
+ SessionEvent publication is not the authority for a grant barrier.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ from ksadk.kernel.contracts import AgentControlCommand
11
+ from ksadk.kernel.errors import InvalidCommandError
12
+ from ksadk.kernel.execution_grants import (
13
+ ExecutionGrantBarrier,
14
+ ExecutionGrantBlocked,
15
+ ExecutionGrantRecord,
16
+ ExecutionGrantSpec,
17
+ GrantState,
18
+ command_grant_error,
19
+ execution_grant_id,
20
+ grant_operation_digest,
21
+ make_grant_barrier,
22
+ require_grant_scope,
23
+ transition_grant,
24
+ )
25
+ from ksadk.kernel.store import now_iso
26
+
27
+ EXECUTION_GRANT_SCHEMA = """
28
+ CREATE TABLE IF NOT EXISTS kernel_execution_grants (
29
+ grant_id TEXT PRIMARY KEY,
30
+ tenant_id TEXT NOT NULL,
31
+ agent_instance_id TEXT NOT NULL,
32
+ session_id TEXT NOT NULL,
33
+ owner_ref TEXT NOT NULL,
34
+ state TEXT NOT NULL CHECK (state IN ('active','suspended','revoked')),
35
+ revision INTEGER NOT NULL CHECK (revision > 0),
36
+ created_at TEXT NOT NULL,
37
+ updated_at TEXT NOT NULL
38
+ );
39
+ CREATE INDEX IF NOT EXISTS idx_kernel_execution_grants_scope
40
+ ON kernel_execution_grants (tenant_id, agent_instance_id, session_id);
41
+ CREATE TABLE IF NOT EXISTS kernel_execution_grant_operations (
42
+ grant_id TEXT NOT NULL,
43
+ idempotency_key TEXT NOT NULL,
44
+ request_digest TEXT NOT NULL,
45
+ receipt_json TEXT NOT NULL,
46
+ PRIMARY KEY (grant_id, idempotency_key)
47
+ );
48
+ """
49
+
50
+
51
+ class SQLiteExecutionGrantMixin:
52
+ async def _sqlite_grant_record(self, connection, grant_id: str) -> ExecutionGrantRecord | None:
53
+ row = await self._fetchone(
54
+ connection, "SELECT * FROM kernel_execution_grants WHERE grant_id=?", (grant_id,)
55
+ )
56
+ return ExecutionGrantRecord.model_validate(dict(row)) if row is not None else None
57
+
58
+ async def ensure_execution_grant(self, spec: ExecutionGrantSpec) -> ExecutionGrantRecord:
59
+ async with self._write_lock:
60
+ connection = await self._begin()
61
+ try:
62
+ record = await self._sqlite_grant_record(connection, spec.grant_id)
63
+ if record is not None:
64
+ require_grant_scope(record, spec)
65
+ else:
66
+ record = ExecutionGrantRecord(
67
+ **spec.model_dump(), created_at=now_iso(), updated_at=now_iso()
68
+ )
69
+ await connection.execute(
70
+ "INSERT INTO kernel_execution_grants (grant_id, tenant_id, "
71
+ "agent_instance_id, "
72
+ "session_id, owner_ref, state, revision, created_at, updated_at) VALUES "
73
+ "(?,?,?,?,?,?,?,?,?)",
74
+ tuple(record.model_dump().values()),
75
+ )
76
+ await connection.commit()
77
+ return record
78
+ except BaseException:
79
+ await connection.rollback()
80
+ raise
81
+
82
+ async def _sqlite_grant_barrier(self, connection, record) -> ExecutionGrantBarrier:
83
+ cursor = await connection.execute(
84
+ "SELECT message_id FROM kernel_inbox WHERE agent_instance_id=? AND session_id=? "
85
+ "ORDER BY accepted_seq",
86
+ (record.agent_instance_id, record.session_id),
87
+ )
88
+ rows = await cursor.fetchall()
89
+ await cursor.close()
90
+ messages = [await self.load_message(row["message_id"]) for row in rows]
91
+ cursor = await connection.execute(
92
+ "SELECT run_id FROM kernel_runs WHERE agent_instance_id=? AND session_id=?",
93
+ (record.agent_instance_id, record.session_id),
94
+ )
95
+ rows = await cursor.fetchall()
96
+ await cursor.close()
97
+ runs = [await self.load_run(row["run_id"]) for row in rows]
98
+ return make_grant_barrier(record, [m for m in messages if m], [r for r in runs if r])
99
+
100
+ async def get_execution_grant(self, spec: ExecutionGrantSpec) -> ExecutionGrantBarrier | None:
101
+ async with self._write_lock:
102
+ connection = await self._begin()
103
+ try:
104
+ record = await self._sqlite_grant_record(connection, spec.grant_id)
105
+ if record is None:
106
+ await connection.commit()
107
+ return None
108
+ require_grant_scope(record, spec)
109
+ barrier = await self._sqlite_grant_barrier(connection, record)
110
+ await connection.commit()
111
+ return barrier
112
+ except BaseException:
113
+ await connection.rollback()
114
+ raise
115
+
116
+ async def set_execution_grant_state(
117
+ self,
118
+ spec: ExecutionGrantSpec,
119
+ state: GrantState,
120
+ *,
121
+ expected_revision: int,
122
+ idempotency_key: str,
123
+ ) -> ExecutionGrantBarrier:
124
+ if not idempotency_key or not idempotency_key.strip():
125
+ raise InvalidCommandError("grant mutation requires idempotency_key")
126
+ digest = grant_operation_digest(spec, state, expected_revision)
127
+ async with self._write_lock:
128
+ connection = await self._begin()
129
+ try:
130
+ record = await self._sqlite_grant_record(connection, spec.grant_id)
131
+ if record is None:
132
+ raise InvalidCommandError("execution grant not found")
133
+ require_grant_scope(record, spec)
134
+ previous = await self._fetchone(
135
+ connection,
136
+ "SELECT * FROM kernel_execution_grant_operations WHERE grant_id=? AND "
137
+ "idempotency_key=?",
138
+ (spec.grant_id, idempotency_key),
139
+ )
140
+ if previous is not None:
141
+ if previous["request_digest"] != digest:
142
+ raise InvalidCommandError("execution grant idempotency conflict")
143
+ await connection.commit()
144
+ return ExecutionGrantBarrier.model_validate_json(previous["receipt_json"])
145
+ updated = transition_grant(record, state, expected_revision, now_iso())
146
+ await connection.execute(
147
+ "UPDATE kernel_execution_grants SET state=?, revision=?, updated_at=? WHERE "
148
+ "grant_id=?",
149
+ (updated.state, updated.revision, updated.updated_at, spec.grant_id),
150
+ )
151
+ if state == "revoked":
152
+ await connection.execute(
153
+ "UPDATE kernel_inbox SET status='discarded' WHERE agent_instance_id=? "
154
+ "AND session_id=? "
155
+ "AND status='accepted' AND json_extract(payload_json, "
156
+ "'$.command_type')='enqueue' "
157
+ "AND json_extract(payload_json, '$.payload.execution_grant_id')=?",
158
+ (spec.agent_instance_id, spec.session_id, spec.grant_id),
159
+ )
160
+ barrier = await self._sqlite_grant_barrier(connection, updated)
161
+ await connection.execute(
162
+ "INSERT INTO kernel_execution_grant_operations "
163
+ "(grant_id, idempotency_key, request_digest, receipt_json) VALUES (?,?,?,?)",
164
+ (spec.grant_id, idempotency_key, digest, barrier.model_dump_json()),
165
+ )
166
+ await connection.commit()
167
+ return barrier
168
+ except BaseException:
169
+ await connection.rollback()
170
+ raise
171
+
172
+ async def _sqlite_admission_grant_error(self, connection, command) -> str | None:
173
+ grant_id = execution_grant_id(command)
174
+ if not grant_id:
175
+ return None
176
+ return command_grant_error(command, await self._sqlite_grant_record(connection, grant_id))
177
+
178
+ async def _sqlite_require_claim_grant(self, connection, row) -> None:
179
+ command = AgentControlCommand.model_validate_json(row["payload_json"])
180
+ grant_id = execution_grant_id(command)
181
+ if not grant_id:
182
+ return
183
+ record = await self._sqlite_grant_record(connection, grant_id)
184
+ error = command_grant_error(command, record)
185
+ if row["status"] == "claimed" and error in (None, "execution_grant_revoked"):
186
+ return
187
+ if error:
188
+ raise ExecutionGrantBlocked(
189
+ error.removeprefix("execution_grant_"), message_id=row["message_id"]
190
+ )
191
+ if record.state == "suspended":
192
+ raise ExecutionGrantBlocked("suspended", message_id=row["message_id"])
193
+ earlier = await self._fetchone(
194
+ connection,
195
+ "SELECT 1 FROM kernel_inbox WHERE agent_instance_id=? AND session_id=? "
196
+ "AND accepted_seq < ? AND status IN ('accepted','claimed') "
197
+ "AND json_extract(payload_json, '$.command_type')='enqueue' LIMIT 1",
198
+ (row["agent_instance_id"], row["session_id"], row["accepted_seq"]),
199
+ )
200
+ busy = await self._fetchone(
201
+ connection,
202
+ "SELECT 1 FROM kernel_runs WHERE agent_instance_id=? AND session_id=? "
203
+ "AND state IN ('pending','running','paused','waiting') LIMIT 1",
204
+ (row["agent_instance_id"], row["session_id"]),
205
+ )
206
+ if earlier or busy:
207
+ raise ExecutionGrantBlocked(
208
+ "queued" if earlier else "busy", message_id=row["message_id"]
209
+ )
ksadk/kernel/ingress.py CHANGED
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- """Agent Kernel ingress 收敛层(Phase 1 Task 8)。
2
+ """Agent Kernel ingress 收敛层(Kernel Task 8)。
3
3
 
4
4
  把 KsADK 现有五个入口(RunAgent / Responses / AG-UI / A2A / Studio)的
5
5
  mutation 统一收敛到 ``AgentKernel.submit``:
@@ -20,6 +20,7 @@ mutation 统一收敛到 ``AgentKernel.submit``:
20
20
  kernel 路径下命令的实际执行由 ``AgentWorker``(Task 6/7 交付)认领并驱动
21
21
  RuntimeAdapter;ingress 只 submit + 订阅投影,不直接触碰 RuntimeExecutor。
22
22
  """
23
+
23
24
  from __future__ import annotations
24
25
 
25
26
  import hashlib
@@ -220,15 +221,11 @@ def trusted_context(
220
221
  # mode the local signature remains unverifiable against Server JWKS, so
221
222
  # this does not create a Server-admission bypass.
222
223
  if agent_instance_id == "local-agent":
223
- agent_instance_id = (
224
- os.environ.get("AGENT_INSTANCE_ID", "").strip() or agent_instance_id
225
- )
224
+ agent_instance_id = os.environ.get("AGENT_INSTANCE_ID", "").strip() or agent_instance_id
226
225
  if launch_context is not None:
227
226
  config = getattr(launch_context, "config", None) or {}
228
227
  tenant_id = str(config.get("tenant_id") or tenant_id)
229
- agent_instance_id = str(
230
- config.get("agent_instance_id") or agent_instance_id
231
- )
228
+ agent_instance_id = str(config.get("agent_instance_id") or agent_instance_id)
232
229
  issuer = issuer or _default_issuer()
233
230
  permit = issuer.issue(
234
231
  tenant_id=tenant_id,
@@ -530,9 +527,7 @@ async def subscribe_projected(
530
527
  subscribe_kwargs["should_stop"] = should_stop
531
528
  if "timeout" in _params:
532
529
  subscribe_kwargs["timeout"] = timeout
533
- async for envelope in kernel.subscribe(
534
- subscription, permit=trusted.permit, **subscribe_kwargs
535
- ):
530
+ async for envelope in kernel.subscribe(subscription, permit=trusted.permit, **subscribe_kwargs):
536
531
  projected = envelope if projector is None else projector(envelope)
537
532
  if projected is None:
538
533
  continue
@@ -672,7 +667,9 @@ async def bootstrap_agent_kernel_from_env() -> Any | None:
672
667
  tenant_id=session_service.tenant_id,
673
668
  workspace_id=session_service.workspace_id,
674
669
  )
675
- store = PostgresAgentKernelStore(pool, event_log, owns_pool=True)
670
+ store = PostgresAgentKernelStore(
671
+ pool, event_log, tenant_id=session_service.tenant_id, owns_pool=True
672
+ )
676
673
  # typed RuntimeEvent 写路径走 fenced store:ActivationWriteGuard
677
674
  # append 与 activation 行验证同一事务(Task 4 Step 5)。
678
675
  events = PostgresFencedSessionEventStore(store)
@@ -746,6 +743,7 @@ def _env_permit_verifier(*, nonce_store: Any = None) -> Any:
746
743
  jwks_url = os.environ.get(ENV_JWKS_URL, "").strip()
747
744
  if jwks_url:
748
745
  from ksadk.kernel.authorization import AgentControlPermitVerifier
746
+
749
747
  source = _remote_jwks_source(jwks_url)
750
748
  if _is_hosted():
751
749
  # hosted 模式:server JWKS 是唯一信任源,绝不合并本地公钥。
@@ -783,12 +781,21 @@ async def _ensure_shared_log_session(command: Any) -> None:
783
781
  if service is None:
784
782
  return
785
783
  try:
786
- if await service.get_session(session_id) is None:
787
- await service.create_session(
788
- agent_id=str(getattr(command, "agent_instance_id", "") or "runtime"),
789
- user_id=str(getattr(command, "tenant_id", "") or "tenant"),
790
- session_id=session_id,
791
- )
784
+ from ksadk.conversations.runtime_persistence import ensure_conversation_session
785
+
786
+ payload = getattr(command, "payload", {})
787
+ identity = payload.get("invocation_identity") if isinstance(payload, Mapping) else None
788
+ agent_id = str(getattr(command, "agent_instance_id", "") or "runtime")
789
+ existing = await service.get_session_metadata(session_id)
790
+ if existing is not None and str(existing.agent_id or "").strip():
791
+ agent_id = str(existing.agent_id)
792
+ await ensure_conversation_session(
793
+ agent_id=agent_id,
794
+ user_id=str(getattr(command, "tenant_id", "") or "tenant"),
795
+ session_id=session_id,
796
+ session_service_provider=lambda: service,
797
+ invocation_identity=identity,
798
+ )
792
799
  except Exception:
793
800
  pass
794
801
 
@@ -949,9 +956,7 @@ def _build_kernel_router() -> Any:
949
956
  )
950
957
  # local 仅为开发便利自签,query 的 authorization_ref 必须同 permit
951
958
  # 本体一致,避免错误地用 caller 自报值触发恒 fail-closed。
952
- query = query.model_copy(
953
- update={"authorization_ref": trusted.permit.permit_id}
954
- )
959
+ query = query.model_copy(update={"authorization_ref": trusted.permit.permit_id})
955
960
  permit = trusted.permit
956
961
  snapshot = await kernel.status(query, permit=permit)
957
962
  return JSONResponse(json.loads(snapshot.model_dump_json()))
@@ -981,10 +986,7 @@ def _build_kernel_router() -> Any:
981
986
  content={
982
987
  "error": {
983
988
  "Code": "missing_resource_identity",
984
- "Message": (
985
- "hosted subscription requires tenant_id and "
986
- "agent_instance_id"
987
- ),
989
+ "Message": ("hosted subscription requires tenant_id and agent_instance_id"),
988
990
  }
989
991
  },
990
992
  )
@@ -1048,9 +1050,7 @@ def _build_kernel_router() -> Any:
1048
1050
  frame.setdefault("seq", seq)
1049
1051
  if not isinstance(envelope, dict):
1050
1052
  frame.setdefault("family", getattr(envelope, "family", None))
1051
- frame.setdefault(
1052
- "family_version", getattr(envelope, "family_version", None)
1053
- )
1053
+ frame.setdefault("family_version", getattr(envelope, "family_version", None))
1054
1054
  frame.setdefault("event_type", getattr(envelope, "event_type", None))
1055
1055
  if getattr(envelope, "run_id", None):
1056
1056
  frame.setdefault("run_id", envelope.run_id)
ksadk/kernel/mapping.py CHANGED
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- """command -> RuntimeAdapter 方法映射与 capability 判定(Phase 1 Task 6 Step 5)。
2
+ """command -> RuntimeAdapter 方法映射与 capability 判定(Kernel Task 6 Step 5)。
3
3
 
4
4
  映射表是唯一事实来源:enqueue 只在没有 active Run 时执行 start;
5
5
  steer/inject 只传给 native adapter method;每条命令产生的
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- """InMemory ``AgentKernelStore``(Phase 1 Task 3 Step 4)。
2
+ """InMemory ``AgentKernelStore``(Kernel Task 3 Step 4)。
3
3
 
4
4
  只用于单进程开发与 conformance 测试,不宣称跨进程 durable。
5
5
  以 per-(agent, session) asyncio lock 保证 accept/claim/transition 的原子语义;
@@ -16,15 +16,15 @@ from uuid import uuid4
16
16
 
17
17
  from ksadk.events.session_event import SessionEventStore
18
18
  from ksadk.interaction.contracts import (
19
- InteractionRecord,
20
19
  InteractionReceipt,
20
+ InteractionRecord,
21
21
  InteractionSubmission,
22
22
  is_terminal,
23
23
  )
24
24
  from ksadk.interaction.ledger import (
25
25
  ALREADY_RESOLVED,
26
- REVISION_MISMATCH,
27
26
  REQUEST_CONFLICT,
27
+ REVISION_MISMATCH,
28
28
  interaction_event,
29
29
  request_digest,
30
30
  requested_event_payload,
@@ -41,6 +41,7 @@ from ksadk.kernel.contracts import (
41
41
  SessionEventEnvelope,
42
42
  )
43
43
  from ksadk.kernel.errors import InvalidCommandError, StaleFenceError
44
+ from ksadk.kernel.execution_grants_memory import MemoryExecutionGrantMixin
44
45
  from ksadk.kernel.state import (
45
46
  InboxState,
46
47
  assert_inbox_transition,
@@ -58,7 +59,7 @@ from ksadk.kernel.store import (
58
59
  )
59
60
 
60
61
 
61
- class InMemoryAgentKernelStore:
62
+ class InMemoryAgentKernelStore(MemoryExecutionGrantMixin):
62
63
  def __init__(self, session_event_store: SessionEventStore) -> None:
63
64
  self._events = session_event_store
64
65
  self._locks: dict[tuple[str, str], asyncio.Lock] = {}
@@ -67,6 +68,8 @@ class InMemoryAgentKernelStore:
67
68
  self._accepted_seq: dict[str, int] = {}
68
69
  self._activations: dict[tuple[str, str], dict[str, Any]] = {}
69
70
  self._runs: dict[str, RunRecord] = {}
71
+ self._execution_grants = {}
72
+ self._execution_grant_operations = {}
70
73
  # Interaction ledger(Task 5):(tenant_id, interaction_id) -> row。
71
74
  self._interactions: dict[tuple[str, str], dict[str, Any]] = {}
72
75
  self._interaction_submissions: dict[tuple[str, str, str], dict[str, Any]] = {}
@@ -91,7 +94,9 @@ class InMemoryAgentKernelStore:
91
94
  def _lease_expired(row: dict[str, Any]) -> bool:
92
95
  return row["lease_expires_at"] <= time.time()
93
96
 
94
- def _check_fence(self, agent_instance_id: str, session_id: str, expected_fence: int) -> dict[str, Any]:
97
+ def _check_fence(
98
+ self, agent_instance_id: str, session_id: str, expected_fence: int
99
+ ) -> dict[str, Any]:
95
100
  row = self._activation_row(agent_instance_id, session_id)
96
101
  if (
97
102
  row is None
@@ -204,6 +209,12 @@ class InMemoryAgentKernelStore:
204
209
  accepted_seq=existing["accepted_seq"],
205
210
  )
206
211
 
212
+ grant_error = self._memory_admission_grant_error(command)
213
+ if grant_error:
214
+ return await self.reject_command(
215
+ command, status="rejected", code=grant_error, message=grant_error,
216
+ )
217
+
207
218
  depth = sum(
208
219
  1
209
220
  for row in self._messages.values()
@@ -356,7 +367,6 @@ class InMemoryAgentKernelStore:
356
367
  elif (
357
368
  fencing_token is not None
358
369
  and row["status"] == InboxState.CLAIMED
359
- and row["claimed_fence"] == int(fencing_token)
360
370
  ):
361
371
  rows.append(row)
362
372
  rows.sort(key=lambda row: row["accepted_seq"])
@@ -371,19 +381,21 @@ class InMemoryAgentKernelStore:
371
381
  raise InvalidCommandError(f"unknown message_id {message_id!r}")
372
382
  async with self._lock(row["agent_instance_id"], row["session_id"]):
373
383
  fresh = self._messages[str(message_id)]
384
+ activation = self._check_fence(
385
+ fresh["agent_instance_id"], fresh["session_id"], fencing_token
386
+ )
387
+ self._memory_require_claim_grant(fresh)
374
388
  if (
375
389
  fresh["status"] == InboxState.CLAIMED
376
390
  and fresh["claimed_fence"] == int(fencing_token)
377
391
  ):
378
392
  return self._to_message(fresh)
379
- activation = self._check_fence(
380
- fresh["agent_instance_id"], fresh["session_id"], fencing_token
381
- )
382
- if fresh["status"] != InboxState.ACCEPTED:
393
+ if fresh["status"] not in (InboxState.ACCEPTED, InboxState.CLAIMED):
383
394
  raise InvalidCommandError(
384
395
  f"message {message_id!r} is not claimable at status {fresh['status']}"
385
396
  )
386
- assert_inbox_transition(InboxState(fresh["status"]), InboxState.CLAIMED)
397
+ if fresh["status"] == InboxState.ACCEPTED:
398
+ assert_inbox_transition(InboxState(fresh["status"]), InboxState.CLAIMED)
387
399
  fresh["status"] = InboxState.CLAIMED
388
400
  fresh["claimed_fence"] = int(fencing_token)
389
401
  await self._emit(
@@ -513,6 +525,7 @@ class InMemoryAgentKernelStore:
513
525
  if not candidates:
514
526
  return None
515
527
  row = candidates[0]
528
+ self._memory_require_claim_grant(row)
516
529
  if row["status"] == InboxState.ACCEPTED:
517
530
  assert_inbox_transition(InboxState(row["status"]), InboxState.CLAIMED)
518
531
  row["status"] = InboxState.CLAIMED
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- """PostgreSQL ``AgentKernelStore``(Phase 1 Task 4)。
2
+ """PostgreSQL ``AgentKernelStore``(Kernel Task 4)。
3
3
 
4
4
  预发多写者 durable Inbox / Run / ActivationLease 存储:
5
5
  - schema 见 ``ksadk/kernel/sql/001_agent_kernel.sql``(BIGINT fencing_token、
@@ -31,15 +31,15 @@ from ksadk.events.session_event import (
31
31
  validate_write_guard,
32
32
  )
33
33
  from ksadk.interaction.contracts import (
34
- InteractionRecord,
35
34
  InteractionReceipt,
35
+ InteractionRecord,
36
36
  InteractionSubmission,
37
37
  is_terminal,
38
38
  )
39
39
  from ksadk.interaction.ledger import (
40
40
  ALREADY_RESOLVED,
41
- REVISION_MISMATCH,
42
41
  REQUEST_CONFLICT,
42
+ REVISION_MISMATCH,
43
43
  interaction_event,
44
44
  request_digest,
45
45
  requested_event_payload,
@@ -56,6 +56,8 @@ from ksadk.kernel.contracts import (
56
56
  SessionEventEnvelope,
57
57
  )
58
58
  from ksadk.kernel.errors import InvalidCommandError, StaleFenceError
59
+ from ksadk.kernel.execution_grants import execution_grant_id
60
+ from ksadk.kernel.execution_grants_postgres import PostgresExecutionGrantMixin
59
61
  from ksadk.kernel.state import (
60
62
  InboxState,
61
63
  RunState,
@@ -310,7 +312,7 @@ class PostgresNonceStore:
310
312
  )
311
313
 
312
314
 
313
- class PostgresAgentKernelStore:
315
+ class PostgresAgentKernelStore(PostgresExecutionGrantMixin):
314
316
  def __init__(
315
317
  self,
316
318
  pool: Any,
@@ -345,6 +347,8 @@ class PostgresAgentKernelStore:
345
347
  "DELETE FROM kernel_inbox; DELETE FROM kernel_runs;"
346
348
  " DELETE FROM kernel_activations; DELETE FROM kernel_accepted_seq;"
347
349
  " DELETE FROM kernel_interactions; DELETE FROM kernel_interaction_submissions;"
350
+ " DELETE FROM kernel_execution_grant_operations;"
351
+ " DELETE FROM kernel_execution_grants;"
348
352
  " DELETE FROM ksadk_events WHERE namespace = 'default';"
349
353
  )
350
354
 
@@ -433,6 +437,8 @@ class PostgresAgentKernelStore:
433
437
  raise InvalidCommandError("queue_limit must be positive")
434
438
  async with self._connection() as connection:
435
439
  async with connection.transaction():
440
+ if execution_grant_id(command):
441
+ await self._postgres_lock_command_grant(connection, command)
436
442
  existing = await connection.fetchrow(
437
443
  "SELECT message_id, accepted_seq, request_digest FROM kernel_inbox"
438
444
  " WHERE tenant_id=$1 AND session_id=$2 AND idempotency_key=$3",
@@ -474,6 +480,19 @@ class PostgresAgentKernelStore:
474
480
  accepted_seq=int(existing["accepted_seq"]),
475
481
  )
476
482
 
483
+ grant_error = await self._postgres_admission_grant_error(connection, command)
484
+ if grant_error:
485
+ await self._append_admission(connection, command, control_event(
486
+ session_id=command.session_id, event_type="control.command_rejected",
487
+ payload={
488
+ "command_id": str(command.command_id), "status": "rejected",
489
+ "reason": grant_error,
490
+ },
491
+ ))
492
+ return self._receipt(command, "rejected", error=ControlError(
493
+ code=grant_error, message=grant_error, retryable=False,
494
+ ))
495
+
477
496
  depth = await connection.fetchval(
478
497
  "SELECT COUNT(*) FROM kernel_inbox WHERE tenant_id=$1"
479
498
  " AND agent_instance_id=$2 AND session_id=$3 AND status='accepted'",
@@ -686,23 +705,29 @@ class PostgresAgentKernelStore:
686
705
  message_id = str(message_id)
687
706
  async with self._connection() as connection:
688
707
  async with connection.transaction():
708
+ # Lock grant before Inbox, matching the revocation lock order.
709
+ candidate = await connection.fetchrow(
710
+ "SELECT payload FROM kernel_inbox WHERE message_id=$1::uuid", message_id,
711
+ )
712
+ if candidate is None:
713
+ raise InvalidCommandError(f"unknown message_id {message_id!r}")
714
+ command = AgentControlCommand.model_validate_json(candidate["payload"])
715
+ grant = await self._postgres_lock_command_grant(connection, command)
689
716
  row = await connection.fetchrow(
690
717
  "SELECT * FROM kernel_inbox WHERE message_id=$1::uuid FOR UPDATE",
691
718
  message_id,
692
719
  )
693
720
  if row is None:
694
721
  raise InvalidCommandError(f"unknown message_id {message_id!r}")
722
+ activation = await self._assert_fence(
723
+ connection, row["agent_instance_id"], row["session_id"], fencing_token,
724
+ )
725
+ await self._postgres_require_claim_grant(connection, row, command, grant)
695
726
  if (
696
727
  row["status"] == InboxState.CLAIMED.value
697
728
  and int(row["claimed_fence"]) == int(fencing_token)
698
729
  ):
699
- return self._row_to_message(row) # type: ignore[return-value]
700
- activation = await self._assert_fence(
701
- connection,
702
- row["agent_instance_id"],
703
- row["session_id"],
704
- fencing_token,
705
- )
730
+ return self._row_to_message(row)
706
731
  if row["status"] not in (
707
732
  InboxState.ACCEPTED.value,
708
733
  InboxState.CLAIMED.value,
@@ -876,7 +901,7 @@ class PostgresAgentKernelStore:
876
901
  connection, agent_instance_id, session_id, fencing_token
877
902
  )
878
903
  row = await connection.fetchrow(
879
- "SELECT message_id, status FROM kernel_inbox"
904
+ "SELECT * FROM kernel_inbox"
880
905
  " WHERE agent_instance_id=$1 AND session_id=$2"
881
906
  " AND (status='accepted' OR (status='claimed' AND claimed_fence <> $3))"
882
907
  " ORDER BY accepted_seq"
@@ -888,27 +913,32 @@ class PostgresAgentKernelStore:
888
913
  )
889
914
  if row is None:
890
915
  return None
891
- if row["status"] == InboxState.ACCEPTED.value:
892
- assert_inbox_transition(InboxState(row["status"]), InboxState.CLAIMED)
893
- await connection.execute(
894
- "UPDATE kernel_inbox SET status='claimed', claimed_fence=$1"
895
- " WHERE message_id=$2::uuid",
896
- int(fencing_token),
897
- str(row["message_id"]),
898
- )
899
- await self._append_activation_fact(
900
- connection,
901
- control_event(
902
- session_id=session_id,
903
- event_type="control.message_claimed",
904
- payload={
905
- "message_id": str(row["message_id"]),
906
- "fencing_token": int(fencing_token),
907
- },
908
- ),
909
- activation,
910
- fencing_token,
911
- )
916
+ command = AgentControlCommand.model_validate_json(row["payload"])
917
+ grant_qualified_path = execution_grant_id(command) is not None
918
+ if not grant_qualified_path:
919
+ if row["status"] == InboxState.ACCEPTED.value:
920
+ assert_inbox_transition(InboxState(row["status"]), InboxState.CLAIMED)
921
+ await connection.execute(
922
+ "UPDATE kernel_inbox SET status='claimed', claimed_fence=$1"
923
+ " WHERE message_id=$2::uuid",
924
+ int(fencing_token),
925
+ str(row["message_id"]),
926
+ )
927
+ await self._append_activation_fact(
928
+ connection,
929
+ control_event(
930
+ session_id=session_id,
931
+ event_type="control.message_claimed",
932
+ payload={
933
+ "message_id": str(row["message_id"]),
934
+ "fencing_token": int(fencing_token),
935
+ },
936
+ ),
937
+ activation,
938
+ fencing_token,
939
+ )
940
+ if grant_qualified_path:
941
+ return await self.claim_message(str(row["message_id"]), fencing_token)
912
942
  return await self.load_message(row["message_id"])
913
943
 
914
944
  async def complete_claim(self, message_id: str, *, expected_fence: int) -> None: