agentengine-sdk-python 0.7.0__py3-none-any.whl → 0.8.1__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.
- {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/METADATA +52 -20
- agentengine_sdk_python-0.8.1.dist-info/RECORD +644 -0
- {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/WHEEL +1 -1
- ksadk/a2a/__init__.py +180 -11
- ksadk/a2a/bootstrap.py +332 -0
- ksadk/a2a/card.py +15 -0
- ksadk/a2a/context_store.py +203 -0
- ksadk/a2a/control_plane.py +1056 -0
- ksadk/a2a/credential.py +99 -0
- ksadk/a2a/event_adapter.py +149 -0
- ksadk/a2a/executor.py +361 -137
- ksadk/a2a/external_transport.py +516 -0
- ksadk/a2a/identity.py +304 -0
- ksadk/a2a/ids.py +22 -0
- ksadk/a2a/langgraph.py +285 -0
- ksadk/a2a/resume_store.py +201 -0
- ksadk/a2a/routes.py +112 -0
- ksadk/a2a/server.py +102 -62
- ksadk/a2a/service_env.py +33 -0
- ksadk/a2a/space_client.py +1122 -0
- ksadk/a2a/task_adapter.py +423 -0
- ksadk/a2a/task_event_dispatcher.py +167 -0
- ksadk/a2a/task_event_outbox.py +326 -0
- ksadk/a2a/task_store.py +206 -0
- ksadk/a2a_card.py +101 -0
- ksadk/a2ui/__init__.py +27 -0
- ksadk/a2ui/core.py +186 -0
- ksadk/a2ui/models.py +166 -0
- ksadk/a2ui/renderer.py +198 -0
- ksadk/agui/__init__.py +9 -0
- ksadk/agui/a2ui_projection.py +92 -0
- ksadk/agui/agent.py +872 -0
- ksadk/agui/config.py +92 -0
- ksadk/agui/routes.py +47 -0
- ksadk/api/client.py +238 -204
- ksadk/api/environment.py +27 -0
- ksadk/builders/__init__.py +2 -0
- ksadk/builders/base.py +16 -14
- ksadk/builders/code_builder.py +375 -270
- ksadk/builders/container_builder.py +240 -200
- ksadk/builders/framework_requirements.py +31 -12
- ksadk/builders/ks3_uploader.py +60 -29
- ksadk/builders/managed_runtime_builder.py +173 -0
- ksadk/builders/mcp_builder.py +91 -92
- ksadk/builders/requirements_utils.py +1 -5
- ksadk/cli/__init__.py +97 -171
- ksadk/cli/cmd_a2a.py +255 -84
- ksadk/cli/cmd_agent.py +19 -5
- ksadk/cli/cmd_build.py +158 -29
- ksadk/cli/cmd_completion.py +47 -35
- ksadk/cli/cmd_config.py +267 -198
- ksadk/cli/cmd_create.py +507 -740
- ksadk/cli/cmd_dashboard.py +120 -45
- ksadk/cli/cmd_deploy.py +135 -59
- ksadk/cli/cmd_destroy.py +44 -14
- ksadk/cli/cmd_eval.py +386 -0
- ksadk/cli/cmd_files.py +63 -24
- ksadk/cli/cmd_hermes.py +313 -135
- ksadk/cli/cmd_invoke.py +184 -122
- ksadk/cli/cmd_launch.py +76 -28
- ksadk/cli/cmd_mcp.py +98 -64
- ksadk/cli/cmd_model.py +14 -5
- ksadk/cli/cmd_openclaw.py +564 -268
- ksadk/cli/cmd_replay.py +71 -0
- ksadk/cli/cmd_run.py +58 -73
- ksadk/cli/cmd_status.py +80 -31
- ksadk/cli/cmd_studio.py +110 -0
- ksadk/cli/cmd_version.py +20 -13
- ksadk/cli/cmd_web.py +95 -18
- ksadk/cli/deploy_utils.py +20 -20
- ksadk/cli/dry_run.py +7 -4
- ksadk/cli/env_options.py +83 -0
- ksadk/cli/error_utils.py +37 -12
- ksadk/cli/global_options.py +4 -3
- ksadk/cli/local_runtime.py +1 -2
- ksadk/cli/model_catalog.py +6 -2
- ksadk/cli/network_options.py +41 -19
- ksadk/cli/resource_common.py +6 -2
- ksadk/cli/runtime_bootstrap.py +51 -0
- ksadk/cli/storage.py +0 -1
- ksadk/cli/ui.py +11 -3
- ksadk/cli/workflow_common.py +52 -18
- ksadk/codex/__init__.py +12 -0
- ksadk/codex/client.py +1042 -0
- ksadk/codex/phase.py +143 -0
- ksadk/codex/runtime.py +940 -0
- ksadk/common/aicp_env.py +0 -1
- ksadk/common/auth.py +2 -2
- ksadk/common/constants.py +1 -3
- ksadk/common/kop_client.py +232 -0
- ksadk/common/llm_utils.py +17 -13
- ksadk/compat/__init__.py +5 -0
- ksadk/compat/adk_compat.py +200 -0
- ksadk/compat/copilotkit_a2ui.py +330 -0
- ksadk/configs/__init__.py +12 -14
- ksadk/configs/env_registry.py +661 -116
- ksadk/configs/global_config.py +3 -2
- ksadk/configs/settings.py +133 -209
- ksadk/conversations/__init__.py +85 -92
- ksadk/conversations/attachment_storage.py +16 -11
- ksadk/conversations/attachments.py +44 -36
- ksadk/conversations/compaction_pipeline.py +12 -12
- ksadk/conversations/compaction_prompt.py +9 -5
- ksadk/conversations/context.py +221 -6
- ksadk/conversations/message_projection.py +438 -51
- ksadk/conversations/model_context.py +12 -6
- ksadk/conversations/model_options.py +0 -1
- ksadk/conversations/normalize.py +20 -16
- ksadk/conversations/reasoning_markup.py +1 -1
- ksadk/conversations/runtime.py +339 -5255
- ksadk/conversations/runtime_compaction.py +333 -0
- ksadk/conversations/runtime_constants.py +27 -0
- ksadk/conversations/runtime_governance.py +185 -0
- ksadk/conversations/runtime_input.py +660 -0
- ksadk/conversations/runtime_invocation.py +395 -0
- ksadk/conversations/runtime_metadata.py +475 -0
- ksadk/conversations/runtime_observability.py +367 -0
- ksadk/conversations/runtime_payloads.py +272 -0
- ksadk/conversations/runtime_persistence.py +440 -0
- ksadk/conversations/runtime_preparation.py +426 -0
- ksadk/conversations/runtime_resume.py +836 -0
- ksadk/conversations/runtime_stream_events.py +902 -0
- ksadk/conversations/runtime_streaming.py +700 -0
- ksadk/conversations/semantic_summary.py +17 -5
- ksadk/conversations/session_title.py +6 -3
- ksadk/deployment/__init__.py +15 -16
- ksadk/deployment/agent_access.py +12 -23
- ksadk/deployment/base.py +51 -38
- ksadk/deployment/managed_runtime.py +33 -0
- ksadk/deployment/manager.py +85 -71
- ksadk/deployment/providers/serverless.py +379 -210
- ksadk/deployment/registry.py +38 -32
- ksadk/deployment/state.py +11 -11
- ksadk/deployment/ui_config.py +1 -1
- ksadk/detection/__init__.py +1 -1
- ksadk/detection/detector.py +146 -83
- ksadk/detection/mcp_detector.py +9 -6
- ksadk/evaluation/__init__.py +84 -0
- ksadk/evaluation/a2a_adapter.py +444 -0
- ksadk/evaluation/adapters.py +54 -0
- ksadk/evaluation/contracts.py +409 -0
- ksadk/evaluation/evalset.py +351 -0
- ksadk/evaluation/evaluators.py +461 -0
- ksadk/evaluation/executor.py +118 -0
- ksadk/evaluation/storage.py +68 -0
- ksadk/evaluation/target.py +73 -0
- ksadk/events/__init__.py +25 -0
- ksadk/events/parser.py +191 -0
- ksadk/events/replay.py +37 -0
- ksadk/events/runtime_event.py +273 -0
- ksadk/events/store.py +317 -0
- ksadk/harness/__init__.py +35 -0
- ksadk/harness/app.py +269 -0
- ksadk/harness/config.py +181 -0
- ksadk/harness/reasoner.py +105 -0
- ksadk/harness/runtime.py +364 -0
- ksadk/harness/sandbox.py +141 -0
- ksadk/harness/tools.py +222 -0
- ksadk/hermes_terminal.py +28 -12
- ksadk/identity/resolver.py +15 -9
- ksadk/ids.py +32 -0
- ksadk/knowledge_base/adk_tool.py +1 -1
- ksadk/knowledge_base/client.py +38 -33
- ksadk/managed_a2a_card.py +160 -0
- ksadk/managed_runtime.py +195 -0
- ksadk/markdown.py +5 -2
- ksadk/mcp_runtime/__init__.py +9 -6
- ksadk/memory/__init__.py +1 -1
- ksadk/memory/adk/__init__.py +2 -0
- ksadk/memory/adk/backends/base_ltm_backend.py +2 -6
- ksadk/memory/adk/backends/http_ltm_backend.py +13 -21
- ksadk/memory/adk/backends/inmemory_ltm_backend.py +7 -13
- ksadk/memory/adk/backends/sdk_ltm_backend.py +36 -36
- ksadk/memory/adk/long_term_memory.py +34 -37
- ksadk/memory/adk/resilient_session_service.py +4 -5
- ksadk/memory/adk/short_term_memory.py +12 -21
- ksadk/memory/adk_tool.py +3 -2
- ksadk/memory/backends/base.py +19 -19
- ksadk/memory/backends/memory.py +24 -25
- ksadk/memory/backends/redis.py +31 -30
- ksadk/memory/langchain_tool.py +2 -1
- ksadk/memory/manager.py +52 -47
- ksadk/memory/service.py +16 -6
- ksadk/memory/tool.py +4 -0
- ksadk/model_policy.py +15 -7
- ksadk/model_proxy/__init__.py +51 -0
- ksadk/model_proxy/bootstrap.py +80 -0
- ksadk/model_proxy/cache.py +165 -0
- ksadk/model_proxy/config.py +66 -0
- ksadk/model_proxy/demo_webui.py +115 -0
- ksadk/model_proxy/detect.py +145 -0
- ksadk/model_proxy/gate.py +68 -0
- ksadk/model_proxy/namespace.py +201 -0
- ksadk/model_proxy/protocol_proxy.py +22 -0
- ksadk/model_proxy/server.py +443 -0
- ksadk/model_proxy/transform.py +735 -0
- ksadk/openclaw_gateway.py +29 -14
- ksadk/runners/adk_runner.py +354 -146
- ksadk/runners/base_runner.py +71 -29
- ksadk/runners/deepagents_runner.py +0 -1
- ksadk/runners/factory.py +18 -5
- ksadk/runners/langchain_runner.py +29 -742
- ksadk/runners/langgraph_runner.py +417 -97
- ksadk/runners/patch_langchain.py +16 -16
- ksadk/runners/remote_runner.py +134 -33
- ksadk/runners/usage_accumulator.py +1 -0
- ksadk/runners/utils/__init__.py +0 -10
- ksadk/runners/utils/loader.py +23 -7
- ksadk/runtime/__init__.py +67 -0
- ksadk/runtime/adapter.py +412 -0
- ksadk/runtime/conversation_execution.py +553 -0
- ksadk/runtime/executor.py +251 -0
- ksadk/runtime/factory.py +156 -0
- ksadk/runtime/framework_adapters.py +118 -0
- ksadk/runtime/launch.py +48 -0
- ksadk/runtime/preprocessing.py +131 -0
- ksadk/runtime/runner_adapter.py +1032 -0
- ksadk/runtime/runner_loading.py +36 -0
- ksadk/runtime_context.py +18 -3
- ksadk/runtime_state.py +0 -1
- ksadk/sandbox/__init__.py +4 -1
- ksadk/sandbox/backends/__init__.py +4 -1
- ksadk/sandbox/backends/e2b.py +13 -5
- ksadk/sandbox/backends/local_process.py +11 -3
- ksadk/sandbox/base.py +10 -15
- ksadk/sandbox/factory.py +14 -4
- ksadk/sandbox/registry.py +57 -6
- ksadk/server/__init__.py +39 -4
- ksadk/server/api_models.py +15 -5
- ksadk/server/app.py +24 -3928
- ksadk/server/composition.py +47 -0
- ksadk/server/factory.py +622 -0
- ksadk/server/routes/__init__.py +1 -0
- ksadk/server/routes/checkpoint_resolution.py +116 -0
- ksadk/server/routes/common.py +682 -0
- ksadk/server/routes/control.py +331 -0
- ksadk/server/routes/dependencies.py +98 -0
- ksadk/server/routes/misc.py +425 -0
- ksadk/server/routes/models.py +451 -0
- ksadk/server/routes/openai_compat.py +229 -0
- ksadk/server/routes/projection.py +848 -0
- ksadk/server/routes/routers.py +52 -0
- ksadk/server/routes/run.py +519 -0
- ksadk/server/routes/sessions.py +644 -0
- ksadk/server/routes/streaming.py +265 -0
- ksadk/server/routes/workspace.py +414 -0
- ksadk/server/static/assets/{ArtifactsPanel-D-SSn2ee.js → ArtifactsPanel-CakCqxEN.js} +1 -1
- ksadk/server/static/assets/CodeBlock-CynLknyO.js +9 -0
- ksadk/server/static/assets/MathMessageMarkdown-3sQdOysS.js +8 -0
- ksadk/server/static/assets/MermaidBlock-NERD_ef7.js +303 -0
- ksadk/server/static/assets/NativeTerminalPanel-CiHWf82q.js +1 -0
- ksadk/server/static/assets/{arc-BA13sHc9.js → arc-DrgjcKhl.js} +1 -1
- ksadk/server/static/assets/architecture-7EHR7CIX-CpZLRCcY.js +1 -0
- ksadk/server/static/assets/{architectureDiagram-3BPJPVTR-DzJzgVoL.js → architectureDiagram-3BPJPVTR-BXoVRbQ6.js} +1 -1
- ksadk/server/static/assets/{blockDiagram-GPEHLZMM-UTdVcZhn.js → blockDiagram-GPEHLZMM-BnaB3Ywv.js} +1 -1
- ksadk/server/static/assets/{c4Diagram-AAUBKEIU-Dix0GD4m.js → c4Diagram-AAUBKEIU-Dw4weZcp.js} +1 -1
- ksadk/server/static/assets/channel-Dt3rQTFI.js +1 -0
- ksadk/server/static/assets/{chunk-2J33WTMH-C2JxuZ42.js → chunk-2J33WTMH-ChjpLK7j.js} +1 -1
- ksadk/server/static/assets/{chunk-4BX2VUAB-Be57QPgD.js → chunk-4BX2VUAB-B9drTgOW.js} +1 -1
- ksadk/server/static/assets/{chunk-55IACEB6-WjSuy4nv.js → chunk-55IACEB6-CK4ROATy.js} +1 -1
- ksadk/server/static/assets/{chunk-727SXJPM-BOovP-b5.js → chunk-727SXJPM-B9KtTTgw.js} +1 -1
- ksadk/server/static/assets/{chunk-AQP2D5EJ-DOmZNmWj.js → chunk-AQP2D5EJ-1O1mki3m.js} +1 -1
- ksadk/server/static/assets/{chunk-FMBD7UC4-DzwlodkU.js → chunk-FMBD7UC4-B_fH2YuH.js} +1 -1
- ksadk/server/static/assets/{chunk-ND2GUHAM-DMqAikEU.js → chunk-ND2GUHAM-D6rFLaVV.js} +1 -1
- ksadk/server/static/assets/chunk-QZHKN3VN-iXEZtKQc.js +1 -0
- ksadk/server/static/assets/classDiagram-4FO5ZUOK-DIveV17Q.js +1 -0
- ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-DIveV17Q.js +1 -0
- ksadk/server/static/assets/{cose-bilkent-S5V4N54A-Zhy2GBnP.js → cose-bilkent-S5V4N54A-ChNs_Mdk.js} +1 -1
- ksadk/server/static/assets/{dagre-BM42HDAG-CbKrtIUz.js → dagre-BM42HDAG-D0QXg_MQ.js} +1 -1
- ksadk/server/static/assets/{diagram-2AECGRRQ-BRApgQRK.js → diagram-2AECGRRQ-DBDDKwBQ.js} +1 -1
- ksadk/server/static/assets/{diagram-5GNKFQAL-D0xbnDiK.js → diagram-5GNKFQAL-BkwDOxmO.js} +1 -1
- ksadk/server/static/assets/{diagram-KO2AKTUF-CVugVI9L.js → diagram-KO2AKTUF-Bv8waYvY.js} +1 -1
- ksadk/server/static/assets/{diagram-LMA3HP47-DozUGgee.js → diagram-LMA3HP47-e1VECDdu.js} +1 -1
- ksadk/server/static/assets/{diagram-OG6HWLK6-ZOYsKlru.js → diagram-OG6HWLK6-Ds9adfRl.js} +1 -1
- ksadk/server/static/assets/{dist-DpKtt4Bo.js → dist-4N2NMVYg.js} +1 -1
- ksadk/server/static/assets/{dist-CkEKJFtk.js → dist-B-jNR6Vn.js} +1 -1
- ksadk/server/static/assets/{dist-D57wnGWd.js → dist-B5J2uhNk.js} +1 -1
- ksadk/server/static/assets/{dist-8_SfK1IP.js → dist-B5oS1zcj.js} +1 -1
- ksadk/server/static/assets/{dist-DMezvBGJ.js → dist-BB3-OwTQ.js} +1 -1
- ksadk/server/static/assets/{dist-2hInLS_J.js → dist-BIlKoW0k.js} +1 -1
- ksadk/server/static/assets/{dist-BrCcQ47T.js → dist-BjOdlDjj.js} +1 -1
- ksadk/server/static/assets/{dist-BmlMPsCc.js → dist-C1sz5Eo3.js} +1 -1
- ksadk/server/static/assets/{dist-B0NP_Z0z.js → dist-CWV4lDr1.js} +1 -1
- ksadk/server/static/assets/{dist-D-xOD048.js → dist-CmZHzlwZ.js} +1 -1
- ksadk/server/static/assets/{dist-DL_NKc_z.js → dist-D6MpCZtz.js} +1 -1
- ksadk/server/static/assets/{dist-DyOkZmze.js → dist-DJN_6Y39.js} +1 -1
- ksadk/server/static/assets/{dist-DmFaq_Iy.js → dist-DQU9EWw-.js} +1 -1
- ksadk/server/static/assets/{dist-gX6GOLKq.js → dist-DWKByxWV.js} +1 -1
- ksadk/server/static/assets/{dist-DyWsb78Q.js → dist-Dli7qW-B.js} +1 -1
- ksadk/server/static/assets/{dist-BIJVDMuB.js → dist-DsHPdk3W.js} +1 -1
- ksadk/server/static/assets/{dist-Dp0k7bWI.js → dist-X4TnqwOK.js} +1 -1
- ksadk/server/static/assets/{dist-8EEyGgDx.js → dist-_pHPTyZ-.js} +1 -1
- ksadk/server/static/assets/{dist-CPBtqRTW.js → dist-fhOuWds5.js} +1 -1
- ksadk/server/static/assets/{dist-D-JMdWPQ.js → dist-gLnrGsoU.js} +1 -1
- ksadk/server/static/assets/{dist-BssVmjIo.js → dist-j6Dxmf_j.js} +1 -1
- ksadk/server/static/assets/{dist-C3HIIaN5.js → dist-o2OVmKvt.js} +1 -1
- ksadk/server/static/assets/{erDiagram-TEJ5UH35-Bk-9bgE5.js → erDiagram-TEJ5UH35-BPItFKH6.js} +1 -1
- ksadk/server/static/assets/eventmodeling-FCH6USID-DYFSxbqr.js +1 -0
- ksadk/server/static/assets/{flowDiagram-I6XJVG4X-Dn9kZVuZ.js → flowDiagram-I6XJVG4X-BbYB9w5Y.js} +1 -1
- ksadk/server/static/assets/{ganttDiagram-6RSMTGT7-BGxXlJqm.js → ganttDiagram-6RSMTGT7-TQXa0KXv.js} +1 -1
- ksadk/server/static/assets/gitGraph-WXDBUCRP-DyNYp6BN.js +1 -0
- ksadk/server/static/assets/{gitGraphDiagram-PVQCEYII-C7Q0X-wi.js → gitGraphDiagram-PVQCEYII-bKblCnpa.js} +1 -1
- ksadk/server/static/assets/index-R52pJJvg.js +177 -0
- ksadk/server/static/assets/index-jJr3_955.css +2 -0
- ksadk/server/static/assets/info-J43DQDTF-WUx7qTde.js +1 -0
- ksadk/server/static/assets/{infoDiagram-5YYISTIA-BO_CSqq5.js → infoDiagram-5YYISTIA-BGVT7J_i.js} +1 -1
- ksadk/server/static/assets/{ishikawaDiagram-YF4QCWOH-eYLPLd46.js → ishikawaDiagram-YF4QCWOH-K0OOfVna.js} +1 -1
- ksadk/server/static/assets/{journeyDiagram-JHISSGLW-De9geSb0.js → journeyDiagram-JHISSGLW-8LeOJaZp.js} +1 -1
- ksadk/server/static/assets/{kanban-definition-UN3LZRKU-Cs80kQto.js → kanban-definition-UN3LZRKU-C6uCgZrW.js} +1 -1
- ksadk/server/static/assets/{katex-DSrCFD8n.js → katex-CYWseY5E.js} +1 -1
- ksadk/server/static/assets/{linear-CN9sbKTF.js → linear-hdBcYzM8.js} +1 -1
- ksadk/server/static/assets/{mermaid-parser.core-DlgSBU8l.js → mermaid-parser.core-BWrDjSZM.js} +2 -2
- ksadk/server/static/assets/{mindmap-definition-RKZ34NQL-9afz7Oug.js → mindmap-definition-RKZ34NQL-Bjy_2v4_.js} +1 -1
- ksadk/server/static/assets/packet-YPE3B663-BN13y_xl.js +1 -0
- ksadk/server/static/assets/pie-LRSECV5Y-ftSLXhhc.js +1 -0
- ksadk/server/static/assets/{pieDiagram-4H26LBE5-DPv_VstN.js → pieDiagram-4H26LBE5-GmmqNiVH.js} +1 -1
- ksadk/server/static/assets/{quadrantDiagram-W4KKPZXB-o77wZ1XK.js → quadrantDiagram-W4KKPZXB-BmkRbwCg.js} +1 -1
- ksadk/server/static/assets/radar-GUYGQ44K-jaICkIeO.js +1 -0
- ksadk/server/static/assets/{requirementDiagram-4Y6WPE33-BYVw81VC.js → requirementDiagram-4Y6WPE33-DSWFqL7c.js} +1 -1
- ksadk/server/static/assets/{sankeyDiagram-5OEKKPKP-B7nZFMKT.js → sankeyDiagram-5OEKKPKP-l6iXmU65.js} +1 -1
- ksadk/server/static/assets/{sequenceDiagram-3UESZ5HK-BGRRrFw5.js → sequenceDiagram-3UESZ5HK-Cq6UBeQB.js} +1 -1
- ksadk/server/static/assets/{stateDiagram-AJRCARHV-BUfHCoPs.js → stateDiagram-AJRCARHV-qzTQpg3Y.js} +1 -1
- ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-BYCoYGAN.js +1 -0
- ksadk/server/static/assets/{timeline-definition-PNZ67QCA-FbCTGrf9.js → timeline-definition-PNZ67QCA-DEz24vV0.js} +1 -1
- ksadk/server/static/assets/treeView-BLDUP644-Cpib_vlz.js +1 -0
- ksadk/server/static/assets/treemap-LRROVOQU-DQxfmVHK.js +1 -0
- ksadk/server/static/assets/{vennDiagram-CIIHVFJN-DWgwtPsJ.js → vennDiagram-CIIHVFJN-CMCixki2.js} +1 -1
- ksadk/server/static/assets/wardley-L42UT6IY-BQYHnnkU.js +1 -0
- ksadk/server/static/assets/{wardleyDiagram-YWT4CUSO-2x8G-tTM.js → wardleyDiagram-YWT4CUSO-CVzB8F9K.js} +1 -1
- ksadk/server/static/assets/{xychartDiagram-2RQKCTM6-Drma3AYl.js → xychartDiagram-2RQKCTM6-BFBqBLc1.js} +1 -1
- ksadk/server/static/index.html +2 -2
- ksadk/server/terminal_sessions.py +111 -58
- ksadk/sessions/__init__.py +69 -19
- ksadk/sessions/base.py +31 -11
- ksadk/sessions/continuity.py +2 -3
- ksadk/sessions/in_memory.py +46 -2
- ksadk/sessions/local_service.py +148 -17
- ksadk/sessions/postgres_service.py +143 -25
- ksadk/sessions/resilient.py +36 -8
- ksadk/skills/models.py +17 -5
- ksadk/skills/package_store.py +5 -2
- ksadk/skills/runtime/agent.py +20 -5
- ksadk/skills/runtime/artifacts.py +1 -5
- ksadk/skills/runtime/backends/e2b.py +10 -4
- ksadk/skills/runtime/backends/local.py +15 -3
- ksadk/skills/runtime/base.py +1 -2
- ksadk/skills/runtime/executor.py +10 -3
- ksadk/skills/runtime/factory.py +4 -2
- ksadk/skills/runtime/loader.py +1 -2
- ksadk/skills/runtime/registry.py +15 -10
- ksadk/skills/runtime/request.py +3 -1
- ksadk/skills/service_client.py +47 -16
- ksadk/skills/tool_defs.py +15 -10
- ksadk/studio/__init__.py +5 -0
- ksadk/studio/agent_avatar_assets.py +120 -0
- ksadk/studio/agent_lifecycle.py +51 -0
- ksadk/studio/api.py +1046 -0
- ksadk/studio/api_catalog_routes.py +324 -0
- ksadk/studio/api_contracts.py +177 -0
- ksadk/studio/api_helpers.py +132 -0
- ksadk/studio/authoring.py +524 -0
- ksadk/studio/authoring_coordinator.py +285 -0
- ksadk/studio/builder.py +320 -0
- ksadk/studio/capabilities.py +351 -0
- ksadk/studio/cloud.py +278 -0
- ksadk/studio/codex_agent_service.py +583 -0
- ksadk/studio/codex_builder.py +324 -0
- ksadk/studio/codex_manifest.py +278 -0
- ksadk/studio/codex_run.py +352 -0
- ksadk/studio/compiler.py +189 -0
- ksadk/studio/contracts.py +644 -0
- ksadk/studio/errors.py +47 -0
- ksadk/studio/evaluation.py +192 -0
- ksadk/studio/event_store.py +284 -0
- ksadk/studio/framework_run.py +114 -0
- ksadk/studio/identifiers.py +33 -0
- ksadk/studio/mcp_runtime.py +229 -0
- ksadk/studio/model_client.py +543 -0
- ksadk/studio/model_profile_service.py +214 -0
- ksadk/studio/operations.py +243 -0
- ksadk/studio/otel_trace.py +754 -0
- ksadk/studio/pagination.py +182 -0
- ksadk/studio/python_tool_inspection.py +183 -0
- ksadk/studio/repository.py +306 -0
- ksadk/studio/resource_catalog.py +1217 -0
- ksadk/studio/run_service.py +707 -0
- ksadk/studio/runtime_catalog.py +74 -0
- ksadk/studio/runtime_source.py +339 -0
- ksadk/studio/service.py +1141 -0
- ksadk/studio/shared_web.py +994 -0
- ksadk/studio/skill_discovery.py +628 -0
- ksadk/studio/static/assets/PrismRenderer-IYN-ffww.js +3 -0
- ksadk/studio/static/assets/index-CaEN0eTR.css +1 -0
- ksadk/studio/static/assets/index-DI2eY_NH.js +252 -0
- ksadk/studio/static/assets/react-vendor-BNmTiJ-I.js +9 -0
- ksadk/studio/static/assets/rolldown-runtime-hePW80VL.js +1 -0
- ksadk/studio/static/index.html +15 -0
- ksadk/studio/templates.py +630 -0
- ksadk/studio/validator.py +246 -0
- ksadk/studio/workspace.py +137 -0
- ksadk/terminal_exec_policy.py +3 -4
- ksadk/tools/gateway.py +101 -15
- ksadk/tools/result_budget.py +12 -4
- ksadk/toolsets/__init__.py +161 -37
- ksadk/toolsets/a2a.py +426 -0
- ksadk/toolsets/platform.py +21 -5
- ksadk/toolsets/sandbox.py +82 -16
- ksadk/toolsets/skills.py +200 -39
- ksadk/toolsets/web.py +123 -26
- ksadk/toolsets/workspace.py +212 -101
- ksadk/tracing/__init__.py +19 -21
- ksadk/tracing/exporters/inmemory_exporter.py +62 -51
- ksadk/tracing/setup.py +135 -506
- ksadk/tracing/span_utils.py +0 -41
- ksadk/tui/loop.py +78 -30
- ksadk/tui/stream_render.py +1 -0
- ksadk/ui_config.py +5 -3
- ksadk/version.py +1 -1
- ksadk_runtime_common/memory_backend/registry.py +56 -56
- ksadk_runtime_common/schemas/runtime_event_v1.json +95 -0
- ksadk_runtime_common/workspace_files/router.py +8 -2
- agentengine_sdk_python-0.7.0.dist-info/RECORD +0 -482
- ksadk/a2a/card_builder.py +0 -64
- ksadk/a2a/client.py +0 -309
- ksadk/runners/utils/langfuse.py +0 -230
- ksadk/server/static/assets/CodeBlock-P16VOLYi.js +0 -9
- ksadk/server/static/assets/MathMessageMarkdown-CdGiQWHR.js +0 -8
- ksadk/server/static/assets/MermaidBlock-IOcal8cm.js +0 -303
- ksadk/server/static/assets/NativeTerminalPanel-DGSDWsei.js +0 -1
- ksadk/server/static/assets/architecture-7EHR7CIX-BvUlsA6l.js +0 -1
- ksadk/server/static/assets/channel-CTuydARX.js +0 -1
- ksadk/server/static/assets/chunk-QZHKN3VN-BnCydivS.js +0 -1
- ksadk/server/static/assets/classDiagram-4FO5ZUOK-BNHg45Be.js +0 -1
- ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-BNHg45Be.js +0 -1
- ksadk/server/static/assets/eventmodeling-FCH6USID-DsAgWnlf.js +0 -1
- ksadk/server/static/assets/gitGraph-WXDBUCRP-BIao9Yjg.js +0 -1
- ksadk/server/static/assets/index-C00Lwg3L.js +0 -165
- ksadk/server/static/assets/index-DAURbCsP.css +0 -1
- ksadk/server/static/assets/info-J43DQDTF-CyipqGxU.js +0 -1
- ksadk/server/static/assets/packet-YPE3B663-CGkyRxlg.js +0 -1
- ksadk/server/static/assets/pie-LRSECV5Y-M0uWAf4n.js +0 -1
- ksadk/server/static/assets/radar-GUYGQ44K-Bdbm24-x.js +0 -1
- ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-8xBN_gLM.js +0 -1
- ksadk/server/static/assets/treeView-BLDUP644-npMo0ak1.js +0 -1
- ksadk/server/static/assets/treemap-LRROVOQU-CHdzrrdo.js +0 -1
- ksadk/server/static/assets/wardley-L42UT6IY-BEQz7wyy.js +0 -1
- ksadk/tracing/exporters/langfuse_exporter.py +0 -445
- {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/entry_points.txt +0 -0
- {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/licenses/LICENSE +0 -0
- {agentengine_sdk_python-0.7.0.dist-info → agentengine_sdk_python-0.8.1.dist-info}/top_level.txt +0 -0
|
@@ -0,0 +1,707 @@
|
|
|
1
|
+
"""Studio Run persistence on top of the canonical RuntimeExecutor."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import asyncio
|
|
6
|
+
import time
|
|
7
|
+
from collections.abc import Callable, Mapping
|
|
8
|
+
from dataclasses import dataclass, field
|
|
9
|
+
from datetime import datetime, timezone
|
|
10
|
+
from typing import Any
|
|
11
|
+
from uuid import uuid4
|
|
12
|
+
|
|
13
|
+
from ksadk.agui.a2ui_projection import project_a2ui_operations
|
|
14
|
+
from ksadk.events.runtime_event import EventType, RuntimeEvent
|
|
15
|
+
from ksadk.runtime import (
|
|
16
|
+
CONVERSATION_PREPROCESSING_METADATA_KEY,
|
|
17
|
+
PauseResult,
|
|
18
|
+
ResumePayload,
|
|
19
|
+
ResumeTarget,
|
|
20
|
+
RuntimeExecutor,
|
|
21
|
+
RuntimeLaunchContext,
|
|
22
|
+
StartRequest,
|
|
23
|
+
)
|
|
24
|
+
from ksadk.studio.contracts import RunEvent, RunRecord, RunStatus, Usage
|
|
25
|
+
from ksadk.studio.errors import StudioError
|
|
26
|
+
from ksadk.studio.event_store import RunEventStore
|
|
27
|
+
from ksadk.studio.workspace import Workspace
|
|
28
|
+
|
|
29
|
+
_CANCEL_TIMEOUT_SECONDS = 2.0
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
@dataclass(frozen=True)
|
|
33
|
+
class StudioRunSpec:
|
|
34
|
+
"""Product metadata plus the core launch context for one Studio run."""
|
|
35
|
+
|
|
36
|
+
launch_context: RuntimeLaunchContext
|
|
37
|
+
build_id: str
|
|
38
|
+
agent_id: str
|
|
39
|
+
model: str | None = None
|
|
40
|
+
request_config: Mapping[str, Any] = field(default_factory=dict)
|
|
41
|
+
manifest_sha256: str = ""
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
class StudioRunService:
|
|
45
|
+
"""Persist Studio state without selecting or wrapping a RuntimeAdapter."""
|
|
46
|
+
|
|
47
|
+
def __init__(
|
|
48
|
+
self,
|
|
49
|
+
workspace: Workspace,
|
|
50
|
+
executor: RuntimeExecutor,
|
|
51
|
+
*,
|
|
52
|
+
event_store: RunEventStore | None = None,
|
|
53
|
+
) -> None:
|
|
54
|
+
self.workspace = workspace
|
|
55
|
+
self.executor = executor
|
|
56
|
+
self.event_store = event_store or RunEventStore(workspace)
|
|
57
|
+
self._active_handles: dict[str, Any] = {}
|
|
58
|
+
self._cancel_flags: dict[str, bool] = {}
|
|
59
|
+
self._control_queues: dict[str, asyncio.Queue[tuple[str, ResumePayload | None]]] = {}
|
|
60
|
+
self._waiting_modes: dict[str, str] = {}
|
|
61
|
+
|
|
62
|
+
async def run(
|
|
63
|
+
self,
|
|
64
|
+
spec: StudioRunSpec,
|
|
65
|
+
user_input: str,
|
|
66
|
+
*,
|
|
67
|
+
runtime_input: Any = None,
|
|
68
|
+
session_id: str | None = None,
|
|
69
|
+
on_event: Callable[[RunEvent], None] | None = None,
|
|
70
|
+
) -> RunRecord:
|
|
71
|
+
run_id = f"run_{uuid4().hex}"
|
|
72
|
+
session = session_id or f"ses_{uuid4().hex}"
|
|
73
|
+
runtime_type = spec.launch_context.runtime_type.strip().lower()
|
|
74
|
+
record = RunRecord(
|
|
75
|
+
id=run_id,
|
|
76
|
+
build_id=spec.build_id,
|
|
77
|
+
agent_id=spec.agent_id,
|
|
78
|
+
session_id=session,
|
|
79
|
+
trace_id=uuid4().hex,
|
|
80
|
+
manifest_sha256=spec.manifest_sha256,
|
|
81
|
+
runtime_type=runtime_type,
|
|
82
|
+
model=str(spec.model or ""),
|
|
83
|
+
collaboration_mode=str(spec.request_config.get("collaboration_mode") or ""),
|
|
84
|
+
goal_objective=str(spec.request_config.get("goal_objective") or ""),
|
|
85
|
+
input=user_input,
|
|
86
|
+
)
|
|
87
|
+
self.event_store.create(record)
|
|
88
|
+
created = self.event_store.append(
|
|
89
|
+
record.id,
|
|
90
|
+
"run.created",
|
|
91
|
+
{
|
|
92
|
+
"runId": record.id,
|
|
93
|
+
"buildId": spec.build_id,
|
|
94
|
+
"sessionId": session,
|
|
95
|
+
"traceId": record.trace_id,
|
|
96
|
+
"runtimeType": runtime_type,
|
|
97
|
+
"manifestSha256": spec.manifest_sha256,
|
|
98
|
+
"model": record.model,
|
|
99
|
+
"collaborationMode": record.collaboration_mode,
|
|
100
|
+
"goalObjective": record.goal_objective,
|
|
101
|
+
},
|
|
102
|
+
)
|
|
103
|
+
if on_event is not None:
|
|
104
|
+
on_event(created)
|
|
105
|
+
|
|
106
|
+
started = time.monotonic()
|
|
107
|
+
record.status = RunStatus.RUNNING
|
|
108
|
+
record.started_at = datetime.now(timezone.utc)
|
|
109
|
+
self.event_store.save(record)
|
|
110
|
+
|
|
111
|
+
def persist(runtime_event: RuntimeEvent) -> RunEvent:
|
|
112
|
+
event_type, data = project_runtime_event(runtime_event)
|
|
113
|
+
stored = self.event_store.append(record.id, event_type, data)
|
|
114
|
+
if on_event is not None:
|
|
115
|
+
on_event(stored)
|
|
116
|
+
return stored
|
|
117
|
+
|
|
118
|
+
handle = None
|
|
119
|
+
final_text = ""
|
|
120
|
+
streamed_final = ""
|
|
121
|
+
runtime_duration_ms: int | None = None
|
|
122
|
+
control_queue: asyncio.Queue[tuple[str, ResumePayload | None]] = asyncio.Queue()
|
|
123
|
+
self._control_queues[run_id] = control_queue
|
|
124
|
+
try:
|
|
125
|
+
tool_approval_mode = str(spec.request_config.get("tool_approval_mode") or "")
|
|
126
|
+
conversation_request: dict[str, Any] = {
|
|
127
|
+
"messages": self._conversation_messages(
|
|
128
|
+
spec.agent_id,
|
|
129
|
+
session,
|
|
130
|
+
user_input,
|
|
131
|
+
)
|
|
132
|
+
}
|
|
133
|
+
if tool_approval_mode:
|
|
134
|
+
conversation_request["request_metadata"] = {
|
|
135
|
+
"tool_approval_mode": tool_approval_mode,
|
|
136
|
+
}
|
|
137
|
+
request = StartRequest(
|
|
138
|
+
input=runtime_input if runtime_input is not None else user_input,
|
|
139
|
+
user_id="local-user",
|
|
140
|
+
session_id=session,
|
|
141
|
+
agent_id=spec.agent_id,
|
|
142
|
+
model=spec.model,
|
|
143
|
+
config=dict(spec.request_config),
|
|
144
|
+
metadata={
|
|
145
|
+
"invocation_id": run_id,
|
|
146
|
+
CONVERSATION_PREPROCESSING_METADATA_KEY: conversation_request,
|
|
147
|
+
**self._native_session_metadata(spec.agent_id, session, runtime_type),
|
|
148
|
+
},
|
|
149
|
+
)
|
|
150
|
+
handle = await self.executor.start(spec.launch_context, request)
|
|
151
|
+
record.runtime_handle = handle.model_dump(mode="json")
|
|
152
|
+
self.event_store.save(record)
|
|
153
|
+
self._active_handles[run_id] = handle
|
|
154
|
+
while True:
|
|
155
|
+
terminal_seen = False
|
|
156
|
+
should_resume = False
|
|
157
|
+
async for event in self.executor.stream(handle):
|
|
158
|
+
persist(event)
|
|
159
|
+
if self._cancel_flags.get(run_id):
|
|
160
|
+
raise asyncio.CancelledError()
|
|
161
|
+
if event.event_type == EventType.TEXT_DELTA and event.phase == "final_answer":
|
|
162
|
+
text = str(event.payload.get("text") or "")
|
|
163
|
+
if event.payload.get("replace"):
|
|
164
|
+
streamed_final = text
|
|
165
|
+
else:
|
|
166
|
+
streamed_final += text
|
|
167
|
+
elif (
|
|
168
|
+
event.event_type == EventType.TEXT_COMPLETED
|
|
169
|
+
and event.phase == "final_answer"
|
|
170
|
+
):
|
|
171
|
+
final_text = str(event.payload.get("text") or "")
|
|
172
|
+
elif event.event_type == EventType.USAGE_REPORTED:
|
|
173
|
+
record.usage = Usage(
|
|
174
|
+
input_tokens=int(event.payload.get("input_tokens") or 0),
|
|
175
|
+
output_tokens=int(event.payload.get("output_tokens") or 0),
|
|
176
|
+
total_tokens=int(event.payload.get("total_tokens") or 0),
|
|
177
|
+
cached_input_tokens=int(event.payload.get("cached_tokens") or 0),
|
|
178
|
+
reasoning_output_tokens=int(event.payload.get("reasoning_tokens") or 0),
|
|
179
|
+
reported=True,
|
|
180
|
+
source=str(event.payload.get("source") or runtime_type),
|
|
181
|
+
)
|
|
182
|
+
elif event.event_type in {
|
|
183
|
+
EventType.APPROVAL_REQUESTED,
|
|
184
|
+
EventType.A2UI_INTERACTION,
|
|
185
|
+
}:
|
|
186
|
+
record.status = RunStatus.WAITING_INPUT
|
|
187
|
+
self._waiting_modes[run_id] = "live"
|
|
188
|
+
self.event_store.save(record)
|
|
189
|
+
if event.event_type == EventType.APPROVAL_REQUESTED:
|
|
190
|
+
self._persist_approval_surface(record, event, on_event=on_event)
|
|
191
|
+
elif event.event_type in {
|
|
192
|
+
EventType.APPROVAL_RESOLVED,
|
|
193
|
+
EventType.A2UI_ACTION,
|
|
194
|
+
}:
|
|
195
|
+
record.status = RunStatus.RUNNING
|
|
196
|
+
self._waiting_modes.pop(run_id, None)
|
|
197
|
+
self.event_store.save(record)
|
|
198
|
+
elif event.event_type == EventType.RUN_FAILED:
|
|
199
|
+
terminal_seen = True
|
|
200
|
+
record.status = RunStatus.FAILED
|
|
201
|
+
record.error = {
|
|
202
|
+
"code": "RUNTIME_RUN_FAILED",
|
|
203
|
+
"message": str(event.payload.get("error") or "Runtime 运行失败"),
|
|
204
|
+
}
|
|
205
|
+
elif event.event_type == EventType.RUN_CANCELED:
|
|
206
|
+
terminal_seen = True
|
|
207
|
+
record.status = RunStatus.CANCELLED
|
|
208
|
+
record.error = {
|
|
209
|
+
"code": "RUN_CANCELLED",
|
|
210
|
+
"message": str(event.payload.get("status") or "运行已取消"),
|
|
211
|
+
}
|
|
212
|
+
elif event.event_type == EventType.RUN_INTERRUPTED:
|
|
213
|
+
interrupted_status = str(event.payload.get("status") or "")
|
|
214
|
+
if interrupted_status == "paused":
|
|
215
|
+
record.status = RunStatus.PAUSED
|
|
216
|
+
should_resume = True
|
|
217
|
+
elif record.status == RunStatus.WAITING_INPUT:
|
|
218
|
+
self._waiting_modes[run_id] = "resume"
|
|
219
|
+
should_resume = True
|
|
220
|
+
else:
|
|
221
|
+
terminal_seen = True
|
|
222
|
+
record.status = RunStatus.INTERRUPTED
|
|
223
|
+
record.error = {
|
|
224
|
+
"code": "RUN_INTERRUPTED",
|
|
225
|
+
"message": interrupted_status or "运行已中断",
|
|
226
|
+
}
|
|
227
|
+
self.event_store.save(record)
|
|
228
|
+
elif event.event_type == EventType.RUN_COMPLETED:
|
|
229
|
+
terminal_seen = True
|
|
230
|
+
record.status = RunStatus.COMPLETED
|
|
231
|
+
raw_duration = event.payload.get("duration_ms")
|
|
232
|
+
if raw_duration is not None:
|
|
233
|
+
runtime_duration_ms = max(0, int(raw_duration))
|
|
234
|
+
if terminal_seen:
|
|
235
|
+
break
|
|
236
|
+
if not should_resume:
|
|
237
|
+
record.status = RunStatus.COMPLETED
|
|
238
|
+
break
|
|
239
|
+
|
|
240
|
+
command, resume_payload = await control_queue.get()
|
|
241
|
+
if command == "cancel" or self._cancel_flags.get(run_id):
|
|
242
|
+
raise asyncio.CancelledError()
|
|
243
|
+
if command != "resume":
|
|
244
|
+
continue
|
|
245
|
+
native_thread_id = handle.native_ref.get("thread_id")
|
|
246
|
+
target = (
|
|
247
|
+
ResumeTarget(kind="thread_id", id=str(native_thread_id))
|
|
248
|
+
if native_thread_id
|
|
249
|
+
else ResumeTarget(kind="invocation_id", id=handle.run_id)
|
|
250
|
+
)
|
|
251
|
+
handle = await self.executor.resume(
|
|
252
|
+
handle,
|
|
253
|
+
target,
|
|
254
|
+
resume_payload,
|
|
255
|
+
)
|
|
256
|
+
self._active_handles[run_id] = handle
|
|
257
|
+
record.runtime_handle = handle.model_dump(mode="json")
|
|
258
|
+
record.status = RunStatus.RUNNING
|
|
259
|
+
record.error = None
|
|
260
|
+
self._waiting_modes.pop(run_id, None)
|
|
261
|
+
resumed = self.event_store.append(
|
|
262
|
+
run_id,
|
|
263
|
+
"run.resumed",
|
|
264
|
+
{"runId": run_id, "runtimeHandle": record.runtime_handle},
|
|
265
|
+
)
|
|
266
|
+
if on_event is not None:
|
|
267
|
+
on_event(resumed)
|
|
268
|
+
self.event_store.save(record)
|
|
269
|
+
record.output = final_text or streamed_final
|
|
270
|
+
except asyncio.CancelledError:
|
|
271
|
+
cancel_result = "task_cancelled"
|
|
272
|
+
if handle is not None and self.executor.is_attached(handle):
|
|
273
|
+
try:
|
|
274
|
+
result = await asyncio.wait_for(
|
|
275
|
+
asyncio.shield(self.executor.cancel(handle)),
|
|
276
|
+
timeout=_CANCEL_TIMEOUT_SECONDS,
|
|
277
|
+
)
|
|
278
|
+
cancel_result = result.value
|
|
279
|
+
except TimeoutError:
|
|
280
|
+
cancel_result = "cancel_timed_out"
|
|
281
|
+
except Exception: # best effort; close still owns resource cleanup
|
|
282
|
+
cancel_result = "cancel_failed"
|
|
283
|
+
record.status = RunStatus.CANCELLED
|
|
284
|
+
record.error = {"code": "RUN_CANCELLED", "message": "运行已取消"}
|
|
285
|
+
cancelled = RuntimeEvent.create(
|
|
286
|
+
EventType.RUN_CANCELED,
|
|
287
|
+
agent_id=spec.agent_id,
|
|
288
|
+
user_id="local-user",
|
|
289
|
+
session_id=session,
|
|
290
|
+
invocation_id=handle.run_id if handle is not None else run_id,
|
|
291
|
+
seq_id=len(self.event_store.events(run_id)) + 1,
|
|
292
|
+
payload={"status": "cancelled", "cancel_result": cancel_result},
|
|
293
|
+
)
|
|
294
|
+
persist(cancelled)
|
|
295
|
+
raise
|
|
296
|
+
except Exception as exc: # noqa: BLE001
|
|
297
|
+
record.status = RunStatus.FAILED
|
|
298
|
+
record.error = {"code": "RUNTIME_RUN_FAILED", "message": str(exc)}
|
|
299
|
+
failure = RuntimeEvent.create(
|
|
300
|
+
EventType.RUN_FAILED,
|
|
301
|
+
agent_id=spec.agent_id,
|
|
302
|
+
user_id="local-user",
|
|
303
|
+
session_id=session,
|
|
304
|
+
invocation_id=handle.run_id if handle is not None else run_id,
|
|
305
|
+
seq_id=len(self.event_store.events(run_id)) + 1,
|
|
306
|
+
payload={"status": "failed", "error": str(exc)},
|
|
307
|
+
)
|
|
308
|
+
persist(failure)
|
|
309
|
+
finally:
|
|
310
|
+
if handle is not None and self.executor.is_attached(handle):
|
|
311
|
+
try:
|
|
312
|
+
await asyncio.shield(self.executor.close(handle))
|
|
313
|
+
except asyncio.CancelledError:
|
|
314
|
+
pass
|
|
315
|
+
except Exception: # cleanup is best effort; run state is already durable
|
|
316
|
+
pass
|
|
317
|
+
self._active_handles.pop(run_id, None)
|
|
318
|
+
self._cancel_flags.pop(run_id, None)
|
|
319
|
+
self._control_queues.pop(run_id, None)
|
|
320
|
+
self._waiting_modes.pop(run_id, None)
|
|
321
|
+
record.completed_at = datetime.now(timezone.utc)
|
|
322
|
+
if runtime_duration_ms is not None:
|
|
323
|
+
record.duration_ms = runtime_duration_ms
|
|
324
|
+
record.duration_source = "runtime"
|
|
325
|
+
else:
|
|
326
|
+
record.duration_ms = int((time.monotonic() - started) * 1000)
|
|
327
|
+
record.duration_source = "studio"
|
|
328
|
+
self.event_store.save(record)
|
|
329
|
+
return record
|
|
330
|
+
|
|
331
|
+
async def cancel_run(self, run_id: str) -> dict[str, str]:
|
|
332
|
+
"""Request cancellation; the flag and executor perform the actual stop."""
|
|
333
|
+
self._cancel_flags[run_id] = True
|
|
334
|
+
queue = self._control_queues.get(run_id)
|
|
335
|
+
if queue is not None:
|
|
336
|
+
queue.put_nowait(("cancel", None))
|
|
337
|
+
handle = self._active_handles.get(run_id)
|
|
338
|
+
if handle is not None and self.executor.is_attached(handle):
|
|
339
|
+
try:
|
|
340
|
+
await asyncio.wait_for(
|
|
341
|
+
asyncio.shield(self.executor.cancel(handle)),
|
|
342
|
+
timeout=_CANCEL_TIMEOUT_SECONDS,
|
|
343
|
+
)
|
|
344
|
+
except TimeoutError:
|
|
345
|
+
# The cancellation flag wakes the Studio state machine; final
|
|
346
|
+
# transport teardown remains close()'s responsibility.
|
|
347
|
+
pass
|
|
348
|
+
except Exception:
|
|
349
|
+
pass
|
|
350
|
+
return {"runId": run_id, "status": "cancelling"}
|
|
351
|
+
|
|
352
|
+
async def pause_run(self, run_id: str) -> dict[str, str]:
|
|
353
|
+
record = self.event_store.get(run_id)
|
|
354
|
+
if record.status == RunStatus.WAITING_INPUT:
|
|
355
|
+
raise StudioError(
|
|
356
|
+
"RUN_WAITING_INPUT",
|
|
357
|
+
"当前运行正在等待交互输入,请先处理卡片",
|
|
358
|
+
status_code=409,
|
|
359
|
+
)
|
|
360
|
+
if record.status != RunStatus.RUNNING:
|
|
361
|
+
raise StudioError("RUN_NOT_RUNNING", "只有运行中的 Run 可以暂停", status_code=409)
|
|
362
|
+
handle = self._active_handles.get(run_id)
|
|
363
|
+
if handle is None or not self.executor.is_attached(handle):
|
|
364
|
+
raise StudioError("RUN_NOT_ATTACHED", "运行句柄已不在当前进程", status_code=409)
|
|
365
|
+
result = await self.executor.pause(handle)
|
|
366
|
+
if result is PauseResult.NOT_SUPPORTED:
|
|
367
|
+
raise StudioError(
|
|
368
|
+
"RUN_PAUSE_UNSUPPORTED",
|
|
369
|
+
"当前 Runtime 不支持可恢复暂停",
|
|
370
|
+
status_code=409,
|
|
371
|
+
)
|
|
372
|
+
if result is not PauseResult.PAUSED_ACTIVE_TURN:
|
|
373
|
+
raise StudioError("RUN_PAUSE_FAILED", "暂停运行失败", status_code=409)
|
|
374
|
+
return {"runId": run_id, "status": "pausing"}
|
|
375
|
+
|
|
376
|
+
async def resume_run(self, run_id: str) -> dict[str, str]:
|
|
377
|
+
record = self.event_store.get(run_id)
|
|
378
|
+
if record.status != RunStatus.PAUSED:
|
|
379
|
+
raise StudioError("RUN_NOT_PAUSED", "只有已暂停的 Run 可以继续", status_code=409)
|
|
380
|
+
queue = self._control_queues.get(run_id)
|
|
381
|
+
if queue is None:
|
|
382
|
+
raise StudioError(
|
|
383
|
+
"RUN_RESUME_UNAVAILABLE",
|
|
384
|
+
"Studio 进程已重启,当前暂停点无法恢复",
|
|
385
|
+
status_code=409,
|
|
386
|
+
)
|
|
387
|
+
queue.put_nowait(("resume", ResumePayload(kind="free_text", data="继续运行")))
|
|
388
|
+
return {"runId": run_id, "status": "resuming"}
|
|
389
|
+
|
|
390
|
+
async def submit_interaction(
|
|
391
|
+
self,
|
|
392
|
+
run_id: str,
|
|
393
|
+
interaction_id: str,
|
|
394
|
+
*,
|
|
395
|
+
name: str,
|
|
396
|
+
data: dict[str, Any] | None = None,
|
|
397
|
+
) -> dict[str, Any]:
|
|
398
|
+
record = self.event_store.get(run_id)
|
|
399
|
+
if record.status != RunStatus.WAITING_INPUT:
|
|
400
|
+
raise StudioError(
|
|
401
|
+
"INTERACTION_NOT_PENDING",
|
|
402
|
+
"该 Run 当前没有等待中的交互",
|
|
403
|
+
status_code=409,
|
|
404
|
+
)
|
|
405
|
+
prior = [
|
|
406
|
+
event
|
|
407
|
+
for event in self.event_store.events(run_id)
|
|
408
|
+
if event.type == "a2ui.action"
|
|
409
|
+
and str(event.data.get("interactionId") or event.data.get("interaction_id") or "")
|
|
410
|
+
== interaction_id
|
|
411
|
+
]
|
|
412
|
+
if prior:
|
|
413
|
+
return {"runId": run_id, "interactionId": interaction_id, "status": "resolved"}
|
|
414
|
+
|
|
415
|
+
interaction = next(
|
|
416
|
+
(
|
|
417
|
+
event
|
|
418
|
+
for event in reversed(self.event_store.events(run_id))
|
|
419
|
+
if event.type == "a2ui.interaction"
|
|
420
|
+
and str(event.data.get("interactionId") or event.data.get("interaction_id") or "")
|
|
421
|
+
== interaction_id
|
|
422
|
+
),
|
|
423
|
+
None,
|
|
424
|
+
)
|
|
425
|
+
if interaction is None:
|
|
426
|
+
raise StudioError("INTERACTION_NOT_FOUND", "交互请求不存在", status_code=404)
|
|
427
|
+
kind = str(interaction.data.get("kind") or "form")
|
|
428
|
+
payload_data = {"decision": name, **dict(data or {})}
|
|
429
|
+
payload = ResumePayload(
|
|
430
|
+
kind="approval_decision" if kind == "approval" else "hitl_answer",
|
|
431
|
+
call_id=interaction_id,
|
|
432
|
+
data=payload_data,
|
|
433
|
+
)
|
|
434
|
+
mode = self._waiting_modes.get(run_id)
|
|
435
|
+
handle = self._active_handles.get(run_id)
|
|
436
|
+
if mode == "live":
|
|
437
|
+
if handle is None or not self.executor.is_attached(handle):
|
|
438
|
+
raise StudioError("INTERACTION_EXPIRED", "运行时交互已失效", status_code=409)
|
|
439
|
+
try:
|
|
440
|
+
await self.executor.submit(handle, payload)
|
|
441
|
+
except (RuntimeError, ValueError) as exc:
|
|
442
|
+
raise StudioError(
|
|
443
|
+
"INTERACTION_SUBMIT_FAILED",
|
|
444
|
+
str(exc),
|
|
445
|
+
status_code=409,
|
|
446
|
+
) from exc
|
|
447
|
+
elif mode == "resume":
|
|
448
|
+
queue = self._control_queues.get(run_id)
|
|
449
|
+
if queue is None:
|
|
450
|
+
raise StudioError("INTERACTION_EXPIRED", "运行时交互已失效", status_code=409)
|
|
451
|
+
queue.put_nowait(("resume", payload))
|
|
452
|
+
else:
|
|
453
|
+
raise StudioError("INTERACTION_EXPIRED", "运行时交互已失效", status_code=409)
|
|
454
|
+
|
|
455
|
+
resolved = self.event_store.append(
|
|
456
|
+
run_id,
|
|
457
|
+
"approval.resolved" if kind == "approval" else "interaction.resolved",
|
|
458
|
+
{
|
|
459
|
+
"runId": run_id,
|
|
460
|
+
"interactionId": interaction_id,
|
|
461
|
+
"callId": interaction_id,
|
|
462
|
+
"name": name,
|
|
463
|
+
"data": dict(data or {}),
|
|
464
|
+
},
|
|
465
|
+
)
|
|
466
|
+
action = self.event_store.append(
|
|
467
|
+
run_id,
|
|
468
|
+
"a2ui.action",
|
|
469
|
+
{
|
|
470
|
+
"runId": run_id,
|
|
471
|
+
"surfaceId": str(
|
|
472
|
+
interaction.data.get("surfaceId") or interaction.data.get("surface_id") or ""
|
|
473
|
+
),
|
|
474
|
+
"interactionId": interaction_id,
|
|
475
|
+
"actionId": f"action-{interaction_id}",
|
|
476
|
+
"name": name,
|
|
477
|
+
"data": dict(data or {}),
|
|
478
|
+
},
|
|
479
|
+
)
|
|
480
|
+
record.status = RunStatus.RUNNING
|
|
481
|
+
self.event_store.save(record)
|
|
482
|
+
self._waiting_modes.pop(run_id, None)
|
|
483
|
+
return {
|
|
484
|
+
"runId": run_id,
|
|
485
|
+
"interactionId": interaction_id,
|
|
486
|
+
"status": "resolved",
|
|
487
|
+
"eventId": action.id,
|
|
488
|
+
"resolutionEventId": resolved.id,
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
def _persist_approval_surface(
|
|
492
|
+
self,
|
|
493
|
+
record: RunRecord,
|
|
494
|
+
event: RuntimeEvent,
|
|
495
|
+
*,
|
|
496
|
+
on_event: Callable[[RunEvent], None] | None,
|
|
497
|
+
) -> None:
|
|
498
|
+
approval_id = str(event.payload.get("approval_id") or event.payload.get("call_id") or "")
|
|
499
|
+
if not approval_id:
|
|
500
|
+
return
|
|
501
|
+
surface_id = f"approval-{approval_id}"
|
|
502
|
+
detail = event.payload.get("detail")
|
|
503
|
+
detail = detail if isinstance(detail, dict) else {}
|
|
504
|
+
command = str(detail.get("command") or detail.get("reason") or "")
|
|
505
|
+
kind = str(event.payload.get("kind") or "tool")
|
|
506
|
+
components = [
|
|
507
|
+
{
|
|
508
|
+
"id": "root",
|
|
509
|
+
"component": "Card",
|
|
510
|
+
"title": "需要你的确认",
|
|
511
|
+
"children": ["approval"],
|
|
512
|
+
},
|
|
513
|
+
{
|
|
514
|
+
"id": "approval",
|
|
515
|
+
"component": "ApprovalBar",
|
|
516
|
+
"tool_name": kind,
|
|
517
|
+
"summary": command or f"Agent 请求执行 {kind} 操作",
|
|
518
|
+
"approve_label": "批准",
|
|
519
|
+
"deny_label": "拒绝",
|
|
520
|
+
},
|
|
521
|
+
]
|
|
522
|
+
begin = self.event_store.append(
|
|
523
|
+
record.id,
|
|
524
|
+
"a2ui.surface.begin",
|
|
525
|
+
{
|
|
526
|
+
"runId": record.id,
|
|
527
|
+
"surfaceId": surface_id,
|
|
528
|
+
"a2uiOperations": [
|
|
529
|
+
{
|
|
530
|
+
"version": "v0.9",
|
|
531
|
+
"createSurface": {
|
|
532
|
+
"surfaceId": surface_id,
|
|
533
|
+
"catalogId": "https://a2ui.org/specification/v0_9/basic_catalog.json",
|
|
534
|
+
},
|
|
535
|
+
},
|
|
536
|
+
{
|
|
537
|
+
"version": "v0.9",
|
|
538
|
+
"updateComponents": {
|
|
539
|
+
"surfaceId": surface_id,
|
|
540
|
+
"components": components,
|
|
541
|
+
},
|
|
542
|
+
},
|
|
543
|
+
],
|
|
544
|
+
},
|
|
545
|
+
)
|
|
546
|
+
interaction = self.event_store.append(
|
|
547
|
+
record.id,
|
|
548
|
+
"a2ui.interaction",
|
|
549
|
+
{
|
|
550
|
+
"runId": record.id,
|
|
551
|
+
"surfaceId": surface_id,
|
|
552
|
+
"interactionId": approval_id,
|
|
553
|
+
"kind": "approval",
|
|
554
|
+
"inputSchema": {
|
|
555
|
+
"type": "object",
|
|
556
|
+
"properties": {
|
|
557
|
+
"decision": {
|
|
558
|
+
"type": "string",
|
|
559
|
+
"enum": ["approve", "approve_session", "deny"],
|
|
560
|
+
}
|
|
561
|
+
},
|
|
562
|
+
"required": ["decision"],
|
|
563
|
+
},
|
|
564
|
+
},
|
|
565
|
+
)
|
|
566
|
+
if on_event is not None:
|
|
567
|
+
on_event(begin)
|
|
568
|
+
on_event(interaction)
|
|
569
|
+
|
|
570
|
+
def _conversation_messages(
|
|
571
|
+
self,
|
|
572
|
+
agent_id: str,
|
|
573
|
+
session_id: str,
|
|
574
|
+
user_input: str,
|
|
575
|
+
) -> list[dict[str, str]]:
|
|
576
|
+
messages: list[dict[str, str]] = []
|
|
577
|
+
for previous in self.event_store.list_runs(session_id=session_id):
|
|
578
|
+
if previous.agent_id != agent_id or previous.status != RunStatus.COMPLETED:
|
|
579
|
+
continue
|
|
580
|
+
messages.append({"role": "user", "content": previous.input})
|
|
581
|
+
messages.append({"role": "assistant", "content": previous.output})
|
|
582
|
+
messages.append({"role": "user", "content": user_input})
|
|
583
|
+
return messages
|
|
584
|
+
|
|
585
|
+
def _native_session_metadata(
|
|
586
|
+
self,
|
|
587
|
+
agent_id: str,
|
|
588
|
+
session_id: str,
|
|
589
|
+
runtime_type: str,
|
|
590
|
+
) -> dict[str, str]:
|
|
591
|
+
if runtime_type != "codex":
|
|
592
|
+
return {}
|
|
593
|
+
for previous in self.event_store.list_runs(session_id=session_id):
|
|
594
|
+
if previous.agent_id != agent_id or previous.status != RunStatus.COMPLETED:
|
|
595
|
+
continue
|
|
596
|
+
native_ref = previous.runtime_handle.get("native_ref")
|
|
597
|
+
native_ref = native_ref if isinstance(native_ref, dict) else {}
|
|
598
|
+
thread_id = str(native_ref.get("thread_id") or "")
|
|
599
|
+
if thread_id:
|
|
600
|
+
return {"thread_id": thread_id}
|
|
601
|
+
return {}
|
|
602
|
+
|
|
603
|
+
|
|
604
|
+
def project_runtime_event(event: RuntimeEvent) -> tuple[str, dict[str, Any]]:
|
|
605
|
+
"""Project the canonical RuntimeEvent into Studio's persisted event view."""
|
|
606
|
+
|
|
607
|
+
payload = dict(event.payload)
|
|
608
|
+
event_type = event.event_type
|
|
609
|
+
if event_type == EventType.RUN_STARTED:
|
|
610
|
+
projected = "run.started"
|
|
611
|
+
elif event_type == EventType.RUN_PROGRESS:
|
|
612
|
+
projected = str(payload.get("native_event") or "run.progress")
|
|
613
|
+
native_data = payload.get("native_data")
|
|
614
|
+
if isinstance(native_data, dict):
|
|
615
|
+
payload = dict(native_data)
|
|
616
|
+
elif event_type in {EventType.REASONING_DELTA, EventType.REASONING_COMPLETED}:
|
|
617
|
+
projected = (
|
|
618
|
+
"thinking.delta" if event_type == EventType.REASONING_DELTA else "thinking.completed"
|
|
619
|
+
)
|
|
620
|
+
elif event_type == EventType.TEXT_DELTA:
|
|
621
|
+
projected = "message.delta" if event.phase == "final_answer" else "thinking.delta"
|
|
622
|
+
elif event_type == EventType.TEXT_COMPLETED:
|
|
623
|
+
projected = "message.completed" if event.phase == "final_answer" else "thinking.completed"
|
|
624
|
+
elif event_type == EventType.TOOL_CALL_BEGIN:
|
|
625
|
+
projected = "command.started" if payload.get("name") == "codex.command" else "tool.started"
|
|
626
|
+
if projected == "command.started":
|
|
627
|
+
raw_args = payload.get("args")
|
|
628
|
+
args: dict[str, Any] = raw_args if isinstance(raw_args, dict) else {}
|
|
629
|
+
payload = {
|
|
630
|
+
"callId": str(payload.get("call_id") or ""),
|
|
631
|
+
"command": str(args.get("command") or ""),
|
|
632
|
+
"cwd": str(args.get("cwd") or ""),
|
|
633
|
+
"commandActions": args.get("command_actions") or [],
|
|
634
|
+
}
|
|
635
|
+
else:
|
|
636
|
+
payload = {
|
|
637
|
+
"callId": str(payload.get("call_id") or ""),
|
|
638
|
+
"tool": str(payload.get("name") or ""),
|
|
639
|
+
"args": payload.get("args"),
|
|
640
|
+
}
|
|
641
|
+
elif event_type == EventType.TOOL_CALL_END:
|
|
642
|
+
projected = (
|
|
643
|
+
"command.completed" if payload.get("name") == "codex.command" else "tool.completed"
|
|
644
|
+
)
|
|
645
|
+
if projected == "command.completed":
|
|
646
|
+
raw_result = payload.get("result")
|
|
647
|
+
result: dict[str, Any] = raw_result if isinstance(raw_result, dict) else {}
|
|
648
|
+
payload = {
|
|
649
|
+
"callId": str(payload.get("call_id") or ""),
|
|
650
|
+
"status": str(result.get("status") or ""),
|
|
651
|
+
"exitCode": result.get("exit_code"),
|
|
652
|
+
"durationMs": result.get("duration_ms"),
|
|
653
|
+
"output": str(result.get("output") or ""),
|
|
654
|
+
}
|
|
655
|
+
else:
|
|
656
|
+
raw_tool_result = payload.get("result")
|
|
657
|
+
tool_result: dict[str, Any] = (
|
|
658
|
+
raw_tool_result if isinstance(raw_tool_result, dict) else {}
|
|
659
|
+
)
|
|
660
|
+
tool_status = str(tool_result.get("status") or "")
|
|
661
|
+
if tool_result.get("error"):
|
|
662
|
+
tool_status = "failed"
|
|
663
|
+
payload = {
|
|
664
|
+
"callId": str(payload.get("call_id") or ""),
|
|
665
|
+
"tool": str(payload.get("name") or ""),
|
|
666
|
+
"status": tool_status,
|
|
667
|
+
"durationMs": tool_result.get("duration_ms"),
|
|
668
|
+
"output": str(tool_result.get("output") or ""),
|
|
669
|
+
**({"error": str(tool_result["error"])} if tool_result.get("error") else {}),
|
|
670
|
+
}
|
|
671
|
+
elif event_type == EventType.RUN_COMPLETED:
|
|
672
|
+
projected = "run.completed"
|
|
673
|
+
elif event_type == EventType.RUN_FAILED:
|
|
674
|
+
projected = "run.failed"
|
|
675
|
+
elif event_type == EventType.RUN_CANCELED:
|
|
676
|
+
projected = "run.cancelled"
|
|
677
|
+
elif event_type == EventType.RUN_INTERRUPTED:
|
|
678
|
+
projected = (
|
|
679
|
+
"run.paused" if str(payload.get("status") or "") == "paused" else "run.interrupted"
|
|
680
|
+
)
|
|
681
|
+
elif event_type in {
|
|
682
|
+
EventType.A2UI_SURFACE_BEGIN,
|
|
683
|
+
EventType.A2UI_SURFACE_UPDATE,
|
|
684
|
+
EventType.A2UI_SURFACE_END,
|
|
685
|
+
EventType.A2UI_INTERACTION,
|
|
686
|
+
EventType.A2UI_ACTION,
|
|
687
|
+
}:
|
|
688
|
+
projected = str(event_type)
|
|
689
|
+
surface_id = str(payload.get("surface_id") or payload.get("surfaceId") or "")
|
|
690
|
+
if surface_id:
|
|
691
|
+
payload["surfaceId"] = surface_id
|
|
692
|
+
interaction_id = str(payload.get("interaction_id") or payload.get("interactionId") or "")
|
|
693
|
+
if interaction_id:
|
|
694
|
+
payload["interactionId"] = interaction_id
|
|
695
|
+
schema = payload.get("input_schema", payload.get("inputSchema"))
|
|
696
|
+
if isinstance(schema, dict):
|
|
697
|
+
payload["inputSchema"] = schema
|
|
698
|
+
operations = project_a2ui_operations(event_type, payload)
|
|
699
|
+
if operations:
|
|
700
|
+
payload["a2uiOperations"] = operations
|
|
701
|
+
else:
|
|
702
|
+
projected = str(event_type)
|
|
703
|
+
payload["runtimeEvent"] = event.to_dict()
|
|
704
|
+
return projected, payload
|
|
705
|
+
|
|
706
|
+
|
|
707
|
+
__all__ = ["StudioRunService", "StudioRunSpec", "project_runtime_event"]
|