oscura 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

oscura/sessions/generic.py

@@ -0,0 +1,189 @@
+"""Generic analysis session implementation.
+
+This module provides GenericSession - a concrete implementation of AnalysisSession
+for general-purpose signal analysis. It wraps the existing session.Session class
+to provide the unified AnalysisSession interface while maintaining backward
+compatibility.
+
+Example:
+    >>> from oscura.sessions import GenericSession
+    >>> from oscura.acquisition import FileSource
+    >>>
+    >>> # Create generic session
+    >>> session = GenericSession(name="Debug Session")
+    >>> session.add_recording("capture1", FileSource("signal1.wfm"))
+    >>> session.add_recording("capture2", FileSource("signal2.wfm"))
+    >>>
+    >>> # Compare recordings
+    >>> diff = session.compare("capture1", "capture2")
+    >>> print(f"Similarity: {diff.similarity_score:.2%}")
+    >>>
+    >>> # Analyze
+    >>> results = session.analyze()  # Generic waveform analysis
+
+Pattern:
+    GenericSession is the default session type for non-domain-specific
+    analysis. Use domain-specific sessions (CANSession, SerialSession, etc.)
+    when working within a specific protocol or analysis domain.
+
+Migration:
+    The existing oscura.session.Session class continues to work unchanged.
+    GenericSession provides the new AnalysisSession interface while
+    delegating to the existing Session implementation internally.
+
+References:
+    Architecture Plan Phase 0.3: AnalysisSession Generic Implementation
+    src/oscura/session/session.py: Legacy Session class
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from oscura.sessions.base import AnalysisSession
+
+
+class GenericSession(AnalysisSession):
+    """Generic analysis session for general-purpose signal analysis.
+
+    Provides the unified AnalysisSession interface for non-domain-specific
+    analysis. This is the default session type when you don't need CAN,
+    Serial, or other specialized functionality.
+
+    Example:
+        >>> from oscura.sessions import GenericSession
+        >>> from oscura.acquisition import FileSource
+        >>>
+        >>> session = GenericSession()
+        >>> session.add_recording("test1", FileSource("capture1.wfm"))
+        >>> session.add_recording("test2", FileSource("capture2.wfm"))
+        >>>
+        >>> # Compare traces
+        >>> diff = session.compare("test1", "test2")
+        >>> print(f"Changed: {diff.changed_bytes} samples")
+        >>>
+        >>> # Generic analysis
+        >>> results = session.analyze()
+        >>> print(results["num_recordings"])
+    """
+
+    def analyze(self) -> dict[str, Any]:
+        """Perform generic waveform analysis on all recordings.
+
+        Analyzes all loaded recordings and provides summary statistics,
+        basic waveform measurements, and comparison results.
+
+        Returns:
+            Dictionary with analysis results:
+                - num_recordings: Number of recordings
+                - recordings: List of recording names
+                - summary: Summary statistics for each recording
+
+        Example:
+            >>> session = GenericSession()
+            >>> session.add_recording("sig", FileSource("capture.wfm"))
+            >>> results = session.analyze()
+            >>> print(results["summary"]["sig"]["mean"])
+        """
+        import numpy as np
+
+        results: dict[str, Any] = {
+            "num_recordings": len(self.recordings),
+            "recordings": self.list_recordings(),
+            "summary": {},
+        }
+
+        # Analyze each recording
+        from oscura.core.types import IQTrace
+
+        for name in self.list_recordings():
+            trace = self.get_recording(name)
+
+            # Handle IQTrace separately
+            if isinstance(trace, IQTrace):
+                raise TypeError("IQTrace analysis not yet supported in GenericSession")
+
+            # Basic statistics
+            summary = {
+                "num_samples": len(trace.data),
+                "sample_rate": trace.metadata.sample_rate,
+                "duration": len(trace.data) / trace.metadata.sample_rate,
+                "mean": float(np.mean(trace.data)),
+                "std": float(np.std(trace.data)),
+                "min": float(np.min(trace.data)),
+                "max": float(np.max(trace.data)),
+                "rms": float(np.sqrt(np.mean(trace.data**2))),
+            }
+
+            results["summary"][name] = summary
+
+        # If multiple recordings, add comparisons
+        if len(self.recordings) >= 2:
+            results["comparisons"] = {}
+            names = self.list_recordings()
+            for i in range(len(names)):
+                for j in range(i + 1, len(names)):
+                    comparison_key = f"{names[i]}_vs_{names[j]}"
+                    comp_result = self.compare(names[i], names[j])
+                    results["comparisons"][comparison_key] = {
+                        "similarity": comp_result.similarity_score,
+                        "changed_samples": comp_result.changed_bytes,
+                    }
+
+        return results
+
+    def export_results(self, format: str, path: str | Path) -> None:
+        """Export analysis results to file.
+
+        Extends base export with additional formats for generic analysis.
+
+        Args:
+            format: Export format ("report", "json", "csv").
+            path: Output file path.
+
+        Raises:
+            ValueError: If format not supported.
+
+        Example:
+            >>> session.export_results("report", "analysis.txt")
+            >>> session.export_results("json", "results.json")
+        """
+        path = Path(path)
+
+        if format == "json":
+            # Export as JSON
+            import json
+
+            results = self.analyze()
+
+            with open(path, "w") as f:
+                json.dump(results, f, indent=2)
+
+        elif format == "csv":
+            # Export summary as CSV
+            import csv
+
+            results = self.analyze()
+
+            with open(path, "w", newline="") as f:
+                if not results["summary"]:
+                    return  # No data to export
+
+                # Get fieldnames from first recording
+                first_rec = next(iter(results["summary"].values()))
+                fieldnames = ["recording"] + list(first_rec.keys())
+
+                writer = csv.DictWriter(f, fieldnames=fieldnames)
+                writer.writeheader()
+
+                for name, summary in results["summary"].items():
+                    row = {"recording": name, **summary}
+                    writer.writerow(row)
+
+        else:
+            # Fall back to base implementation (text report)
+            super().export_results(format, path)
+
+
+__all__ = ["GenericSession"]

{oscura-0.3.0.dist-info → oscura-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oscura
-Version: 0.3.0
+Version: 0.4.0
 Summary: Unified hardware reverse engineering framework. Extract all information from any system through signals and data. Unknown protocol discovery, state machine extraction, CRC recovery, security analysis. 16+ protocols, IEEE-compliant measurements.
 Project-URL: Homepage, https://github.com/oscura-re/oscura
 Project-URL: Documentation, https://github.com/oscura-re/oscura/tree/main/docs
@@ -57,6 +57,8 @@ Requires-Dist: pytest-timeout<3.0.0,>=2.3.0; extra == 'all'
 Requires-Dist: pytest<10.0.0,>=8.0; extra == 'all'
 Requires-Dist: python-can<5.0.0,>=4.4.0; extra == 'all'
 Requires-Dist: python-pptx<1.0.0,>=0.6.21; extra == 'all'
+Requires-Dist: pyvisa-py<1.0.0,>=0.7.0; extra == 'all'
+Requires-Dist: pyvisa<2.0.0,>=1.13.0; extra == 'all'
 Requires-Dist: pywavelets<2.0.0,>=1.0.0; extra == 'all'
 Requires-Dist: reportlab<6.0.0,>=4.4.7; extra == 'all'
 Requires-Dist: rigolwfm<2.0.0,>=1.0.0; extra == 'all'
@@ -82,6 +84,9 @@ Requires-Dist: pytest-timeout<3.0.0,>=2.3.0; extra == 'dev'
 Requires-Dist: pytest<10.0.0,>=8.0; extra == 'dev'
 Requires-Dist: types-pyyaml<7.0.0,>=6.0; extra == 'dev'
 Requires-Dist: yamllint<2.0.0,>=1.35; extra == 'dev'
+Provides-Extra: hardware
+Requires-Dist: pyvisa-py<1.0.0,>=0.7.0; extra == 'hardware'
+Requires-Dist: pyvisa<2.0.0,>=1.13.0; extra == 'hardware'
 Provides-Extra: hdf5
 Requires-Dist: h5py<4.0.0,>=3.0.0; extra == 'hdf5'
 Provides-Extra: jupyter
@@ -127,11 +132,15 @@ Description-Content-Type: text/markdown
 
 Oscura is a hardware reverse engineering framework for security researchers, right-to-repair advocates, defense analysts, and commercial intelligence teams. From oscilloscope captures to complete system understanding.
 
-**Reverse Engineering**: Unknown protocol discovery • State machine extraction • CRC/checksum recovery • Proprietary device replication • Security vulnerability analysis
+**Reverse Engineering**: Unknown protocol discovery • State machine extraction • CRC/checksum recovery • Proprietary device replication • Security vulnerability analysis • Black-box protocol analysis
 
-**Signal Analysis**: IEEE-compliant measurements (181/1241/1459/2414) • Comprehensive protocol decoding (16+ protocols) • Spectral analysis • Timing characterization
+**Signal Analysis**: IEEE-compliant measurements (181/1241/1459/2414) • Comprehensive protocol decoding (16+ protocols) • Spectral analysis • Timing characterization • Side-channel analysis (DPA/CPA/timing attacks)
 
-**Built For**: Exploitation • Replication • Defense analysis • Commercial intelligence • Right-to-repair
+**Unified Acquisition**: File-based • Hardware sources (SocketCAN, Saleae, PyVISA - Phase 2) • Synthetic generation • Polymorphic Source protocol
+
+**Interactive Sessions**: Domain-specific analysis sessions • BlackBoxSession for protocol RE • Differential analysis • Field hypothesis generation • Protocol specification export
+
+**Built For**: Exploitation • Replication • Defense analysis • Commercial intelligence • Right-to-repair • Cryptographic research
 
 ---
 
@@ -155,6 +164,8 @@ cd oscura
 
 ## Quick Start
 
+### Signal Analysis
+
 ```python
 import oscura as osc
 
@@ -171,6 +182,57 @@ decoder = UARTDecoder(baud_rate=115200)
 messages = decoder.decode(trace)
 ```
 
+### Black-Box Protocol Reverse Engineering
+
+```python
+from oscura.sessions import BlackBoxSession
+from oscura.acquisition import FileSource
+
+# Create analysis session
+session = BlackBoxSession(name="IoT Device RE")
+
+# Add recordings from different stimuli
+session.add_recording("idle", FileSource("idle.bin"))
+session.add_recording("button_press", FileSource("button.bin"))
+
+# Differential analysis
+diff = session.compare("idle", "button_press")
+print(f"Changed bytes: {diff.changed_bytes}")
+
+# Generate protocol specification
+spec = session.generate_protocol_spec()
+print(f"Detected {len(spec['fields'])} protocol fields")
+
+# Export Wireshark dissector
+session.export_results("dissector", "protocol.lua")
+```
+
+### CAN Protocol Analysis
+
+```python
+from oscura.automotive.can import CANSession
+from oscura.acquisition import FileSource
+
+# Create session
+session = CANSession(name="Vehicle Analysis")
+
+# Add recordings from CAN bus captures
+session.add_recording("idle", FileSource("idle.blf"))
+session.add_recording("accelerate", FileSource("accelerate.blf"))
+
+# Analyze traffic
+analysis = session.analyze()
+print(f"Messages: {analysis['inventory']['total_messages']}")
+print(f"Unique IDs: {len(analysis['inventory']['message_ids'])}")
+
+# Compare recordings
+diff = session.compare("idle", "accelerate")
+print(f"Changed IDs: {len(diff.details['changed_ids'])}")
+
+# Export DBC file
+session.export_dbc("vehicle.dbc")
+```
+
 ---
 
 ## Learn by Example
@@ -285,9 +347,28 @@ uv sync --all-extras
 
 ## Documentation
 
-- **[Demos](demos/)** - Start here (working examples)
+### Getting Started
+
+- **[Quick Start Guide](docs/guides/quick-start.md)** - Begin here
+- **[Demos](demos/)** - Working examples for every feature
+- **[Migration Guide](docs/migration/v0-to-v1.md)** - Upgrade from older versions
+
+### User Guides
+
+- **[Black-Box Protocol Analysis](docs/guides/blackbox-analysis.md)** - Unknown protocol reverse engineering
+- **[Hardware Acquisition](docs/guides/hardware-acquisition.md)** - Direct hardware integration (Phase 2)
+- **[Side-Channel Analysis](docs/guides/side-channel-analysis.md)** - Power/timing/EM attacks
+- **[Workflows](docs/guides/workflows.md)** - Complete analysis workflows
+
+### API Reference
+
 - **[API Reference](docs/api/)** - Complete API documentation
+- **[Session Management](docs/api/session-management.md)** - Interactive analysis sessions
 - **[CLI Reference](docs/cli.md)** - Command line usage
+
+### Development
+
+- **[Architecture](docs/architecture/)** - Design principles and patterns
 - **[Testing Guide](docs/testing/)** - Test suite architecture
 - **[CHANGELOG](CHANGELOG.md)** - Version history
 

{oscura-0.3.0.dist-info → oscura-0.4.0.dist-info}/RECORD

@@ -1,21 +1,29 @@
-oscura/__init__.py,sha256=V1fB6L32oWxgv5OtAHJKWTAtb9DqD_QXkfAcsEge-pw,18443
+oscura/__init__.py,sha256=IvoCA0vsnvD_yPvwtMWi4qX4q5FhsY7uiQFKghU85wQ,18313
 oscura/__main__.py,sha256=l1rnaD-tpI1W3cp1VHGhSdq9NDqw6Gxjf_gnqXf-zzE,11786
 oscura/convenience.py,sha256=o8f1Im8WpakGXRz8D4bV-XSNkzpgnVjsyVxnaxZ-dg4,14612
 oscura/exceptions.py,sha256=Ywyi7IhEG9XmbceCxAcLGKAddAOdP9Ph1ZT2NioMQCU,1606
 oscura/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-oscura/analyzers/__init__.py,sha256=UNSltiHbqKbkuBOSeOqy9R2VkFcBIAFwPErJ0H1pswM,896
+oscura/acquisition/__init__.py,sha256=JAQt5FXsGiKPkqHuyWJoGVnGf1ElSRXqGxJdjcDLLho,4834
+oscura/acquisition/file.py,sha256=nrOWunIGxUaF-B946ZKwME4f-8jbWhp3z3BadvCuUw0,8426
+oscura/acquisition/hardware.py,sha256=-BrIi0aLoVBTVIh5gdTvYY5OrDPIv06wxrx28GJw7j8,6598
+oscura/acquisition/saleae.py,sha256=D61v7_k-zZzor-jiYHFwjd-u8VFo93spQ3_m7Jhk_Dc,11438
+oscura/acquisition/socketcan.py,sha256=ifs7Chv-pk4LLYTvfe4-9xS2-vbe4efqVd1azIYLexE,10575
+oscura/acquisition/streaming.py,sha256=P57M8S33DGIeoDUSBHm3bzoKfNIDZkYE4dODPNeJy78,1191
+oscura/acquisition/synthetic.py,sha256=VXhz5W0gzwE3_Ezo7hADwfFoTV5pOixpPCVNPMngNAo,7823
+oscura/acquisition/visa.py,sha256=phUwdlbphvNhSCaRgIXuPb8YDP0jR4eqY-OuJXCgRCo,12272
+oscura/analyzers/__init__.py,sha256=LE-KFYoVePYsiPIy2NDNB2OrzbtqYezdCu9xqqPxgrY,985
 oscura/analyzers/measurements.py,sha256=ng5Qt2jyAvfKw3JQbJY_JNUqAOJEZwPo3UWa0xSg5Xk,697
 oscura/analyzers/validation.py,sha256=vHSKmLThwcU0j5Dat9QPbWImw_dqUGaZk_Ul6XbJ958,20376
 oscura/analyzers/digital/__init__.py,sha256=CrZxLveYI-nZ7INCZg-4zp8UP_uQRpMmX2vljzudJ6s,4228
 oscura/analyzers/digital/bus.py,sha256=Wf3QUKNSxzXaWItR1rdf32kELayywrIg0TC-OhKEub0,22717
-oscura/analyzers/digital/clock.py,sha256=Ls9-YgH0qRLhkZWG9qVadcGw9koT21UPvFk-Ia5OuZ8,25802
+oscura/analyzers/digital/clock.py,sha256=2WihQyf2fUlKTDAOKrhQSStiuUw711CvR6bMbkiliAc,26088
 oscura/analyzers/digital/correlation.py,sha256=_D-pmymVU1rTemSUfg_MklXCo03VkfAFcxSTLAV6jcY,23689
-oscura/analyzers/digital/edges.py,sha256=uQf00dxcN8h8dni3l-ksZ8XsMswk5Gzhtdqp7GpFkk8,20000
+oscura/analyzers/digital/edges.py,sha256=-Mlyh_SFkqs7L2n11bfYlv8bHD-jrfV6UByhXS1DLp0,20018
 oscura/analyzers/digital/extraction.py,sha256=wBOPZi3H1llCHsq36txz_jkEO--Sj6pbsxPZXXGk5_c,12144
 oscura/analyzers/digital/quality.py,sha256=bMXpmAhs15tjyiWW0Ao5aZcK_8AvEKyo_E3rtxDrFlo,27413
 oscura/analyzers/digital/signal_quality.py,sha256=Ssb1MkUfqjiENJJFOslkTX8Ef6C65HFCM_Ra20Bvp4k,30130
 oscura/analyzers/digital/thresholds.py,sha256=CrGgO1rtzkUOnYb40UT3_uD_0qVA853lGL2WNL95qv4,22428
-oscura/analyzers/digital/timing.py,sha256=ilk6iacaIup2epB_VOnNjg0jGBFT5wBX-CpaZLFVScM,33138
+oscura/analyzers/digital/timing.py,sha256=eOo1jk-FfUd3tkqDndPTz-JO5tnfW9w4dEI-klgW-QU,34862
 oscura/analyzers/eye/__init__.py,sha256=SRW0Ir-1RWLwoaenk6FZhGOIWPkuhevYTPt_-8thPw0,974
 oscura/analyzers/eye/diagram.py,sha256=T3QwuZ3nvlHzSkmjp47ariRlt3FnfsK6yh3WsPszhmI,13307
 oscura/analyzers/eye/metrics.py,sha256=QDwtMxiBPSXbUCyFnTiAgWllbVCrcI4xEo6teZc3Cm8,17210
@@ -65,10 +73,13 @@ oscura/analyzers/protocols/spi.py,sha256=gl0LVpZVI22tr7h5D1OAdDtlY_krb7CdNCNP10D
 oscura/analyzers/protocols/swd.py,sha256=NAInX2bZyZFCM03CLjjxraYTV7cCGOzcl_OEXU21qZE,10155
 oscura/analyzers/protocols/uart.py,sha256=6bf9EFHjHjkSeTxBq8b6GRlp1xWlBh65HuUcmWxWAEA,12188
 oscura/analyzers/protocols/usb.py,sha256=jBjmqfqnwys6Zvd7Ku-zZRNlOVZB7xKPmocM2NynGg4,14541
+oscura/analyzers/side_channel/__init__.py,sha256=XGD7uvvL6Mf2FO6VU5fbBTtfARA-WGXa-rvHAbjNBxc,1361
+oscura/analyzers/side_channel/power.py,sha256=036A5ygwGVa5jqOFoOWm1bV-x63FrztyCS8cIEc68wo,17995
+oscura/analyzers/side_channel/timing.py,sha256=loNKa5dgWu9sFTsKCNt087vqYCjBIVVQn3lzQBb3pQc,12128
 oscura/analyzers/signal_integrity/__init__.py,sha256=RXt5K79WFsy3NvJuNjVxWCf0r6Z8kOIBvJSBBw4X2Y8,1410
 oscura/analyzers/signal_integrity/embedding.py,sha256=LV-8TwSfCfFe-TavXXKOw7eIeigxkvKeJktyQiqcZXg,8036
 oscura/analyzers/signal_integrity/equalization.py,sha256=cVomry8n-U5pS8F2LKuEdZBwmi1wfbQo2vyWettn2A0,9906
-oscura/analyzers/signal_integrity/sparams.py,sha256=uLusiE942QR6rmB5c_VfhRWjGEM4zC9nwCcMxXG2Twg,8289
+oscura/analyzers/signal_integrity/sparams.py,sha256=TK4o-IOfnVVbfycBgJ0XhTgBYxHcBNdFbmC9TXhfMJs,8303
 oscura/analyzers/spectral/__init__.py,sha256=YeUKiUOtN3LkWjPmjiG55OWMldSaBJ4BE4OSem7sdm0,850
 oscura/analyzers/spectral/chunked.py,sha256=KS1Jtv_o9vripQVH3CeaTBx-Lq4AAU-eOXF9_En3rc4,8551
 oscura/analyzers/spectral/chunked_fft.py,sha256=VKslVgXv7xuSuVVx-Fk2eh255AG6D0D-hQFzAbz1Hk4,18593
@@ -99,7 +110,7 @@ oscura/api/fluent.py,sha256=Bvo1yVqqn3nmVWaoPv4C-YtYszBhHmdW8m5NdyhWEEo,15373
 oscura/api/operators.py,sha256=To4PZUrwInD43T7i2Sy8YD04eLoRsmrD6XYePuExUX8,13853
 oscura/api/optimization.py,sha256=5R6rPByVsyxla6oq4SjxjxEp9Uplog4owzsIuFcVoR0,11875
 oscura/api/profiling.py,sha256=vkYinleXrznWdd0OT5zIJN_PW289GQE_ODmR9DaCcQ0,10567
-oscura/automotive/__init__.py,sha256=b1LX9vQXG4FhN_XRq2LJgUNq36-xuAgMjGyEl-EzLS4,2423
+oscura/automotive/__init__.py,sha256=3Wt44lFmx_zzyC1_IeukEpEnUagyM8TT0mWUnTpXb4s,2538
 oscura/automotive/visualization.py,sha256=2ILQjzNwCwj6zZ4MEsBS-QLwYFKMO0_0xDsbv3gEXu0,10692
 oscura/automotive/can/__init__.py,sha256=0WCLgE6juqQF_mTO716tWzfziOcM6cjshdb957G0edw,1283
 oscura/automotive/can/analysis.py,sha256=0z6MycxuJGusqDQhYEpHnGRmDw3OMf5yDbS8zI6GJO0,11251
@@ -108,9 +119,9 @@ oscura/automotive/can/correlation.py,sha256=B7MXSz_uzce-dSkwON4ssmFzC53hYc6GupZW
 oscura/automotive/can/discovery.py,sha256=E4Z-zc8cOP_yUklhVp2tBLOIw2I9KU4mLoSb37VsgTk,11237
 oscura/automotive/can/message_wrapper.py,sha256=xCyHLMvvTiloifWXELoeuN6Qz_vrLL8iPjxZG1FvJYY,12640
 oscura/automotive/can/models.py,sha256=fGnCt8FBKURKAz295s2duUas--w2rVfJpMEZ4O9uPvA,12046
-oscura/automotive/can/patterns.py,sha256=PPAnWrOFgh3EWlzgtT0H8TJcw1kA41uYZWviwOIQvts,13837
-oscura/automotive/can/session.py,sha256=6weEsM8AqgET7hVXwTW7QPpIGgblRVHR5RMOKJXbNnA,15597
-oscura/automotive/can/state_machine.py,sha256=NDwCFYw42J3M1QuigA7XNY5E9L0sfUygcvfALb6kt70,10205
+oscura/automotive/can/patterns.py,sha256=XkiBnxaL20Zbpt9aK7dS8BGXQtbNe8PoyTyZNsj-BLY,13960
+oscura/automotive/can/session.py,sha256=bLbDuKw2uuGvIr25E0njYJGWw1urRVhWVMckVUL2EI4,24577
+oscura/automotive/can/state_machine.py,sha256=yeHwydg5RegCPg_zvzS7lLZX-JfBdfMySUcNgMszuIY,10407
 oscura/automotive/can/stimulus_response.py,sha256=y_oN297KypsFewjM6kvjGII0-7Ubpz2RZBPr8pjW-Gc,16543
 oscura/automotive/dbc/__init__.py,sha256=7s36h4LQrJKKkO3ICHeuVCoYVx8jGnHT_wKcJgOsQFQ,380
 oscura/automotive/dbc/generator.py,sha256=EqJKJikAK2Neaff2H9AGb8ZnseE8m4lFAFRMXEIwjsY,5616
@@ -138,8 +149,8 @@ oscura/batch/aggregate.py,sha256=NBc1RmSGbSRUdpuZG_3wy-vSkGlegGRSj_6WqPqhTkM,105
 oscura/batch/analyze.py,sha256=RfRJQ9w9rlutDlT9nTdqSCswi9FxAsznYbCN51Cx2-Y,4891
 oscura/batch/logging.py,sha256=ay8BxwBfH75k5qgs68gI1LdAjPJQg31ZtBxwmWs2XIo,15502
 oscura/batch/metrics.py,sha256=KrY9R0fKttVSW7wL3ra3A4XHVfAeUaLeoM0BtU3GEWI,17312
-oscura/builders/__init__.py,sha256=EhiubV1xFlhfERyoKtgPSD_mIj8BUW1_s0kUv7BrNl8,1187
-oscura/builders/signal_builder.py,sha256=SgmSkOfSFQ6vge2861rbiZ7ZCKf6g-RpezI88tfLROE,35293
+oscura/builders/__init__.py,sha256=7ryrfaFlT4zAh5zKr76LLQDionMFsPv57E_1OlxrkE0,1326
+oscura/builders/signal_builder.py,sha256=nH7AK6YJZZ_KoDcqL3zsxCFwgBQNFieP1k_fChnD4EU,33099
 oscura/cli/__init__.py,sha256=OsdCTexpFCKn-o7FPnwTEAZE52E2s-NbXwpADUOfhDM,275
 oscura/cli/batch.py,sha256=6WkdQF5G03cwCGxfErqr-nq2llOXJqLrfk3u2agUlXY,10773
 oscura/cli/characterize.py,sha256=yMAm4Ji_Dq4Hml3PeDftoUFq60z1BpU_6O7HJ9dUDtc,8898
@@ -185,7 +196,7 @@ oscura/core/correlation.py,sha256=3kG-scCs7Lv3uYJhvGYbnSyCsf9gQOqX9hnRTsZjAII,64
 oscura/core/cross_domain.py,sha256=ZGJGieFpLEMTHEeQ8GFZnNZL0WgKLW_fn7joEptovpE,16118
 oscura/core/debug.py,sha256=1fz5Mwx6dcMXwsGNQMhPCVduAf2ZTSGSvvwjpqIS3Cc,8160
 oscura/core/edge_cases.py,sha256=-z95foSBKZb3V2DhGQSw1A2VaVOGRBdhMfxDooWbLhg,16367
-oscura/core/exceptions.py,sha256=h_s0HX9SkZYcHyTmpQvDMRD93cmY47z4VYw_pfDBGf4,17500
+oscura/core/exceptions.py,sha256=VOvd6iY4SQWz_fPx9EgwdbaIHpqydyFAou8SeZa7w48,17691
 oscura/core/gpu_backend.py,sha256=U7DoPKHltlGNTFk6cOhpuVUC5VuglahbBRu1jZ83nDE,17700
 oscura/core/lazy.py,sha256=XwXPznvfpgfJqRvONO2YcgLE9IxekhHLQboiLm3a2jw,26302
 oscura/core/log_query.py,sha256=qV7NrZH3W6Xq1BEsEIc6Z4ZW8k3vi6U16Br23tSynhk,17051
@@ -289,8 +300,9 @@ oscura/integrations/llm.py,sha256=sPt58GZYW6G4rkwX4956RP-FsFNDXCffyiPlBuah6Y4,58
 oscura/jupyter/__init__.py,sha256=L5un2-sVNGP46rzJ7e3qrJOyXmhj2BkhLc7DGQzSLj0,726
 oscura/jupyter/display.py,sha256=HuLg5NEIKAGEZe_3EmABaRkTzLAfdAm6VTBw9LCl030,8597
 oscura/jupyter/magic.py,sha256=O1m9N6I5nMUKhCnNANiOdr2pouQxI9oRIcLeRNtrdTc,9953
-oscura/loaders/__init__.py,sha256=6osTOOBd1Q7w2wwxOU9kiLD-Q2CE--kCYsN7mdEBmRI,16793
+oscura/loaders/__init__.py,sha256=JKlIsEY0vKEtnXAccgQ6SJMkWYRm9ijM13SSPaqQQJg,16870
 oscura/loaders/binary.py,sha256=Y5j0jaDggSmhFRZvGHT2Fph2dvhTWsqoYWwkOHIBug4,1875
+oscura/loaders/chipwhisperer.py,sha256=vUsmt6Pamybivp6cqqxe70QUlNrVPdQDn-OS5wEdqxo,12049
 oscura/loaders/configurable.py,sha256=dJKv3nFSgmWe22ZNB1kTZZyIWgiMhWTf8ZU-SNahefk,41267
 oscura/loaders/csv.py,sha256=hjToCQkXQEMUCOSBTf3a1d4AAsntvxYbW_jiccQ9JaM,918
 oscura/loaders/csv_loader.py,sha256=Y4MOJQ-95tZsi9hDdu9ru1vTJQyGtGxkhV7RUqGBLWg,14252
@@ -305,7 +317,7 @@ oscura/loaders/rigol.py,sha256=nwf5aNpH0bWerDgneUpLNlDQfouQ9E_PChv6vG8GLTA,9238
 oscura/loaders/sigrok.py,sha256=puyj357BPiJpzNB-hcv6ofp6DZFEnOv_usdi-_zs6Co,10250
 oscura/loaders/tdms.py,sha256=QngrFLJTpctfqcCtv2x3PJmNwfIeWgyug97N_xSdaMA,10483
 oscura/loaders/tektronix.py,sha256=rLqTefIwGCCmkpUwflEJMuKSfGG1qX_pAFF7Kk0j6-I,24069
-oscura/loaders/touchstone.py,sha256=-rg5cj6kNzVBbrloErY2a5_yfcNihlbhZKk3PfNb4sY,6128
+oscura/loaders/touchstone.py,sha256=HdrpVsyHACSMD8DR86iCI5cj9vdXGXbpADNkjaQRUng,6179
 oscura/loaders/validation.py,sha256=JA_vVYQJB4gC9KFKa2lsGV5D-_agmIjP9kE_dXpv4Wk,17835
 oscura/loaders/vcd.py,sha256=YtRqU6AEkZjZhNnyNOfgBsxZ8rueB5pALrYIoiRYHQ8,13662
 oscura/loaders/wav.py,sha256=UYPc1A1ZRuw5zC7XmBdEqjZpsi2QvSW1noNmXZqpy2k,7251
@@ -393,7 +405,11 @@ oscura/search/pattern.py,sha256=pqCtlFDKZwms1LrX64Halt25EQAI1VKr3X_6W4XQ_xI,5735
 oscura/session/__init__.py,sha256=LAeHbROHU-OBSep1NWffhhcOxVuK30hoKnYgzBsnmn4,926
 oscura/session/annotations.py,sha256=btHVzA6CedrqVI-c_uFVi_lo7-NByxBLTDHoXWYtY08,8713
 oscura/session/history.py,sha256=3YAMhON7wlzNdR03HpGSYWJEuxBsrYeYq19YALc8k8M,9578
-oscura/session/session.py,sha256=fK5YD5nDKOGHaRTkwhLfkr6TkDTBJx2vTCImPzcMf3s,16185
+oscura/session/session.py,sha256=MWx2cE_ZtyWwl5v8QR_X2MGEBn-TAaFftwKNyZktwIU,16321
+oscura/sessions/__init__.py,sha256=BCmLuo95CfyutHrjEFdWSKRDzKKpDGVMcFi3989HiFA,2371
+oscura/sessions/base.py,sha256=S2ka5o01w1YVBHH59EV64tmW9fXErfNuG2zu9g13-t8,10820
+oscura/sessions/blackbox.py,sha256=CyYA6o7d9pMSR6rsbUOQYq6lBSfUUq-ivtr1QKUppdU,22176
+oscura/sessions/generic.py,sha256=hqwhGO_DT3rS0EOKhLtcebJPu81PPLfHSLH1qVmAWj0,6642
 oscura/streaming/__init__.py,sha256=uJKpXU6-uBW1lWqh8_8WNzUKSLhMYzxrJstsNMDLVcM,959
 oscura/streaming/chunked.py,sha256=tWK7m_fHJVJKGq2y6I3RRfioUER2ObMUDPvJ78K73d0,19487
 oscura/streaming/progressive.py,sha256=YRdAd4P9Zvckerm2kG5bFWZtcuUB1FlRklpS1078s9c,13089
@@ -458,8 +474,8 @@ oscura/workflows/power.py,sha256=fpTzoIfuZi69ldtu2KAHW-Qu6jzA5jBa_9LVy6xqpTI,608
 oscura/workflows/protocol.py,sha256=x3T-M81vFVrW3mouaYA8WjxyLLzZyLATVJbiqcMAVFQ,15275
 oscura/workflows/reverse_engineering.py,sha256=K_yrqrQqQNcCoB0jRAG92e2zy8er3oiKJWSF6lU4nGk,19929
 oscura/workflows/signal_integrity.py,sha256=p-DOC-AhzQOkG_jyyBK3EUaIBAGZhAhdmo-Ub_ifC3U,8391
-oscura-0.3.0.dist-info/METADATA,sha256=5q5ASfeIwK-qE3ipz29nutrQyxZZMZ6odN9GtUhOVn8,13291
-oscura-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-oscura-0.3.0.dist-info/entry_points.txt,sha256=QLBxd-iTjBQ5HidaVSkLBwvUsqxSG1ZTJ6i-0juu960,48
-oscura-0.3.0.dist-info/licenses/LICENSE,sha256=p1_oEK-oqWDXMFSv5mKbyYkgW-CPbCnFUvdICu490aY,1077
-oscura-0.3.0.dist-info/RECORD,,
+oscura-0.4.0.dist-info/METADATA,sha256=Usu1H_SaG7TkKGT33lnwM0WfPH4FB-icct_YbUwO1EM,16212
+oscura-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+oscura-0.4.0.dist-info/entry_points.txt,sha256=QLBxd-iTjBQ5HidaVSkLBwvUsqxSG1ZTJ6i-0juu960,48
+oscura-0.4.0.dist-info/licenses/LICENSE,sha256=p1_oEK-oqWDXMFSv5mKbyYkgW-CPbCnFUvdICu490aY,1077
+oscura-0.4.0.dist-info/RECORD,,