Staqtapp-TDS v3.11.0

Staqtapp-TDS 3.11.0 is the final public version of TDS.

Platform: Linux.

This public distribution does not include Eaglegate activation or full Eaglegate integration. The Olum multi-agentic registry system and workflow are not included.

Eaglegate target and shadow qualification utilities remain non-authoritative and cannot activate production serving.

Staqtapp-TDS is a directory-first storage, persistence, evidence, and operations engine for Python systems. It stores typed values in an indexed hierarchy, persists exact bytes to rooted .tds files, and returns stable non-halting results for ordinary operations.

Programmer Core API Guide (PDF; complete source ZIP)

Available features

Measured performance

PyPI 3.8.3 compared with 3.11.0

The 843–1,011× results are the removal of the old post-2,048-entry registry scaling and correctness cliff, not general TDS throughput multipliers. Version 3.8.3 omitted live keys in those fixtures; 3.11.0 retained exact closure.

Additional 3.11.0 medians

Benchmark scope:

• Linux 6.18.35 x86-64, one AMD EPYC 9V74 core, CPython 3.12.13, NumPy 2.3.5.
• Numba disabled, CPU affinity 4, PYTHONHASHSEED=0, two warmups, nine timed repetitions.
• Paired results were accepted only after values, telemetry, packed bytes, round trips, and SHA-256 roots matched.
• Results are workload-specific local measurements. tracemalloc is not process RSS.

Benchmark harnesses are included in the complete source ZIP.

Install

# Base package
python -m pip install "staqtapp-tds==3.11.0"

# Optional Numba acceleration
python -m pip install "staqtapp-tds[fast]==3.11.0"

# Optional PySide6 cockpit
python -m pip install "staqtapp-tds[gui]==3.11.0"

The PyPI wheel uses deterministic Python backends. Optional native builds are Linux-only and require an explicit source build:

STAQTAPP_TDS_BUILD_NATIVE=1 \
  python -m pip install --no-binary staqtapp-tds "staqtapp-tds==3.11.0"

Quick start

from pathlib import Path

from staqtapp_tds import TDSFileSystem, TDSPersistence, TDSReader

fs = TDSFileSystem("agent_state")
runtime = fs.makedirs("/models/runtime")

assert runtime.write_text("system_prompt", "Be precise.").ok
assert runtime.write_json("settings", {"temperature": 0.2}).ok
assert runtime.write_result("step_count", 7).ok

result = runtime.read_result("settings")
assert result.ok and result.value["temperature"] == 0.2

store = TDSPersistence(Path("./tds_store"))
store.flush(fs, parallel_nodes=False)

path = Path("./tds_store/agent_state__models__runtime.tds")
assert store.load_node(path).read_value("step_count") == 7

with TDSReader(path) as reader:
    assert reader.audit_integrity()["ok"]

Commands

Format and authority boundaries

License

MIT. See LICENSE.