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,251 @@
|
|
|
1
|
+
"""RuntimeAdapter 的统一生命周期路由与 Handle 所有权。"""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from contextlib import suppress
|
|
6
|
+
from dataclasses import dataclass
|
|
7
|
+
|
|
8
|
+
from ksadk.runtime.adapter import (
|
|
9
|
+
CancelResult,
|
|
10
|
+
CheckpointDescriptor,
|
|
11
|
+
PauseResult,
|
|
12
|
+
ResumePayload,
|
|
13
|
+
ResumeTarget,
|
|
14
|
+
RunHandle,
|
|
15
|
+
RuntimeAdapter,
|
|
16
|
+
RuntimeRegistry,
|
|
17
|
+
StartRequest,
|
|
18
|
+
)
|
|
19
|
+
from ksadk.runtime.launch import RuntimeLaunchContext
|
|
20
|
+
|
|
21
|
+
_HandleKey = tuple[str, str, str]
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
@dataclass
|
|
25
|
+
class _OwnedRun:
|
|
26
|
+
adapter: RuntimeAdapter
|
|
27
|
+
handle: RunHandle
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
@dataclass
|
|
31
|
+
class RuntimeStartPreparation:
|
|
32
|
+
"""One adapter instance preflighted for exactly one subsequent start."""
|
|
33
|
+
|
|
34
|
+
context: RuntimeLaunchContext
|
|
35
|
+
adapter: RuntimeAdapter
|
|
36
|
+
consumed: bool = False
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
class RuntimeExecutor:
|
|
40
|
+
"""让每个 Handle 始终回到创建或恢复它的 Adapter 实例。"""
|
|
41
|
+
|
|
42
|
+
def __init__(self, registry: RuntimeRegistry) -> None:
|
|
43
|
+
self._registry = registry
|
|
44
|
+
self._runs: dict[_HandleKey, _OwnedRun] = {}
|
|
45
|
+
|
|
46
|
+
async def prepare_start(self, context: RuntimeLaunchContext) -> RuntimeStartPreparation:
|
|
47
|
+
"""Preflight a fresh adapter and retain it for the matching ``start``.
|
|
48
|
+
|
|
49
|
+
A response streaming endpoint must learn about lazy import/configuration
|
|
50
|
+
failures before its SSE headers are committed. Retaining the instance
|
|
51
|
+
matters: creating a second adapter after preflight could execute user
|
|
52
|
+
agent initialization twice.
|
|
53
|
+
"""
|
|
54
|
+
|
|
55
|
+
adapter = self._registry.create(context)
|
|
56
|
+
await adapter.preflight()
|
|
57
|
+
return RuntimeStartPreparation(context=context, adapter=adapter)
|
|
58
|
+
|
|
59
|
+
async def start(
|
|
60
|
+
self,
|
|
61
|
+
context: RuntimeLaunchContext,
|
|
62
|
+
request: StartRequest,
|
|
63
|
+
*,
|
|
64
|
+
preparation: RuntimeStartPreparation | None = None,
|
|
65
|
+
) -> RunHandle:
|
|
66
|
+
adapter = self._take_prepared_adapter(context, preparation)
|
|
67
|
+
handle = await adapter.start(request)
|
|
68
|
+
expected_type = _normalize_runtime_type(context.runtime_type)
|
|
69
|
+
if _normalize_runtime_type(handle.runtime_type) != expected_type:
|
|
70
|
+
with suppress(Exception):
|
|
71
|
+
await adapter.close(handle)
|
|
72
|
+
raise ValueError(
|
|
73
|
+
"adapter returned a handle with the wrong runtime type: "
|
|
74
|
+
f"expected {expected_type!r}, got {handle.runtime_type!r}"
|
|
75
|
+
)
|
|
76
|
+
if handle.session_id != request.session_id:
|
|
77
|
+
with suppress(Exception):
|
|
78
|
+
await adapter.close(handle)
|
|
79
|
+
raise ValueError(
|
|
80
|
+
"adapter returned a handle for the wrong session: "
|
|
81
|
+
f"expected {request.session_id!r}, got {handle.session_id!r}"
|
|
82
|
+
)
|
|
83
|
+
if _handle_key(handle) in self._runs:
|
|
84
|
+
with suppress(Exception):
|
|
85
|
+
await adapter.close(handle)
|
|
86
|
+
raise RuntimeError(f"runtime handle is already attached: {_handle_key(handle)!r}")
|
|
87
|
+
self._record_owner(adapter, handle)
|
|
88
|
+
return handle
|
|
89
|
+
|
|
90
|
+
def stream(self, handle: RunHandle):
|
|
91
|
+
owned = self._resolve(handle)
|
|
92
|
+
return owned.adapter.stream(owned.handle)
|
|
93
|
+
|
|
94
|
+
async def cancel(self, handle: RunHandle) -> CancelResult:
|
|
95
|
+
owned = self._resolve(handle)
|
|
96
|
+
return await owned.adapter.cancel(owned.handle)
|
|
97
|
+
|
|
98
|
+
async def pause(self, handle: RunHandle) -> PauseResult:
|
|
99
|
+
owned = self._resolve(handle)
|
|
100
|
+
return await owned.adapter.pause(owned.handle)
|
|
101
|
+
|
|
102
|
+
async def submit(self, handle: RunHandle, payload: ResumePayload) -> None:
|
|
103
|
+
owned = self._resolve(handle)
|
|
104
|
+
await owned.adapter.submit(owned.handle, payload)
|
|
105
|
+
|
|
106
|
+
async def resume(
|
|
107
|
+
self,
|
|
108
|
+
handle: RunHandle,
|
|
109
|
+
target: ResumeTarget,
|
|
110
|
+
payload: ResumePayload | None,
|
|
111
|
+
) -> RunHandle:
|
|
112
|
+
old_key = _handle_key(handle)
|
|
113
|
+
owned = self._resolve(handle)
|
|
114
|
+
resumed = await owned.adapter.resume(owned.handle, target, payload)
|
|
115
|
+
if _normalize_runtime_type(resumed.runtime_type) != old_key[0]:
|
|
116
|
+
raise ValueError("resumed handle changed runtime type")
|
|
117
|
+
if resumed.session_id != old_key[2]:
|
|
118
|
+
raise ValueError("resumed handle changed session")
|
|
119
|
+
|
|
120
|
+
new_key = _handle_key(resumed)
|
|
121
|
+
if new_key != old_key:
|
|
122
|
+
existing = self._runs.get(new_key)
|
|
123
|
+
if existing is not None and existing.adapter is not owned.adapter:
|
|
124
|
+
raise RuntimeError(f"runtime handle is already attached: {new_key!r}")
|
|
125
|
+
self._runs.pop(old_key, None)
|
|
126
|
+
self._runs[new_key] = _OwnedRun(adapter=owned.adapter, handle=resumed)
|
|
127
|
+
return resumed
|
|
128
|
+
|
|
129
|
+
async def checkpoint(self, handle: RunHandle) -> CheckpointDescriptor:
|
|
130
|
+
owned = self._resolve(handle)
|
|
131
|
+
return await owned.adapter.checkpoint(owned.handle)
|
|
132
|
+
|
|
133
|
+
async def close(self, handle: RunHandle) -> None:
|
|
134
|
+
key = _handle_key(handle)
|
|
135
|
+
owned = self._resolve(handle)
|
|
136
|
+
try:
|
|
137
|
+
await owned.adapter.close(owned.handle)
|
|
138
|
+
finally:
|
|
139
|
+
self._runs.pop(key, None)
|
|
140
|
+
|
|
141
|
+
async def close_all(self) -> None:
|
|
142
|
+
"""Release every attached adapter while preserving best-effort cleanup."""
|
|
143
|
+
|
|
144
|
+
first_error: BaseException | None = None
|
|
145
|
+
for key, owned in list(self._runs.items()):
|
|
146
|
+
try:
|
|
147
|
+
await owned.adapter.close(owned.handle)
|
|
148
|
+
except BaseException as exc: # cleanup must continue for the other runtimes
|
|
149
|
+
if first_error is None:
|
|
150
|
+
first_error = exc
|
|
151
|
+
finally:
|
|
152
|
+
self._runs.pop(key, None)
|
|
153
|
+
if first_error is not None:
|
|
154
|
+
raise first_error
|
|
155
|
+
|
|
156
|
+
async def attach(
|
|
157
|
+
self,
|
|
158
|
+
context: RuntimeLaunchContext,
|
|
159
|
+
handle: RunHandle,
|
|
160
|
+
) -> RunHandle:
|
|
161
|
+
expected_type = _normalize_runtime_type(context.runtime_type)
|
|
162
|
+
if _normalize_runtime_type(handle.runtime_type) != expected_type:
|
|
163
|
+
raise ValueError("launch context and persisted handle runtime type differ")
|
|
164
|
+
if self.is_attached(handle):
|
|
165
|
+
return handle
|
|
166
|
+
|
|
167
|
+
adapter = self._registry.create(context)
|
|
168
|
+
restored = await adapter.attach(handle)
|
|
169
|
+
if restored != handle:
|
|
170
|
+
with suppress(Exception):
|
|
171
|
+
await adapter.close(restored)
|
|
172
|
+
raise ValueError("adapter attach must preserve persisted handle identity")
|
|
173
|
+
self._record_owner(adapter, restored)
|
|
174
|
+
return restored
|
|
175
|
+
|
|
176
|
+
def is_attached(self, handle: RunHandle) -> bool:
|
|
177
|
+
owned = self._runs.get(_handle_key(handle))
|
|
178
|
+
return owned is not None and owned.handle == handle
|
|
179
|
+
|
|
180
|
+
def find_handle(
|
|
181
|
+
self,
|
|
182
|
+
runtime_type: str,
|
|
183
|
+
run_id: str,
|
|
184
|
+
session_id: str,
|
|
185
|
+
) -> RunHandle | None:
|
|
186
|
+
"""Return the attached handle for one exact runtime/run/session scope."""
|
|
187
|
+
|
|
188
|
+
owned = self._runs.get(
|
|
189
|
+
(
|
|
190
|
+
_normalize_runtime_type(runtime_type),
|
|
191
|
+
str(run_id),
|
|
192
|
+
str(session_id),
|
|
193
|
+
)
|
|
194
|
+
)
|
|
195
|
+
return owned.handle if owned is not None else None
|
|
196
|
+
|
|
197
|
+
def native_capabilities(self, context: RuntimeLaunchContext) -> dict[str, object]:
|
|
198
|
+
"""Read the capability declaration from the registered Runtime implementation."""
|
|
199
|
+
|
|
200
|
+
adapter = self._registry.create(context)
|
|
201
|
+
return dict(adapter.runtime.native_capabilities())
|
|
202
|
+
|
|
203
|
+
def registered_runtime_types(self) -> list[str]:
|
|
204
|
+
"""Expose Registry membership without leaking or duplicating the Registry."""
|
|
205
|
+
|
|
206
|
+
return self._registry.registered_types()
|
|
207
|
+
|
|
208
|
+
def _resolve(self, handle: RunHandle) -> _OwnedRun:
|
|
209
|
+
key = _handle_key(handle)
|
|
210
|
+
try:
|
|
211
|
+
owned = self._runs[key]
|
|
212
|
+
except KeyError:
|
|
213
|
+
raise KeyError(f"runtime handle is not attached: {key!r}") from None
|
|
214
|
+
if owned.handle != handle:
|
|
215
|
+
raise ValueError(f"runtime handle payload does not match owner: {key!r}")
|
|
216
|
+
return owned
|
|
217
|
+
|
|
218
|
+
def _record_owner(self, adapter: RuntimeAdapter, handle: RunHandle) -> None:
|
|
219
|
+
key = _handle_key(handle)
|
|
220
|
+
if key in self._runs:
|
|
221
|
+
raise RuntimeError(f"runtime handle is already attached: {key!r}")
|
|
222
|
+
self._runs[key] = _OwnedRun(adapter=adapter, handle=handle)
|
|
223
|
+
|
|
224
|
+
def _take_prepared_adapter(
|
|
225
|
+
self,
|
|
226
|
+
context: RuntimeLaunchContext,
|
|
227
|
+
preparation: RuntimeStartPreparation | None,
|
|
228
|
+
) -> RuntimeAdapter:
|
|
229
|
+
if preparation is None:
|
|
230
|
+
return self._registry.create(context)
|
|
231
|
+
if preparation.consumed:
|
|
232
|
+
raise RuntimeError("runtime start preparation was already consumed")
|
|
233
|
+
if preparation.context != context:
|
|
234
|
+
raise ValueError("runtime start preparation does not match launch context")
|
|
235
|
+
preparation.consumed = True
|
|
236
|
+
return preparation.adapter
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
def _normalize_runtime_type(runtime_type: str) -> str:
|
|
240
|
+
return runtime_type.strip().lower()
|
|
241
|
+
|
|
242
|
+
|
|
243
|
+
def _handle_key(handle: RunHandle) -> _HandleKey:
|
|
244
|
+
return (
|
|
245
|
+
_normalize_runtime_type(handle.runtime_type),
|
|
246
|
+
handle.run_id,
|
|
247
|
+
handle.session_id,
|
|
248
|
+
)
|
|
249
|
+
|
|
250
|
+
|
|
251
|
+
__all__ = ["RuntimeExecutor", "RuntimeStartPreparation"]
|
ksadk/runtime/factory.py
ADDED
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
"""内置 RuntimeAdapter 的唯一默认 Factory Registry。"""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import dataclasses
|
|
6
|
+
import os
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
from typing import Any
|
|
9
|
+
|
|
10
|
+
from ksadk.codex.client import AsyncCodexClient
|
|
11
|
+
from ksadk.codex.runtime import CodexRuntimeAdapter
|
|
12
|
+
from ksadk.runners.base_runner import BaseRunner
|
|
13
|
+
from ksadk.runtime.adapter import RuntimeAdapter, RuntimeRegistry
|
|
14
|
+
from ksadk.runtime.framework_adapters import ADKRuntimeAdapter, LangGraphRuntimeAdapter
|
|
15
|
+
from ksadk.runtime.launch import RuntimeLaunchContext
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
def _create_codex(context: RuntimeLaunchContext) -> RuntimeAdapter:
|
|
19
|
+
client_factory = context.services.codex_client_factory or AsyncCodexClient
|
|
20
|
+
overrides = list(context.config.get("codex_overrides") or [])
|
|
21
|
+
# Studio's default collaboration mode must expose Codex's structured
|
|
22
|
+
# request_user_input tool; the upstream feature is intentionally off by
|
|
23
|
+
# default outside Plan mode. This stays process-local to the isolated
|
|
24
|
+
# runtime and does not mutate the user's global Codex configuration.
|
|
25
|
+
interaction_override = "features.default_mode_request_user_input=true"
|
|
26
|
+
if interaction_override not in overrides:
|
|
27
|
+
overrides.append(interaction_override)
|
|
28
|
+
try:
|
|
29
|
+
from openai_codex import CodexConfig
|
|
30
|
+
|
|
31
|
+
base_cfg = CodexConfig()
|
|
32
|
+
if overrides:
|
|
33
|
+
base_cfg = dataclasses.replace(
|
|
34
|
+
base_cfg,
|
|
35
|
+
config_overrides=tuple(getattr(base_cfg, "config_overrides", ()) or ())
|
|
36
|
+
+ tuple(str(o) for o in overrides),
|
|
37
|
+
)
|
|
38
|
+
env = dict(getattr(base_cfg, "env", None) or {})
|
|
39
|
+
isolated_home = _isolated_codex_home(context.project_dir)
|
|
40
|
+
env.setdefault("CODEX_HOME", str(isolated_home))
|
|
41
|
+
# HOME 级隔离:codex app-server 还会按约定扫 ~/.agents/skills、
|
|
42
|
+
# ~/.claude/skills 等宿主目录,仅设 CODEX_HOME 挡不住。隔离 HOME 后这些
|
|
43
|
+
# 路径全部落在工作区内,宿主 skills/MCP/凭证不再进入 Agent 上下文。
|
|
44
|
+
# 设 KSADK_CODEX_ISOLATE_HOME=0 可关闭(调试用)。
|
|
45
|
+
if os.environ.get("KSADK_CODEX_ISOLATE_HOME", "1") != "0":
|
|
46
|
+
env.setdefault("HOME", str(isolated_home))
|
|
47
|
+
# 运行期解析出的凭证值(如 MCP bearer_token_env_var 所需)注入子进程环境
|
|
48
|
+
env.update({str(k): str(v) for k, v in (context.config.get("env") or {}).items()})
|
|
49
|
+
base_cfg = dataclasses.replace(base_cfg, env=env)
|
|
50
|
+
try:
|
|
51
|
+
client: Any = client_factory(config=base_cfg)
|
|
52
|
+
except TypeError:
|
|
53
|
+
# 自定义/测试工厂可能不接受 config 参数:退化为无参构造,
|
|
54
|
+
# config_overrides 事后注入(自定义工厂自行承担 env 隔离)。
|
|
55
|
+
client = client_factory()
|
|
56
|
+
if overrides:
|
|
57
|
+
_apply_codex_overrides(client, overrides)
|
|
58
|
+
except ImportError:
|
|
59
|
+
client: Any = client_factory()
|
|
60
|
+
if overrides:
|
|
61
|
+
_apply_codex_overrides(client, overrides)
|
|
62
|
+
timeout = context.config.get("turn_timeout_seconds")
|
|
63
|
+
return CodexRuntimeAdapter(
|
|
64
|
+
client,
|
|
65
|
+
sandbox_read_only=bool(context.config.get("sandbox_read_only", True)),
|
|
66
|
+
turn_timeout_seconds=float(timeout) if timeout is not None else None,
|
|
67
|
+
)
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def _isolated_codex_home(project_dir: Any) -> Path:
|
|
71
|
+
"""Studio 运行 Agent 使用工作区级隔离 CODEX_HOME。
|
|
72
|
+
|
|
73
|
+
避免 codex app-server 继承宿主环境(~/.codex / ~/.wework/codex)里的
|
|
74
|
+
skills、MCP 配置、插件与凭证,污染 Agent 上下文甚至泄漏宿主能力。
|
|
75
|
+
可用 KSADK_CODEX_HOME 显式覆盖。
|
|
76
|
+
"""
|
|
77
|
+
override = os.environ.get("KSADK_CODEX_HOME")
|
|
78
|
+
if override:
|
|
79
|
+
return Path(override).expanduser()
|
|
80
|
+
home = Path(str(project_dir)) / ".agentkit" / "codex-home"
|
|
81
|
+
home.mkdir(parents=True, exist_ok=True)
|
|
82
|
+
return home
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
def _apply_codex_overrides(client: Any, overrides: Any) -> None:
|
|
86
|
+
"""Append MCP server --config overrides to the client's CodexConfig."""
|
|
87
|
+
try:
|
|
88
|
+
from openai_codex import CodexConfig
|
|
89
|
+
except ImportError:
|
|
90
|
+
return
|
|
91
|
+
# ksadk AsyncCodexClient -> AsyncCodex -> inner AsyncCodexClient.config
|
|
92
|
+
inner_codex = getattr(client, "_codex", None)
|
|
93
|
+
inner_client = getattr(inner_codex, "_client", None) or inner_codex
|
|
94
|
+
cfg = getattr(inner_client, "config", None)
|
|
95
|
+
if cfg is None or not isinstance(cfg, CodexConfig):
|
|
96
|
+
return
|
|
97
|
+
base_overrides = tuple(getattr(cfg, "config_overrides", ()) or ())
|
|
98
|
+
new_overrides = tuple(str(o) for o in overrides if o not in base_overrides)
|
|
99
|
+
if not new_overrides:
|
|
100
|
+
return
|
|
101
|
+
new_cfg = dataclasses.replace(cfg, config_overrides=base_overrides + new_overrides)
|
|
102
|
+
setattr(inner_client, "config", new_cfg)
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
def _create_framework_runner(context: RuntimeLaunchContext, runtime_type: str) -> BaseRunner:
|
|
106
|
+
try:
|
|
107
|
+
from ksadk.runners.patch_langchain import apply_patch
|
|
108
|
+
|
|
109
|
+
apply_patch()
|
|
110
|
+
except ImportError:
|
|
111
|
+
pass
|
|
112
|
+
detection = context.detection
|
|
113
|
+
if detection is None:
|
|
114
|
+
raise ValueError(f"{runtime_type} runtime requires framework detection")
|
|
115
|
+
if context.services.runner_factory is not None:
|
|
116
|
+
runner = context.services.runner_factory(detection, str(context.project_dir))
|
|
117
|
+
else:
|
|
118
|
+
# 复用 runners.factory.create_runner:它优先读 detection.runner_class
|
|
119
|
+
# (agentengine.yaml 的 runner_class 字段),否则按 detection.type 分发到
|
|
120
|
+
# ADKRunner/LangGraphRunner 等。直接硬编码 LangGraphRunner 会绕过自定义
|
|
121
|
+
# runner,导致 root_agent=None 的项目在 preflight 阶段误报"不是有效 CompiledGraph"。
|
|
122
|
+
from ksadk.runners.factory import create_runner
|
|
123
|
+
|
|
124
|
+
runner = create_runner(detection, str(context.project_dir))
|
|
125
|
+
if not isinstance(runner, BaseRunner):
|
|
126
|
+
raise TypeError(
|
|
127
|
+
f"{runtime_type} runner factory must return BaseRunner, got {type(runner).__name__}"
|
|
128
|
+
)
|
|
129
|
+
return runner
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
def _create_adk(context: RuntimeLaunchContext) -> RuntimeAdapter:
|
|
133
|
+
return ADKRuntimeAdapter(_create_framework_runner(context, "adk"))
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
def _create_langgraph(context: RuntimeLaunchContext) -> RuntimeAdapter:
|
|
137
|
+
return LangGraphRuntimeAdapter(_create_framework_runner(context, "langgraph"))
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
def build_default_runtime_registry() -> RuntimeRegistry:
|
|
141
|
+
"""注册内置 Codex、ADK 和 LangGraph Runtime Factory。"""
|
|
142
|
+
|
|
143
|
+
registry = RuntimeRegistry()
|
|
144
|
+
registry.register("codex", _create_codex)
|
|
145
|
+
registry.register("adk", _create_adk)
|
|
146
|
+
registry.register("langgraph", _create_langgraph)
|
|
147
|
+
return registry
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
def create_runtime_adapter(context: RuntimeLaunchContext) -> RuntimeAdapter:
|
|
151
|
+
"""通过唯一默认 Registry 创建 RuntimeAdapter。"""
|
|
152
|
+
|
|
153
|
+
return build_default_runtime_registry().create(context)
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
__all__ = ["build_default_runtime_registry", "create_runtime_adapter"]
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
"""ADK / LangGraph 两个框架的 RuntimeAdapter (goal-07)。
|
|
2
|
+
|
|
3
|
+
在通用 :class:`~ksadk.runtime.runner_adapter.RunnerRuntimeAdapter` 之上,只声明
|
|
4
|
+
框架差异(resume 目标 + checkpoint 粒度),诚实暴露,不开接口后门:
|
|
5
|
+
|
|
6
|
+
- ADK:**forward-only**,resume 经 ``invocation_id``;不支持 time-travel/fork。
|
|
7
|
+
- LangGraph:**time-travel**,resume 经 ``checkpoint_id``;可按 turn 回滚/fork。
|
|
8
|
+
|
|
9
|
+
默认注册由 :mod:`ksadk.runtime.factory` 统一负责。
|
|
10
|
+
"""
|
|
11
|
+
|
|
12
|
+
from __future__ import annotations
|
|
13
|
+
|
|
14
|
+
from typing import Optional
|
|
15
|
+
|
|
16
|
+
from ksadk.runners.base_runner import BaseRunner
|
|
17
|
+
from ksadk.runtime.adapter import (
|
|
18
|
+
CheckpointCapability,
|
|
19
|
+
ResumePayload,
|
|
20
|
+
ResumeTarget,
|
|
21
|
+
RunHandle,
|
|
22
|
+
)
|
|
23
|
+
from ksadk.runtime.runner_adapter import RunnerRuntimeAdapter
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
class ADKRuntimeAdapter(RunnerRuntimeAdapter):
|
|
27
|
+
"""ADK 框架 adapter(forward-only resume)。"""
|
|
28
|
+
|
|
29
|
+
def __init__(self, runner: BaseRunner) -> None:
|
|
30
|
+
super().__init__(runner, runtime_type="adk")
|
|
31
|
+
|
|
32
|
+
async def _resume_native(
|
|
33
|
+
self,
|
|
34
|
+
handle: RunHandle,
|
|
35
|
+
target: ResumeTarget,
|
|
36
|
+
payload: Optional[ResumePayload],
|
|
37
|
+
) -> Optional[dict]:
|
|
38
|
+
# ADK forward-only:恢复目标 = invocation_id。注入 adk_runner 真消费的
|
|
39
|
+
# ``checkpoint_resume`` + ``framework_ref.adk.invocation_id`` → run_async(invocation_id)。
|
|
40
|
+
return {
|
|
41
|
+
"checkpoint_resume": True,
|
|
42
|
+
"run_id": target.id,
|
|
43
|
+
"framework_ref": {"adk": {"invocation_id": target.id}},
|
|
44
|
+
"input": payload.data if payload else None,
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
def _checkpoint_capability(self) -> CheckpointCapability:
|
|
48
|
+
capability = super()._checkpoint_capability()
|
|
49
|
+
if not capability.supported:
|
|
50
|
+
return capability
|
|
51
|
+
return capability.model_copy(
|
|
52
|
+
update={
|
|
53
|
+
"granularity": "delta",
|
|
54
|
+
"rollback_scope": "invocation",
|
|
55
|
+
"fork_supported": False,
|
|
56
|
+
}
|
|
57
|
+
)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
class LangGraphRuntimeAdapter(RunnerRuntimeAdapter):
|
|
61
|
+
"""LangGraph 框架 adapter(time-travel resume)。"""
|
|
62
|
+
|
|
63
|
+
def __init__(self, runner: BaseRunner) -> None:
|
|
64
|
+
super().__init__(runner, runtime_type="langgraph")
|
|
65
|
+
|
|
66
|
+
async def _resume_native(
|
|
67
|
+
self,
|
|
68
|
+
handle: RunHandle,
|
|
69
|
+
target: ResumeTarget,
|
|
70
|
+
payload: Optional[ResumePayload],
|
|
71
|
+
) -> Optional[dict]:
|
|
72
|
+
if target.kind != "checkpoint_id":
|
|
73
|
+
raise ValueError(f"LangGraph resume requires checkpoint_id target, got {target.kind!r}")
|
|
74
|
+
known_checkpoint_ids = {
|
|
75
|
+
str(checkpoint_id)
|
|
76
|
+
for checkpoint_id in handle.native_ref.get("known_checkpoint_ids", [])
|
|
77
|
+
}
|
|
78
|
+
if target.id not in known_checkpoint_ids:
|
|
79
|
+
raise ValueError(f"checkpoint {target.id!r} does not belong to run {handle.run_id!r}")
|
|
80
|
+
if payload is not None and payload.call_id:
|
|
81
|
+
pending_approval_ids = {
|
|
82
|
+
str(call_id) for call_id in handle.native_ref.get("pending_approval_ids", [])
|
|
83
|
+
}
|
|
84
|
+
if payload.call_id not in pending_approval_ids:
|
|
85
|
+
raise ValueError(f"unknown interrupt {payload.call_id!r}")
|
|
86
|
+
# LangGraph time-travel:恢复目标 = checkpoint_id。注入 langgraph_runner 真消费的
|
|
87
|
+
# ``checkpoint_resume`` + ``framework_ref.langgraph.{checkpoint_id,thread_id}``。
|
|
88
|
+
return {
|
|
89
|
+
"checkpoint_resume": True,
|
|
90
|
+
"run_id": handle.run_id,
|
|
91
|
+
"resume_payload_provided": payload is not None,
|
|
92
|
+
"resume_interrupt_id": payload.call_id if payload else None,
|
|
93
|
+
"framework_ref": {
|
|
94
|
+
"langgraph": {
|
|
95
|
+
"checkpoint_id": target.id,
|
|
96
|
+
"thread_id": str(handle.native_ref.get("thread_id") or handle.session_id),
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
"input": payload.data if payload else None,
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
def _checkpoint_capability(self) -> CheckpointCapability:
|
|
103
|
+
capability = super()._checkpoint_capability()
|
|
104
|
+
if not capability.supported:
|
|
105
|
+
return capability
|
|
106
|
+
return capability.model_copy(
|
|
107
|
+
update={
|
|
108
|
+
"granularity": "snapshot",
|
|
109
|
+
"rollback_scope": "turn",
|
|
110
|
+
"fork_supported": True,
|
|
111
|
+
}
|
|
112
|
+
)
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
__all__ = [
|
|
116
|
+
"ADKRuntimeAdapter",
|
|
117
|
+
"LangGraphRuntimeAdapter",
|
|
118
|
+
]
|
ksadk/runtime/launch.py
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
"""RuntimeAdapter Factory 的启动上下文与可注入依赖。"""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from collections.abc import Callable, Mapping
|
|
6
|
+
from dataclasses import dataclass, field
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
from types import MappingProxyType
|
|
9
|
+
from typing import Any
|
|
10
|
+
|
|
11
|
+
_RUNTIME_TYPE_ALIASES = {
|
|
12
|
+
# LangChain and DeepAgents are source-framework variants. They share the
|
|
13
|
+
# LangGraph execution/checkpoint contract and must not create new top-level
|
|
14
|
+
# runtime types in the RuntimeAdapter registry.
|
|
15
|
+
"langchain": "langgraph",
|
|
16
|
+
"deepagents": "langgraph",
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
@dataclass(frozen=True)
|
|
21
|
+
class RuntimeServices:
|
|
22
|
+
"""创建 RuntimeAdapter 时可替换的进程级依赖。"""
|
|
23
|
+
|
|
24
|
+
codex_client_factory: Callable[[], Any] | None = None
|
|
25
|
+
runner_factory: Callable[[Any, str], Any] | None = None
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
@dataclass(frozen=True)
|
|
29
|
+
class RuntimeLaunchContext:
|
|
30
|
+
"""一次 RuntimeAdapter 创建所需的框架无关输入。"""
|
|
31
|
+
|
|
32
|
+
runtime_type: str
|
|
33
|
+
project_dir: Path
|
|
34
|
+
detection: Any | None = None
|
|
35
|
+
config: Mapping[str, Any] = field(default_factory=dict)
|
|
36
|
+
services: RuntimeServices = field(default_factory=RuntimeServices)
|
|
37
|
+
|
|
38
|
+
def __post_init__(self) -> None:
|
|
39
|
+
runtime_type = str(self.runtime_type or "").strip().lower()
|
|
40
|
+
canonical_runtime_type = _RUNTIME_TYPE_ALIASES.get(
|
|
41
|
+
runtime_type, runtime_type
|
|
42
|
+
)
|
|
43
|
+
object.__setattr__(self, "runtime_type", canonical_runtime_type)
|
|
44
|
+
object.__setattr__(self, "project_dir", Path(self.project_dir))
|
|
45
|
+
object.__setattr__(self, "config", MappingProxyType(dict(self.config)))
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
__all__ = ["RuntimeLaunchContext", "RuntimeServices"]
|