agentengine-sdk-python 0.8.3__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.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/METADATA +13 -9
- agentengine_sdk_python-0.8.5.dist-info/RECORD +1296 -0
- 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 +111 -91
- ksadk/builders/code_builder.py +74 -21
- ksadk/builders/framework_requirements.py +22 -3
- ksadk/builders/ks3_uploader.py +36 -7
- ksadk/builders/managed_runtime_builder.py +1 -0
- ksadk/cli/__init__.py +68 -3
- 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_managed_runtime.py +13 -1
- ksadk/cli/cmd_openclaw.py +26 -1
- ksadk/cli/cmd_plugin.py +76 -13
- ksadk/cli/cmd_studio.py +64 -16
- ksadk/cli/cmd_web.py +2 -5
- ksadk/cli/openclaw_env.py +1 -1
- ksadk/cli/resource_common.py +26 -0
- ksadk/cli/runtime_bootstrap.py +23 -1
- ksadk/codex/client.py +425 -96
- ksadk/codex/projection.py +24 -0
- ksadk/codex/runtime.py +56 -298
- ksadk/common/auth.py +16 -10
- ksadk/configs/__init__.py +1 -1
- ksadk/configs/env_registry.py +153 -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 +133 -21
- ksadk/conversations/normalize.py +28 -10
- ksadk/conversations/projector.py +4 -6
- ksadk/conversations/runtime_baseline.py +37 -0
- ksadk/conversations/runtime_invocation.py +22 -4
- ksadk/conversations/runtime_observability.py +39 -10
- ksadk/conversations/runtime_payloads.py +9 -0
- ksadk/conversations/runtime_persistence.py +105 -9
- ksadk/conversations/runtime_preparation.py +42 -33
- ksadk/conversations/runtime_resume.py +50 -2
- ksadk/conversations/runtime_stream_events.py +34 -35
- ksadk/conversations/runtime_streaming.py +33 -7
- ksadk/deployment/env_forward.py +2 -2
- ksadk/deployment/providers/serverless.py +1 -1
- ksadk/events/adapters/_codex_items.py +16 -8
- ksadk/events/adapters/_codex_validators.py +18 -7
- ksadk/events/adapters/_langgraph_support.py +34 -0
- ksadk/events/adapters/langgraph.py +15 -1
- ksadk/events/canonical_store.py +3 -1
- ksadk/events/projections.py +1 -1
- 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/config.py +2 -2
- 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 +171 -136
- 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/tools.py +38 -13
- 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 +2 -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 +2 -1
- ksadk/kernel/__init__.py +10 -0
- ksadk/kernel/approval_presentation.py +91 -0
- ksadk/kernel/authorization.py +1 -1
- ksadk/kernel/bootstrap.py +114 -106
- 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 +42 -29
- 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 +331 -25
- ksadk/kernel/state.py +2 -3
- ksadk/kernel/store.py +72 -2
- ksadk/kernel/worker.py +144 -51
- ksadk/kernel/worker_history.py +72 -0
- ksadk/kernel/worker_identity.py +47 -0
- ksadk/knowledge_base/client.py +57 -27
- ksadk/mcp_runtime/__init__.py +12 -4
- ksadk/memory/adk/backends/sdk_ltm_backend.py +161 -41
- ksadk/memory/adk/resilient_session_service.py +25 -17
- ksadk/memory/adk/short_term_memory.py +26 -9
- ksadk/memory/coordinator.py +22 -6
- ksadk/memory/extraction.py +40 -1
- ksadk/memory/models.py +84 -5
- ksadk/memory/provider_resolver.py +8 -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 +14 -7
- ksadk/model_proxy/transform.py +40 -2
- ksadk/plugins/__init__.py +5 -1
- ksadk/plugins/artifacts.py +275 -0
- ksadk/plugins/bridges/__init__.py +4 -2
- ksadk/plugins/bridges/codex.py +120 -13
- ksadk/plugins/bridges/dsh.py +351 -156
- ksadk/plugins/builtins.py +72 -35
- ksadk/plugins/bundle_security.py +28 -4
- ksadk/plugins/codex_manifest.py +983 -0
- ksadk/plugins/companion_artifacts.py +83 -0
- ksadk/plugins/companions.py +368 -0
- ksadk/plugins/composition.py +8 -0
- ksadk/plugins/contracts.py +119 -1
- ksadk/plugins/delivery.py +153 -0
- ksadk/plugins/dsh_channels.py +156 -0
- ksadk/plugins/dsh_home.py +140 -0
- ksadk/plugins/dsh_installation_digest.py +71 -0
- ksadk/plugins/dsh_teams.py +105 -0
- ksadk/plugins/dsh_toolchain.py +203 -32
- ksadk/plugins/ecosystem_probe.py +6 -6
- ksadk/plugins/execution_host.py +99 -0
- ksadk/plugins/host.py +102 -39
- ksadk/plugins/kernel_adapter.py +205 -0
- ksadk/plugins/providers/__init__.py +23 -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/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-knowledge/index.mjs +53 -0
- ksadk/plugins/providers/bundles/dsh-knowledge/package.json +16 -0
- ksadk/plugins/providers/bundles/dsh-memory/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-memory/index.mjs +175 -0
- ksadk/plugins/providers/bundles/dsh-memory/package.json +16 -0
- ksadk/plugins/providers/bundles/dsh-platform-resources/client.mjs +166 -0
- ksadk/plugins/providers/bundles/dsh-platform-resources/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-platform-resources/index.mjs +9 -0
- ksadk/plugins/providers/bundles/dsh-platform-resources/package.json +12 -0
- ksadk/plugins/providers/bundles/dsh-skill-center/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/dsh-skill-center/index.mjs +125 -0
- ksadk/plugins/providers/bundles/dsh-skill-center/package.json +16 -0
- 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/cordis.patch.yml +3 -0
- ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/index.mjs +920 -0
- ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/package.json +27 -0
- 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 +115 -0
- ksadk/plugins/providers/bundles/ksadk-dsh-studio/index.mjs +19 -0
- ksadk/plugins/providers/bundles/ksadk-dsh-studio/package.json +7 -0
- ksadk/plugins/providers/bundles/ksadk-harness/index.mjs +1 -1
- ksadk/plugins/providers/codex.py +344 -70
- ksadk/plugins/providers/codex_native.py +368 -0
- ksadk/plugins/providers/codex_turn.py +301 -0
- ksadk/plugins/providers/dsh_capabilities.py +1450 -0
- ksadk/plugins/providers/dsh_mcp.py +467 -0
- ksadk/plugins/providers/harness.py +294 -141
- 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/mcp_projection.py +150 -0
- ksadk/plugins/providers/platform_resources.py +657 -0
- ksadk/plugins/providers/shipped_dsh.py +4 -1
- ksadk/plugins/resolver.py +8 -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/resource_runtime/__init__.py +4 -0
- ksadk/resource_runtime/broker.py +616 -0
- ksadk/resource_runtime/build_artifacts.py +165 -0
- ksadk/resource_runtime/contracts.py +138 -0
- ksadk/resource_runtime/discovery_receipts.py +100 -0
- ksadk/resource_runtime/discovery_skills.py +172 -0
- ksadk/resource_runtime/errors.py +6 -0
- ksadk/resource_runtime/ipc.py +142 -0
- ksadk/resource_runtime/kernel_approval.py +165 -0
- ksadk/resource_runtime/knowledge.py +114 -0
- ksadk/resource_runtime/langgraph.py +94 -0
- ksadk/resource_runtime/leases.py +191 -0
- ksadk/resource_runtime/managed_projection.py +186 -0
- ksadk/resource_runtime/mcp_server.py +138 -0
- ksadk/resource_runtime/memory_provider.py +318 -0
- ksadk/resource_runtime/memory_receipts.py +34 -0
- ksadk/resource_runtime/operation_ledger.py +211 -0
- ksadk/resource_runtime/plugin_config.py +48 -0
- ksadk/resource_runtime/policy_authorization.py +54 -0
- ksadk/resource_runtime/process.py +110 -0
- ksadk/resource_runtime/skill_artifacts.py +153 -0
- ksadk/resource_runtime/skill_runtime.py +42 -0
- ksadk/resource_runtime/skill_workspace.py +118 -0
- ksadk/resource_runtime/skills.py +215 -0
- ksadk/resource_runtime/snapshots.py +180 -0
- ksadk/resource_runtime/socket_server.py +103 -0
- ksadk/resource_runtime/supervisor.py +380 -0
- ksadk/resource_runtime/worker.py +504 -0
- ksadk/runners/_langgraph_runner_streams.py +182 -38
- ksadk/runners/_langgraph_state_reader.py +106 -0
- ksadk/runners/_session_identity.py +285 -0
- ksadk/runners/adk_runner.py +166 -63
- ksadk/runners/base_runner.py +29 -1
- ksadk/runners/langgraph_runner.py +542 -195
- ksadk/runners/patch_langchain.py +47 -0
- ksadk/runners/usage_accumulator.py +11 -3
- ksadk/runtime/_runner_adapter/stream_mapping.py +194 -20
- ksadk/runtime/adapter.py +2 -0
- ksadk/runtime/conversation_execution.py +117 -17
- ksadk/runtime/executor.py +87 -3
- ksadk/runtime/factory.py +65 -274
- ksadk/runtime/framework_adapters.py +23 -0
- ksadk/runtime/preprocessing.py +21 -5
- ksadk/runtime/runner_adapter.py +106 -18
- ksadk/runtime/skill_eval_result.py +36 -0
- ksadk/runtime/timing.py +46 -0
- ksadk/runtime/usage.py +49 -18
- ksadk/runtime_context.py +142 -2
- ksadk/sandbox/backends/e2b.py +288 -25
- ksadk/sandbox/backends/local_process.py +72 -39
- ksadk/sandbox/base.py +64 -1
- ksadk/sandbox/diagnostics.py +82 -0
- ksadk/sandbox/e2b_connection.py +66 -0
- ksadk/sandbox/local_controls.py +746 -0
- ksadk/sandbox/local_launcher.py +90 -0
- ksadk/scheduler/dispatcher.py +1 -1
- ksadk/scheduler/sqlite_store.py +18 -0
- ksadk/server/composition.py +2 -0
- ksadk/server/factory.py +5 -0
- ksadk/server/invocation_identity.py +118 -0
- ksadk/server/persistence_capability.py +516 -0
- ksadk/server/routes/common.py +32 -3
- ksadk/server/routes/control.py +271 -52
- ksadk/server/routes/dependencies.py +16 -0
- ksadk/server/routes/kernel_ingress.py +9 -1
- ksadk/server/routes/misc.py +233 -25
- ksadk/server/routes/models.py +47 -4
- ksadk/server/routes/openai_compat.py +76 -13
- ksadk/server/routes/projection.py +252 -12
- ksadk/server/routes/run.py +106 -35
- ksadk/server/routes/sessions.py +491 -138
- ksadk/server/routes/streaming.py +43 -9
- ksadk/server/routes/workspace.py +130 -21
- ksadk/server/static/assets/{ArtifactsPanel-10GPXIJ6.js → ArtifactsPanel-C1YoaKhx.js} +1 -1
- ksadk/server/static/assets/{CodeBlock-BXk1l-G1.js → CodeBlock-DHuAWfr5.js} +10 -7
- ksadk/server/static/assets/MathMessageMarkdown-cvdrBwYr.js +8 -0
- ksadk/server/static/assets/{MermaidBlock--OEYoXIJ.js → MermaidBlock-DeBkbJvI.js} +9 -9
- ksadk/server/static/assets/{NativeTerminalPanel-DrEe1syq.js → NativeTerminalPanel-oJj44_sV.js} +1 -1
- ksadk/server/static/assets/{abnfDiagram-VCTEODGH-eeTFJLvo.js → abnfDiagram-VCTEODGH-Dhfv25o2.js} +1 -1
- ksadk/server/static/assets/{arc-S3ZNbIAd.js → arc-C35w-pn1.js} +1 -1
- ksadk/server/static/assets/architecture-7GRP2DOG-BCsa26zi.js +1 -0
- ksadk/server/static/assets/{architectureDiagram-5GKGNRK7-CRjgEJDX.js → architectureDiagram-5GKGNRK7-FoMY_u6D.js} +1 -1
- ksadk/server/static/assets/{blockDiagram-NRAW4CY4-C7bsBoNH.js → blockDiagram-NRAW4CY4-zD4Rt7oE.js} +1 -1
- ksadk/server/static/assets/{c4Diagram-UCG6FXSJ-BX3c33Ob.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-bZ7ws-8m.js → chunk-5VM5RSS4-C2Ms13_k.js} +1 -1
- ksadk/server/static/assets/{chunk-F27PBJKO-D2r0pvhY.js → chunk-F27PBJKO-BoTj-qgx.js} +1 -1
- ksadk/server/static/assets/{chunk-G27WJ6UU-CZwF3oUP.js → chunk-G27WJ6UU-DOMyyjHH.js} +1 -1
- ksadk/server/static/assets/{chunk-JWPE2WC7-DigFYCML.js → chunk-JWPE2WC7-DbJJqDli.js} +1 -1
- ksadk/server/static/assets/{chunk-LCL6LL3I-CnorGV5q.js → chunk-LCL6LL3I-CLuRCt_W.js} +1 -1
- ksadk/server/static/assets/{chunk-POPQ4Y6H-CexntQA-.js → chunk-POPQ4Y6H-D0Dz847e.js} +1 -1
- ksadk/server/static/assets/{chunk-RHFEMEQ7-CHTC7UxA.js → chunk-RHFEMEQ7-BWSRzEcd.js} +1 -1
- ksadk/server/static/assets/{chunk-SVP7TREG-BC1EWt_-.js → chunk-SVP7TREG-CPoHqkCY.js} +1 -1
- ksadk/server/static/assets/{chunk-XXDRQBXY-BTG24xN0.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-CkonRdAS.js → cose-bilkent-JH36ORCC-LzyWm4m0.js} +1 -1
- ksadk/server/static/assets/cynefin-OW5HDTMX-CNXjFctL.js +1 -0
- ksadk/server/static/assets/{cynefinDiagram-5FMLGOSQ-DEOCBe15.js → cynefinDiagram-5FMLGOSQ-BlW_bHED.js} +1 -1
- ksadk/server/static/assets/{dagre-3AP2YEHR-DBThPuLa.js → dagre-3AP2YEHR-Bu_S86_i.js} +1 -1
- ksadk/server/static/assets/{dagre-ClTPrTht.js → dagre-B7nCawed.js} +1 -1
- ksadk/server/static/assets/{diagram-S7CK7UJ4-DsZHrnpJ.js → diagram-S7CK7UJ4-W_Zow2Km.js} +1 -1
- ksadk/server/static/assets/{diagram-UQ7AKVKN-BJR4nhVr.js → diagram-UQ7AKVKN-CLIKAHON.js} +1 -1
- ksadk/server/static/assets/{diagram-VSXAHHWV-xzcERX0a.js → diagram-VSXAHHWV-Dv6_QAlN.js} +1 -1
- ksadk/server/static/assets/{diagram-VX7I27RA-tn2xM1xu.js → diagram-VX7I27RA-BWAWRDtZ.js} +1 -1
- ksadk/server/static/assets/{diagram-Z3DM3KII-BZPGBkw5.js → diagram-Z3DM3KII-XA_rWMss.js} +1 -1
- ksadk/server/static/assets/dist-0X_j2Rcc.js +1 -0
- ksadk/server/static/assets/{dist-4zN1_tq5.js → dist-1nXCdsej.js} +1 -1
- ksadk/server/static/assets/{dist-M67Hwu0n.js → dist-2vL2sAdF.js} +1 -1
- ksadk/server/static/assets/{dist-BJLUwH6W.js → dist-B3bA05-e.js} +1 -1
- ksadk/server/static/assets/{dist-8VWI-2bZ.js → dist-BLpRy_Yx.js} +1 -1
- ksadk/server/static/assets/{dist-D1V3f1B4.js → dist-BO_UwatH.js} +1 -1
- ksadk/server/static/assets/{dist-Cq4OL6nO.js → dist-BdNFAney.js} +1 -1
- ksadk/server/static/assets/{dist-DfGFrb0v.js → dist-C0J5_3qM.js} +1 -1
- ksadk/server/static/assets/{dist-DyqV4fL4.js → dist-CGt_UGeO.js} +1 -1
- ksadk/server/static/assets/{dist-DjhwGUgZ.js → dist-CIRMvUM4.js} +1 -1
- ksadk/server/static/assets/{dist-B1oWRmrH.js → dist-CIpWk_5f.js} +1 -1
- ksadk/server/static/assets/{dist-CXpH_Rdd.js → dist-CPyieXEf.js} +1 -1
- ksadk/server/static/assets/{dist-Btyo4vX4.js → dist-D-92S-Fd.js} +1 -1
- ksadk/server/static/assets/{dist-u8tVH5Ak.js → dist-DNKuMzWc.js} +1 -1
- ksadk/server/static/assets/{dist-DQAB0qn_.js → dist-DWfdmz9s.js} +2 -2
- ksadk/server/static/assets/{dist-B-46q3Hk.js → dist-DppE_r-D.js} +1 -1
- ksadk/server/static/assets/{dist-C71CsujO.js → dist-DyG6Ya-z.js} +1 -1
- ksadk/server/static/assets/{dist-DJmCPRVB.js → dist-M-SrdhhZ.js} +1 -1
- ksadk/server/static/assets/{dist-Bbwqa8TG.js → dist-mqD5TZup.js} +1 -1
- ksadk/server/static/assets/{dist-BI1qQH4n.js → dist-n3n6t_FO.js} +1 -1
- ksadk/server/static/assets/{dist-DUwKa_l6.js → dist-qe8xjesy.js} +1 -1
- ksadk/server/static/assets/{dist-B0gdk4rl.js → dist-t6MzE0jU.js} +1 -1
- ksadk/server/static/assets/{ebnfDiagram-PWID7BFC-DVfMsLge.js → ebnfDiagram-PWID7BFC-BfCzF1Xi.js} +1 -1
- ksadk/server/static/assets/{erDiagram-SSCWMZ5O-CWEZSYaw.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-TWIxoyYL.js → ganttDiagram-EL5Y4UJY-DDaG1f4_.js} +1 -1
- ksadk/server/static/assets/gitGraph-4MIJSDKK-B-AhYj4C.js +1 -0
- ksadk/server/static/assets/{gitGraphDiagram-WWUBYQGX-DDh2hd2S.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-CgoyWiDR.js → infoDiagram-RXCK75RN-CYMdn6lQ.js} +1 -1
- ksadk/server/static/assets/{ishikawaDiagram-5VMMS53U-CyRIu_om.js → ishikawaDiagram-5VMMS53U-CLHFAD6c.js} +1 -1
- ksadk/server/static/assets/{journeyDiagram-EYS64GPL-DN5JXHzN.js → journeyDiagram-EYS64GPL-BHSKQGAl.js} +1 -1
- ksadk/server/static/assets/{kanban-definition-3QL26DDD-CNP3ui66.js → kanban-definition-3QL26DDD-D5W3tjTT.js} +1 -1
- ksadk/server/static/assets/{katex-DWEzQy1d.js → katex-mtjOi4KM.js} +1 -1
- ksadk/server/static/assets/{linear-C-qHp7d2.js → linear-BETqsxE_.js} +1 -1
- ksadk/server/static/assets/{mermaid-parser.core-Cl-K943T.js → mermaid-parser.core-DPWrvs90.js} +2 -2
- ksadk/server/static/assets/{mindmap-definition-FBJOCRG2-D5DB5mYm.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-BQVc9ia_.js → pegDiagram-XKGWAZYB-GjAPNaqn.js} +1 -1
- ksadk/server/static/assets/pie-WAS4IAKB-DyfxBU7V.js +1 -0
- ksadk/server/static/assets/{pieDiagram-E7YTZNPT-B6UCAvtY.js → pieDiagram-E7YTZNPT-ToIewrqr.js} +1 -1
- ksadk/server/static/assets/{quadrantDiagram-AXDQQJYC-mIr2d3eb.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-Dt3FFDmK.js → railroadDiagram-O6MQD6OU-DKzx4xfv.js} +1 -1
- ksadk/server/static/assets/{requirementDiagram-EFPCY7ZU-Cz_vQtgF.js → requirementDiagram-EFPCY7ZU-CJYljxQS.js} +1 -1
- ksadk/server/static/assets/{sankeyDiagram-P5KCCOFB-wlO1TsH5.js → sankeyDiagram-P5KCCOFB-DLU2fV1w.js} +1 -1
- ksadk/server/static/assets/{sequenceDiagram-WJ2MYXX4-CHRbElYq.js → sequenceDiagram-WJ2MYXX4-CVqysrA9.js} +1 -1
- ksadk/server/static/assets/{sizeCapture-X5ZJPWSS-DXX54iyO.js → sizeCapture-X5ZJPWSS-BUxfmTHc.js} +1 -1
- ksadk/server/static/assets/{stateDiagram-HBIQ2CUA-Dp_lw9II.js → stateDiagram-HBIQ2CUA-CNFgYI9E.js} +1 -1
- ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-BXAFScz8.js +1 -0
- ksadk/server/static/assets/{swimlanes-XN3QIQJK-D8O5UlLG.js → swimlanes-XN3QIQJK-B6qCMe8N.js} +1 -1
- ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uIQ2lJKH.js +8 -0
- ksadk/server/static/assets/{timeline-definition-24CTP7MA-8mfKcxvG.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-EnNl0DE7.js → vennDiagram-4TSXK5OY-BqtUqvXM.js} +1 -1
- ksadk/server/static/assets/wardley-WFR3VGLG-QAt06uEz.js +1 -0
- ksadk/server/static/assets/{wardleyDiagram-VM6X3IG4-DBu5fbYr.js → wardleyDiagram-VM6X3IG4-B5KfDjI-.js} +1 -1
- ksadk/server/static/assets/{xychartDiagram-S5SC5T6Z-BSVXs4IY.js → xychartDiagram-S5SC5T6Z-BaUlSZrn.js} +1 -1
- ksadk/server/static/index.html +2 -2
- ksadk/server/terminal_sessions.py +34 -2
- ksadk/session_context.py +66 -0
- ksadk/sessions/__init__.py +11 -21
- ksadk/sessions/_local_service_sync.py +263 -1
- ksadk/sessions/base.py +176 -0
- ksadk/sessions/errors.py +4 -0
- ksadk/sessions/in_memory.py +309 -19
- ksadk/sessions/invocation_identity.py +235 -0
- ksadk/sessions/local_service.py +83 -1
- ksadk/sessions/persistence.py +275 -0
- ksadk/sessions/postgres_service.py +358 -0
- ksadk/sessions/resilience.py +8 -0
- ksadk/sessions/resilient.py +362 -4
- ksadk/sessions/topology.py +135 -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 +37 -4
- ksadk/skills/observability.py +132 -0
- ksadk/skills/package_store.py +261 -40
- ksadk/skills/runtime/agent.py +67 -9
- ksadk/skills/runtime/artifact_delivery.py +139 -0
- ksadk/skills/runtime/artifacts.py +87 -0
- ksadk/skills/runtime/backends/e2b.py +460 -27
- ksadk/skills/runtime/backends/local.py +629 -62
- ksadk/skills/runtime/base.py +81 -7
- ksadk/skills/runtime/executor.py +268 -1
- ksadk/skills/runtime/loader.py +118 -5
- ksadk/skills/runtime/pinned.py +114 -0
- ksadk/skills/runtime/request.py +49 -0
- ksadk/skills/service_client.py +167 -28
- ksadk/skills/tool_defs.py +108 -3
- ksadk/studio/api.py +810 -93
- ksadk/studio/api_catalog_routes.py +18 -0
- ksadk/studio/api_contracts.py +8 -2
- ksadk/studio/api_plugin_routes.py +562 -104
- ksadk/studio/api_resource_connections.py +221 -0
- ksadk/studio/authoring.py +12 -6
- ksadk/studio/authoring_coordinator.py +23 -16
- ksadk/studio/builder.py +88 -0
- ksadk/studio/capabilities.py +23 -6
- ksadk/studio/channel_connections.py +333 -0
- ksadk/studio/cloud.py +370 -112
- ksadk/studio/cloud_shared_web.py +638 -0
- ksadk/studio/codex_agent_service.py +130 -28
- ksadk/studio/codex_builder.py +242 -3
- ksadk/studio/codex_credentials.py +90 -0
- ksadk/studio/codex_manifest.py +31 -4
- ksadk/studio/codex_plugin_store.py +746 -0
- ksadk/studio/codex_provider_build.py +231 -0
- ksadk/studio/codex_run.py +190 -26
- ksadk/studio/compatibility_report.py +12 -1
- ksadk/studio/compiler.py +88 -14
- ksadk/studio/configuration.py +182 -0
- ksadk/studio/contracts.py +165 -11
- ksadk/studio/dsh_application.py +247 -0
- ksadk/studio/dsh_capability_service.py +1374 -0
- ksadk/studio/dsh_lifecycle.py +58 -0
- ksadk/studio/dsh_models.py +59 -0
- ksadk/studio/dsh_provider_registration.py +367 -21
- 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 +89 -14
- ksadk/studio/kernel_registry.py +418 -0
- ksadk/studio/kernel_sqlite_migration.py +181 -0
- ksadk/studio/mcp_runtime.py +11 -3
- ksadk/studio/model_client.py +1180 -66
- ksadk/studio/model_profile_service.py +26 -11
- ksadk/studio/native_documents.py +172 -0
- ksadk/studio/plugin_composition.py +202 -24
- ksadk/studio/plugin_kernel_adapter.py +21 -106
- ksadk/studio/plugin_lifecycle.py +80 -0
- ksadk/studio/plugin_runtime.py +448 -56
- ksadk/studio/provider_recovery.py +59 -0
- ksadk/studio/recovery_page.py +70 -0
- ksadk/studio/resource_authority.py +664 -0
- ksadk/studio/resource_binding_validation.py +77 -0
- ksadk/studio/resource_build_admission.py +196 -0
- ksadk/studio/resource_build_materializer.py +149 -0
- ksadk/studio/resource_catalog.py +149 -2
- ksadk/studio/resource_connections.py +220 -0
- ksadk/studio/run_activity.py +895 -0
- ksadk/studio/run_documents.py +127 -0
- ksadk/studio/run_service.py +789 -83
- ksadk/studio/runtime_catalog.py +53 -10
- ksadk/studio/runtime_source.py +16 -8
- ksadk/studio/scheduler_assistant.py +317 -0
- ksadk/studio/scheduler_runtime.py +32 -280
- ksadk/studio/scheduler_service.py +3 -0
- ksadk/studio/service.py +861 -120
- ksadk/studio/shared_web.py +579 -82
- 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/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
- ksadk/studio/static/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
- ksadk/studio/static/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
- ksadk/studio/static/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
- ksadk/studio/static/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
- ksadk/studio/static/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
- ksadk/studio/static/assets/MathMessageMarkdown-BesSeCYl-BEOyPC3w.css +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/arc-Pry-7G1_.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/array-BifhSqXX.js +1 -0
- ksadk/studio/static/assets/blockDiagram-I7D4REHJ-CLB4L11u.js +129 -0
- ksadk/studio/static/assets/c4Diagram-7LVT6UL2-BOma_Z_F.js +38 -0
- 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-2Q5K7J3B-C1jixKkw.js +1 -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-DVtDP4rm.js +62 -0
- ksadk/studio/static/assets/chunk-5V3GS4D5-i-ZDOEnP.js +1 -0
- ksadk/studio/static/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -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-CpEZCUgg.js +128 -0
- ksadk/studio/static/assets/chunk-F27PBJKO-D7pvKf0C.js +1 -0
- ksadk/studio/static/assets/chunk-FOHPRMQF-DHwB1DNv.js +161 -0
- ksadk/studio/static/assets/chunk-GMAD6QVW-DE_8H717.js +72 -0
- 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-D38axYOR.js +231 -0
- ksadk/studio/static/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
- 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-DiCQjx9b.js +10 -0
- ksadk/studio/static/assets/chunk-OUJLGHUK-D0j2JRSg.js +2 -0
- ksadk/studio/static/assets/chunk-P2QGCYS3-VdhKmfYq.js +1 -0
- 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-DsCFnRVE.js +168 -0
- ksadk/studio/static/assets/chunk-SVP7TREG-DljApgRX.js +88 -0
- ksadk/studio/static/assets/chunk-TICWLB2K-DWqRtyqa.js +206 -0
- 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/chunk-Y2CYZVJY-DsF7k-Jl.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/cytoscape.esm-CGd-uY3x.js +321 -0
- ksadk/studio/static/assets/dagre-GXQ25YYZ-buZBRlwz.js +4 -0
- ksadk/studio/static/assets/dagre-PrKaheQc.js +1 -0
- ksadk/studio/static/assets/defaultLocale-BFoDCU3G.js +1 -0
- ksadk/studio/static/assets/diagram-S7CK7UJ4-C6aH78c4.js +30 -0
- 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/dist-v5Q1xZ2K.js +1 -0
- ksadk/studio/static/assets/ebnfDiagram-PWID7BFC-Daukxwqf.js +1 -0
- ksadk/studio/static/assets/erDiagram-RLTQ6QDP-CGthTMmJ.js +99 -0
- 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/graphlib-DS17s2tU.js +1 -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/init-C-OQMol4.js +1 -0
- ksadk/studio/static/assets/ishikawaDiagram-5VMMS53U-BUGEl8cO.js +70 -0
- ksadk/studio/static/assets/journeyDiagram-3NMN7TZE-Ch2ZYxvr.js +139 -0
- ksadk/studio/static/assets/kanban-definition-UXKFOSKX-Da-Fp4vC.js +89 -0
- ksadk/studio/static/assets/katex-DhON-x74.js +257 -0
- ksadk/studio/static/assets/kingsoft-cloud-BOcLiQ3e.ico +0 -0
- ksadk/studio/static/assets/line-BDaeq300.js +1 -0
- 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-CvlsVQ38.js +96 -0
- ksadk/studio/static/assets/ordinal-BDEzSJ7C.js +1 -0
- ksadk/studio/static/assets/packet-AYTQ26CC-BSJEH9Lb.js +1 -0
- ksadk/studio/static/assets/path-fybaL0A-.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-DlrWiSOv.js +39 -0
- 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-BA3hpUZM.js +7 -0
- 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-E-Ge0FcV.js +84 -0
- ksadk/studio/static/assets/rolldown-runtime-Dy4uBu1J-DK3Fl9T5.js +1 -0
- ksadk/studio/static/assets/rough.esm-Dy-Kn_BL.js +1 -0
- ksadk/studio/static/assets/sankeyDiagram-P5KCCOFB-CA6YKhQ3.js +40 -0
- ksadk/studio/static/assets/sequenceDiagram-WJ2MYXX4-CcElXGg4.js +162 -0
- ksadk/studio/static/assets/sizeCapture-INFHLROL-B0uUizjq.js +1 -0
- 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-CIuYhNy3.js +120 -0
- 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-CMJiaedy.js +78 -0
- ksadk/studio/static/assets/xychartDiagram-S5SC5T6Z-BdgtMvW2.js +7 -0
- 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
- agentengine_sdk_python-0.8.3.dist-info/RECORD +0 -833
- ksadk/server/static/assets/MathMessageMarkdown-D9uB55Oh.js +0 -8
- ksadk/server/static/assets/architecture-7GRP2DOG-Dk9nRQ6-.js +0 -1
- ksadk/server/static/assets/channel-s354Yo6o.js +0 -1
- ksadk/server/static/assets/chunk-2Q5K7J3B-CDpPpKR5.js +0 -1
- ksadk/server/static/assets/classDiagram-DTDB5LWJ-Dd0nucl9.js +0 -1
- ksadk/server/static/assets/classDiagram-v2-JRS7N3AN-Dd0nucl9.js +0 -1
- ksadk/server/static/assets/cynefin-OW5HDTMX-BBlT4uMf.js +0 -1
- ksadk/server/static/assets/dist-DdRBIceA.js +0 -1
- ksadk/server/static/assets/eventmodeling-NTZA5JFV-Dr5okd8V.js +0 -1
- ksadk/server/static/assets/flowDiagram-A5DVABFB-VEO-cVcO.js +0 -1
- ksadk/server/static/assets/gitGraph-4MIJSDKK-CKiKY9Cf.js +0 -1
- ksadk/server/static/assets/index-B2k_urY8.js +0 -241
- ksadk/server/static/assets/index-ILPt6IWF.css +0 -2
- ksadk/server/static/assets/info-A6RAGUB7-ubA4Nm_p.js +0 -1
- ksadk/server/static/assets/packet-AYTQ26CC-C7R3NUlK.js +0 -1
- ksadk/server/static/assets/pie-WAS4IAKB-BIT6qjr3.js +0 -1
- ksadk/server/static/assets/radar-RG4KPBEZ-l5noef9X.js +0 -1
- ksadk/server/static/assets/railroad-74A4TZTK-Baea6ZvM.js +0 -1
- ksadk/server/static/assets/railroad-abnf-HS5TGJTU-OKn8zZnU.js +0 -1
- ksadk/server/static/assets/railroad-ebnf-LZEXJU2U-DdKAKC4l.js +0 -1
- ksadk/server/static/assets/railroad-peg-WCYAUIDC-Bds8udlG.js +0 -1
- ksadk/server/static/assets/stateDiagram-v2-4QOOHH4V-5b-8o2iS.js +0 -1
- ksadk/server/static/assets/swimlanesDiagram-VK2B7HYN-uf6WPRA4.js +0 -8
- ksadk/server/static/assets/treeView-Q6P3EWNA-CK5CSrSO.js +0 -1
- ksadk/server/static/assets/treemap-WGGIJYW6-Ch2BKgAM.js +0 -1
- ksadk/server/static/assets/wardley-WFR3VGLG-YW3Q0ml_.js +0 -1
- ksadk/studio/static/assets/PrismRenderer-IYN-ffww.js +0 -3
- ksadk/studio/static/assets/index-DXs1Eq4M.css +0 -1
- ksadk/studio/static/assets/index-DeDqwTsD.js +0 -283
- {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/WHEEL +0 -0
- {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/entry_points.txt +0 -0
- {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/licenses/LICENSE +0 -0
- {agentengine_sdk_python-0.8.3.dist-info → agentengine_sdk_python-0.8.5.dist-info}/top_level.txt +0 -0
ksadk/sandbox/backends/e2b.py
CHANGED
|
@@ -2,16 +2,20 @@ from __future__ import annotations
|
|
|
2
2
|
|
|
3
3
|
import logging
|
|
4
4
|
import os
|
|
5
|
+
import posixpath
|
|
5
6
|
import time
|
|
6
7
|
from typing import Any
|
|
7
8
|
|
|
8
9
|
from ksadk.sandbox.base import (
|
|
10
|
+
ReconnectableSandboxCommandHandle,
|
|
9
11
|
SandboxCommandResult,
|
|
10
12
|
SandboxError,
|
|
11
13
|
SandboxInputFile,
|
|
12
14
|
SandboxSession,
|
|
13
15
|
SandboxSpec,
|
|
14
16
|
)
|
|
17
|
+
from ksadk.sandbox.diagnostics import e2b_diagnostic_step
|
|
18
|
+
from ksadk.sandbox.e2b_connection import ExplicitE2BConnection
|
|
15
19
|
|
|
16
20
|
logger = logging.getLogger(__name__)
|
|
17
21
|
|
|
@@ -25,6 +29,28 @@ _TRANSIENT_STARTUP_ERROR_NAMES = {
|
|
|
25
29
|
}
|
|
26
30
|
|
|
27
31
|
|
|
32
|
+
class E2BSandboxSessionError(SandboxError):
|
|
33
|
+
"""Carry sandbox lifecycle facts when session initialization fails."""
|
|
34
|
+
|
|
35
|
+
def __init__(
|
|
36
|
+
self,
|
|
37
|
+
cause: Exception,
|
|
38
|
+
*,
|
|
39
|
+
instance_status: str,
|
|
40
|
+
failure_stage: str,
|
|
41
|
+
runtime_id: str = "",
|
|
42
|
+
cleanup_status: str = "not_started",
|
|
43
|
+
cleanup_error: str | None = None,
|
|
44
|
+
) -> None:
|
|
45
|
+
super().__init__(str(cause))
|
|
46
|
+
self.cause = cause
|
|
47
|
+
self.instance_status = instance_status
|
|
48
|
+
self.failure_stage = failure_stage
|
|
49
|
+
self.runtime_id = runtime_id
|
|
50
|
+
self.cleanup_status = cleanup_status
|
|
51
|
+
self.cleanup_error = cleanup_error
|
|
52
|
+
|
|
53
|
+
|
|
28
54
|
def _startup_retry_attempts() -> int:
|
|
29
55
|
raw = os.environ.get("KSADK_SANDBOX_STARTUP_RETRY_ATTEMPTS", "6")
|
|
30
56
|
try:
|
|
@@ -45,7 +71,7 @@ def _is_transient_startup_error(exc: Exception) -> bool:
|
|
|
45
71
|
return type(exc).__name__ in _TRANSIENT_STARTUP_ERROR_NAMES
|
|
46
72
|
|
|
47
73
|
|
|
48
|
-
def _with_startup_retry(operation):
|
|
74
|
+
def _with_startup_retry(operation, *, step: str = "startup", runtime_id: str = ""):
|
|
49
75
|
attempts = _startup_retry_attempts()
|
|
50
76
|
delay = _startup_retry_delay()
|
|
51
77
|
last_exc: Exception | None = None
|
|
@@ -53,7 +79,18 @@ def _with_startup_retry(operation):
|
|
|
53
79
|
try:
|
|
54
80
|
return operation()
|
|
55
81
|
except Exception as exc:
|
|
56
|
-
|
|
82
|
+
retry = _is_transient_startup_error(exc) and attempt < attempts - 1
|
|
83
|
+
logger.warning(
|
|
84
|
+
"E2B_DIAGNOSTIC step=%s runtime_id=%s attempt=%d max_attempts=%d "
|
|
85
|
+
"error_type=%s retry=%s",
|
|
86
|
+
step,
|
|
87
|
+
runtime_id,
|
|
88
|
+
attempt + 1,
|
|
89
|
+
attempts,
|
|
90
|
+
type(exc).__name__,
|
|
91
|
+
retry,
|
|
92
|
+
)
|
|
93
|
+
if not retry:
|
|
57
94
|
raise
|
|
58
95
|
last_exc = exc
|
|
59
96
|
time.sleep(min(delay * (2**attempt), 1.0))
|
|
@@ -62,6 +99,43 @@ def _with_startup_retry(operation):
|
|
|
62
99
|
raise SandboxError("E2B sandbox startup retry failed unexpectedly")
|
|
63
100
|
|
|
64
101
|
|
|
102
|
+
class E2BCommandHandle:
|
|
103
|
+
"""Normalize an E2B background command to the SDK optional contract."""
|
|
104
|
+
|
|
105
|
+
def __init__(self, handle: Any):
|
|
106
|
+
self._handle = handle
|
|
107
|
+
|
|
108
|
+
@property
|
|
109
|
+
def process_id(self) -> int:
|
|
110
|
+
process_id = int(getattr(self._handle, "pid", 0) or 0)
|
|
111
|
+
if process_id <= 0:
|
|
112
|
+
raise SandboxError("E2B command handle did not expose a valid process ID")
|
|
113
|
+
return process_id
|
|
114
|
+
|
|
115
|
+
def wait(self) -> SandboxCommandResult:
|
|
116
|
+
try:
|
|
117
|
+
result = self._handle.wait()
|
|
118
|
+
except Exception as exc:
|
|
119
|
+
# E2B raises CommandExitException for an ordinary non-zero exit.
|
|
120
|
+
# Preserve the result contract instead of erasing stdout/stderr.
|
|
121
|
+
exit_code = getattr(exc, "exit_code", None)
|
|
122
|
+
if exit_code is None:
|
|
123
|
+
raise
|
|
124
|
+
return SandboxCommandResult(
|
|
125
|
+
stdout=str(getattr(exc, "stdout", "") or ""),
|
|
126
|
+
stderr=str(getattr(exc, "stderr", "") or ""),
|
|
127
|
+
exit_code=int(exit_code),
|
|
128
|
+
)
|
|
129
|
+
return SandboxCommandResult(
|
|
130
|
+
stdout=str(getattr(result, "stdout", "") or ""),
|
|
131
|
+
stderr=str(getattr(result, "stderr", "") or ""),
|
|
132
|
+
exit_code=getattr(result, "exit_code", None),
|
|
133
|
+
)
|
|
134
|
+
|
|
135
|
+
def kill(self) -> bool:
|
|
136
|
+
return bool(self._handle.kill())
|
|
137
|
+
|
|
138
|
+
|
|
65
139
|
class E2BSandboxSession:
|
|
66
140
|
def __init__(self, sandbox: Any):
|
|
67
141
|
self._sandbox = sandbox
|
|
@@ -81,6 +155,22 @@ class E2BSandboxSession:
|
|
|
81
155
|
def read_file(self, path: str) -> str:
|
|
82
156
|
return str(self._sandbox.files.read(path))
|
|
83
157
|
|
|
158
|
+
def read_file_bytes(self, path: str, *, max_bytes: int) -> bytes:
|
|
159
|
+
if type(max_bytes) is not int or max_bytes < 1:
|
|
160
|
+
raise ValueError("File download limit must be positive")
|
|
161
|
+
stream = self._sandbox.files.read(path, format="stream", request_timeout=30)
|
|
162
|
+
content = bytearray()
|
|
163
|
+
try:
|
|
164
|
+
for chunk in stream:
|
|
165
|
+
if len(content) + len(chunk) > max_bytes:
|
|
166
|
+
raise ValueError("Sandbox file exceeds download limit")
|
|
167
|
+
content.extend(chunk)
|
|
168
|
+
finally:
|
|
169
|
+
close = getattr(stream, "close", None)
|
|
170
|
+
if close is not None:
|
|
171
|
+
close()
|
|
172
|
+
return bytes(content)
|
|
173
|
+
|
|
84
174
|
def run_command(
|
|
85
175
|
self,
|
|
86
176
|
command: str,
|
|
@@ -103,6 +193,65 @@ class E2BSandboxSession:
|
|
|
103
193
|
exit_code=getattr(result, "exit_code", None),
|
|
104
194
|
)
|
|
105
195
|
|
|
196
|
+
def start_command(
|
|
197
|
+
self,
|
|
198
|
+
command: str,
|
|
199
|
+
*,
|
|
200
|
+
timeout: int | None = None,
|
|
201
|
+
env: dict[str, str] | None = None,
|
|
202
|
+
cwd: str | None = None,
|
|
203
|
+
) -> ReconnectableSandboxCommandHandle:
|
|
204
|
+
kwargs: dict[str, Any] = {"background": True}
|
|
205
|
+
if timeout is not None:
|
|
206
|
+
kwargs["timeout"] = timeout
|
|
207
|
+
if env is not None:
|
|
208
|
+
kwargs["envs"] = env
|
|
209
|
+
if cwd is not None:
|
|
210
|
+
kwargs["cwd"] = cwd
|
|
211
|
+
return E2BCommandHandle(self._sandbox.commands.run(command, **kwargs))
|
|
212
|
+
|
|
213
|
+
def connect_command(
|
|
214
|
+
self,
|
|
215
|
+
process_id: int,
|
|
216
|
+
*,
|
|
217
|
+
timeout: int | None = None,
|
|
218
|
+
) -> ReconnectableSandboxCommandHandle:
|
|
219
|
+
if process_id <= 0:
|
|
220
|
+
raise SandboxError("E2B command reconnect requires a positive process ID")
|
|
221
|
+
kwargs: dict[str, Any] = {}
|
|
222
|
+
if timeout is not None:
|
|
223
|
+
kwargs["timeout"] = timeout
|
|
224
|
+
return E2BCommandHandle(self._sandbox.commands.connect(process_id, **kwargs))
|
|
225
|
+
|
|
226
|
+
def list_files(self, root: str, *, recursive: bool = True) -> list[str]:
|
|
227
|
+
"""List file paths below ``root`` without exposing sibling paths."""
|
|
228
|
+
|
|
229
|
+
normalized_root = posixpath.normpath(root)
|
|
230
|
+
if not normalized_root.startswith("/"):
|
|
231
|
+
raise SandboxError("E2B artifact root must be an absolute path")
|
|
232
|
+
entries = self._sandbox.files.list(
|
|
233
|
+
normalized_root,
|
|
234
|
+
depth=None if recursive else 1,
|
|
235
|
+
)
|
|
236
|
+
files: list[str] = []
|
|
237
|
+
for entry in entries:
|
|
238
|
+
entry_path = posixpath.normpath(str(getattr(entry, "path", "") or ""))
|
|
239
|
+
if not entry_path.startswith("/"):
|
|
240
|
+
entry_path = posixpath.normpath(posixpath.join(normalized_root, entry_path))
|
|
241
|
+
entry_type = getattr(getattr(entry, "type", None), "value", "")
|
|
242
|
+
if getattr(entry, "symlink_target", None) is not None:
|
|
243
|
+
continue
|
|
244
|
+
try:
|
|
245
|
+
in_root = posixpath.commonpath((normalized_root, entry_path)) == normalized_root
|
|
246
|
+
except ValueError:
|
|
247
|
+
in_root = False
|
|
248
|
+
if not in_root or entry_type != "file":
|
|
249
|
+
continue
|
|
250
|
+
relative = posixpath.relpath(entry_path, normalized_root)
|
|
251
|
+
if relative != "." and not relative.startswith("../"):
|
|
252
|
+
files.append(relative)
|
|
253
|
+
return sorted(set(files))
|
|
254
|
+
|
|
106
255
|
def get_host(self, port: int) -> str:
|
|
107
256
|
return str(self._sandbox.get_host(port))
|
|
108
257
|
|
|
@@ -111,24 +260,53 @@ class E2BSandboxSession:
|
|
|
111
260
|
|
|
112
261
|
|
|
113
262
|
class E2BSandboxBackend:
|
|
263
|
+
def _diagnostic_step(self, step: str, *, runtime_id: str = "", env=None):
|
|
264
|
+
credentials = (
|
|
265
|
+
(self.connection.api_key.get_secret_value(),) if self.connection is not None else ()
|
|
266
|
+
)
|
|
267
|
+
return e2b_diagnostic_step(
|
|
268
|
+
step,
|
|
269
|
+
runtime_id=runtime_id,
|
|
270
|
+
sensitive_values=credentials,
|
|
271
|
+
env={**self.spec.env, **(env or {})},
|
|
272
|
+
)
|
|
273
|
+
|
|
114
274
|
def __init__(
|
|
115
275
|
self,
|
|
116
276
|
*,
|
|
117
277
|
spec: SandboxSpec,
|
|
118
278
|
sandbox_cls: Any | None = None,
|
|
279
|
+
connection: ExplicitE2BConnection | None = None,
|
|
119
280
|
):
|
|
120
281
|
if not spec.template_id:
|
|
121
282
|
raise SandboxError("E2B sandbox backend requires a template id")
|
|
122
283
|
self.spec = spec
|
|
123
284
|
self.sandbox_cls = sandbox_cls
|
|
285
|
+
self.connection = (
|
|
286
|
+
ExplicitE2BConnection.model_validate(connection.model_dump())
|
|
287
|
+
if connection is not None
|
|
288
|
+
else None
|
|
289
|
+
)
|
|
124
290
|
|
|
125
|
-
def
|
|
126
|
-
self
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
291
|
+
def _get_sandbox_cls(self) -> Any:
|
|
292
|
+
sandbox_cls = self.sandbox_cls
|
|
293
|
+
if sandbox_cls is not None:
|
|
294
|
+
return sandbox_cls
|
|
295
|
+
try:
|
|
296
|
+
from e2b import Sandbox # type: ignore[import-not-found, import-untyped]
|
|
297
|
+
except ImportError as exc:
|
|
298
|
+
raise SandboxError(
|
|
299
|
+
"e2b>=2.15.3,<2.25.0 is required for KSADK_SANDBOX_BACKEND=e2b"
|
|
300
|
+
) from exc
|
|
301
|
+
return Sandbox
|
|
302
|
+
|
|
303
|
+
def check_available(self) -> None:
|
|
304
|
+
"""Validate local SDK/connection configuration without creating a sandbox."""
|
|
305
|
+
if self.connection is not None:
|
|
306
|
+
self.connection.sdk_options()
|
|
307
|
+
self._sandbox_class()
|
|
308
|
+
|
|
309
|
+
def _sandbox_class(self):
|
|
132
310
|
sandbox_cls = self.sandbox_cls
|
|
133
311
|
if sandbox_cls is None:
|
|
134
312
|
try:
|
|
@@ -138,6 +316,17 @@ class E2BSandboxBackend:
|
|
|
138
316
|
"e2b>=2.15.3,<2.25.0 is required for KSADK_SANDBOX_BACKEND=e2b"
|
|
139
317
|
) from exc
|
|
140
318
|
sandbox_cls = Sandbox
|
|
319
|
+
return sandbox_cls
|
|
320
|
+
|
|
321
|
+
def create_session(
|
|
322
|
+
self,
|
|
323
|
+
*,
|
|
324
|
+
session_id: str,
|
|
325
|
+
env: dict[str, str] | None = None,
|
|
326
|
+
input_files: list[SandboxInputFile] | None = None,
|
|
327
|
+
) -> SandboxSession:
|
|
328
|
+
connection_options = self.connection.sdk_options() if self.connection is not None else {}
|
|
329
|
+
sandbox_cls = self._sandbox_class()
|
|
141
330
|
|
|
142
331
|
metadata = {
|
|
143
332
|
"runtime": "ksadk",
|
|
@@ -146,18 +335,82 @@ class E2BSandboxBackend:
|
|
|
146
335
|
"session_id": session_id,
|
|
147
336
|
}
|
|
148
337
|
runtime_env = {**self.spec.env, **(env or {})}
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
338
|
+
try:
|
|
339
|
+
with self._diagnostic_step("create", env=runtime_env):
|
|
340
|
+
sandbox = sandbox_cls.create(
|
|
341
|
+
template=self.spec.template_id,
|
|
342
|
+
timeout=self.spec.timeout,
|
|
343
|
+
metadata=metadata,
|
|
344
|
+
envs=runtime_env,
|
|
345
|
+
allow_internet_access=self.spec.allow_internet_access,
|
|
346
|
+
**connection_options,
|
|
347
|
+
)
|
|
348
|
+
except Exception as exc:
|
|
349
|
+
# The transport can fail after the service accepted the request but before
|
|
350
|
+
# returning an instance id, so creation cannot be reported as not_created.
|
|
351
|
+
raise E2BSandboxSessionError(
|
|
352
|
+
exc,
|
|
353
|
+
instance_status="unknown",
|
|
354
|
+
failure_stage="create",
|
|
355
|
+
) from exc
|
|
156
356
|
session = self._wrap_sandbox(sandbox)
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
357
|
+
try:
|
|
358
|
+
with self._diagnostic_step(
|
|
359
|
+
"initialize", runtime_id=session.sandbox_id, env=runtime_env
|
|
360
|
+
):
|
|
361
|
+
self._wait_until_ready(session, runtime_env)
|
|
362
|
+
with self._diagnostic_step(
|
|
363
|
+
"input_files.write", runtime_id=session.sandbox_id, env=runtime_env
|
|
364
|
+
):
|
|
365
|
+
session.write_files(
|
|
366
|
+
[(item.target_path, item.source.read_bytes()) for item in input_files or []]
|
|
367
|
+
)
|
|
368
|
+
except BaseException as exc:
|
|
369
|
+
cleanup_status = "not_started"
|
|
370
|
+
cleanup_error = None
|
|
371
|
+
try:
|
|
372
|
+
with self._diagnostic_step(
|
|
373
|
+
"initialize.cleanup", runtime_id=session.sandbox_id, env=runtime_env
|
|
374
|
+
):
|
|
375
|
+
session.kill()
|
|
376
|
+
cleanup_status = "completed"
|
|
377
|
+
except Exception:
|
|
378
|
+
cleanup_status = "failed"
|
|
379
|
+
cleanup_error = "cleanup_failed"
|
|
380
|
+
logger.warning("E2B sandbox cleanup failed after initialization failure")
|
|
381
|
+
if not isinstance(exc, Exception):
|
|
382
|
+
raise
|
|
383
|
+
raise E2BSandboxSessionError(
|
|
384
|
+
exc,
|
|
385
|
+
instance_status="created",
|
|
386
|
+
failure_stage="initialize",
|
|
387
|
+
runtime_id=session.sandbox_id,
|
|
388
|
+
cleanup_status=cleanup_status,
|
|
389
|
+
cleanup_error=cleanup_error,
|
|
390
|
+
) from exc
|
|
391
|
+
return session
|
|
392
|
+
|
|
393
|
+
def reconnect_session(self, *, session_locator: str) -> SandboxSession:
|
|
394
|
+
"""Reconnect to an existing E2B sandbox without recreating it."""
|
|
395
|
+
|
|
396
|
+
locator = session_locator.strip()
|
|
397
|
+
if not locator:
|
|
398
|
+
raise SandboxError("E2B reconnect requires a sandbox ID")
|
|
399
|
+
# Reconnection does not transfer ownership: failure must not kill an
|
|
400
|
+
# existing instance that may still be running another process's work.
|
|
401
|
+
with self._diagnostic_step("reconnect", runtime_id=locator):
|
|
402
|
+
sandbox_cls = self._get_sandbox_cls()
|
|
403
|
+
connection_options = (
|
|
404
|
+
self.connection.sdk_options() if self.connection is not None else {}
|
|
405
|
+
)
|
|
406
|
+
sandbox = sandbox_cls.connect(locator, timeout=self.spec.timeout, **connection_options)
|
|
407
|
+
session = self._wrap_sandbox(sandbox)
|
|
408
|
+
with self._diagnostic_step("reconnect.ready.command", runtime_id=session.sandbox_id):
|
|
409
|
+
_with_startup_retry(
|
|
410
|
+
lambda: session.run_command("true"),
|
|
411
|
+
step="reconnect.ready.command",
|
|
412
|
+
runtime_id=session.sandbox_id,
|
|
413
|
+
)
|
|
161
414
|
return session
|
|
162
415
|
|
|
163
416
|
def _wrap_sandbox(self, sandbox: Any) -> E2BSandboxSession:
|
|
@@ -166,9 +419,20 @@ class E2BSandboxBackend:
|
|
|
166
419
|
def _wait_until_ready(
|
|
167
420
|
self, session: E2BSandboxSession, env: dict[str, str] | None = None
|
|
168
421
|
) -> None:
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
422
|
+
with self._diagnostic_step("ready.command", runtime_id=session.sandbox_id, env=env):
|
|
423
|
+
_with_startup_retry(
|
|
424
|
+
lambda: session.run_command("true"),
|
|
425
|
+
step="ready.command",
|
|
426
|
+
runtime_id=session.sandbox_id,
|
|
427
|
+
)
|
|
428
|
+
with self._diagnostic_step("ready.file", runtime_id=session.sandbox_id, env=env):
|
|
429
|
+
_with_startup_retry(
|
|
430
|
+
lambda: session.write_file("/tmp/.ksadk-sandbox-ready", ""),
|
|
431
|
+
step="ready.file",
|
|
432
|
+
runtime_id=session.sandbox_id,
|
|
433
|
+
)
|
|
434
|
+
with self._diagnostic_step("ready.env", runtime_id=session.sandbox_id, env=env):
|
|
435
|
+
self._wait_env_applied(session, env or {})
|
|
172
436
|
|
|
173
437
|
def _wait_env_applied(self, session: E2BSandboxSession, env: dict[str, str]) -> None:
|
|
174
438
|
# create 返回后 envd 异步应用 envVars, 实测存在秒级延迟;
|
|
@@ -187,9 +451,8 @@ class E2BSandboxBackend:
|
|
|
187
451
|
# 不 raise: 模板可能预置同名空值覆盖 create 注入 (envd 合并优先级问题),
|
|
188
452
|
# 此时调用方仍可通过 run_command(env=...) 的 per-command 注入拿到正确值。
|
|
189
453
|
logger.warning(
|
|
190
|
-
"E2B sandbox env %s not applied after %d attempts
|
|
454
|
+
"E2B sandbox env %s not applied after %d attempts; "
|
|
191
455
|
"template may predefine an empty override",
|
|
192
456
|
key,
|
|
193
457
|
attempts,
|
|
194
|
-
expected,
|
|
195
458
|
)
|
|
@@ -1,17 +1,16 @@
|
|
|
1
1
|
from __future__ import annotations
|
|
2
2
|
|
|
3
3
|
import os
|
|
4
|
-
import signal
|
|
5
|
-
import subprocess
|
|
6
4
|
from pathlib import Path
|
|
7
5
|
|
|
8
6
|
from ksadk.sandbox.base import SandboxCommandResult, SandboxInputFile, SandboxSession
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
7
|
+
from ksadk.sandbox.local_controls import (
|
|
8
|
+
LocalControlSettings,
|
|
9
|
+
build_script_environment,
|
|
10
|
+
check_command,
|
|
11
|
+
resource_limit_reason,
|
|
12
|
+
run_bounded_process,
|
|
13
|
+
)
|
|
15
14
|
|
|
16
15
|
|
|
17
16
|
class LocalProcessSandboxSession:
|
|
@@ -22,6 +21,7 @@ class LocalProcessSandboxSession:
|
|
|
22
21
|
self._workspace_root = workspace_root.expanduser().resolve()
|
|
23
22
|
self._workspace_root.mkdir(parents=True, exist_ok=True)
|
|
24
23
|
self._backend_name = backend_name
|
|
24
|
+
self._controls = LocalControlSettings.from_trusted_host_env()
|
|
25
25
|
|
|
26
26
|
@property
|
|
27
27
|
def sandbox_id(self) -> str:
|
|
@@ -38,6 +38,15 @@ class LocalProcessSandboxSession:
|
|
|
38
38
|
def read_file(self, path: str) -> str:
|
|
39
39
|
return self._resolve_workspace_path(path).read_text(encoding="utf-8")
|
|
40
40
|
|
|
41
|
+
def read_file_bytes(self, path: str, *, max_bytes: int) -> bytes:
|
|
42
|
+
if type(max_bytes) is not int or max_bytes < 1:
|
|
43
|
+
raise ValueError("File download limit must be positive")
|
|
44
|
+
with self._resolve_workspace_path(path).open("rb") as source:
|
|
45
|
+
content = source.read(max_bytes + 1)
|
|
46
|
+
if len(content) > max_bytes:
|
|
47
|
+
raise ValueError("Sandbox file exceeds download limit")
|
|
48
|
+
return content
|
|
49
|
+
|
|
41
50
|
def run_command(
|
|
42
51
|
self,
|
|
43
52
|
command: str,
|
|
@@ -50,35 +59,56 @@ class LocalProcessSandboxSession:
|
|
|
50
59
|
resolved_cwd = self._resolve_cwd(cwd or (env or {}).get("KSADK_COMMAND_CWD"))
|
|
51
60
|
except ValueError as exc:
|
|
52
61
|
return SandboxCommandResult(stderr=str(exc), exit_code=126)
|
|
53
|
-
|
|
62
|
+
finding = check_command(
|
|
63
|
+
command,
|
|
64
|
+
cwd=resolved_cwd,
|
|
65
|
+
allowed_roots=(self._workspace_root,),
|
|
66
|
+
)
|
|
67
|
+
if finding is not None:
|
|
68
|
+
return SandboxCommandResult(
|
|
69
|
+
stderr=f"blocked by local-process policy: {finding.reason()}", exit_code=126
|
|
70
|
+
)
|
|
71
|
+
source_env = dict(os.environ)
|
|
72
|
+
source_env.update(env or {})
|
|
73
|
+
process_env = build_script_environment(source_env, settings=self._controls)
|
|
54
74
|
try:
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
75
|
+
effective_timeout = self._controls.wall_seconds
|
|
76
|
+
if timeout is not None:
|
|
77
|
+
effective_timeout = min(timeout, effective_timeout)
|
|
78
|
+
executed = run_bounded_process(
|
|
79
|
+
["/bin/sh", "-c", command],
|
|
58
80
|
cwd=resolved_cwd,
|
|
59
81
|
env=process_env,
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
stderr=subprocess.PIPE,
|
|
82
|
+
timeout=effective_timeout,
|
|
83
|
+
settings=self._controls,
|
|
63
84
|
start_new_session=True,
|
|
64
85
|
)
|
|
65
|
-
|
|
66
|
-
return SandboxCommandResult(
|
|
67
|
-
stdout=stdout,
|
|
68
|
-
stderr=stderr,
|
|
69
|
-
exit_code=process.returncode,
|
|
70
|
-
)
|
|
71
|
-
except subprocess.TimeoutExpired as exc:
|
|
72
|
-
try:
|
|
73
|
-
os.killpg(process.pid, signal.SIGKILL)
|
|
74
|
-
except Exception:
|
|
75
|
-
pass
|
|
76
|
-
stdout, stderr = process.communicate()
|
|
86
|
+
except (OSError, ValueError) as exc:
|
|
77
87
|
return SandboxCommandResult(
|
|
78
|
-
|
|
79
|
-
stderr=_coerce_output(stderr or exc.stderr) + "\ncommand timed out",
|
|
80
|
-
exit_code=124,
|
|
88
|
+
stderr=f"local-process controls failed: {exc}", exit_code=125
|
|
81
89
|
)
|
|
90
|
+
diagnostics: list[str] = []
|
|
91
|
+
if executed.controls.get("status") == "failed":
|
|
92
|
+
diagnostics.append("resource limits were not applied")
|
|
93
|
+
if executed.output_limit_exceeded:
|
|
94
|
+
diagnostics.append("command output limit exceeded")
|
|
95
|
+
if executed.timed_out:
|
|
96
|
+
diagnostics.append("command timed out")
|
|
97
|
+
if limit := resource_limit_reason(executed.exit_code):
|
|
98
|
+
diagnostics.append(f"command exceeded {limit} resource limit")
|
|
99
|
+
if executed.cleanup_error:
|
|
100
|
+
diagnostics.append("command process-group cleanup failed")
|
|
101
|
+
stderr = executed.stderr
|
|
102
|
+
if diagnostics:
|
|
103
|
+
stderr = (stderr.rstrip() + "\n" if stderr else "") + "; ".join(diagnostics)
|
|
104
|
+
exit_code = executed.exit_code
|
|
105
|
+
if executed.timed_out:
|
|
106
|
+
exit_code = 124
|
|
107
|
+
elif executed.output_limit_exceeded:
|
|
108
|
+
exit_code = 122
|
|
109
|
+
elif executed.controls.get("status") == "failed" or executed.cleanup_error:
|
|
110
|
+
exit_code = 125
|
|
111
|
+
return SandboxCommandResult(stdout=executed.stdout, stderr=stderr, exit_code=exit_code)
|
|
82
112
|
|
|
83
113
|
def get_host(self, port: int) -> str:
|
|
84
114
|
return f"http://127.0.0.1:{int(port)}"
|
|
@@ -95,24 +125,27 @@ class LocalProcessSandboxSession:
|
|
|
95
125
|
resolved = candidate.expanduser().resolve()
|
|
96
126
|
if resolved != self._workspace_root and self._workspace_root not in resolved.parents:
|
|
97
127
|
raise ValueError("cwd must stay inside the sandbox workspace")
|
|
128
|
+
self._reject_symlink_components(candidate)
|
|
98
129
|
return resolved
|
|
99
130
|
|
|
100
131
|
def _resolve_workspace_path(self, path: str) -> Path:
|
|
101
132
|
raw = str(path or "").strip().lstrip("/") or "."
|
|
133
|
+
self._reject_symlink_components(self._workspace_root / raw)
|
|
102
134
|
target = (self._workspace_root / raw).resolve()
|
|
103
135
|
if target != self._workspace_root and self._workspace_root not in target.parents:
|
|
104
136
|
raise ValueError("path must stay inside the sandbox workspace")
|
|
105
137
|
return target
|
|
106
138
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
139
|
+
def _reject_symlink_components(self, path: Path) -> None:
|
|
140
|
+
try:
|
|
141
|
+
relative = path.absolute().relative_to(self._workspace_root)
|
|
142
|
+
except ValueError:
|
|
143
|
+
raise ValueError("path must stay inside the sandbox workspace") from None
|
|
144
|
+
current = self._workspace_root
|
|
145
|
+
for part in relative.parts:
|
|
146
|
+
current = current / part
|
|
147
|
+
if current.is_symlink():
|
|
148
|
+
raise ValueError("sandbox file API does not follow symbolic links")
|
|
116
149
|
|
|
117
150
|
|
|
118
151
|
class LocalProcessSandboxBackend:
|
ksadk/sandbox/base.py
CHANGED
|
@@ -3,7 +3,7 @@ from __future__ import annotations
|
|
|
3
3
|
from dataclasses import dataclass, field
|
|
4
4
|
from enum import Enum
|
|
5
5
|
from pathlib import Path
|
|
6
|
-
from typing import Protocol
|
|
6
|
+
from typing import Protocol, runtime_checkable
|
|
7
7
|
|
|
8
8
|
|
|
9
9
|
class SandboxError(RuntimeError):
|
|
@@ -72,6 +72,8 @@ class SandboxSession(Protocol):
|
|
|
72
72
|
|
|
73
73
|
def read_file(self, path: str) -> str: ...
|
|
74
74
|
|
|
75
|
+
def read_file_bytes(self, path: str, *, max_bytes: int) -> bytes: ...
|
|
76
|
+
|
|
75
77
|
def run_command(
|
|
76
78
|
self,
|
|
77
79
|
command: str,
|
|
@@ -86,6 +88,56 @@ class SandboxSession(Protocol):
|
|
|
86
88
|
def kill(self) -> None: ...
|
|
87
89
|
|
|
88
90
|
|
|
91
|
+
@runtime_checkable
|
|
92
|
+
class SandboxCommandHandle(Protocol):
|
|
93
|
+
"""Optional handle for a command that can be stopped explicitly."""
|
|
94
|
+
|
|
95
|
+
def wait(self) -> SandboxCommandResult: ...
|
|
96
|
+
|
|
97
|
+
def kill(self) -> bool: ...
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
@runtime_checkable
|
|
101
|
+
class BackgroundCommandSandboxSession(Protocol):
|
|
102
|
+
"""Optional session extension used for truthful cooperative cancellation."""
|
|
103
|
+
|
|
104
|
+
def start_command(
|
|
105
|
+
self,
|
|
106
|
+
command: str,
|
|
107
|
+
*,
|
|
108
|
+
timeout: int | None = None,
|
|
109
|
+
env: dict[str, str] | None = None,
|
|
110
|
+
cwd: str | None = None,
|
|
111
|
+
) -> SandboxCommandHandle: ...
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
@runtime_checkable
|
|
115
|
+
class ReconnectableSandboxCommandHandle(SandboxCommandHandle, Protocol):
|
|
116
|
+
"""Optional command handle with a credential-free vendor process ID."""
|
|
117
|
+
|
|
118
|
+
@property
|
|
119
|
+
def process_id(self) -> int: ...
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
@runtime_checkable
|
|
123
|
+
class ReconnectableCommandSandboxSession(BackgroundCommandSandboxSession, Protocol):
|
|
124
|
+
"""Optional session extension for reconnecting an in-flight command."""
|
|
125
|
+
|
|
126
|
+
def connect_command(
|
|
127
|
+
self,
|
|
128
|
+
process_id: int,
|
|
129
|
+
*,
|
|
130
|
+
timeout: int | None = None,
|
|
131
|
+
) -> ReconnectableSandboxCommandHandle: ...
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
@runtime_checkable
|
|
135
|
+
class ArtifactListingSandboxSession(Protocol):
|
|
136
|
+
"""Optional session extension for bounded artifact enumeration."""
|
|
137
|
+
|
|
138
|
+
def list_files(self, root: str, *, recursive: bool = True) -> list[str]: ...
|
|
139
|
+
|
|
140
|
+
|
|
89
141
|
class SandboxBackend(Protocol):
|
|
90
142
|
def create_session(
|
|
91
143
|
self,
|
|
@@ -94,3 +146,14 @@ class SandboxBackend(Protocol):
|
|
|
94
146
|
env: dict[str, str] | None = None,
|
|
95
147
|
input_files: list[SandboxInputFile] | None = None,
|
|
96
148
|
) -> SandboxSession: ...
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
@runtime_checkable
|
|
152
|
+
class ReconnectableSandboxBackend(Protocol):
|
|
153
|
+
"""Optional SDK backend extension for reconnecting an existing session.
|
|
154
|
+
|
|
155
|
+
``session_locator`` is an opaque vendor locator (for example an E2B
|
|
156
|
+
sandbox ID). It must not contain credentials or environment values.
|
|
157
|
+
"""
|
|
158
|
+
|
|
159
|
+
def reconnect_session(self, *, session_locator: str) -> SandboxSession: ...
|