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
|
@@ -0,0 +1,746 @@
|
|
|
1
|
+
"""Immutable workspace snapshots and selective Codex plugin marketplaces.
|
|
2
|
+
|
|
3
|
+
Codex App Server owns plugin installation. Studio admits the installed bytes
|
|
4
|
+
into a content-addressed workspace store, then builds a small local
|
|
5
|
+
marketplace from those immutable bytes. Neither operation writes Codex's
|
|
6
|
+
host-managed cache directly.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
import hashlib
|
|
12
|
+
import json
|
|
13
|
+
import os
|
|
14
|
+
import re
|
|
15
|
+
import shutil
|
|
16
|
+
import stat
|
|
17
|
+
import tempfile
|
|
18
|
+
from pathlib import Path, PurePosixPath
|
|
19
|
+
from typing import Any, Iterable, Literal
|
|
20
|
+
|
|
21
|
+
from pydantic import Field, field_validator
|
|
22
|
+
|
|
23
|
+
from ksadk.plugins.codex_manifest import (
|
|
24
|
+
CodexInstalledPluginSnapshot,
|
|
25
|
+
CodexPluginComponentSnapshot,
|
|
26
|
+
CodexPluginManifest,
|
|
27
|
+
CodexPluginManifestError,
|
|
28
|
+
CodexPluginSourceCoordinate,
|
|
29
|
+
_load_installed_plugin,
|
|
30
|
+
snapshot_installed_codex_plugin,
|
|
31
|
+
)
|
|
32
|
+
from ksadk.studio.contracts import ContractModel
|
|
33
|
+
from ksadk.studio.errors import StudioError
|
|
34
|
+
from ksadk.studio.workspace import Workspace
|
|
35
|
+
|
|
36
|
+
_DIGEST = re.compile(r"^sha256:[0-9a-f]{64}$")
|
|
37
|
+
_PLUGIN_ID = re.compile(r"^[a-z0-9]+(?:[._-][a-z0-9]+)*$")
|
|
38
|
+
_SELECTOR = re.compile(r"^(skill|mcp|hook|app):(.+)$")
|
|
39
|
+
_CACHE_SEGMENT = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,255}$")
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
class CodexWorkspacePluginSnapshot(ContractModel):
|
|
43
|
+
"""Receipt for bytes copied into the workspace content-addressed store."""
|
|
44
|
+
|
|
45
|
+
snapshot_format: Literal["codex.workspace-plugin-snapshot/v1"] = (
|
|
46
|
+
"codex.workspace-plugin-snapshot/v1"
|
|
47
|
+
)
|
|
48
|
+
snapshot_digest: str
|
|
49
|
+
plugin_ref: str = Field(min_length=12, max_length=256)
|
|
50
|
+
content_path: str = Field(min_length=1, max_length=4096)
|
|
51
|
+
source: CodexPluginSourceCoordinate
|
|
52
|
+
manifest: CodexPluginManifest
|
|
53
|
+
manifest_digest: str
|
|
54
|
+
artifact_digest: str
|
|
55
|
+
components: tuple[CodexPluginComponentSnapshot, ...] = ()
|
|
56
|
+
|
|
57
|
+
@field_validator("snapshot_digest", "manifest_digest", "artifact_digest")
|
|
58
|
+
@classmethod
|
|
59
|
+
def validate_digest(cls, value: str) -> str:
|
|
60
|
+
if _DIGEST.fullmatch(value) is None:
|
|
61
|
+
raise ValueError("Codex snapshot digests must be lowercase sha256 values")
|
|
62
|
+
return value
|
|
63
|
+
|
|
64
|
+
@field_validator("content_path")
|
|
65
|
+
@classmethod
|
|
66
|
+
def validate_content_path(cls, value: str) -> str:
|
|
67
|
+
if "\\" in value:
|
|
68
|
+
raise ValueError("Codex snapshot contentPath must use POSIX separators")
|
|
69
|
+
path = PurePosixPath(value)
|
|
70
|
+
if path.is_absolute() or any(part in {"", ".", ".."} for part in path.parts):
|
|
71
|
+
raise ValueError("Codex snapshot contentPath must be workspace-relative")
|
|
72
|
+
return value
|
|
73
|
+
|
|
74
|
+
def select_components(
|
|
75
|
+
self, selectors: Iterable[str]
|
|
76
|
+
) -> tuple[CodexPluginComponentSnapshot, ...]:
|
|
77
|
+
requested = tuple(dict.fromkeys(str(item) for item in selectors))
|
|
78
|
+
by_selector = {component_selector(component): component for component in self.components}
|
|
79
|
+
missing = [selector for selector in requested if selector not in by_selector]
|
|
80
|
+
if missing:
|
|
81
|
+
raise StudioError(
|
|
82
|
+
"CODEX_PLUGIN_COMPONENT_NOT_FOUND",
|
|
83
|
+
"Codex 插件绑定引用了快照中不存在的组件",
|
|
84
|
+
status_code=422,
|
|
85
|
+
details={"pluginRef": self.plugin_ref, "components": missing},
|
|
86
|
+
)
|
|
87
|
+
return tuple(by_selector[selector] for selector in requested)
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
class CodexPinnedMarketplace(ContractModel):
|
|
91
|
+
marketplace_format: Literal["codex.pinned-marketplace/v1"] = "codex.pinned-marketplace/v1"
|
|
92
|
+
marketplace_name: str
|
|
93
|
+
marketplace_path: str
|
|
94
|
+
marketplace_digest: str
|
|
95
|
+
plugin_names: tuple[str, ...]
|
|
96
|
+
plugin_lock_digest: str
|
|
97
|
+
|
|
98
|
+
@field_validator("marketplace_digest", "plugin_lock_digest")
|
|
99
|
+
@classmethod
|
|
100
|
+
def validate_digest(cls, value: str) -> str:
|
|
101
|
+
if _DIGEST.fullmatch(value) is None:
|
|
102
|
+
raise ValueError("Codex marketplace digests must be lowercase sha256 values")
|
|
103
|
+
return value
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
def component_selector(component: CodexPluginComponentSnapshot) -> str:
|
|
107
|
+
return f"{component.kind}:{component.name}"
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
def codex_plugin_ref(manifest: CodexPluginManifest) -> str:
|
|
111
|
+
version = str(manifest.version or "")
|
|
112
|
+
if not version:
|
|
113
|
+
raise StudioError(
|
|
114
|
+
"CODEX_PLUGIN_VERSION_REQUIRED",
|
|
115
|
+
"Codex 插件必须声明精确版本后才能提交不可变快照",
|
|
116
|
+
status_code=422,
|
|
117
|
+
field="version",
|
|
118
|
+
)
|
|
119
|
+
candidate = str(manifest.id or "").strip().lower()
|
|
120
|
+
if not candidate or _PLUGIN_ID.fullmatch(candidate) is None:
|
|
121
|
+
candidate = f"codex.{manifest.name.lower()}"
|
|
122
|
+
if len(candidate) > 128 or _PLUGIN_ID.fullmatch(candidate) is None:
|
|
123
|
+
raise StudioError(
|
|
124
|
+
"CODEX_PLUGIN_ID_INVALID",
|
|
125
|
+
"Codex 插件无法映射为稳定的 plugin reference",
|
|
126
|
+
status_code=422,
|
|
127
|
+
details={"name": manifest.name, "id": manifest.id},
|
|
128
|
+
)
|
|
129
|
+
return f"plugin://{candidate}@{version}"
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
def _canonical_bytes(value: Any) -> bytes:
|
|
133
|
+
return json.dumps(
|
|
134
|
+
value,
|
|
135
|
+
ensure_ascii=False,
|
|
136
|
+
sort_keys=True,
|
|
137
|
+
separators=(",", ":"),
|
|
138
|
+
).encode("utf-8")
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
def _sha256(raw: bytes) -> str:
|
|
142
|
+
return "sha256:" + hashlib.sha256(raw).hexdigest()
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
def _snapshot_identity(snapshot: CodexInstalledPluginSnapshot) -> dict[str, Any]:
|
|
146
|
+
return {
|
|
147
|
+
"source": snapshot.source.model_dump(by_alias=True, exclude_none=True, mode="json"),
|
|
148
|
+
"manifest": snapshot.manifest.model_dump(by_alias=True, exclude_none=True, mode="json"),
|
|
149
|
+
"manifestDigest": snapshot.manifest_digest,
|
|
150
|
+
"artifactDigest": snapshot.artifact_digest,
|
|
151
|
+
"components": [
|
|
152
|
+
item.model_dump(by_alias=True, exclude_none=True, mode="json")
|
|
153
|
+
for item in snapshot.components
|
|
154
|
+
],
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
def _snapshot_digest(snapshot: CodexInstalledPluginSnapshot) -> str:
|
|
159
|
+
return _sha256(_canonical_bytes(_snapshot_identity(snapshot)))
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
def _same_snapshot(
|
|
163
|
+
expected: CodexInstalledPluginSnapshot,
|
|
164
|
+
actual: CodexInstalledPluginSnapshot,
|
|
165
|
+
) -> bool:
|
|
166
|
+
return _snapshot_identity(expected) == _snapshot_identity(actual)
|
|
167
|
+
|
|
168
|
+
|
|
169
|
+
def _tree_digest(root: Path) -> str:
|
|
170
|
+
digest = hashlib.sha256()
|
|
171
|
+
for candidate in sorted(root.rglob("*"), key=lambda path: path.relative_to(root).as_posix()):
|
|
172
|
+
relative = candidate.relative_to(root).as_posix()
|
|
173
|
+
if candidate.is_symlink():
|
|
174
|
+
raise StudioError(
|
|
175
|
+
"CODEX_PLUGIN_MARKETPLACE_INVALID",
|
|
176
|
+
"固定 Codex marketplace 不能包含符号链接",
|
|
177
|
+
status_code=409,
|
|
178
|
+
details={"path": relative},
|
|
179
|
+
)
|
|
180
|
+
if candidate.is_dir():
|
|
181
|
+
continue
|
|
182
|
+
if not candidate.is_file():
|
|
183
|
+
raise StudioError(
|
|
184
|
+
"CODEX_PLUGIN_MARKETPLACE_INVALID",
|
|
185
|
+
"固定 Codex marketplace 只能包含常规文件",
|
|
186
|
+
status_code=409,
|
|
187
|
+
details={"path": relative},
|
|
188
|
+
)
|
|
189
|
+
raw = candidate.read_bytes()
|
|
190
|
+
digest.update(relative.encode("utf-8"))
|
|
191
|
+
digest.update(b"\0")
|
|
192
|
+
digest.update(f"{stat.S_IMODE(candidate.stat().st_mode) & 0o111:03o}".encode("ascii"))
|
|
193
|
+
digest.update(b"\0")
|
|
194
|
+
digest.update(str(len(raw)).encode("ascii"))
|
|
195
|
+
digest.update(b"\0")
|
|
196
|
+
digest.update(raw)
|
|
197
|
+
digest.update(b"\0")
|
|
198
|
+
return "sha256:" + digest.hexdigest()
|
|
199
|
+
|
|
200
|
+
|
|
201
|
+
class CodexPluginSnapshotStore:
|
|
202
|
+
"""Content-addressed, copy-then-rehash store for installed Codex plugins."""
|
|
203
|
+
|
|
204
|
+
def __init__(self, workspace: Workspace) -> None:
|
|
205
|
+
self.workspace = workspace
|
|
206
|
+
self.root = workspace.resolve(".agentkit/codex-plugin-snapshots")
|
|
207
|
+
|
|
208
|
+
def lookup(self, snapshot: CodexInstalledPluginSnapshot) -> CodexWorkspacePluginSnapshot | None:
|
|
209
|
+
"""Return an already-admitted snapshot without mutating the workspace.
|
|
210
|
+
|
|
211
|
+
The installed bytes still need to be hashed to derive their content
|
|
212
|
+
address. Unlike :meth:`commit`, lookup never creates directories or
|
|
213
|
+
copies host-owned plugin bytes.
|
|
214
|
+
"""
|
|
215
|
+
|
|
216
|
+
digest = _snapshot_digest(snapshot)
|
|
217
|
+
receipt = self.root / digest.removeprefix("sha256:") / "snapshot.json"
|
|
218
|
+
if not receipt.is_file():
|
|
219
|
+
return None
|
|
220
|
+
return self.load(digest)
|
|
221
|
+
|
|
222
|
+
def commit(self, snapshot: CodexInstalledPluginSnapshot) -> CodexWorkspacePluginSnapshot:
|
|
223
|
+
source_root = Path(snapshot.installed_root)
|
|
224
|
+
try:
|
|
225
|
+
observed = snapshot_installed_codex_plugin(source_root, source=snapshot.source)
|
|
226
|
+
except CodexPluginManifestError as exc:
|
|
227
|
+
raise StudioError(
|
|
228
|
+
"CODEX_PLUGIN_SNAPSHOT_INVALID",
|
|
229
|
+
"Codex 插件安装目录无法提交快照",
|
|
230
|
+
status_code=422,
|
|
231
|
+
details={"reason": str(exc)},
|
|
232
|
+
) from exc
|
|
233
|
+
if not _same_snapshot(snapshot, observed):
|
|
234
|
+
raise StudioError(
|
|
235
|
+
"CODEX_PLUGIN_SOURCE_DRIFT",
|
|
236
|
+
"Codex 插件在提交快照前已发生变化",
|
|
237
|
+
status_code=409,
|
|
238
|
+
details={
|
|
239
|
+
"expected": snapshot.artifact_digest,
|
|
240
|
+
"actual": observed.artifact_digest,
|
|
241
|
+
},
|
|
242
|
+
)
|
|
243
|
+
|
|
244
|
+
digest = _snapshot_digest(observed)
|
|
245
|
+
suffix = digest.removeprefix("sha256:")
|
|
246
|
+
destination = self.workspace.resolve(self.root / suffix)
|
|
247
|
+
if destination.exists():
|
|
248
|
+
return self.load(digest)
|
|
249
|
+
|
|
250
|
+
self.root.mkdir(parents=True, exist_ok=True)
|
|
251
|
+
staging = Path(tempfile.mkdtemp(prefix=".codex-plugin-", dir=self.root))
|
|
252
|
+
try:
|
|
253
|
+
content = staging / "content"
|
|
254
|
+
# Preserve a racing symlink as a symlink. The second parser/hash
|
|
255
|
+
# rejects it instead of following it outside the admitted root.
|
|
256
|
+
shutil.copytree(source_root, content, symlinks=True)
|
|
257
|
+
try:
|
|
258
|
+
copied = snapshot_installed_codex_plugin(content, source=observed.source)
|
|
259
|
+
except CodexPluginManifestError as exc:
|
|
260
|
+
raise StudioError(
|
|
261
|
+
"CODEX_PLUGIN_COPY_DRIFT",
|
|
262
|
+
"Codex 插件复制期间发生不安全或不一致的变化",
|
|
263
|
+
status_code=409,
|
|
264
|
+
details={"reason": str(exc)},
|
|
265
|
+
) from exc
|
|
266
|
+
if not _same_snapshot(observed, copied):
|
|
267
|
+
raise StudioError(
|
|
268
|
+
"CODEX_PLUGIN_COPY_DRIFT",
|
|
269
|
+
"Codex 插件复制后的二次摘要不一致",
|
|
270
|
+
status_code=409,
|
|
271
|
+
details={
|
|
272
|
+
"expected": observed.artifact_digest,
|
|
273
|
+
"actual": copied.artifact_digest,
|
|
274
|
+
},
|
|
275
|
+
)
|
|
276
|
+
|
|
277
|
+
content_path = (destination / "content").relative_to(self.workspace.root).as_posix()
|
|
278
|
+
record = CodexWorkspacePluginSnapshot(
|
|
279
|
+
snapshot_digest=digest,
|
|
280
|
+
plugin_ref=codex_plugin_ref(copied.manifest),
|
|
281
|
+
content_path=content_path,
|
|
282
|
+
source=copied.source,
|
|
283
|
+
manifest=copied.manifest,
|
|
284
|
+
manifest_digest=copied.manifest_digest,
|
|
285
|
+
artifact_digest=copied.artifact_digest,
|
|
286
|
+
components=copied.components,
|
|
287
|
+
)
|
|
288
|
+
(staging / "snapshot.json").write_bytes(
|
|
289
|
+
json.dumps(
|
|
290
|
+
record.model_dump(by_alias=True, exclude_none=True, mode="json"),
|
|
291
|
+
ensure_ascii=False,
|
|
292
|
+
indent=2,
|
|
293
|
+
sort_keys=True,
|
|
294
|
+
).encode("utf-8")
|
|
295
|
+
+ b"\n"
|
|
296
|
+
)
|
|
297
|
+
try:
|
|
298
|
+
os.replace(staging, destination)
|
|
299
|
+
except FileExistsError:
|
|
300
|
+
# A concurrent identical commit won the content-addressed path.
|
|
301
|
+
pass
|
|
302
|
+
finally:
|
|
303
|
+
if staging.exists():
|
|
304
|
+
shutil.rmtree(staging)
|
|
305
|
+
return self.load(digest)
|
|
306
|
+
|
|
307
|
+
def load(self, digest: str) -> CodexWorkspacePluginSnapshot:
|
|
308
|
+
if _DIGEST.fullmatch(digest) is None:
|
|
309
|
+
raise StudioError(
|
|
310
|
+
"CODEX_PLUGIN_SNAPSHOT_DIGEST_INVALID",
|
|
311
|
+
"Codex 插件快照摘要格式无效",
|
|
312
|
+
status_code=422,
|
|
313
|
+
)
|
|
314
|
+
suffix = digest.removeprefix("sha256:")
|
|
315
|
+
directory = self.workspace.resolve(self.root / suffix)
|
|
316
|
+
receipt_path = self.workspace.resolve(directory / "snapshot.json")
|
|
317
|
+
if not receipt_path.is_file():
|
|
318
|
+
raise StudioError(
|
|
319
|
+
"CODEX_PLUGIN_SNAPSHOT_NOT_FOUND",
|
|
320
|
+
"Codex 插件快照不存在",
|
|
321
|
+
status_code=404,
|
|
322
|
+
details={"snapshotDigest": digest},
|
|
323
|
+
)
|
|
324
|
+
try:
|
|
325
|
+
record = CodexWorkspacePluginSnapshot.model_validate_json(
|
|
326
|
+
receipt_path.read_text(encoding="utf-8")
|
|
327
|
+
)
|
|
328
|
+
except (OSError, ValueError) as exc:
|
|
329
|
+
raise StudioError(
|
|
330
|
+
"CODEX_PLUGIN_SNAPSHOT_RECEIPT_INVALID",
|
|
331
|
+
"Codex 插件快照记录损坏",
|
|
332
|
+
status_code=409,
|
|
333
|
+
details={"snapshotDigest": digest},
|
|
334
|
+
) from exc
|
|
335
|
+
expected_content = (directory / "content").relative_to(self.workspace.root).as_posix()
|
|
336
|
+
if record.snapshot_digest != digest or record.content_path != expected_content:
|
|
337
|
+
raise StudioError(
|
|
338
|
+
"CODEX_PLUGIN_SNAPSHOT_RECEIPT_INVALID",
|
|
339
|
+
"Codex 插件快照记录与内容地址不一致",
|
|
340
|
+
status_code=409,
|
|
341
|
+
details={"snapshotDigest": digest},
|
|
342
|
+
)
|
|
343
|
+
content = self.workspace.resolve(record.content_path)
|
|
344
|
+
try:
|
|
345
|
+
observed = snapshot_installed_codex_plugin(content, source=record.source)
|
|
346
|
+
except CodexPluginManifestError as exc:
|
|
347
|
+
raise StudioError(
|
|
348
|
+
"CODEX_PLUGIN_SNAPSHOT_DRIFT",
|
|
349
|
+
"Codex 插件不可变快照已损坏或漂移",
|
|
350
|
+
status_code=409,
|
|
351
|
+
details={"snapshotDigest": digest, "reason": str(exc)},
|
|
352
|
+
) from exc
|
|
353
|
+
expected = CodexInstalledPluginSnapshot(
|
|
354
|
+
installed_root=str(content),
|
|
355
|
+
source=record.source,
|
|
356
|
+
manifest=record.manifest,
|
|
357
|
+
manifest_digest=record.manifest_digest,
|
|
358
|
+
artifact_digest=record.artifact_digest,
|
|
359
|
+
components=record.components,
|
|
360
|
+
)
|
|
361
|
+
if not _same_snapshot(expected, observed) or _snapshot_digest(observed) != digest:
|
|
362
|
+
raise StudioError(
|
|
363
|
+
"CODEX_PLUGIN_SNAPSHOT_DRIFT",
|
|
364
|
+
"Codex 插件不可变快照的内容摘要已漂移",
|
|
365
|
+
status_code=409,
|
|
366
|
+
details={
|
|
367
|
+
"snapshotDigest": digest,
|
|
368
|
+
"expectedArtifactDigest": record.artifact_digest,
|
|
369
|
+
"actualArtifactDigest": observed.artifact_digest,
|
|
370
|
+
},
|
|
371
|
+
)
|
|
372
|
+
return record
|
|
373
|
+
|
|
374
|
+
def content_root(self, snapshot: CodexWorkspacePluginSnapshot) -> Path:
|
|
375
|
+
return self.workspace.resolve(snapshot.content_path, must_exist=True)
|
|
376
|
+
|
|
377
|
+
def verify_marketplace(self, receipt: CodexPinnedMarketplace) -> Path:
|
|
378
|
+
root = self.workspace.resolve(receipt.marketplace_path, must_exist=True)
|
|
379
|
+
actual = _tree_digest(root)
|
|
380
|
+
if actual != receipt.marketplace_digest:
|
|
381
|
+
raise StudioError(
|
|
382
|
+
"CODEX_PLUGIN_MARKETPLACE_DRIFT",
|
|
383
|
+
"固定 Codex marketplace 已发生漂移",
|
|
384
|
+
status_code=409,
|
|
385
|
+
details={
|
|
386
|
+
"pluginLockDigest": receipt.plugin_lock_digest,
|
|
387
|
+
"expected": receipt.marketplace_digest,
|
|
388
|
+
"actual": actual,
|
|
389
|
+
},
|
|
390
|
+
)
|
|
391
|
+
return root
|
|
392
|
+
|
|
393
|
+
def materialize_marketplace(
|
|
394
|
+
self,
|
|
395
|
+
*,
|
|
396
|
+
plugin_lock_digest: str,
|
|
397
|
+
selections: Iterable[
|
|
398
|
+
tuple[CodexWorkspacePluginSnapshot, tuple[CodexPluginComponentSnapshot, ...]]
|
|
399
|
+
],
|
|
400
|
+
) -> CodexPinnedMarketplace:
|
|
401
|
+
"""Build a deterministic local marketplace with selected declarations only."""
|
|
402
|
+
|
|
403
|
+
if _DIGEST.fullmatch(plugin_lock_digest) is None:
|
|
404
|
+
raise ValueError("plugin_lock_digest must be a lowercase sha256 digest")
|
|
405
|
+
selected_plugins = tuple(selections)
|
|
406
|
+
suffix = plugin_lock_digest.removeprefix("sha256:")
|
|
407
|
+
directory = self.workspace.resolve(Path(".agentkit/codex-plugin-marketplaces") / suffix)
|
|
408
|
+
receipt_path = directory / "receipt.json"
|
|
409
|
+
if receipt_path.is_file():
|
|
410
|
+
receipt = CodexPinnedMarketplace.model_validate_json(
|
|
411
|
+
receipt_path.read_text(encoding="utf-8")
|
|
412
|
+
)
|
|
413
|
+
root = self.workspace.resolve(receipt.marketplace_path, must_exist=True)
|
|
414
|
+
if (
|
|
415
|
+
receipt.plugin_lock_digest != plugin_lock_digest
|
|
416
|
+
or _tree_digest(root) != receipt.marketplace_digest
|
|
417
|
+
):
|
|
418
|
+
raise StudioError(
|
|
419
|
+
"CODEX_PLUGIN_MARKETPLACE_DRIFT",
|
|
420
|
+
"固定 Codex marketplace 已发生漂移",
|
|
421
|
+
status_code=409,
|
|
422
|
+
details={"pluginLockDigest": plugin_lock_digest},
|
|
423
|
+
)
|
|
424
|
+
return receipt
|
|
425
|
+
|
|
426
|
+
directory.parent.mkdir(parents=True, exist_ok=True)
|
|
427
|
+
staging = Path(tempfile.mkdtemp(prefix=".codex-marketplace-", dir=directory.parent))
|
|
428
|
+
try:
|
|
429
|
+
root = staging / "marketplace"
|
|
430
|
+
plugins_root = root / "plugins"
|
|
431
|
+
plugins_root.mkdir(parents=True)
|
|
432
|
+
plugin_entries: list[dict[str, Any]] = []
|
|
433
|
+
plugin_names: list[str] = []
|
|
434
|
+
ordered_plugins = sorted(
|
|
435
|
+
selected_plugins,
|
|
436
|
+
key=lambda item: (item[0].manifest.name, item[0].plugin_ref),
|
|
437
|
+
)
|
|
438
|
+
names = [item[0].manifest.name for item in ordered_plugins]
|
|
439
|
+
if len(names) != len(set(names)):
|
|
440
|
+
raise StudioError(
|
|
441
|
+
"CODEX_PLUGIN_MARKETPLACE_NAME_CONFLICT",
|
|
442
|
+
"多个 Codex 插件快照映射到相同的原生插件名称",
|
|
443
|
+
status_code=422,
|
|
444
|
+
details={"pluginNames": names},
|
|
445
|
+
)
|
|
446
|
+
for snapshot, components in ordered_plugins:
|
|
447
|
+
# Revalidate the immutable source immediately before copying.
|
|
448
|
+
snapshot = self.load(snapshot.snapshot_digest)
|
|
449
|
+
name = snapshot.manifest.name
|
|
450
|
+
target = plugins_root / name
|
|
451
|
+
shutil.copytree(self.content_root(snapshot), target, symlinks=True)
|
|
452
|
+
self._retain_selected_components(target, components)
|
|
453
|
+
plugin_names.append(name)
|
|
454
|
+
plugin_entries.append(
|
|
455
|
+
{
|
|
456
|
+
"name": name,
|
|
457
|
+
"source": {"source": "local", "path": f"./plugins/{name}"},
|
|
458
|
+
"policy": {
|
|
459
|
+
"installation": "AVAILABLE",
|
|
460
|
+
"authentication": "ON_INSTALL",
|
|
461
|
+
},
|
|
462
|
+
"category": (
|
|
463
|
+
snapshot.manifest.interface.category
|
|
464
|
+
if snapshot.manifest.interface and snapshot.manifest.interface.category
|
|
465
|
+
else "Productivity"
|
|
466
|
+
),
|
|
467
|
+
}
|
|
468
|
+
)
|
|
469
|
+
marketplace_name = f"ksadk-{suffix[:20]}"
|
|
470
|
+
marketplace = {
|
|
471
|
+
"name": marketplace_name,
|
|
472
|
+
"interface": {"displayName": "KsADK pinned plugins"},
|
|
473
|
+
"plugins": plugin_entries,
|
|
474
|
+
}
|
|
475
|
+
marketplace_path = root / ".agents" / "plugins" / "marketplace.json"
|
|
476
|
+
marketplace_path.parent.mkdir(parents=True)
|
|
477
|
+
marketplace_path.write_bytes(
|
|
478
|
+
json.dumps(marketplace, ensure_ascii=False, indent=2, sort_keys=True).encode(
|
|
479
|
+
"utf-8"
|
|
480
|
+
)
|
|
481
|
+
+ b"\n"
|
|
482
|
+
)
|
|
483
|
+
digest = _tree_digest(root)
|
|
484
|
+
final_root = directory / "marketplace"
|
|
485
|
+
receipt = CodexPinnedMarketplace(
|
|
486
|
+
marketplace_name=marketplace_name,
|
|
487
|
+
marketplace_path=final_root.relative_to(self.workspace.root).as_posix(),
|
|
488
|
+
marketplace_digest=digest,
|
|
489
|
+
plugin_names=tuple(plugin_names),
|
|
490
|
+
plugin_lock_digest=plugin_lock_digest,
|
|
491
|
+
)
|
|
492
|
+
(staging / "receipt.json").write_bytes(
|
|
493
|
+
json.dumps(
|
|
494
|
+
receipt.model_dump(by_alias=True, mode="json"),
|
|
495
|
+
ensure_ascii=False,
|
|
496
|
+
indent=2,
|
|
497
|
+
sort_keys=True,
|
|
498
|
+
).encode("utf-8")
|
|
499
|
+
+ b"\n"
|
|
500
|
+
)
|
|
501
|
+
try:
|
|
502
|
+
os.replace(staging, directory)
|
|
503
|
+
except FileExistsError:
|
|
504
|
+
pass
|
|
505
|
+
finally:
|
|
506
|
+
if staging.exists():
|
|
507
|
+
shutil.rmtree(staging)
|
|
508
|
+
return self.materialize_marketplace(
|
|
509
|
+
plugin_lock_digest=plugin_lock_digest,
|
|
510
|
+
selections=selected_plugins,
|
|
511
|
+
)
|
|
512
|
+
|
|
513
|
+
@staticmethod
|
|
514
|
+
def _retain_selected_components(
|
|
515
|
+
root: Path,
|
|
516
|
+
selected: tuple[CodexPluginComponentSnapshot, ...],
|
|
517
|
+
) -> None:
|
|
518
|
+
selected_keys = {(component.kind, component.name) for component in selected}
|
|
519
|
+
(
|
|
520
|
+
_validated_root,
|
|
521
|
+
manifest,
|
|
522
|
+
_raw,
|
|
523
|
+
skills,
|
|
524
|
+
mcp_servers,
|
|
525
|
+
hooks,
|
|
526
|
+
apps,
|
|
527
|
+
) = _load_installed_plugin(root)
|
|
528
|
+
|
|
529
|
+
# The parser deliberately preserves additive upstream fields so the
|
|
530
|
+
# inventory/read path remains forward compatible. Selective
|
|
531
|
+
# materialization is an execution boundary, however: an unknown
|
|
532
|
+
# top-level field could name a new executable component that this
|
|
533
|
+
# implementation does not know how to remove. Fail closed until the
|
|
534
|
+
# field has explicit selection semantics.
|
|
535
|
+
if manifest.model_extra:
|
|
536
|
+
raise StudioError(
|
|
537
|
+
"CODEX_PLUGIN_MANIFEST_EXTENSION_UNSUPPORTED",
|
|
538
|
+
"Codex 插件包含尚未支持的可执行清单字段,无法安全裁剪组件",
|
|
539
|
+
status_code=422,
|
|
540
|
+
details={"fields": sorted(manifest.model_extra)},
|
|
541
|
+
)
|
|
542
|
+
|
|
543
|
+
# Copy selected skill trees aside, remove every discovered skill tree,
|
|
544
|
+
# then publish only the selected ones under the canonical skills root.
|
|
545
|
+
skill_staging = Path(tempfile.mkdtemp(prefix=".selected-skills-", dir=root))
|
|
546
|
+
try:
|
|
547
|
+
for name, source in skills:
|
|
548
|
+
if ("skill", name) in selected_keys:
|
|
549
|
+
shutil.copytree(source, skill_staging / name)
|
|
550
|
+
for _name, source in sorted(skills, key=lambda item: len(item[1].parts), reverse=True):
|
|
551
|
+
if source.exists():
|
|
552
|
+
shutil.rmtree(source)
|
|
553
|
+
canonical_skills = root / "skills"
|
|
554
|
+
if canonical_skills.exists():
|
|
555
|
+
shutil.rmtree(canonical_skills)
|
|
556
|
+
if any(kind == "skill" for kind, _name in selected_keys):
|
|
557
|
+
canonical_skills.mkdir(parents=True)
|
|
558
|
+
for source in sorted(skill_staging.iterdir(), key=lambda item: item.name):
|
|
559
|
+
shutil.copytree(source, canonical_skills / source.name)
|
|
560
|
+
finally:
|
|
561
|
+
shutil.rmtree(skill_staging, ignore_errors=True)
|
|
562
|
+
|
|
563
|
+
# Remove all source declaration files before writing canonical selected
|
|
564
|
+
# companions. Inline MCP declarations are replaced in plugin.json.
|
|
565
|
+
companion_paths = {
|
|
566
|
+
relative for _name, _config, relative in (*mcp_servers, *hooks, *apps) if relative
|
|
567
|
+
}
|
|
568
|
+
if isinstance(manifest.mcp_servers, str):
|
|
569
|
+
companion_paths.add(manifest.mcp_servers)
|
|
570
|
+
if manifest.apps:
|
|
571
|
+
companion_paths.add(manifest.apps)
|
|
572
|
+
if isinstance(manifest.hooks, str):
|
|
573
|
+
companion_paths.add(manifest.hooks)
|
|
574
|
+
elif isinstance(manifest.hooks, tuple):
|
|
575
|
+
companion_paths.update(item for item in manifest.hooks if isinstance(item, str))
|
|
576
|
+
elif manifest.hooks is None and (root / "hooks" / "hooks.json").is_file():
|
|
577
|
+
companion_paths.add("./hooks/hooks.json")
|
|
578
|
+
for relative in companion_paths:
|
|
579
|
+
candidate = root / PurePosixPath(relative)
|
|
580
|
+
if candidate.is_file():
|
|
581
|
+
candidate.unlink()
|
|
582
|
+
selected_mcp = {
|
|
583
|
+
name: config for name, config, _path in mcp_servers if ("mcp", name) in selected_keys
|
|
584
|
+
}
|
|
585
|
+
selected_hooks = {
|
|
586
|
+
name: config["hooks"]
|
|
587
|
+
for name, config, _path in hooks
|
|
588
|
+
if ("hook", name) in selected_keys
|
|
589
|
+
}
|
|
590
|
+
selected_apps = {
|
|
591
|
+
name: config for name, config, _path in apps if ("app", name) in selected_keys
|
|
592
|
+
}
|
|
593
|
+
if selected_mcp:
|
|
594
|
+
(root / ".mcp.json").write_bytes(_canonical_bytes({"mcpServers": selected_mcp}) + b"\n")
|
|
595
|
+
if selected_hooks:
|
|
596
|
+
(root / "hooks.json").write_bytes(_canonical_bytes({"hooks": selected_hooks}) + b"\n")
|
|
597
|
+
if selected_apps:
|
|
598
|
+
(root / ".app.json").write_bytes(_canonical_bytes({"apps": selected_apps}) + b"\n")
|
|
599
|
+
|
|
600
|
+
payload = manifest.model_dump(by_alias=True, exclude_none=True, mode="json")
|
|
601
|
+
for key in ("skills", "mcpServers", "mcp_servers", "hooks", "apps"):
|
|
602
|
+
payload.pop(key, None)
|
|
603
|
+
if any(kind == "skill" for kind, _name in selected_keys):
|
|
604
|
+
payload["skills"] = "./skills/"
|
|
605
|
+
if selected_mcp:
|
|
606
|
+
payload["mcpServers"] = "./.mcp.json"
|
|
607
|
+
if selected_hooks:
|
|
608
|
+
payload["hooks"] = "./hooks.json"
|
|
609
|
+
if selected_apps:
|
|
610
|
+
payload["apps"] = "./.app.json"
|
|
611
|
+
manifest_path = root / ".codex-plugin" / "plugin.json"
|
|
612
|
+
manifest_path.write_bytes(
|
|
613
|
+
json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True).encode("utf-8")
|
|
614
|
+
+ b"\n"
|
|
615
|
+
)
|
|
616
|
+
# The same strict parser used at admission must accept generated bytes.
|
|
617
|
+
_load_installed_plugin(root)
|
|
618
|
+
|
|
619
|
+
|
|
620
|
+
def find_installed_codex_plugin_root(
|
|
621
|
+
codex_home: Path,
|
|
622
|
+
*,
|
|
623
|
+
marketplace_name: str,
|
|
624
|
+
plugin_name: str,
|
|
625
|
+
version: str | None,
|
|
626
|
+
) -> Path:
|
|
627
|
+
"""Locate the App Server-owned cache root without assuming it is writable."""
|
|
628
|
+
|
|
629
|
+
coordinates = {
|
|
630
|
+
"marketplaceName": marketplace_name,
|
|
631
|
+
"pluginName": plugin_name,
|
|
632
|
+
"version": version,
|
|
633
|
+
}
|
|
634
|
+
invalid = [
|
|
635
|
+
field
|
|
636
|
+
for field, value in coordinates.items()
|
|
637
|
+
if value is not None and _CACHE_SEGMENT.fullmatch(value) is None
|
|
638
|
+
]
|
|
639
|
+
if invalid:
|
|
640
|
+
raise StudioError(
|
|
641
|
+
"CODEX_PLUGIN_CACHE_COORDINATE_INVALID",
|
|
642
|
+
"Codex 宿主返回的插件缓存坐标不是安全的单一路径段",
|
|
643
|
+
status_code=409,
|
|
644
|
+
details={"fields": invalid, **coordinates},
|
|
645
|
+
)
|
|
646
|
+
|
|
647
|
+
home = Path(codex_home).expanduser().resolve()
|
|
648
|
+
cache_path = home / "plugins" / "cache"
|
|
649
|
+
if any(path.is_symlink() for path in (home / "plugins", cache_path)):
|
|
650
|
+
raise StudioError(
|
|
651
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_UNSAFE",
|
|
652
|
+
"Codex 插件缓存路径不能经过符号链接",
|
|
653
|
+
status_code=409,
|
|
654
|
+
details={"cache": str(cache_path)},
|
|
655
|
+
)
|
|
656
|
+
try:
|
|
657
|
+
cache = cache_path.resolve(strict=True) if cache_path.exists() else cache_path.resolve()
|
|
658
|
+
except OSError as exc:
|
|
659
|
+
raise StudioError(
|
|
660
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_UNSAFE",
|
|
661
|
+
"Codex 插件缓存路径无法安全解析",
|
|
662
|
+
status_code=409,
|
|
663
|
+
details={"cache": str(cache_path)},
|
|
664
|
+
) from exc
|
|
665
|
+
try:
|
|
666
|
+
cache.relative_to(home)
|
|
667
|
+
except ValueError as exc: # defensive if platform resolution semantics change
|
|
668
|
+
raise StudioError(
|
|
669
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_UNSAFE",
|
|
670
|
+
"Codex 插件缓存路径越出 CODEX_HOME",
|
|
671
|
+
status_code=409,
|
|
672
|
+
details={"cache": str(cache)},
|
|
673
|
+
) from exc
|
|
674
|
+
|
|
675
|
+
def safe_root(candidate: Path) -> Path:
|
|
676
|
+
try:
|
|
677
|
+
relative = candidate.relative_to(cache_path)
|
|
678
|
+
except ValueError as exc:
|
|
679
|
+
raise StudioError(
|
|
680
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_UNSAFE",
|
|
681
|
+
"Codex 插件安装目录不在宿主缓存内",
|
|
682
|
+
status_code=409,
|
|
683
|
+
details={"path": str(candidate)},
|
|
684
|
+
) from exc
|
|
685
|
+
cursor = cache_path
|
|
686
|
+
for part in relative.parts:
|
|
687
|
+
cursor /= part
|
|
688
|
+
if cursor.is_symlink():
|
|
689
|
+
raise StudioError(
|
|
690
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_UNSAFE",
|
|
691
|
+
"Codex 插件安装目录不能经过符号链接",
|
|
692
|
+
status_code=409,
|
|
693
|
+
details={"path": str(candidate)},
|
|
694
|
+
)
|
|
695
|
+
try:
|
|
696
|
+
resolved = candidate.resolve(strict=True)
|
|
697
|
+
resolved.relative_to(cache)
|
|
698
|
+
except (OSError, ValueError) as exc:
|
|
699
|
+
raise StudioError(
|
|
700
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_UNSAFE",
|
|
701
|
+
"Codex 插件安装目录越出宿主缓存或无法安全解析",
|
|
702
|
+
status_code=409,
|
|
703
|
+
details={"path": str(candidate)},
|
|
704
|
+
) from exc
|
|
705
|
+
return resolved
|
|
706
|
+
|
|
707
|
+
candidates: list[Path] = []
|
|
708
|
+
if version:
|
|
709
|
+
expected = cache / marketplace_name / plugin_name / version
|
|
710
|
+
if expected.is_dir():
|
|
711
|
+
candidates.append(safe_root(expected))
|
|
712
|
+
if cache.is_dir():
|
|
713
|
+
for manifest_path in cache.glob("*/*/*/.codex-plugin/plugin.json"):
|
|
714
|
+
root = safe_root(manifest_path.parent.parent)
|
|
715
|
+
if root not in candidates:
|
|
716
|
+
try:
|
|
717
|
+
manifest = _load_installed_plugin(root)[1]
|
|
718
|
+
except CodexPluginManifestError:
|
|
719
|
+
continue
|
|
720
|
+
if manifest.name == plugin_name and (
|
|
721
|
+
version is None or manifest.version == version or root.name == version
|
|
722
|
+
):
|
|
723
|
+
candidates.append(root)
|
|
724
|
+
if len(candidates) != 1:
|
|
725
|
+
raise StudioError(
|
|
726
|
+
"CODEX_PLUGIN_INSTALLED_ROOT_NOT_FOUND",
|
|
727
|
+
"无法唯一定位 Codex App Server 安装的插件目录",
|
|
728
|
+
status_code=409,
|
|
729
|
+
details={
|
|
730
|
+
"marketplaceName": marketplace_name,
|
|
731
|
+
"pluginName": plugin_name,
|
|
732
|
+
"version": version,
|
|
733
|
+
"matches": [str(path) for path in candidates],
|
|
734
|
+
},
|
|
735
|
+
)
|
|
736
|
+
return candidates[0]
|
|
737
|
+
|
|
738
|
+
|
|
739
|
+
__all__ = [
|
|
740
|
+
"CodexPinnedMarketplace",
|
|
741
|
+
"CodexPluginSnapshotStore",
|
|
742
|
+
"CodexWorkspacePluginSnapshot",
|
|
743
|
+
"codex_plugin_ref",
|
|
744
|
+
"component_selector",
|
|
745
|
+
"find_installed_codex_plugin_root",
|
|
746
|
+
]
|