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
ksadk/toolsets/skills.py
CHANGED
|
@@ -18,15 +18,18 @@ from ksadk.skills.service_env import (
|
|
|
18
18
|
user_skill_space_ids,
|
|
19
19
|
)
|
|
20
20
|
from ksadk.skills.tool_defs import (
|
|
21
|
-
|
|
21
|
+
_skill_manifest_item,
|
|
22
22
|
load_remote_skill_manifests,
|
|
23
23
|
resolve_skill_space_ids,
|
|
24
24
|
)
|
|
25
|
+
from ksadk.skills.tool_defs import (
|
|
26
|
+
build_execute_skills_tool as build_runtime_execute_skills_tool,
|
|
27
|
+
)
|
|
25
28
|
from ksadk.tools.gateway import ToolPolicy, default_tool_gateway
|
|
26
29
|
from ksadk.toolsets._langchain import as_tool
|
|
27
30
|
|
|
28
|
-
|
|
29
31
|
_SKILL_TOOL_POLICIES = {
|
|
32
|
+
"list_skill_spaces": ToolPolicy(risk_level="low"),
|
|
30
33
|
"list_skills": ToolPolicy(risk_level="low"),
|
|
31
34
|
"search_skills": ToolPolicy(risk_level="low"),
|
|
32
35
|
"load_skill": ToolPolicy(risk_level="low", side_effects=("skill_cache_write",)),
|
|
@@ -38,27 +41,132 @@ def _gateway():
|
|
|
38
41
|
return default_tool_gateway(_SKILL_TOOL_POLICIES)
|
|
39
42
|
|
|
40
43
|
|
|
41
|
-
def
|
|
42
|
-
|
|
44
|
+
def _dict_result(value: Any, *, tool_name: str) -> dict[str, Any]:
|
|
45
|
+
if not isinstance(value, dict):
|
|
46
|
+
raise TypeError(f"{tool_name} returned {type(value).__name__}, expected dict")
|
|
47
|
+
return dict(value)
|
|
48
|
+
|
|
43
49
|
|
|
50
|
+
def list_skill_spaces() -> dict[str, Any]:
|
|
51
|
+
"""List visible Skill Spaces with id/name/description, so the model can pick one by intent.
|
|
52
|
+
|
|
53
|
+
多 space 场景下,先调用本工具了解可选 space,再按用户意图用
|
|
54
|
+
``search_skills(query, space_id=...)`` 或 ``load_skill(name, space_id=...)`` 定向查找。
|
|
55
|
+
"""
|
|
56
|
+
|
|
57
|
+
configured = resolve_skill_space_ids()
|
|
44
58
|
try:
|
|
45
|
-
|
|
59
|
+
client = _skill_service_client()
|
|
60
|
+
payload = client.list_skill_spaces()
|
|
61
|
+
spaces = _parse_skill_spaces(payload)
|
|
62
|
+
configured_set = set(configured)
|
|
63
|
+
for space in spaces:
|
|
64
|
+
space["configured"] = space["space_id"] in configured_set
|
|
65
|
+
if not spaces:
|
|
66
|
+
# 服务不支持 ListSkillSpaces 时,退化为返回已配置的 space id。
|
|
67
|
+
spaces = [
|
|
68
|
+
{"space_id": sid, "space_name": "", "description": "", "configured": True}
|
|
69
|
+
for sid in configured
|
|
70
|
+
]
|
|
71
|
+
return {
|
|
72
|
+
"ok": True,
|
|
73
|
+
"configured_space_ids": configured,
|
|
74
|
+
"spaces": spaces,
|
|
75
|
+
"usage": (
|
|
76
|
+
"根据用户意图从这些 space 中选一个 space_id,再用 "
|
|
77
|
+
"search_skills(query, space_id=...) 在该 space 内搜索,或用 "
|
|
78
|
+
"load_skill(skill_name, space_id=...) 精确加载该 space 下的 skill。"
|
|
79
|
+
),
|
|
80
|
+
}
|
|
81
|
+
except Exception as exc:
|
|
82
|
+
return {
|
|
83
|
+
"ok": False,
|
|
84
|
+
"error_type": type(exc).__name__,
|
|
85
|
+
"error_message": str(exc),
|
|
86
|
+
"configured_space_ids": configured,
|
|
87
|
+
"spaces": [
|
|
88
|
+
{"space_id": sid, "space_name": "", "description": "", "configured": True}
|
|
89
|
+
for sid in configured
|
|
90
|
+
],
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
def _parse_skill_spaces(payload: dict[str, Any]) -> list[dict[str, Any]]:
|
|
95
|
+
data = payload.get("Data") or payload.get("data") or {}
|
|
96
|
+
raw = (
|
|
97
|
+
data.get("SkillSpaces")
|
|
98
|
+
or data.get("skill_spaces")
|
|
99
|
+
or data.get("Spaces")
|
|
100
|
+
or data.get("spaces")
|
|
101
|
+
or data.get("Items")
|
|
102
|
+
or data.get("items")
|
|
103
|
+
or []
|
|
104
|
+
)
|
|
105
|
+
spaces: list[dict[str, Any]] = []
|
|
106
|
+
for item in raw:
|
|
107
|
+
if not isinstance(item, dict):
|
|
108
|
+
continue
|
|
109
|
+
spaces.append(
|
|
110
|
+
{
|
|
111
|
+
"space_id": str(
|
|
112
|
+
item.get("SkillSpaceId")
|
|
113
|
+
or item.get("skill_space_id")
|
|
114
|
+
or item.get("SpaceId")
|
|
115
|
+
or item.get("space_id")
|
|
116
|
+
or ""
|
|
117
|
+
),
|
|
118
|
+
"space_name": str(
|
|
119
|
+
item.get("SkillSpaceName")
|
|
120
|
+
or item.get("skill_space_name")
|
|
121
|
+
or item.get("SpaceName")
|
|
122
|
+
or item.get("space_name")
|
|
123
|
+
or ""
|
|
124
|
+
),
|
|
125
|
+
"description": str(item.get("Description") or item.get("description") or ""),
|
|
126
|
+
}
|
|
127
|
+
)
|
|
128
|
+
return spaces
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
def list_skills(space_id: str | None = None) -> dict[str, Any]:
|
|
132
|
+
"""List skills discoverable from configured Skill Spaces, optionally limited to one space.
|
|
133
|
+
|
|
134
|
+
``space_id`` 指定时只列该 space(user space id 或 ``"public"``);缺省列出全部已配置 space。
|
|
135
|
+
"""
|
|
136
|
+
|
|
137
|
+
space_ids = [space_id] if space_id else resolve_skill_space_ids()
|
|
138
|
+
try:
|
|
139
|
+
if space_id:
|
|
140
|
+
client = _skill_service_client()
|
|
141
|
+
manifests = [
|
|
142
|
+
_skill_manifest_item(skill, space_id=sid)
|
|
143
|
+
for sid, skill in _iter_remote_skills(client, space_id=space_id)
|
|
144
|
+
if skill.name
|
|
145
|
+
]
|
|
146
|
+
else:
|
|
147
|
+
manifests = load_remote_skill_manifests(space_ids)
|
|
46
148
|
return {
|
|
47
149
|
"ok": True,
|
|
48
150
|
"skills": manifests,
|
|
49
|
-
"skill_space_ids":
|
|
151
|
+
"skill_space_ids": space_ids,
|
|
152
|
+
"space_id": space_id,
|
|
50
153
|
}
|
|
51
154
|
except Exception as exc:
|
|
52
155
|
return {
|
|
53
156
|
"ok": False,
|
|
54
157
|
"error_type": type(exc).__name__,
|
|
55
158
|
"error_message": str(exc),
|
|
56
|
-
"skill_space_ids":
|
|
159
|
+
"skill_space_ids": space_ids,
|
|
160
|
+
"space_id": space_id,
|
|
57
161
|
}
|
|
58
162
|
|
|
59
163
|
|
|
60
|
-
def load_skill(skill_name: str) -> dict[str, Any]:
|
|
61
|
-
"""Download and load a skill's SKILL.md instructions from configured Skill Spaces.
|
|
164
|
+
def load_skill(skill_name: str, space_id: str | None = None) -> dict[str, Any]:
|
|
165
|
+
"""Download and load a skill's SKILL.md instructions from configured Skill Spaces.
|
|
166
|
+
|
|
167
|
+
``space_id`` 指定时只在该 space 内按名匹配,用于多 space 下精确定位、避免同名冲突;
|
|
168
|
+
缺省按配置顺序(user space 优先于 public)取第一个匹配。
|
|
169
|
+
"""
|
|
62
170
|
|
|
63
171
|
target = str(skill_name or "").strip().lower()
|
|
64
172
|
if not target:
|
|
@@ -66,7 +174,7 @@ def load_skill(skill_name: str) -> dict[str, Any]:
|
|
|
66
174
|
try:
|
|
67
175
|
client = _skill_service_client()
|
|
68
176
|
available: list[str] = []
|
|
69
|
-
for
|
|
177
|
+
for sid, skill in _iter_remote_skills(client, space_id=space_id):
|
|
70
178
|
if not skill.name:
|
|
71
179
|
continue
|
|
72
180
|
available.append(skill.name)
|
|
@@ -79,7 +187,7 @@ def load_skill(skill_name: str) -> dict[str, Any]:
|
|
|
79
187
|
"execution_context": "outer_agent",
|
|
80
188
|
"name": local_skill.name,
|
|
81
189
|
"description": local_skill.description,
|
|
82
|
-
"space_id":
|
|
190
|
+
"space_id": sid,
|
|
83
191
|
"skill_id": skill.skill_id,
|
|
84
192
|
"version_id": skill.version_id,
|
|
85
193
|
"version": skill.version,
|
|
@@ -88,31 +196,52 @@ def load_skill(skill_name: str) -> dict[str, Any]:
|
|
|
88
196
|
"has_scripts_dir": (local_skill.root_dir / "scripts").is_dir(),
|
|
89
197
|
"script_files": _script_files(local_skill.root_dir),
|
|
90
198
|
"instructions": local_skill.body,
|
|
91
|
-
"usage":
|
|
199
|
+
"usage": (
|
|
200
|
+
"Read these instructions and complete the user's task in the outer "
|
|
201
|
+
"agent unless the skill explicitly requires isolated execution."
|
|
202
|
+
),
|
|
92
203
|
}
|
|
93
204
|
return {
|
|
94
205
|
"ok": False,
|
|
95
206
|
"error_message": f"Skill not found: {skill_name}",
|
|
207
|
+
"space_id": space_id,
|
|
96
208
|
"available_skills": available,
|
|
97
209
|
}
|
|
98
210
|
except Exception as exc:
|
|
99
211
|
return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc)}
|
|
100
212
|
|
|
101
213
|
|
|
102
|
-
def search_skills(query: str, max_results: int = 10) -> dict[str, Any]:
|
|
103
|
-
"""Search skills by name, aliases, tags, description, and examples.
|
|
214
|
+
def search_skills(query: str, max_results: int = 10, space_id: str | None = None) -> dict[str, Any]:
|
|
215
|
+
"""Search skills by name, aliases, tags, description, and examples.
|
|
216
|
+
|
|
217
|
+
``space_id`` 指定时只在该 space 内搜索;缺省聚合全部已配置 space。结果带 ``space_id``,
|
|
218
|
+
便于后续 ``load_skill(name, space_id=...)`` 精确定位。
|
|
219
|
+
"""
|
|
104
220
|
|
|
105
221
|
query_text = str(query or "").strip()
|
|
106
222
|
if not query_text:
|
|
107
223
|
return {"ok": False, "error_message": "query is required"}
|
|
108
224
|
try:
|
|
109
225
|
client = _skill_service_client()
|
|
110
|
-
|
|
226
|
+
pairs = list(_iter_remote_skills(client, space_id=space_id))
|
|
227
|
+
# 建立 skill 标识 -> space_id 映射,给结果回填来源 space(cache_key 与 match 去重一致)。
|
|
228
|
+
space_of: dict[str, str] = {}
|
|
229
|
+
for sid, skill in pairs:
|
|
230
|
+
space_of.setdefault(skill.cache_key or skill.skill_id or skill.name, sid)
|
|
231
|
+
refs = [skill for _, skill in pairs]
|
|
111
232
|
matches = match_skill_refs(refs, query_text, limit=max_results)
|
|
233
|
+
results = []
|
|
234
|
+
for match in matches:
|
|
235
|
+
item = match.to_dict()
|
|
236
|
+
item["space_id"] = space_of.get(
|
|
237
|
+
match.skill.cache_key or match.skill.skill_id or match.skill.name, ""
|
|
238
|
+
)
|
|
239
|
+
results.append(item)
|
|
112
240
|
return {
|
|
113
241
|
"ok": True,
|
|
114
242
|
"query": query,
|
|
115
|
-
"
|
|
243
|
+
"space_id": space_id,
|
|
244
|
+
"results": results,
|
|
116
245
|
}
|
|
117
246
|
except Exception as exc:
|
|
118
247
|
return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc)}
|
|
@@ -125,43 +254,64 @@ def execute_skills(
|
|
|
125
254
|
) -> dict[str, Any]:
|
|
126
255
|
"""Execute a workflow through the configured Skill Runtime."""
|
|
127
256
|
|
|
128
|
-
return
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
257
|
+
return _dict_result(
|
|
258
|
+
_gateway().invoke(
|
|
259
|
+
"execute_skills",
|
|
260
|
+
_execute_skills_impl,
|
|
261
|
+
workflow_prompt,
|
|
262
|
+
skill_names,
|
|
263
|
+
approval=approval,
|
|
264
|
+
),
|
|
265
|
+
tool_name="execute_skills",
|
|
134
266
|
)
|
|
135
267
|
|
|
136
268
|
|
|
137
|
-
def _execute_skills_impl(
|
|
269
|
+
def _execute_skills_impl(
|
|
270
|
+
workflow_prompt: str, skill_names: list[str] | str | None = None
|
|
271
|
+
) -> dict[str, Any]:
|
|
138
272
|
try:
|
|
139
273
|
backend = create_skill_runtime_backend()
|
|
140
274
|
raw_tool = build_runtime_execute_skills_tool(backend=backend)
|
|
141
275
|
result = raw_tool(workflow_prompt, skill_names)
|
|
142
|
-
if isinstance(result, dict):
|
|
143
|
-
|
|
144
|
-
|
|
276
|
+
if not isinstance(result, dict):
|
|
277
|
+
return {
|
|
278
|
+
"ok": False,
|
|
279
|
+
"error_type": "invalid_skill_runtime_result",
|
|
280
|
+
"error_message": (f"skill runtime returned {type(result).__name__}, expected dict"),
|
|
281
|
+
}
|
|
282
|
+
result.setdefault("execution_context", f"skill-runtime/{_skill_execution_backend()}")
|
|
283
|
+
return dict(result)
|
|
145
284
|
except SkillRuntimeError as exc:
|
|
146
285
|
return {
|
|
147
286
|
"ok": False,
|
|
148
287
|
"error_type": "skill_runtime_disabled",
|
|
149
288
|
"error_message": str(exc),
|
|
150
|
-
"hint":
|
|
289
|
+
"hint": (
|
|
290
|
+
"Configure KSADK_SKILL_RUNTIME_BACKEND=local_process/e2b or "
|
|
291
|
+
"KSADK_SANDBOX_TEMPLATE_ID for isolated Skill workflow execution."
|
|
292
|
+
),
|
|
151
293
|
}
|
|
152
294
|
except Exception as exc:
|
|
153
295
|
return {"ok": False, "error_type": type(exc).__name__, "error_message": str(exc)}
|
|
154
296
|
|
|
155
297
|
|
|
156
298
|
def get_skill_tools() -> list:
|
|
157
|
-
return [
|
|
299
|
+
return [
|
|
300
|
+
as_tool(list_skills),
|
|
301
|
+
as_tool(list_skill_spaces),
|
|
302
|
+
as_tool(search_skills),
|
|
303
|
+
as_tool(load_skill),
|
|
304
|
+
as_tool(execute_skills),
|
|
305
|
+
]
|
|
158
306
|
|
|
159
307
|
|
|
160
308
|
def _skill_execution_backend() -> str:
|
|
161
309
|
explicit = os.environ.get("KSADK_SKILL_RUNTIME_BACKEND", "").strip().lower()
|
|
162
310
|
if explicit:
|
|
163
311
|
return explicit
|
|
164
|
-
if os.environ.get("KSADK_SANDBOX_TEMPLATE_ID") or os.environ.get(
|
|
312
|
+
if os.environ.get("KSADK_SANDBOX_TEMPLATE_ID") or os.environ.get(
|
|
313
|
+
"KSADK_SKILL_RUNTIME_TEMPLATE_ID"
|
|
314
|
+
):
|
|
165
315
|
return "e2b"
|
|
166
316
|
return "disabled"
|
|
167
317
|
|
|
@@ -177,21 +327,34 @@ def _skill_service_client() -> SkillServiceClient:
|
|
|
177
327
|
)
|
|
178
328
|
|
|
179
329
|
|
|
180
|
-
def
|
|
181
|
-
|
|
330
|
+
def _iter_space_skills(client: SkillServiceClient, space_id: str):
|
|
331
|
+
"""遍历单个 space 的 active skill;space_id="public" 走 premade 列表。"""
|
|
332
|
+
|
|
333
|
+
if space_id == "public":
|
|
334
|
+
listing = client.list_available_premade_skills()
|
|
335
|
+
for skill in select_public_skill_refs(listing.active_skills()):
|
|
336
|
+
yield listing.space_id or "public", skill
|
|
337
|
+
else:
|
|
182
338
|
listing = client.list_skills_by_space_id(space_id)
|
|
183
339
|
for skill in listing.active_skills():
|
|
184
340
|
yield space_id, skill
|
|
341
|
+
|
|
342
|
+
|
|
343
|
+
def _iter_remote_skills(client: SkillServiceClient, space_id: str | None = None):
|
|
344
|
+
"""遍历配置的 space;space_id 指定时只遍历该 space(user 或 "public")。"""
|
|
345
|
+
|
|
346
|
+
if space_id:
|
|
347
|
+
yield from _iter_space_skills(client, space_id)
|
|
348
|
+
return
|
|
349
|
+
for user_space_id in user_skill_space_ids():
|
|
350
|
+
yield from _iter_space_skills(client, user_space_id)
|
|
185
351
|
if public_skill_space_ids():
|
|
186
|
-
|
|
187
|
-
for skill in select_public_skill_refs(listing.active_skills()):
|
|
188
|
-
yield listing.space_id or "public", skill
|
|
352
|
+
yield from _iter_space_skills(client, "public")
|
|
189
353
|
|
|
190
354
|
|
|
191
355
|
def _get_or_download_package(client: SkillServiceClient, skill):
|
|
192
356
|
cache_dir = Path(
|
|
193
|
-
os.environ.get("KSADK_SKILL_CACHE_DIR")
|
|
194
|
-
or Path(tempfile.gettempdir()) / "ksadk-skill-cache"
|
|
357
|
+
os.environ.get("KSADK_SKILL_CACHE_DIR") or Path(tempfile.gettempdir()) / "ksadk-skill-cache"
|
|
195
358
|
)
|
|
196
359
|
store = PackageStore(cache_dir=cache_dir)
|
|
197
360
|
package = store.get_cached(skill)
|
|
@@ -211,7 +374,5 @@ def _script_files(root_dir: Path) -> list[str]:
|
|
|
211
374
|
if not scripts_dir.is_dir():
|
|
212
375
|
return []
|
|
213
376
|
return [
|
|
214
|
-
str(path.relative_to(root_dir))
|
|
215
|
-
for path in sorted(scripts_dir.rglob("*"))
|
|
216
|
-
if path.is_file()
|
|
377
|
+
str(path.relative_to(root_dir)) for path in sorted(scripts_dir.rglob("*")) if path.is_file()
|
|
217
378
|
][:20]
|
ksadk/toolsets/web.py
CHANGED
|
@@ -15,10 +15,17 @@ from ksadk.tools.gateway import ToolPolicy, default_tool_gateway
|
|
|
15
15
|
from ksadk.tools.result_budget import budget_tool_output, default_tool_result_budget
|
|
16
16
|
from ksadk.toolsets._langchain import as_tool
|
|
17
17
|
|
|
18
|
-
|
|
19
18
|
_WEB_TOOL_POLICIES = {
|
|
20
|
-
"web_fetch": ToolPolicy(
|
|
21
|
-
|
|
19
|
+
"web_fetch": ToolPolicy(
|
|
20
|
+
risk_level="low",
|
|
21
|
+
approval_scopes=("public_network",),
|
|
22
|
+
approval_exempt=True,
|
|
23
|
+
),
|
|
24
|
+
"web_search": ToolPolicy(
|
|
25
|
+
risk_level="low",
|
|
26
|
+
approval_scopes=("public_network",),
|
|
27
|
+
approval_exempt=True,
|
|
28
|
+
),
|
|
22
29
|
}
|
|
23
30
|
|
|
24
31
|
|
|
@@ -26,10 +33,19 @@ def _gateway():
|
|
|
26
33
|
return default_tool_gateway(_WEB_TOOL_POLICIES)
|
|
27
34
|
|
|
28
35
|
|
|
36
|
+
def _dict_result(value: Any, *, tool_name: str) -> dict[str, Any]:
|
|
37
|
+
if not isinstance(value, dict):
|
|
38
|
+
raise TypeError(f"{tool_name} returned {type(value).__name__}, expected dict")
|
|
39
|
+
return dict(value)
|
|
40
|
+
|
|
41
|
+
|
|
29
42
|
def web_fetch(url: str, max_chars: int | None = None, timeout: int = 30) -> dict:
|
|
30
43
|
"""Fetch a public HTTP(S) URL and return sanitized text content."""
|
|
31
44
|
|
|
32
|
-
return
|
|
45
|
+
return _dict_result(
|
|
46
|
+
_gateway().invoke("web_fetch", _web_fetch_impl, url, max_chars, timeout),
|
|
47
|
+
tool_name="web_fetch",
|
|
48
|
+
)
|
|
33
49
|
|
|
34
50
|
|
|
35
51
|
def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -> dict:
|
|
@@ -44,9 +60,19 @@ def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -
|
|
|
44
60
|
with httpx.Client(follow_redirects=False, timeout=timeout) as client:
|
|
45
61
|
response = client.get(current_url)
|
|
46
62
|
except httpx.TimeoutException:
|
|
47
|
-
return {
|
|
63
|
+
return {
|
|
64
|
+
"ok": False,
|
|
65
|
+
"error_type": "timeout",
|
|
66
|
+
"error_message": "web_fetch timed out",
|
|
67
|
+
"url": current_url,
|
|
68
|
+
}
|
|
48
69
|
except httpx.HTTPError as exc:
|
|
49
|
-
return {
|
|
70
|
+
return {
|
|
71
|
+
"ok": False,
|
|
72
|
+
"error_type": type(exc).__name__,
|
|
73
|
+
"error_message": str(exc),
|
|
74
|
+
"url": current_url,
|
|
75
|
+
}
|
|
50
76
|
if response.is_redirect and response.headers.get("location"):
|
|
51
77
|
current_url = urljoin(current_url, str(response.headers["location"]))
|
|
52
78
|
continue
|
|
@@ -58,7 +84,9 @@ def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -
|
|
|
58
84
|
field_name="text",
|
|
59
85
|
value=text,
|
|
60
86
|
metadata={"tool_use_id": "web_fetch"},
|
|
61
|
-
budget=default_tool_result_budget(
|
|
87
|
+
budget=default_tool_result_budget(
|
|
88
|
+
max_chars=limit, preview_chars=limit, persist_threshold_chars=limit
|
|
89
|
+
),
|
|
62
90
|
)
|
|
63
91
|
return {
|
|
64
92
|
"ok": True,
|
|
@@ -68,13 +96,21 @@ def _web_fetch_impl(url: str, max_chars: int | None = None, timeout: int = 30) -
|
|
|
68
96
|
"content_type": content_type,
|
|
69
97
|
**budgeted,
|
|
70
98
|
}
|
|
71
|
-
return {
|
|
99
|
+
return {
|
|
100
|
+
"ok": False,
|
|
101
|
+
"error_type": "too_many_redirects",
|
|
102
|
+
"error_message": "web_fetch exceeded redirect limit",
|
|
103
|
+
"url": url,
|
|
104
|
+
}
|
|
72
105
|
|
|
73
106
|
|
|
74
107
|
def web_search(query: str, max_results: int = 5, recency_days: int | None = None) -> dict:
|
|
75
108
|
"""Search the web and return title/url/snippet results without fetching full pages."""
|
|
76
109
|
|
|
77
|
-
return
|
|
110
|
+
return _dict_result(
|
|
111
|
+
_gateway().invoke("web_search", _web_search_impl, query, max_results, recency_days),
|
|
112
|
+
tool_name="web_search",
|
|
113
|
+
)
|
|
78
114
|
|
|
79
115
|
|
|
80
116
|
def _web_search_impl(query: str, max_results: int = 5, recency_days: int | None = None) -> dict:
|
|
@@ -83,7 +119,11 @@ def _web_search_impl(query: str, max_results: int = 5, recency_days: int | None
|
|
|
83
119
|
return {"ok": False, "error_type": "query_required", "error_message": "query is required"}
|
|
84
120
|
provider = _web_search_provider()
|
|
85
121
|
if not provider:
|
|
86
|
-
return {
|
|
122
|
+
return {
|
|
123
|
+
"ok": False,
|
|
124
|
+
"error_type": "provider_not_configured",
|
|
125
|
+
"error_message": "web search provider is not configured",
|
|
126
|
+
}
|
|
87
127
|
if provider == "fake":
|
|
88
128
|
return {
|
|
89
129
|
"ok": True,
|
|
@@ -103,7 +143,11 @@ def _web_search_impl(query: str, max_results: int = 5, recency_days: int | None
|
|
|
103
143
|
return _web_search_http(text, max_results=max_results, recency_days=recency_days)
|
|
104
144
|
if provider == "ksyun":
|
|
105
145
|
return _web_search_ksyun(text, max_results=max_results)
|
|
106
|
-
return {
|
|
146
|
+
return {
|
|
147
|
+
"ok": False,
|
|
148
|
+
"error_type": "provider_not_configured",
|
|
149
|
+
"error_message": f"unsupported web search provider: {provider}",
|
|
150
|
+
}
|
|
107
151
|
|
|
108
152
|
|
|
109
153
|
def get_web_tools() -> list:
|
|
@@ -112,17 +156,35 @@ def get_web_tools() -> list:
|
|
|
112
156
|
|
|
113
157
|
def _web_search_provider() -> str:
|
|
114
158
|
return (
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
159
|
+
(
|
|
160
|
+
os.environ.get("KSADK_WEB_SEARCH_PROVIDER")
|
|
161
|
+
or os.environ.get("OPENCLAW_WEB_SEARCH_PROVIDER")
|
|
162
|
+
or ""
|
|
163
|
+
)
|
|
164
|
+
.strip()
|
|
165
|
+
.lower()
|
|
166
|
+
)
|
|
119
167
|
|
|
120
168
|
|
|
121
|
-
def _web_search_http(
|
|
122
|
-
|
|
169
|
+
def _web_search_http(
|
|
170
|
+
query: str, *, max_results: int = 5, recency_days: int | None = None
|
|
171
|
+
) -> dict[str, Any]:
|
|
172
|
+
base_url = str(
|
|
173
|
+
os.environ.get("KSADK_WEB_SEARCH_BASE_URL")
|
|
174
|
+
or os.environ.get("OPENCLAW_WEB_SEARCH_BASE_URL")
|
|
175
|
+
or ""
|
|
176
|
+
).strip()
|
|
123
177
|
if not base_url:
|
|
124
|
-
return {
|
|
125
|
-
|
|
178
|
+
return {
|
|
179
|
+
"ok": False,
|
|
180
|
+
"error_type": "provider_not_configured",
|
|
181
|
+
"error_message": "web search base URL is not configured",
|
|
182
|
+
}
|
|
183
|
+
api_key = str(
|
|
184
|
+
os.environ.get("KSADK_WEB_SEARCH_API_KEY")
|
|
185
|
+
or os.environ.get("OPENCLAW_WEB_SEARCH_API_KEY")
|
|
186
|
+
or ""
|
|
187
|
+
).strip()
|
|
126
188
|
params: dict[str, Any] = {"q": query, "max_results": max(1, int(max_results or 5))}
|
|
127
189
|
if recency_days is not None:
|
|
128
190
|
params["recency_days"] = int(recency_days)
|
|
@@ -190,7 +252,14 @@ def _web_search_ksyun(query: str, *, max_results: int = 5) -> dict[str, Any]:
|
|
|
190
252
|
endpoint = _ksyun_search_endpoint()
|
|
191
253
|
api_key = _ksyun_search_api_key()
|
|
192
254
|
if not api_key:
|
|
193
|
-
return {
|
|
255
|
+
return {
|
|
256
|
+
"ok": False,
|
|
257
|
+
"error_type": "provider_not_configured",
|
|
258
|
+
"error_message": (
|
|
259
|
+
"ksyun web search api key is not configured "
|
|
260
|
+
"(KSADK_WEB_SEARCH_API_KEY / KSADK_MCP_KEY / KSC_AIPRO_API_KEY)"
|
|
261
|
+
),
|
|
262
|
+
}
|
|
194
263
|
size = max(1, min(int(max_results or 5), 200))
|
|
195
264
|
headers = {"Content-Type": "application/json", "Authorization": f"Bearer {api_key}"}
|
|
196
265
|
payload_body = {"q": query, "scope": _ksyun_search_scope(), "size": size}
|
|
@@ -231,25 +300,53 @@ def _web_search_ksyun(query: str, *, max_results: int = 5) -> dict[str, Any]:
|
|
|
231
300
|
def _validate_public_http_url(url: str) -> dict | None:
|
|
232
301
|
parsed = urlparse(url)
|
|
233
302
|
if parsed.scheme not in {"http", "https"}:
|
|
234
|
-
return {
|
|
303
|
+
return {
|
|
304
|
+
"ok": False,
|
|
305
|
+
"error_type": "unsupported_scheme",
|
|
306
|
+
"error_message": "only http and https URLs are supported",
|
|
307
|
+
"url": url,
|
|
308
|
+
}
|
|
235
309
|
if not parsed.hostname:
|
|
236
|
-
return {
|
|
310
|
+
return {
|
|
311
|
+
"ok": False,
|
|
312
|
+
"error_type": "invalid_url",
|
|
313
|
+
"error_message": "URL host is required",
|
|
314
|
+
"url": url,
|
|
315
|
+
}
|
|
237
316
|
policy = _ssrf_policy()
|
|
238
317
|
if policy.get("allow_private") is True:
|
|
239
318
|
return None
|
|
240
319
|
try:
|
|
241
|
-
addresses = socket.getaddrinfo(
|
|
320
|
+
addresses = socket.getaddrinfo(
|
|
321
|
+
parsed.hostname,
|
|
322
|
+
parsed.port or (443 if parsed.scheme == "https" else 80),
|
|
323
|
+
type=socket.SOCK_STREAM,
|
|
324
|
+
)
|
|
242
325
|
except socket.gaierror as exc:
|
|
243
|
-
return {
|
|
326
|
+
return {
|
|
327
|
+
"ok": False,
|
|
328
|
+
"error_type": "dns_resolution_failed",
|
|
329
|
+
"error_message": str(exc),
|
|
330
|
+
"url": url,
|
|
331
|
+
}
|
|
244
332
|
for address in addresses:
|
|
245
333
|
ip = ipaddress.ip_address(address[4][0])
|
|
246
334
|
if ip.is_loopback or ip.is_private or ip.is_link_local or ip.is_multicast or ip.is_reserved:
|
|
247
|
-
return {
|
|
335
|
+
return {
|
|
336
|
+
"ok": False,
|
|
337
|
+
"error_type": "blocked_by_ssrf_policy",
|
|
338
|
+
"error_message": f"blocked non-public address: {ip}",
|
|
339
|
+
"url": url,
|
|
340
|
+
}
|
|
248
341
|
return None
|
|
249
342
|
|
|
250
343
|
|
|
251
344
|
def _ssrf_policy() -> dict:
|
|
252
|
-
raw =
|
|
345
|
+
raw = (
|
|
346
|
+
os.environ.get("KSADK_WEB_SSRF_POLICY_JSON")
|
|
347
|
+
or os.environ.get("OPENCLAW_BROWSER_SSRF_POLICY_JSON")
|
|
348
|
+
or ""
|
|
349
|
+
)
|
|
253
350
|
if not raw:
|
|
254
351
|
return {}
|
|
255
352
|
try:
|