snulbug 0.1.1__py3-none-any.whl

snulbug/__init__.py

@@ -0,0 +1,588 @@
+"""Local-dev MCP policy proxy and programmable Lua ASGI policy layer."""
+
+__version__ = "0.1.1"
+
+from .auth_recipes import (
+    AUTH_RECIPE_PROVIDERS,
+    format_mcp_auth_init_report,
+    format_mcp_auth_recipe_report,
+    generate_mcp_auth_init,
+    generate_mcp_auth_recipe,
+)
+from .bundle import (
+    LIFECYCLE_STATES,
+    bundle_lifecycle_digest,
+    inspect_bundle_lifecycle,
+    pack_bundle,
+    promote_bundle_lifecycle,
+    sign_bundle_lifecycle,
+    test_bundle,
+    validate_bundle,
+    verify_bundle_lifecycle,
+)
+from .cloudflare_access import CloudflareAccessConfig, evaluate_cloudflare_access
+from .codespaces import (
+    DEFAULT_CODESPACE_ATTACH_DIR,
+    DEFAULT_CODESPACE_DEMO_HOST,
+    DEFAULT_CODESPACE_DEMO_NAME,
+    DEFAULT_CODESPACE_DEMO_PATH,
+    DEFAULT_CODESPACE_DEMO_PORT,
+    DEFAULT_CODESPACE_DISCOVERY_ENV,
+    DEFAULT_CODESPACE_HOST,
+    DEFAULT_CODESPACE_PORT,
+    DEFAULT_CODESPACE_TOOL_PREFIX,
+    DEFAULT_CODESPACE_UPSTREAM_NAME,
+    codespace_forwarded_url,
+    create_codespace_demo_server,
+    format_codespace_attach_report,
+    format_codespace_demo_report,
+    prepare_codespace_attach,
+    prepare_codespace_demo,
+    serve_codespace_demo,
+    smoke_check_codespace_upstream,
+)
+from .config import (
+    default_event_sink_configs,
+    format_event_sinks_toml,
+    load_mcp_fabric_config,
+    load_mcp_proxy_config,
+    normalize_mcp_auth_config,
+    write_sample_config,
+)
+from .confirm import ConfirmationBroker
+from .control_events import (
+    CONTROL_EVENT_SCHEMA,
+    EVENT_DISCOVERY_DEGRADED,
+    EVENT_DISCOVERY_RECOVERED,
+    EVENT_MANIFEST_CHANGED,
+    EVENT_POLICY_CHANGED,
+    EVENT_RELOAD_FAILED,
+    EVENT_RELOAD_RECOVERED,
+    EVENT_ROUTE_CHANGED,
+    EVENT_UPSTREAM_DEGRADED,
+    EVENT_UPSTREAM_RECOVERED,
+    EVENT_UPSTREAM_UNHEALTHY,
+    make_control_event,
+)
+from .controller import (
+    FabricControllerStatusServer,
+    format_fabric_controller_report,
+    format_fabric_run_report,
+    reconcile_fabric_controller,
+    run_fabric_controller,
+    run_fabric_data_plane,
+)
+from .discovery import discovery_provider_types, register_discovery_provider
+from .events import (
+    ConsoleEventSink,
+    EventDispatcher,
+    JsonlEventSink,
+    WebhookDeliveryResult,
+    WebhookEventSink,
+    WebhookSink,
+    build_event_dispatcher,
+    deliver_webhook_event,
+    event_names,
+    format_decision_console_line,
+    normalize_event_sink_configs,
+    prepare_webhook_payload,
+)
+from .fabric import (
+    annotate_topology_audit,
+    build_fabric_audit_metadata,
+    discover_fabric_upstreams,
+    doctor_fabric,
+    fabric_status,
+    format_fabric_conformance_report,
+    format_fabric_discovery_report,
+    format_fabric_doctor_report,
+    format_fabric_learn_report,
+    format_fabric_status_report,
+    generate_fabric_conformance_pack,
+    learn_fabric_profile,
+    run_fabric_conformance_pack,
+)
+from .fabric_control import (
+    FABRIC_CONTROL_ACTION_TYPES,
+    FABRIC_CONTROL_STATE_SCHEMA,
+    clear_fabric_control_actions,
+    format_fabric_control_report,
+    issue_fabric_control_action,
+    load_fabric_control_state,
+    summarize_fabric_control_state,
+)
+from .fabric_members import (
+    DEFAULT_FABRIC_MEMBER_REGISTRY,
+    DEFAULT_FABRIC_MEMBER_REGISTRY_KEY,
+    DEFAULT_FABRIC_MEMBER_TTL_SECONDS,
+    FABRIC_MEMBER_REGISTRY_SCHEMA,
+    FABRIC_MEMBER_ROLES,
+    FABRIC_MEMBER_STATUSES,
+    active_fabric_members,
+    format_fabric_member_report,
+    heartbeat_fabric_member,
+    load_fabric_member_registry,
+    member_upstreams,
+    register_fabric_member,
+    summarize_fabric_members,
+    unregister_fabric_member,
+)
+from .fabric_runtime import (
+    DEFAULT_FABRIC_RUNTIME_LEASE_TTL_SECONDS,
+    DEFAULT_FABRIC_RUNTIME_STATE,
+    DEFAULT_FABRIC_RUNTIME_STATE_KEY,
+    FABRIC_RUNTIME_LEASE_SCHEMA,
+    FABRIC_RUNTIME_STATE_SCHEMA,
+    FabricRuntimeStateStore,
+    MemoryFabricRuntimeStateStore,
+    PolicyFabricRuntimeStateStore,
+    clear_fabric_runtime_status,
+    format_fabric_runtime_report,
+    load_fabric_runtime_status,
+    open_fabric_runtime_state_store,
+)
+from .gateway_templates import GatewayTemplate, render_gateway_toml
+from .guide import MCP_GUIDE_WORKFLOWS, build_mcp_guide, format_mcp_guide
+from .impact import analyze_mcp_impact, format_mcp_impact_report
+from .inspection import format_mcp_inspection_report, inspect_mcp_log
+from .lab import format_mcp_auth_lab_report, run_mcp_auth_lab, run_mcp_lab
+from .learn import amend_mcp_policy, learn_mcp_policy
+from .leases import LeasePolicyConfig, create_lease, list_leases, revoke_lease
+from .manifests import load_manifest, manifest_digest, sign_upstream_manifest, verify_upstream_manifest, write_manifest
+from .mcp_auth import (
+    OAuthDecision,
+    OAuthResourceConfig,
+    RemoteIssuerMetadataCache,
+    RemoteJwksCache,
+    TokenIntrospectionCache,
+    auth_runtime_snapshot,
+    auth_runtime_summary,
+    evaluate_oauth_request,
+    oauth_bearer_challenge,
+    oauth_resource_metadata_url,
+    protected_resource_metadata,
+    verify_jwt,
+    verify_token,
+)
+from .mcp_schema_policy import (
+    DEFAULT_SCHEMA_POLICY_ALLOWED_PATHS,
+    MCP_SCHEMA_POLICY_SCHEMA,
+    SCHEMA_POLICY_HIGH_RISK_ACTIONS,
+    SchemaPolicyOptions,
+    format_mcp_schema_policy_report,
+    generate_mcp_schema_policy,
+    score_mcp_schema_catalog,
+)
+from .mcp_schemas import (
+    DEFAULT_MCP_PROTOCOL_VERSION,
+    MCP_SCHEMA_CATALOG_SCHEMA,
+    MCP_SCHEMA_DIFF_SCHEMA,
+    build_mcp_schema_catalog,
+    diff_mcp_schema_catalogs,
+    discover_mcp_schemas,
+    fetch_mcp_jsonrpc,
+    fetch_mcp_schema_responses,
+    format_mcp_schema_catalog_report,
+    format_mcp_schema_diff_report,
+    normalize_mcp_schema_methods,
+    parse_mcp_schema_headers,
+    stable_schema_digest,
+)
+from .mcp_tools import (
+    MCP_TOOL_DIFF_SCHEMA,
+    MCP_TOOL_SNAPSHOT_SCHEMA,
+    build_mcp_tool_snapshot,
+    diff_mcp_tool_snapshots,
+    fetch_mcp_tools_list,
+    format_mcp_tool_diff_report,
+    format_mcp_tool_snapshot_report,
+    mcp_tool_digest,
+    parse_mcp_tool_headers,
+    snapshot_mcp_tools,
+)
+from .middleware import LuaConfig, LuaMiddleware
+from .policy_activation import POLICY_ACTIVATION_MODES, reconcile_policy_activation
+from .presets import McpPolicyOptions, copy_builtin_preset, generate_mcp_preset, list_builtin_presets
+from .promotion import compare_decisions, diff_policies, format_policy_diff_report
+from .proxy import (
+    FabricConfigReloadMiddleware,
+    FacadeHealthPolicy,
+    FacadeUpstream,
+    ManagedHolepunchBridge,
+    ManagedStdioMcpClient,
+    McpFacadeProxyApp,
+    ReverseProxyApp,
+    create_proxy_application,
+    proxy_config_run_kwargs,
+    run_mcp_proxy_config,
+    run_proxy,
+)
+from .quickstart import create_mcp_quickstart
+from .recorder import append_record, load_record_log, record_audit_event, record_policy_request, replay_record_log
+from .redaction import RedactionConfig, append_audit_event, build_audit_event, redact_secrets
+from .response_policy import ResponsePolicyConfig
+from .runtime import LuaDecisionError, LuaDecisionTrace, LuaRuntimeError
+from .sarif import sarif_for_policy_diff, sarif_for_schema_diff, sarif_for_share_doctor
+from .scaffolds import (
+    GeneratedArtifact,
+    GeneratedClient,
+    GeneratedCommand,
+    GeneratedEnv,
+    GeneratedLog,
+    GeneratedSession,
+    ScaffoldFile,
+    ScaffoldPlan,
+    format_scaffold_report,
+    format_session_report,
+    json_scaffold_file,
+    session_result,
+    session_summary,
+    write_scaffold,
+)
+from .schema_policy import SchemaPolicyConfig
+from .share import (
+    activate_mcp_share_policy,
+    amend_mcp_share_policy,
+    attach_mcp_share_member,
+    close_mcp_share,
+    create_mcp_share,
+    doctor_mcp_share,
+    doctor_mcp_share_auth,
+    format_share_auth_conformance_report,
+    format_share_auth_doctor_report,
+    format_share_doctor_report,
+    format_share_report,
+    format_share_status_report,
+    generate_auth_conformance_pack,
+    load_mcp_share,
+    load_share_contract,
+    promote_mcp_share_policy,
+    run_auth_conformance_pack,
+    run_mcp_share,
+    share_client_config,
+    share_contract,
+    share_contract_runtime_metadata,
+    share_report,
+    share_status,
+)
+from .share_session import (
+    SHARE_SESSION_MODEL_PATH,
+    SHARE_SESSION_MODEL_TYPE,
+    build_share_session_model,
+    load_share_session_model,
+    share_session_model_path,
+    update_share_session_model,
+    write_share_session_model,
+)
+from .simulator import simulate_policy
+from .state import (
+    BoundedPolicyState,
+    MemoryStateStore,
+    RedisStateStore,
+    SnapshotStateStore,
+    SQLiteStateStore,
+    StateLimits,
+)
+from .tool_risk import classify_mcp_tool, classify_mcp_tool_risks
+from .tunnel import (
+    TUNNEL_PROVIDERS,
+    TunnelAuditConfig,
+    build_tunnel_audit_metadata,
+    display_tunnel_public_endpoint,
+    doctor_tunnel,
+    format_tunnel_doctor_report,
+    format_tunnel_init_report,
+    init_tunnel_provider,
+    parse_tunnel_headers,
+)
+
+__all__ = [
+    "BoundedPolicyState",
+    "CloudflareAccessConfig",
+    "ConsoleEventSink",
+    "ConfirmationBroker",
+    "CONTROL_EVENT_SCHEMA",
+    "AUTH_RECIPE_PROVIDERS",
+    "DEFAULT_FABRIC_MEMBER_REGISTRY",
+    "DEFAULT_FABRIC_MEMBER_REGISTRY_KEY",
+    "DEFAULT_FABRIC_MEMBER_TTL_SECONDS",
+    "DEFAULT_CODESPACE_ATTACH_DIR",
+    "DEFAULT_CODESPACE_DEMO_HOST",
+    "DEFAULT_CODESPACE_DEMO_NAME",
+    "DEFAULT_CODESPACE_DEMO_PATH",
+    "DEFAULT_CODESPACE_DEMO_PORT",
+    "DEFAULT_CODESPACE_DISCOVERY_ENV",
+    "DEFAULT_CODESPACE_HOST",
+    "DEFAULT_CODESPACE_PORT",
+    "DEFAULT_CODESPACE_TOOL_PREFIX",
+    "DEFAULT_CODESPACE_UPSTREAM_NAME",
+    "DEFAULT_FABRIC_RUNTIME_LEASE_TTL_SECONDS",
+    "DEFAULT_FABRIC_RUNTIME_STATE",
+    "DEFAULT_FABRIC_RUNTIME_STATE_KEY",
+    "DEFAULT_MCP_PROTOCOL_VERSION",
+    "DEFAULT_SCHEMA_POLICY_ALLOWED_PATHS",
+    "EVENT_DISCOVERY_DEGRADED",
+    "EVENT_DISCOVERY_RECOVERED",
+    "EVENT_MANIFEST_CHANGED",
+    "EVENT_POLICY_CHANGED",
+    "EVENT_RELOAD_FAILED",
+    "EVENT_RELOAD_RECOVERED",
+    "EVENT_ROUTE_CHANGED",
+    "EVENT_UPSTREAM_DEGRADED",
+    "EVENT_UPSTREAM_RECOVERED",
+    "EVENT_UPSTREAM_UNHEALTHY",
+    "EventDispatcher",
+    "FABRIC_CONTROL_ACTION_TYPES",
+    "FABRIC_CONTROL_STATE_SCHEMA",
+    "FABRIC_MEMBER_REGISTRY_SCHEMA",
+    "FABRIC_MEMBER_ROLES",
+    "FABRIC_MEMBER_STATUSES",
+    "FABRIC_RUNTIME_LEASE_SCHEMA",
+    "FABRIC_RUNTIME_STATE_SCHEMA",
+    "FacadeHealthPolicy",
+    "LuaConfig",
+    "LuaDecisionError",
+    "LuaDecisionTrace",
+    "LuaMiddleware",
+    "LuaRuntimeError",
+    "LeasePolicyConfig",
+    "LIFECYCLE_STATES",
+    "MemoryFabricRuntimeStateStore",
+    "MemoryStateStore",
+    "McpPolicyOptions",
+    "FacadeUpstream",
+    "FabricConfigReloadMiddleware",
+    "FabricControllerStatusServer",
+    "FabricRuntimeStateStore",
+    "GatewayTemplate",
+    "GeneratedArtifact",
+    "GeneratedClient",
+    "GeneratedCommand",
+    "GeneratedEnv",
+    "GeneratedLog",
+    "GeneratedSession",
+    "JsonlEventSink",
+    "ManagedHolepunchBridge",
+    "ManagedStdioMcpClient",
+    "MCP_GUIDE_WORKFLOWS",
+    "MCP_SCHEMA_CATALOG_SCHEMA",
+    "MCP_SCHEMA_DIFF_SCHEMA",
+    "MCP_SCHEMA_POLICY_SCHEMA",
+    "MCP_TOOL_DIFF_SCHEMA",
+    "MCP_TOOL_SNAPSHOT_SCHEMA",
+    "McpFacadeProxyApp",
+    "OAuthDecision",
+    "OAuthResourceConfig",
+    "PolicyFabricRuntimeStateStore",
+    "POLICY_ACTIVATION_MODES",
+    "RedisStateStore",
+    "RedactionConfig",
+    "RemoteIssuerMetadataCache",
+    "RemoteJwksCache",
+    "ResponsePolicyConfig",
+    "ReverseProxyApp",
+    "SCHEMA_POLICY_HIGH_RISK_ACTIONS",
+    "ScaffoldFile",
+    "ScaffoldPlan",
+    "SchemaPolicyConfig",
+    "SchemaPolicyOptions",
+    "SQLiteStateStore",
+    "SnapshotStateStore",
+    "StateLimits",
+    "TUNNEL_PROVIDERS",
+    "TunnelAuditConfig",
+    "__version__",
+    "WebhookDeliveryResult",
+    "WebhookEventSink",
+    "WebhookSink",
+    "active_fabric_members",
+    "append_audit_event",
+    "append_record",
+    "amend_mcp_policy",
+    "amend_mcp_share_policy",
+    "analyze_mcp_impact",
+    "annotate_topology_audit",
+    "activate_mcp_share_policy",
+    "attach_mcp_share_member",
+    "auth_runtime_snapshot",
+    "auth_runtime_summary",
+    "build_audit_event",
+    "build_event_dispatcher",
+    "build_fabric_audit_metadata",
+    "build_mcp_schema_catalog",
+    "build_mcp_tool_snapshot",
+    "build_share_session_model",
+    "build_tunnel_audit_metadata",
+    "bundle_lifecycle_digest",
+    "clear_fabric_control_actions",
+    "clear_fabric_runtime_status",
+    "close_mcp_share",
+    "compare_decisions",
+    "classify_mcp_tool",
+    "classify_mcp_tool_risks",
+    "copy_builtin_preset",
+    "codespace_forwarded_url",
+    "create_lease",
+    "create_codespace_demo_server",
+    "create_mcp_quickstart",
+    "create_mcp_share",
+    "create_proxy_application",
+    "proxy_config_run_kwargs",
+    "diff_mcp_schema_catalogs",
+    "diff_mcp_tool_snapshots",
+    "diff_policies",
+    "build_mcp_guide",
+    "deliver_webhook_event",
+    "default_event_sink_configs",
+    "discovery_provider_types",
+    "discover_fabric_upstreams",
+    "discover_mcp_schemas",
+    "display_tunnel_public_endpoint",
+    "doctor_tunnel",
+    "doctor_fabric",
+    "doctor_mcp_share",
+    "doctor_mcp_share_auth",
+    "evaluate_cloudflare_access",
+    "evaluate_oauth_request",
+    "event_names",
+    "fabric_status",
+    "fetch_mcp_jsonrpc",
+    "fetch_mcp_schema_responses",
+    "fetch_mcp_tools_list",
+    "format_fabric_conformance_report",
+    "format_fabric_discovery_report",
+    "format_fabric_doctor_report",
+    "format_fabric_controller_report",
+    "format_fabric_run_report",
+    "format_fabric_learn_report",
+    "format_fabric_control_report",
+    "format_fabric_member_report",
+    "format_fabric_runtime_report",
+    "format_fabric_status_report",
+    "format_decision_console_line",
+    "format_codespace_attach_report",
+    "format_codespace_demo_report",
+    "format_mcp_inspection_report",
+    "format_mcp_impact_report",
+    "format_mcp_guide",
+    "format_mcp_schema_catalog_report",
+    "format_mcp_schema_diff_report",
+    "format_mcp_schema_policy_report",
+    "format_mcp_tool_diff_report",
+    "format_mcp_tool_snapshot_report",
+    "format_policy_diff_report",
+    "format_mcp_auth_lab_report",
+    "format_mcp_auth_init_report",
+    "format_mcp_auth_recipe_report",
+    "format_event_sinks_toml",
+    "format_scaffold_report",
+    "format_session_report",
+    "format_share_auth_conformance_report",
+    "format_share_auth_doctor_report",
+    "format_share_doctor_report",
+    "format_share_report",
+    "format_share_status_report",
+    "format_tunnel_doctor_report",
+    "format_tunnel_init_report",
+    "generate_fabric_conformance_pack",
+    "generate_auth_conformance_pack",
+    "generate_mcp_preset",
+    "generate_mcp_auth_init",
+    "generate_mcp_auth_recipe",
+    "generate_mcp_schema_policy",
+    "heartbeat_fabric_member",
+    "inspect_mcp_log",
+    "inspect_bundle_lifecycle",
+    "init_tunnel_provider",
+    "issue_fabric_control_action",
+    "json_scaffold_file",
+    "learn_mcp_policy",
+    "learn_fabric_profile",
+    "load_fabric_control_state",
+    "load_fabric_member_registry",
+    "load_fabric_runtime_status",
+    "load_mcp_proxy_config",
+    "load_mcp_fabric_config",
+    "load_mcp_share",
+    "load_share_contract",
+    "load_share_session_model",
+    "load_manifest",
+    "load_record_log",
+    "manifest_digest",
+    "make_control_event",
+    "mcp_tool_digest",
+    "member_upstreams",
+    "list_builtin_presets",
+    "list_leases",
+    "open_fabric_runtime_state_store",
+    "pack_bundle",
+    "parse_mcp_schema_headers",
+    "parse_mcp_tool_headers",
+    "parse_tunnel_headers",
+    "prepare_codespace_attach",
+    "prepare_codespace_demo",
+    "record_audit_event",
+    "record_policy_request",
+    "reconcile_fabric_controller",
+    "reconcile_policy_activation",
+    "register_fabric_member",
+    "register_discovery_provider",
+    "redact_secrets",
+    "render_gateway_toml",
+    "replay_record_log",
+    "revoke_lease",
+    "run_mcp_auth_lab",
+    "run_auth_conformance_pack",
+    "run_mcp_lab",
+    "serve_codespace_demo",
+    "run_fabric_controller",
+    "run_fabric_conformance_pack",
+    "run_fabric_data_plane",
+    "run_mcp_proxy_config",
+    "run_mcp_share",
+    "run_proxy",
+    "sarif_for_policy_diff",
+    "sarif_for_schema_diff",
+    "sarif_for_share_doctor",
+    "score_mcp_schema_catalog",
+    "share_client_config",
+    "share_contract",
+    "share_contract_runtime_metadata",
+    "share_report",
+    "SHARE_SESSION_MODEL_PATH",
+    "SHARE_SESSION_MODEL_TYPE",
+    "share_status",
+    "share_session_model_path",
+    "session_result",
+    "session_summary",
+    "simulate_policy",
+    "smoke_check_codespace_upstream",
+    "snapshot_mcp_tools",
+    "normalize_mcp_auth_config",
+    "normalize_mcp_schema_methods",
+    "normalize_event_sink_configs",
+    "oauth_bearer_challenge",
+    "oauth_resource_metadata_url",
+    "promote_bundle_lifecycle",
+    "promote_mcp_share_policy",
+    "prepare_webhook_payload",
+    "protected_resource_metadata",
+    "sign_bundle_lifecycle",
+    "sign_upstream_manifest",
+    "summarize_fabric_control_state",
+    "summarize_fabric_members",
+    "stable_schema_digest",
+    "TokenIntrospectionCache",
+    "test_bundle",
+    "unregister_fabric_member",
+    "update_share_session_model",
+    "validate_bundle",
+    "verify_bundle_lifecycle",
+    "verify_jwt",
+    "verify_token",
+    "verify_upstream_manifest",
+    "write_scaffold",
+    "write_manifest",
+    "write_sample_config",
+    "write_share_session_model",
+]

snulbug/__main__.py

@@ -0,0 +1,3 @@
+from snulbug.simulator import main
+
+raise SystemExit(main())