agent_hypervisor 3.1.0__py3-none-any.whl

agent_hypervisor-3.1.0.dist-info/RECORD

@@ -0,0 +1,60 @@
+hypervisor/__init__.py,sha256=XaycXw_46Ct306g7MIB8Ow3kp0F5NfY9qJGnPBrMvds,4516
+hypervisor/constants.py,sha256=UQ8c1E4dVPOlVeXwXd6CKkNx_3tYvg_x2RDIl--hqV8,4187
+hypervisor/core.py,sha256=ZrBivTP2rLGxp0RvIF0sRHnO-BdKYKsjdgwkMTZXSkQ,12868
+hypervisor/models.py,sha256=eUU5_sYIqW52nCCxbeMCE2y6akFudNJOCnjI8n0DG84,10009
+hypervisor/providers.py,sha256=bGArL0UdCGm0OF2mS1TL5QmUGVsvgcqtJzF-7iJJ7kg,3822
+hypervisor/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hypervisor/api/__init__.py,sha256=mQJ-e_7REaXDKn8PPgKFzxvCv3R-oPYoauj4vYMs5QQ,180
+hypervisor/api/models.py,sha256=RtWB3fLzDiRiD0xvd6i7X9RJF959VmJys9WaDZ6d5WI,7818
+hypervisor/api/server.py,sha256=tudVp2hjxD_eprE_MZ7pVVxASShrlmNdRORkjeHYUVc,26657
+hypervisor/audit/__init__.py,sha256=d4Gi_4wedGGQDvrpd8tKs7fvr3YtVOzqR2noWx7B81Q,176
+hypervisor/audit/commitment.py,sha256=8bWQDnINQReG3O1psy3Eowpr_n9Kqh8FvfRdBXPqTWc,2235
+hypervisor/audit/delta.py,sha256=Ib5Ivy84YtTUB8Y7zKfl3hb9yZJywsePuds6S_Mbj60,4130
+hypervisor/audit/gc.py,sha256=-GuZmGORS7EwzJKbEMt7_--bTQqp3ci_pTus9UrV-R0,2898
+hypervisor/cli/__init__.py,sha256=PmQyHhvPOKtpk6ILlhtvdJTWUfFYon3Y6uJzD9hJ37A,124
+hypervisor/cli/formatters.py,sha256=2PKV8PxvC8hmWpVGqs3IdUud03Ll_YuH1YrRT-IMn2k,3271
+hypervisor/cli/session_commands.py,sha256=-f5_yg9paMNXXOtC_Z6ydfdhtTjDI6zliFYqCfhgmc0,6089
+hypervisor/integrations/__init__.py,sha256=5-co8S88Ma7RWSzXGxhVX67t1mcmuqqNg5-a9FbHSdI,353
+hypervisor/integrations/iatp_adapter.py,sha256=yGFOpqiaDNDw0E-PovfXSBGoT9dR0LapziKeXTPLDG8,5306
+hypervisor/integrations/nexus_adapter.py,sha256=Y-F8WHZzjPvdxHbnZAZeJypr0fzqOUecferfYkivgXY,3014
+hypervisor/integrations/verification_adapter.py,sha256=c5YEZ5oheMlEvMyOY7WGPIEVzSbovdrnnVewVdVwRWI,3643
+hypervisor/liability/__init__.py,sha256=4hWzz0dqji4aJgUjXogOaSepGe8oN1gvxTbW5U8HTyo,4462
+hypervisor/liability/attribution.py,sha256=boofYSZbkK0FMlU_uxr9T7wUO5AIIVijQZaVRjCC09s,2693
+hypervisor/liability/ledger.py,sha256=0qNmxD0wzzEH85cYoBOGG4puu1QmKa3ukruO9gPezMI,3510
+hypervisor/liability/quarantine.py,sha256=Vb6EMTe3OBvhNAx089lIpzOfUNbhU9hkZW7MvrVDXUg,3491
+hypervisor/liability/slashing.py,sha256=xuBZ81GYIw7tGyztXWzdu_rZyJBBqcY6lK-JQr6foUE,2028
+hypervisor/liability/vouching.py,sha256=VTKlTg2Q6RuccX_Zu45WwobzeezvZyS8KaIgiKrveMY,4067
+hypervisor/observability/__init__.py,sha256=PBCcIE2Oxwq9R9lUuHlyxHpF1ViFQ9Fp3dVrrIk7s6w,718
+hypervisor/observability/causal_trace.py,sha256=w6GOY_E119PkzTFghqQCw9iFrjmweFWmkml9HJnWH40,2295
+hypervisor/observability/event_bus.py,sha256=6ysWj8O7KIhfbrnr09u472OZJnwle_wG-oOvIJ7QzkE,7438
+hypervisor/observability/prometheus_collector.py,sha256=q8OCzYioH57P1_DPL-mHcfPiqM5pTYFHit4Ues8sjgg,9442
+hypervisor/observability/saga_span_exporter.py,sha256=cWjMbZx2MQjr5UZS_KqCNgoPFnWV-ty8JPYaMfyjOrU,11754
+hypervisor/reversibility/__init__.py,sha256=pXGNeoNLlgq-KKIlcERgQ7X0KB5gjiplHUAF7e_Wa2A,105
+hypervisor/reversibility/registry.py,sha256=Qx6rfUuz39gCRQm_yu811uYEntvcgJasLp_7Rqb8L8U,3602
+hypervisor/rings/__init__.py,sha256=uLAUcJUVHhisBEix-iepL0bTY7sgTjW45mdro87dFkA,587
+hypervisor/rings/breach_detector.py,sha256=butsp2_GizMTEZNPtiKtnTqipqUUSr8WD3M5gbs1B8M,6865
+hypervisor/rings/classifier.py,sha256=50C83kS86lHzwNMvUjlyweHfTFX1k3P9WmK31oa4vMI,2516
+hypervisor/rings/elevation.py,sha256=rXvTeEboTg4rzCHrZnOubvms5PaUR94mKCK3KTGboSc,7386
+hypervisor/rings/enforcer.py,sha256=4QqtHWIwaS4B7IuFU-xP6DjqjkOKwmLewSBWvS789p0,3077
+hypervisor/saga/__init__.py,sha256=tv5A_SPMqAu5LZi29UfKPBTe6rkP4IyRguGeMEH6d-k,747
+hypervisor/saga/checkpoint.py,sha256=xntQ-OYK_BP1k7zEpwfUjNhhV_FnyC8maH8mxXEjQVk,3324
+hypervisor/saga/dsl.py,sha256=3fWUdWaYR51X3KfR7yYGPGGbGi3ONxmID5RrhVtZ5SA,6287
+hypervisor/saga/fan_out.py,sha256=ddV3gHAbHmTXgXtGPPkzJNV8GhZgom5eaw9zhXkMgCo,4359
+hypervisor/saga/orchestrator.py,sha256=XN_-SCTg6WwYuQPjT4Dcz3UtFu9kdTP6IgDPAsDW17w,7415
+hypervisor/saga/schema.py,sha256=5_c5uhv-k6w1Jq-YAv3WJ5UnwV97dtFacI1ytmHFZD4,7973
+hypervisor/saga/state_machine.py,sha256=coscEM-rnqj7Tqmj1riyrquGJg4DcHzotLIGB7BRO7c,5025
+hypervisor/security/__init__.py,sha256=Y-0p_uteRbQ9pVmt2lxH3XXCva2Ce5wCGfvwX32TmSM,398
+hypervisor/security/kill_switch.py,sha256=n8gd203HHkjKUVS6sLWch1N9TBfIqGtlvAVdU0gd0Xw,6520
+hypervisor/security/rate_limiter.py,sha256=ZwVzwMzBZ0wIo544wJ4RGil7fkkph5xpUyjTjQnTDMc,5774
+hypervisor/session/__init__.py,sha256=sYuk7V4foGZMVbKwY9SVyTlxZ27mnwMAw53UlguEIaY,7031
+hypervisor/session/intent_locks.py,sha256=MhJTI79_3nMhQg6bad85M0H2rH1Ivv4Oqr3palEJgpc,3332
+hypervisor/session/isolation.py,sha256=vI3pqw3zzHqfSTqz3m6agMpoan2qoEcPIGemNelDF60,887
+hypervisor/session/sso.py,sha256=eaOgfSdj1fvjCdBCbt0302ZuChjWVJX2_F7c1wp-VXc,6027
+hypervisor/session/vector_clock.py,sha256=tde5eAMZff737MX9rBivbGII1uuiNpwMr9zCSFa57Rg,3920
+hypervisor/verification/__init__.py,sha256=OOD30e_3b0uzCEBt1JJ2AGXq64PM0ORRzjZYBF9zI2A,104
+hypervisor/verification/history.py,sha256=8DDnm5-cRBqvH_5r6v5OKbmU4rKwGy2JEeoN62q1FhA,5898
+agent_hypervisor-3.1.0.dist-info/METADATA,sha256=NhiNdY8wEeHpaFSdMNkEDJ0k8v_t9Q9XQXPIJ05Q3K0,32028
+agent_hypervisor-3.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+agent_hypervisor-3.1.0.dist-info/entry_points.txt,sha256=I9hsjWJjzQWhKsrLdOe_tWwBZkx3VyxOlbncTZIcQiE,68
+agent_hypervisor-3.1.0.dist-info/licenses/LICENSE,sha256=ffINzfkZfplFwUhY1Bxg8RtSuT5baeK2NBa4dNWY0yI,1074
+agent_hypervisor-3.1.0.dist-info/RECORD,,

agent_hypervisor-3.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_hypervisor-3.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hypervisor = hypervisor.cli.session_commands:main

agent_hypervisor-3.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hypervisor/__init__.py

@@ -0,0 +1,160 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+"""
+Agent Hypervisor v2.0
+
+Runtime supervisor for multi-agent Shared Sessions with execution rings,
+liability tracking, saga orchestration, and audit trails.
+
+Usage:
+    >>> from hypervisor import Hypervisor, SessionConfig, ConsistencyMode
+    >>> hv = Hypervisor()
+    >>> session = await hv.create_session(
+    ...     config=SessionConfig(consistency_mode=ConsistencyMode.EVENTUAL)
+    ... )
+
+Version: 2.0.0
+"""
+
+__version__ = "3.1.0"
+
+# Centralized constants
+from hypervisor import constants  # noqa: F401
+
+# Core models
+from hypervisor.audit.commitment import CommitmentEngine
+
+# Audit
+from hypervisor.audit.delta import DeltaEngine
+from hypervisor.audit.gc import EphemeralGC
+
+# Top-level orchestrator
+from hypervisor.core import Hypervisor
+from hypervisor.liability import LiabilityMatrix
+from hypervisor.liability.attribution import AttributionResult, CausalAttributor
+from hypervisor.liability.ledger import LedgerEntryType, LiabilityLedger
+from hypervisor.liability.quarantine import QuarantineManager, QuarantineReason
+from hypervisor.liability.slashing import SlashingEngine
+
+# Liability engine
+from hypervisor.liability.vouching import VouchingEngine, VouchRecord
+from hypervisor.models import (
+    ConsistencyMode,
+    ExecutionRing,
+    ReversibilityLevel,
+    SessionConfig,
+    SessionState,
+)
+from hypervisor.observability.causal_trace import CausalTraceId
+
+# Observability
+from hypervisor.observability.event_bus import EventType, HypervisorEvent, HypervisorEventBus
+
+# Reversibility
+from hypervisor.reversibility.registry import ReversibilityRegistry
+from hypervisor.rings.breach_detector import BreachSeverity, RingBreachDetector
+from hypervisor.rings.classifier import ActionClassifier
+from hypervisor.rings.elevation import ElevationDenialReason, RingElevation, RingElevationManager
+
+# Execution rings
+from hypervisor.rings.enforcer import RingEnforcer
+from hypervisor.saga.checkpoint import CheckpointManager, SemanticCheckpoint
+from hypervisor.saga.dsl import SagaDefinition, SagaDSLParser
+from hypervisor.saga.fan_out import FanOutOrchestrator, FanOutPolicy
+
+# Saga
+from hypervisor.saga.orchestrator import SagaOrchestrator, SagaTimeoutError
+from hypervisor.saga.state_machine import SagaState, StepState
+from hypervisor.security.kill_switch import KillResult, KillSwitch
+
+# Security
+from hypervisor.security.rate_limiter import AgentRateLimiter, RateLimitExceeded
+
+# Session management
+from hypervisor.session import SharedSessionObject
+from hypervisor.session.intent_locks import (
+    DeadlockError,
+    IntentLockManager,
+    LockContentionError,
+    LockIntent,
+)
+from hypervisor.session.isolation import IsolationLevel
+from hypervisor.session.sso import SessionVFS, VFSEdit, VFSPermissionError
+from hypervisor.session.vector_clock import CausalViolationError, VectorClock, VectorClockManager
+
+# Verification
+from hypervisor.verification.history import TransactionHistoryVerifier
+
+__all__ = [
+    # Version
+    "__version__",
+    # Core
+    "Hypervisor",
+    # Models
+    "ConsistencyMode",
+    "ExecutionRing",
+    "ReversibilityLevel",
+    "SessionConfig",
+    "SessionState",
+    # Session
+    "SharedSessionObject",
+    "SessionVFS",
+    "VFSEdit",
+    "VFSPermissionError",
+    "VectorClock",
+    "VectorClockManager",
+    "CausalViolationError",
+    "IntentLockManager",
+    "LockIntent",
+    "LockContentionError",
+    "DeadlockError",
+    "IsolationLevel",
+    # Liability
+    "VouchRecord",
+    "VouchingEngine",
+    "SlashingEngine",
+    "LiabilityMatrix",
+    "CausalAttributor",
+    "AttributionResult",
+    "QuarantineManager",
+    "QuarantineReason",
+    "LiabilityLedger",
+    "LedgerEntryType",
+    # Rings
+    "RingEnforcer",
+    "ActionClassifier",
+    "RingElevationManager",
+    "RingElevation",
+    "ElevationDenialReason",
+    "RingBreachDetector",
+    "BreachSeverity",
+    # Reversibility
+    "ReversibilityRegistry",
+    # Saga
+    "SagaOrchestrator",
+    "SagaTimeoutError",
+    "SagaState",
+    "StepState",
+    "FanOutOrchestrator",
+    "FanOutPolicy",
+    "CheckpointManager",
+    "SemanticCheckpoint",
+    "SagaDSLParser",
+    "SagaDefinition",
+    # Audit
+    "DeltaEngine",
+    "CommitmentEngine",
+    "EphemeralGC",
+    # Verification
+    "TransactionHistoryVerifier",
+    # Observability
+    "HypervisorEventBus",
+    "EventType",
+    "HypervisorEvent",
+    "CausalTraceId",
+    # Security
+    "AgentRateLimiter",
+    "RateLimitExceeded",
+    "KillSwitch",
+    "KillResult",
+]

hypervisor/api/__init__.py

@@ -0,0 +1,7 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+"""Hypervisor REST API package."""
+
+from hypervisor.api.server import create_app
+
+__all__ = ["create_app"]

hypervisor/api/models.py

@@ -0,0 +1,285 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+"""Pydantic request/response models for the Hypervisor REST API."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+from hypervisor.models import ConsistencyMode
+
+# ── Session models ──────────────────────────────────────────────────────────
+
+class CreateSessionRequest(BaseModel):
+    """Request body for creating a new session."""
+
+    creator_did: str = Field(..., description="DID of the session creator")
+    consistency_mode: ConsistencyMode = ConsistencyMode.EVENTUAL
+    max_participants: int = 10
+    max_duration_seconds: int = 3600
+    min_eff_score: float = 0.60
+    enable_audit: bool = True
+    enable_blockchain_commitment: bool = False
+
+
+class ParticipantInfo(BaseModel):
+    """Serialized session participant."""
+
+    agent_did: str
+    ring: int
+    sigma_raw: float
+    eff_score: float
+    joined_at: str
+    is_active: bool
+
+
+class CreateSessionResponse(BaseModel):
+    """Response after creating a session."""
+
+    session_id: str
+    state: str
+    consistency_mode: str
+    created_at: str
+
+
+class SessionDetailResponse(BaseModel):
+    """Detailed session information."""
+
+    session_id: str
+    state: str
+    consistency_mode: str
+    creator_did: str
+    participant_count: int
+    participants: list[ParticipantInfo]
+    created_at: str
+    terminated_at: str | None = None
+    sagas: list[dict[str, Any]] = []
+
+
+class SessionListItem(BaseModel):
+    """Summary item for session listing."""
+
+    session_id: str
+    state: str
+    consistency_mode: str
+    participant_count: int
+    created_at: str
+
+
+class JoinSessionRequest(BaseModel):
+    """Request body for joining a session."""
+
+    agent_did: str = Field(..., description="DID of the joining agent")
+    actions: list[dict[str, Any]] | None = None
+    sigma_raw: float = 0.0
+
+
+class JoinSessionResponse(BaseModel):
+    """Response after joining a session."""
+
+    agent_did: str
+    session_id: str
+    assigned_ring: int
+    ring_name: str
+
+
+# ── Ring models ─────────────────────────────────────────────────────────────
+
+class RingDistributionResponse(BaseModel):
+    """Ring distribution across session participants."""
+
+    session_id: str
+    distribution: dict[str, list[str]]
+
+
+class AgentRingResponse(BaseModel):
+    """Agent's current ring assignment."""
+
+    agent_did: str
+    ring: int
+    ring_name: str
+    session_id: str
+
+
+class RingCheckRequest(BaseModel):
+    """Request body for checking ring-based access."""
+
+    agent_ring: int = Field(..., description="Agent's current ring level (0-3)")
+    action: dict[str, Any] = Field(..., description="ActionDescriptor fields")
+    eff_score: float = Field(..., description="Agent's effective reputation score")
+    has_consensus: bool = False
+    has_sre_witness: bool = False
+
+
+class RingCheckResponse(BaseModel):
+    """Response from ring access check."""
+
+    allowed: bool
+    required_ring: int
+    agent_ring: int
+    eff_score: float
+    reason: str
+    requires_consensus: bool = False
+    requires_sre_witness: bool = False
+
+
+# ── Saga models ─────────────────────────────────────────────────────────────
+
+class CreateSagaResponse(BaseModel):
+    """Response after creating a saga."""
+
+    saga_id: str
+    session_id: str
+    state: str
+    created_at: str
+
+
+class SagaDetailResponse(BaseModel):
+    """Detailed saga information."""
+
+    saga_id: str
+    session_id: str
+    state: str
+    created_at: str
+    completed_at: str | None = None
+    error: str | None = None
+    steps: list[dict[str, Any]]
+
+
+class AddStepRequest(BaseModel):
+    """Request body for adding a step to a saga."""
+
+    action_id: str
+    agent_did: str
+    execute_api: str
+    undo_api: str | None = None
+    timeout_seconds: int = 300
+    max_retries: int = 0
+
+
+class AddStepResponse(BaseModel):
+    """Response after adding a step."""
+
+    step_id: str
+    saga_id: str
+    action_id: str
+    state: str
+
+
+class ExecuteStepResponse(BaseModel):
+    """Response after executing a step."""
+
+    step_id: str
+    saga_id: str
+    state: str
+    error: str | None = None
+
+
+# ── Liability models ────────────────────────────────────────────────────────
+
+class CreateVouchRequest(BaseModel):
+    """Request body for creating a sponsor."""
+
+    voucher_did: str = Field(..., description="DID of the sponsorship agent")
+    vouchee_did: str = Field(..., description="DID of the agent being vouched for")
+    voucher_sigma: float = Field(..., description="Sponsor's raw reputation score")
+    bond_pct: float | None = None
+    expiry: str | None = None
+
+
+class VouchResponse(BaseModel):
+    """Response after creating a sponsor."""
+
+    vouch_id: str
+    voucher_did: str
+    vouchee_did: str
+    session_id: str
+    bonded_amount: float
+    bonded_sigma_pct: float
+    is_active: bool
+
+
+class LiabilityExposureResponse(BaseModel):
+    """Agent's liability exposure across sessions."""
+
+    agent_did: str
+    vouches_given: list[VouchResponse]
+    vouches_received: list[VouchResponse]
+    total_exposure: float
+
+
+# ── Event models ────────────────────────────────────────────────────────────
+
+class EventResponse(BaseModel):
+    """Serialized hypervisor event."""
+
+    event_id: str
+    event_type: str
+    timestamp: str
+    session_id: str | None = None
+    agent_did: str | None = None
+    causal_trace_id: str | None = None
+    payload: dict[str, Any] = {}
+
+
+class EventStatsResponse(BaseModel):
+    """Event type counts."""
+
+    total_events: int
+    by_type: dict[str, int]
+
+
+# ── Stats models ────────────────────────────────────────────────────────────
+
+class StatsResponse(BaseModel):
+    """Overall hypervisor statistics."""
+
+    version: str
+    total_sessions: int
+    active_sessions: int
+    total_participants: int
+    active_sagas: int
+    total_vouches: int
+    event_count: int
+
+
+# ── Audit models ────────────────────────────────────────────────────────────
+
+class CommitmentResponse(BaseModel):
+    session_id: str
+    hash_chain_root: str
+    participant_dids: list[str]
+    delta_count: int
+    committed_at: str
+    committed_to: str = "local"
+    blockchain_tx_id: str | None = None
+
+class VerifyCommitmentResponse(BaseModel):
+    session_id: str
+    valid: bool
+    committed_root: str
+    expected_root: str
+
+# ── Verification models ─────────────────────────────────────────────────────
+
+class TransactionInput(BaseModel):
+    session_id: str
+    summary_hash: str
+    timestamp: datetime
+    participant_count: int = 0
+
+class VerifyHistoryRequest(BaseModel):
+    agent_did: str
+    transactions: list[TransactionInput]
+
+class VerifyHistoryResponse(BaseModel):
+    agent_did: str
+    status: str
+    transactions_checked: int
+    transactions_found: int
+    inconsistencies: list[str]
+    is_trustworthy: bool
+    cached: bool = False