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,324 @@
|
|
|
1
|
+
"""Codex Studio 的本地 ManagedRuntime 审计构建。"""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import json
|
|
6
|
+
import os
|
|
7
|
+
import shutil
|
|
8
|
+
from datetime import datetime, timezone
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
from typing import Any, Callable, Literal, cast
|
|
11
|
+
|
|
12
|
+
from pydantic import ValidationError
|
|
13
|
+
|
|
14
|
+
from ksadk.builders.managed_runtime_builder import ManagedRuntimeBuilder
|
|
15
|
+
from ksadk.managed_runtime import (
|
|
16
|
+
ResolvedRuntime,
|
|
17
|
+
validate_installed_runtime,
|
|
18
|
+
validate_runtime_binary,
|
|
19
|
+
)
|
|
20
|
+
from ksadk.studio.codex_manifest import CodexManifestRepository
|
|
21
|
+
from ksadk.studio.contracts import ContractModel, ModelSpec
|
|
22
|
+
from ksadk.studio.errors import StudioError, not_found
|
|
23
|
+
from ksadk.studio.workspace import Workspace
|
|
24
|
+
from ksadk.version import VERSION as SDK_VERSION
|
|
25
|
+
|
|
26
|
+
RuntimeInspector = Callable[[ResolvedRuntime], tuple[str, str, str]]
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
class CodexBuildRecord(ContractModel):
|
|
30
|
+
id: str
|
|
31
|
+
status: Literal["SUCCEEDED"] = "SUCCEEDED"
|
|
32
|
+
agent_name: str
|
|
33
|
+
agent_version: str
|
|
34
|
+
source_revision: int = 1
|
|
35
|
+
artifact_path: str
|
|
36
|
+
manifest_sha256: str
|
|
37
|
+
runtime_name: Literal["codex"] = "codex"
|
|
38
|
+
runtime_version: str
|
|
39
|
+
sdk_version: str
|
|
40
|
+
cli_version: str
|
|
41
|
+
proxy_mode: Literal["forced", "auto", "direct"]
|
|
42
|
+
runtime_lock: dict
|
|
43
|
+
# ``None`` identifies legacy records that predate connection snapshots.
|
|
44
|
+
# New builds always persist a mapping (possibly empty), so run resolution
|
|
45
|
+
# never consults mutable Catalog state after the build has been created.
|
|
46
|
+
model_profiles: dict[str, dict[str, Any]] | None = None
|
|
47
|
+
created_at: datetime
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
class CodexBuildRepository:
|
|
51
|
+
def __init__(self, workspace: Workspace) -> None:
|
|
52
|
+
self.workspace = workspace
|
|
53
|
+
|
|
54
|
+
def _path(self, build_id: str) -> Path:
|
|
55
|
+
return self.workspace.resolve(Path(".agentkit/codex-builds") / f"{build_id}.json")
|
|
56
|
+
|
|
57
|
+
def save(self, record: CodexBuildRecord) -> CodexBuildRecord:
|
|
58
|
+
payload = record.model_dump(
|
|
59
|
+
by_alias=True,
|
|
60
|
+
exclude_none=True,
|
|
61
|
+
mode="json",
|
|
62
|
+
)
|
|
63
|
+
self.workspace.atomic_write_text(
|
|
64
|
+
self._path(record.id),
|
|
65
|
+
json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True) + "\n",
|
|
66
|
+
)
|
|
67
|
+
return record
|
|
68
|
+
|
|
69
|
+
def get(self, build_id: str) -> CodexBuildRecord:
|
|
70
|
+
path = self._path(build_id)
|
|
71
|
+
if not path.is_file():
|
|
72
|
+
raise not_found("codex build", build_id)
|
|
73
|
+
try:
|
|
74
|
+
return cast(
|
|
75
|
+
CodexBuildRecord,
|
|
76
|
+
CodexBuildRecord.model_validate_json(path.read_text(encoding="utf-8")),
|
|
77
|
+
)
|
|
78
|
+
except (OSError, ValidationError) as exc:
|
|
79
|
+
raise StudioError(
|
|
80
|
+
"CODEX_BUILD_RECORD_INVALID",
|
|
81
|
+
"Codex Build 记录损坏",
|
|
82
|
+
status_code=500,
|
|
83
|
+
details={"id": build_id},
|
|
84
|
+
) from exc
|
|
85
|
+
|
|
86
|
+
def list(self) -> list[CodexBuildRecord]:
|
|
87
|
+
directory = self.workspace.resolve(".agentkit/codex-builds")
|
|
88
|
+
records: list[CodexBuildRecord] = []
|
|
89
|
+
for path in directory.glob("build_*.json"):
|
|
90
|
+
try:
|
|
91
|
+
records.append(
|
|
92
|
+
CodexBuildRecord.model_validate_json(path.read_text(encoding="utf-8"))
|
|
93
|
+
)
|
|
94
|
+
except (OSError, ValidationError):
|
|
95
|
+
continue
|
|
96
|
+
return sorted(records, key=lambda item: item.created_at, reverse=True)
|
|
97
|
+
|
|
98
|
+
def delete_for_agent(
|
|
99
|
+
self,
|
|
100
|
+
agent_id: str,
|
|
101
|
+
*,
|
|
102
|
+
purge: bool,
|
|
103
|
+
trash_directory: Path | None = None,
|
|
104
|
+
) -> int:
|
|
105
|
+
records = [item for item in self.list() if item.agent_name == agent_id]
|
|
106
|
+
artifacts = {
|
|
107
|
+
self.workspace.resolve(item.artifact_path) for item in records if item.artifact_path
|
|
108
|
+
}
|
|
109
|
+
for artifact in artifacts:
|
|
110
|
+
self._remove_file(
|
|
111
|
+
artifact,
|
|
112
|
+
purge=purge,
|
|
113
|
+
destination=(
|
|
114
|
+
None
|
|
115
|
+
if trash_directory is None
|
|
116
|
+
else trash_directory / "artifacts" / artifact.name
|
|
117
|
+
),
|
|
118
|
+
)
|
|
119
|
+
for record in records:
|
|
120
|
+
path = self._path(record.id)
|
|
121
|
+
self._remove_file(
|
|
122
|
+
path,
|
|
123
|
+
purge=purge,
|
|
124
|
+
destination=(
|
|
125
|
+
None if trash_directory is None else trash_directory / "builds" / path.name
|
|
126
|
+
),
|
|
127
|
+
)
|
|
128
|
+
return len(records)
|
|
129
|
+
|
|
130
|
+
def _remove_file(
|
|
131
|
+
self,
|
|
132
|
+
source: Path,
|
|
133
|
+
*,
|
|
134
|
+
purge: bool,
|
|
135
|
+
destination: Path | None,
|
|
136
|
+
) -> None:
|
|
137
|
+
if not source.is_file():
|
|
138
|
+
return
|
|
139
|
+
if purge:
|
|
140
|
+
source.unlink()
|
|
141
|
+
return
|
|
142
|
+
if destination is None:
|
|
143
|
+
raise ValueError("recoverable deletion requires a trash destination")
|
|
144
|
+
target = self.workspace.resolve(destination)
|
|
145
|
+
target.parent.mkdir(parents=True, exist_ok=True)
|
|
146
|
+
shutil.move(str(source), str(target))
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
def current_proxy_mode() -> Literal["forced", "auto", "direct"]:
|
|
150
|
+
override = os.environ.get("KSADK_CODEX_USE_PROXY")
|
|
151
|
+
if override == "1":
|
|
152
|
+
return "forced"
|
|
153
|
+
if override == "0":
|
|
154
|
+
return "direct"
|
|
155
|
+
return "auto"
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
def _inspect_runtime(runtime: ResolvedRuntime) -> tuple[str, str, str]:
|
|
159
|
+
installed = validate_installed_runtime(runtime)
|
|
160
|
+
cli = validate_runtime_binary(runtime)
|
|
161
|
+
return SDK_VERSION, installed, cli
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
class CodexStudioBuilder:
|
|
165
|
+
def __init__(
|
|
166
|
+
self,
|
|
167
|
+
workspace: Workspace,
|
|
168
|
+
*,
|
|
169
|
+
manifest_repository: CodexManifestRepository | None = None,
|
|
170
|
+
build_repository: CodexBuildRepository | None = None,
|
|
171
|
+
runtime_inspector: RuntimeInspector = _inspect_runtime,
|
|
172
|
+
resource_catalog: Any = None,
|
|
173
|
+
draft_repository: Any = None,
|
|
174
|
+
) -> None:
|
|
175
|
+
self.workspace = workspace
|
|
176
|
+
self.manifests = manifest_repository or CodexManifestRepository(workspace)
|
|
177
|
+
self.repository = build_repository or CodexBuildRepository(workspace)
|
|
178
|
+
self.runtime_inspector = runtime_inspector
|
|
179
|
+
self.catalog = resource_catalog
|
|
180
|
+
self.drafts = draft_repository
|
|
181
|
+
|
|
182
|
+
def build(
|
|
183
|
+
self,
|
|
184
|
+
agent_id: str | None = None,
|
|
185
|
+
*,
|
|
186
|
+
source_revision: int = 1,
|
|
187
|
+
) -> CodexBuildRecord:
|
|
188
|
+
snapshot = self.manifests.load(agent_id)
|
|
189
|
+
model_profiles = self._model_profile_snapshot(
|
|
190
|
+
snapshot.manifest.name,
|
|
191
|
+
allowed_models=snapshot.manifest.allowed_models,
|
|
192
|
+
)
|
|
193
|
+
build_id = self._build_id(snapshot.manifest_sha256, model_profiles)
|
|
194
|
+
try:
|
|
195
|
+
existing = self.repository.get(build_id)
|
|
196
|
+
except StudioError as exc:
|
|
197
|
+
if exc.status_code != 404:
|
|
198
|
+
raise
|
|
199
|
+
else:
|
|
200
|
+
return existing
|
|
201
|
+
|
|
202
|
+
runtime = ResolvedRuntime(
|
|
203
|
+
name=snapshot.manifest.runtime.name,
|
|
204
|
+
version=snapshot.manifest.runtime.version,
|
|
205
|
+
source="manifest",
|
|
206
|
+
)
|
|
207
|
+
sdk_version, installed_runtime, cli_version = self.runtime_inspector(runtime)
|
|
208
|
+
if installed_runtime != runtime.version:
|
|
209
|
+
raise StudioError(
|
|
210
|
+
"CODEX_RUNTIME_VERSION_MISMATCH",
|
|
211
|
+
"本地 Codex Runtime 与 agentengine.yaml 锁定版本不一致",
|
|
212
|
+
status_code=422,
|
|
213
|
+
details={"expected": runtime.version, "installed": installed_runtime},
|
|
214
|
+
)
|
|
215
|
+
|
|
216
|
+
result = ManagedRuntimeBuilder(
|
|
217
|
+
self.workspace.root,
|
|
218
|
+
config=snapshot.manifest.model_dump(mode="python", exclude_none=True),
|
|
219
|
+
runtime_version=runtime.version,
|
|
220
|
+
).build()
|
|
221
|
+
if not result.success or result.artifact_path is None:
|
|
222
|
+
raise StudioError(
|
|
223
|
+
"CODEX_BUILD_FAILED",
|
|
224
|
+
result.error_message or "Codex ManagedRuntime 构建失败",
|
|
225
|
+
status_code=422,
|
|
226
|
+
)
|
|
227
|
+
lock = self._runtime_lock(result.artifact_path)
|
|
228
|
+
lock_sha = str(lock.get("manifest_sha256") or "")
|
|
229
|
+
if lock_sha != snapshot.manifest_sha256:
|
|
230
|
+
raise StudioError(
|
|
231
|
+
"CODEX_BUILD_DIGEST_MISMATCH",
|
|
232
|
+
"构建产物与当前 agentengine.yaml 摘要不一致",
|
|
233
|
+
status_code=500,
|
|
234
|
+
)
|
|
235
|
+
record = CodexBuildRecord(
|
|
236
|
+
id=build_id,
|
|
237
|
+
agent_name=snapshot.manifest.name,
|
|
238
|
+
agent_version=snapshot.manifest.version,
|
|
239
|
+
source_revision=source_revision,
|
|
240
|
+
artifact_path=self.workspace.relative(result.artifact_path),
|
|
241
|
+
manifest_sha256=snapshot.manifest_sha256,
|
|
242
|
+
runtime_version=runtime.version,
|
|
243
|
+
sdk_version=sdk_version,
|
|
244
|
+
cli_version=cli_version,
|
|
245
|
+
proxy_mode=current_proxy_mode(),
|
|
246
|
+
runtime_lock=lock,
|
|
247
|
+
model_profiles=model_profiles,
|
|
248
|
+
created_at=datetime.now(timezone.utc),
|
|
249
|
+
)
|
|
250
|
+
return self.repository.save(record)
|
|
251
|
+
|
|
252
|
+
def is_current(self, record: CodexBuildRecord) -> bool:
|
|
253
|
+
snapshot = self.manifests.load(record.agent_name)
|
|
254
|
+
if record.manifest_sha256 != snapshot.manifest_sha256:
|
|
255
|
+
return False
|
|
256
|
+
if record.model_profiles is None:
|
|
257
|
+
return True
|
|
258
|
+
return record.model_profiles == self._model_profile_snapshot(
|
|
259
|
+
snapshot.manifest.name,
|
|
260
|
+
allowed_models=snapshot.manifest.allowed_models,
|
|
261
|
+
)
|
|
262
|
+
|
|
263
|
+
@staticmethod
|
|
264
|
+
def _build_id(
|
|
265
|
+
manifest_sha256: str,
|
|
266
|
+
model_profiles: dict[str, dict[str, Any]],
|
|
267
|
+
) -> str:
|
|
268
|
+
if not model_profiles:
|
|
269
|
+
return f"build_{manifest_sha256[:20]}"
|
|
270
|
+
fingerprint = json.dumps(
|
|
271
|
+
model_profiles,
|
|
272
|
+
ensure_ascii=False,
|
|
273
|
+
sort_keys=True,
|
|
274
|
+
separators=(",", ":"),
|
|
275
|
+
)
|
|
276
|
+
import hashlib
|
|
277
|
+
|
|
278
|
+
digest = hashlib.sha256(f"{manifest_sha256}\n{fingerprint}".encode()).hexdigest()
|
|
279
|
+
return f"build_{digest[:20]}"
|
|
280
|
+
|
|
281
|
+
def _model_profile_snapshot(
|
|
282
|
+
self,
|
|
283
|
+
agent_id: str,
|
|
284
|
+
*,
|
|
285
|
+
allowed_models: tuple[str, ...],
|
|
286
|
+
) -> dict[str, dict[str, Any]]:
|
|
287
|
+
if self.catalog is None or self.drafts is None:
|
|
288
|
+
return {}
|
|
289
|
+
draft = self.drafts.get(agent_id)
|
|
290
|
+
if draft is None:
|
|
291
|
+
return {}
|
|
292
|
+
bindings = draft.spec.bindings
|
|
293
|
+
resource_ids = list(getattr(bindings, "model_profile_ids", []) or [])
|
|
294
|
+
default_id = getattr(bindings, "model_profile_id", None)
|
|
295
|
+
if not resource_ids and default_id:
|
|
296
|
+
resource_ids = [default_id]
|
|
297
|
+
profiles: dict[str, dict[str, Any]] = {}
|
|
298
|
+
for resource_id in resource_ids:
|
|
299
|
+
descriptor = self.catalog.get(resource_id)
|
|
300
|
+
profile = ModelSpec.model_validate(descriptor.contract)
|
|
301
|
+
if profile.model not in allowed_models or profile.model in profiles:
|
|
302
|
+
continue
|
|
303
|
+
profiles[profile.model] = profile.model_dump(
|
|
304
|
+
by_alias=True,
|
|
305
|
+
exclude_defaults=True,
|
|
306
|
+
exclude_none=True,
|
|
307
|
+
mode="json",
|
|
308
|
+
)
|
|
309
|
+
return profiles
|
|
310
|
+
|
|
311
|
+
@staticmethod
|
|
312
|
+
def _runtime_lock(artifact_path: Path) -> dict:
|
|
313
|
+
import zipfile
|
|
314
|
+
|
|
315
|
+
with zipfile.ZipFile(artifact_path) as archive:
|
|
316
|
+
return cast(dict, json.loads(archive.read("runtime-lock.json")))
|
|
317
|
+
|
|
318
|
+
|
|
319
|
+
__all__ = [
|
|
320
|
+
"CodexBuildRecord",
|
|
321
|
+
"CodexBuildRepository",
|
|
322
|
+
"CodexStudioBuilder",
|
|
323
|
+
"current_proxy_mode",
|
|
324
|
+
]
|
|
@@ -0,0 +1,278 @@
|
|
|
1
|
+
"""Codex Studio 的单一 ``agentengine.yaml`` 合同与文件仓储。"""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import hashlib
|
|
6
|
+
import re
|
|
7
|
+
import shutil
|
|
8
|
+
from dataclasses import dataclass
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
from typing import Any, Literal, cast
|
|
11
|
+
|
|
12
|
+
import yaml # type: ignore[import-untyped]
|
|
13
|
+
from pydantic import BaseModel, ConfigDict, Field, ValidationError, model_validator
|
|
14
|
+
|
|
15
|
+
from ksadk.builders.managed_runtime_builder import serialize_managed_runtime_manifest
|
|
16
|
+
from ksadk.studio.errors import StudioError, not_found
|
|
17
|
+
from ksadk.studio.workspace import Workspace
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
class CodexRuntimeRef(BaseModel):
|
|
21
|
+
"""平台托管的 Codex runtime 锁定信息。"""
|
|
22
|
+
|
|
23
|
+
model_config = ConfigDict(extra="forbid")
|
|
24
|
+
|
|
25
|
+
name: Literal["codex"] = "codex"
|
|
26
|
+
version: str = Field(min_length=1, max_length=64)
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
class CodexAgentManifest(BaseModel):
|
|
30
|
+
"""本地演示允许进入 ``agentengine.yaml`` 的完整字段集合。"""
|
|
31
|
+
|
|
32
|
+
model_config = ConfigDict(extra="forbid")
|
|
33
|
+
|
|
34
|
+
name: str = Field(pattern=r"^[a-z][a-z0-9-]{2,62}$")
|
|
35
|
+
version: str = Field(min_length=1, max_length=64)
|
|
36
|
+
framework: Literal["codex"] = "codex"
|
|
37
|
+
artifact_type: Literal["ManagedRuntime"] = "ManagedRuntime"
|
|
38
|
+
runtime: CodexRuntimeRef
|
|
39
|
+
model: str = Field(min_length=1, max_length=256)
|
|
40
|
+
models: list[str] | None = None
|
|
41
|
+
prompt: str = Field(min_length=1, max_length=32768)
|
|
42
|
+
skills: list[str] | None = None
|
|
43
|
+
mcp_servers: list[dict[str, Any]] | None = None
|
|
44
|
+
sandbox: str | None = None
|
|
45
|
+
approval_mode: str | None = None
|
|
46
|
+
|
|
47
|
+
@model_validator(mode="after")
|
|
48
|
+
def validate_models(self) -> "CodexAgentManifest":
|
|
49
|
+
if self.models is None:
|
|
50
|
+
return self
|
|
51
|
+
normalized: list[str] = []
|
|
52
|
+
for value in self.models:
|
|
53
|
+
model = str(value).strip()
|
|
54
|
+
if not model or len(model) > 256:
|
|
55
|
+
raise ValueError("models 中的模型名称长度必须为 1..256")
|
|
56
|
+
if model in normalized:
|
|
57
|
+
raise ValueError("models 不能包含重复模型")
|
|
58
|
+
normalized.append(model)
|
|
59
|
+
if not normalized:
|
|
60
|
+
raise ValueError("models 至少包含一个模型")
|
|
61
|
+
if self.model not in normalized:
|
|
62
|
+
raise ValueError("默认模型 model 必须包含在 models 中")
|
|
63
|
+
self.models = normalized
|
|
64
|
+
if self.skills is not None:
|
|
65
|
+
seen: set[str] = set()
|
|
66
|
+
deduped: list[str] = []
|
|
67
|
+
for sid in self.skills:
|
|
68
|
+
sid = str(sid).strip()
|
|
69
|
+
if not sid:
|
|
70
|
+
raise ValueError("skills 不能包含空值")
|
|
71
|
+
if sid in seen:
|
|
72
|
+
raise ValueError("skills 不能包含重复资源")
|
|
73
|
+
seen.add(sid)
|
|
74
|
+
deduped.append(sid)
|
|
75
|
+
self.skills = deduped
|
|
76
|
+
if self.mcp_servers is not None:
|
|
77
|
+
mcp_seen: set[str] = set()
|
|
78
|
+
mcp_deduped: list[dict[str, Any]] = []
|
|
79
|
+
for server in self.mcp_servers:
|
|
80
|
+
if not isinstance(server, dict):
|
|
81
|
+
raise ValueError("mcp_servers 必须是对象列表")
|
|
82
|
+
name = str(server.get("name") or "").strip()
|
|
83
|
+
url = str(server.get("url") or "").strip()
|
|
84
|
+
if not name:
|
|
85
|
+
raise ValueError("mcp_servers 每项必须有 name")
|
|
86
|
+
if not url:
|
|
87
|
+
raise ValueError("mcp_servers 每项必须有 url")
|
|
88
|
+
if name in mcp_seen:
|
|
89
|
+
raise ValueError("mcp_servers 不能包含重复 name")
|
|
90
|
+
mcp_seen.add(name)
|
|
91
|
+
mcp_deduped.append(server)
|
|
92
|
+
self.mcp_servers = mcp_deduped
|
|
93
|
+
return self
|
|
94
|
+
|
|
95
|
+
@property
|
|
96
|
+
def allowed_models(self) -> tuple[str, ...]:
|
|
97
|
+
return tuple(self.models or [self.model])
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def normalized_manifest_bytes(manifest: CodexAgentManifest) -> bytes:
|
|
101
|
+
"""生成构建、SHA 和磁盘写入共同使用的规范化 YAML。"""
|
|
102
|
+
|
|
103
|
+
payload = manifest.model_dump(mode="python", exclude_none=True)
|
|
104
|
+
return serialize_managed_runtime_manifest(payload)
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
@dataclass(frozen=True)
|
|
108
|
+
class CodexManifestSnapshot:
|
|
109
|
+
manifest: CodexAgentManifest
|
|
110
|
+
manifest_sha256: str
|
|
111
|
+
source_path: Path
|
|
112
|
+
source_bytes: bytes
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
_AGENT_NAME = re.compile(r"^[a-z][a-z0-9-]{2,62}$")
|
|
116
|
+
|
|
117
|
+
|
|
118
|
+
class CodexManifestRepository:
|
|
119
|
+
"""每个本地 Agent 一份 YAML,首个 Agent 兼容工作区根路径。"""
|
|
120
|
+
|
|
121
|
+
def __init__(self, workspace: Workspace) -> None:
|
|
122
|
+
self.workspace = workspace
|
|
123
|
+
self.path = workspace.resolve("agentengine.yaml")
|
|
124
|
+
self.agents_path = workspace.resolve("agents")
|
|
125
|
+
|
|
126
|
+
def exists(self, agent_id: str | None = None) -> bool:
|
|
127
|
+
if agent_id is None:
|
|
128
|
+
return self.path.is_file()
|
|
129
|
+
try:
|
|
130
|
+
self.load(agent_id)
|
|
131
|
+
except StudioError as exc:
|
|
132
|
+
if exc.status_code == 404:
|
|
133
|
+
return False
|
|
134
|
+
raise
|
|
135
|
+
return True
|
|
136
|
+
|
|
137
|
+
def load(self, agent_id: str | None = None) -> CodexManifestSnapshot:
|
|
138
|
+
if agent_id is None:
|
|
139
|
+
return self._load_path(self.path)
|
|
140
|
+
self._validate_agent_id(agent_id)
|
|
141
|
+
if self.path.is_file():
|
|
142
|
+
root = self._load_path(self.path)
|
|
143
|
+
if root.manifest.name == agent_id:
|
|
144
|
+
return root
|
|
145
|
+
path = self._agent_path(agent_id)
|
|
146
|
+
snapshot = self._load_path(path, agent_id=agent_id)
|
|
147
|
+
if snapshot.manifest.name != agent_id:
|
|
148
|
+
raise StudioError(
|
|
149
|
+
"CODEX_MANIFEST_ID_MISMATCH",
|
|
150
|
+
"Agent 目录与 agentengine.yaml 中的 name 不一致",
|
|
151
|
+
status_code=422,
|
|
152
|
+
details={"agentId": agent_id, "manifestName": snapshot.manifest.name},
|
|
153
|
+
)
|
|
154
|
+
return snapshot
|
|
155
|
+
|
|
156
|
+
def list(self) -> list[CodexManifestSnapshot]:
|
|
157
|
+
snapshots: list[CodexManifestSnapshot] = []
|
|
158
|
+
seen: set[str] = set()
|
|
159
|
+
if self.path.is_file():
|
|
160
|
+
root = self._load_path(self.path)
|
|
161
|
+
snapshots.append(root)
|
|
162
|
+
seen.add(root.manifest.name)
|
|
163
|
+
for path in sorted(self.agents_path.glob("*/agentengine.yaml")):
|
|
164
|
+
try:
|
|
165
|
+
snapshot = self._load_path(path)
|
|
166
|
+
except StudioError:
|
|
167
|
+
continue
|
|
168
|
+
if snapshot.manifest.name in seen:
|
|
169
|
+
continue
|
|
170
|
+
snapshots.append(snapshot)
|
|
171
|
+
seen.add(snapshot.manifest.name)
|
|
172
|
+
return snapshots
|
|
173
|
+
|
|
174
|
+
def _load_path(
|
|
175
|
+
self,
|
|
176
|
+
path: Path,
|
|
177
|
+
*,
|
|
178
|
+
agent_id: str | None = None,
|
|
179
|
+
) -> CodexManifestSnapshot:
|
|
180
|
+
if not path.is_file():
|
|
181
|
+
if agent_id is not None:
|
|
182
|
+
raise not_found("agent", agent_id)
|
|
183
|
+
raise StudioError(
|
|
184
|
+
"CODEX_MANIFEST_NOT_FOUND",
|
|
185
|
+
"当前工作区还没有 agentengine.yaml",
|
|
186
|
+
status_code=404,
|
|
187
|
+
)
|
|
188
|
+
try:
|
|
189
|
+
payload = yaml.safe_load(path.read_text(encoding="utf-8-sig"))
|
|
190
|
+
manifest = cast(
|
|
191
|
+
CodexAgentManifest,
|
|
192
|
+
CodexAgentManifest.model_validate(payload),
|
|
193
|
+
)
|
|
194
|
+
except (OSError, yaml.YAMLError, ValidationError) as exc:
|
|
195
|
+
raise StudioError(
|
|
196
|
+
"CODEX_MANIFEST_INVALID",
|
|
197
|
+
"agentengine.yaml 不符合 Codex ManagedRuntime 合同",
|
|
198
|
+
status_code=422,
|
|
199
|
+
details={"reason": str(exc)},
|
|
200
|
+
) from exc
|
|
201
|
+
source = normalized_manifest_bytes(manifest)
|
|
202
|
+
return CodexManifestSnapshot(
|
|
203
|
+
manifest=manifest,
|
|
204
|
+
manifest_sha256=hashlib.sha256(source).hexdigest(),
|
|
205
|
+
source_path=path,
|
|
206
|
+
source_bytes=source,
|
|
207
|
+
)
|
|
208
|
+
|
|
209
|
+
def save(self, manifest: CodexAgentManifest) -> CodexManifestSnapshot:
|
|
210
|
+
source = normalized_manifest_bytes(manifest)
|
|
211
|
+
path = self._save_path(manifest.name)
|
|
212
|
+
self.workspace.atomic_write_text(path, source.decode("utf-8"))
|
|
213
|
+
return CodexManifestSnapshot(
|
|
214
|
+
manifest=manifest,
|
|
215
|
+
manifest_sha256=hashlib.sha256(source).hexdigest(),
|
|
216
|
+
source_path=path,
|
|
217
|
+
source_bytes=source,
|
|
218
|
+
)
|
|
219
|
+
|
|
220
|
+
def delete(
|
|
221
|
+
self,
|
|
222
|
+
agent_id: str,
|
|
223
|
+
*,
|
|
224
|
+
purge: bool,
|
|
225
|
+
trash_directory: Path | None = None,
|
|
226
|
+
) -> None:
|
|
227
|
+
"""Remove one Agent source without ever deleting the workspace root."""
|
|
228
|
+
|
|
229
|
+
snapshot = self.load(agent_id)
|
|
230
|
+
source = snapshot.source_path
|
|
231
|
+
if source == self.path:
|
|
232
|
+
if purge:
|
|
233
|
+
source.unlink()
|
|
234
|
+
return
|
|
235
|
+
if trash_directory is None:
|
|
236
|
+
raise ValueError("recoverable deletion requires a trash directory")
|
|
237
|
+
destination = self.workspace.resolve(trash_directory / "source/agentengine.yaml")
|
|
238
|
+
destination.parent.mkdir(parents=True, exist_ok=True)
|
|
239
|
+
shutil.move(str(source), str(destination))
|
|
240
|
+
return
|
|
241
|
+
|
|
242
|
+
agent_directory = source.parent
|
|
243
|
+
if purge:
|
|
244
|
+
shutil.rmtree(agent_directory)
|
|
245
|
+
return
|
|
246
|
+
if trash_directory is None:
|
|
247
|
+
raise ValueError("recoverable deletion requires a trash directory")
|
|
248
|
+
destination = self.workspace.resolve(
|
|
249
|
+
trash_directory / "source/agents" / agent_id
|
|
250
|
+
)
|
|
251
|
+
destination.parent.mkdir(parents=True, exist_ok=True)
|
|
252
|
+
shutil.move(str(agent_directory), str(destination))
|
|
253
|
+
|
|
254
|
+
def _save_path(self, agent_id: str) -> Path:
|
|
255
|
+
self._validate_agent_id(agent_id)
|
|
256
|
+
if not self.path.is_file():
|
|
257
|
+
return self.path
|
|
258
|
+
if self._load_path(self.path).manifest.name == agent_id:
|
|
259
|
+
return self.path
|
|
260
|
+
return self._agent_path(agent_id)
|
|
261
|
+
|
|
262
|
+
def _agent_path(self, agent_id: str) -> Path:
|
|
263
|
+
self._validate_agent_id(agent_id)
|
|
264
|
+
return self.workspace.resolve(Path("agents") / agent_id / "agentengine.yaml")
|
|
265
|
+
|
|
266
|
+
@staticmethod
|
|
267
|
+
def _validate_agent_id(agent_id: str) -> None:
|
|
268
|
+
if not _AGENT_NAME.fullmatch(agent_id):
|
|
269
|
+
raise not_found("agent", agent_id)
|
|
270
|
+
|
|
271
|
+
|
|
272
|
+
__all__ = [
|
|
273
|
+
"CodexAgentManifest",
|
|
274
|
+
"CodexManifestRepository",
|
|
275
|
+
"CodexManifestSnapshot",
|
|
276
|
+
"CodexRuntimeRef",
|
|
277
|
+
"normalized_manifest_bytes",
|
|
278
|
+
]
|