quantumflow-sdk 0.2.1__py3-none-any.whl → 0.4.0__py3-none-any.whl

api/main.py

@@ -35,6 +35,10 @@ from api.models import (
 from api.auth import get_current_user, get_optional_user, get_db_session
 from api.routes.auth_routes import router as auth_router
 from api.routes.teleport_routes import router as teleport_router
+from api.routes.algorithm_routes import router as algorithm_router
+from api.routes.chat_routes import router as chat_router
+# Pipeline routes disabled - internal research only (not public API)
+# from api.routes.pipeline_routes import router as pipeline_router
 
 # Import billing routes (optional - only if Stripe is configured)
 try:
@@ -97,7 +101,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     title="QuantumFlow API",
     description="Quantum-optimized AI agent workflow platform",
-    version="0.1.0",
+    version="0.3.0",
     lifespan=lifespan,
 )
 
@@ -116,6 +120,16 @@ app.include_router(auth_router)
 # Include teleportation & secure messaging routes
 app.include_router(teleport_router)
 
+# Include algorithm routes (QNN, Grover, QAOA, VQE, QSVM, QKD, QRNG, QFT)
+app.include_router(algorithm_router)
+
+# Include QChat messaging routes (P2P encrypted messaging)
+app.include_router(chat_router)
+
+# Pipeline routes disabled - internal research only
+# To enable: uncomment import and line below
+# app.include_router(pipeline_router)
+
 # Include billing routes if available
 if BILLING_ENABLED and billing_router:
     app.include_router(billing_router)
@@ -128,7 +142,7 @@ async def health_check():
     """Check API health status."""
     return HealthResponse(
         status="healthy",
-        version="0.1.0",
+        version="0.3.0",
         quantum_ready=_compressor is not None,
     )
 
@@ -156,14 +170,29 @@ async def compress_tokens(
     Compress tokens using quantum amplitude encoding.
 
     Achieves 53% token reduction via quantum superposition.
+
+    Options:
+    - `use_gray_code`: Enable Gray-code measurement protocol (arXiv:2601.00247)
+      which reduces measurement settings from O(N) to 2n+1.
     """
     if not _compressor:
         raise HTTPException(status_code=503, detail="Quantum compressor not initialized")
 
     start_time = time.perf_counter()
+    measurement_settings = None
+    gray_code_enabled = request.use_gray_code
 
     try:
-        if request.execute:
+        if request.use_gray_code and request.execute:
+            # Use Gray-code measurement protocol
+            result, gray_result = _compressor.compress_with_gray_code(
+                tokens=request.tokens,
+                compression_level=request.compression_level,
+                shots=request.shots,
+            )
+            fidelity = result.execution_result.fidelity if result.execution_result else None
+            measurement_settings = gray_result.n_measurement_settings
+        elif request.execute:
             result = _compressor.compress_and_execute(
                 tokens=request.tokens,
                 compression_level=request.compression_level,
@@ -206,6 +235,8 @@ async def compress_tokens(
             fidelity=fidelity,
             execution_time_ms=execution_time,
             backend_used=request.backend,
+            measurement_settings=measurement_settings,
+            gray_code_enabled=gray_code_enabled,
         )
 
     except Exception as e:

api/models.py

@@ -16,6 +16,10 @@ class CompressRequest(BaseModel):
     backend: str = Field(default="auto", description="Backend: auto, simulator, ibm")
     execute: bool = Field(default=False, description="Execute on quantum backend")
     shots: int = Field(default=1024, ge=1, le=10000)
+    use_gray_code: bool = Field(
+        default=False,
+        description="Use Gray-code measurement protocol (arXiv:2601.00247) for efficient readout"
+    )
 
 
 class CompressResponse(BaseModel):
@@ -29,6 +33,43 @@ class CompressResponse(BaseModel):
     fidelity: Optional[float] = None
     execution_time_ms: Optional[float] = None
     backend_used: str
+    # Gray-code specific fields
+    measurement_settings: Optional[int] = Field(
+        default=None,
+        description="Number of measurement settings used (2n+1 for Gray-code)"
+    )
+    gray_code_enabled: bool = Field(default=False)
+
+
+# === SES VQE Models (arXiv:2601.00247) ===
+
+class SESVQERequest(BaseModel):
+    """Request for Single Excitation Subspace VQE."""
+
+    n_sites: int = Field(..., ge=2, le=1024, description="Number of lattice sites")
+    on_site_energies: list[float] = Field(..., description="Energy at each site [h_11, h_22, ...]")
+    hopping_terms: list[tuple[int, int, float]] = Field(
+        ...,
+        description="Hopping amplitudes [(i, j, t_ij), ...] between sites"
+    )
+    max_iterations: int = Field(default=100, ge=10, le=1000)
+    backend: str = Field(default="auto")
+    shots: int = Field(default=1024, ge=100, le=10000)
+
+
+class SESVQEResponse(BaseModel):
+    """Response from SES VQE computation."""
+
+    ground_energy: float
+    n_sites: int
+    n_qubits_used: int = Field(description="Logarithmic encoding: log₂(n_sites)")
+    qubit_reduction_percent: float
+    iterations: int
+    volumetric_cost: int
+    original_volumetric_cost: int
+    speedup: float
+    execution_time_ms: float
+    ansatz_type: str = "ses_binary"
 
 
 # === Gradient Models ===