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,47 @@
|
|
|
1
|
+
"""Runtime app route composition independent from the default app facade."""
|
|
2
|
+
|
|
3
|
+
from fastapi import FastAPI
|
|
4
|
+
|
|
5
|
+
from ksadk.server.factory import RuntimeAppState, get_state
|
|
6
|
+
from ksadk.server.routes.common import _register_integrated_routers, _resolve_agent_ui_spec
|
|
7
|
+
from ksadk.server.routes.routers import GROUP_ROUTERS, load_route_modules
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def configure_runtime_app(app: FastAPI, state: RuntimeAppState, groups: set[str]) -> None:
|
|
11
|
+
"""Attach integrated resources and the selected route groups to one app."""
|
|
12
|
+
load_route_modules()
|
|
13
|
+
_configure_route_dependencies()
|
|
14
|
+
_register_integrated_routers(app, state)
|
|
15
|
+
|
|
16
|
+
ordered = sorted(group for group in groups if group != "health_meta")
|
|
17
|
+
if "health_meta" in groups:
|
|
18
|
+
ordered.append("health_meta")
|
|
19
|
+
for group in ordered:
|
|
20
|
+
router = GROUP_ROUTERS.get(group)
|
|
21
|
+
if router is not None:
|
|
22
|
+
app.include_router(router)
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
def _configure_route_dependencies() -> None:
|
|
26
|
+
"""Install dynamic providers that always resolve the request-bound app state."""
|
|
27
|
+
|
|
28
|
+
import ksadk.conversations as conversation
|
|
29
|
+
from ksadk.server.routes import dependencies
|
|
30
|
+
from ksadk.server.routes.streaming import (
|
|
31
|
+
SSE_HEARTBEAT_INTERVAL_SECONDS,
|
|
32
|
+
_DetachedSSEStream,
|
|
33
|
+
detached_streaming_response,
|
|
34
|
+
)
|
|
35
|
+
|
|
36
|
+
dependencies.configure(
|
|
37
|
+
dependencies.ServerRouteDependencies(
|
|
38
|
+
resolve_session_service=lambda: get_state().resolve_session_service(),
|
|
39
|
+
describe_session_backend=lambda: get_state().describe_session_backend(),
|
|
40
|
+
resolve_agent_ui_spec=_resolve_agent_ui_spec,
|
|
41
|
+
conversation=lambda: conversation,
|
|
42
|
+
detached_streaming_response=detached_streaming_response,
|
|
43
|
+
detached_stream_class=lambda: _DetachedSSEStream,
|
|
44
|
+
heartbeat_interval=lambda: SSE_HEARTBEAT_INTERVAL_SECONDS,
|
|
45
|
+
runtime_app=lambda: get_state().app,
|
|
46
|
+
)
|
|
47
|
+
)
|
ksadk/server/factory.py
ADDED
|
@@ -0,0 +1,622 @@
|
|
|
1
|
+
"""create_runtime_app — 普通 runtime 与 HarnessApp 共用的 app factory (goal-01)。
|
|
2
|
+
|
|
3
|
+
H2 §4.2:这是三线公共装配入口,替代 `ksadk/server/app.py` 的模块级单例 +
|
|
4
|
+
`set_runner` 全局态。纯结构性重构,不动业务逻辑。
|
|
5
|
+
|
|
6
|
+
设计要点:
|
|
7
|
+
|
|
8
|
+
- **per-app state**:RuntimeExecutor / RuntimeLaunchContext / detached-stream registry 全部挂在
|
|
9
|
+
`app.state.runtime`(:class:`RuntimeAppState`)上,每个 app 实例一份,普通 app 与
|
|
10
|
+
HarnessApp 互不共享。不再有模块级 ``runner`` / ``_DETACHED_*`` 全局可变态。
|
|
11
|
+
- **请求级桥接**:中间件把当前 app 的 state 写入 :data:`current_state` 的
|
|
12
|
+
contextvar,handler 内既有辅助函数经 :func:`get_state` 取 state,从而**不必逐个
|
|
13
|
+
改写约 30 个 handler 的签名**。后台 detached task 脱离请求上下文,在创建时
|
|
14
|
+
从 state 捕获 registry(见 ``_detached_streaming_response``)。
|
|
15
|
+
- **route group 化**:路由按域拆成 APIRouter,factory 按 ``config.route_groups``
|
|
16
|
+
可插拔装配;数据面 group 进 HarnessApp,控制面(cancel/resume/builder/debug)
|
|
17
|
+
不进。
|
|
18
|
+
- **薄兼容壳**:`ksadk/server/app.py` 仍以 ``app`` / ``set_runner`` 暴露,内部
|
|
19
|
+
改为调用本 factory,老调用方(TestClient / run_server / builders / deploy
|
|
20
|
+
manager)零改动。
|
|
21
|
+
"""
|
|
22
|
+
|
|
23
|
+
from __future__ import annotations
|
|
24
|
+
|
|
25
|
+
import asyncio
|
|
26
|
+
import contextvars
|
|
27
|
+
import logging
|
|
28
|
+
from contextlib import contextmanager
|
|
29
|
+
from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional
|
|
30
|
+
|
|
31
|
+
from fastapi import FastAPI
|
|
32
|
+
|
|
33
|
+
from ksadk.runtime.adapter import RuntimeAdapter, RuntimeLaunchContext
|
|
34
|
+
from ksadk.runtime.executor import RuntimeExecutor
|
|
35
|
+
from ksadk.sandbox.registry import (
|
|
36
|
+
SandboxRegistry,
|
|
37
|
+
bind_sandbox_registry,
|
|
38
|
+
set_fallback_sandbox_registry,
|
|
39
|
+
)
|
|
40
|
+
|
|
41
|
+
logger = logging.getLogger(__name__)
|
|
42
|
+
|
|
43
|
+
if TYPE_CHECKING:
|
|
44
|
+
from ksadk.server.terminal_sessions import TerminalSessionManager
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
# ---------------------------------------------------------------------------
|
|
48
|
+
# route group 注册表(冻结稿 G0.1):数据面 vs 控制面
|
|
49
|
+
# ---------------------------------------------------------------------------
|
|
50
|
+
|
|
51
|
+
#: 数据面 route group —— 可插拔装配进 HarnessApp。
|
|
52
|
+
DATA_PLANE_GROUPS: frozenset[str] = frozenset(
|
|
53
|
+
{
|
|
54
|
+
"health_meta",
|
|
55
|
+
"sessions",
|
|
56
|
+
"sessions_adk_compat",
|
|
57
|
+
"run",
|
|
58
|
+
"openai_compat",
|
|
59
|
+
"workspace",
|
|
60
|
+
"models",
|
|
61
|
+
"feedback",
|
|
62
|
+
"tools",
|
|
63
|
+
"ui_bootstrap",
|
|
64
|
+
"agui",
|
|
65
|
+
}
|
|
66
|
+
)
|
|
67
|
+
|
|
68
|
+
#: 控制面 route group —— 不进入 HarnessApp(H2 §4.2:控制面 action 不进入)。
|
|
69
|
+
CONTROL_PLANE_GROUPS: frozenset[str] = frozenset(
|
|
70
|
+
{
|
|
71
|
+
"control", # cancel / resume / checkpoint-resume-preview
|
|
72
|
+
"builder",
|
|
73
|
+
"debug",
|
|
74
|
+
}
|
|
75
|
+
)
|
|
76
|
+
|
|
77
|
+
#: 全部 group(普通 runtime app 默认装配)。
|
|
78
|
+
ALL_GROUPS: frozenset[str] = DATA_PLANE_GROUPS | CONTROL_PLANE_GROUPS
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
class StreamRegistry:
|
|
82
|
+
"""per-app detached SSE stream + resume-key 状态。
|
|
83
|
+
|
|
84
|
+
替代 `app.py` 曾经的模块级 ``_DETACHED_STREAMS`` / ``_DETACHED_STREAMS_BY_INVOCATION``
|
|
85
|
+
/ ``_DETACHED_RESUME_KEYS_BY_INVOCATION`` / ``_ACTIVE_DETACHED_RESUME_INVOCATION_BY_KEY``。
|
|
86
|
+
生命周期绑定所属 app(lifespan 清理)。SSE/cancel 行为与旧模块级实现逐点一致。
|
|
87
|
+
"""
|
|
88
|
+
|
|
89
|
+
def __init__(self) -> None:
|
|
90
|
+
self.streams: set[asyncio.Task[Any]] = set()
|
|
91
|
+
self.streams_by_invocation: dict[str, Any] = {}
|
|
92
|
+
self.resume_keys_by_invocation: dict[str, tuple[str, str]] = {}
|
|
93
|
+
self.active_resume_invocation_by_key: dict[tuple[str, str], str] = {}
|
|
94
|
+
|
|
95
|
+
def clear(self) -> None:
|
|
96
|
+
self.streams.clear()
|
|
97
|
+
self.streams_by_invocation.clear()
|
|
98
|
+
self.resume_keys_by_invocation.clear()
|
|
99
|
+
self.active_resume_invocation_by_key.clear()
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
class RuntimeAppState:
|
|
103
|
+
"""per-app 运行时状态及其拥有的可清理资源。"""
|
|
104
|
+
|
|
105
|
+
def __init__(
|
|
106
|
+
self,
|
|
107
|
+
*,
|
|
108
|
+
executor: RuntimeExecutor | None = None,
|
|
109
|
+
launch_context: RuntimeLaunchContext | None = None,
|
|
110
|
+
session_service_provider: Callable[[], Any] | None = None,
|
|
111
|
+
session_backend_provider: Callable[[], dict[str, Any]] | None = None,
|
|
112
|
+
) -> None:
|
|
113
|
+
self.app: Optional[FastAPI] = None
|
|
114
|
+
self.executor = executor
|
|
115
|
+
self.launch_context = launch_context
|
|
116
|
+
self.stream_registry = StreamRegistry()
|
|
117
|
+
self.sandbox_registry = SandboxRegistry()
|
|
118
|
+
self.session_service: Any = None
|
|
119
|
+
self._session_services_by_loop: dict[asyncio.AbstractEventLoop, Any] = {}
|
|
120
|
+
self._sync_session_service: Any = None
|
|
121
|
+
# The legacy ``server.app`` facade exposes monkeypatchable providers.
|
|
122
|
+
# New factory callers leave these unset and get per-app owned services.
|
|
123
|
+
self._session_service_provider = session_service_provider
|
|
124
|
+
self._session_backend_provider = session_backend_provider
|
|
125
|
+
# app.py 在装配 terminal routes 时创建,避免 factory 反向依赖 server。
|
|
126
|
+
self.terminal_manager: Optional[TerminalSessionManager] = None
|
|
127
|
+
# A2A 装配产物(config.a2a.enabled 时由 _wire_a2a_if_enabled 写入)。
|
|
128
|
+
self.a2a_server: Any = None
|
|
129
|
+
self.a2a_bootstrap: Any = None
|
|
130
|
+
# AG-UI endpoint 及其 app-owned RuntimeAdapter handle registry。
|
|
131
|
+
self.agui_agent: Any = None
|
|
132
|
+
self.agui_config: Any = None
|
|
133
|
+
|
|
134
|
+
def resolve_session_service(self) -> Any:
|
|
135
|
+
"""Return this app's session service for the current execution loop."""
|
|
136
|
+
if self.session_service is not None:
|
|
137
|
+
return self.session_service
|
|
138
|
+
if self._session_service_provider is not None:
|
|
139
|
+
return self._session_service_provider()
|
|
140
|
+
|
|
141
|
+
from ksadk.sessions import create_session_service
|
|
142
|
+
|
|
143
|
+
try:
|
|
144
|
+
loop = asyncio.get_running_loop()
|
|
145
|
+
except RuntimeError:
|
|
146
|
+
if self._sync_session_service is None:
|
|
147
|
+
self._sync_session_service = create_session_service()
|
|
148
|
+
return self._sync_session_service
|
|
149
|
+
|
|
150
|
+
service = self._session_services_by_loop.get(loop)
|
|
151
|
+
if service is None:
|
|
152
|
+
service = create_session_service()
|
|
153
|
+
self._session_services_by_loop[loop] = service
|
|
154
|
+
return service
|
|
155
|
+
|
|
156
|
+
def session_services(self) -> list[Any]:
|
|
157
|
+
"""Return all unique services owned by this app for shutdown."""
|
|
158
|
+
candidates = [
|
|
159
|
+
self.session_service,
|
|
160
|
+
self._sync_session_service,
|
|
161
|
+
*self._session_services_by_loop.values(),
|
|
162
|
+
]
|
|
163
|
+
services: list[Any] = []
|
|
164
|
+
for service in candidates:
|
|
165
|
+
if service is not None and all(service is not item for item in services):
|
|
166
|
+
services.append(service)
|
|
167
|
+
return services
|
|
168
|
+
|
|
169
|
+
def describe_session_backend(self) -> dict[str, Any]:
|
|
170
|
+
if self._session_backend_provider is not None:
|
|
171
|
+
return dict(self._session_backend_provider())
|
|
172
|
+
from ksadk.sessions import describe_session_backend
|
|
173
|
+
|
|
174
|
+
return dict(describe_session_backend())
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
class RuntimeAppConfig:
|
|
178
|
+
"""create_runtime_app 的装配配置。
|
|
179
|
+
|
|
180
|
+
- ``runtime_executor``:统一 Runtime 生命周期入口。
|
|
181
|
+
- ``launch_context``:当前 Runtime 与项目的不可变启动上下文。
|
|
182
|
+
- ``runtime_type``:runtime 类型标识(普通 / harness / codex ...)。
|
|
183
|
+
- ``route_groups``:要装配的 route group 集合;默认 :data:`ALL_GROUPS`,
|
|
184
|
+
HarnessApp 传 :data:`DATA_PLANE_GROUPS`。
|
|
185
|
+
"""
|
|
186
|
+
|
|
187
|
+
def __init__(
|
|
188
|
+
self,
|
|
189
|
+
*,
|
|
190
|
+
runtime_type: str = "local",
|
|
191
|
+
route_groups: Optional[set[str]] = None,
|
|
192
|
+
a2a: Optional[Any] = None,
|
|
193
|
+
a2a_runtime_adapter: RuntimeAdapter | None = None,
|
|
194
|
+
agui: Optional[Any] = None,
|
|
195
|
+
runtime_executor: RuntimeExecutor | None = None,
|
|
196
|
+
launch_context: RuntimeLaunchContext | None = None,
|
|
197
|
+
session_service_provider: Callable[[], Any] | None = None,
|
|
198
|
+
session_backend_provider: Callable[[], dict[str, Any]] | None = None,
|
|
199
|
+
) -> None:
|
|
200
|
+
self.runtime_type = runtime_type
|
|
201
|
+
self.route_groups: set[str] = (
|
|
202
|
+
set(route_groups) if route_groups is not None else set(ALL_GROUPS)
|
|
203
|
+
)
|
|
204
|
+
# A2A 协议装配配置(``ksadk.a2a.routes.A2AConfig``);enabled 时 factory 装配
|
|
205
|
+
# A2A 数据面端点(契约 §8)。用 Any 避免本模块硬依赖可选的 a2a-sdk。
|
|
206
|
+
self.a2a = a2a
|
|
207
|
+
self.a2a_runtime_adapter = a2a_runtime_adapter
|
|
208
|
+
self.agui = agui
|
|
209
|
+
self.runtime_executor = runtime_executor
|
|
210
|
+
self.launch_context = launch_context
|
|
211
|
+
self.session_service_provider = session_service_provider
|
|
212
|
+
self.session_backend_provider = session_backend_provider
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
# ---------------------------------------------------------------------------
|
|
216
|
+
# 请求级 state 桥接
|
|
217
|
+
# ---------------------------------------------------------------------------
|
|
218
|
+
|
|
219
|
+
_current_state: contextvars.ContextVar[Optional[RuntimeAppState]] = contextvars.ContextVar(
|
|
220
|
+
"ksadk_runtime_app_state", default=None
|
|
221
|
+
)
|
|
222
|
+
|
|
223
|
+
# 非请求上下文(直接调用内部 helper 的测试 / run_server 启动前)的兜底 state。
|
|
224
|
+
# 由 app.py 在 factory 建 app 后指向 ``app.state.runtime``。
|
|
225
|
+
_fallback_state: RuntimeAppState = RuntimeAppState()
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
def set_fallback_state(state: RuntimeAppState) -> None:
|
|
229
|
+
"""把兜底 state 指向某个 app 的 state(兼容壳用)。"""
|
|
230
|
+
global _fallback_state
|
|
231
|
+
_fallback_state = state
|
|
232
|
+
set_fallback_sandbox_registry(state.sandbox_registry)
|
|
233
|
+
|
|
234
|
+
|
|
235
|
+
def get_state() -> RuntimeAppState:
|
|
236
|
+
"""取当前请求对应的 app state;非请求上下文退回兜底 state。"""
|
|
237
|
+
state = _current_state.get()
|
|
238
|
+
return state if state is not None else _fallback_state
|
|
239
|
+
|
|
240
|
+
|
|
241
|
+
def get_runtime_execution() -> tuple[RuntimeExecutor, RuntimeLaunchContext]:
|
|
242
|
+
"""Resolve the current app's canonical runtime execution dependencies."""
|
|
243
|
+
|
|
244
|
+
from fastapi import HTTPException
|
|
245
|
+
|
|
246
|
+
state = get_state()
|
|
247
|
+
if state.executor is None or state.launch_context is None:
|
|
248
|
+
raise HTTPException(status_code=500, detail="RuntimeExecutor 未初始化")
|
|
249
|
+
return state.executor, state.launch_context
|
|
250
|
+
|
|
251
|
+
|
|
252
|
+
@contextmanager
|
|
253
|
+
def bind_runtime_state(state: RuntimeAppState) -> Iterator[None]:
|
|
254
|
+
"""Bind one app state for non-HTTP scopes such as WebSockets."""
|
|
255
|
+
token = _current_state.set(state)
|
|
256
|
+
try:
|
|
257
|
+
with bind_sandbox_registry(state.sandbox_registry):
|
|
258
|
+
yield
|
|
259
|
+
finally:
|
|
260
|
+
_current_state.reset(token)
|
|
261
|
+
|
|
262
|
+
|
|
263
|
+
# ---------------------------------------------------------------------------
|
|
264
|
+
# factory
|
|
265
|
+
# ---------------------------------------------------------------------------
|
|
266
|
+
|
|
267
|
+
# configure 回调签名:由 app.py 提供,负责把各 domain router 挂到 app 上。
|
|
268
|
+
ConfigureApp = Callable[[FastAPI, RuntimeAppState, set[str]], None]
|
|
269
|
+
|
|
270
|
+
|
|
271
|
+
async def shutdown_runtime_resources(state: RuntimeAppState) -> None:
|
|
272
|
+
"""Close only resources owned by one runtime app."""
|
|
273
|
+
manager = state.terminal_manager
|
|
274
|
+
if manager is not None:
|
|
275
|
+
try:
|
|
276
|
+
await manager.close()
|
|
277
|
+
except Exception:
|
|
278
|
+
logger.exception("failed to close terminal sessions on shutdown")
|
|
279
|
+
|
|
280
|
+
registry = state.stream_registry
|
|
281
|
+
pending_streams = list(registry.streams)
|
|
282
|
+
for task in pending_streams:
|
|
283
|
+
task.cancel()
|
|
284
|
+
if pending_streams:
|
|
285
|
+
await asyncio.gather(*pending_streams, return_exceptions=True)
|
|
286
|
+
registry.clear()
|
|
287
|
+
|
|
288
|
+
if state.executor is not None:
|
|
289
|
+
try:
|
|
290
|
+
await state.executor.close_all()
|
|
291
|
+
except Exception:
|
|
292
|
+
logger.exception("failed to close runtime adapters on shutdown")
|
|
293
|
+
|
|
294
|
+
for service in state.session_services():
|
|
295
|
+
close = getattr(service, "aclose", None)
|
|
296
|
+
if callable(close):
|
|
297
|
+
try:
|
|
298
|
+
await close()
|
|
299
|
+
except Exception:
|
|
300
|
+
logger.exception("failed to close app session service on shutdown")
|
|
301
|
+
|
|
302
|
+
try:
|
|
303
|
+
state.sandbox_registry.close()
|
|
304
|
+
except Exception:
|
|
305
|
+
logger.exception("failed to clear sandbox registry on shutdown")
|
|
306
|
+
|
|
307
|
+
|
|
308
|
+
def _is_agent_execution_path(path: str, method: str) -> bool:
|
|
309
|
+
"""是否 agent 执行类请求(需要 root span 兜底,让 tool 内 outbound 挂到该 trace)。
|
|
310
|
+
|
|
311
|
+
session 管理(GetAgentUiBootstrap/ListSessionMessages 等轮询)与 UI/health 不建 span。
|
|
312
|
+
"""
|
|
313
|
+
m = (method or "").upper()
|
|
314
|
+
p = (path or "").strip()
|
|
315
|
+
if m == "POST" and p in {
|
|
316
|
+
"/v1/responses",
|
|
317
|
+
"/v1/chat/completions",
|
|
318
|
+
"/run",
|
|
319
|
+
"/run_sse",
|
|
320
|
+
"/agentengine/api/v1/RunAgent",
|
|
321
|
+
}:
|
|
322
|
+
return True
|
|
323
|
+
if m == "GET" and p in {"/agentengine/api/v1/SubscribeRunEvents"}:
|
|
324
|
+
return True
|
|
325
|
+
return False
|
|
326
|
+
|
|
327
|
+
|
|
328
|
+
def create_runtime_app(
|
|
329
|
+
config: RuntimeAppConfig,
|
|
330
|
+
configure: Optional[ConfigureApp] = None,
|
|
331
|
+
) -> FastAPI:
|
|
332
|
+
"""装配一个 runtime app。
|
|
333
|
+
|
|
334
|
+
参数:
|
|
335
|
+
config: :class:`RuntimeAppConfig`(executor / launch_context / route_groups)。
|
|
336
|
+
configure: 路由装配回调 ``configure(app, state, route_groups)``;由
|
|
337
|
+
``ksadk/server/app.py`` 提供,负责按 group 把 domain router include 进 app。
|
|
338
|
+
factory 自身只负责 FastAPI 实例、state、中间件、lifespan、异常处理器,
|
|
339
|
+
不 import 全局 ``base_app`` 再过滤复制路由(H2 禁止)。
|
|
340
|
+
"""
|
|
341
|
+
from contextlib import asynccontextmanager
|
|
342
|
+
from typing import AsyncIterator
|
|
343
|
+
|
|
344
|
+
from fastapi.middleware.cors import CORSMiddleware
|
|
345
|
+
from fastapi.responses import Response
|
|
346
|
+
|
|
347
|
+
state = RuntimeAppState(
|
|
348
|
+
executor=config.runtime_executor,
|
|
349
|
+
launch_context=config.launch_context,
|
|
350
|
+
session_service_provider=config.session_service_provider,
|
|
351
|
+
session_backend_provider=config.session_backend_provider,
|
|
352
|
+
)
|
|
353
|
+
|
|
354
|
+
@asynccontextmanager
|
|
355
|
+
async def _lifespan(app: FastAPI) -> AsyncIterator[None]:
|
|
356
|
+
try:
|
|
357
|
+
if state.a2a_bootstrap is not None:
|
|
358
|
+
await state.a2a_bootstrap.start()
|
|
359
|
+
yield
|
|
360
|
+
finally:
|
|
361
|
+
if state.a2a_bootstrap is not None:
|
|
362
|
+
await state.a2a_bootstrap.stop()
|
|
363
|
+
await shutdown_runtime_resources(state)
|
|
364
|
+
|
|
365
|
+
app = FastAPI(
|
|
366
|
+
title="ADK Core API",
|
|
367
|
+
description="Agent Development Kit HTTP API",
|
|
368
|
+
version="1.0.0",
|
|
369
|
+
lifespan=_lifespan,
|
|
370
|
+
)
|
|
371
|
+
state.app = app
|
|
372
|
+
app.state.runtime = state
|
|
373
|
+
|
|
374
|
+
# 中间件:把当前 app 的 state 写入请求级 contextvar(handler 经 get_state() 取)。
|
|
375
|
+
@app.middleware("http")
|
|
376
|
+
async def _runtime_state_bridge(request, call_next):
|
|
377
|
+
from ksadk.server.routes.dependencies import bind_session_service
|
|
378
|
+
|
|
379
|
+
with (
|
|
380
|
+
bind_runtime_state(state),
|
|
381
|
+
bind_session_service(
|
|
382
|
+
state.resolve_session_service(),
|
|
383
|
+
backend=state.describe_session_backend(),
|
|
384
|
+
),
|
|
385
|
+
):
|
|
386
|
+
# 提取 inbound OTel trace context(traceparent);无有效 inbound 时建一个
|
|
387
|
+
# 覆盖整个请求的 root server span,让 langchain/openinference 的 agent span 与
|
|
388
|
+
# tool 内 outbound(A2A)调用都挂到这条 trace 上(openinference 只在 LLM 调用
|
|
389
|
+
# 期间建 span,tool 执行时其 span 已 detach,需一个贯穿 span 兜底)。
|
|
390
|
+
# 只对 agent 执行类路径建 root span;session/UI 管理路径(GetAgentUiBootstrap/
|
|
391
|
+
# ListSessionMessages 等轮询)不建,避免一次问答产生一堆独立 trace。
|
|
392
|
+
try:
|
|
393
|
+
from opentelemetry import context as _otel_ctx
|
|
394
|
+
from opentelemetry import propagate
|
|
395
|
+
from opentelemetry import trace as _otel_trace
|
|
396
|
+
|
|
397
|
+
_carrier = dict(request.headers)
|
|
398
|
+
_parent = propagate.extract(_carrier)
|
|
399
|
+
_parent_span_ctx = _otel_trace.get_current_span(_parent).get_span_context()
|
|
400
|
+
except Exception:
|
|
401
|
+
logger.exception("failed to initialize request tracing; continuing without OTel")
|
|
402
|
+
response = await call_next(request)
|
|
403
|
+
else:
|
|
404
|
+
if _parent_span_ctx.is_valid:
|
|
405
|
+
try:
|
|
406
|
+
_token = _otel_ctx.attach(_parent)
|
|
407
|
+
except Exception:
|
|
408
|
+
logger.exception(
|
|
409
|
+
"failed to attach inbound trace context; continuing without OTel"
|
|
410
|
+
)
|
|
411
|
+
response = await call_next(request)
|
|
412
|
+
else:
|
|
413
|
+
try:
|
|
414
|
+
response = await call_next(request)
|
|
415
|
+
finally:
|
|
416
|
+
try:
|
|
417
|
+
_otel_ctx.detach(_token)
|
|
418
|
+
except Exception:
|
|
419
|
+
logger.exception("failed to detach inbound trace context")
|
|
420
|
+
elif _is_agent_execution_path(request.url.path, request.method):
|
|
421
|
+
try:
|
|
422
|
+
_tracer = _otel_trace.get_tracer("ksadk.server")
|
|
423
|
+
_span_scope = _tracer.start_as_current_span(
|
|
424
|
+
f"{request.method} {request.url.path}"
|
|
425
|
+
)
|
|
426
|
+
_span_scope.__enter__()
|
|
427
|
+
except Exception:
|
|
428
|
+
logger.exception(
|
|
429
|
+
"failed to start request span; continuing without OTel"
|
|
430
|
+
)
|
|
431
|
+
response = await call_next(request)
|
|
432
|
+
else:
|
|
433
|
+
try:
|
|
434
|
+
response = await call_next(request)
|
|
435
|
+
except BaseException as exc:
|
|
436
|
+
try:
|
|
437
|
+
_span_scope.__exit__(type(exc), exc, exc.__traceback__)
|
|
438
|
+
except Exception:
|
|
439
|
+
logger.exception("failed to close request span after handler error")
|
|
440
|
+
raise
|
|
441
|
+
else:
|
|
442
|
+
try:
|
|
443
|
+
_span_scope.__exit__(None, None, None)
|
|
444
|
+
except Exception:
|
|
445
|
+
logger.exception("failed to close request span")
|
|
446
|
+
else:
|
|
447
|
+
response = await call_next(request)
|
|
448
|
+
path = request.url.path
|
|
449
|
+
if path == "/" or path.endswith(".html"):
|
|
450
|
+
response.headers["Cache-Control"] = "no-cache, no-store, must-revalidate"
|
|
451
|
+
response.headers["Pragma"] = "no-cache"
|
|
452
|
+
response.headers["Expires"] = "0"
|
|
453
|
+
return response
|
|
454
|
+
|
|
455
|
+
# CORS(与旧 app 一致,默认对 ADK 工具放开)。
|
|
456
|
+
app.add_middleware(
|
|
457
|
+
CORSMiddleware,
|
|
458
|
+
allow_origins=["*"],
|
|
459
|
+
allow_credentials=True,
|
|
460
|
+
allow_methods=["*"],
|
|
461
|
+
allow_headers=["*"],
|
|
462
|
+
)
|
|
463
|
+
|
|
464
|
+
# 异常处理器(与旧 app 一致)。
|
|
465
|
+
import json as _json
|
|
466
|
+
|
|
467
|
+
from ksadk.sessions.errors import SessionBackendUnavailable
|
|
468
|
+
|
|
469
|
+
@app.exception_handler(SessionBackendUnavailable)
|
|
470
|
+
async def session_backend_unavailable_handler(_request, exc: SessionBackendUnavailable):
|
|
471
|
+
return Response(
|
|
472
|
+
content=_json.dumps(
|
|
473
|
+
{"detail": {"code": "session_backend_unavailable", "message": str(exc)}},
|
|
474
|
+
ensure_ascii=False,
|
|
475
|
+
),
|
|
476
|
+
status_code=503,
|
|
477
|
+
media_type="application/json",
|
|
478
|
+
)
|
|
479
|
+
|
|
480
|
+
# A2A 端点须在 configure 之前装配:health_meta 含 GET catch-all ``/{requested_path:path}``,
|
|
481
|
+
# 若 A2A 后挂,A2A 的 GET 路由(agent-card / tasks/{id})会被 catch-all 遮蔽成 404。
|
|
482
|
+
_wire_a2a_if_enabled(app, state, config)
|
|
483
|
+
_wire_agui_if_enabled(app, state, config)
|
|
484
|
+
|
|
485
|
+
if configure is not None:
|
|
486
|
+
configure(app, state, set(config.route_groups))
|
|
487
|
+
|
|
488
|
+
return app
|
|
489
|
+
|
|
490
|
+
|
|
491
|
+
def _wire_a2a_if_enabled(app: FastAPI, state: RuntimeAppState, config: RuntimeAppConfig) -> None:
|
|
492
|
+
"""Mount A2A with an explicitly injected RuntimeAdapter.
|
|
493
|
+
|
|
494
|
+
The server composition root never resolves or wraps a Runner. Framework
|
|
495
|
+
internals may still use one behind their adapter factory, but A2A only sees
|
|
496
|
+
the frozen RuntimeAdapter contract.
|
|
497
|
+
"""
|
|
498
|
+
a2a_cfg = config.a2a
|
|
499
|
+
if a2a_cfg is None:
|
|
500
|
+
return
|
|
501
|
+
from ksadk.managed_a2a_card import ManagedA2ACardMount
|
|
502
|
+
|
|
503
|
+
if isinstance(a2a_cfg, ManagedA2ACardMount):
|
|
504
|
+
a2a_cfg.mount(app)
|
|
505
|
+
state.a2a_bootstrap = a2a_cfg
|
|
506
|
+
logger.info(
|
|
507
|
+
"managed A2A discovery card mounted(agent_name=%s base_url=%s)",
|
|
508
|
+
a2a_cfg.config.agent_name,
|
|
509
|
+
a2a_cfg.config.base_url,
|
|
510
|
+
)
|
|
511
|
+
return
|
|
512
|
+
from ksadk.a2a.bootstrap import AgentEngineA2ABootstrap
|
|
513
|
+
|
|
514
|
+
adapter = config.a2a_runtime_adapter
|
|
515
|
+
if adapter is None:
|
|
516
|
+
raise ValueError("A2A requires an explicitly injected RuntimeAdapter")
|
|
517
|
+
runtime_type = adapter.runtime.runtime_type or config.runtime_type
|
|
518
|
+
|
|
519
|
+
if isinstance(a2a_cfg, AgentEngineA2ABootstrap):
|
|
520
|
+
server = a2a_cfg.mount(
|
|
521
|
+
app,
|
|
522
|
+
runtime_adapter=adapter,
|
|
523
|
+
runtime_type=runtime_type,
|
|
524
|
+
)
|
|
525
|
+
state.a2a_bootstrap = a2a_cfg
|
|
526
|
+
state.a2a_server = server
|
|
527
|
+
logger.info(
|
|
528
|
+
"managed A2A Runtime mounted(agent=%s inbound_enabled=%s)",
|
|
529
|
+
a2a_cfg.runtime_metadata.agent_id,
|
|
530
|
+
a2a_cfg.inbound_enabled,
|
|
531
|
+
)
|
|
532
|
+
return
|
|
533
|
+
if not getattr(a2a_cfg, "enabled", False):
|
|
534
|
+
return
|
|
535
|
+
from ksadk.a2a.routes import add_a2a_protocol_routes
|
|
536
|
+
from ksadk.a2a.task_adapter import A2ARuntimeTaskAdapter
|
|
537
|
+
|
|
538
|
+
task_adapter = A2ARuntimeTaskAdapter(adapter, runtime_type=runtime_type)
|
|
539
|
+
server = add_a2a_protocol_routes(app, a2a_cfg, task_adapter=task_adapter)
|
|
540
|
+
state.a2a_server = server
|
|
541
|
+
logger.info("A2A 协议端点已装配进 runtime app(agent=%s)", a2a_cfg.agent_name)
|
|
542
|
+
|
|
543
|
+
|
|
544
|
+
def _wire_agui_if_enabled(app: FastAPI, state: RuntimeAppState, config: RuntimeAppConfig) -> None:
|
|
545
|
+
"""Mount the optional official AG-UI endpoint before the static catch-all."""
|
|
546
|
+
agui_cfg = config.agui
|
|
547
|
+
if (
|
|
548
|
+
agui_cfg is None
|
|
549
|
+
or not getattr(agui_cfg, "enabled", False)
|
|
550
|
+
or "agui" not in config.route_groups
|
|
551
|
+
):
|
|
552
|
+
return
|
|
553
|
+
|
|
554
|
+
from ksadk.agui.config import require_agui_dependencies
|
|
555
|
+
|
|
556
|
+
require_agui_dependencies()
|
|
557
|
+
|
|
558
|
+
from ksadk.agui.routes import add_ksadk_agui_endpoint
|
|
559
|
+
from ksadk.events.store import RuntimeEventStore
|
|
560
|
+
from ksadk.server.routes import dependencies as route_dependencies
|
|
561
|
+
|
|
562
|
+
if state.executor is None or state.launch_context is None:
|
|
563
|
+
raise ValueError("AG-UI requires RuntimeExecutor and RuntimeLaunchContext")
|
|
564
|
+
|
|
565
|
+
class _AutoSessionRuntimeEventStore:
|
|
566
|
+
"""Create a session on first AG-UI event when HttpAgent starts fresh."""
|
|
567
|
+
|
|
568
|
+
def __init__(self, service: Any) -> None:
|
|
569
|
+
self._service = service
|
|
570
|
+
self._store = RuntimeEventStore(service)
|
|
571
|
+
|
|
572
|
+
async def append_one(self, event: Any) -> Any:
|
|
573
|
+
existing = await self._service.get_session(event.session_id)
|
|
574
|
+
if existing is None:
|
|
575
|
+
await self._service.create_session(
|
|
576
|
+
event.agent_id,
|
|
577
|
+
event.user_id,
|
|
578
|
+
event.session_id,
|
|
579
|
+
)
|
|
580
|
+
return await self._store.append_one(event)
|
|
581
|
+
|
|
582
|
+
async def reserve_once(self, event: Any) -> Any:
|
|
583
|
+
existing = await self._service.get_session(event.session_id)
|
|
584
|
+
if existing is None:
|
|
585
|
+
await self._service.create_session(
|
|
586
|
+
event.agent_id,
|
|
587
|
+
event.user_id,
|
|
588
|
+
event.session_id,
|
|
589
|
+
)
|
|
590
|
+
return await self._store.reserve_once(event)
|
|
591
|
+
|
|
592
|
+
async def list(self, session_id: str, **kwargs: Any) -> Any:
|
|
593
|
+
return await self._store.list(session_id, **kwargs)
|
|
594
|
+
|
|
595
|
+
agent = add_ksadk_agui_endpoint(
|
|
596
|
+
app,
|
|
597
|
+
state.executor,
|
|
598
|
+
state.launch_context,
|
|
599
|
+
agui_cfg,
|
|
600
|
+
event_store_factory=lambda: _AutoSessionRuntimeEventStore(
|
|
601
|
+
route_dependencies.resolve_session_service()
|
|
602
|
+
),
|
|
603
|
+
session_service_factory=route_dependencies.resolve_session_service,
|
|
604
|
+
)
|
|
605
|
+
state.agui_agent = agent
|
|
606
|
+
state.agui_config = agui_cfg
|
|
607
|
+
logger.info("AG-UI endpoint mounted at %s", agui_cfg.path)
|
|
608
|
+
|
|
609
|
+
|
|
610
|
+
__all__ = [
|
|
611
|
+
"ALL_GROUPS",
|
|
612
|
+
"CONTROL_PLANE_GROUPS",
|
|
613
|
+
"DATA_PLANE_GROUPS",
|
|
614
|
+
"RuntimeAppConfig",
|
|
615
|
+
"RuntimeAppState",
|
|
616
|
+
"bind_runtime_state",
|
|
617
|
+
"StreamRegistry",
|
|
618
|
+
"create_runtime_app",
|
|
619
|
+
"get_runtime_execution",
|
|
620
|
+
"get_state",
|
|
621
|
+
"set_fallback_state",
|
|
622
|
+
]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Domain routers used by the runtime app composition root."""
|