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
@@ -5,13 +5,26 @@ from dataclasses import dataclass, field
5
5
  from pathlib import Path
6
6
  from typing import Protocol, Sequence
7
7
 
8
+ from ksadk.skills.events import SkillEvent, SkillInvocationPlan
8
9
  from ksadk.skills.package_store import SkillPackage
9
10
 
11
+ _SANDBOX_OBSERVABILITY_ENV_PREFIXES = ("OTEL_", "LANGFUSE_")
12
+ _SANDBOX_TRACE_ENV_NAMES = {"BAGGAGE", "TRACEPARENT", "TRACESTATE"}
13
+
10
14
 
11
15
  class SkillRuntimeError(RuntimeError):
12
16
  pass
13
17
 
14
18
 
19
+ def sandbox_runtime_env(env: dict[str, str]) -> dict[str, str]:
20
+ return {
21
+ name: value
22
+ for name, value in env.items()
23
+ if not name.startswith(_SANDBOX_OBSERVABILITY_ENV_PREFIXES)
24
+ and name not in _SANDBOX_TRACE_ENV_NAMES
25
+ }
26
+
27
+
15
28
  @dataclass(frozen=True)
16
29
  class SandboxInputFile:
17
30
  source: Path
@@ -29,13 +42,20 @@ class SkillRuntimeResult:
29
42
  error_type: str | None = None
30
43
  error_message: str | None = None
31
44
  output_files: list[str] = field(default_factory=list)
45
+ output_text: str = ""
46
+ output_text_truncated: bool = False
47
+ skill_events: list[SkillEvent] = field(default_factory=list)
48
+ workflow_status: str = ""
49
+ executed_skill: str = ""
50
+ instructions: str = ""
51
+ sandbox: dict[str, object] = field(default_factory=dict)
32
52
 
33
53
  @property
34
54
  def ok(self) -> bool:
35
55
  return self.exit_code == 0 and not self.error_type and not self.timed_out
36
56
 
37
57
  def to_dict(self) -> dict[str, object]:
38
- return {
58
+ result: dict[str, object] = {
39
59
  "runtime_id": self.runtime_id,
40
60
  "exit_code": self.exit_code,
41
61
  "stdout": self.stdout,
@@ -45,7 +65,19 @@ class SkillRuntimeResult:
45
65
  "error_type": self.error_type,
46
66
  "error_message": self.error_message,
47
67
  "output_files": list(self.output_files),
68
+ "workflow_status": self.workflow_status,
69
+ "executed_skill": self.executed_skill,
70
+ "instructions": self.instructions,
48
71
  }
72
+ if self.output_text:
73
+ result["output_text"] = self.output_text
74
+ if self.output_text_truncated:
75
+ result["output_text_truncated"] = True
76
+ if self.skill_events:
77
+ result["skill_events"] = [event.to_dict() for event in self.skill_events]
78
+ if self.sandbox:
79
+ result["sandbox"] = dict(self.sandbox)
80
+ return result
49
81
 
50
82
 
51
83
  class SkillRuntimeBackend(Protocol):
@@ -58,12 +90,26 @@ class SkillRuntimeBackend(Protocol):
58
90
  skill_names: list[str] | None = None,
59
91
  env: dict[str, str] | None = None,
60
92
  input_files: list[SandboxInputFile] | None = None,
93
+ invocation_plan: SkillInvocationPlan | None = None,
61
94
  pinned_packages: list[SkillPackage] | None = None,
62
95
  timeout: int = 900,
63
96
  ) -> SkillRuntimeResult: ...
64
97
 
65
98
 
66
- def parse_output_files(stdout: str) -> list[str]:
99
+ @dataclass(frozen=True)
100
+ class ParsedWorkflowResult:
101
+ output_files: tuple[str, ...] = ()
102
+ output_text: str = ""
103
+ output_text_truncated: bool = False
104
+ workflow_status: str = ""
105
+ executed_skill: str = ""
106
+ instructions: str = ""
107
+ error: str = ""
108
+ command_error_type: str = ""
109
+
110
+
111
+ def parse_workflow_result(stdout: str) -> ParsedWorkflowResult:
112
+ """Parse the workflow_result= JSON line from agent.py stdout."""
67
113
  for line in stdout.splitlines():
68
114
  if not line.startswith("workflow_result="):
69
115
  continue
@@ -71,11 +117,36 @@ def parse_output_files(stdout: str) -> list[str]:
71
117
  try:
72
118
  payload = json.loads(raw)
73
119
  except json.JSONDecodeError:
74
- return []
75
- output_files = payload.get("output_files") if isinstance(payload, dict) else None
76
- if isinstance(output_files, list):
77
- return [str(item) for item in output_files]
78
- return []
120
+ return ParsedWorkflowResult()
121
+ if not isinstance(payload, dict):
122
+ return ParsedWorkflowResult()
123
+ output_files = payload.get("output_files")
124
+ output_text = payload.get("output_text")
125
+ commands = payload.get("commands")
126
+ command_error_type = ""
127
+ if isinstance(commands, list):
128
+ for command in commands:
129
+ if isinstance(command, dict) and isinstance(command.get("error_type"), str):
130
+ command_error_type = command["error_type"]
131
+ break
132
+ return ParsedWorkflowResult(
133
+ output_files=(
134
+ tuple(str(item) for item in output_files) if isinstance(output_files, list) else ()
135
+ ),
136
+ output_text=output_text if isinstance(output_text, str) else "",
137
+ output_text_truncated=payload.get("output_text_truncated") is True,
138
+ workflow_status=str(payload.get("status") or ""),
139
+ executed_skill=str(payload.get("executed_skill") or ""),
140
+ instructions=str(payload.get("instructions") or ""),
141
+ error=str(payload.get("error") or ""),
142
+ command_error_type=command_error_type,
143
+ )
144
+ return ParsedWorkflowResult()
145
+
146
+
147
+ def parse_output_files(stdout: str) -> list[str]:
148
+ """Compatibility helper for callers that only need artifact paths."""
149
+ return list(parse_workflow_result(stdout).output_files)
79
150
 
80
151
 
81
152
  def normalize_skill_names(skill_names: Sequence[str] | str | None) -> list[str]:
@@ -4,12 +4,24 @@ import os
4
4
  import shutil
5
5
  import subprocess
6
6
  import tempfile
7
+ import uuid
7
8
  from dataclasses import dataclass, field
8
9
  from pathlib import Path
9
10
 
11
+ from ksadk.sandbox.local_controls import (
12
+ LocalControlSettings,
13
+ build_script_environment,
14
+ check_command,
15
+ controls_enabled,
16
+ resource_limit_reason,
17
+ run_bounded_process,
18
+ )
19
+ from ksadk.skills.events import SKILL_EVENT_FILE_ENV, SkillEvent, SkillEventSink
10
20
  from ksadk.skills.loader import LocalSkill
21
+ from ksadk.skills.models import SkillRef
11
22
  from ksadk.skills.runtime.artifacts import (
12
23
  collect_output_dir_artifacts,
24
+ collect_text_output,
13
25
  merge_artifacts,
14
26
  parse_artifact_lines,
15
27
  )
@@ -21,12 +33,15 @@ class WorkflowExecution:
21
33
  status: str
22
34
  executed_skill: str = ""
23
35
  output_files: list[str] = field(default_factory=list)
36
+ output_text: str = ""
37
+ output_text_truncated: bool = False
24
38
  commands: list[dict[str, object]] = field(default_factory=list)
25
39
  selected_skills: list[str] = field(default_factory=list)
26
40
  loaded_skills: list[str] = field(default_factory=list)
27
41
  artifacts: list[str] = field(default_factory=list)
28
42
  warnings: list[str] = field(default_factory=list)
29
43
  error: str = ""
44
+ instructions: str = ""
30
45
  artifact_bundle: dict[str, object] | None = None
31
46
 
32
47
 
@@ -35,6 +50,9 @@ def execute_workflow(
35
50
  skills: list[LocalSkill],
36
51
  *,
37
52
  selected_skill_names: list[str] | None = None,
53
+ event_sink: SkillEventSink | None = None,
54
+ skill_refs: dict[str, SkillRef] | None = None,
55
+ skill_invocation_ids: dict[str, str] | None = None,
38
56
  ) -> WorkflowExecution:
39
57
  selected = normalize_skill_names(selected_skill_names)
40
58
  loaded = [skill.name for skill in skills]
@@ -43,16 +61,39 @@ def execute_workflow(
43
61
 
44
62
  for skill in _candidate_skills(skills, selected):
45
63
  if _can_run_web_artifacts_builder(skill, prompt):
64
+ invocation_id, skill_ref = _execution_identity(skill, skill_refs, skill_invocation_ids)
65
+ _emit_execution(
66
+ event_sink, "skill.execution.started", "running", skill_ref, invocation_id
67
+ )
46
68
  result = _run_web_artifacts_builder(skill)
47
69
  _attach_context(result, selected=selected, loaded=loaded)
70
+ _emit_execution_result(event_sink, result, skill_ref, invocation_id)
48
71
  return result
49
72
 
50
73
  for skill in _candidate_skills(skills, selected):
51
74
  if _can_run_generic_workflow(skill):
75
+ invocation_id, skill_ref = _execution_identity(skill, skill_refs, skill_invocation_ids)
76
+ _emit_execution(
77
+ event_sink, "skill.execution.started", "running", skill_ref, invocation_id
78
+ )
52
79
  result = _run_generic_workflow(skill, prompt)
53
80
  _attach_context(result, selected=selected, loaded=loaded)
81
+ _emit_execution_result(event_sink, result, skill_ref, invocation_id)
54
82
  return result
55
83
 
84
+ for skill in _candidate_skills(skills, selected):
85
+ invocation_id, skill_ref = _execution_identity(skill, skill_refs, skill_invocation_ids)
86
+ if _has_instructions(skill):
87
+ _emit_execution(
88
+ event_sink, "skill.execution.started", "running", skill_ref, invocation_id
89
+ )
90
+ result = _run_instruction_only(skill, prompt)
91
+ _attach_context(result, selected=selected, loaded=loaded)
92
+ _emit_execution_result(event_sink, result, skill_ref, invocation_id)
93
+ return result
94
+ _emit_execution(
95
+ event_sink, "skill.execution.completed", "skipped", skill_ref, invocation_id
96
+ )
56
97
  return WorkflowExecution(
57
98
  status="skipped",
58
99
  selected_skills=selected,
@@ -73,6 +114,85 @@ def _attach_context(result: WorkflowExecution, *, selected: list[str], loaded: l
73
114
  result.loaded_skills = loaded
74
115
  if not result.artifacts:
75
116
  result.artifacts = list(result.output_files)
117
+ result.output_text, result.output_text_truncated = collect_text_output(
118
+ result.artifacts,
119
+ allowed_root=_skill_workdir(),
120
+ max_bytes=_output_text_limit(),
121
+ )
122
+
123
+
124
+ def _execution_identity(
125
+ skill: LocalSkill,
126
+ skill_refs: dict[str, SkillRef] | None,
127
+ skill_invocation_ids: dict[str, str] | None,
128
+ ) -> tuple[str, SkillRef | None]:
129
+ skill_ref = (skill_refs or {}).get(skill.name)
130
+ invocation_id = (skill_invocation_ids or {}).get(skill.name) or f"skill_inv_{uuid.uuid4().hex}"
131
+ return invocation_id, skill_ref
132
+
133
+
134
+ def _emit_execution(
135
+ event_sink: SkillEventSink | None,
136
+ event_type: str,
137
+ status: str,
138
+ skill_ref: SkillRef | None,
139
+ invocation_id: str,
140
+ *,
141
+ error_category: str = "",
142
+ ) -> None:
143
+ if event_sink is not None:
144
+ event_sink.emit(
145
+ SkillEvent.create(
146
+ event_type,
147
+ status=status,
148
+ skill_ref=skill_ref,
149
+ skill_invocation_id=invocation_id,
150
+ error_category=error_category,
151
+ )
152
+ )
153
+
154
+
155
+ def _emit_execution_result(
156
+ event_sink: SkillEventSink | None,
157
+ result: WorkflowExecution,
158
+ skill_ref: SkillRef | None,
159
+ invocation_id: str,
160
+ ) -> None:
161
+ status = "failed" if result.status in ("failed", "error") else "completed"
162
+ error_category = ""
163
+ if any(command.get("timed_out") for command in result.commands):
164
+ error_category = "timeout"
165
+ elif any(command.get("status") == "blocked" for command in result.commands):
166
+ error_category = "safety_policy"
167
+ elif any(command.get("output_limit_exceeded") for command in result.commands):
168
+ error_category = "output_limit"
169
+ elif any(command.get("resource_limit") for command in result.commands):
170
+ error_category = "resource_limit"
171
+ _emit_execution(
172
+ event_sink,
173
+ f"skill.execution.{status}",
174
+ status,
175
+ skill_ref,
176
+ invocation_id,
177
+ error_category=error_category,
178
+ )
179
+ if event_sink is None:
180
+ return
181
+ for index, artifact in enumerate(result.artifacts):
182
+ artifact_path = Path(artifact)
183
+ event_sink.emit(
184
+ SkillEvent.create(
185
+ "skill.artifact.created",
186
+ status="completed",
187
+ skill_ref=skill_ref,
188
+ skill_invocation_id=invocation_id,
189
+ attributes={
190
+ "artifact_ref": f"{invocation_id}:{index}",
191
+ "artifact_name": artifact_path.name,
192
+ "size_bytes": artifact_path.stat().st_size if artifact_path.exists() else 0,
193
+ },
194
+ )
195
+ )
76
196
 
77
197
 
78
198
  def _can_run_web_artifacts_builder(skill: LocalSkill, prompt: str) -> bool:
@@ -93,6 +213,23 @@ def _can_run_generic_workflow(skill: LocalSkill) -> bool:
93
213
  return (skill.root_dir / "scripts" / "run-workflow.sh").exists()
94
214
 
95
215
 
216
+ def _has_instructions(skill: LocalSkill) -> bool:
217
+ has_scripts = (skill.root_dir / "scripts").is_dir()
218
+ return not has_scripts and bool(skill.body and skill.body.strip())
219
+
220
+
221
+ def _run_instruction_only(skill: LocalSkill, prompt: str) -> WorkflowExecution:
222
+ return WorkflowExecution(
223
+ status="instructions",
224
+ executed_skill=skill.name,
225
+ instructions=skill.body,
226
+ warnings=[
227
+ "This skill is instruction-only (no executable scripts). "
228
+ "Follow the instructions below using your available tools."
229
+ ],
230
+ )
231
+
232
+
96
233
  def _run_web_artifacts_builder(skill: LocalSkill) -> WorkflowExecution:
97
234
  workdir = _skill_workdir()
98
235
  project_name = _safe_project_name(
@@ -101,6 +238,24 @@ def _run_web_artifacts_builder(skill: LocalSkill) -> WorkflowExecution:
101
238
  project_dir = workdir / project_name
102
239
  workdir.mkdir(parents=True, exist_ok=True)
103
240
  if project_dir.exists():
241
+ if project_dir.is_symlink() or project_dir.resolve().parent != workdir.resolve():
242
+ return WorkflowExecution(
243
+ status="failed",
244
+ executed_skill=skill.name,
245
+ commands=[
246
+ {
247
+ "command": "prepare artifact project",
248
+ "cwd": str(workdir),
249
+ "exit_code": 126,
250
+ "status": "blocked",
251
+ "error_type": "SafetyPolicyViolation",
252
+ "blocked_reason": (
253
+ "path.project_directory_boundary: existing artifact project path "
254
+ "must be a real directory directly inside the Skill workdir"
255
+ ),
256
+ }
257
+ ],
258
+ )
104
259
  shutil.rmtree(project_dir)
105
260
 
106
261
  timeout = _runtime_timeout()
@@ -109,15 +264,22 @@ def _run_web_artifacts_builder(skill: LocalSkill) -> WorkflowExecution:
109
264
  ["bash", str(skill.root_dir / "scripts" / "init-artifact.sh"), project_name],
110
265
  cwd=workdir,
111
266
  timeout=timeout,
267
+ allowed_roots=(workdir, skill.root_dir),
112
268
  )
113
269
  commands.append(init_result)
114
270
  if init_result["exit_code"] != 0:
115
- return WorkflowExecution(status="failed", executed_skill=skill.name, commands=commands)
271
+ return WorkflowExecution(
272
+ status="failed",
273
+ executed_skill=skill.name,
274
+ commands=commands,
275
+ error=_command_error(init_result),
276
+ )
116
277
 
117
278
  bundle_result = _run_command(
118
279
  ["bash", str(skill.root_dir / "scripts" / "bundle-artifact.sh")],
119
280
  cwd=project_dir,
120
281
  timeout=timeout,
282
+ allowed_roots=(workdir, skill.root_dir),
121
283
  )
122
284
  commands.append(bundle_result)
123
285
  output_files = (
@@ -130,6 +292,7 @@ def _run_web_artifacts_builder(skill: LocalSkill) -> WorkflowExecution:
130
292
  output_files=output_files,
131
293
  artifacts=list(output_files),
132
294
  commands=commands,
295
+ error=_command_error(bundle_result) if status == "failed" else "",
133
296
  )
134
297
 
135
298
 
@@ -143,6 +306,7 @@ def _run_generic_workflow(skill: LocalSkill, prompt: str) -> WorkflowExecution:
143
306
  ["bash", str(skill.root_dir / "scripts" / "run-workflow.sh")],
144
307
  cwd=workdir,
145
308
  timeout=timeout,
309
+ allowed_roots=(workdir, skill.root_dir),
146
310
  extra_env={
147
311
  "KSADK_WORKFLOW_PROMPT": prompt,
148
312
  "KSADK_SKILL_WORKDIR": str(workdir),
@@ -161,6 +325,7 @@ def _run_generic_workflow(skill: LocalSkill, prompt: str) -> WorkflowExecution:
161
325
  output_files=list(artifacts),
162
326
  artifacts=list(artifacts),
163
327
  commands=[command],
328
+ error=_command_error(command) if status == "failed" else "",
164
329
  )
165
330
 
166
331
 
@@ -177,8 +342,18 @@ def _run_command(
177
342
  cwd: Path,
178
343
  timeout: int,
179
344
  extra_env: dict[str, str] | None = None,
345
+ allowed_roots: tuple[Path, ...] | None = None,
180
346
  ) -> dict[str, object]:
347
+ if controls_enabled():
348
+ return _run_controlled_command(
349
+ args,
350
+ cwd=cwd,
351
+ timeout=timeout,
352
+ extra_env=extra_env,
353
+ allowed_roots=allowed_roots or (cwd,),
354
+ )
181
355
  env = os.environ.copy()
356
+ env.pop(SKILL_EVENT_FILE_ENV, None)
182
357
  env.setdefault("CI", "1")
183
358
  env.update(extra_env or {})
184
359
  try:
@@ -209,6 +384,79 @@ def _run_command(
209
384
  }
210
385
 
211
386
 
387
+ def _run_controlled_command(
388
+ args: list[str],
389
+ *,
390
+ cwd: Path,
391
+ timeout: int,
392
+ extra_env: dict[str, str] | None,
393
+ allowed_roots: tuple[Path, ...],
394
+ ) -> dict[str, object]:
395
+ command_text = " ".join(args)
396
+ try:
397
+ settings = LocalControlSettings.from_runtime_env()
398
+ except (TypeError, ValueError) as exc:
399
+ return {
400
+ "command": command_text,
401
+ "cwd": str(cwd),
402
+ "exit_code": 125,
403
+ "status": "failed",
404
+ "error_type": "LocalControlConfigurationError",
405
+ "error_message": str(exc),
406
+ "controls": {"status": "failed"},
407
+ }
408
+ finding = check_command(args, cwd=cwd, allowed_roots=allowed_roots)
409
+ if finding is not None:
410
+ return {
411
+ "command": command_text,
412
+ "cwd": str(cwd),
413
+ "exit_code": 126,
414
+ "status": "blocked",
415
+ "error_type": "SafetyPolicyViolation",
416
+ "blocked_reason": finding.reason(),
417
+ "controls": {"status": "blocked", "static_check": finding.rule},
418
+ }
419
+ required = dict(extra_env or {})
420
+ required.setdefault("TMPDIR", str(cwd))
421
+ env = build_script_environment(os.environ, settings=settings, required=required)
422
+ executed = run_bounded_process(
423
+ args,
424
+ cwd=cwd,
425
+ env=env,
426
+ timeout=min(timeout, settings.wall_seconds),
427
+ settings=settings,
428
+ # The outer local runtime owns the process group and always cleans it.
429
+ # Starting a nested session here would let commands outlive outer timeout.
430
+ start_new_session=False,
431
+ )
432
+ result: dict[str, object] = {
433
+ "command": command_text,
434
+ "cwd": str(cwd),
435
+ "exit_code": executed.exit_code,
436
+ "stdout": executed.stdout,
437
+ "stderr": executed.stderr,
438
+ "controls": executed.controls,
439
+ "cleanup_status": "deferred_to_runtime_process_group",
440
+ }
441
+ if executed.timed_out:
442
+ result.update(timed_out=True, status="failed", error_type="TimeoutExpired")
443
+ if executed.output_limit_exceeded:
444
+ result.update(
445
+ status="failed",
446
+ error_type="OutputLimitExceeded",
447
+ output_limit_exceeded=True,
448
+ )
449
+ if executed.stdout_truncated:
450
+ result["stdout_truncated"] = True
451
+ if executed.stderr_truncated:
452
+ result["stderr_truncated"] = True
453
+ if executed.controls.get("status") == "failed":
454
+ result.update(status="failed", error_type="ResourceLimitSetupError")
455
+ if limit := resource_limit_reason(executed.exit_code):
456
+ result.update(status="failed", error_type="ResourceLimitExceeded", resource_limit=limit)
457
+ return result
458
+
459
+
212
460
  def _runtime_timeout() -> int:
213
461
  try:
214
462
  return int(os.environ.get("KSADK_SKILL_RUNTIME_TIMEOUT", "900"))
@@ -216,6 +464,23 @@ def _runtime_timeout() -> int:
216
464
  return 900
217
465
 
218
466
 
467
+ def _command_error(command: dict[str, object]) -> str:
468
+ return str(
469
+ command.get("blocked_reason")
470
+ or command.get("error_message")
471
+ or command.get("error_type")
472
+ or "Skill command failed"
473
+ )
474
+
475
+
476
+ def _output_text_limit() -> int:
477
+ try:
478
+ configured = int(os.environ.get("KSADK_SKILL_OUTPUT_TEXT_MAX_BYTES", "65536"))
479
+ except ValueError:
480
+ configured = 65536
481
+ return min(max(configured, 0), 1024 * 1024)
482
+
483
+
219
484
  def _safe_project_name(raw: str) -> str:
220
485
  sanitized = "".join(ch if ch.isalnum() or ch in {"-", "_"} else "-" for ch in raw).strip("-_")
221
486
  return sanitized[:80] or "ksadk-artifact"
@@ -3,11 +3,14 @@ from __future__ import annotations
3
3
  import os
4
4
  import shutil
5
5
  import tempfile
6
+ import time
7
+ import uuid
6
8
  from dataclasses import dataclass, field
7
9
  from pathlib import Path
8
10
 
9
11
  import httpx
10
12
 
13
+ from ksadk.skills.events import SkillEvent, SkillEventSink
11
14
  from ksadk.skills.loader import LocalSkill, load_local_skill
12
15
  from ksadk.skills.models import SkillRef
13
16
  from ksadk.skills.package_store import PackageStore, SkillPackageError
@@ -20,6 +23,8 @@ from ksadk.skills.service_env import resolve_skill_service_url
20
23
  class SkillLoadResult:
21
24
  skills: list[LocalSkill] = field(default_factory=list)
22
25
  warnings: list[str] = field(default_factory=list)
26
+ skill_refs: dict[str, SkillRef] = field(default_factory=dict)
27
+ skill_invocation_ids: dict[str, str] = field(default_factory=dict)
23
28
 
24
29
 
25
30
  def load_skills(
@@ -27,6 +32,8 @@ def load_skills(
27
32
  prompt: str = "",
28
33
  skill_names: list[str] | None = None,
29
34
  service_transport: httpx.BaseTransport | None = None,
35
+ event_sink: SkillEventSink | None = None,
36
+ planned_invocations: dict[str, str] | None = None,
30
37
  ) -> SkillLoadResult:
31
38
  warnings: list[str] = []
32
39
  skills: list[LocalSkill] = []
@@ -77,19 +84,90 @@ def load_skills(
77
84
  )
78
85
  )
79
86
 
87
+ skill_refs: dict[str, SkillRef] = {}
88
+ skill_invocation_ids: dict[str, str] = {}
80
89
  for skill in selected_refs:
90
+ if planned_invocations is not None and skill.skill_id not in planned_invocations:
91
+ continue
92
+ invocation_id = (planned_invocations or {}).get(skill.skill_id)
93
+ invocation_id = invocation_id or f"skill_inv_{uuid.uuid4().hex}"
81
94
  package = store.get_cached(skill)
82
95
  if package is None:
96
+ downloaded_at = time.time()
83
97
  archive = client.download_skill_archive(skill)
98
+ _emit(
99
+ event_sink,
100
+ "skill.package.downloaded",
101
+ skill_ref=skill,
102
+ skill_invocation_id=invocation_id,
103
+ status="completed",
104
+ started_at=downloaded_at,
105
+ ended_at=time.time(),
106
+ )
84
107
  try:
85
- package = store.store_archive(skill, archive)
108
+ package = store.store_archive(
109
+ skill,
110
+ archive,
111
+ event_sink=event_sink,
112
+ skill_invocation_id=invocation_id,
113
+ )
86
114
  except SkillPackageError as exc:
87
115
  if not _allow_hash_mismatch():
88
116
  raise
89
117
  package = _store_unverified_archive(store, skill, archive)
90
118
  warnings.append(str(exc))
91
- skills.append(load_local_skill(package.root_dir))
92
- return SkillLoadResult(skills=skills, warnings=warnings)
119
+ else:
120
+ _emit(
121
+ event_sink,
122
+ "skill.package.cache_hit",
123
+ skill_ref=skill,
124
+ skill_invocation_id=invocation_id,
125
+ status="completed",
126
+ attributes={"cache_hit": True},
127
+ )
128
+ _emit(
129
+ event_sink,
130
+ "skill.load.started",
131
+ skill_ref=skill,
132
+ skill_invocation_id=invocation_id,
133
+ status="running",
134
+ )
135
+ try:
136
+ local_skill = load_local_skill(package.root_dir)
137
+ except Exception as exc:
138
+ _emit(
139
+ event_sink,
140
+ "skill.load.failed",
141
+ skill_ref=skill,
142
+ skill_invocation_id=invocation_id,
143
+ status="failed",
144
+ error_category=type(exc).__name__,
145
+ )
146
+ raise
147
+ _emit(
148
+ event_sink,
149
+ "skill.manifest.parsed",
150
+ skill_ref=skill,
151
+ skill_invocation_id=invocation_id,
152
+ status="completed",
153
+ attributes={"has_description": bool(local_skill.description)},
154
+ )
155
+ _emit(
156
+ event_sink,
157
+ "skill.load.completed",
158
+ skill_ref=skill,
159
+ skill_invocation_id=invocation_id,
160
+ status="completed",
161
+ )
162
+ skills.append(local_skill)
163
+ skill_refs[local_skill.name] = skill
164
+ skill_invocation_ids[local_skill.name] = invocation_id
165
+ return SkillLoadResult(
166
+ skills=skills,
167
+ warnings=warnings,
168
+ skill_refs=skill_refs,
169
+ skill_invocation_ids=skill_invocation_ids,
170
+ )
93
171
 
94
172
 
95
173
  def load_local_skills() -> list[LocalSkill]:
@@ -115,6 +193,33 @@ def _allow_hash_mismatch() -> bool:
115
193
  }
116
194
 
117
195
 
196
+ def _emit(
197
+ event_sink: SkillEventSink | None,
198
+ event_type: str,
199
+ *,
200
+ status: str,
201
+ skill_ref: SkillRef | None = None,
202
+ skill_invocation_id: str = "",
203
+ attributes: dict[str, object] | None = None,
204
+ error_category: str = "",
205
+ started_at: float | None = None,
206
+ ended_at: float | None = None,
207
+ ) -> None:
208
+ if event_sink is not None:
209
+ event_sink.emit(
210
+ SkillEvent.create(
211
+ event_type,
212
+ status=status,
213
+ skill_ref=skill_ref,
214
+ skill_invocation_id=skill_invocation_id,
215
+ attributes=attributes,
216
+ error_category=error_category,
217
+ started_at=started_at,
218
+ ended_at=ended_at,
219
+ )
220
+ )
221
+
222
+
118
223
  def _store_unverified_archive(store: PackageStore, skill: SkillRef, archive: bytes):
119
224
  skill_dir = store.cache_dir / f"unverified-{skill.cache_key or skill.name or 'skill'}"
120
225
  if skill_dir.exists():