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,182 @@
|
|
|
1
|
+
"""Signed keyset cursors shared by Studio list endpoints.
|
|
2
|
+
|
|
3
|
+
The cursor is intentionally opaque to clients. It binds the last stable sort
|
|
4
|
+
tuple to a namespace, a whitelisted sort name and the active filters so a
|
|
5
|
+
cursor cannot be replayed against a different query.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
import base64
|
|
11
|
+
import hashlib
|
|
12
|
+
import hmac
|
|
13
|
+
import json
|
|
14
|
+
import secrets
|
|
15
|
+
from collections.abc import Callable, Mapping, Sequence
|
|
16
|
+
from typing import Any, TypeVar
|
|
17
|
+
|
|
18
|
+
from ksadk.studio.errors import StudioError
|
|
19
|
+
|
|
20
|
+
T = TypeVar("T")
|
|
21
|
+
CursorScalar = str | int | float | bool | None
|
|
22
|
+
|
|
23
|
+
_CURSOR_VERSION = 1
|
|
24
|
+
_CURSOR_SECRET = secrets.token_bytes(32)
|
|
25
|
+
_MAX_CURSOR_LENGTH = 4096
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def _invalid_cursor() -> StudioError:
|
|
29
|
+
return StudioError(
|
|
30
|
+
"PAGINATION_CURSOR_INVALID",
|
|
31
|
+
"分页游标无效或已过期",
|
|
32
|
+
status_code=422,
|
|
33
|
+
field="cursor",
|
|
34
|
+
)
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def _encode_part(value: bytes) -> str:
|
|
38
|
+
return base64.urlsafe_b64encode(value).decode("ascii").rstrip("=")
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def _decode_part(value: str) -> bytes:
|
|
42
|
+
padding = "=" * (-len(value) % 4)
|
|
43
|
+
try:
|
|
44
|
+
return base64.b64decode(value + padding, altchars=b"-_", validate=True)
|
|
45
|
+
except (ValueError, TypeError) as exc:
|
|
46
|
+
raise _invalid_cursor() from exc
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def _filter_fingerprint(filters: Mapping[str, Any]) -> str:
|
|
50
|
+
canonical = json.dumps(
|
|
51
|
+
dict(filters),
|
|
52
|
+
ensure_ascii=False,
|
|
53
|
+
sort_keys=True,
|
|
54
|
+
separators=(",", ":"),
|
|
55
|
+
).encode("utf-8")
|
|
56
|
+
return hashlib.sha256(canonical).hexdigest()[:24]
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def encode_cursor(
|
|
60
|
+
*,
|
|
61
|
+
namespace: str,
|
|
62
|
+
sort: str,
|
|
63
|
+
filters: Mapping[str, Any],
|
|
64
|
+
key: Sequence[CursorScalar],
|
|
65
|
+
) -> str:
|
|
66
|
+
"""Return an authenticated opaque cursor for the last emitted row."""
|
|
67
|
+
|
|
68
|
+
if not key or len(key) > 16:
|
|
69
|
+
raise ValueError("cursor key must contain between 1 and 16 values")
|
|
70
|
+
payload = {
|
|
71
|
+
"v": _CURSOR_VERSION,
|
|
72
|
+
"ns": namespace,
|
|
73
|
+
"sort": sort,
|
|
74
|
+
"filters": _filter_fingerprint(filters),
|
|
75
|
+
"key": list(key),
|
|
76
|
+
}
|
|
77
|
+
encoded = json.dumps(
|
|
78
|
+
payload,
|
|
79
|
+
ensure_ascii=False,
|
|
80
|
+
sort_keys=True,
|
|
81
|
+
separators=(",", ":"),
|
|
82
|
+
).encode("utf-8")
|
|
83
|
+
signature = hmac.new(_CURSOR_SECRET, encoded, hashlib.sha256).digest()
|
|
84
|
+
return f"{_encode_part(encoded)}.{_encode_part(signature)}"
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
def decode_cursor(
|
|
88
|
+
cursor: str,
|
|
89
|
+
*,
|
|
90
|
+
namespace: str,
|
|
91
|
+
sort: str,
|
|
92
|
+
filters: Mapping[str, Any],
|
|
93
|
+
) -> tuple[CursorScalar, ...]:
|
|
94
|
+
"""Validate a cursor and return its stable sort tuple."""
|
|
95
|
+
|
|
96
|
+
if not cursor or len(cursor) > _MAX_CURSOR_LENGTH:
|
|
97
|
+
raise _invalid_cursor()
|
|
98
|
+
try:
|
|
99
|
+
encoded_part, signature_part = cursor.split(".", 1)
|
|
100
|
+
encoded = _decode_part(encoded_part)
|
|
101
|
+
signature = _decode_part(signature_part)
|
|
102
|
+
except ValueError as exc:
|
|
103
|
+
raise _invalid_cursor() from exc
|
|
104
|
+
expected_signature = hmac.new(_CURSOR_SECRET, encoded, hashlib.sha256).digest()
|
|
105
|
+
if not hmac.compare_digest(signature, expected_signature):
|
|
106
|
+
raise _invalid_cursor()
|
|
107
|
+
try:
|
|
108
|
+
payload = json.loads(encoded.decode("utf-8"))
|
|
109
|
+
except (UnicodeDecodeError, json.JSONDecodeError) as exc:
|
|
110
|
+
raise _invalid_cursor() from exc
|
|
111
|
+
if not isinstance(payload, dict) or set(payload) != {
|
|
112
|
+
"v",
|
|
113
|
+
"ns",
|
|
114
|
+
"sort",
|
|
115
|
+
"filters",
|
|
116
|
+
"key",
|
|
117
|
+
}:
|
|
118
|
+
raise _invalid_cursor()
|
|
119
|
+
if (
|
|
120
|
+
payload.get("v") != _CURSOR_VERSION
|
|
121
|
+
or payload.get("ns") != namespace
|
|
122
|
+
or payload.get("sort") != sort
|
|
123
|
+
or payload.get("filters") != _filter_fingerprint(filters)
|
|
124
|
+
):
|
|
125
|
+
raise _invalid_cursor()
|
|
126
|
+
key = payload.get("key")
|
|
127
|
+
if not isinstance(key, list) or not key or len(key) > 16:
|
|
128
|
+
raise _invalid_cursor()
|
|
129
|
+
if any(value is not None and not isinstance(value, (str, int, float, bool)) for value in key):
|
|
130
|
+
raise _invalid_cursor()
|
|
131
|
+
return tuple(key)
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
def keyset_page(
|
|
135
|
+
items: Sequence[T],
|
|
136
|
+
*,
|
|
137
|
+
key: Callable[[T], Sequence[CursorScalar]],
|
|
138
|
+
reverse: bool,
|
|
139
|
+
limit: int,
|
|
140
|
+
cursor: str | None,
|
|
141
|
+
namespace: str,
|
|
142
|
+
sort: str,
|
|
143
|
+
filters: Mapping[str, Any],
|
|
144
|
+
) -> dict[str, Any]:
|
|
145
|
+
"""Sort and page records using a unique stable tuple.
|
|
146
|
+
|
|
147
|
+
Callers must include a unique identifier as the final key component.
|
|
148
|
+
Filters are expected to have been applied before this function is called.
|
|
149
|
+
"""
|
|
150
|
+
|
|
151
|
+
page_limit = max(1, limit)
|
|
152
|
+
ordered = sorted(items, key=lambda item: tuple(key(item)), reverse=reverse)
|
|
153
|
+
remaining = ordered
|
|
154
|
+
if cursor is not None:
|
|
155
|
+
cursor_key = decode_cursor(
|
|
156
|
+
cursor,
|
|
157
|
+
namespace=namespace,
|
|
158
|
+
sort=sort,
|
|
159
|
+
filters=filters,
|
|
160
|
+
)
|
|
161
|
+
try:
|
|
162
|
+
remaining = [
|
|
163
|
+
item
|
|
164
|
+
for item in ordered
|
|
165
|
+
if (tuple(key(item)) < cursor_key if reverse else tuple(key(item)) > cursor_key)
|
|
166
|
+
]
|
|
167
|
+
except TypeError as exc:
|
|
168
|
+
raise _invalid_cursor() from exc
|
|
169
|
+
page_items = remaining[:page_limit]
|
|
170
|
+
next_cursor = None
|
|
171
|
+
if len(remaining) > page_limit and page_items:
|
|
172
|
+
next_cursor = encode_cursor(
|
|
173
|
+
namespace=namespace,
|
|
174
|
+
sort=sort,
|
|
175
|
+
filters=filters,
|
|
176
|
+
key=key(page_items[-1]),
|
|
177
|
+
)
|
|
178
|
+
return {
|
|
179
|
+
"items": page_items,
|
|
180
|
+
"nextCursor": next_cursor,
|
|
181
|
+
"total": len(ordered),
|
|
182
|
+
}
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
"""AST-only, inspect-before-commit staging for uploaded Python tools."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import ast
|
|
6
|
+
import hashlib
|
|
7
|
+
import json
|
|
8
|
+
import re
|
|
9
|
+
import shutil
|
|
10
|
+
from pathlib import Path, PurePath
|
|
11
|
+
from typing import Any
|
|
12
|
+
from uuid import uuid4
|
|
13
|
+
|
|
14
|
+
from ksadk.studio.errors import StudioError
|
|
15
|
+
from ksadk.studio.workspace import Workspace
|
|
16
|
+
|
|
17
|
+
_MAX_SOURCE_BYTES = 1024 * 1024
|
|
18
|
+
_TOKEN = re.compile(r"^pyti_[0-9a-f]{32}$")
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
class PythonToolInspector:
|
|
22
|
+
"""Stage Python source and expose declarations without importing it."""
|
|
23
|
+
|
|
24
|
+
def __init__(self, workspace: Workspace) -> None:
|
|
25
|
+
self.workspace = workspace
|
|
26
|
+
self.root = workspace.resolve(".agentkit/catalog/python-tool-inspections")
|
|
27
|
+
self.root.mkdir(parents=True, exist_ok=True)
|
|
28
|
+
|
|
29
|
+
def inspect(self, content: bytes, *, filename: str) -> dict[str, Any]:
|
|
30
|
+
normalized_filename = str(filename or "").strip()
|
|
31
|
+
if (
|
|
32
|
+
not normalized_filename
|
|
33
|
+
or PurePath(normalized_filename).name != normalized_filename
|
|
34
|
+
or not normalized_filename.endswith(".py")
|
|
35
|
+
):
|
|
36
|
+
raise StudioError(
|
|
37
|
+
"PYTHON_TOOL_FILENAME_INVALID",
|
|
38
|
+
"Python Tool 必须是单个 .py 文件",
|
|
39
|
+
status_code=422,
|
|
40
|
+
field="file",
|
|
41
|
+
)
|
|
42
|
+
if not content:
|
|
43
|
+
raise StudioError(
|
|
44
|
+
"PYTHON_TOOL_EMPTY",
|
|
45
|
+
"Python Tool 文件不能为空",
|
|
46
|
+
status_code=422,
|
|
47
|
+
field="file",
|
|
48
|
+
)
|
|
49
|
+
if len(content) > _MAX_SOURCE_BYTES:
|
|
50
|
+
raise StudioError(
|
|
51
|
+
"PYTHON_TOOL_TOO_LARGE",
|
|
52
|
+
"Python Tool 源码不能超过 1 MiB",
|
|
53
|
+
status_code=413,
|
|
54
|
+
field="file",
|
|
55
|
+
)
|
|
56
|
+
try:
|
|
57
|
+
source = content.decode("utf-8")
|
|
58
|
+
except UnicodeDecodeError as exc:
|
|
59
|
+
raise StudioError(
|
|
60
|
+
"PYTHON_TOOL_ENCODING_INVALID",
|
|
61
|
+
"Python Tool 源码必须使用 UTF-8 编码",
|
|
62
|
+
status_code=422,
|
|
63
|
+
field="file",
|
|
64
|
+
) from exc
|
|
65
|
+
try:
|
|
66
|
+
tree = ast.parse(source, filename=normalized_filename)
|
|
67
|
+
except SyntaxError as exc:
|
|
68
|
+
raise StudioError(
|
|
69
|
+
"PYTHON_TOOL_SYNTAX_INVALID",
|
|
70
|
+
f"Python 语法错误:第 {exc.lineno or 1} 行",
|
|
71
|
+
status_code=422,
|
|
72
|
+
field="file",
|
|
73
|
+
details={"line": exc.lineno, "offset": exc.offset},
|
|
74
|
+
) from exc
|
|
75
|
+
|
|
76
|
+
callables = [
|
|
77
|
+
self._callable(node)
|
|
78
|
+
for node in tree.body
|
|
79
|
+
if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef))
|
|
80
|
+
and not node.name.startswith("_")
|
|
81
|
+
]
|
|
82
|
+
if not callables:
|
|
83
|
+
raise StudioError(
|
|
84
|
+
"PYTHON_TOOL_CALLABLE_REQUIRED",
|
|
85
|
+
"文件中没有可导入的顶层公开函数",
|
|
86
|
+
status_code=422,
|
|
87
|
+
field="file",
|
|
88
|
+
)
|
|
89
|
+
|
|
90
|
+
token = f"pyti_{uuid4().hex}"
|
|
91
|
+
directory = self.root / token
|
|
92
|
+
directory.mkdir(parents=True, exist_ok=False)
|
|
93
|
+
digest = hashlib.sha256(content).hexdigest()
|
|
94
|
+
try:
|
|
95
|
+
self.workspace.atomic_write_text(directory / "tool.py", source)
|
|
96
|
+
record = {
|
|
97
|
+
"format": "agentkit.python-tool-inspection/v1",
|
|
98
|
+
"inspectionToken": token,
|
|
99
|
+
"filename": normalized_filename,
|
|
100
|
+
"sha256": digest,
|
|
101
|
+
"size": len(content),
|
|
102
|
+
"callables": callables,
|
|
103
|
+
}
|
|
104
|
+
self.workspace.atomic_write_text(
|
|
105
|
+
directory / "inspection.json",
|
|
106
|
+
json.dumps(record, ensure_ascii=False, sort_keys=True, indent=2) + "\n",
|
|
107
|
+
)
|
|
108
|
+
except BaseException:
|
|
109
|
+
shutil.rmtree(directory, ignore_errors=True)
|
|
110
|
+
raise
|
|
111
|
+
return dict(record)
|
|
112
|
+
|
|
113
|
+
def load(self, token: str) -> dict[str, Any]:
|
|
114
|
+
directory = self._directory(token)
|
|
115
|
+
record_path = directory / "inspection.json"
|
|
116
|
+
source_path = directory / "tool.py"
|
|
117
|
+
try:
|
|
118
|
+
record = json.loads(record_path.read_text(encoding="utf-8"))
|
|
119
|
+
content = source_path.read_bytes()
|
|
120
|
+
except (OSError, ValueError) as exc:
|
|
121
|
+
raise StudioError(
|
|
122
|
+
"PYTHON_TOOL_INSPECTION_NOT_FOUND",
|
|
123
|
+
"Python Tool 检查不存在或已失效",
|
|
124
|
+
status_code=404,
|
|
125
|
+
) from exc
|
|
126
|
+
actual = hashlib.sha256(content).hexdigest()
|
|
127
|
+
if actual != str(record.get("sha256") or ""):
|
|
128
|
+
raise StudioError(
|
|
129
|
+
"PYTHON_TOOL_INSPECTION_CHANGED",
|
|
130
|
+
"Python Tool 暂存内容在确认前发生变化,请重新检查",
|
|
131
|
+
status_code=409,
|
|
132
|
+
)
|
|
133
|
+
record["sourcePath"] = self.workspace.relative(source_path)
|
|
134
|
+
return record
|
|
135
|
+
|
|
136
|
+
def consume(self, token: str) -> None:
|
|
137
|
+
shutil.rmtree(self._directory(token), ignore_errors=True)
|
|
138
|
+
|
|
139
|
+
def _directory(self, token: str) -> Path:
|
|
140
|
+
if not _TOKEN.fullmatch(str(token or "")):
|
|
141
|
+
raise StudioError(
|
|
142
|
+
"PYTHON_TOOL_INSPECTION_NOT_FOUND",
|
|
143
|
+
"Python Tool 检查不存在或已失效",
|
|
144
|
+
status_code=404,
|
|
145
|
+
)
|
|
146
|
+
directory = (self.root / token).resolve()
|
|
147
|
+
try:
|
|
148
|
+
directory.relative_to(self.root.resolve())
|
|
149
|
+
except ValueError as exc:
|
|
150
|
+
raise StudioError(
|
|
151
|
+
"PYTHON_TOOL_INSPECTION_NOT_FOUND",
|
|
152
|
+
"Python Tool 检查不存在或已失效",
|
|
153
|
+
status_code=404,
|
|
154
|
+
) from exc
|
|
155
|
+
return directory
|
|
156
|
+
|
|
157
|
+
@staticmethod
|
|
158
|
+
def _callable(node: ast.FunctionDef | ast.AsyncFunctionDef) -> dict[str, Any]:
|
|
159
|
+
positional = [*node.args.posonlyargs, *node.args.args]
|
|
160
|
+
required_count = max(0, len(positional) - len(node.args.defaults))
|
|
161
|
+
required = [argument.arg for argument in positional[:required_count]]
|
|
162
|
+
required.extend(
|
|
163
|
+
argument.arg
|
|
164
|
+
for argument, default in zip(node.args.kwonlyargs, node.args.kw_defaults)
|
|
165
|
+
if default is None
|
|
166
|
+
)
|
|
167
|
+
parameters = [argument.arg for argument in positional]
|
|
168
|
+
if node.args.vararg is not None:
|
|
169
|
+
parameters.append(f"*{node.args.vararg.arg}")
|
|
170
|
+
parameters.extend(argument.arg for argument in node.args.kwonlyargs)
|
|
171
|
+
if node.args.kwarg is not None:
|
|
172
|
+
parameters.append(f"**{node.args.kwarg.arg}")
|
|
173
|
+
return {
|
|
174
|
+
"name": node.name,
|
|
175
|
+
"async": isinstance(node, ast.AsyncFunctionDef),
|
|
176
|
+
"description": ast.get_docstring(node) or "",
|
|
177
|
+
"parameters": parameters,
|
|
178
|
+
"required": required,
|
|
179
|
+
"line": node.lineno,
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
|
|
183
|
+
__all__ = ["PythonToolInspector"]
|
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
"""File-backed repositories for Agent drafts and immutable build records."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import json
|
|
6
|
+
import shutil
|
|
7
|
+
from datetime import datetime, timezone
|
|
8
|
+
from pathlib import Path
|
|
9
|
+
from typing import Any, cast
|
|
10
|
+
|
|
11
|
+
import yaml # type: ignore[import-untyped]
|
|
12
|
+
from pydantic import ValidationError
|
|
13
|
+
|
|
14
|
+
from ksadk.studio.contracts import (
|
|
15
|
+
AgentAppearance,
|
|
16
|
+
AgentDraft,
|
|
17
|
+
AgentMetadata,
|
|
18
|
+
AgentSpec,
|
|
19
|
+
BuildRecord,
|
|
20
|
+
Instructions,
|
|
21
|
+
)
|
|
22
|
+
from ksadk.studio.errors import StudioError, not_found
|
|
23
|
+
from ksadk.studio.workspace import Workspace
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
class AgentDraftRepository:
|
|
27
|
+
def __init__(self, workspace: Workspace) -> None:
|
|
28
|
+
self.workspace = workspace
|
|
29
|
+
|
|
30
|
+
def _agent_dir(self, agent_id: str) -> Path:
|
|
31
|
+
return self.workspace.resolve(Path("agents") / agent_id)
|
|
32
|
+
|
|
33
|
+
def _agent_file(self, agent_id: str) -> Path:
|
|
34
|
+
return self._agent_dir(agent_id) / "agent.yaml"
|
|
35
|
+
|
|
36
|
+
def create(
|
|
37
|
+
self,
|
|
38
|
+
*,
|
|
39
|
+
agent_id: str,
|
|
40
|
+
name: str,
|
|
41
|
+
description: str = "",
|
|
42
|
+
template: str = "blank",
|
|
43
|
+
spec: AgentSpec | None = None,
|
|
44
|
+
labels: dict[str, str] | None = None,
|
|
45
|
+
) -> AgentDraft:
|
|
46
|
+
if template not in {"blank", "research"}:
|
|
47
|
+
raise StudioError(
|
|
48
|
+
"AGENT_TEMPLATE_UNSUPPORTED",
|
|
49
|
+
"不支持的 Agent 模板",
|
|
50
|
+
status_code=422,
|
|
51
|
+
field="template",
|
|
52
|
+
details={"template": template},
|
|
53
|
+
)
|
|
54
|
+
draft = AgentDraft(
|
|
55
|
+
metadata=AgentMetadata(
|
|
56
|
+
id=agent_id,
|
|
57
|
+
name=name,
|
|
58
|
+
labels={
|
|
59
|
+
"agentkit.ksyun.com/template": template,
|
|
60
|
+
**dict(labels or {}),
|
|
61
|
+
},
|
|
62
|
+
),
|
|
63
|
+
spec=spec
|
|
64
|
+
or AgentSpec(
|
|
65
|
+
description=description,
|
|
66
|
+
instructions=Instructions(
|
|
67
|
+
system="你是一个可靠的企业智能助手。",
|
|
68
|
+
task="",
|
|
69
|
+
),
|
|
70
|
+
),
|
|
71
|
+
)
|
|
72
|
+
path = self._agent_file(agent_id)
|
|
73
|
+
if path.exists():
|
|
74
|
+
raise StudioError(
|
|
75
|
+
"AGENT_ALREADY_EXISTS",
|
|
76
|
+
"Agent ID 已存在",
|
|
77
|
+
status_code=409,
|
|
78
|
+
details={"id": agent_id},
|
|
79
|
+
)
|
|
80
|
+
path.parent.mkdir(parents=True, exist_ok=False)
|
|
81
|
+
(path.parent / "instructions").mkdir()
|
|
82
|
+
(path.parent / "evaluations").mkdir()
|
|
83
|
+
self._write(path, draft)
|
|
84
|
+
return draft
|
|
85
|
+
|
|
86
|
+
def list(self, *, query: str = "", limit: int = 50) -> list[AgentDraft]:
|
|
87
|
+
normalized = query.strip().lower()
|
|
88
|
+
results: list[AgentDraft] = []
|
|
89
|
+
agents_dir = self.workspace.resolve("agents")
|
|
90
|
+
for path in sorted(agents_dir.glob("*/agent.yaml")):
|
|
91
|
+
try:
|
|
92
|
+
draft = self._read(path)
|
|
93
|
+
except StudioError:
|
|
94
|
+
continue
|
|
95
|
+
if (
|
|
96
|
+
normalized
|
|
97
|
+
and normalized not in draft.metadata.id.lower()
|
|
98
|
+
and normalized not in (draft.metadata.name.lower())
|
|
99
|
+
):
|
|
100
|
+
continue
|
|
101
|
+
results.append(draft)
|
|
102
|
+
if len(results) >= limit:
|
|
103
|
+
break
|
|
104
|
+
return results
|
|
105
|
+
|
|
106
|
+
def get(self, agent_id: str) -> AgentDraft:
|
|
107
|
+
path = self._agent_file(agent_id)
|
|
108
|
+
if not path.is_file():
|
|
109
|
+
raise not_found("agent", agent_id)
|
|
110
|
+
return self._read(path)
|
|
111
|
+
|
|
112
|
+
def update(self, agent_id: str, spec: AgentSpec, *, expected_revision: int) -> AgentDraft:
|
|
113
|
+
current = self.get(agent_id)
|
|
114
|
+
if current.metadata.revision != expected_revision:
|
|
115
|
+
raise StudioError(
|
|
116
|
+
"AGENT_REVISION_CONFLICT",
|
|
117
|
+
"Agent 已被其他操作更新",
|
|
118
|
+
status_code=409,
|
|
119
|
+
field="metadata.revision",
|
|
120
|
+
details={
|
|
121
|
+
"expected": expected_revision,
|
|
122
|
+
"actual": current.metadata.revision,
|
|
123
|
+
},
|
|
124
|
+
)
|
|
125
|
+
updated = cast(AgentDraft, current.model_copy(deep=True))
|
|
126
|
+
updated.metadata.revision += 1
|
|
127
|
+
updated.spec = spec
|
|
128
|
+
self._write(self._agent_file(agent_id), updated)
|
|
129
|
+
return updated
|
|
130
|
+
|
|
131
|
+
def update_appearance(
|
|
132
|
+
self,
|
|
133
|
+
agent_id: str,
|
|
134
|
+
appearance: AgentAppearance,
|
|
135
|
+
*,
|
|
136
|
+
expected_revision: int,
|
|
137
|
+
) -> AgentDraft:
|
|
138
|
+
current = self.get(agent_id)
|
|
139
|
+
if current.metadata.revision != expected_revision:
|
|
140
|
+
raise StudioError(
|
|
141
|
+
"AGENT_REVISION_CONFLICT",
|
|
142
|
+
"Agent 已被其他操作更新",
|
|
143
|
+
status_code=409,
|
|
144
|
+
field="metadata.revision",
|
|
145
|
+
details={"expected": expected_revision, "actual": current.metadata.revision},
|
|
146
|
+
)
|
|
147
|
+
updated = cast(AgentDraft, current.model_copy(deep=True))
|
|
148
|
+
updated.metadata.revision += 1
|
|
149
|
+
updated.metadata.appearance = appearance
|
|
150
|
+
self._write(self._agent_file(agent_id), updated)
|
|
151
|
+
return updated
|
|
152
|
+
|
|
153
|
+
def replace(self, draft: AgentDraft) -> AgentDraft:
|
|
154
|
+
"""Persist metadata-only creation state without creating a Revision."""
|
|
155
|
+
|
|
156
|
+
current = self.get(draft.metadata.id)
|
|
157
|
+
if draft.metadata.revision != current.metadata.revision:
|
|
158
|
+
raise StudioError(
|
|
159
|
+
"AGENT_REVISION_CONFLICT",
|
|
160
|
+
"Agent metadata replacement revision mismatch",
|
|
161
|
+
status_code=409,
|
|
162
|
+
)
|
|
163
|
+
self._write(self._agent_file(draft.metadata.id), draft)
|
|
164
|
+
return draft
|
|
165
|
+
|
|
166
|
+
def delete(
|
|
167
|
+
self,
|
|
168
|
+
agent_id: str,
|
|
169
|
+
*,
|
|
170
|
+
purge: bool = False,
|
|
171
|
+
trash_directory: Path | None = None,
|
|
172
|
+
) -> None:
|
|
173
|
+
agent_dir = self._agent_dir(agent_id)
|
|
174
|
+
if not agent_dir.is_dir():
|
|
175
|
+
raise not_found("agent", agent_id)
|
|
176
|
+
if purge:
|
|
177
|
+
shutil.rmtree(agent_dir)
|
|
178
|
+
return
|
|
179
|
+
if trash_directory is None:
|
|
180
|
+
timestamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
|
|
181
|
+
trash = self.workspace.resolve(Path(".agentkit/trash") / f"{agent_id}-{timestamp}")
|
|
182
|
+
else:
|
|
183
|
+
trash = self.workspace.resolve(trash_directory / "source" / "agents" / agent_id)
|
|
184
|
+
trash.parent.mkdir(parents=True, exist_ok=True)
|
|
185
|
+
shutil.move(str(agent_dir), str(trash))
|
|
186
|
+
|
|
187
|
+
def _read(self, path: Path) -> AgentDraft:
|
|
188
|
+
try:
|
|
189
|
+
payload = yaml.safe_load(path.read_text(encoding="utf-8-sig"))
|
|
190
|
+
return cast(AgentDraft, AgentDraft.model_validate(payload))
|
|
191
|
+
except (OSError, yaml.YAMLError, ValidationError) as exc:
|
|
192
|
+
raise StudioError(
|
|
193
|
+
"AGENT_SCHEMA_INVALID",
|
|
194
|
+
"Agent YAML 无法解析",
|
|
195
|
+
status_code=422,
|
|
196
|
+
details={"path": self.workspace.relative(path), "reason": str(exc)},
|
|
197
|
+
) from exc
|
|
198
|
+
|
|
199
|
+
def _write(self, path: Path, draft: AgentDraft) -> None:
|
|
200
|
+
self.workspace.atomic_write_yaml(
|
|
201
|
+
path,
|
|
202
|
+
draft.model_dump(by_alias=True, exclude_none=True, mode="json"),
|
|
203
|
+
)
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
class BuildRepository:
|
|
207
|
+
def __init__(self, workspace: Workspace) -> None:
|
|
208
|
+
self.workspace = workspace
|
|
209
|
+
|
|
210
|
+
def _path(self, build_id: str) -> Path:
|
|
211
|
+
return self.workspace.resolve(Path(".agentkit/builds") / f"{build_id}.json")
|
|
212
|
+
|
|
213
|
+
def save(self, record: BuildRecord) -> BuildRecord:
|
|
214
|
+
payload = record.model_dump(by_alias=True, exclude_none=True, mode="json")
|
|
215
|
+
self.workspace.atomic_write_text(
|
|
216
|
+
self._path(record.id),
|
|
217
|
+
json.dumps(payload, ensure_ascii=False, sort_keys=True, indent=2) + "\n",
|
|
218
|
+
)
|
|
219
|
+
return record
|
|
220
|
+
|
|
221
|
+
def get(self, build_id: str) -> BuildRecord:
|
|
222
|
+
path = self._path(build_id)
|
|
223
|
+
if not path.is_file():
|
|
224
|
+
raise not_found("build", build_id)
|
|
225
|
+
try:
|
|
226
|
+
return cast(
|
|
227
|
+
BuildRecord,
|
|
228
|
+
BuildRecord.model_validate_json(path.read_text(encoding="utf-8")),
|
|
229
|
+
)
|
|
230
|
+
except (OSError, ValidationError) as exc:
|
|
231
|
+
raise StudioError(
|
|
232
|
+
"BUILD_RECORD_INVALID",
|
|
233
|
+
"Build 记录损坏",
|
|
234
|
+
status_code=500,
|
|
235
|
+
details={"id": build_id},
|
|
236
|
+
) from exc
|
|
237
|
+
|
|
238
|
+
def list_for_agent(self, agent_id: str) -> list[BuildRecord]:
|
|
239
|
+
records: list[BuildRecord] = []
|
|
240
|
+
directory = self.workspace.resolve(".agentkit/builds")
|
|
241
|
+
for path in sorted(directory.glob("build_*.json"), reverse=True):
|
|
242
|
+
try:
|
|
243
|
+
record = BuildRecord.model_validate_json(path.read_text(encoding="utf-8"))
|
|
244
|
+
except (OSError, ValidationError):
|
|
245
|
+
continue
|
|
246
|
+
if record.agent_id == agent_id:
|
|
247
|
+
records.append(record)
|
|
248
|
+
return records
|
|
249
|
+
|
|
250
|
+
def delete_for_agent(
|
|
251
|
+
self,
|
|
252
|
+
agent_id: str,
|
|
253
|
+
*,
|
|
254
|
+
purge: bool,
|
|
255
|
+
trash_directory: Path | None = None,
|
|
256
|
+
) -> int:
|
|
257
|
+
records = self.list_for_agent(agent_id)
|
|
258
|
+
artifact_directories: set[Path] = set()
|
|
259
|
+
for record in records:
|
|
260
|
+
if record.artifact_path:
|
|
261
|
+
archive = self.workspace.resolve(record.artifact_path)
|
|
262
|
+
artifact_directories.add(archive.parent)
|
|
263
|
+
for directory in artifact_directories:
|
|
264
|
+
if not directory.is_dir():
|
|
265
|
+
continue
|
|
266
|
+
if purge:
|
|
267
|
+
shutil.rmtree(directory)
|
|
268
|
+
else:
|
|
269
|
+
if trash_directory is None:
|
|
270
|
+
raise ValueError("recoverable deletion requires a trash directory")
|
|
271
|
+
destination = self.workspace.resolve(trash_directory / "artifacts" / directory.name)
|
|
272
|
+
destination.parent.mkdir(parents=True, exist_ok=True)
|
|
273
|
+
shutil.move(str(directory), str(destination))
|
|
274
|
+
for record in records:
|
|
275
|
+
path = self._path(record.id)
|
|
276
|
+
if not path.is_file():
|
|
277
|
+
continue
|
|
278
|
+
if purge:
|
|
279
|
+
path.unlink()
|
|
280
|
+
else:
|
|
281
|
+
if trash_directory is None:
|
|
282
|
+
raise ValueError("recoverable deletion requires a trash directory")
|
|
283
|
+
destination = self.workspace.resolve(trash_directory / "builds" / path.name)
|
|
284
|
+
destination.parent.mkdir(parents=True, exist_ok=True)
|
|
285
|
+
shutil.move(str(path), str(destination))
|
|
286
|
+
return len(records)
|
|
287
|
+
|
|
288
|
+
|
|
289
|
+
def load_yaml_file(path: Path) -> dict[str, Any]:
|
|
290
|
+
try:
|
|
291
|
+
payload = yaml.safe_load(path.read_text(encoding="utf-8-sig")) or {}
|
|
292
|
+
except (OSError, yaml.YAMLError) as exc:
|
|
293
|
+
raise StudioError(
|
|
294
|
+
"WORKSPACE_INVALID",
|
|
295
|
+
"YAML 文件无法解析",
|
|
296
|
+
status_code=422,
|
|
297
|
+
details={"path": str(path), "reason": str(exc)},
|
|
298
|
+
) from exc
|
|
299
|
+
if not isinstance(payload, dict):
|
|
300
|
+
raise StudioError(
|
|
301
|
+
"WORKSPACE_INVALID",
|
|
302
|
+
"YAML 根节点必须是对象",
|
|
303
|
+
status_code=422,
|
|
304
|
+
details={"path": str(path)},
|
|
305
|
+
)
|
|
306
|
+
return cast(dict[str, Any], payload)
|