agentengine-sdk-python 0.8.1__py3-none-any.whl → 0.8.3__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.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/METADATA +25 -12
- {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/RECORD +421 -232
- ksadk/_build_provenance.json +1 -0
- ksadk/a2a/_space_client_events.py +381 -0
- ksadk/a2a/event_adapter.py +156 -64
- ksadk/a2a/executor.py +179 -63
- ksadk/a2a/space_client.py +6 -333
- ksadk/a2ui/core.py +222 -53
- ksadk/agui/_agent_helpers.py +247 -0
- ksadk/agui/a2ui_projection.py +12 -5
- ksadk/agui/agent.py +443 -259
- ksadk/api/client.py +528 -27
- ksadk/builders/code_builder.py +284 -8
- ksadk/builders/container_builder.py +8 -1
- ksadk/builders/managed_runtime_builder.py +42 -35
- ksadk/cli/__init__.py +23 -0
- ksadk/cli/cmd_dashboard.py +15 -1
- ksadk/cli/cmd_deploy.py +10 -2
- ksadk/cli/cmd_eval.py +66 -9
- ksadk/cli/cmd_evalset.py +284 -0
- ksadk/cli/cmd_files.py +5 -1
- ksadk/cli/cmd_hermes.py +1 -126
- ksadk/cli/cmd_invoke.py +28 -38
- ksadk/cli/cmd_managed_runtime.py +95 -0
- ksadk/cli/cmd_observe.py +85 -0
- ksadk/cli/cmd_openclaw.py +1 -435
- ksadk/cli/cmd_plugin.py +657 -0
- ksadk/cli/cmd_replay.py +28 -4
- ksadk/cli/cmd_studio.py +99 -8
- ksadk/cli/cmd_web.py +10 -2
- ksadk/cli/hermes_env.py +151 -0
- ksadk/cli/invoke_payload.py +49 -0
- ksadk/cli/openclaw_env.py +458 -0
- ksadk/codex/client.py +180 -30
- ksadk/codex/runtime.py +475 -331
- ksadk/configs/env_registry.py +94 -12
- ksadk/configs/env_registry_pcm.py +181 -0
- ksadk/configs/env_var_spec.py +18 -0
- ksadk/configs/global_config.py +5 -0
- ksadk/configs/settings.py +9 -0
- ksadk/context_engine/__init__.py +98 -0
- ksadk/context_engine/assembler.py +176 -0
- ksadk/context_engine/baseline.py +419 -0
- ksadk/context_engine/cache_observability.py +228 -0
- ksadk/context_engine/capabilities.py +443 -0
- ksadk/context_engine/contributors.py +409 -0
- ksadk/context_engine/hosted_pipeline.py +417 -0
- ksadk/context_engine/models.py +117 -0
- ksadk/context_engine/planner.py +698 -0
- ksadk/context_engine/policies.py +319 -0
- ksadk/context_engine/projection.py +31 -0
- ksadk/context_engine/shadow_plan.py +266 -0
- ksadk/context_engine/tokenizer.py +164 -0
- ksadk/conversations/__init__.py +19 -0
- ksadk/conversations/context.py +230 -30
- ksadk/conversations/contracts.py +266 -0
- ksadk/conversations/message_projection.py +308 -26
- ksadk/conversations/model_context.py +49 -3
- ksadk/conversations/projector.py +616 -0
- ksadk/conversations/reducer.py +98 -0
- ksadk/conversations/runtime_compaction.py +207 -5
- ksadk/conversations/runtime_input.py +184 -2
- ksadk/conversations/runtime_invocation.py +81 -3
- ksadk/conversations/runtime_observability.py +141 -0
- ksadk/conversations/runtime_payloads.py +42 -0
- ksadk/conversations/runtime_preparation.py +272 -2
- ksadk/conversations/runtime_resume.py +20 -1
- ksadk/conversations/runtime_stream_events.py +94 -9
- ksadk/conversations/semantic_summary.py +311 -1
- ksadk/conversations/session_lock.py +51 -0
- ksadk/deployment/env_forward.py +72 -0
- ksadk/deployment/managed_runtime.py +5 -0
- ksadk/deployment/providers/serverless.py +143 -69
- ksadk/evaluation/__init__.py +32 -0
- ksadk/evaluation/a2a_adapter.py +9 -1
- ksadk/evaluation/adapters.py +18 -5
- ksadk/evaluation/agent_eval_client.py +395 -0
- ksadk/evaluation/cloud_binding.py +80 -0
- ksadk/evaluation/cloud_converter.py +194 -0
- ksadk/evaluation/cloud_service.py +199 -0
- ksadk/evaluation/contracts.py +73 -4
- ksadk/evaluation/evaluators.py +183 -17
- ksadk/evaluation/evidence.py +258 -0
- ksadk/evaluation/executor.py +31 -6
- ksadk/evaluation/local_adapter.py +550 -0
- ksadk/evaluation/service_env.py +27 -0
- ksadk/evaluation/studio_build_adapter.py +253 -0
- ksadk/evaluation/target.py +15 -6
- ksadk/events/__init__.py +13 -13
- ksadk/events/_v1_compat/__init__.py +1 -0
- ksadk/events/_v1_compat/models.py +299 -0
- ksadk/events/_v1_compat/parser.py +247 -0
- ksadk/events/_v1_compat/projection.py +755 -0
- ksadk/events/adapters/__init__.py +34 -0
- ksadk/events/adapters/_a2a_snapshot.py +622 -0
- ksadk/events/adapters/_a2a_support.py +275 -0
- ksadk/events/adapters/_codex_interactions.py +375 -0
- ksadk/events/adapters/_codex_items.py +801 -0
- ksadk/events/adapters/_codex_validators.py +311 -0
- ksadk/events/adapters/_langgraph_support.py +785 -0
- ksadk/events/adapters/a2a.py +841 -0
- ksadk/events/adapters/adk.py +503 -0
- ksadk/events/adapters/codex.py +907 -0
- ksadk/events/adapters/langgraph.py +745 -0
- ksadk/events/canonical.py +440 -0
- ksadk/events/canonical_replay.py +497 -0
- ksadk/events/canonical_store.py +468 -0
- ksadk/events/cold_recovery.py +257 -0
- ksadk/events/content.py +89 -0
- ksadk/events/identity.py +86 -0
- ksadk/events/pipeline.py +455 -0
- ksadk/events/projections.py +66 -0
- ksadk/events/reducer.py +661 -0
- ksadk/events/replay.py +3 -36
- ksadk/events/runtime_event.py +20 -265
- ksadk/events/session_event.py +324 -0
- ksadk/events/store.py +3 -316
- ksadk/events/v1_compat.py +41 -0
- ksadk/harness/__init__.py +45 -35
- ksadk/harness/runtime.py +220 -58
- ksadk/identity/resolver.py +4 -3
- ksadk/interaction/__init__.py +28 -0
- ksadk/interaction/contracts.py +136 -0
- ksadk/interaction/ledger.py +189 -0
- ksadk/interaction/provider.py +122 -0
- ksadk/interaction/providers/__init__.py +52 -0
- ksadk/interaction/providers/adk.py +40 -0
- ksadk/interaction/providers/codex.py +94 -0
- ksadk/interaction/providers/langgraph.py +58 -0
- ksadk/kernel/__init__.py +117 -0
- ksadk/kernel/authorization.py +258 -0
- ksadk/kernel/bootstrap.py +1074 -0
- ksadk/kernel/contract_fingerprints.py +62 -0
- ksadk/kernel/contracts.py +370 -0
- ksadk/kernel/control.py +220 -0
- ksadk/kernel/errors.py +79 -0
- ksadk/kernel/ingress.py +1123 -0
- ksadk/kernel/mapping.py +111 -0
- ksadk/kernel/memory_store.py +1134 -0
- ksadk/kernel/postgres_store.py +1757 -0
- ksadk/kernel/recovery.py +452 -0
- ksadk/kernel/runtime_identity.py +103 -0
- ksadk/kernel/sql/001_agent_kernel.sql +120 -0
- ksadk/kernel/sqlite_store.py +1411 -0
- ksadk/kernel/state.py +145 -0
- ksadk/kernel/store.py +232 -0
- ksadk/kernel/worker.py +964 -0
- ksadk/knowledge_base/client.py +7 -0
- ksadk/knowledge_base/service.py +32 -5
- ksadk/memory/__init__.py +61 -0
- ksadk/memory/adk/backends/base_ltm_backend.py +96 -1
- ksadk/memory/adk/backends/http_ltm_backend.py +14 -5
- ksadk/memory/adk/backends/inmemory_ltm_backend.py +136 -3
- ksadk/memory/adk/backends/sdk_ltm_backend.py +384 -2
- ksadk/memory/adk/backends/sqlite_ltm_backend.py +95 -0
- ksadk/memory/coordinator.py +461 -0
- ksadk/memory/events.py +202 -0
- ksadk/memory/extraction.py +228 -0
- ksadk/memory/ltm_backend_factory.py +16 -3
- ksadk/memory/models.py +316 -0
- ksadk/memory/policy.py +215 -0
- ksadk/memory/provider.py +47 -0
- ksadk/memory/provider_adapter.py +159 -0
- ksadk/memory/provider_resolver.py +71 -0
- ksadk/memory/providers/__init__.py +5 -0
- ksadk/memory/providers/local_sqlite.py +497 -0
- ksadk/memory/resolved_policy.py +145 -0
- ksadk/memory/service.py +188 -6
- ksadk/model_proxy/bootstrap.py +16 -9
- ksadk/model_proxy/detect.py +202 -9
- ksadk/model_proxy/namespace.py +39 -15
- ksadk/model_proxy/server.py +24 -5
- ksadk/model_proxy/transform.py +60 -2
- ksadk/observability/__init__.py +25 -0
- ksadk/observability/session_log.py +420 -0
- ksadk/observability/trajectory.py +105 -0
- ksadk/plugins/__init__.py +167 -0
- ksadk/plugins/bridges/__init__.py +45 -0
- ksadk/plugins/bridges/codex.py +552 -0
- ksadk/plugins/bridges/dsh.py +1116 -0
- ksadk/plugins/builtins.py +747 -0
- ksadk/plugins/bundle.py +246 -0
- ksadk/plugins/bundle_security.py +167 -0
- ksadk/plugins/composition.py +529 -0
- ksadk/plugins/context_contributor.py +437 -0
- ksadk/plugins/contracts.py +451 -0
- ksadk/plugins/dsh_toolchain.py +935 -0
- ksadk/plugins/ecosystem_bridge.py +1105 -0
- ksadk/plugins/ecosystem_probe.py +191 -0
- ksadk/plugins/host.py +724 -0
- ksadk/plugins/providers/__init__.py +85 -0
- ksadk/plugins/providers/bundles/ksadk-codex/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/ksadk-codex/index.mjs +18 -0
- ksadk/plugins/providers/bundles/ksadk-codex/package.json +19 -0
- ksadk/plugins/providers/bundles/ksadk-harness/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +19 -0
- ksadk/plugins/providers/bundles/ksadk-harness/package.json +19 -0
- ksadk/plugins/providers/codex.py +722 -0
- ksadk/plugins/providers/codex_dsh.py +83 -0
- ksadk/plugins/providers/dsh.py +951 -0
- ksadk/plugins/providers/dsh_descriptor_host.py +226 -0
- ksadk/plugins/providers/harness.py +627 -0
- ksadk/plugins/providers/harness_dsh.py +91 -0
- ksadk/plugins/providers/legacy.py +215 -0
- ksadk/plugins/providers/legacy_catalog.py +100 -0
- ksadk/plugins/providers/shipped_dsh.py +370 -0
- ksadk/plugins/resolver.py +331 -0
- ksadk/plugins/subagent_providers/__init__.py +12 -0
- ksadk/plugins/subagent_providers/codex.py +443 -0
- ksadk/plugins/subagents.py +333 -0
- ksadk/prompts/__init__.py +71 -0
- ksadk/prompts/compiler.py +215 -0
- ksadk/prompts/models.py +82 -0
- ksadk/prompts/projection.py +89 -0
- ksadk/prompts/resolved.py +137 -0
- ksadk/prompts/sources.py +233 -0
- ksadk/runners/_langgraph_runner_streams.py +822 -0
- ksadk/runners/adk_runner.py +5 -5
- ksadk/runners/base_runner.py +16 -0
- ksadk/runners/factory.py +1 -2
- ksadk/runners/langgraph_runner.py +198 -437
- ksadk/runtime/_runner_adapter/__init__.py +1 -0
- ksadk/runtime/_runner_adapter/stream_mapping.py +797 -0
- ksadk/runtime/adapter.py +119 -2
- ksadk/runtime/conversation_execution.py +316 -182
- ksadk/runtime/executor.py +144 -3
- ksadk/runtime/factory.py +268 -8
- ksadk/runtime/framework_adapters.py +18 -0
- ksadk/runtime/hosted_finalizer.py +268 -0
- ksadk/runtime/launch.py +14 -1
- ksadk/runtime/preprocessing.py +25 -3
- ksadk/runtime/runner_adapter.py +293 -508
- ksadk/runtime/usage.py +33 -0
- ksadk/sandbox/__init__.py +2 -1
- ksadk/sandbox/backends/e2b.py +35 -2
- ksadk/sandbox/factory.py +72 -0
- ksadk/scheduler/__init__.py +18 -0
- ksadk/scheduler/calendar.py +102 -0
- ksadk/scheduler/contracts.py +254 -0
- ksadk/scheduler/dispatcher.py +129 -0
- ksadk/scheduler/engine.py +416 -0
- ksadk/scheduler/sqlite_store.py +563 -0
- ksadk/server/composition.py +8 -0
- ksadk/server/factory.py +69 -6
- ksadk/server/routes/kernel_ingress.py +258 -0
- ksadk/server/routes/openai_compat.py +88 -8
- ksadk/server/routes/projection.py +35 -20
- ksadk/server/routes/run.py +94 -0
- ksadk/server/routes/sessions.py +2 -0
- ksadk/server/routes/streaming.py +5 -2
- ksadk/server/static/assets/{ArtifactsPanel-CakCqxEN.js → ArtifactsPanel-10GPXIJ6.js} +1 -1
- ksadk/server/static/assets/{CodeBlock-CynLknyO.js → CodeBlock-BXk1l-G1.js} +4 -4
- ksadk/server/static/assets/MathMessageMarkdown-BorAY7qD.css +1 -0
- ksadk/server/static/assets/{MathMessageMarkdown-3sQdOysS.js → MathMessageMarkdown-D9uB55Oh.js} +4 -4
- ksadk/server/static/assets/MermaidBlock--OEYoXIJ.js +312 -0
- ksadk/server/static/assets/NativeTerminalPanel-DrEe1syq.js +1 -0
- ksadk/server/static/assets/abnfDiagram-VCTEODGH-eeTFJLvo.js +1 -0
- ksadk/server/static/assets/arc-S3ZNbIAd.js +1 -0
- ksadk/server/static/assets/architecture-7GRP2DOG-Dk9nRQ6-.js +1 -0
- ksadk/server/static/assets/architectureDiagram-5GKGNRK7-CRjgEJDX.js +36 -0
- ksadk/server/static/assets/blockDiagram-NRAW4CY4-C7bsBoNH.js +129 -0
- ksadk/server/static/assets/c4Diagram-UCG6FXSJ-BX3c33Ob.js +38 -0
- ksadk/server/static/assets/channel-s354Yo6o.js +1 -0
- ksadk/server/static/assets/chunk-2Q5K7J3B-CDpPpKR5.js +1 -0
- ksadk/server/static/assets/{chunk-FMBD7UC4-B_fH2YuH.js → chunk-5VM5RSS4-bZ7ws-8m.js} +1 -1
- ksadk/server/static/assets/{chunk-ND2GUHAM-D6rFLaVV.js → chunk-F27PBJKO-D2r0pvhY.js} +1 -1
- ksadk/server/static/assets/chunk-G27WJ6UU-CZwF3oUP.js +231 -0
- ksadk/server/static/assets/{chunk-4BX2VUAB-B9drTgOW.js → chunk-JWPE2WC7-DigFYCML.js} +1 -1
- ksadk/server/static/assets/chunk-LCL6LL3I-CnorGV5q.js +206 -0
- ksadk/server/static/assets/chunk-POPQ4Y6H-CexntQA-.js +1 -0
- ksadk/server/static/assets/chunk-RHFEMEQ7-CHTC7UxA.js +168 -0
- ksadk/server/static/assets/chunk-SVP7TREG-BC1EWt_-.js +88 -0
- ksadk/server/static/assets/chunk-XXDRQBXY-BTG24xN0.js +1 -0
- ksadk/server/static/assets/classDiagram-DTDB5LWJ-Dd0nucl9.js +1 -0
- ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Dd0nucl9.js +1 -0
- ksadk/server/static/assets/{cose-bilkent-S5V4N54A-ChNs_Mdk.js → cose-bilkent-JH36ORCC-CkonRdAS.js} +1 -1
- ksadk/server/static/assets/cynefin-OW5HDTMX-BBlT4uMf.js +1 -0
- ksadk/server/static/assets/cynefinDiagram-5FMLGOSQ-DEOCBe15.js +62 -0
- ksadk/server/static/assets/cytoscape.esm-CyCl8rPi.js +321 -0
- ksadk/server/static/assets/dagre-3AP2YEHR-DBThPuLa.js +4 -0
- ksadk/server/static/assets/dagre-ClTPrTht.js +1 -0
- ksadk/server/static/assets/diagram-S7CK7UJ4-DsZHrnpJ.js +30 -0
- ksadk/server/static/assets/diagram-UQ7AKVKN-BJR4nhVr.js +41 -0
- ksadk/server/static/assets/diagram-VSXAHHWV-xzcERX0a.js +3 -0
- ksadk/server/static/assets/diagram-VX7I27RA-tn2xM1xu.js +24 -0
- ksadk/server/static/assets/diagram-Z3DM3KII-BZPGBkw5.js +24 -0
- ksadk/server/static/assets/{dist-gLnrGsoU.js → dist-4zN1_tq5.js} +1 -1
- ksadk/server/static/assets/{dist-C1sz5Eo3.js → dist-8VWI-2bZ.js} +1 -1
- ksadk/server/static/assets/{dist-BjOdlDjj.js → dist-B-46q3Hk.js} +1 -1
- ksadk/server/static/assets/{dist-o2OVmKvt.js → dist-B0gdk4rl.js} +1 -1
- ksadk/server/static/assets/{dist-4N2NMVYg.js → dist-B1oWRmrH.js} +1 -1
- ksadk/server/static/assets/{dist-CmZHzlwZ.js → dist-BI1qQH4n.js} +1 -1
- ksadk/server/static/assets/{dist-X4TnqwOK.js → dist-BJLUwH6W.js} +1 -1
- ksadk/server/static/assets/{dist-B5oS1zcj.js → dist-Bbwqa8TG.js} +1 -1
- ksadk/server/static/assets/{dist-j6Dxmf_j.js → dist-Btyo4vX4.js} +1 -1
- ksadk/server/static/assets/{dist-DQU9EWw-.js → dist-C71CsujO.js} +1 -1
- ksadk/server/static/assets/{dist-BIlKoW0k.js → dist-CXpH_Rdd.js} +1 -1
- ksadk/server/static/assets/{dist-DJN_6Y39.js → dist-Cq4OL6nO.js} +1 -1
- ksadk/server/static/assets/{dist-Dli7qW-B.js → dist-D1V3f1B4.js} +1 -1
- ksadk/server/static/assets/{dist-fhOuWds5.js → dist-DJmCPRVB.js} +1 -1
- ksadk/server/static/assets/{dist-CWV4lDr1.js → dist-DQAB0qn_.js} +2 -2
- ksadk/server/static/assets/{dist-D6MpCZtz.js → dist-DUwKa_l6.js} +1 -1
- ksadk/server/static/assets/dist-DdRBIceA.js +1 -0
- ksadk/server/static/assets/{dist-DWKByxWV.js → dist-DfGFrb0v.js} +1 -1
- ksadk/server/static/assets/{dist-DsHPdk3W.js → dist-DjhwGUgZ.js} +1 -1
- ksadk/server/static/assets/{dist-B-jNR6Vn.js → dist-DyqV4fL4.js} +1 -1
- ksadk/server/static/assets/{dist-BB3-OwTQ.js → dist-M67Hwu0n.js} +1 -1
- ksadk/server/static/assets/{dist-_pHPTyZ-.js → dist-u8tVH5Ak.js} +1 -1
- ksadk/server/static/assets/ebnfDiagram-PWID7BFC-DVfMsLge.js +1 -0
- ksadk/server/static/assets/erDiagram-SSCWMZ5O-CWEZSYaw.js +99 -0
- ksadk/server/static/assets/eventmodeling-NTZA5JFV-Dr5okd8V.js +1 -0
- ksadk/server/static/assets/flowDiagram-A5DVABFB-VEO-cVcO.js +1 -0
- ksadk/server/static/assets/ganttDiagram-EL5Y4UJY-TWIxoyYL.js +292 -0
- ksadk/server/static/assets/gitGraph-4MIJSDKK-CKiKY9Cf.js +1 -0
- ksadk/server/static/assets/gitGraphDiagram-WWUBYQGX-DDh2hd2S.js +106 -0
- ksadk/server/static/assets/index-B2k_urY8.js +241 -0
- ksadk/server/static/assets/index-ILPt6IWF.css +2 -0
- ksadk/server/static/assets/info-A6RAGUB7-ubA4Nm_p.js +1 -0
- ksadk/server/static/assets/infoDiagram-RXCK75RN-CgoyWiDR.js +2 -0
- ksadk/server/static/assets/{ishikawaDiagram-YF4QCWOH-K0OOfVna.js → ishikawaDiagram-5VMMS53U-CyRIu_om.js} +6 -6
- ksadk/server/static/assets/{journeyDiagram-JHISSGLW-8LeOJaZp.js → journeyDiagram-EYS64GPL-DN5JXHzN.js} +6 -6
- ksadk/server/static/assets/{kanban-definition-UN3LZRKU-C6uCgZrW.js → kanban-definition-3QL26DDD-CNP3ui66.js} +10 -10
- ksadk/server/static/assets/katex-DWEzQy1d.js +257 -0
- ksadk/server/static/assets/{linear-hdBcYzM8.js → linear-C-qHp7d2.js} +1 -1
- ksadk/server/static/assets/mermaid-parser.core-Cl-K943T.js +166 -0
- ksadk/server/static/assets/{mindmap-definition-RKZ34NQL-Bjy_2v4_.js → mindmap-definition-FBJOCRG2-D5DB5mYm.js} +29 -29
- ksadk/server/static/assets/packet-AYTQ26CC-C7R3NUlK.js +1 -0
- ksadk/server/static/assets/pegDiagram-XKGWAZYB-BQVc9ia_.js +1 -0
- ksadk/server/static/assets/pie-WAS4IAKB-BIT6qjr3.js +1 -0
- ksadk/server/static/assets/pieDiagram-E7YTZNPT-B6UCAvtY.js +39 -0
- ksadk/server/static/assets/{quadrantDiagram-W4KKPZXB-BmkRbwCg.js → quadrantDiagram-AXDQQJYC-mIr2d3eb.js} +6 -6
- ksadk/server/static/assets/radar-RG4KPBEZ-l5noef9X.js +1 -0
- ksadk/server/static/assets/railroad-74A4TZTK-Baea6ZvM.js +1 -0
- ksadk/server/static/assets/railroad-abnf-HS5TGJTU-OKn8zZnU.js +1 -0
- ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-DdKAKC4l.js +1 -0
- ksadk/server/static/assets/railroad-peg-WCYAUIDC-Bds8udlG.js +1 -0
- ksadk/server/static/assets/railroadDiagram-O6MQD6OU-Dt3FFDmK.js +1 -0
- ksadk/server/static/assets/requirementDiagram-EFPCY7ZU-Cz_vQtgF.js +84 -0
- ksadk/server/static/assets/{sankeyDiagram-5OEKKPKP-l6iXmU65.js → sankeyDiagram-P5KCCOFB-wlO1TsH5.js} +7 -7
- ksadk/server/static/assets/{sequenceDiagram-3UESZ5HK-Cq6UBeQB.js → sequenceDiagram-WJ2MYXX4-CHRbElYq.js} +10 -10
- ksadk/server/static/assets/sizeCapture-X5ZJPWSS-DXX54iyO.js +1 -0
- ksadk/server/static/assets/stateDiagram-HBIQ2CUA-Dp_lw9II.js +1 -0
- ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-5b-8o2iS.js +1 -0
- ksadk/server/static/assets/swimlanes-XN3QIQJK-D8O5UlLG.js +1 -0
- ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uf6WPRA4.js +8 -0
- ksadk/server/static/assets/{timeline-definition-PNZ67QCA-DEz24vV0.js → timeline-definition-24CTP7MA-8mfKcxvG.js} +7 -7
- ksadk/server/static/assets/treeView-Q6P3EWNA-CK5CSrSO.js +1 -0
- ksadk/server/static/assets/treemap-WGGIJYW6-Ch2BKgAM.js +1 -0
- ksadk/server/static/assets/vennDiagram-4TSXK5OY-EnNl0DE7.js +34 -0
- ksadk/server/static/assets/wardley-WFR3VGLG-YW3Q0ml_.js +1 -0
- ksadk/server/static/assets/wardleyDiagram-VM6X3IG4-DBu5fbYr.js +78 -0
- ksadk/server/static/assets/xychartDiagram-S5SC5T6Z-BSVXs4IY.js +7 -0
- ksadk/server/static/index.html +2 -2
- ksadk/sessions/__init__.py +26 -9
- ksadk/sessions/_local_service_sync.py +688 -0
- ksadk/sessions/_local_tables.py +21 -0
- ksadk/sessions/_postgres_schema.py +305 -0
- ksadk/sessions/_postgres_tables.py +15 -0
- ksadk/sessions/base.py +80 -1
- ksadk/sessions/in_memory.py +53 -2
- ksadk/sessions/local_service.py +63 -604
- ksadk/sessions/postgres_service.py +58 -148
- ksadk/sessions/resilient.py +35 -1
- ksadk/skills/service_client.py +48 -0
- ksadk/studio/agent_lifecycle.py +26 -20
- ksadk/studio/api.py +1063 -69
- ksadk/studio/api_catalog_routes.py +5 -0
- ksadk/studio/api_contracts.py +148 -6
- ksadk/studio/api_memory_routes.py +82 -0
- ksadk/studio/api_plugin_routes.py +480 -0
- ksadk/studio/attachment_store.py +187 -0
- ksadk/studio/authoring.py +259 -28
- ksadk/studio/authoring_coordinator.py +809 -67
- ksadk/studio/builder.py +197 -40
- ksadk/studio/capabilities.py +17 -0
- ksadk/studio/cloud.py +1920 -95
- ksadk/studio/codex_agent_service.py +137 -15
- ksadk/studio/codex_authoring.py +469 -0
- ksadk/studio/codex_builder.py +177 -25
- ksadk/studio/codex_manifest.py +71 -22
- ksadk/studio/codex_run.py +59 -4
- ksadk/studio/compatibility_report.py +445 -0
- ksadk/studio/compiler.py +7 -1
- ksadk/studio/contracts.py +234 -4
- ksadk/studio/dsh_provider_registration.py +768 -0
- ksadk/studio/event_store.py +79 -101
- ksadk/studio/framework_run.py +264 -3
- ksadk/studio/hosted_kernel.py +317 -0
- ksadk/studio/manifest_resolver.py +131 -0
- ksadk/studio/model_client.py +95 -9
- ksadk/studio/model_profile_service.py +1 -1
- ksadk/studio/operations.py +47 -5
- ksadk/studio/otel_trace.py +348 -42
- ksadk/studio/pcm_memory.py +85 -0
- ksadk/studio/plugin_composition.py +301 -0
- ksadk/studio/plugin_kernel_adapter.py +128 -0
- ksadk/studio/plugin_runtime.py +652 -0
- ksadk/studio/repository.py +23 -2
- ksadk/studio/resource_catalog.py +49 -1
- ksadk/studio/run_service.py +1266 -202
- ksadk/studio/runtime_source.py +51 -17
- ksadk/studio/scheduler_runtime.py +374 -0
- ksadk/studio/scheduler_service.py +211 -0
- ksadk/studio/service.py +1815 -117
- ksadk/studio/shared_web.py +199 -50
- ksadk/studio/soul.py +52 -0
- ksadk/studio/static/assets/index-DXs1Eq4M.css +1 -0
- ksadk/studio/static/assets/index-DeDqwTsD.js +283 -0
- ksadk/studio/static/index.html +2 -2
- ksadk/studio/templates.py +100 -8
- ksadk/studio/validator.py +20 -1
- ksadk/studio/workspace.py +31 -32
- ksadk/tracing/setup.py +304 -3
- ksadk/version.py +1 -1
- ksadk_runtime_common/schemas/runtime_event_v1.json +37 -0
- ksadk_runtime_common/schemas/runtime_event_v2.json +271 -0
- ksadk_runtime_common/workspace_files/path_utils.py +41 -0
- ksadk/events/parser.py +0 -191
- ksadk/server/static/assets/MathMessageMarkdown-DeYh8QPr.css +0 -1
- ksadk/server/static/assets/MermaidBlock-NERD_ef7.js +0 -303
- ksadk/server/static/assets/NativeTerminalPanel-CiHWf82q.js +0 -1
- ksadk/server/static/assets/arc-DrgjcKhl.js +0 -1
- ksadk/server/static/assets/architecture-7EHR7CIX-CpZLRCcY.js +0 -1
- ksadk/server/static/assets/architectureDiagram-3BPJPVTR-BXoVRbQ6.js +0 -36
- ksadk/server/static/assets/blockDiagram-GPEHLZMM-BnaB3Ywv.js +0 -132
- ksadk/server/static/assets/c4Diagram-AAUBKEIU-Dw4weZcp.js +0 -10
- ksadk/server/static/assets/channel-Dt3rQTFI.js +0 -1
- ksadk/server/static/assets/chunk-2J33WTMH-ChjpLK7j.js +0 -1
- ksadk/server/static/assets/chunk-55IACEB6-CK4ROATy.js +0 -1
- ksadk/server/static/assets/chunk-727SXJPM-B9KtTTgw.js +0 -206
- ksadk/server/static/assets/chunk-AQP2D5EJ-1O1mki3m.js +0 -231
- ksadk/server/static/assets/chunk-QZHKN3VN-iXEZtKQc.js +0 -1
- ksadk/server/static/assets/classDiagram-4FO5ZUOK-DIveV17Q.js +0 -1
- ksadk/server/static/assets/classDiagram-v2-Q7XG4LA2-DIveV17Q.js +0 -1
- ksadk/server/static/assets/cytoscape.esm-DelgaX4f.js +0 -321
- ksadk/server/static/assets/dagre-BM42HDAG-D0QXg_MQ.js +0 -4
- ksadk/server/static/assets/dagre-Bx709z4p.js +0 -1
- ksadk/server/static/assets/diagram-2AECGRRQ-DBDDKwBQ.js +0 -43
- ksadk/server/static/assets/diagram-5GNKFQAL-BkwDOxmO.js +0 -10
- ksadk/server/static/assets/diagram-KO2AKTUF-Bv8waYvY.js +0 -3
- ksadk/server/static/assets/diagram-LMA3HP47-e1VECDdu.js +0 -24
- ksadk/server/static/assets/diagram-OG6HWLK6-Ds9adfRl.js +0 -24
- ksadk/server/static/assets/dist-B5J2uhNk.js +0 -1
- ksadk/server/static/assets/erDiagram-TEJ5UH35-BPItFKH6.js +0 -85
- ksadk/server/static/assets/eventmodeling-FCH6USID-DYFSxbqr.js +0 -1
- ksadk/server/static/assets/flowDiagram-I6XJVG4X-BbYB9w5Y.js +0 -162
- ksadk/server/static/assets/ganttDiagram-6RSMTGT7-TQXa0KXv.js +0 -292
- ksadk/server/static/assets/gitGraph-WXDBUCRP-DyNYp6BN.js +0 -1
- ksadk/server/static/assets/gitGraphDiagram-PVQCEYII-bKblCnpa.js +0 -106
- ksadk/server/static/assets/graphlib-B8gBHxth.js +0 -1
- ksadk/server/static/assets/index-R52pJJvg.js +0 -177
- ksadk/server/static/assets/index-jJr3_955.css +0 -2
- ksadk/server/static/assets/info-J43DQDTF-WUx7qTde.js +0 -1
- ksadk/server/static/assets/infoDiagram-5YYISTIA-BGVT7J_i.js +0 -2
- ksadk/server/static/assets/katex-CYWseY5E.js +0 -265
- ksadk/server/static/assets/mermaid-parser.core-BWrDjSZM.js +0 -161
- ksadk/server/static/assets/packet-YPE3B663-BN13y_xl.js +0 -1
- ksadk/server/static/assets/pie-LRSECV5Y-ftSLXhhc.js +0 -1
- ksadk/server/static/assets/pieDiagram-4H26LBE5-GmmqNiVH.js +0 -30
- ksadk/server/static/assets/radar-GUYGQ44K-jaICkIeO.js +0 -1
- ksadk/server/static/assets/requirementDiagram-4Y6WPE33-DSWFqL7c.js +0 -84
- ksadk/server/static/assets/stateDiagram-AJRCARHV-qzTQpg3Y.js +0 -1
- ksadk/server/static/assets/stateDiagram-v2-BHNVJYJU-BYCoYGAN.js +0 -1
- ksadk/server/static/assets/treeView-BLDUP644-Cpib_vlz.js +0 -1
- ksadk/server/static/assets/treemap-LRROVOQU-DQxfmVHK.js +0 -1
- ksadk/server/static/assets/vennDiagram-CIIHVFJN-CMCixki2.js +0 -34
- ksadk/server/static/assets/wardley-L42UT6IY-BQYHnnkU.js +0 -1
- ksadk/server/static/assets/wardleyDiagram-YWT4CUSO-CVzB8F9K.js +0 -78
- ksadk/server/static/assets/xychartDiagram-2RQKCTM6-BFBqBLc1.js +0 -7
- ksadk/studio/evaluation.py +0 -192
- ksadk/studio/static/assets/index-CaEN0eTR.css +0 -1
- ksadk/studio/static/assets/index-DI2eY_NH.js +0 -252
- {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/WHEEL +0 -0
- {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/entry_points.txt +0 -0
- {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/licenses/LICENSE +0 -0
- {agentengine_sdk_python-0.8.1.dist-info → agentengine_sdk_python-0.8.3.dist-info}/top_level.txt +0 -0
ksadk/studio/shared_web.py
CHANGED
|
@@ -9,7 +9,16 @@ from datetime import datetime, timezone
|
|
|
9
9
|
from typing import Any
|
|
10
10
|
from uuid import uuid4
|
|
11
11
|
|
|
12
|
-
from ksadk.
|
|
12
|
+
from ksadk.conversations.contracts import (
|
|
13
|
+
APPROVAL_MODE_EXTENSION,
|
|
14
|
+
COLLABORATION_MODE_EXTENSION,
|
|
15
|
+
GOAL_OBJECTIVE_EXTENSION,
|
|
16
|
+
ConversationAttachmentPart,
|
|
17
|
+
ConversationInput,
|
|
18
|
+
ConversationTextPart,
|
|
19
|
+
validate_conversation_input,
|
|
20
|
+
)
|
|
21
|
+
from ksadk.studio.contracts import OperationStatus, RunRecord, RunStatus
|
|
13
22
|
from ksadk.studio.errors import StudioError, not_found
|
|
14
23
|
from ksadk.studio.service import StudioService
|
|
15
24
|
from ksadk.tools.gateway import tool_approval_capability
|
|
@@ -144,7 +153,7 @@ class StudioSharedWebBridge:
|
|
|
144
153
|
self.studio.event_store.delete_session(session_id)
|
|
145
154
|
return {}
|
|
146
155
|
|
|
147
|
-
def list_messages(
|
|
156
|
+
async def list_messages(
|
|
148
157
|
self,
|
|
149
158
|
session_id: str,
|
|
150
159
|
*,
|
|
@@ -176,7 +185,7 @@ class StudioSharedWebBridge:
|
|
|
176
185
|
"Timestamp": self._timestamp(run.completed_at or run.started_at),
|
|
177
186
|
"SeqId": sequence,
|
|
178
187
|
"InvocationId": run.id,
|
|
179
|
-
"Activities": self._run_activities(run),
|
|
188
|
+
"Activities": await self._run_activities(run),
|
|
180
189
|
}
|
|
181
190
|
)
|
|
182
191
|
|
|
@@ -195,12 +204,12 @@ class StudioSharedWebBridge:
|
|
|
195
204
|
"NextCursor": selected[0]["SeqId"] if has_more and selected else None,
|
|
196
205
|
}
|
|
197
206
|
|
|
198
|
-
def list_session_events(self, session_id: str) -> dict[str, Any]:
|
|
207
|
+
async def list_session_events(self, session_id: str) -> dict[str, Any]:
|
|
199
208
|
runs = self.studio.event_store.list_runs(session_id=session_id)
|
|
200
209
|
events: list[dict[str, Any]] = []
|
|
201
210
|
sequence = 0
|
|
202
211
|
for run in runs:
|
|
203
|
-
for event in self.studio.
|
|
212
|
+
for event in await self.studio.run_service.events(run.id):
|
|
204
213
|
sequence += 1
|
|
205
214
|
events.append(
|
|
206
215
|
{
|
|
@@ -247,11 +256,38 @@ class StudioSharedWebBridge:
|
|
|
247
256
|
prompt = self._input_text(payload)
|
|
248
257
|
runtime_input = self._runtime_input(payload)
|
|
249
258
|
model = self._select_model(agent_id, str(payload.get("Model") or ""))
|
|
259
|
+
model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
|
|
250
260
|
approval_mode = str(payload.get("ApprovalMode") or "")
|
|
251
261
|
collaboration_mode = str(payload.get("CollaborationMode") or "")
|
|
252
262
|
goal_objective = str(payload.get("GoalObjective") or "")
|
|
263
|
+
reasoning_effort = str(payload.get("ReasoningEffort") or "")
|
|
264
|
+
try:
|
|
265
|
+
build = await self._ensure_build(agent_id)
|
|
266
|
+
self._validate_conversation_turn(
|
|
267
|
+
build_id=build.id,
|
|
268
|
+
session_id=session_id,
|
|
269
|
+
invocation_id=invocation_id,
|
|
270
|
+
prompt=prompt,
|
|
271
|
+
runtime_input=runtime_input,
|
|
272
|
+
model=model if model_explicit else "",
|
|
273
|
+
approval_mode=approval_mode,
|
|
274
|
+
collaboration_mode=collaboration_mode,
|
|
275
|
+
goal_objective=goal_objective,
|
|
276
|
+
reasoning_effort=reasoning_effort,
|
|
277
|
+
)
|
|
278
|
+
except StudioError as exc:
|
|
279
|
+
# StreamingResponse starts the HTTP response before advancing this
|
|
280
|
+
# generator. Preflight failures therefore belong in the stream;
|
|
281
|
+
# raising here would turn an actionable Studio error into Starlette's
|
|
282
|
+
# "response already started" RuntimeError.
|
|
283
|
+
yield self._failed_sse(invocation_id, exc.message)
|
|
284
|
+
return
|
|
285
|
+
except Exception:
|
|
286
|
+
yield self._failed_sse(invocation_id, "本地 Agent 运行失败")
|
|
287
|
+
return
|
|
253
288
|
execution = asyncio.create_task(
|
|
254
289
|
self._execute_run(
|
|
290
|
+
build=build,
|
|
255
291
|
agent_id=agent_id,
|
|
256
292
|
session_id=session_id,
|
|
257
293
|
invocation_id=invocation_id,
|
|
@@ -261,6 +297,7 @@ class StudioSharedWebBridge:
|
|
|
261
297
|
approval_mode=approval_mode,
|
|
262
298
|
collaboration_mode=collaboration_mode,
|
|
263
299
|
goal_objective=goal_objective,
|
|
300
|
+
reasoning_effort=reasoning_effort,
|
|
264
301
|
)
|
|
265
302
|
)
|
|
266
303
|
|
|
@@ -290,7 +327,7 @@ class StudioSharedWebBridge:
|
|
|
290
327
|
emitted_text = ""
|
|
291
328
|
idle_polls = 0
|
|
292
329
|
while not execution.done():
|
|
293
|
-
projected = self._project_response_events(
|
|
330
|
+
projected = await self._project_response_events(
|
|
294
331
|
session_id=session_id,
|
|
295
332
|
agent_id=agent_id,
|
|
296
333
|
invocation_id=invocation_id,
|
|
@@ -309,7 +346,7 @@ class StudioSharedWebBridge:
|
|
|
309
346
|
yield ": keep-alive\n\n"
|
|
310
347
|
await asyncio.sleep(0.05)
|
|
311
348
|
run = await execution
|
|
312
|
-
for event_name, event_payload in self._project_response_events(
|
|
349
|
+
for event_name, event_payload in await self._project_response_events(
|
|
313
350
|
session_id=session_id,
|
|
314
351
|
agent_id=agent_id,
|
|
315
352
|
invocation_id=invocation_id,
|
|
@@ -353,20 +390,39 @@ class StudioSharedWebBridge:
|
|
|
353
390
|
session_id = str(payload.get("SessionId") or f"ses_{uuid4().hex}")
|
|
354
391
|
invocation_id = str(payload.get("InvocationId") or f"resp_{uuid4().hex}")
|
|
355
392
|
model = self._select_model(agent_id, str(payload.get("Model") or ""))
|
|
393
|
+
model_explicit = bool(payload.get("ModelExplicit", str(payload.get("Model") or "")))
|
|
356
394
|
approval_mode = str(payload.get("ApprovalMode") or "")
|
|
357
395
|
collaboration_mode = str(payload.get("CollaborationMode") or "")
|
|
358
396
|
goal_objective = str(payload.get("GoalObjective") or "")
|
|
397
|
+
reasoning_effort = str(payload.get("ReasoningEffort") or "")
|
|
398
|
+
build = await self._ensure_build(agent_id)
|
|
399
|
+
prompt = self._input_text(payload)
|
|
400
|
+
runtime_input = self._runtime_input(payload)
|
|
401
|
+
self._validate_conversation_turn(
|
|
402
|
+
build_id=build.id,
|
|
403
|
+
session_id=session_id,
|
|
404
|
+
invocation_id=invocation_id,
|
|
405
|
+
prompt=prompt,
|
|
406
|
+
runtime_input=runtime_input,
|
|
407
|
+
model=model if model_explicit else "",
|
|
408
|
+
approval_mode=approval_mode,
|
|
409
|
+
collaboration_mode=collaboration_mode,
|
|
410
|
+
goal_objective=goal_objective,
|
|
411
|
+
reasoning_effort=reasoning_effort,
|
|
412
|
+
)
|
|
359
413
|
try:
|
|
360
414
|
run = await self._execute_run(
|
|
415
|
+
build=build,
|
|
361
416
|
agent_id=agent_id,
|
|
362
417
|
session_id=session_id,
|
|
363
418
|
invocation_id=invocation_id,
|
|
364
|
-
prompt=
|
|
365
|
-
runtime_input=
|
|
419
|
+
prompt=prompt,
|
|
420
|
+
runtime_input=runtime_input,
|
|
366
421
|
model=model,
|
|
367
422
|
approval_mode=approval_mode,
|
|
368
423
|
collaboration_mode=collaboration_mode,
|
|
369
424
|
goal_objective=goal_objective,
|
|
425
|
+
reasoning_effort=reasoning_effort,
|
|
370
426
|
)
|
|
371
427
|
return self._response_payload(
|
|
372
428
|
run,
|
|
@@ -379,6 +435,7 @@ class StudioSharedWebBridge:
|
|
|
379
435
|
async def _execute_run(
|
|
380
436
|
self,
|
|
381
437
|
*,
|
|
438
|
+
build: Any = None,
|
|
382
439
|
agent_id: str,
|
|
383
440
|
session_id: str,
|
|
384
441
|
invocation_id: str,
|
|
@@ -388,8 +445,19 @@ class StudioSharedWebBridge:
|
|
|
388
445
|
approval_mode: str = "",
|
|
389
446
|
collaboration_mode: str = "",
|
|
390
447
|
goal_objective: str = "",
|
|
448
|
+
reasoning_effort: str = "",
|
|
391
449
|
) -> RunRecord:
|
|
392
|
-
build
|
|
450
|
+
if build is None:
|
|
451
|
+
build = await self._ensure_build(agent_id)
|
|
452
|
+
bound_agent = str(
|
|
453
|
+
getattr(build, "agent_name", None) or getattr(build, "agent_id", "")
|
|
454
|
+
)
|
|
455
|
+
if bound_agent != agent_id:
|
|
456
|
+
raise StudioError(
|
|
457
|
+
"CONVERSATION_BUILD_MISMATCH",
|
|
458
|
+
"会话 Build 不属于当前 Agent",
|
|
459
|
+
status_code=409,
|
|
460
|
+
)
|
|
393
461
|
|
|
394
462
|
def observe(event: Any) -> None:
|
|
395
463
|
if event.type == "run.created":
|
|
@@ -405,6 +473,7 @@ class StudioSharedWebBridge:
|
|
|
405
473
|
approval_mode=approval_mode or None,
|
|
406
474
|
collaboration_mode=collaboration_mode or None,
|
|
407
475
|
goal_objective=goal_objective or None,
|
|
476
|
+
reasoning_effort=reasoning_effort or None,
|
|
408
477
|
runtime_input=runtime_input or None,
|
|
409
478
|
idempotency_key=f"responses:{invocation_id}",
|
|
410
479
|
on_event=observe,
|
|
@@ -434,7 +503,7 @@ class StudioSharedWebBridge:
|
|
|
434
503
|
"output": [],
|
|
435
504
|
}
|
|
436
505
|
|
|
437
|
-
def _project_response_events(
|
|
506
|
+
async def _project_response_events(
|
|
438
507
|
self,
|
|
439
508
|
*,
|
|
440
509
|
session_id: str,
|
|
@@ -449,7 +518,7 @@ class StudioSharedWebBridge:
|
|
|
449
518
|
for run in self.studio.event_store.list_runs(session_id=session_id):
|
|
450
519
|
if run.agent_id != agent_id or run.id != current_run_id:
|
|
451
520
|
continue
|
|
452
|
-
events = self.studio.
|
|
521
|
+
events = await self.studio.run_service.events(run.id)
|
|
453
522
|
starts = {
|
|
454
523
|
str(event.data.get("callId") or event.data.get("call_id") or ""): event.data
|
|
455
524
|
for event in events
|
|
@@ -541,11 +610,11 @@ class StudioSharedWebBridge:
|
|
|
541
610
|
"id": call_id or f"shell_{uuid4().hex}",
|
|
542
611
|
"call_id": call_id,
|
|
543
612
|
"type": "shell_call",
|
|
544
|
-
"status":
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
613
|
+
"status": (
|
|
614
|
+
"failed"
|
|
615
|
+
if event_type.endswith("failed") or data.get("exitCode") not in {None, 0}
|
|
616
|
+
else "completed" if done else "in_progress"
|
|
617
|
+
),
|
|
549
618
|
"action": {
|
|
550
619
|
"commands": [command],
|
|
551
620
|
"cwd": data.get("cwd") or started.get("cwd") or "",
|
|
@@ -562,11 +631,11 @@ class StudioSharedWebBridge:
|
|
|
562
631
|
"type": "function_call",
|
|
563
632
|
"name": name,
|
|
564
633
|
"arguments": json.dumps(args, ensure_ascii=False) if args is not None else "",
|
|
565
|
-
"status":
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
634
|
+
"status": (
|
|
635
|
+
"failed"
|
|
636
|
+
if event_type.endswith("failed")
|
|
637
|
+
else "completed" if done else "in_progress"
|
|
638
|
+
),
|
|
570
639
|
"output": data.get("output") or data.get("result") or "",
|
|
571
640
|
}
|
|
572
641
|
elif event_type == "approval.requested":
|
|
@@ -653,29 +722,94 @@ class StudioSharedWebBridge:
|
|
|
653
722
|
}
|
|
654
723
|
|
|
655
724
|
async def _ensure_build(self, agent_id: str):
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
725
|
+
return await self.studio.ensure_current_build(agent_id)
|
|
726
|
+
|
|
727
|
+
def _validate_conversation_turn(
|
|
728
|
+
self,
|
|
729
|
+
*,
|
|
730
|
+
build_id: str,
|
|
731
|
+
session_id: str,
|
|
732
|
+
invocation_id: str,
|
|
733
|
+
prompt: str,
|
|
734
|
+
runtime_input: Any,
|
|
735
|
+
model: str,
|
|
736
|
+
approval_mode: str,
|
|
737
|
+
collaboration_mode: str,
|
|
738
|
+
goal_objective: str,
|
|
739
|
+
reasoning_effort: str,
|
|
740
|
+
) -> None:
|
|
741
|
+
"""Revalidate compatibility requests against the active Surface.
|
|
742
|
+
|
|
743
|
+
`/v1/responses` and the legacy RunAgent action remain supported wire
|
|
744
|
+
shapes, but neither may smuggle provider-only input past the shared
|
|
745
|
+
ConversationInput contract.
|
|
746
|
+
"""
|
|
747
|
+
|
|
748
|
+
surface = self.studio.conversation_surface(build_id, session_id=session_id)
|
|
749
|
+
parts: list[ConversationTextPart | ConversationAttachmentPart] = [
|
|
750
|
+
ConversationTextPart(text=prompt)
|
|
751
|
+
]
|
|
752
|
+
for index, item in enumerate(runtime_input if isinstance(runtime_input, list) else []):
|
|
753
|
+
if not isinstance(item, dict):
|
|
754
|
+
continue
|
|
755
|
+
kind = str(item.get("type") or "")
|
|
756
|
+
if kind in {"image", "input_image"}:
|
|
757
|
+
media_type = self._data_url_media_type(
|
|
758
|
+
str(item.get("url") or item.get("image_url") or ""),
|
|
759
|
+
fallback="image/*",
|
|
760
|
+
)
|
|
761
|
+
parts.append(
|
|
762
|
+
ConversationAttachmentPart(
|
|
763
|
+
attachment_ref=f"attachment://inline/{invocation_id}/{index}",
|
|
764
|
+
media_type=media_type,
|
|
765
|
+
name=str(item.get("filename") or "image"),
|
|
766
|
+
)
|
|
767
|
+
)
|
|
768
|
+
elif kind == "input_file":
|
|
769
|
+
parts.append(
|
|
770
|
+
ConversationAttachmentPart(
|
|
771
|
+
attachment_ref=f"attachment://inline/{invocation_id}/{index}",
|
|
772
|
+
media_type=self._data_url_media_type(
|
|
773
|
+
str(item.get("file_data") or item.get("file_url") or ""),
|
|
774
|
+
fallback="application/octet-stream",
|
|
775
|
+
),
|
|
776
|
+
name=str(item.get("filename") or "attachment"),
|
|
777
|
+
)
|
|
778
|
+
)
|
|
779
|
+
conversation_input = ConversationInput(
|
|
780
|
+
input_id=invocation_id,
|
|
781
|
+
session_id=session_id,
|
|
782
|
+
idempotency_key=f"responses:{invocation_id}",
|
|
783
|
+
parts=tuple(parts),
|
|
784
|
+
model_ref=model or None,
|
|
785
|
+
reasoning=reasoning_effort or None,
|
|
786
|
+
extensions={
|
|
787
|
+
key: value
|
|
788
|
+
for key, value in (
|
|
789
|
+
(APPROVAL_MODE_EXTENSION, approval_mode or None),
|
|
790
|
+
(COLLABORATION_MODE_EXTENSION, collaboration_mode or None),
|
|
791
|
+
(GOAL_OBJECTIVE_EXTENSION, goal_objective or None),
|
|
792
|
+
)
|
|
793
|
+
if value is not None
|
|
794
|
+
},
|
|
795
|
+
)
|
|
796
|
+
try:
|
|
797
|
+
validate_conversation_input(surface, conversation_input)
|
|
798
|
+
except ValueError as exc:
|
|
671
799
|
raise StudioError(
|
|
672
|
-
"
|
|
673
|
-
"当前 Agent
|
|
674
|
-
"API Key 只提供访问凭证,不会自动绑定模型。",
|
|
800
|
+
"CONVERSATION_INPUT_UNSUPPORTED",
|
|
801
|
+
"当前 Agent 不支持此会话输入",
|
|
675
802
|
status_code=422,
|
|
676
|
-
|
|
677
|
-
)
|
|
678
|
-
|
|
803
|
+
details={"reason": str(exc), "surfaceId": surface.surface_id},
|
|
804
|
+
) from exc
|
|
805
|
+
|
|
806
|
+
@staticmethod
|
|
807
|
+
def _data_url_media_type(value: str, *, fallback: str) -> str:
|
|
808
|
+
if value.startswith("data:"):
|
|
809
|
+
media_type = value[5:].split(";", 1)[0].strip().lower()
|
|
810
|
+
if media_type:
|
|
811
|
+
return media_type
|
|
812
|
+
return fallback
|
|
679
813
|
|
|
680
814
|
def _sessions(self, agent_id: str) -> list[dict[str, Any]]:
|
|
681
815
|
grouped: dict[str, list[RunRecord]] = {}
|
|
@@ -812,7 +946,7 @@ class StudioSharedWebBridge:
|
|
|
812
946
|
model_id = spec.model
|
|
813
947
|
metadata = dict(spec.metadata or {})
|
|
814
948
|
resolved_display_name = display_name or spec.model
|
|
815
|
-
max_output_tokens = spec.parameters.max_tokens
|
|
949
|
+
max_output_tokens = spec.parameters.max_tokens or 4096
|
|
816
950
|
return {
|
|
817
951
|
**metadata,
|
|
818
952
|
"id": model_id,
|
|
@@ -862,10 +996,14 @@ class StudioSharedWebBridge:
|
|
|
862
996
|
def _draft(self, agent_id: str):
|
|
863
997
|
return self.studio.agent_detail(agent_id)["draft"]
|
|
864
998
|
|
|
865
|
-
def _run_activities(self, run: RunRecord) -> list[dict[str, Any]]:
|
|
999
|
+
async def _run_activities(self, run: RunRecord) -> list[dict[str, Any]]:
|
|
866
1000
|
activities: list[dict[str, Any]] = []
|
|
867
|
-
for event in self.studio.
|
|
868
|
-
operations =
|
|
1001
|
+
for event in await self.studio.run_service.events(run.id):
|
|
1002
|
+
operations = (
|
|
1003
|
+
event.data.get("a2uiOperations")
|
|
1004
|
+
or event.data.get("a2ui_operations")
|
|
1005
|
+
or event.data.get("operations")
|
|
1006
|
+
)
|
|
869
1007
|
if not isinstance(operations, list):
|
|
870
1008
|
continue
|
|
871
1009
|
surface_id = str(
|
|
@@ -929,7 +1067,7 @@ class StudioSharedWebBridge:
|
|
|
929
1067
|
if not isinstance(content, list):
|
|
930
1068
|
continue
|
|
931
1069
|
items: list[dict[str, str]] = []
|
|
932
|
-
|
|
1070
|
+
has_attachment = False
|
|
933
1071
|
for part in content:
|
|
934
1072
|
if not isinstance(part, dict):
|
|
935
1073
|
continue
|
|
@@ -944,8 +1082,19 @@ class StudioSharedWebBridge:
|
|
|
944
1082
|
)
|
|
945
1083
|
if url:
|
|
946
1084
|
items.append({"type": "image", "url": url})
|
|
947
|
-
|
|
948
|
-
|
|
1085
|
+
has_attachment = True
|
|
1086
|
+
elif kind == "input_file":
|
|
1087
|
+
data = str(part.get("file_data") or part.get("file_url") or "")
|
|
1088
|
+
if data:
|
|
1089
|
+
items.append(
|
|
1090
|
+
{
|
|
1091
|
+
"type": "input_file",
|
|
1092
|
+
"file_data": data,
|
|
1093
|
+
"filename": str(part.get("filename") or "attachment"),
|
|
1094
|
+
}
|
|
1095
|
+
)
|
|
1096
|
+
has_attachment = True
|
|
1097
|
+
if items and has_attachment:
|
|
949
1098
|
return items
|
|
950
1099
|
return []
|
|
951
1100
|
|
ksadk/studio/soul.py
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
"""Deterministic SoulDocument rendering and prompt compilation helpers."""
|
|
2
|
+
from __future__ import annotations
|
|
3
|
+
|
|
4
|
+
import hashlib
|
|
5
|
+
import json
|
|
6
|
+
|
|
7
|
+
from ksadk.studio.contracts import Instructions, SoulDocument
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def render_soul_markdown(soul: SoulDocument) -> str:
|
|
11
|
+
"""Render a portable ``soul.md`` snapshot without executable directives."""
|
|
12
|
+
|
|
13
|
+
lines = ["# Soul", "", "## Identity", soul.identity.strip()]
|
|
14
|
+
if soul.principles:
|
|
15
|
+
lines.extend(["", "## Principles", *[f"- {item.strip()}" for item in soul.principles]])
|
|
16
|
+
if soul.boundaries:
|
|
17
|
+
lines.extend(["", "## Boundaries", *[f"- {item.strip()}" for item in soul.boundaries]])
|
|
18
|
+
if soul.tone:
|
|
19
|
+
lines.extend(["", "## Tone", soul.tone.strip()])
|
|
20
|
+
return "\n".join(lines).rstrip() + "\n"
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def soul_digest(soul: SoulDocument) -> str:
|
|
24
|
+
"""Content-address the reviewed structured source, not rendered whitespace."""
|
|
25
|
+
|
|
26
|
+
payload = soul.model_dump(by_alias=True, exclude_none=True, mode="json")
|
|
27
|
+
canonical = json.dumps(
|
|
28
|
+
payload, ensure_ascii=False, sort_keys=True, separators=(",", ":")
|
|
29
|
+
).encode("utf-8")
|
|
30
|
+
return f"sha256:{hashlib.sha256(canonical).hexdigest()}"
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
def compose_system_instruction(
|
|
34
|
+
instructions: Instructions, soul: SoulDocument | None
|
|
35
|
+
) -> Instructions:
|
|
36
|
+
"""Put the reviewed identity before mutable task-specific system guidance."""
|
|
37
|
+
|
|
38
|
+
if soul is None:
|
|
39
|
+
return instructions
|
|
40
|
+
soul_section = render_soul_markdown(soul).rstrip()
|
|
41
|
+
system = "\n\n".join(
|
|
42
|
+
part
|
|
43
|
+
for part in (
|
|
44
|
+
soul_section,
|
|
45
|
+
instructions.system.strip(),
|
|
46
|
+
)
|
|
47
|
+
if part
|
|
48
|
+
)
|
|
49
|
+
return instructions.model_copy(update={"system": system})
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
__all__ = ["compose_system_instruction", "render_soul_markdown", "soul_digest"]
|