Skip to content

Droste 1.3.0 - Progressive space, bounded tokens

Latest

Choose a tag to compare

@lorismascio17 lorismascio17 released this 19 Oct 15:03

Droste 1.3.0 adds progressive code exploration: search a local graph, navigate by node ID, and zoom from map to structure to source within a measured token window.

  • New CLI droste explore and MCP droste_explore.
  • Real o200k_base / cl100k_base budgets on the complete compact response, including JSON, source locations, receipts and newline.
  • One MCP text block, with automatic duplicate structured output disabled.
  • Reuse exact unchanged representations only when the client explicitly acknowledges it still retains them. Clear receipts after compaction.
  • Verify source hashes and refuse stale or unverifiable snapshots. Show omitted candidates, truncated links and each item's actual detail level.
  • Keep the legacy character-budget context API and original galaxy viewer.

Try the recorded interactive demo ? Workflow and limitations

On pinned Requests source, the complete source response for HTTPAdapter.send was 2,500 tokens; a retained revisit returned 827 tokens. Its acknowledgement arguments add 254 tokens (the original arguments add 16). These are selected payload-size observations, not model task success, provider billing or competitor-performance results. Natural-language discovery and dynamic call resolution remain limited.

Validation: 105 regression cases on Linux Python 3.10/3.11/3.12 and Windows Python 3.12; distribution checks; installed-wheel CLI/receipt/HTTP and actual calls to all ten MCP tools, including checking the exact counted single text block. All three public Requests investigations were also checked through the installed wheel. The recorded demo was exercised at desktop and mobile sizes.

python -m pip install --upgrade droste-memory
droste index .
droste explore --tokens 1000

The first tokenizer use downloads a small vocabulary; run droste explore --prepare-tokenizers once for later offline use. Token counts cover the returned text under the chosen reference encoding, excluding tool-call arguments, provider wrappers and other session messages. File-size reductions do not establish task quality or lower bills.

Release CI

Published on GitHub, PyPI and the MCP Registry.