You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
MCP: как агент дочитывает длинный список — потолок 500 без продолжения (находка живого прогона) #502
Первый живой прогон «три поверхности» (E5, #501) сравнил 56 операций через CLI, MCP и SDK. Данные совпали везде, кроме одного места — и это не ошибка сравнения, а дыра:
Поверхность
tracker issues search, один и тот же запрос
CLI с --all
752 задачи
SDK
752
MCP
500, и всё
У инструментов MCP есть потолок на число элементов (500), а способа дочитать остальное у агента нет: ни --all, ни «следующей страницы». Он даже не узнаёт, что получил не всё (это принятая идея 16: сказать об обрыве). Потолок есть у 49 инструментов.
Вы назвали принцип: CLI и MCP — зеркало. Здесь зеркало разбито; вопрос, как его чинить.
Варианты
А. Зеркалить буквально: all=true у инструмента.
tracker_issues_search(query="Queue: DE", all=true) → 752 задачи одним ответом
Б. Страницы: инструмент отдаёт порцию и говорит, как взять следующую.
tracker_issues_search(query="Queue: DE", limit=100)
→ 100 задач + «показано 100 из 752; дальше: offset=100»
tracker_issues_search(query="Queue: DE", limit=100, offset=100)
Зеркально у CLI появляется --offset (сейчас есть только --limit и --all).
В. Оставить потолок, только сказать об обрыве (идея 16) и посоветовать сузить запрос.
Сравнение
А. all=true
Б. Страницы
В. Только сообщение
Агент может получить всё
да
да
нет
Ответ помещается в контекст модели
нет: 752 задачи — сотни тысяч знаков, клиент обрежет сам и молча
да
да
CLI и MCP — зеркало
да
да, если --offset добавить в CLI
нет
Работает у сервисов без номера страницы (курсоры, прокрутка)
да
нужен общий «токен продолжения» вместо offset
—
Работа
S
M: одно место в ядре (обход страниц уже там)
S
Рекомендация: Б, с одной поправкой к примеру: не offset, а непрозрачный токен продолжения (next="…"), потому что у сервисов страницы устроены по-разному (номер страницы, курсор, прокрутка в Трекере), а агенту это знать незачем. Ядро уже умеет все три способа; токен — это «с какого места продолжить», выданный ядром.
→ 100 задач + next="eyJwYWdlIjoyfQ"
tracker_issues_search(query="Queue: DE", next="eyJwYWdlIjoyfQ")
То же в CLI (--next) и в SDK (.next у результата рядом с .truncated из идеи 36) — одна вещь на трёх поверхностях.
Заодно: ещё две находки того же прогона
14 операций без инструмента MCP — все про файлы: скачать и загрузить вложение, выгрузить ответы формы. Через MCP файл не передать «как есть»; это идея 25 («ссылкой на ресурс»), вы сказали «потом да». Оставляю как есть, но в таблице покрытия у них появится честная пометка «только CLI и SDK: файл».
У 8 операций метод SDK принимает больше аргументов, чем инструмент (expand, fields, page и подобные). Это просто дефекты зеркала; E5 чинит их и проверку ARCH-1, которая их пропустила. Решения не требуется.
я правильно понял что в CLI сейчас доступно либо прочитать 1 страницу либо прочитать все сразу, но пагинация не доступна?
в SDK доступно все, можно и все прочитать и пагинироваться по ресурсу?
в MCP отдается просто первая страница и все, нету ни пагинации ни отдать все сразу?
ну ты же понимаешь что это странно и не зеркально работает? почему так? мне кажется нам нужно сделать везде зеркальный функционал, разве нет? как делают другие проекты?
Сначала поправка к моему же описанию выше: я написала, что у MCP «500, и дочитать нечем». Это неточно — проверила по коду (settings.py, HTTPConfig.cap): заданный limit побеждает потолок, то есть агент может попросить limit=1000 и получить все 752. Чего у MCP нет — это «отдай всё» и «продолжи с места, где остановился». Ниже точная картина.
Как сейчас (проверено по коду и справке команд)
Ни одна поверхность не отдаёт «одну страницу»: все три сами ходят по страницам сервиса, пока не наберут нужное число.
Первые N
Всё
Продолжить с места остановки
Если ничего не сказать
CLI
--limit N
--all
нет
500
SDK
limit=N
limit=None
нет у методов клиента (лениво перебирать умеет только сессия ядра)
всё
MCP
limit=N, любое N
нет
нет
500
Ответы на ваши три вопроса:
CLI: не «одна страница или всё», а «первые N (по умолчанию 500) или всё». Взять следующую порцию после первых N — нельзя.
SDK: можно всё и можно первые N; продолжить с N-го — тоже нельзя, только начать заново с большим limit.
MCP: первые N, по умолчанию 500; N можно поднять, но слова «всё» нет, продолжения нет, и о том, что список оборван, агент не узнаёт.
Да, это не зеркально, причём в трёх местах сразу: разное умолчание (SDK — всё, остальные — 500), «всё» есть не везде, «продолжить» нет нигде. Почему так вышло: каждая поверхность получила своё решение в своё время, а общее знание («где остановились») из ядра наружу не выходит.
Как у других
Проект
Первые N
Всё
Продолжить
Зеркально между CLI и SDK
AWS CLI и boto3
--max-items N / PaginationConfig={"MaxItems": N}
по умолчанию
--starting-token T / "StartingToken": T; токен печатается в ответе как NextToken
да, одно и то же понятие и те же слова
Stripe API и SDK
limit
auto_paging_iter() в SDK
starting_after=<id последнего>
да
gh
--limit N (по умолчанию 30)
gh api --paginate
нет в командах высокого уровня
частично
Спецификация MCP (свои списки инструментов и ресурсов)
—
—
непрозрачный cursor в запросе, nextCursor в ответе
—
Самый близкий к вашему принципу образец — AWS: три ручки, одинаковые на CLI и SDK, а «продолжить» — непрозрачный токен, который выдаёт сам инструмент. (Про AWS и Stripe — по страницам документации, которые читал разведчик; gh --limit 30 — по памяти, не перепроверяла.)
Предложение: три ручки, одинаковые везде
Ручка
CLI
SDK
MCP
сколько
--limit N
limit=N
limit=N
всё
--all
limit=None
all=true
продолжить
--next ТОКЕН
next="ТОКЕН"
next="ТОКЕН"
что вернулось сверх списка
строка в stderr: «показано 500, есть ещё: --next eyJ… или --all»
result.truncated, result.next
приписка в ответе с тем же токеном
Токен непрозрачный, его выдаёт ядро: внутри «с какого места продолжить» в том виде, в каком это понимает сервис (номер страницы, курсор, прокрутка Трекера). Это одно изменение в ядре, в обходе страниц; ресурсы не правятся.
$ ycli tracker issues search --query 'Queue: DE' --limit 100
… 100 задач …
показано 100, есть ещё: --next eyJwIjoyfQ (или --all)
$ ycli tracker issues search --query 'Queue: DE' --limit 100 --next eyJwIjoyfQ
Два места, где нужно ваше слово
1. Умолчание. Сейчас SDK без limit отдаёт всё, CLI и MCP — 500.
А. Везде 500
Б. Оставить: SDK — всё, CLI и MCP — 500
Зеркало
да
нет
Ломает тех, кто пишет tracker.issues.search(body) и ждёт всё
да: получат 500 и truncated=True
нет
Привычно для SDK (boto3, Stripe отдают всё лениво)
нет
да
Рекомендую Б, но честно названное: у SDK «всё» — это ленивый перебор (принятая идея 29), он не грузит память, поэтому умолчание «всё» там безопасно; у CLI и MCP результат печатается целиком, поэтому потолок. Это одно объяснимое различие, а не случайность. Если зеркало важнее — А.
2. all=true в MCP. 752 задачи одним ответом — сотни тысяч знаков; клиент обрежет ответ сам. С зеркалом это честно («ручка есть везде»), а описание инструмента скажет: «большой список бери порциями через next». Рекомендую добавить, раз есть next.
Ответ: «умолчание — А / Б; all в MCP — да / нет». Если да на всё — это вариант Б из шапки issue, только шире: три ручки на трёх поверхностях.
1 - да, согласен с тобой на вариант Б, покажи потом инлайн примеры псевдокода в сессии как будет это вызываться через разные интерфейсы (Endpoints / SDK / CLI / MCP)
2 - да, согласен с тобой во всем
Три ручки, одинаковые на всех поверхностях: сколько (limit), всё (--all / limit=None / all=true), продолжить (next — непрозрачный токен, который выдаёт ядро).
Умолчание — Б: SDK без limit отдаёт всё ленивым перебором; CLI и MCP — 500. Это одно объяснимое различие: SDK не печатает результат целиком.
all=true в MCP — да; описание инструмента советует брать большой список порциями через next.
Об обрыве сообщают все три: result.truncated / result.next в SDK, строка в stderr у CLI, приписка с токеном у MCP.
Одно изменение в ядре, в обходе страниц; ресурсы не правятся.
Поправка к «у 8 операций метод SDK шире инструмента» (E5 перемерила по всем 467 операциям). Формулировка была неверной: это не разрыв между CLI и MCP. Команда и инструмент передают все параметры метода у 447 операций; у 14 инструмента нет вовсе (файлы); у 6 параметр метода не передаёт ни команда, ни инструмент — то есть CLI и MCP зеркальны везде, а SDK в шести местах шире обеих. Из «восьми» две не разрыв вовсе. Пять операций получают аргумент на обеих поверхностях (PR #511: tracker entities comments list|get --expand, links list --fields, wiki pages descendants-list|-by-id --actuality); шестая, tracker.entities.search (page, per_page), ждёт единой пагинации из этого решения. Проверка, которая это пропускала, сравнивала только набор операций, а аргументы — нет; теперь сравнивает.
Уточнение решением в #538 (6 — Б, 2026-10-08): в CLI -o json и -o yaml печатают тот же объект {items, truncated, next, total}, что отдают MCP и SDK, а не массив; табличные форматы печатают строки, обрыв — строкой в stderr, как и было.
Построено и лежит в main: три ручки на всех списках, обрыв и объект {items, truncated, next, total} — #534; лимит по умолчанию для MCP 50 — #566; токен второй версии — #567. Закрываю.
Activity
bim-ba commentedon Oct 7, 2026
корнер-кейсы:
ну ты же понимаешь что это странно и не зеркально работает? почему так? мне кажется нам нужно сделать везде зеркальный функционал, разве нет? как делают другие проекты?
bim-ba commentedon Oct 7, 2026
Сначала поправка к моему же описанию выше: я написала, что у MCP «500, и дочитать нечем». Это неточно — проверила по коду (
settings.py,HTTPConfig.cap): заданныйlimitпобеждает потолок, то есть агент может попроситьlimit=1000и получить все 752. Чего у MCP нет — это «отдай всё» и «продолжи с места, где остановился». Ниже точная картина.Как сейчас (проверено по коду и справке команд)
Ни одна поверхность не отдаёт «одну страницу»: все три сами ходят по страницам сервиса, пока не наберут нужное число.
--limit N--alllimit=Nlimit=Nonelimit=N, любое NОтветы на ваши три вопроса:
limit.Да, это не зеркально, причём в трёх местах сразу: разное умолчание (SDK — всё, остальные — 500), «всё» есть не везде, «продолжить» нет нигде. Почему так вышло: каждая поверхность получила своё решение в своё время, а общее знание («где остановились») из ядра наружу не выходит.
Как у других
--max-items N/PaginationConfig={"MaxItems": N}--starting-token T/"StartingToken": T; токен печатается в ответе какNextTokenlimitauto_paging_iter()в SDKstarting_after=<id последнего>--limit N(по умолчанию 30)gh api --paginatecursorв запросе,nextCursorв ответеСамый близкий к вашему принципу образец — AWS: три ручки, одинаковые на CLI и SDK, а «продолжить» — непрозрачный токен, который выдаёт сам инструмент. (Про AWS и Stripe — по страницам документации, которые читал разведчик;
gh --limit 30— по памяти, не перепроверяла.)Предложение: три ручки, одинаковые везде
--limit Nlimit=Nlimit=N--alllimit=Noneall=true--next ТОКЕНnext="ТОКЕН"next="ТОКЕН"--next eyJ…или--all»result.truncated,result.nextТокен непрозрачный, его выдаёт ядро: внутри «с какого места продолжить» в том виде, в каком это понимает сервис (номер страницы, курсор, прокрутка Трекера). Это одно изменение в ядре, в обходе страниц; ресурсы не правятся.
Два места, где нужно ваше слово
1. Умолчание. Сейчас SDK без
limitотдаёт всё, CLI и MCP — 500.tracker.issues.search(body)и ждёт всёtruncated=TrueРекомендую Б, но честно названное: у SDK «всё» — это ленивый перебор (принятая идея 29), он не грузит память, поэтому умолчание «всё» там безопасно; у CLI и MCP результат печатается целиком, поэтому потолок. Это одно объяснимое различие, а не случайность. Если зеркало важнее — А.
2.
all=trueв MCP. 752 задачи одним ответом — сотни тысяч знаков; клиент обрежет ответ сам. С зеркалом это честно («ручка есть везде»), а описание инструмента скажет: «большой список бери порциями черезnext». Рекомендую добавить, раз естьnext.Ответ: «умолчание — А / Б;
allв MCP — да / нет». Если да на всё — это вариант Б из шапки issue, только шире: три ручки на трёх поверхностях.bim-ba commentedon Oct 7, 2026
1 - да, согласен с тобой на вариант Б, покажи потом инлайн примеры псевдокода в сессии как будет это вызываться через разные интерфейсы (Endpoints / SDK / CLI / MCP)
2 - да, согласен с тобой во всем
bim-ba commentedon Oct 7, 2026
Решено (владелец, 2026-10-07)
Три ручки, одинаковые на всех поверхностях: сколько (
limit), всё (--all/limit=None/all=true), продолжить (next— непрозрачный токен, который выдаёт ядро).limitотдаёт всё ленивым перебором; CLI и MCP — 500. Это одно объяснимое различие: SDK не печатает результат целиком.all=trueв MCP — да; описание инструмента советует брать большой список порциями черезnext.result.truncated/result.nextв SDK, строка в stderr у CLI, приписка с токеном у MCP.Одно изменение в ядре, в обходе страниц; ресурсы не правятся.
bim-ba commentedon Oct 7, 2026
Поправка к «у 8 операций метод SDK шире инструмента» (E5 перемерила по всем 467 операциям). Формулировка была неверной: это не разрыв между CLI и MCP. Команда и инструмент передают все параметры метода у 447 операций; у 14 инструмента нет вовсе (файлы); у 6 параметр метода не передаёт ни команда, ни инструмент — то есть CLI и MCP зеркальны везде, а SDK в шести местах шире обеих. Из «восьми» две не разрыв вовсе. Пять операций получают аргумент на обеих поверхностях (PR #511:
tracker entities comments list|get --expand,links list --fields,wiki pages descendants-list|-by-id --actuality); шестая,tracker.entities.search(page,per_page), ждёт единой пагинации из этого решения. Проверка, которая это пропускала, сравнивала только набор операций, а аргументы — нет; теперь сравнивает.feat!: every listing takes `limit`, everything and `next` on the SDK,…
feat!: every listing takes `limit`, everything and `next` on the SDK,…
feat!: every listing takes `limit`, everything and `next` on the SDK,…
feat!: every listing takes `limit`, everything and `next` on the SDK,…
bim-ba commentedon Oct 8, 2026
Уточнение решением в #538 (6 — Б, 2026-10-08): в CLI
-o jsonи-o yamlпечатают тот же объект{items, truncated, next, total}, что отдают MCP и SDK, а не массив; табличные форматы печатают строки, обрыв — строкой в stderr, как и было.feat!: every listing takes `limit`, everything and `next` on the SDK,…
feat!: every listing takes `limit`, everything and `next` on the SDK,…
feat!: every listing takes `limit`, everything and `next` on the SDK,…
feat(mcp)!: a listing tool gives 50 items when no `limit` is asked (#566
bim-ba commentedon Oct 10, 2026
Построено и лежит в main: три ручки на всех списках, обрыв и объект
{items, truncated, next, total}— #534; лимит по умолчанию для MCP 50 — #566; токен второй версии — #567. Закрываю.