Tiersense README

The project's README from github.com/wangmingxuan666/Tiersense. As one markdown file: README.md.

TierSense

TierSense

Understand difficulty. Decide when to compress and recall.

TierSense API Memory Control PDF StateComp PDF Authors' statement

English · 简体中文

The main TierSense repository: use the three modules independently or combine them for your application. Find project navigation, integration guidance, and the centralized authors' statements here.

[!IMPORTANT] Authors' statement | Independent technical approach and research timeline

We deeply regret that, in this day and age, publishing our work requires us to clarify when we began it. Nevertheless, we will do so.

We solemnly state that the three methods and two manuscripts were completed before September 14, 2026, Beijing time (UTC+8), with their actual completion dates being earlier still (supported by the WeChat screenshot at the end of this page). Jev appeared on September 15, 2026. This work represents approximately six months of effort before its public release. These were not papers hastily assembled with AI within a few days of Jev's appearance. The two papers emerged as branches of the research process; both are complete studies developed through validation and released recently after repeated refinement. For the detailed timeline, please contact the account holder directly.

This method follows a completely different technical approach from Jev and includes our own mechanistic findings. We regard it as an advance beyond Jev through an independent technical direction—not a reproduction or a rushed follow-up. This is the authors' assessment of originality and technical direction, not a claim that a universal performance advantage across all tasks has already been demonstrated in published comparisons.

We oppose hastily assembled work lacking substantive research presented under the label “auto research,” and we disagree with applying that label to carefully developed work based solely on publication timing. We want to make a genuine contribution to the community and recognize that AI-assisted research can produce high-quality results. We ask that the effort behind this method and manuscript not be dismissed as automatically generated filler without a fair examination.

At the same time, we understand the concerns about research quality and appreciate those who speak up for meaningful scholarly discussion. We hope to work alongside you to produce and publish genuinely valuable research, so that sustained effort receives thoughtful consideration rather than being dismissed overnight as filler. If this resonates with you, please join our official discussion group to exchange ideas, explore new directions, and pursue more interesting and rigorous research together.

We welcome you to use our work and share your valuable feedback. Questions, reproduction efforts, and open discussion are all welcome.

Three modules, one entry point

Module Question Output Guide
TierSense-Score How difficult is the current task? Five feature scores and an overall score Difficulty scoring
TierSense-Compress Which historical steps are ready for compression? Per-step recommendations and span selection History compression
TierSense-Memory-Decide Should history be compressed or recalled now? Two decisions and their confidence values Memory decisions

These modules provide decision signals. Your application switches models, generates summaries, and retrieves memories. See each module's documentation for its complete contract and latest capabilities.

Choose a module

Quick start

Get an API key from the TierSense platform. These endpoints follow the current module documentation; creating this hub does not change them.

Capability POST endpoint
Difficulty scoring https://tierflow.cn/tiersense/v1/score
History compression selection https://tierflow.cn/tiersense/v1/compress
Compression / recall decisions https://tierflow.cn/tiersense/v1/memory/decide

Minimal request examples for all three APIs. Request and response contracts differ; fields are not interchangeable.

Paper

Memory Control Signals Emerge Before Action in Long Horizon Agents

StateComp: Learning When to Compress History in Long Horizon Agents

Repository PDF copies: Memory Control · StateComp

Read or download the full author-provided PDFs: Memory Control (35 pages) and StateComp (33 pages). Research systems and hosted APIs have different scopes; see the usage guides for the API contracts.

Documentation

This repository is the single maintained home for documentation, integration examples, and paper links across all three modules. Please direct future updates, Issues, and Stars here. The old repositories retain migration notices, historical files, and commit history. Model weights, production configuration, and self-hosted inference server code are not included.

Join the community

TierFlow

We welcome you to use our work and share your valuable feedback. Questions, reproduction efforts, and open discussion are all welcome.

TierFlow official discussion group QR code and contact information

Research timeline screenshot

Author-provided research timeline screenshot

Tiersense (wangmingxuan666/Tiersense)

Searching Database…

Что это?TierSense — хаб из трёх API, основанных на исследованиях: они дают ИИ-агенту сигналы для решений — о сложности задачи, какие шаги истории готовы к сжатию и стоит ли прямо сейчас сжать или извлечь память, — чтобы ваше собственное приложение могло действовать по этим сигналам.
Это библиотека для установки или хостинговый API для вызовов?Это хостинговый API-сервис, который вы вызываете с API-ключом; репозиторий — лишь документация и хаб интеграций для трёх эндпоинтов, а не SDK и не сервер для самостоятельного хостинга.
С чего начать?Получите API-ключ на платформе TierSense, затем по мере надобности отправляйте POST-запросы на эндпоинты Score, Compress или Memory-Decide.
Обязательно ли вызывать все три API?Нет, каждый модуль независим: один Score — для показа сложности или маршрутизации моделей, один Compress — для выбора истории на сжатие, один Memory-Decide — для решения, когда извлекать память; комбинируйте, только если ваш сценарий этого требует.
Что именно возвращает каждый из Score, Compress и Memory-Decide?Score возвращает пять признаковых оценок плюс общую оценку сложности, Compress — рекомендации по сжатию для каждого шага и выбор интервалов, а Memory-Decide — два решения (сжать/извлечь) со значениями уверенности.
В чём история с упоминаниями «Jev» в README?Авторы заявляют, что их методы и две статьи были готовы до появления Jev 15 сентября 2026 года — это примерно полгода независимой работы, — и возражают против ярлыка спешного «автоисследования» в ответ на него.
Где почитать исследования, лежащие в основе?Работа описана в двух приложенных PDF: «Memory Control Signals Emerge Before Action in Long Horizon Agents» (35 страниц) и «StateComp: Learning When to Compress History in Long Horizon Agents» (33 страницы).
Это единственный нужный мне репозиторий или есть более старые?Теперь этот репозиторий — единственное поддерживаемое место для документации, примеров интеграции, Issues и Stars; старые репозитории хранят только уведомления о миграции и историю коммитов.
Size
6.4 MB
Stars
713
Updated
CommitOct 01
Age
26d
Commits · 90 Days