thoughtflow 0.2.3__tar.gz → 0.2.4__tar.gz

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to ThoughtFlow will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.4] - 2026-07-11
+
+### Fixed
+- MEMORY index tie-breaking: events with identical `dt_utc` now preserve insertion order (fixes flaky replay and get_events tests on CI)
+- `add_exchange()` stamp now includes response payload so duplicate-key recordings are not overwritten
+
 ## [0.2.3] - 2026-07-11
 
 ### Fixed
@@ -202,7 +208,8 @@ grown from MEMORY itself, with zero new concepts.
 ---
 
 <!-- Release links -->
-[Unreleased]: https://github.com/jrolf/thoughtflow/compare/v0.2.3...HEAD
+[Unreleased]: https://github.com/jrolf/thoughtflow/compare/v0.2.4...HEAD
+[0.2.4]: https://github.com/jrolf/thoughtflow/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/jrolf/thoughtflow/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/jrolf/thoughtflow/compare/v0.2.0...v0.2.2
 [0.2.0]: https://github.com/jrolf/thoughtflow/compare/v0.1.3...v0.2.0

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtflow
-Version: 0.2.3
+Version: 0.2.4
 Summary: Powerful AI systems from simple parts. Composable cognitive primitives, event-sourced memory, and autonomous agents in pure Python with zero dependencies.
 Project-URL: Homepage, https://github.com/jrolf/thoughtflow
 Project-URL: Documentation, https://thoughtflow.dev
@@ -164,7 +164,7 @@ supply-chain anxiety. The core library uses only Python's standard library —
 pip install --upgrade thoughtflow
 
 # Pin to a specific version for stability
-pip install thoughtflow==0.2.3
+pip install thoughtflow==0.2.4
 
 # Check your installed version
 python -c "import thoughtflow; print(thoughtflow.__version__)"

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/README.md

@@ -93,7 +93,7 @@ supply-chain anxiety. The core library uses only Python's standard library —
 pip install --upgrade thoughtflow
 
 # Pin to a specific version for stability
-pip install thoughtflow==0.2.3
+pip install thoughtflow==0.2.4
 
 # Check your installed version
 python -c "import thoughtflow; print(thoughtflow.__version__)"

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thoughtflow"
-version = "0.2.3"
+version = "0.2.4"
 description = "Powerful AI systems from simple parts. Composable cognitive primitives, event-sourced memory, and autonomous agents in pure Python with zero dependencies."
 readme = "README.md"
 requires-python = ">=3.9"

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/src/thoughtflow/__init__.py

@@ -105,7 +105,7 @@ try:
 
     __version__ = _get_version("thoughtflow")
 except Exception:
-    __version__ = "0.2.3"
+    __version__ = "0.2.4"
 
 # Public API
 __all__ = [

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/src/thoughtflow/memory.py

@@ -183,7 +183,8 @@ class MEMORY:
         self.idx_refs = []          # Reflection [timestamp, stamp] pairs
         self.idx_logs = []          # Log [timestamp, stamp] pairs
         self.idx_vars = []          # Variable-change [timestamp, stamp] pairs
-        self.idx_all  = []          # Master index (all [timestamp, stamp] pairs)
+        self.idx_all  = []          # Master index (all [timestamp, seq, stamp] triples)
+        self._index_seq = 0         # Insertion tie-breaker when dt_utc collides
         
         # VARIABLE LAYER: Full history with timestamps
         # vars[key] = [[stamp1, value1], [stamp2, value2], ...]
@@ -235,15 +236,17 @@ class MEMORY:
 
     def _add_to_index(self, index_list, timestamp, stamp):
         """
-        Insert [timestamp, stamp] pair maintaining sorted order by timestamp.
-        
-        Args:
-            index_list: One of the idx_* lists
-            timestamp: ISO timestamp string (dt_utc)
-            stamp: Event stamp ID
+        Insert [timestamp, seq, stamp] maintaining sorted order by timestamp.
+
+        When two events share the same dt_utc string (common in tight loops),
+        seq preserves insertion order instead of falling back to stamp sorting.
         """
-        # bisect.insort sorts by first element of tuple/list (timestamp)
-        bisect.insort(index_list, [timestamp, stamp])
+        self._index_seq += 1
+        bisect.insort(index_list, [timestamp, self._index_seq, stamp])
+
+    def _stamp_from_index_pair(self, pair):
+        """Return the stamp from a 2- or 3-element index pair (legacy compat)."""
+        return pair[-1]
 
     def _store_event(self, event_type, obj):
         """
@@ -278,15 +281,18 @@ class MEMORY:
         Get events from an index, optionally limited to last N.
         
         Args:
-            index: One of the idx_* lists (format: [[timestamp, stamp], ...])
+            index: One of the idx_* lists ([timestamp, stamp] or [timestamp, seq, stamp])
             limit: Max events to return (-1 = all)
             
         Returns:
             List of event dicts
         """
         pairs = index if limit <= 0 else index[-limit:]
-        # Extract stamp (second element) from each [timestamp, stamp] pair
-        return [self.events[ts_stamp[1]] for ts_stamp in pairs if ts_stamp[1] in self.events]
+        return [
+            self.events[self._stamp_from_index_pair(ts_stamp)]
+            for ts_stamp in pairs
+            if self._stamp_from_index_pair(ts_stamp) in self.events
+        ]
 
     def _get_latest_desc(self, key):
         """
@@ -425,7 +431,7 @@ class MEMORY:
             request: JSON-serializable dict describing the request.
             response: JSON-serializable response payload.
         """
-        stamp = event_stamp({'key': key, 'kind': kind})
+        stamp = event_stamp({'key': key, 'kind': kind, 'response': response})
         exchange = {
             'stamp'    : stamp,
             'type'     : 'llm',
@@ -1206,6 +1212,7 @@ class MEMORY:
         self.idx_logs = mem.idx_logs
         self.idx_vars = mem.idx_vars
         self.idx_all = mem.idx_all
+        self._index_seq = mem._index_seq
         self.vars = mem.vars
         self.var_desc_history = mem.var_desc_history
         self.objects = mem.objects
@@ -1328,7 +1335,8 @@ class MEMORY:
         mem.idx_logs = data.get('idx_logs', [])
         mem.idx_vars = data.get('idx_vars', [])
         mem.idx_all = data.get('idx_all', [])
-        
+        mem._index_seq = len(mem.idx_all)
+
         return mem
 
     @classmethod
@@ -1367,8 +1375,9 @@ class MEMORY:
             # Store in data layer
             mem.events[stamp] = ev
             
-            # Create [timestamp, stamp] pair for indexes
-            ts_pair = [timestamp, stamp]
+            # Create index pair; seq is assigned on load for stable ordering
+            seq = len(mem.idx_all) + 1
+            ts_pair = [timestamp, seq, stamp]
             
             # Add to appropriate index (direct append since already sorted by timestamp)
             if event_type == 'msg':

{thoughtflow-0.2.3 → thoughtflow-0.2.4}/tests/unit/test_memory.py

@@ -1308,20 +1308,19 @@ class TestGetEvents:
 
     def test_get_events_returns_chronological_order(self, memory):
         """
-        get_events must return events in chronological order.
-        
-        Order is determined by event stamps.
-        
-        Remove this test if: We change ordering.
+        get_events must return events in insertion order.
+
+        Stamps embed a random component and are not guaranteed to sort
+        lexicographically when events are created in the same clock tick.
         """
         memory.add_msg('user', 'First', channel='webapp')
         memory.add_log('Second')
         memory.add_ref('Third')
-        
+
         events = memory.get_events()
-        stamps = [e['stamp'] for e in events]
-        
-        assert stamps == sorted(stamps)
+        contents = [e['content'] for e in events]
+
+        assert contents == ['First', 'Second', 'Third']
 
     def test_get_events_respects_limit(self, memory):
         """