agentengine-sdk-python 0.8.4__py3-none-any.whl → 0.8.5__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.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/METADATA +6 -3
- {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/RECORD +591 -365
- ksadk/_build_provenance.json +1 -1
- ksadk/_process.py +83 -0
- ksadk/_str_enum.py +17 -0
- ksadk/a2ui/core.py +3 -3
- ksadk/api/client.py +6 -0
- ksadk/builders/code_builder.py +38 -12
- ksadk/builders/framework_requirements.py +20 -2
- ksadk/cli/__init__.py +36 -0
- ksadk/cli/cmd_config.py +4 -4
- ksadk/cli/cmd_create.py +12 -12
- ksadk/cli/cmd_hermes.py +24 -2
- ksadk/cli/cmd_invoke.py +28 -5
- ksadk/cli/cmd_openclaw.py +26 -1
- ksadk/cli/cmd_plugin.py +70 -12
- ksadk/cli/cmd_studio.py +64 -16
- ksadk/cli/openclaw_env.py +1 -1
- ksadk/cli/resource_common.py +26 -0
- ksadk/codex/client.py +3 -2
- ksadk/configs/__init__.py +1 -1
- ksadk/configs/env_registry.py +125 -31
- ksadk/configs/env_registry_studio.py +86 -0
- ksadk/configs/global_config.py +1 -1
- ksadk/configs/settings.py +3 -3
- ksadk/connector/__init__.py +17 -0
- ksadk/connector/channel.py +477 -0
- ksadk/context_engine/capabilities.py +52 -4
- ksadk/conversations/attachment_storage.py +10 -3
- ksadk/conversations/attachments.py +16 -5
- ksadk/conversations/message_projection.py +23 -32
- ksadk/conversations/normalize.py +28 -10
- ksadk/conversations/runtime_baseline.py +37 -0
- ksadk/conversations/runtime_invocation.py +17 -4
- ksadk/conversations/runtime_observability.py +39 -10
- ksadk/conversations/runtime_payloads.py +8 -0
- ksadk/conversations/runtime_persistence.py +105 -9
- ksadk/conversations/runtime_preparation.py +13 -7
- ksadk/conversations/runtime_stream_events.py +29 -35
- ksadk/conversations/runtime_streaming.py +8 -0
- ksadk/events/adapters/_codex_items.py +16 -8
- ksadk/events/adapters/_langgraph_support.py +34 -0
- ksadk/events/session_event.py +2 -2
- ksadk/harness/__init__.py +14 -0
- ksadk/harness/app.py +11 -0
- ksadk/harness/artifact_store.py +213 -0
- ksadk/harness/capabilities.py +115 -0
- ksadk/harness/capability_runtime.py +237 -0
- ksadk/harness/closure_contract.py +92 -0
- ksadk/harness/compaction_record.py +122 -0
- ksadk/harness/compiler.py +284 -0
- ksadk/harness/conformance/__init__.py +33 -0
- ksadk/harness/conformance/contract.py +506 -0
- ksadk/harness/conformance/fixtures.py +102 -0
- ksadk/harness/context_engine.py +403 -0
- ksadk/harness/context_maintenance.py +259 -0
- ksadk/harness/context_manifest.py +188 -0
- ksadk/harness/context_tuning.py +168 -0
- ksadk/harness/draft_runtime.py +322 -0
- ksadk/harness/engine/__init__.py +40 -0
- ksadk/harness/engine/base.py +122 -0
- ksadk/harness/engine/budgets.py +108 -0
- ksadk/harness/engine/capability_declarations.py +59 -0
- ksadk/harness/engine/completion_guard.py +42 -0
- ksadk/harness/engine/context_pipeline.py +579 -0
- ksadk/harness/engine/graph_builder.py +859 -0
- ksadk/harness/engine/langgraph.py +931 -0
- ksadk/harness/engine/mcp_disclosure.py +750 -0
- ksadk/harness/engine/policy_runtime.py +70 -0
- ksadk/harness/engine/postgres_checkpointer.py +63 -0
- ksadk/harness/engine/run_control_bridge.py +80 -0
- ksadk/harness/engine/run_types.py +88 -0
- ksadk/harness/engine/skill_disclosure.py +189 -0
- ksadk/harness/engine/spans.py +41 -0
- ksadk/harness/engine/subagents.py +343 -0
- ksadk/harness/engine/thread_ids.py +112 -0
- ksadk/harness/engine/tool_dispatch.py +144 -0
- ksadk/harness/event_tree.py +212 -0
- ksadk/harness/events.py +461 -0
- ksadk/harness/execution_policy.py +94 -0
- ksadk/harness/insights.py +210 -0
- ksadk/harness/lifecycle.py +578 -0
- ksadk/harness/lifecycle_conformance.py +233 -0
- ksadk/harness/lifecycle_local_plane.py +104 -0
- ksadk/harness/loop/__init__.py +44 -0
- ksadk/harness/loop/reason.py +454 -0
- ksadk/harness/loop/tools.py +762 -0
- ksadk/harness/managed_runtime.py +884 -0
- ksadk/harness/mcp_matrix.py +474 -0
- ksadk/harness/mcp_runtime.py +471 -0
- ksadk/harness/memory_consolidation.py +157 -0
- ksadk/harness/memory_loop.py +156 -0
- ksadk/harness/memory_runtime.py +541 -0
- ksadk/harness/metrics.py +90 -0
- ksadk/harness/model_capability.py +253 -0
- ksadk/harness/model_provider.py +220 -0
- ksadk/harness/observability/__init__.py +29 -0
- ksadk/harness/observability/inspection.py +528 -0
- ksadk/harness/observability/metrics.py +167 -0
- ksadk/harness/observability/otel_exporter.py +218 -0
- ksadk/harness/prompt_cache.py +70 -0
- ksadk/harness/public_activity.py +154 -0
- ksadk/harness/readiness.py +249 -0
- ksadk/harness/reasoner.py +466 -13
- ksadk/harness/release_readiness.py +140 -0
- ksadk/harness/resource_ref.py +69 -0
- ksadk/harness/run_control.py +668 -0
- ksadk/harness/runtime.py +146 -111
- ksadk/harness/runtime_capabilities.py +158 -0
- ksadk/harness/runtime_server.py +514 -0
- ksadk/harness/sandbox_adapters.py +739 -0
- ksadk/harness/sandbox_backend.py +530 -0
- ksadk/harness/sandbox_conformance.py +288 -0
- ksadk/harness/sandbox_lease.py +77 -0
- ksadk/harness/sandbox_lease_conformance.py +259 -0
- ksadk/harness/sandbox_matrix.py +170 -0
- ksadk/harness/sandbox_reconciliation.py +140 -0
- ksadk/harness/sandbox_recovery.py +586 -0
- ksadk/harness/sandbox_recovery_conformance.py +246 -0
- ksadk/harness/session_store.py +243 -0
- ksadk/harness/skill_composition.py +212 -0
- ksadk/harness/skill_feedback.py +123 -0
- ksadk/harness/skill_matrix.py +233 -0
- ksadk/harness/skill_runtime.py +259 -0
- ksadk/harness/spec.py +332 -0
- ksadk/harness/state.py +153 -0
- ksadk/harness/strategies.py +149 -0
- ksadk/harness/subagent.py +253 -0
- ksadk/harness/tool_policy.py +131 -0
- ksadk/harness/tool_receipts.py +96 -0
- ksadk/harness/tool_reliability.py +81 -0
- ksadk/harness/user_errors.py +69 -0
- ksadk/harness/working_context.py +81 -0
- ksadk/harness/working_context_patch.py +99 -0
- ksadk/identity/resolver.py +18 -0
- ksadk/interaction/__init__.py +1 -1
- ksadk/interaction/ledger.py +1 -1
- ksadk/interaction/provider.py +1 -1
- ksadk/interaction/providers/__init__.py +3 -1
- ksadk/interaction/providers/adk.py +1 -1
- ksadk/interaction/providers/codex.py +1 -1
- ksadk/interaction/providers/harness.py +50 -0
- ksadk/interaction/providers/langgraph.py +1 -1
- ksadk/kernel/__init__.py +10 -0
- ksadk/kernel/approval_presentation.py +91 -0
- ksadk/kernel/authorization.py +1 -1
- ksadk/kernel/bootstrap.py +86 -102
- ksadk/kernel/contract_fingerprints.py +1 -1
- ksadk/kernel/contracts.py +5 -0
- ksadk/kernel/control.py +32 -1
- ksadk/kernel/execution_grants.py +221 -0
- ksadk/kernel/execution_grants_memory.py +133 -0
- ksadk/kernel/execution_grants_postgres.py +217 -0
- ksadk/kernel/execution_grants_sqlite.py +209 -0
- ksadk/kernel/ingress.py +27 -27
- ksadk/kernel/mapping.py +1 -1
- ksadk/kernel/memory_store.py +24 -11
- ksadk/kernel/postgres_store.py +63 -33
- ksadk/kernel/recovery.py +78 -14
- ksadk/kernel/sql/001_agent_kernel.sql +23 -0
- ksadk/kernel/sqlite_store.py +304 -25
- ksadk/kernel/state.py +2 -3
- ksadk/kernel/store.py +69 -2
- ksadk/kernel/worker.py +79 -41
- ksadk/kernel/worker_history.py +72 -0
- ksadk/kernel/worker_identity.py +47 -0
- ksadk/memory/coordinator.py +22 -6
- ksadk/memory/extraction.py +40 -1
- ksadk/memory/models.py +77 -1
- ksadk/memory/provider_resolver.py +5 -0
- ksadk/memory/providers/local_postgres.py +200 -0
- ksadk/memory/providers/local_sqlite.py +42 -3
- ksadk/memory/retrieval.py +189 -0
- ksadk/memory/store_adapter.py +150 -0
- ksadk/model_policy.py +2 -2
- ksadk/model_proxy/detect.py +254 -0
- ksadk/model_proxy/server.py +4 -2
- ksadk/model_proxy/transform.py +40 -2
- ksadk/plugins/__init__.py +1 -1
- ksadk/plugins/bridges/dsh.py +11 -0
- ksadk/plugins/builtins.py +40 -2
- ksadk/plugins/companion_artifacts.py +83 -0
- ksadk/plugins/companions.py +368 -0
- ksadk/plugins/contracts.py +1 -1
- ksadk/plugins/dsh_channels.py +156 -0
- ksadk/plugins/dsh_home.py +140 -0
- ksadk/plugins/dsh_teams.py +105 -0
- ksadk/plugins/dsh_toolchain.py +101 -19
- ksadk/plugins/execution_host.py +99 -0
- ksadk/plugins/providers/bundles/dsh-channels-client/client.js +19 -0
- ksadk/plugins/providers/bundles/dsh-channels-client/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-channels-client/index.mjs +7 -0
- ksadk/plugins/providers/bundles/dsh-channels-client/package.json +12 -0
- ksadk/plugins/providers/bundles/dsh-knowledge/package.json +1 -1
- ksadk/plugins/providers/bundles/dsh-memory/package.json +1 -1
- ksadk/plugins/providers/bundles/dsh-skill-center/package.json +1 -1
- ksadk/plugins/providers/bundles/dsh-teams-client/client.js +29 -0
- ksadk/plugins/providers/bundles/dsh-teams-client/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-teams-client/index.mjs +11 -0
- ksadk/plugins/providers/bundles/dsh-teams-client/package.json +35 -0
- ksadk/plugins/providers/bundles/dsh-teams-leader-policy/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-teams-leader-policy/index.mjs +13 -0
- ksadk/plugins/providers/bundles/dsh-teams-leader-policy/package.json +27 -0
- ksadk/plugins/providers/bundles/dsh-teams-profile/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-teams-profile/index.mjs +12 -0
- ksadk/plugins/providers/bundles/dsh-teams-profile/package.json +26 -0
- ksadk/plugins/providers/bundles/dsh-teams-router/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-teams-router/index.mjs +16 -0
- ksadk/plugins/providers/bundles/dsh-teams-router/package.json +27 -0
- ksadk/plugins/providers/bundles/dsh-teams-tasks/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-teams-tasks/index.mjs +16 -0
- ksadk/plugins/providers/bundles/dsh-teams-tasks/package.json +27 -0
- ksadk/plugins/providers/bundles/dsh-teams-tools/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-teams-tools/index.mjs +25 -0
- ksadk/plugins/providers/bundles/dsh-teams-tools/package.json +29 -0
- ksadk/plugins/providers/bundles/dsh-teams-tools/tools.json +235 -0
- ksadk/plugins/providers/bundles/ksadk-codex/index.mjs +1 -1
- ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/index.mjs +51 -1
- ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/package.json +2 -2
- ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/client.mjs +133 -0
- ksadk/plugins/providers/bundles/ksadk-dsh-companion-host/index.mjs +14 -0
- ksadk/plugins/providers/bundles/ksadk-dsh-studio/client.js +27 -4
- ksadk/plugins/providers/bundles/ksadk-dsh-studio/index.mjs +9 -5
- ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +1 -1
- ksadk/plugins/providers/codex.py +10 -2
- ksadk/plugins/providers/dsh_capabilities.py +61 -0
- ksadk/plugins/providers/harness.py +181 -33
- ksadk/plugins/providers/harness_delegation.py +593 -0
- ksadk/plugins/providers/harness_managed.py +456 -0
- ksadk/plugins/providers/harness_tools.py +326 -0
- ksadk/plugins/providers/shipped_dsh.py +4 -1
- ksadk/plugins/subagent_providers/codex.py +28 -6
- ksadk/plugins/teams/__init__.py +5 -0
- ksadk/plugins/teams/api.py +405 -0
- ksadk/plugins/teams/application.py +680 -0
- ksadk/plugins/teams/artifacts.py +60 -0
- ksadk/plugins/teams/context.py +96 -0
- ksadk/plugins/teams/contracts.py +136 -0
- ksadk/plugins/teams/domain.py +1427 -0
- ksadk/plugins/teams/domain_values.py +24 -0
- ksadk/plugins/teams/errors.py +13 -0
- ksadk/plugins/teams/migration.py +311 -0
- ksadk/plugins/teams/migration_cli.py +322 -0
- ksadk/plugins/teams/postgres_store.py +138 -0
- ksadk/plugins/teams/runtime.py +777 -0
- ksadk/plugins/teams/source_projection.py +84 -0
- ksadk/plugins/teams/store.py +311 -0
- ksadk/plugins/teams/task_decisions.py +423 -0
- ksadk/plugins/teams/transport.py +91 -0
- ksadk/plugins/teams/workspaces.py +255 -0
- ksadk/runners/_langgraph_runner_streams.py +121 -45
- ksadk/runners/_langgraph_state_reader.py +106 -0
- ksadk/runners/_session_identity.py +285 -0
- ksadk/runners/adk_runner.py +25 -60
- ksadk/runners/langgraph_runner.py +128 -111
- ksadk/runners/patch_langchain.py +47 -0
- ksadk/runners/usage_accumulator.py +11 -3
- ksadk/runtime/_runner_adapter/stream_mapping.py +52 -2
- ksadk/runtime/conversation_execution.py +25 -1
- ksadk/runtime/executor.py +9 -1
- ksadk/runtime/factory.py +36 -1
- ksadk/runtime/preprocessing.py +11 -3
- ksadk/runtime/runner_adapter.py +38 -9
- ksadk/runtime/skill_eval_result.py +36 -0
- ksadk/runtime/timing.py +46 -0
- ksadk/runtime/usage.py +49 -18
- ksadk/runtime_context.py +103 -1
- ksadk/sandbox/backends/e2b.py +245 -23
- ksadk/sandbox/backends/local_process.py +63 -39
- ksadk/sandbox/base.py +62 -1
- ksadk/sandbox/diagnostics.py +82 -0
- ksadk/sandbox/local_controls.py +746 -0
- ksadk/sandbox/local_launcher.py +90 -0
- ksadk/scheduler/dispatcher.py +1 -1
- ksadk/server/invocation_identity.py +118 -0
- ksadk/server/routes/common.py +32 -3
- ksadk/server/routes/control.py +64 -9
- ksadk/server/routes/dependencies.py +2 -1
- ksadk/server/routes/kernel_ingress.py +9 -1
- ksadk/server/routes/misc.py +233 -25
- ksadk/server/routes/models.py +3 -3
- ksadk/server/routes/openai_compat.py +76 -13
- ksadk/server/routes/run.py +106 -35
- ksadk/server/routes/sessions.py +244 -68
- ksadk/server/routes/workspace.py +130 -21
- ksadk/server/static/assets/{ArtifactsPanel-CGbWlMNh.js → ArtifactsPanel-C1YoaKhx.js} +1 -1
- ksadk/server/static/assets/{CodeBlock-b4C7upmO.js → CodeBlock-DHuAWfr5.js} +10 -7
- ksadk/server/static/assets/MathMessageMarkdown-cvdrBwYr.js +8 -0
- ksadk/server/static/assets/{MermaidBlock-BEBN4Ksz.js → MermaidBlock-DeBkbJvI.js} +9 -9
- ksadk/server/static/assets/{NativeTerminalPanel-zvL-WpAn.js → NativeTerminalPanel-oJj44_sV.js} +1 -1
- ksadk/server/static/assets/{abnfDiagram-VCTEODGH-BYafW7Za.js → abnfDiagram-VCTEODGH-Dhfv25o2.js} +1 -1
- ksadk/server/static/assets/{arc-bTohInsS.js → arc-C35w-pn1.js} +1 -1
- ksadk/server/static/assets/architecture-7GRP2DOG-BCsa26zi.js +1 -0
- ksadk/server/static/assets/{architectureDiagram-5GKGNRK7-Ch5Lbzsi.js → architectureDiagram-5GKGNRK7-FoMY_u6D.js} +1 -1
- ksadk/server/static/assets/{blockDiagram-NRAW4CY4-kqF4MDOG.js → blockDiagram-NRAW4CY4-zD4Rt7oE.js} +1 -1
- ksadk/server/static/assets/{c4Diagram-UCG6FXSJ-8uSRIODv.js → c4Diagram-UCG6FXSJ-BCtGGkhN.js} +1 -1
- ksadk/server/static/assets/channel-_KDifNys.js +1 -0
- ksadk/server/static/assets/chunk-2Q5K7J3B-HdVkJ9F0.js +1 -0
- ksadk/server/static/assets/{chunk-5VM5RSS4-DkhehZDr.js → chunk-5VM5RSS4-C2Ms13_k.js} +1 -1
- ksadk/server/static/assets/{chunk-F27PBJKO-BdXhtPe9.js → chunk-F27PBJKO-BoTj-qgx.js} +1 -1
- ksadk/server/static/assets/{chunk-G27WJ6UU-DPTpvpwi.js → chunk-G27WJ6UU-DOMyyjHH.js} +1 -1
- ksadk/server/static/assets/{chunk-JWPE2WC7-Pqoh38el.js → chunk-JWPE2WC7-DbJJqDli.js} +1 -1
- ksadk/server/static/assets/{chunk-LCL6LL3I-DeU00qC-.js → chunk-LCL6LL3I-CLuRCt_W.js} +1 -1
- ksadk/server/static/assets/{chunk-POPQ4Y6H-CzxScFkr.js → chunk-POPQ4Y6H-D0Dz847e.js} +1 -1
- ksadk/server/static/assets/{chunk-RHFEMEQ7-DpqMx-ux.js → chunk-RHFEMEQ7-BWSRzEcd.js} +1 -1
- ksadk/server/static/assets/{chunk-SVP7TREG-C6t0SypQ.js → chunk-SVP7TREG-CPoHqkCY.js} +1 -1
- ksadk/server/static/assets/{chunk-XXDRQBXY-DVaeafZk.js → chunk-XXDRQBXY-Bx1jS-X-.js} +1 -1
- ksadk/server/static/assets/classDiagram-DTDB5LWJ-BVCW3ZqZ.js +1 -0
- ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-BVCW3ZqZ.js +1 -0
- ksadk/server/static/assets/{cose-bilkent-JH36ORCC-Bf9D3tzJ.js → cose-bilkent-JH36ORCC-LzyWm4m0.js} +1 -1
- ksadk/server/static/assets/cynefin-OW5HDTMX-CNXjFctL.js +1 -0
- ksadk/server/static/assets/{cynefinDiagram-5FMLGOSQ-B9cY3iTz.js → cynefinDiagram-5FMLGOSQ-BlW_bHED.js} +1 -1
- ksadk/server/static/assets/{dagre-3AP2YEHR-CSwlx3CB.js → dagre-3AP2YEHR-Bu_S86_i.js} +1 -1
- ksadk/server/static/assets/{dagre-UBpgon5q.js → dagre-B7nCawed.js} +1 -1
- ksadk/server/static/assets/{diagram-S7CK7UJ4-C9akhN9a.js → diagram-S7CK7UJ4-W_Zow2Km.js} +1 -1
- ksadk/server/static/assets/{diagram-UQ7AKVKN-CgedhTPI.js → diagram-UQ7AKVKN-CLIKAHON.js} +1 -1
- ksadk/server/static/assets/{diagram-VSXAHHWV-Cjucz5BY.js → diagram-VSXAHHWV-Dv6_QAlN.js} +1 -1
- ksadk/server/static/assets/{diagram-VX7I27RA-Dd4Vleyn.js → diagram-VX7I27RA-BWAWRDtZ.js} +1 -1
- ksadk/server/static/assets/{diagram-Z3DM3KII-CZ2jGtYW.js → diagram-Z3DM3KII-XA_rWMss.js} +1 -1
- ksadk/server/static/assets/dist-0X_j2Rcc.js +1 -0
- ksadk/server/static/assets/{dist-DiixqL0J.js → dist-1nXCdsej.js} +1 -1
- ksadk/server/static/assets/{dist-BIr4DSRq.js → dist-2vL2sAdF.js} +1 -1
- ksadk/server/static/assets/{dist-D_ctSS2i.js → dist-B3bA05-e.js} +1 -1
- ksadk/server/static/assets/{dist-ClYUxfeK.js → dist-BLpRy_Yx.js} +1 -1
- ksadk/server/static/assets/{dist-QfkEHOlb.js → dist-BO_UwatH.js} +1 -1
- ksadk/server/static/assets/{dist-B3FR1SKK.js → dist-BdNFAney.js} +1 -1
- ksadk/server/static/assets/{dist-BnaTiyzN.js → dist-C0J5_3qM.js} +1 -1
- ksadk/server/static/assets/{dist-Bj730Ib4.js → dist-CGt_UGeO.js} +1 -1
- ksadk/server/static/assets/{dist-CFzsn6BG.js → dist-CIRMvUM4.js} +1 -1
- ksadk/server/static/assets/{dist-BgV_owcB.js → dist-CIpWk_5f.js} +1 -1
- ksadk/server/static/assets/{dist-C5_ZAZsG.js → dist-CPyieXEf.js} +1 -1
- ksadk/server/static/assets/{dist-btbmmX5O.js → dist-D-92S-Fd.js} +1 -1
- ksadk/server/static/assets/{dist-fBO2v5Kt.js → dist-DNKuMzWc.js} +1 -1
- ksadk/server/static/assets/{dist-ufY3F5p6.js → dist-DWfdmz9s.js} +2 -2
- ksadk/server/static/assets/{dist-DVCOWtha.js → dist-DppE_r-D.js} +1 -1
- ksadk/server/static/assets/{dist-C1NMAY5a.js → dist-DyG6Ya-z.js} +1 -1
- ksadk/server/static/assets/{dist-CB9iJrvg.js → dist-M-SrdhhZ.js} +1 -1
- ksadk/server/static/assets/{dist-DvFK7p5S.js → dist-mqD5TZup.js} +1 -1
- ksadk/server/static/assets/{dist-Cf125P_m.js → dist-n3n6t_FO.js} +1 -1
- ksadk/server/static/assets/{dist-DFD6Qa6T.js → dist-qe8xjesy.js} +1 -1
- ksadk/server/static/assets/{dist-DoVSwoDb.js → dist-t6MzE0jU.js} +1 -1
- ksadk/server/static/assets/{ebnfDiagram-PWID7BFC-Ci8NqqZu.js → ebnfDiagram-PWID7BFC-BfCzF1Xi.js} +1 -1
- ksadk/server/static/assets/{erDiagram-SSCWMZ5O-CCIOhLZG.js → erDiagram-SSCWMZ5O-Dpz9_0zn.js} +1 -1
- ksadk/server/static/assets/eventmodeling-NTZA5JFV-B5-8RH9c.js +1 -0
- ksadk/server/static/assets/flowDiagram-A5DVABFB-BppFxEKw.js +1 -0
- ksadk/server/static/assets/{ganttDiagram-EL5Y4UJY-Cp_r9Hb6.js → ganttDiagram-EL5Y4UJY-DDaG1f4_.js} +1 -1
- ksadk/server/static/assets/gitGraph-4MIJSDKK-B-AhYj4C.js +1 -0
- ksadk/server/static/assets/{gitGraphDiagram-WWUBYQGX-Dlhc8Wr8.js → gitGraphDiagram-WWUBYQGX-DcxzRwYC.js} +1 -1
- ksadk/server/static/assets/index-BMd2mucF.css +2 -0
- ksadk/server/static/assets/index-D5qyyhTH.js +244 -0
- ksadk/server/static/assets/info-A6RAGUB7-0uiKrC35.js +1 -0
- ksadk/server/static/assets/{infoDiagram-RXCK75RN-CO0rRTRA.js → infoDiagram-RXCK75RN-CYMdn6lQ.js} +1 -1
- ksadk/server/static/assets/{ishikawaDiagram-5VMMS53U-CHiaedSS.js → ishikawaDiagram-5VMMS53U-CLHFAD6c.js} +1 -1
- ksadk/server/static/assets/{journeyDiagram-EYS64GPL-CHcCIB09.js → journeyDiagram-EYS64GPL-BHSKQGAl.js} +1 -1
- ksadk/server/static/assets/{kanban-definition-3QL26DDD-CJ_ebBZf.js → kanban-definition-3QL26DDD-D5W3tjTT.js} +1 -1
- ksadk/server/static/assets/{katex-B4weu383.js → katex-mtjOi4KM.js} +1 -1
- ksadk/server/static/assets/{linear-V-MgYHW1.js → linear-BETqsxE_.js} +1 -1
- ksadk/server/static/assets/{mermaid-parser.core-CBijEX_c.js → mermaid-parser.core-DPWrvs90.js} +2 -2
- ksadk/server/static/assets/{mindmap-definition-FBJOCRG2-Bc-pQvpp.js → mindmap-definition-FBJOCRG2-CJG2mfBP.js} +1 -1
- ksadk/server/static/assets/packet-AYTQ26CC-BVTmZ_cw.js +1 -0
- ksadk/server/static/assets/{pegDiagram-XKGWAZYB-D7genGLl.js → pegDiagram-XKGWAZYB-GjAPNaqn.js} +1 -1
- ksadk/server/static/assets/pie-WAS4IAKB-DyfxBU7V.js +1 -0
- ksadk/server/static/assets/{pieDiagram-E7YTZNPT-Bxj32zwD.js → pieDiagram-E7YTZNPT-ToIewrqr.js} +1 -1
- ksadk/server/static/assets/{quadrantDiagram-AXDQQJYC-BURv2mGh.js → quadrantDiagram-AXDQQJYC-4d78KiEY.js} +1 -1
- ksadk/server/static/assets/radar-RG4KPBEZ-FFontjL2.js +1 -0
- ksadk/server/static/assets/railroad-74A4TZTK-D0Uidzen.js +1 -0
- ksadk/server/static/assets/railroad-abnf-HS5TGJTU-BOo_9T2h.js +1 -0
- ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-D6-BjW7Z.js +1 -0
- ksadk/server/static/assets/railroad-peg-WCYAUIDC-CXx__yMm.js +1 -0
- ksadk/server/static/assets/{railroadDiagram-O6MQD6OU-CCsh3avW.js → railroadDiagram-O6MQD6OU-DKzx4xfv.js} +1 -1
- ksadk/server/static/assets/{requirementDiagram-EFPCY7ZU-_FRRBKEd.js → requirementDiagram-EFPCY7ZU-CJYljxQS.js} +1 -1
- ksadk/server/static/assets/{sankeyDiagram-P5KCCOFB-C-gr2o9M.js → sankeyDiagram-P5KCCOFB-DLU2fV1w.js} +1 -1
- ksadk/server/static/assets/{sequenceDiagram-WJ2MYXX4-D97NmfKg.js → sequenceDiagram-WJ2MYXX4-CVqysrA9.js} +1 -1
- ksadk/server/static/assets/{sizeCapture-X5ZJPWSS-DjrPC5FX.js → sizeCapture-X5ZJPWSS-BUxfmTHc.js} +1 -1
- ksadk/server/static/assets/{stateDiagram-HBIQ2CUA-DzMNg1hh.js → stateDiagram-HBIQ2CUA-CNFgYI9E.js} +1 -1
- ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BXAFScz8.js +1 -0
- ksadk/server/static/assets/{swimlanes-XN3QIQJK-Cssf_CsU.js → swimlanes-XN3QIQJK-B6qCMe8N.js} +1 -1
- ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uIQ2lJKH.js +8 -0
- ksadk/server/static/assets/{timeline-definition-24CTP7MA-BWTHzyS1.js → timeline-definition-24CTP7MA-CMD3x_U_.js} +1 -1
- ksadk/server/static/assets/treeView-Q6P3EWNA-CK5GgucZ.js +1 -0
- ksadk/server/static/assets/treemap-WGGIJYW6-Bq1u1SpG.js +1 -0
- ksadk/server/static/assets/{vennDiagram-4TSXK5OY-BSKgJsmR.js → vennDiagram-4TSXK5OY-BqtUqvXM.js} +1 -1
- ksadk/server/static/assets/wardley-WFR3VGLG-QAt06uEz.js +1 -0
- ksadk/server/static/assets/{wardleyDiagram-VM6X3IG4-eflHNoaZ.js → wardleyDiagram-VM6X3IG4-B5KfDjI-.js} +1 -1
- ksadk/server/static/assets/{xychartDiagram-S5SC5T6Z-eYqrQ-v4.js → xychartDiagram-S5SC5T6Z-BaUlSZrn.js} +1 -1
- ksadk/server/static/index.html +2 -2
- ksadk/server/terminal_sessions.py +34 -2
- ksadk/sessions/invocation_identity.py +235 -0
- ksadk/skills/__init__.py +26 -0
- ksadk/skills/events.py +464 -0
- ksadk/skills/manifest_cache.py +263 -0
- ksadk/skills/mcp_server/__init__.py +0 -0
- ksadk/skills/mcp_server/_registry.py +33 -0
- ksadk/skills/mcp_server/_routing.py +26 -0
- ksadk/skills/mcp_server/_workspace_files.py +160 -0
- ksadk/skills/mcp_server/register.py +415 -0
- ksadk/skills/mcp_server/server.py +218 -0
- ksadk/skills/models.py +11 -0
- ksadk/skills/observability.py +132 -0
- ksadk/skills/package_store.py +75 -2
- ksadk/skills/runtime/agent.py +38 -5
- ksadk/skills/runtime/artifacts.py +87 -0
- ksadk/skills/runtime/backends/e2b.py +393 -52
- ksadk/skills/runtime/backends/local.py +621 -119
- ksadk/skills/runtime/base.py +78 -7
- ksadk/skills/runtime/executor.py +266 -1
- ksadk/skills/runtime/loader.py +108 -3
- ksadk/skills/runtime/request.py +18 -0
- ksadk/skills/tool_defs.py +108 -3
- ksadk/studio/api.py +592 -57
- ksadk/studio/api_contracts.py +8 -2
- ksadk/studio/api_plugin_routes.py +39 -12
- ksadk/studio/api_resource_connections.py +79 -41
- ksadk/studio/authoring.py +12 -6
- ksadk/studio/authoring_coordinator.py +4 -2
- ksadk/studio/builder.py +12 -0
- ksadk/studio/capabilities.py +23 -6
- ksadk/studio/channel_connections.py +333 -0
- ksadk/studio/cloud.py +30 -10
- ksadk/studio/cloud_shared_web.py +75 -2
- ksadk/studio/codex_agent_service.py +2 -2
- ksadk/studio/codex_builder.py +1 -1
- ksadk/studio/codex_run.py +6 -1
- ksadk/studio/compiler.py +10 -0
- ksadk/studio/configuration.py +182 -0
- ksadk/studio/contracts.py +33 -5
- ksadk/studio/dsh_application.py +135 -25
- ksadk/studio/dsh_capability_service.py +287 -20
- ksadk/studio/dsh_lifecycle.py +58 -0
- ksadk/studio/dsh_provider_registration.py +55 -16
- ksadk/studio/entry.py +53 -0
- ksadk/studio/event_store.py +36 -5
- ksadk/studio/execution_host.py +525 -0
- ksadk/studio/framework_run.py +32 -10
- ksadk/studio/hosted_kernel.py +1 -1
- ksadk/studio/kernel_registry.py +418 -0
- ksadk/studio/kernel_sqlite_migration.py +181 -0
- ksadk/studio/model_client.py +1178 -64
- ksadk/studio/model_profile_service.py +26 -11
- ksadk/studio/native_documents.py +172 -0
- ksadk/studio/plugin_composition.py +13 -2
- ksadk/studio/plugin_kernel_adapter.py +15 -0
- ksadk/studio/plugin_lifecycle.py +80 -0
- ksadk/studio/plugin_runtime.py +230 -17
- ksadk/studio/provider_recovery.py +59 -0
- ksadk/studio/recovery_page.py +70 -0
- ksadk/studio/resource_authority.py +59 -32
- ksadk/studio/resource_catalog.py +6 -0
- ksadk/studio/run_activity.py +895 -0
- ksadk/studio/run_documents.py +127 -0
- ksadk/studio/run_service.py +329 -33
- ksadk/studio/runtime_catalog.py +53 -10
- ksadk/studio/runtime_source.py +1 -1
- ksadk/studio/scheduler_runtime.py +32 -289
- ksadk/studio/service.py +398 -103
- ksadk/studio/shared_web.py +149 -36
- ksadk/studio/static/assets/ChannelsPage-D_PGmKVq.js +8 -0
- ksadk/studio/static/assets/CodeBlock-DMIf4h33-UIqo-BPW.js +44 -0
- ksadk/studio/static/assets/ExecutionTree-v3HexvPo-Bk8wzGSy.js +1 -0
- ksadk/studio/static/assets/MathMessageMarkdown-BesSeCYl-OhNwH4K9.js +8 -0
- ksadk/studio/static/assets/MermaidBlock-H_0qzQDf-BdXtxug_.js +11 -0
- ksadk/studio/static/assets/MessageMarkdown-CwMTvgFj-g0I-I4dD.js +59 -0
- ksadk/studio/static/assets/PrismRenderer-5pK6tUdb.js +3 -0
- ksadk/studio/static/assets/TeamsPage-DqX4HWKQ.js +3 -0
- ksadk/studio/static/assets/abnfDiagram-VCTEODGH-Bnb1O3tA.js +1 -0
- ksadk/studio/static/assets/architecture-7GRP2DOG-BMOPAkUC.js +1 -0
- ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-5Zn1gqJv.js +36 -0
- ksadk/studio/static/assets/{blockDiagram-I7D4REHJ-CFmPl1de.js → blockDiagram-I7D4REHJ-CLB4L11u.js} +6 -6
- ksadk/studio/static/assets/{c4Diagram-7LVT6UL2-BRrGu8qt.js → c4Diagram-7LVT6UL2-BOma_Z_F.js} +7 -7
- ksadk/studio/static/assets/channel-r8itPEik.js +1 -0
- ksadk/studio/static/assets/chunk-2E4U76K2-BFf_huql.js +2 -0
- ksadk/studio/static/assets/chunk-2ZTRR5NV-C2qZJila.js +2 -0
- ksadk/studio/static/assets/chunk-3Z5EZCMW-DMniOlPd.js +1 -0
- ksadk/studio/static/assets/{chunk-4HAMMTFA-D220vUtq.js → chunk-4HAMMTFA-DVtDP4rm.js} +7 -7
- ksadk/studio/static/assets/chunk-5V3GS4D5-i-ZDOEnP.js +1 -0
- ksadk/studio/static/assets/chunk-6AZGARVD-BB6FqMl-.js +1 -0
- ksadk/studio/static/assets/chunk-6EIED4P4-DdUJkP0f.js +1 -0
- ksadk/studio/static/assets/chunk-6K3QC6MW-CqVsVn-y.js +1 -0
- ksadk/studio/static/assets/chunk-6TQVIW2G-DKlLbNIP.js +1 -0
- ksadk/studio/static/assets/chunk-747NJXEK-BFkZPlab.js +2 -0
- ksadk/studio/static/assets/chunk-75Z2AOVW-BZNhM4vB.js +2 -0
- ksadk/studio/static/assets/chunk-CLGD4ZFX-D-GTtyKs.js +1 -0
- ksadk/studio/static/assets/{chunk-DU6HZSFF-C4DtVpCu.js → chunk-DU6HZSFF-CpEZCUgg.js} +1 -1
- ksadk/studio/static/assets/chunk-F27PBJKO-D7pvKf0C.js +1 -0
- ksadk/studio/static/assets/{chunk-GMAD6QVW-DiQA-u2N.js → chunk-GMAD6QVW-DE_8H717.js} +6 -6
- ksadk/studio/static/assets/chunk-GVQU2GXP-BfEB0lNv.js +1 -0
- ksadk/studio/static/assets/chunk-I5DQTOEV-Hm2LfiYI.js +1 -0
- ksadk/studio/static/assets/chunk-ICYGCRZG-749o-pGJ.js +1 -0
- ksadk/studio/static/assets/chunk-IH6LHLGP-CC6I9F3i.js +1 -0
- ksadk/studio/static/assets/{chunk-IMKFNOWR-BSlbjT_b.js → chunk-IMKFNOWR-D38axYOR.js} +5 -5
- ksadk/studio/static/assets/chunk-KI3K4JFJ-Rma-0k_M.js +1 -0
- ksadk/studio/static/assets/chunk-L3NEJ4N5-Dq5xn7aL.js +1 -0
- ksadk/studio/static/assets/chunk-LNGE3PJU-DWpGwHrW.js +34 -0
- ksadk/studio/static/assets/{chunk-OSK3NFVY-M2m6G3j4.js → chunk-OSK3NFVY-DiCQjx9b.js} +5 -5
- ksadk/studio/static/assets/chunk-OUJLGHUK-D0j2JRSg.js +2 -0
- ksadk/studio/static/assets/{chunk-P2QGCYS3-DezaQxiK.js → chunk-P2QGCYS3-VdhKmfYq.js} +1 -1
- ksadk/studio/static/assets/chunk-POPQ4Y6H-C1_rzO5M.js +1 -0
- ksadk/studio/static/assets/chunk-PWAF6VOD-B45HvflI.js +1 -0
- ksadk/studio/static/assets/{chunk-SHT3W25Y-DAyIVp5H.js → chunk-SHT3W25Y-DsCFnRVE.js} +9 -9
- ksadk/studio/static/assets/{chunk-SVP7TREG-DulomOrS.js → chunk-SVP7TREG-DljApgRX.js} +1 -1
- ksadk/studio/static/assets/{chunk-TICWLB2K-bHJYoflj.js → chunk-TICWLB2K-DWqRtyqa.js} +6 -6
- ksadk/studio/static/assets/chunk-TLUHSLCS-DUeGgnD5.js +2 -0
- ksadk/studio/static/assets/chunk-UY3FDG6J-CnmaAkG5.js +1 -0
- ksadk/studio/static/assets/chunk-XHIXRSVI-BFQ6B8BE.js +1 -0
- ksadk/studio/static/assets/chunk-XXDRQBXY-DqAYeljN.js +1 -0
- ksadk/studio/static/assets/classDiagram-ZZMXUADV-DjeMNJmu.js +1 -0
- ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-DjeMNJmu.js +1 -0
- ksadk/studio/static/assets/clsx-DB0hHKMi.js +1 -0
- ksadk/studio/static/assets/cose-bilkent-JH36ORCC-om8AY0Mc.js +1 -0
- ksadk/studio/static/assets/createLucideIcon-DR0LGTP5.js +1 -0
- ksadk/studio/static/assets/cynefin-OW5HDTMX-7tP7QfM3.js +1 -0
- ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-6BrmK52S.js +62 -0
- ksadk/studio/static/assets/dagre-GXQ25YYZ-buZBRlwz.js +4 -0
- ksadk/studio/static/assets/{diagram-S7CK7UJ4-0BZ98mya.js → diagram-S7CK7UJ4-C6aH78c4.js} +3 -3
- ksadk/studio/static/assets/diagram-UQ7AKVKN-DY_tQ6C_.js +41 -0
- ksadk/studio/static/assets/diagram-VSXAHHWV-DX9p5cQT.js +3 -0
- ksadk/studio/static/assets/diagram-VX7I27RA-DB2WSH8X.js +24 -0
- ksadk/studio/static/assets/diagram-Z3DM3KII-Ce1BJwHE.js +24 -0
- ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-Daukxwqf.js +1 -0
- ksadk/studio/static/assets/{erDiagram-RLTQ6QDP-DLGry2Ap.js → erDiagram-RLTQ6QDP-CGthTMmJ.js} +6 -6
- ksadk/studio/static/assets/eventmodeling-NTZA5JFV-BR2FzK4R.js +1 -0
- ksadk/studio/static/assets/flowDiagram-HODETNUW-CZ1tEenp.js +1 -0
- ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BfoAZW9X.js +292 -0
- ksadk/studio/static/assets/gitGraph-4MIJSDKK-DYlXv_yJ.js +1 -0
- ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-S985OIJF.js +106 -0
- ksadk/studio/static/assets/iconfont-4HN3C9Pg.woff2 +0 -0
- ksadk/studio/static/assets/index-CfEnms6Y.css +2 -0
- ksadk/studio/static/assets/index-Dp61rOWZ.js +0 -0
- ksadk/studio/static/assets/index.dom-BQenBtFm.js +1 -0
- ksadk/studio/static/assets/info-A6RAGUB7-BlU-8_xu.js +1 -0
- ksadk/studio/static/assets/infoDiagram-27XIBGKW-CO3W8tFn.js +2 -0
- ksadk/studio/static/assets/{ishikawaDiagram-5VMMS53U-CljI2wyf.js → ishikawaDiagram-5VMMS53U-BUGEl8cO.js} +2 -2
- ksadk/studio/static/assets/{journeyDiagram-3NMN7TZE-D50Fo2sL.js → journeyDiagram-3NMN7TZE-Ch2ZYxvr.js} +6 -6
- ksadk/studio/static/assets/{kanban-definition-UXKFOSKX-DimfOTam.js → kanban-definition-UXKFOSKX-Da-Fp4vC.js} +3 -3
- ksadk/studio/static/assets/kingsoft-cloud-BOcLiQ3e.ico +0 -0
- ksadk/studio/static/assets/{line-CX5BOOUP.js → line-BDaeq300.js} +1 -1
- ksadk/studio/static/assets/linear-DmucvK78.js +1 -0
- ksadk/studio/static/assets/mermaid-parser.core-Cj5mYdBi.js +4 -0
- ksadk/studio/static/assets/{mindmap-definition-YA3MSWOX-Bizzqy5R.js → mindmap-definition-YA3MSWOX-CvlsVQ38.js} +1 -1
- ksadk/studio/static/assets/packet-AYTQ26CC-BSJEH9Lb.js +1 -0
- ksadk/studio/static/assets/pegDiagram-XKGWAZYB-BuHuNgT5.js +1 -0
- ksadk/studio/static/assets/pie-WAS4IAKB-qxv01Y8W.js +1 -0
- ksadk/studio/static/assets/{pieDiagram-E7YTZNPT-B9mrFSDF.js → pieDiagram-E7YTZNPT-DlrWiSOv.js} +1 -1
- ksadk/studio/static/assets/preload-helper-CO68xz6u.js +1 -0
- ksadk/studio/static/assets/presentation-yYw7xK60-BmcZriri.js +1 -0
- ksadk/studio/static/assets/{quadrantDiagram-AXDQQJYC-NzUfCbMR.js → quadrantDiagram-AXDQQJYC-BA3hpUZM.js} +6 -6
- ksadk/studio/static/assets/radar-RG4KPBEZ-B6h6pWOs.js +1 -0
- ksadk/studio/static/assets/railroad-74A4TZTK-CGtTWdGc.js +1 -0
- ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-Cq7y22IA.js +1 -0
- ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-V0aQVv9m.js +1 -0
- ksadk/studio/static/assets/railroad-peg-WCYAUIDC-BQiIsX_p.js +1 -0
- ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-BxpAazym.js +1 -0
- ksadk/studio/static/assets/{requirementDiagram-BXWQKSXE-BF3d103U.js → requirementDiagram-BXWQKSXE-E-Ge0FcV.js} +1 -1
- ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-CA6YKhQ3.js +40 -0
- ksadk/studio/static/assets/{sequenceDiagram-WJ2MYXX4-Dh4wZtUm.js → sequenceDiagram-WJ2MYXX4-CcElXGg4.js} +9 -9
- ksadk/studio/static/assets/src-B6xuSHsQ.js +1 -0
- ksadk/studio/static/assets/stateDiagram-D77RDMKH-DdXZOFqY.js +1 -0
- ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-CJbOM-QK.js +1 -0
- ksadk/studio/static/assets/swimlanes-42K2YHIH-NtgEEHLY.js +1 -0
- ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-D-AVlW8B.js +8 -0
- ksadk/studio/static/assets/{timeline-definition-24CTP7MA-DxmSSjRB.js → timeline-definition-24CTP7MA-CIuYhNy3.js} +7 -7
- ksadk/studio/static/assets/treeView-Q6P3EWNA-BTTYcvrF.js +1 -0
- ksadk/studio/static/assets/treemap-WGGIJYW6-Cg7tyfH8.js +1 -0
- ksadk/studio/static/assets/vennDiagram-4TSXK5OY-7HbApbrv.js +34 -0
- ksadk/studio/static/assets/wardley-WFR3VGLG-C6N1rULY.js +1 -0
- ksadk/studio/static/assets/{wardleyDiagram-VM6X3IG4-Ba1AOWoe.js → wardleyDiagram-VM6X3IG4-CMJiaedy.js} +1 -1
- ksadk/studio/static/assets/{xychartDiagram-S5SC5T6Z-Cr5pt5Y-.js → xychartDiagram-S5SC5T6Z-BdgtMvW2.js} +6 -6
- ksadk/studio/static/index.html +8 -2
- ksadk/studio/teams_catalog.py +133 -0
- ksadk/studio/teams_installation.py +214 -0
- ksadk/studio/teams_node.py +545 -0
- ksadk/studio/teams_node_runner.py +69 -0
- ksadk/studio/teams_remote.py +274 -0
- ksadk/studio/templates.py +40 -19
- ksadk/studio/validator.py +13 -0
- ksadk/studio/workspace.py +19 -4
- ksadk/studio/workspace_plugins.py +136 -0
- ksadk/studio/workspace_registry.py +286 -0
- ksadk/toolsets/__init__.py +11 -0
- ksadk/toolsets/skills.py +446 -378
- ksadk/toolsets/workspace.py +3 -3
- ksadk/toolsets/workspace_identity.py +15 -0
- ksadk/version.py +1 -1
- ksadk_runtime_common/memory_backend/providers/lancedb.py +56 -2
- ksadk_runtime_common/schemas/memory_backend_manifest.schema.json +148 -148
- ksadk_runtime_common/workspace_files/router.py +26 -13
- ksadk/server/static/assets/MathMessageMarkdown-DbdW5A4_.js +0 -8
- ksadk/server/static/assets/architecture-7GRP2DOG-BW5UtSnx.js +0 -1
- ksadk/server/static/assets/channel-CF5Up3hQ.js +0 -1
- ksadk/server/static/assets/chunk-2Q5K7J3B-KkXX47WI.js +0 -1
- ksadk/server/static/assets/classDiagram-DTDB5LWJ-Cz81acRQ.js +0 -1
- ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Cz81acRQ.js +0 -1
- ksadk/server/static/assets/cynefin-OW5HDTMX-DVWs8a2t.js +0 -1
- ksadk/server/static/assets/dist-B2_CVgKv.js +0 -1
- ksadk/server/static/assets/eventmodeling-NTZA5JFV-CQqR2hg3.js +0 -1
- ksadk/server/static/assets/flowDiagram-A5DVABFB-DDRRbGPm.js +0 -1
- ksadk/server/static/assets/gitGraph-4MIJSDKK-fgWEf7UD.js +0 -1
- ksadk/server/static/assets/index-DcTML1Up.css +0 -2
- ksadk/server/static/assets/index-Dh2XHqPK.js +0 -244
- ksadk/server/static/assets/info-A6RAGUB7-BUecLTdt.js +0 -1
- ksadk/server/static/assets/packet-AYTQ26CC-BeW-btFv.js +0 -1
- ksadk/server/static/assets/pie-WAS4IAKB-X0xh4SaT.js +0 -1
- ksadk/server/static/assets/radar-RG4KPBEZ-DzRMSqjd.js +0 -1
- ksadk/server/static/assets/railroad-74A4TZTK-Cc44icX-.js +0 -1
- ksadk/server/static/assets/railroad-abnf-HS5TGJTU-D6S4BdV-.js +0 -1
- ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-vD3aVE2o.js +0 -1
- ksadk/server/static/assets/railroad-peg-WCYAUIDC-CYbW_b4T.js +0 -1
- ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BIcjKFhF.js +0 -1
- ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-tq3K3Ybl.js +0 -8
- ksadk/server/static/assets/treeView-Q6P3EWNA-DBXt3GdU.js +0 -1
- ksadk/server/static/assets/treemap-WGGIJYW6-DrCy4E_l.js +0 -1
- ksadk/server/static/assets/wardley-WFR3VGLG-CefhOliM.js +0 -1
- ksadk/studio/static/assets/CodeBlock-DCUUY0PL-BLjA7kbS.js +0 -41
- ksadk/studio/static/assets/MathMessageMarkdown-CBcDrAw--CUYIXwgI.js +0 -8
- ksadk/studio/static/assets/MermaidBlock-DBFTztfQ-BTYKWEbD.js +0 -44
- ksadk/studio/static/assets/PrismRenderer-wiXRHURw.js +0 -3
- ksadk/studio/static/assets/abnfDiagram-VCTEODGH-CLETGjKq.js +0 -1
- ksadk/studio/static/assets/architecture-7GRP2DOG-hXMiO_AU.js +0 -1
- ksadk/studio/static/assets/architectureDiagram-5GKGNRK7-B5EQysk6.js +0 -36
- ksadk/studio/static/assets/channel-BqO-gtEw.js +0 -1
- ksadk/studio/static/assets/chunk-75Z2AOVW-C8lLv_qc.js +0 -2
- ksadk/studio/static/assets/chunk-F27PBJKO-Cpw14SNG.js +0 -1
- ksadk/studio/static/assets/chunk-GVQU2GXP-DUdNBUCi.js +0 -1
- ksadk/studio/static/assets/chunk-L3NEJ4N5-Db8Ab22W.js +0 -1
- ksadk/studio/static/assets/chunk-POPQ4Y6H-DOpufJ3t.js +0 -1
- ksadk/studio/static/assets/chunk-PWAF6VOD-CfLb1gSc.js +0 -1
- ksadk/studio/static/assets/chunk-XXDRQBXY-7PcdR2B1.js +0 -1
- ksadk/studio/static/assets/classDiagram-ZZMXUADV-D_bW8JjA.js +0 -1
- ksadk/studio/static/assets/classDiagram-v2-VYDZK3BY-D_bW8JjA.js +0 -1
- ksadk/studio/static/assets/cose-bilkent-JH36ORCC-snL88wkX.js +0 -1
- ksadk/studio/static/assets/cynefin-OW5HDTMX-Bd1YhRo1.js +0 -1
- ksadk/studio/static/assets/cynefinDiagram-5FMLGOSQ-BBrIG_mI.js +0 -62
- ksadk/studio/static/assets/dagre-GXQ25YYZ-DtF1nGdY.js +0 -4
- ksadk/studio/static/assets/diagram-UQ7AKVKN-6mLKEo6L.js +0 -41
- ksadk/studio/static/assets/diagram-VSXAHHWV-CJBIaiZ2.js +0 -3
- ksadk/studio/static/assets/diagram-VX7I27RA-BohLEE1C.js +0 -24
- ksadk/studio/static/assets/diagram-Z3DM3KII-D8KIGonG.js +0 -24
- ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-C99HU61t.js +0 -1
- ksadk/studio/static/assets/eventmodeling-NTZA5JFV-B1_5Ac8j.js +0 -1
- ksadk/studio/static/assets/flowDiagram-HODETNUW-DD5hmicn.js +0 -1
- ksadk/studio/static/assets/ganttDiagram-EL5Y4UJY-BPJrVLSG.js +0 -292
- ksadk/studio/static/assets/gitGraph-4MIJSDKK-Cy_ZQBGi.js +0 -1
- ksadk/studio/static/assets/gitGraphDiagram-WWUBYQGX-CZCUz4MT.js +0 -106
- ksadk/studio/static/assets/index-CeHL9ARV.css +0 -2
- ksadk/studio/static/assets/index-D9QEcVpL.js +0 -320
- ksadk/studio/static/assets/info-A6RAGUB7-DBzDQB_I.js +0 -1
- ksadk/studio/static/assets/infoDiagram-27XIBGKW-B-sq07Hi.js +0 -2
- ksadk/studio/static/assets/linear-BCxN9JLv.js +0 -1
- ksadk/studio/static/assets/mermaid-parser.core-BdCz8fkS.js +0 -7
- ksadk/studio/static/assets/packet-AYTQ26CC-gPln-_kG.js +0 -1
- ksadk/studio/static/assets/pegDiagram-XKGWAZYB-Dy3fB-gW.js +0 -1
- ksadk/studio/static/assets/pie-WAS4IAKB-qZdHMr7B.js +0 -1
- ksadk/studio/static/assets/radar-RG4KPBEZ-BZlnaea9.js +0 -1
- ksadk/studio/static/assets/railroad-74A4TZTK-Ce3__H9c.js +0 -1
- ksadk/studio/static/assets/railroad-abnf-HS5TGJTU-DqQn7EzD.js +0 -1
- ksadk/studio/static/assets/railroad-ebnf-LZEXJU2U-B55kCA8F.js +0 -1
- ksadk/studio/static/assets/railroad-peg-WCYAUIDC-DfQnvkHd.js +0 -1
- ksadk/studio/static/assets/railroadDiagram-O6MQD6OU-DnhMjZCk.js +0 -1
- ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-Bo-JTwt0.js +0 -40
- ksadk/studio/static/assets/src-SFn9St9H.js +0 -1
- ksadk/studio/static/assets/stateDiagram-D77RDMKH-DH774G6d.js +0 -1
- ksadk/studio/static/assets/stateDiagram-v2-MP3YSRHH-DZvVWPBo.js +0 -1
- ksadk/studio/static/assets/swimlanes-42K2YHIH-Bl13OvTX.js +0 -1
- ksadk/studio/static/assets/swimlanesDiagram-VR7AAH4N-BnFOTALJ.js +0 -8
- ksadk/studio/static/assets/treeView-Q6P3EWNA-D5Nn9Swz.js +0 -1
- ksadk/studio/static/assets/treemap-WGGIJYW6-CgHgnQhE.js +0 -1
- ksadk/studio/static/assets/vennDiagram-4TSXK5OY-B9QEXcJq.js +0 -34
- ksadk/studio/static/assets/wardley-WFR3VGLG-DXrK2RRY.js +0 -1
- {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/WHEEL +0 -0
- {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/entry_points.txt +0 -0
- {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/licenses/LICENSE +0 -0
- {agentengine_sdk_python-0.8.4.dist-info → agentengine_sdk_python-0.8.5.dist-info}/top_level.txt +0 -0
- /ksadk/studio/static/assets/{MathMessageMarkdown-CBcDrAw--BEOyPC3w.css → MathMessageMarkdown-BesSeCYl-BEOyPC3w.css} +0 -0
|
@@ -0,0 +1,579 @@
|
|
|
1
|
+
"""Managed Engine 的 Context 构建管线(长任务方案 §6 / §8)。
|
|
2
|
+
|
|
3
|
+
从 ``engine/langgraph.py`` 抽出(模块体量守卫):规划 → 主动/紧急压缩 →
|
|
4
|
+
组装 → ContextManifest/context.built 投影,以及压缩前受控 Memory Flush。
|
|
5
|
+
事件落账统一走引擎注入的 ``event_fn``(保证 seq 单调与信封一致)。
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
from typing import Any, Callable
|
|
11
|
+
|
|
12
|
+
from ksadk.harness.compaction_record import build_compaction_record
|
|
13
|
+
from ksadk.harness.events import EventType, RuntimeEvent
|
|
14
|
+
from ksadk.harness.loop import ModelFailoverExhausted, ReasonInput, reason_turn_async
|
|
15
|
+
from ksadk.harness.state import Message, MessageRole
|
|
16
|
+
|
|
17
|
+
#: 事件构造函数签名(引擎的 _event)。
|
|
18
|
+
EventFn = Callable[..., RuntimeEvent]
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
class EngineContextPipeline:
|
|
22
|
+
"""ContextEngine 的运行时编排:规划、压缩、组装、Manifest 投影。"""
|
|
23
|
+
|
|
24
|
+
def __init__(
|
|
25
|
+
self,
|
|
26
|
+
*,
|
|
27
|
+
context_engine: Any,
|
|
28
|
+
reasoner: Any,
|
|
29
|
+
event_fn: EventFn,
|
|
30
|
+
memory_runtime: Any | None = None,
|
|
31
|
+
prompt_cache_tracker: Any | None = None,
|
|
32
|
+
) -> None:
|
|
33
|
+
self._context_engine = context_engine
|
|
34
|
+
self._reasoner = reasoner
|
|
35
|
+
self._event = event_fn
|
|
36
|
+
self._memory_runtime = memory_runtime
|
|
37
|
+
self._prompt_cache_tracker = prompt_cache_tracker
|
|
38
|
+
|
|
39
|
+
# ------------------------------------------------------------ 主入口
|
|
40
|
+
|
|
41
|
+
async def prepare_context(self, run: Any, instructions: str) -> list[dict[str, Any]] | None:
|
|
42
|
+
"""ContextEngine 真正控制首次模型输入(收口 1)。
|
|
43
|
+
|
|
44
|
+
规划 → 超过主动阈值(Spec context_policy)先主动压缩 → 仍超预算做一次
|
|
45
|
+
紧急压缩(只允许一次,§8.4)→ 组装为 Chat 输入。未注入 ContextEngine 时
|
|
46
|
+
返回 None(回退旧拼接路径)。
|
|
47
|
+
"""
|
|
48
|
+
from ksadk.harness.context_engine import ContextEngineError
|
|
49
|
+
|
|
50
|
+
history = run.request.metadata.get("conversation_history") or []
|
|
51
|
+
messages = [
|
|
52
|
+
Message(
|
|
53
|
+
role=MessageRole(m.get("role", "user")),
|
|
54
|
+
content=str(m.get("content") or ""),
|
|
55
|
+
tool_call_id=str(m["tool_call_id"]) if m.get("tool_call_id") else None,
|
|
56
|
+
name=str(m["name"]) if m.get("name") else None,
|
|
57
|
+
)
|
|
58
|
+
for m in history
|
|
59
|
+
if isinstance(m, dict) and m.get("role") in {"user", "assistant", "system"}
|
|
60
|
+
]
|
|
61
|
+
current_input = str(run.request.input or "")
|
|
62
|
+
# Studio/Draft 会把本轮输入同时放进 request.input 和历史末尾。历史副本
|
|
63
|
+
# 不能继续作为可丢弃 history_round 参与规划,否则超大本轮输入会在
|
|
64
|
+
# Planner 限额时被静默裁掉。只移除重复副本,本轮输入始终以 required
|
|
65
|
+
# current_input 单独进入 ContextPlan。
|
|
66
|
+
if (
|
|
67
|
+
current_input
|
|
68
|
+
and messages
|
|
69
|
+
and messages[-1].role is MessageRole.USER
|
|
70
|
+
and messages[-1].content == current_input
|
|
71
|
+
):
|
|
72
|
+
messages = messages[:-1]
|
|
73
|
+
# 长任务方案 §9:recall_memory_and_knowledge——规划前检索长期 Memory,
|
|
74
|
+
# 命中以 system 段注入(planner 按 history_system 高优先级保留)。
|
|
75
|
+
messages = self._recall_memory(run, messages) + messages
|
|
76
|
+
window, source = self._resolve_window(run)
|
|
77
|
+
plan = self._plan_context(run, messages, current_input=current_input)
|
|
78
|
+
self._emit_planned(run, plan, window, source)
|
|
79
|
+
policy = run.compiled.spec.context_policy
|
|
80
|
+
max_input = plan.budget.max_input_tokens
|
|
81
|
+
|
|
82
|
+
if plan.planned_input_tokens > int(policy.proactive_compaction_threshold * max_input) or (
|
|
83
|
+
# Planner 丢弃了历史轮次(静默丢上下文)→ 主动压缩以摘要保住事实。
|
|
84
|
+
any(d.action == "dropped" and d.item_id.startswith("history") for d in plan.decisions)
|
|
85
|
+
):
|
|
86
|
+
compacted = await self._compact_history(
|
|
87
|
+
run, messages, trigger="proactive", keep_recent=6, budget_tokens=max_input
|
|
88
|
+
)
|
|
89
|
+
if compacted is not None:
|
|
90
|
+
messages = compacted
|
|
91
|
+
plan = self._plan_context(run, messages, current_input=current_input)
|
|
92
|
+
self._emit_planned(run, plan, window, source)
|
|
93
|
+
max_input = plan.budget.max_input_tokens
|
|
94
|
+
|
|
95
|
+
if plan.planned_input_tokens > max_input:
|
|
96
|
+
# 紧急压缩(§8.4):更强压缩,只允许一次。
|
|
97
|
+
compacted = await self._compact_history(
|
|
98
|
+
run, messages, trigger="emergency", keep_recent=2, budget_tokens=max_input
|
|
99
|
+
)
|
|
100
|
+
if compacted is not None:
|
|
101
|
+
messages = compacted
|
|
102
|
+
plan = self._plan_context(run, messages, current_input=current_input)
|
|
103
|
+
self._emit_planned(run, plan, window, source)
|
|
104
|
+
run.events.append(
|
|
105
|
+
self._event(
|
|
106
|
+
run,
|
|
107
|
+
EventType.CONTEXT_RECOVERED,
|
|
108
|
+
{"reason": "context_overflow", "trigger": "emergency"},
|
|
109
|
+
)
|
|
110
|
+
)
|
|
111
|
+
if plan.planned_input_tokens > plan.budget.max_input_tokens:
|
|
112
|
+
current_tokens = count_tokens(current_input)
|
|
113
|
+
raise ContextEngineError(
|
|
114
|
+
"紧急压缩后仍超出输入预算;本轮用户输入不会被静默丢弃: "
|
|
115
|
+
f"planned_input_tokens={plan.planned_input_tokens}, "
|
|
116
|
+
f"current_input_tokens={current_tokens}, "
|
|
117
|
+
f"max_input_tokens={plan.budget.max_input_tokens}"
|
|
118
|
+
)
|
|
119
|
+
|
|
120
|
+
assembled = self._context_engine.assemble_chat(plan)
|
|
121
|
+
if not assembled.messages or assembled.messages[0].get("role") != "system":
|
|
122
|
+
assembled.messages.insert(0, {"role": "system", "content": instructions})
|
|
123
|
+
# 长任务方案 §6.2:Manifest 可观测快照 + context.built(Planned/Projected;
|
|
124
|
+
# Actual 由 usage 回填)。正文不入 Manifest,只记 Hash/引用/Token。
|
|
125
|
+
projected = sum(count_tokens(str(m.get("content") or "")) for m in assembled.messages)
|
|
126
|
+
self._emit_context_built(run, plan, projected, window)
|
|
127
|
+
return assembled.messages
|
|
128
|
+
|
|
129
|
+
async def recover_model_overflow(
|
|
130
|
+
self,
|
|
131
|
+
run: Any,
|
|
132
|
+
messages: list[dict[str, Any]],
|
|
133
|
+
instructions: str,
|
|
134
|
+
) -> list[dict[str, Any]]:
|
|
135
|
+
"""模型明确拒绝上下文后执行一次更强压缩并重建输入。
|
|
136
|
+
|
|
137
|
+
这是 provider 真实 overflow 的恢复路径,不是首次调用前的预算预测。
|
|
138
|
+
重试预算保存在 HarnessState,避免模型/备用模型之间形成无限循环;
|
|
139
|
+
最近 Tool Call/Result 作为完整尾部原样保留,不能被重建成残缺消息。
|
|
140
|
+
"""
|
|
141
|
+
from ksadk.harness.context_engine import ContextEngineError
|
|
142
|
+
|
|
143
|
+
retries = run.state.retry_state.emergency_compaction_retries
|
|
144
|
+
limit = run.compiled.spec.context_policy.emergency_retry_limit
|
|
145
|
+
if retries >= limit:
|
|
146
|
+
raise ContextEngineError(
|
|
147
|
+
f"模型上下文溢出已执行 {retries} 次紧急压缩,达到上限 {limit}"
|
|
148
|
+
)
|
|
149
|
+
|
|
150
|
+
# Stable Prompt 是高信任、不参与摘要的固定前缀;只压缩其后的动态消息。
|
|
151
|
+
stable_prefix: list[dict[str, Any]] = []
|
|
152
|
+
dynamic_messages = messages
|
|
153
|
+
if messages and str(messages[0].get("role") or "") == "system":
|
|
154
|
+
stable_prefix = [dict(messages[0])]
|
|
155
|
+
dynamic_messages = messages[1:]
|
|
156
|
+
converted = [_chat_message(message) for message in dynamic_messages]
|
|
157
|
+
# 保留至少最后两条,并把边界向前移动到 Tool Pair 之前。
|
|
158
|
+
cutoff = max(0, len(dynamic_messages) - 2)
|
|
159
|
+
while cutoff > 0 and str(dynamic_messages[cutoff].get("role") or "") == "tool":
|
|
160
|
+
cutoff -= 1
|
|
161
|
+
if cutoff <= 0:
|
|
162
|
+
raise ContextEngineError("上下文溢出但没有可继续压缩的历史消息")
|
|
163
|
+
|
|
164
|
+
run.state.retry_state = run.state.retry_state.model_copy(
|
|
165
|
+
update={
|
|
166
|
+
"emergency_compaction_retries": retries + 1,
|
|
167
|
+
"last_error_kind": "context_length",
|
|
168
|
+
}
|
|
169
|
+
)
|
|
170
|
+
compacted = await self._compact_history(
|
|
171
|
+
run,
|
|
172
|
+
converted,
|
|
173
|
+
trigger="emergency",
|
|
174
|
+
keep_recent=len(dynamic_messages) - cutoff,
|
|
175
|
+
budget_tokens=self._plan_context(run, converted).budget.max_input_tokens,
|
|
176
|
+
)
|
|
177
|
+
if compacted is None:
|
|
178
|
+
raise ContextEngineError("上下文溢出但紧急压缩没有产生新输入")
|
|
179
|
+
|
|
180
|
+
summary = compacted[0].content
|
|
181
|
+
recovered: list[dict[str, Any]] = list(stable_prefix)
|
|
182
|
+
recovered.append({"role": "system", "content": summary})
|
|
183
|
+
recovered.extend(dict(message) for message in dynamic_messages[cutoff:])
|
|
184
|
+
if not recovered or recovered[0].get("role") != "system":
|
|
185
|
+
recovered.insert(0, {"role": "system", "content": instructions})
|
|
186
|
+
|
|
187
|
+
# 为恢复后的真实模型输入生成新的 Manifest 世代;正文仍不落 Manifest。
|
|
188
|
+
recovered_state = [_chat_message(message) for message in recovered[len(stable_prefix) :]]
|
|
189
|
+
plan = self._plan_context(run, recovered_state)
|
|
190
|
+
window, _source = self._resolve_window(run)
|
|
191
|
+
projected = sum(count_tokens(str(m.get("content") or "")) for m in recovered)
|
|
192
|
+
self._emit_context_built(run, plan, projected, window)
|
|
193
|
+
run.events.append(
|
|
194
|
+
self._event(
|
|
195
|
+
run,
|
|
196
|
+
EventType.CONTEXT_RECOVERED,
|
|
197
|
+
{
|
|
198
|
+
"reason": "provider_context_overflow",
|
|
199
|
+
"trigger": "emergency",
|
|
200
|
+
"retry": retries + 1,
|
|
201
|
+
"retry_limit": limit,
|
|
202
|
+
"message_count_before": len(messages),
|
|
203
|
+
"message_count_after": len(recovered),
|
|
204
|
+
},
|
|
205
|
+
)
|
|
206
|
+
)
|
|
207
|
+
return recovered
|
|
208
|
+
|
|
209
|
+
# ------------------------------------------------------------ Memory 召回
|
|
210
|
+
|
|
211
|
+
def _recall_memory(self, run: Any, messages: list[Message]) -> list[Message]:
|
|
212
|
+
"""检索长期 Memory 并以 system 段注入(长任务方案 §7.5 / §9)。
|
|
213
|
+
|
|
214
|
+
- 检索前先做 scope 允许列表过滤(policy 未启用 → 不检索);
|
|
215
|
+
- 每条命中在 ``memory.recalled`` 事件中给出 memory_id/score/injected
|
|
216
|
+
(injected = 最终被 planner 选入;由 context.built 的 sections
|
|
217
|
+
佐证,这里记召回集合本身);
|
|
218
|
+
- Provider 故障返回空结果(HarnessMemoryRuntime 语义),不污染输入。
|
|
219
|
+
"""
|
|
220
|
+
if self._memory_runtime is None or not run.compiled.spec.memory_policy.enabled:
|
|
221
|
+
return []
|
|
222
|
+
query = str(run.request.input or "").strip()
|
|
223
|
+
if not query:
|
|
224
|
+
return []
|
|
225
|
+
|
|
226
|
+
def _scope_id(scope: str) -> str:
|
|
227
|
+
if scope == "agent":
|
|
228
|
+
return f"agent:{run.state.agent_id}"
|
|
229
|
+
return f"user:{run.state.user_id or 'anonymous'}"
|
|
230
|
+
|
|
231
|
+
scopes = [
|
|
232
|
+
(scope, _scope_id(scope))
|
|
233
|
+
for scope in ("agent", "user")
|
|
234
|
+
if scope in set(run.compiled.spec.memory_policy.scopes)
|
|
235
|
+
]
|
|
236
|
+
if not scopes:
|
|
237
|
+
return []
|
|
238
|
+
result = self._memory_runtime.recall(query=query, scopes=scopes)
|
|
239
|
+
if result.status != "ok" or not result.records:
|
|
240
|
+
return []
|
|
241
|
+
items = []
|
|
242
|
+
lines: list[str] = []
|
|
243
|
+
for record in result.records:
|
|
244
|
+
items.append(
|
|
245
|
+
{
|
|
246
|
+
"memory_id": record.memory_id,
|
|
247
|
+
"scope": record.scope,
|
|
248
|
+
"score": _keyword_score(query, record.content),
|
|
249
|
+
"injected": True,
|
|
250
|
+
}
|
|
251
|
+
)
|
|
252
|
+
lines.append(f"- (长期记忆 {record.memory_id}){record.summary or record.content}")
|
|
253
|
+
run.events.append(
|
|
254
|
+
self._event(
|
|
255
|
+
run,
|
|
256
|
+
EventType.MEMORY_RECALLED,
|
|
257
|
+
{
|
|
258
|
+
"scope": ",".join(s for s, _ in scopes),
|
|
259
|
+
"query": query[:256],
|
|
260
|
+
"items": items,
|
|
261
|
+
},
|
|
262
|
+
)
|
|
263
|
+
)
|
|
264
|
+
return [Message(role=MessageRole.SYSTEM, content="【相关长期记忆】\n" + "\n".join(lines))]
|
|
265
|
+
|
|
266
|
+
# ------------------------------------------------------------ 规划
|
|
267
|
+
|
|
268
|
+
def _resolve_window(self, run: Any) -> tuple[int, str]:
|
|
269
|
+
from ksadk.harness.context_engine import resolve_context_window
|
|
270
|
+
|
|
271
|
+
raw_window = run.request.metadata.get("context_window_tokens")
|
|
272
|
+
return resolve_context_window(
|
|
273
|
+
model_profile_window=int(raw_window) if isinstance(raw_window, (int, float)) else None
|
|
274
|
+
)
|
|
275
|
+
|
|
276
|
+
def _plan_context(
|
|
277
|
+
self,
|
|
278
|
+
run: Any,
|
|
279
|
+
messages: list[Message],
|
|
280
|
+
*,
|
|
281
|
+
current_input: str | None = None,
|
|
282
|
+
) -> Any:
|
|
283
|
+
"""对给定历史做一次上下文规划(ContextRequest 以快照构建)。"""
|
|
284
|
+
from ksadk.harness.context_engine import ContextRequest
|
|
285
|
+
|
|
286
|
+
window, _source = self._resolve_window(run)
|
|
287
|
+
snapshot = run.state.model_copy(update={"messages": messages})
|
|
288
|
+
effective_input = str(run.request.input or "") if current_input is None else current_input
|
|
289
|
+
return self._context_engine.plan(
|
|
290
|
+
ContextRequest(
|
|
291
|
+
spec=run.compiled.spec,
|
|
292
|
+
state=snapshot,
|
|
293
|
+
user_input=effective_input,
|
|
294
|
+
context_window_tokens=window,
|
|
295
|
+
skill_catalog=tuple(run.skill_catalog),
|
|
296
|
+
)
|
|
297
|
+
)
|
|
298
|
+
|
|
299
|
+
def _emit_planned(self, run: Any, plan: Any, window: int, source: str) -> None:
|
|
300
|
+
run.events.append(
|
|
301
|
+
self._event(
|
|
302
|
+
run,
|
|
303
|
+
EventType.CONTEXT_PLANNED,
|
|
304
|
+
{
|
|
305
|
+
"budget_tokens": plan.budget.max_input_tokens,
|
|
306
|
+
"sections": dict(plan.tokens_by_kind),
|
|
307
|
+
"window_source": source,
|
|
308
|
+
"context_window_tokens": window,
|
|
309
|
+
"planned_input_tokens": plan.planned_input_tokens,
|
|
310
|
+
},
|
|
311
|
+
)
|
|
312
|
+
)
|
|
313
|
+
|
|
314
|
+
def _emit_context_built(self, run: Any, plan: Any, projected: int, window: int) -> None:
|
|
315
|
+
from ksadk.harness.context_manifest import build_manifest
|
|
316
|
+
|
|
317
|
+
previous = run.context_manifest
|
|
318
|
+
manifest = build_manifest(
|
|
319
|
+
plan=plan,
|
|
320
|
+
projected_tokens=projected,
|
|
321
|
+
run_id=run.handle.run_id,
|
|
322
|
+
scope_id=f"agent:{run.state.agent_id}",
|
|
323
|
+
model_profile_ref=run.compiled.spec.model.profile_ref,
|
|
324
|
+
supersedes=previous.manifest_id if previous is not None else None,
|
|
325
|
+
)
|
|
326
|
+
run.context_manifest = manifest
|
|
327
|
+
sections = {
|
|
328
|
+
section.item_id: section.estimated_tokens
|
|
329
|
+
for section in manifest.sections
|
|
330
|
+
if section.included
|
|
331
|
+
}
|
|
332
|
+
run.events.append(
|
|
333
|
+
self._event(
|
|
334
|
+
run,
|
|
335
|
+
EventType.CONTEXT_BUILT,
|
|
336
|
+
{
|
|
337
|
+
"manifest_id": manifest.manifest_id,
|
|
338
|
+
"stable_prompt_hash": manifest.stable_prompt_hash,
|
|
339
|
+
"planned_tokens": manifest.planned_tokens,
|
|
340
|
+
"projected_tokens": manifest.projected_tokens,
|
|
341
|
+
"context_window_tokens": window,
|
|
342
|
+
"sections": sections,
|
|
343
|
+
"supersedes": manifest.supersedes or "",
|
|
344
|
+
},
|
|
345
|
+
)
|
|
346
|
+
)
|
|
347
|
+
if self._prompt_cache_tracker is not None:
|
|
348
|
+
diagnostic = self._prompt_cache_tracker.observe(
|
|
349
|
+
scope=(
|
|
350
|
+
f"{run.state.tenant_id}:{run.state.agent_id}:"
|
|
351
|
+
f"{run.compiled.spec.model.profile_ref}"
|
|
352
|
+
),
|
|
353
|
+
stable_prompt_hash=manifest.stable_prompt_hash,
|
|
354
|
+
)
|
|
355
|
+
run.events.append(
|
|
356
|
+
self._event(
|
|
357
|
+
run,
|
|
358
|
+
EventType.PROMPT_CACHE_DIAGNOSTIC,
|
|
359
|
+
{
|
|
360
|
+
**diagnostic.to_payload(),
|
|
361
|
+
"manifest_id": manifest.manifest_id,
|
|
362
|
+
},
|
|
363
|
+
)
|
|
364
|
+
)
|
|
365
|
+
|
|
366
|
+
# ------------------------------------------------------------ 压缩
|
|
367
|
+
|
|
368
|
+
async def _summarize(self, run: Any, head: list[Message]) -> str:
|
|
369
|
+
"""受控摘要调用:走统一 reason 通道(事件成对、usage 可审计)。失败降级拼接。"""
|
|
370
|
+
spec = run.compiled.spec
|
|
371
|
+
try:
|
|
372
|
+
out = await reason_turn_async(
|
|
373
|
+
0,
|
|
374
|
+
ReasonInput(
|
|
375
|
+
model_ref=spec.model.profile_ref,
|
|
376
|
+
fallback_model_refs=spec.model.fallback_profile_refs,
|
|
377
|
+
provider_policy=spec.model.provider_policy,
|
|
378
|
+
instructions=(
|
|
379
|
+
"你是上下文压缩器。请把以下对话历史压缩为要点摘要,"
|
|
380
|
+
"必须保留所有 ID、金额、日期、审批号等关键事实。"
|
|
381
|
+
),
|
|
382
|
+
messages=[{"role": "user", "content": "\n".join(m.content for m in head)}],
|
|
383
|
+
tools=[],
|
|
384
|
+
reasoner=self._reasoner,
|
|
385
|
+
agent_id=run.state.agent_id,
|
|
386
|
+
user_id=run.state.user_id,
|
|
387
|
+
session_id=run.state.session_id,
|
|
388
|
+
run_id=run.handle.run_id,
|
|
389
|
+
seq_start=run.seq,
|
|
390
|
+
max_turns=1,
|
|
391
|
+
),
|
|
392
|
+
)
|
|
393
|
+
except Exception as exc: # noqa: BLE001 - 摘要失败降级为截断拼接,不阻断 Run
|
|
394
|
+
if isinstance(exc, ModelFailoverExhausted):
|
|
395
|
+
for event in exc.events:
|
|
396
|
+
run.events.append(event)
|
|
397
|
+
run.seq = max(run.seq, event.seq_id)
|
|
398
|
+
text = "\n".join(m.content for m in head)
|
|
399
|
+
# 降级不静默(§6.4 "不静默丢弃"):真实模型评测曾把摘要失败
|
|
400
|
+
# 吞成 0-token Run;发 context.recovered 让降级可观测可告警。
|
|
401
|
+
run.events.append(
|
|
402
|
+
self._event(
|
|
403
|
+
run,
|
|
404
|
+
EventType.CONTEXT_RECOVERED,
|
|
405
|
+
{
|
|
406
|
+
"reason": "compaction_summary_failed:degraded_truncation",
|
|
407
|
+
"error": str(exc)[:256],
|
|
408
|
+
},
|
|
409
|
+
)
|
|
410
|
+
)
|
|
411
|
+
return text[:2000] + ("\n…[截断]" if len(text) > 2000 else "")
|
|
412
|
+
for ev in out.events:
|
|
413
|
+
# 压缩摘要是管线内部模型调用,不对应任何 ContextManifest;
|
|
414
|
+
# usage 事件标记 purpose=compaction(真实模型评测暴露:否则
|
|
415
|
+
# Actual↔Manifest 配对率虚低,且压缩花费不可归因)。
|
|
416
|
+
if ev.event_type == EventType.USAGE_REPORTED:
|
|
417
|
+
ev.payload.setdefault("purpose", "compaction")
|
|
418
|
+
run.events.append(ev)
|
|
419
|
+
run.seq = max(run.seq, ev.seq_id)
|
|
420
|
+
return str(out.new_messages[0].get("content") or "") if out.new_messages else ""
|
|
421
|
+
|
|
422
|
+
async def _compact_history(
|
|
423
|
+
self,
|
|
424
|
+
run: Any,
|
|
425
|
+
messages: list[Message],
|
|
426
|
+
*,
|
|
427
|
+
trigger: str,
|
|
428
|
+
keep_recent: int,
|
|
429
|
+
budget_tokens: int,
|
|
430
|
+
) -> list[Message] | None:
|
|
431
|
+
"""主动/紧急压缩:摘要 head + 保留 tail + 关键事实重注入,返回新历史。"""
|
|
432
|
+
from ksadk.harness.context_engine import CompactionRequest
|
|
433
|
+
|
|
434
|
+
if len(messages) <= keep_recent:
|
|
435
|
+
return None
|
|
436
|
+
run.events.append(
|
|
437
|
+
self._event(
|
|
438
|
+
run,
|
|
439
|
+
EventType.CONTEXT_COMPACTION_STARTED,
|
|
440
|
+
{"phase": "before", "trigger": trigger},
|
|
441
|
+
)
|
|
442
|
+
)
|
|
443
|
+
# 长任务方案 §6.4 主动压缩步骤 2:压缩前受控 Memory Flush——
|
|
444
|
+
# 被压缩历史先经提取管线落长期 Memory(审计事件并入事件流)。
|
|
445
|
+
memory_candidate_refs = self._flush_memory_before_compaction(run, messages[:-keep_recent])
|
|
446
|
+
before_tokens = sum(count_tokens(m.content) for m in messages)
|
|
447
|
+
summary = await self._summarize(run, messages[:-keep_recent])
|
|
448
|
+
checkpoint = self._context_engine.compact(
|
|
449
|
+
CompactionRequest(
|
|
450
|
+
messages=messages,
|
|
451
|
+
keep_recent=keep_recent,
|
|
452
|
+
trigger=trigger,
|
|
453
|
+
summary=summary,
|
|
454
|
+
compacted_count=len(messages) - keep_recent,
|
|
455
|
+
)
|
|
456
|
+
)
|
|
457
|
+
compacted_text = (checkpoint.summary or "").strip()
|
|
458
|
+
if checkpoint.reinjection:
|
|
459
|
+
compacted_text = (compacted_text + "\n\n" + checkpoint.reinjection).strip()
|
|
460
|
+
new_messages: list[Message] = [
|
|
461
|
+
Message(role=MessageRole.SYSTEM, content=f"【历史摘要】\n{compacted_text}")
|
|
462
|
+
]
|
|
463
|
+
new_messages.extend(messages[-keep_recent:])
|
|
464
|
+
after_tokens = sum(count_tokens(m.content) for m in new_messages)
|
|
465
|
+
# 长任务方案 §6.4:CompactionRecord(投影变化记录,非新事实源)。
|
|
466
|
+
# 摘要缺失但经重注入保留的事实不算最终丢弃(§8.4.1 "不静默丢弃")。
|
|
467
|
+
reinjected = (
|
|
468
|
+
tuple(checkpoint.dropped_critical_facts) if checkpoint.reinjection else ()
|
|
469
|
+
)
|
|
470
|
+
record = build_compaction_record(
|
|
471
|
+
run_id=run.handle.run_id,
|
|
472
|
+
trigger=trigger,
|
|
473
|
+
before_tokens=before_tokens,
|
|
474
|
+
after_tokens=after_tokens,
|
|
475
|
+
compacted_event_range=(0, int(checkpoint.compacted_until_seq_id)),
|
|
476
|
+
summary=compacted_text,
|
|
477
|
+
retained_critical_facts=tuple(checkpoint.retained_critical_facts),
|
|
478
|
+
dropped_critical_facts=tuple(checkpoint.dropped_critical_facts),
|
|
479
|
+
reinjected_critical_facts=reinjected,
|
|
480
|
+
summary_model_ref=run.compiled.spec.model.profile_ref,
|
|
481
|
+
memory_candidate_refs=tuple(memory_candidate_refs),
|
|
482
|
+
)
|
|
483
|
+
run.compaction_records.append(record)
|
|
484
|
+
run.events.append(
|
|
485
|
+
self._event(
|
|
486
|
+
run,
|
|
487
|
+
EventType.CONTEXT_COMPACTION_COMPLETED,
|
|
488
|
+
{
|
|
489
|
+
"phase": "after",
|
|
490
|
+
"trigger": trigger,
|
|
491
|
+
"compacted_until_seq_id": checkpoint.compacted_until_seq_id,
|
|
492
|
+
"budget_tokens": budget_tokens,
|
|
493
|
+
"dropped_critical_facts": list(checkpoint.dropped_critical_facts),
|
|
494
|
+
"reinjected_critical_facts": list(reinjected),
|
|
495
|
+
# 长任务方案 §8:Compaction 投影(引用 + 前后 Token + 质量校验)。
|
|
496
|
+
"compaction_id": record.compaction_id,
|
|
497
|
+
"before_tokens": record.before_tokens,
|
|
498
|
+
"after_tokens": record.after_tokens,
|
|
499
|
+
"quality_checks": record.quality_checks(),
|
|
500
|
+
"memory_candidate_refs": list(record.memory_candidate_refs),
|
|
501
|
+
},
|
|
502
|
+
)
|
|
503
|
+
)
|
|
504
|
+
return new_messages
|
|
505
|
+
|
|
506
|
+
def _flush_memory_before_compaction(self, run: Any, head: list[Message]) -> list[str]:
|
|
507
|
+
"""压缩前受控 Memory Flush(§6.4 步骤 2)。
|
|
508
|
+
|
|
509
|
+
未注入 MemoryRuntime 或 policy 未启用时为 no-op;审计事件并入
|
|
510
|
+
Run 事件流(memory.write / memory.conflict)。返回已提交候选引用。
|
|
511
|
+
"""
|
|
512
|
+
if self._memory_runtime is None or not run.compiled.spec.memory_policy.enabled:
|
|
513
|
+
return []
|
|
514
|
+
from ksadk.harness.memory_loop import write_back_messages
|
|
515
|
+
|
|
516
|
+
committed: list[str] = []
|
|
517
|
+
|
|
518
|
+
def _sink(event: RuntimeEvent) -> None:
|
|
519
|
+
if event.payload.get("decision") == "commit":
|
|
520
|
+
committed.append(str(event.payload.get("memory_ref") or ""))
|
|
521
|
+
run.events.append(self._event(run, event.event_type, dict(event.payload)))
|
|
522
|
+
|
|
523
|
+
try:
|
|
524
|
+
write_back_messages(
|
|
525
|
+
self._memory_runtime,
|
|
526
|
+
run.compiled.spec,
|
|
527
|
+
run_id=run.handle.run_id,
|
|
528
|
+
agent_id=run.state.agent_id,
|
|
529
|
+
user_id=run.state.user_id,
|
|
530
|
+
messages=head,
|
|
531
|
+
audit_sink=_sink,
|
|
532
|
+
)
|
|
533
|
+
except Exception: # noqa: BLE001 - Flush 是后置增强,失败不阻断压缩
|
|
534
|
+
run.events.append(
|
|
535
|
+
self._event(
|
|
536
|
+
run,
|
|
537
|
+
EventType.MEMORY_WRITE,
|
|
538
|
+
{"scope": "agent", "memory_ref": "", "decision": "flush_failed"},
|
|
539
|
+
)
|
|
540
|
+
)
|
|
541
|
+
return [ref for ref in committed if ref]
|
|
542
|
+
|
|
543
|
+
|
|
544
|
+
def count_tokens(text: str) -> int:
|
|
545
|
+
from ksadk.context_engine.tokenizer import get_default_token_counter
|
|
546
|
+
|
|
547
|
+
return get_default_token_counter().count_text(text)
|
|
548
|
+
|
|
549
|
+
|
|
550
|
+
def _chat_message(message: dict[str, Any]) -> Message:
|
|
551
|
+
"""把 OpenAI 消息投影为压缩/规划使用的稳定 Message 形态。"""
|
|
552
|
+
role_value = str(message.get("role") or "user")
|
|
553
|
+
try:
|
|
554
|
+
role = MessageRole(role_value)
|
|
555
|
+
except ValueError:
|
|
556
|
+
role = MessageRole.USER
|
|
557
|
+
tool_call_id = str(message.get("tool_call_id") or "") or None
|
|
558
|
+
if role is MessageRole.ASSISTANT and not tool_call_id:
|
|
559
|
+
calls = message.get("tool_calls")
|
|
560
|
+
if isinstance(calls, list) and calls and isinstance(calls[0], dict):
|
|
561
|
+
tool_call_id = str(calls[0].get("id") or "") or None
|
|
562
|
+
return Message(
|
|
563
|
+
role=role,
|
|
564
|
+
content=str(message.get("content") or ""),
|
|
565
|
+
tool_call_id=tool_call_id,
|
|
566
|
+
name=str(message.get("name") or "") or None,
|
|
567
|
+
)
|
|
568
|
+
|
|
569
|
+
|
|
570
|
+
def _keyword_score(query: str, content: str) -> float:
|
|
571
|
+
"""廉价关键词命中率(0~1):供 memory.recalled 的 items.score 观测。"""
|
|
572
|
+
terms = [t for t in query.split() if len(t) >= 2]
|
|
573
|
+
if not terms:
|
|
574
|
+
return 0.0
|
|
575
|
+
hits = sum(1 for t in terms if t in content)
|
|
576
|
+
return round(hits / len(terms), 4)
|
|
577
|
+
|
|
578
|
+
|
|
579
|
+
__all__ = ["EngineContextPipeline", "count_tokens"]
|