agentengine-sdk-python 0.8.2__py3-none-any.whl → 0.8.3__py3-none-any.whl

ksadk/plugins/__init__.py

@@ -0,0 +1,167 @@
+"""Versioned contracts for the Phase 2 plugin composition boundary.
+
+This package models discovery, deterministic locking, and the controlled
+PluginHost lifecycle.  It does not create a second runtime/event store;
+providers keep their native execution authority behind these contracts.
+"""
+
+from ksadk.plugins.bundle import (
+    PluginBundleError,
+    PluginBundleResolver,
+    ResolvedPluginBundle,
+)
+from ksadk.plugins.context_contributor import (
+    AuthenticatedContextScope,
+    ContextClassification,
+    ContextContributorCacheability,
+    ContextContributorCapabilities,
+    ContextContributorExchange,
+    ContextContributorFailureMode,
+    ContextContributorRequest,
+    ContextContributorResponse,
+    ContextFragment,
+    ContextSourceReference,
+    ProjectedContextContribution,
+    context_contributor_json_schema,
+)
+from ksadk.plugins.contracts import (
+    CapabilityDefinition,
+    CompositionProfile,
+    PluginInventory,
+    PluginLock,
+    canonical_plugin_lock,
+    plugin_lock_digest,
+)
+from ksadk.plugins.ecosystem_bridge import (
+    BridgeAction,
+    BridgeCommitRequest,
+    BridgeCommitResult,
+    BridgeDescribeRequest,
+    BridgeDescribeResult,
+    BridgeDescriptor,
+    BridgeDisposeRequest,
+    BridgeDisposeResult,
+    BridgeHostObservation,
+    BridgeHostRequirement,
+    BridgeInspectExchange,
+    BridgeInspectRequest,
+    BridgeInspectResult,
+    BridgePlanRequest,
+    BridgePlanResult,
+    BridgeProbeExchange,
+    BridgeProbeRequest,
+    BridgeProbeResult,
+    BridgeReconcileRequest,
+    BridgeReconcileResult,
+    BridgeRejection,
+    BridgeRollbackRequest,
+    BridgeRollbackResult,
+    BridgeStageRequest,
+    BridgeStageResult,
+    BridgeTransitionPlan,
+    EcosystemInstallReceipt,
+    EcosystemPluginDescriptor,
+    EcosystemPluginInventory,
+    PluginDesiredState,
+    PluginEcosystem,
+    PluginEcosystemBridge,
+    PluginEcosystemBridgeFixture,
+    PluginEcosystemBridgeTranscript,
+    PluginIntegrationMode,
+    PluginManifestCandidate,
+    PluginObservedState,
+    PluginSupportMaturity,
+    ecosystem_bridge_json_schema,
+)
+from ksadk.plugins.ecosystem_probe import EcosystemProbeError, probe_ecosystem_manifests
+from ksadk.plugins.host import (
+    ExecutableAgentProvider,
+    PluginActivationSession,
+    PluginCapabilityBinding,
+    PluginExecutionContext,
+    PluginHost,
+    PluginHostError,
+    PreparedAgent,
+)
+from ksadk.plugins.resolver import (
+    PluginRegistry,
+    PluginResolutionError,
+    ResolvedComposition,
+    composition_profile_digest,
+)
+
+__all__ = [
+    "AuthenticatedContextScope",
+    "BridgeAction",
+    "BridgeCommitRequest",
+    "BridgeCommitResult",
+    "BridgeDescribeRequest",
+    "BridgeDescribeResult",
+    "BridgeDescriptor",
+    "BridgeDisposeRequest",
+    "BridgeDisposeResult",
+    "BridgeHostObservation",
+    "BridgeHostRequirement",
+    "BridgeInspectExchange",
+    "BridgeInspectRequest",
+    "BridgeInspectResult",
+    "BridgePlanRequest",
+    "BridgePlanResult",
+    "BridgeProbeExchange",
+    "BridgeProbeRequest",
+    "BridgeProbeResult",
+    "BridgeReconcileRequest",
+    "BridgeReconcileResult",
+    "BridgeRejection",
+    "BridgeRollbackRequest",
+    "BridgeRollbackResult",
+    "BridgeStageRequest",
+    "BridgeStageResult",
+    "BridgeTransitionPlan",
+    "CapabilityDefinition",
+    "CompositionProfile",
+    "ContextClassification",
+    "ContextContributorCacheability",
+    "ContextContributorCapabilities",
+    "ContextContributorExchange",
+    "ContextContributorFailureMode",
+    "ContextContributorRequest",
+    "ContextContributorResponse",
+    "ContextFragment",
+    "ContextSourceReference",
+    "EcosystemInstallReceipt",
+    "EcosystemProbeError",
+    "EcosystemPluginDescriptor",
+    "EcosystemPluginInventory",
+    "PluginInventory",
+    "PluginLock",
+    "PluginDesiredState",
+    "PluginEcosystem",
+    "PluginEcosystemBridge",
+    "PluginEcosystemBridgeFixture",
+    "PluginEcosystemBridgeTranscript",
+    "PluginIntegrationMode",
+    "PluginManifestCandidate",
+    "PluginObservedState",
+    "PluginSupportMaturity",
+    "PluginBundleError",
+    "PluginBundleResolver",
+    "ResolvedPluginBundle",
+    "ExecutableAgentProvider",
+    "PluginActivationSession",
+    "PluginCapabilityBinding",
+    "PluginExecutionContext",
+    "PluginHost",
+    "PluginHostError",
+    "PreparedAgent",
+    "PluginRegistry",
+    "PluginResolutionError",
+    "ProjectedContextContribution",
+    "ResolvedComposition",
+    "composition_profile_digest",
+    "context_contributor_json_schema",
+    "ecosystem_bridge_json_schema",
+    "canonical_plugin_lock",
+    "plugin_lock_digest",
+    "probe_ecosystem_manifests",
+]

ksadk/plugins/bridges/__init__.py

@@ -0,0 +1,45 @@
+"""Native-host ecosystem bridges.
+
+Bridges keep each ecosystem's executable ABI inside its native host.  They do
+not add a generic plugin execution API to KsADK.
+"""
+
+from ksadk.plugins.bridges.codex import (
+    CodexAppServerPluginBridge,
+    CodexBridgeError,
+    CodexPluginApprovalRequired,
+    CodexPluginDetail,
+    CodexPluginInventory,
+    CodexPluginNotFoundError,
+)
+from ksadk.plugins.bridges.dsh import (
+    DshBridgeError,
+    DshBridgeHost,
+    DshClientBundle,
+    DshHostUnavailableError,
+    DshPluginApprovalRequired,
+    DshPluginInventory,
+    DshPluginMutationError,
+    DshPluginNotFoundError,
+    DshProfilePluginBridge,
+    DshProfileProjection,
+)
+
+__all__ = [
+    "CodexAppServerPluginBridge",
+    "CodexBridgeError",
+    "CodexPluginApprovalRequired",
+    "CodexPluginDetail",
+    "CodexPluginInventory",
+    "CodexPluginNotFoundError",
+    "DshBridgeError",
+    "DshBridgeHost",
+    "DshClientBundle",
+    "DshHostUnavailableError",
+    "DshPluginApprovalRequired",
+    "DshPluginInventory",
+    "DshPluginMutationError",
+    "DshPluginNotFoundError",
+    "DshProfilePluginBridge",
+    "DshProfileProjection",
+]