mayim-agent 2.0.0__py3-none-any.whl

mayim_agent/__init__.py

@@ -0,0 +1,436 @@
+from .client import (
+    Payment402Client,
+    MagClient,
+    SURFACE_PREFLIGHT_SCHEMA_VERSION,
+    validate_public_domain_for_observation
+)
+from .task_client import AgentTaskClient
+from .task_discovery_models import TaskDiscoveryPage, TaskDiscoveryCandidate
+from .task_models import (
+    AgentTask,
+    AgentTaskPage,
+    AgentTaskRewardTerms,
+    AgentTaskClaim,
+    TaskClaimCredential,
+    TaskObservedUrlEntry,
+    TaskDiscoveredSurfaceEntry,
+    TaskObservationErrorEntry,
+    TaskVerificationCostVector,
+    TaskDomainObservationSubmission,
+    TaskDomainObservationResponse,
+    AgentTaskCompletionResponse,
+    AgentTaskRewardStatus,
+    TaskDefinitionReference,
+)
+from .task_transport import (
+    TaskError,
+    TaskTransportError,
+    TaskAPIError,
+    TaskAmbiguousOutcomeError,
+)
+from .exceptions import (
+    PaymentChallengeError,
+    PaymentExecutionError,
+    NavigationGuardrailError,
+    InvoiceParseError,
+    CounterpartyTrustError # v1.4+
+)
+from .models import (
+    AssetType, 
+    SchemeType,
+    OmikujiResponse, 
+    AgentIdentity,
+    ConfessionResponse,
+    HonoResponse,
+    CompareResponse,
+    AggregateResponse,
+    BenchmarkOverviewResponse,
+    HateoasErrorResponse,
+    MonzenTraceResponse,
+    MonzenMetricsResponse,
+    MonzenGraphResponse,
+    PaymentPolicy,        
+    SettlementReceipt,
+    ExecutionResult,
+    ParsedChallenge,
+    ChallengeSource,
+    ExecutionContext,
+    TrustDecision,
+    OutcomeSummary,
+    TrustEvidence,
+    InteropRunResult,
+    ExternalProtocolRunResult,
+    CorpusReplayResult,
+    InspectResult,           
+    X402ExactDiagnosticResult,
+    GrantDiagnostics,
+    SponsoredAccessEvidence,
+    SandboxEvidence,
+    SandboxCorpusCandidate,
+    PaymentFailureRecord,
+    build_observation_provenance,
+    build_protocol_role_observation,
+    build_verification_cost_vector,
+    OBSERVATION_PROVENANCE_SCHEMA_VERSION,
+    PROTOCOL_ROLES_SCHEMA_VERSION,
+    VERIFICATION_COST_VECTOR_SCHEMA_VERSION,
+    VERIFICATION_COST_FORMULA_VERSION,
+    READ_MODEL_REVISION,
+    DomainObservationSlotResponse,
+    DomainObservationRequestStatus,
+    DomainObservationDomainReadModel,
+    DomainObservationTarget,
+    DomainObservationTargetsResponse,
+    DomainObservationResultSubmission,
+    DomainObservationResultResponse,
+    DomainSponsorVerification,
+    DomainSponsorVerificationSummary,
+    DomainSponsorChallengeResponse,
+    DomainSponsorVerifyResponse,
+    VerifiedDomainTrackPrice,
+    VerifiedDomainTrackNextAction,
+    VerifiedDomainTrackRegistrationResponse,
+    VerifiedDomainTrackReadModel,
+    VerifiedDomainTrackSummary
+)
+from .crypto.protocols import EVMSigner, LightningProvider 
+from .grants import diagnose_grant_token, decode_grant_token
+
+from .evidence import (
+    build_sponsored_access_evidence,
+    build_sandbox_evidence_from_response,
+    build_sandbox_interop_report_payload,
+    build_sandbox_corpus_candidate
+)
+
+from .failures import (
+    build_payment_failure_record,
+    build_payment_failure_observation_payload,
+    fingerprint_public_challenge_summary,
+    detect_public_challenge_changed_fields
+)
+
+from .capabilities import get_capability_matrix
+
+
+# Scheduled and immediate Task surfaces are lazy so importing the keyless
+# inspect-only MCP does not initialize their workers or secret-bearing models. A
+# normal explicit import (``from mayim_agent import AgentTaskV2Client``)
+# resolves and caches exactly the requested public symbol.
+_V18_LAZY_EXPORTS = {
+    'ActivityMapClient': ('activity_map', 'ActivityMapClient'),
+    'ActivityMapError': ('activity_map', 'ActivityMapError'),
+    'StructuredResponseClient': ('structured_response_client', 'StructuredResponseClient'),
+    'StructuredResponseJournal': ('structured_response_journal', 'StructuredResponseJournal'),
+    'StructuredResponseTask': ('structured_response_models', 'StructuredResponseTask'),
+    'StructuredResponseClaimCredential': ('structured_response_models', 'StructuredResponseClaimCredential'),
+    'FrozenStructuredResponseReport': ('structured_response_models', 'FrozenStructuredResponseReport'),
+    'StructuredResponseSubmissionStatus': ('structured_response_models', 'StructuredResponseSubmissionStatus'),
+    'OfferRegistrationClient': ('offer_registration', 'OfferRegistrationClient'),
+    'OfferRegistrationError': ('offer_registration', 'OfferRegistrationError'),
+    'RegistrationQuote': ('offer_registration', 'RegistrationQuote'),
+    'SignedRegistration': ('offer_registration', 'SignedRegistration'),
+    'RegistrationReadChallenge': ('offer_registration', 'RegistrationReadChallenge'),
+    'RegistrationReadProof': ('offer_registration', 'RegistrationReadProof'),
+    'RegistrationReadResult': ('offer_registration', 'RegistrationReadResult'),
+    'AgentEndpointChoiceReasonClient': ('endpoint_choice_reason_client', 'AgentEndpointChoiceReasonClient'),
+    'EndpointChoiceJournal': ('endpoint_choice_reason_journal', 'EndpointChoiceJournal'),
+    'FrozenEndpointChoiceReport': ('endpoint_choice_reason_models', 'FrozenEndpointChoiceReport'),
+    'EndpointChoiceTask': ('endpoint_choice_reason_models', 'EndpointChoiceTask'),
+    'EndpointChoiceClaimCredential': ('endpoint_choice_reason_models', 'EndpointChoiceClaimCredential'),
+    'EndpointChoiceSubmissionStatus': ('endpoint_choice_reason_models', 'EndpointChoiceSubmissionStatus'),
+    'EndpointChoicePublicResults': ('endpoint_choice_reason_models', 'EndpointChoicePublicResults'),
+    'EndpointChoiceRequesterClient': ('endpoint_choice_reason_requester', 'EndpointChoiceRequesterClient'),
+    'OfferResultsChallenge': ('endpoint_choice_reason_requester', 'OfferResultsChallenge'),
+    'OfferResultsProof': ('endpoint_choice_reason_requester', 'OfferResultsProof'),
+    'prepare_registration': ('endpoint_choice_reason_requester', 'prepare_registration'),
+    'registration_operation_ref': ('endpoint_choice_reason_requester', 'registration_operation_ref'),
+
+    "PaidServiceRequest": ("paid_service_trial_models", "PaidServiceRequest"),
+    "PaidServiceTrialTaskV2": ("paid_service_trial_models", "PaidServiceTrialTaskV2"),
+    "PaidServiceTrialTaskV3": ("paid_service_trial_models", "PaidServiceTrialTaskV3"),
+    "PaidServiceTrialClaimV2": ("paid_service_trial_models", "PaidServiceTrialClaimV2"),
+    "PaidServiceTrialClaimV3": ("paid_service_trial_models", "PaidServiceTrialClaimV3"),
+    "PaidServiceTrialReportV2": ("paid_service_trial_models", "PaidServiceTrialReportV2"),
+    "PaidServiceTrialReportV3": ("paid_service_trial_models", "PaidServiceTrialReportV3"),
+    "PaidServiceTrialCompletionReceiptV2": ("paid_service_trial_models", "PaidServiceTrialCompletionReceiptV2"),
+    "PaidServiceTrialCompletionReceiptV3": ("paid_service_trial_models", "PaidServiceTrialCompletionReceiptV3"),
+    "PaidServiceTrialSubmissionStatusV2": ("paid_service_trial_models", "PaidServiceTrialSubmissionStatusV2"),
+    "PaidServiceTrialSubmissionStatusV3": ("paid_service_trial_models", "PaidServiceTrialSubmissionStatusV3"),
+    "prepare_paid_service_request": ("paid_service_trial_contract", "prepare_request"),
+    "PaidServiceTrialTaskClient": ("paid_service_trial_client", "PaidServiceTrialTaskClient"),
+    "PaidServiceTrialExecutor": ("paid_service_trial", "PaidServiceTrialExecutor"),
+    "PaidServiceTrialExecution": ("paid_service_trial", "PaidServiceTrialExecution"),
+    "export_purchase_import_descriptor": ("paid_service_trial", "export_purchase_import_descriptor"),
+    "PaidServiceTrialJournal": ("paid_service_trial_journal", "PaidServiceTrialJournal"),
+    "FrozenPaidServiceTrialReport": ("paid_service_trial_models", "FrozenPaidServiceTrialReport"),
+    "PaidServiceTrialClaim": ("paid_service_trial_models", "PaidServiceTrialClaim"),
+    "PaidServiceTrialTask": ("paid_service_trial_models", "PaidServiceTrialTask"),
+    "PaidServiceTrialSubmissionStatus": ("paid_service_trial_models", "PaidServiceTrialSubmissionStatus"),
+    "PaidServiceTrialCompletionReceipt": ("paid_service_trial_models", "PaidServiceTrialCompletionReceipt"),
+    "AgentImmediateVisitClient": (
+        "immediate_visit_client",
+        "AgentImmediateVisitClient",
+    ),
+    "ImmediateVisitExecutor": ("immediate_visit", "ImmediateVisitExecutor"),
+    "FrozenImmediateVisitReport": (
+        "immediate_visit",
+        "FrozenImmediateVisitReport",
+    ),
+    "ImmediateVisitJournal": ("immediate_visit_journal", "ImmediateVisitJournal"),
+    "AgentTaskV2Client": ("task_v2_client", "AgentTaskV2Client"),
+    "ScheduledTaskClaimCredential": (
+        "task_v2_models",
+        "ScheduledTaskClaimCredential",
+    ),
+    "ScheduledTaskReadiness": (
+        "task_v2_models",
+        "ScheduledTaskReadiness",
+    ),
+    "ScheduledCompletionReport": (
+        "task_v2_models",
+        "ScheduledCompletionReport",
+    ),
+    "ScheduledCompletionReceipt": (
+        "task_v2_models",
+        "ScheduledCompletionReceipt",
+    ),
+    "ScheduledRewardStatus": (
+        "task_v2_models",
+        "ScheduledRewardStatus",
+    ),
+    "ScheduledCompletionAcknowledgement": (
+        "task_v2_models",
+        "ScheduledCompletionAcknowledgement",
+    ),
+    "TaskV2Error": ("task_v2_transport", "TaskV2Error"),
+    "TaskV2TransportError": (
+        "task_v2_transport",
+        "TaskV2TransportError",
+    ),
+    "TaskV2APIError": ("task_v2_transport", "TaskV2APIError"),
+    "ClaimOutcomeUnknownError": (
+        "task_v2_transport",
+        "ClaimOutcomeUnknownError",
+    ),
+    "CompletionOutcomeUnknownError": (
+        "task_v2_transport",
+        "CompletionOutcomeUnknownError",
+    ),
+    "ScheduledExecutionContext": (
+        "scheduled_http_get_batch",
+        "ScheduledExecutionContext",
+    ),
+    "FrozenCompletionReport": (
+        "scheduled_http_get_batch",
+        "FrozenCompletionReport",
+    ),
+    "ScheduledExecutionError": (
+        "scheduled_http_get_batch",
+        "ScheduledExecutionError",
+    ),
+    "ScheduledHTTPGetBatchExecutor": (
+        "scheduled_http_get_batch",
+        "ScheduledHTTPGetBatchExecutor",
+    ),
+    "ScheduledHttpGetBatchExecutor": (
+        "scheduled_http_get_batch",
+        "ScheduledHttpGetBatchExecutor",
+    ),
+    "TaskJournal": ("task_journal", "TaskJournal"),
+    "JournalError": ("task_journal", "JournalError"),
+}
+
+
+def __getattr__(name):
+    target = _V18_LAZY_EXPORTS.get(name)
+    if target is None:
+        raise AttributeError("module %r has no attribute %r" % (__name__, name))
+    from importlib import import_module
+
+    module = import_module(".%s" % target[0], __name__)
+    value = getattr(module, target[1])
+    globals()[name] = value
+    return value
+
+
+def __dir__():
+    return sorted(set(globals()) | set(_V18_LAZY_EXPORTS))
+
+# 汎用別名
+Http402Client = Payment402Client 
+
+__all__ = [
+    'ActivityMapClient', 'ActivityMapError',
+    'StructuredResponseClient',
+    'StructuredResponseJournal',
+    'StructuredResponseTask',
+    'StructuredResponseClaimCredential',
+    'FrozenStructuredResponseReport',
+    'StructuredResponseSubmissionStatus',
+    'OfferRegistrationClient',
+    'OfferRegistrationError',
+    'RegistrationQuote',
+    'SignedRegistration',
+    'RegistrationReadChallenge',
+    'RegistrationReadProof',
+    'RegistrationReadResult',
+
+    'AgentEndpointChoiceReasonClient',
+    'EndpointChoiceJournal',
+    'FrozenEndpointChoiceReport',
+    'EndpointChoiceTask',
+    'EndpointChoiceClaimCredential',
+    'EndpointChoiceSubmissionStatus',
+    'EndpointChoicePublicResults',
+    'EndpointChoiceRequesterClient',
+    'OfferResultsChallenge',
+    'OfferResultsProof',
+    'prepare_registration',
+    'registration_operation_ref',
+
+    "AccessQuotaPolicy", "AccessQuotaError", "AccessQuotaTerms",
+    "PaidServiceRequest",
+    "PaidServiceTrialTaskV2",
+    "PaidServiceTrialTaskV3",
+    "PaidServiceTrialClaimV2",
+    "PaidServiceTrialClaimV3",
+    "PaidServiceTrialReportV2",
+    "PaidServiceTrialReportV3",
+    "PaidServiceTrialCompletionReceiptV2",
+    "PaidServiceTrialCompletionReceiptV3",
+    "PaidServiceTrialSubmissionStatusV2",
+    "PaidServiceTrialSubmissionStatusV3",
+    "prepare_paid_service_request",
+    "PaidServiceTrialTaskClient",
+    "PaidServiceTrialExecutor",
+    "PaidServiceTrialExecution",
+    "export_purchase_import_descriptor",
+    "PaidServiceTrialJournal",
+    "FrozenPaidServiceTrialReport",
+    "PaidServiceTrialClaim",
+    "PaidServiceTrialTask",
+    "PaidServiceTrialSubmissionStatus",
+    "PaidServiceTrialCompletionReceipt",
+
+    "Payment402Client", 
+    "MagClient",
+    "AgentTaskClient",
+    "TaskDiscoveryPage",
+    "TaskDiscoveryCandidate",
+    "Http402Client", 
+    "AssetType",
+    "SchemeType",
+    "OmikujiResponse",
+    "AgentIdentity",
+    "ConfessionResponse",
+    "HonoResponse",
+    "CompareResponse",
+    "AggregateResponse",
+    "BenchmarkOverviewResponse",
+    "HateoasErrorResponse",
+    "PaymentChallengeError",
+    "PaymentExecutionError",
+    "NavigationGuardrailError",
+    "InvoiceParseError",
+    "MonzenTraceResponse",
+    "MonzenMetricsResponse",
+    "MonzenGraphResponse",
+    "PaymentPolicy",      
+    "SettlementReceipt",  
+    "EVMSigner",          
+    "LightningProvider",
+    "ExecutionResult",   
+    "ParsedChallenge",
+    "ChallengeSource",
+    "ExecutionContext",
+    "TrustDecision",
+    "OutcomeSummary",
+    "TrustEvidence",
+    "InteropRunResult",
+    "ExternalProtocolRunResult",
+    "CorpusReplayResult",
+    "InspectResult",
+    "X402ExactDiagnosticResult",
+    "GrantDiagnostics",
+    "diagnose_grant_token",
+    "decode_grant_token",
+    "SponsoredAccessEvidence",
+    "SandboxEvidence",
+    "build_sponsored_access_evidence",
+    "build_sandbox_evidence_from_response",
+    "build_sandbox_interop_report_payload",
+    "SandboxCorpusCandidate",
+    "build_sandbox_corpus_candidate",
+    "get_capability_matrix",
+    "SURFACE_PREFLIGHT_SCHEMA_VERSION",
+    "build_observation_provenance",
+    "build_protocol_role_observation",
+    "build_verification_cost_vector",
+    "OBSERVATION_PROVENANCE_SCHEMA_VERSION",
+    "PROTOCOL_ROLES_SCHEMA_VERSION",
+    "VERIFICATION_COST_VECTOR_SCHEMA_VERSION",
+    "VERIFICATION_COST_FORMULA_VERSION",
+    "READ_MODEL_REVISION",
+    "DomainObservationSlotResponse",
+    "DomainObservationRequestStatus",
+    "DomainObservationDomainReadModel",
+    "DomainObservationTarget",
+    "DomainObservationTargetsResponse",
+    "DomainObservationResultSubmission",
+    "DomainObservationResultResponse",
+    "validate_public_domain_for_observation",
+    "DomainSponsorVerification",
+    "DomainSponsorVerificationSummary",
+    "DomainSponsorChallengeResponse",
+    "DomainSponsorVerifyResponse",
+    "VerifiedDomainTrackPrice",
+    "VerifiedDomainTrackNextAction",
+    "VerifiedDomainTrackRegistrationResponse",
+    "VerifiedDomainTrackReadModel",
+    "VerifiedDomainTrackSummary",
+    "AgentTask",
+    "AgentTaskPage",
+    "AgentTaskRewardTerms",
+    "AgentTaskClaim",
+    "TaskClaimCredential",
+    "TaskObservedUrlEntry",
+    "TaskDiscoveredSurfaceEntry",
+    "TaskObservationErrorEntry",
+    "TaskVerificationCostVector",
+    "TaskDomainObservationSubmission",
+    "TaskDomainObservationResponse",
+    "AgentTaskCompletionResponse",
+    "AgentTaskRewardStatus",
+    "TaskDefinitionReference",
+    "TaskError",
+    "TaskTransportError",
+    "TaskAPIError",
+    "TaskAmbiguousOutcomeError",
+    "AgentTaskV2Client",
+    "AgentImmediateVisitClient",
+    "ImmediateVisitExecutor",
+    "FrozenImmediateVisitReport",
+    "ImmediateVisitJournal",
+    "ScheduledTaskClaimCredential",
+    "ScheduledTaskReadiness",
+    "ScheduledCompletionReport",
+    "ScheduledCompletionReceipt",
+    "ScheduledRewardStatus",
+    "ScheduledCompletionAcknowledgement",
+    "TaskV2Error",
+    "TaskV2TransportError",
+    "TaskV2APIError",
+    "ClaimOutcomeUnknownError",
+    "CompletionOutcomeUnknownError",
+    "ScheduledExecutionContext",
+    "FrozenCompletionReport",
+    "ScheduledExecutionError",
+    "ScheduledHTTPGetBatchExecutor",
+    "ScheduledHttpGetBatchExecutor",
+    "TaskJournal",
+    "JournalError",
+]
+
+from .access_quota import AccessQuotaPolicy, AccessQuotaError, AccessQuotaTerms
+