iia-arg/dsh-plugins--packages-dsh-subscription-gateway ↗★ 2
dsh-subscription-gateway
Шлюз подписочного агентного SDK для DSH · Subscription agent SDK gateway for DSH
安裝
此插件尚未提供可驗證的 bundle,或相容性檢查未通過。請先閱讀倉庫說明。 閱讀完整 README ↗
說明文件
閱讀完整 README ↗dsh-subscription-gateway — подписочный шлюз агентного движка · Subscription gateway for an agent engine
Codex engine account proof — AP 0.1.10, private candidate
RU: В app-server режиме G дважды вызывает account/read у ТОГО ЖЕ дочернего
процесса: после initialize/initialized, до turn/start, и перед записью
engine_terminal. refreshToken=false, initialize.capabilities.experimentalApi=true.
При равных accountRef пишет auth с proof engine-account-read. AccountRef — полный
SHA256 exact workspaceRouting.chatgptAccountId (64 lowercase hex). В auth входят
только accountRef, производный authEpoch, authMode из account.type и planType плюс proof/общий raw-v1
контекст. account.email, его SHA, исходный ID, токены и весь RPC reply не пишутся.
Разрешён mode chatgpt, PlanType — strict enum из binary schema0.162.1; неизвестное
значение/неверная форма дают именованный SUBSCRIPTION_UNBOUND, не догадку.
Имена wire: positive {kind:"auth",accountRef:"",authEpoch:"",authMode:"chatgpt", planType:" ",proof:"engine-account-read"}; negative {kind:"auth", accountRef:null,authEpoch:null,authMode:null,planType:null,reason:"SUBSCRIPTION_UNBOUND", detail:""}. Полей codex-N/subscription в новом proof нет:
сопоставление accountRef→codex-N и AP validator — отдельная рука Беты. Старый
SDK exec без app-server account API сохраняет прежний route-only отказ.
RU: authEpoch выдаётся при первом успешном account/read: authEpoch = sha256("engine-account-read" ‖ processEpoch ‖ accountRef) (UTF-8, конкатенация без разделителей); стабилен при той же учётке внутри процесса, меняется с процессом/учёткой; при отказе — null.
Склейка однозначна, пока processEpoch — UUID (36 знаков) и accountRef — sha256 hex (64); меняешь источник — добавь разделитель или длину.
Наблюдённый иной ID, включая A→B→A, фиксирует
ACCOUNT_CHANGED_DURING_TURN до конца observer; более ранний именованный отказ,
если он уже был, сохраняет приоритет. Ни один последующий ответ не снимает отказ. account/updated сам по себе
не означает смену: только запускает account/read. В один момент один RPC и один
coalesced hint; hint во время initial не теряется, его чтение завершается до
turn/start. Новые hints во время hint-read объединяются с ним, не порождают
цикл перечитываний из собственного уведомления. Перед terminal приём новых hints
закрывается; уже ожидавший hint завершается перед обязательным final read.
Каждый read ограничен2000мс; initial/final могут дополнительно дождаться одного уже занятого hint. Нет retries/login/logout/config/read. RPC ошибка — ACCOUNT_READ_ERROR, deadline — ACCOUNT_READ_TIMEOUT; неверный ответ — ACCOUNT_READ_SCHEMA_INVALID/ACCOUNT_ID_UNAVAILABLE/ACCOUNT_AUTH_MODE_UNSUPPORTED. Незавершённый ход без точного terminal — ACCOUNT_TERMINAL_UNPROVEN; потерянный обязательный final read — ACCOUNT_READ_FINAL_MISSING. Поздние ответы не дописывают auth после закрытия. Ошибка учёта не отменяет модельный ход; его запуск может дождаться bounded initial proof, terminal G — bounded final proof.
Любой непустой accountRoutingOverride кроме NO_CONSTRAINT отказывает
ACCOUNT_ROUTING_OVERRIDE. Основание исключения: точный upstream rust-v0.162.1,
model-provider/src/workspace_routing.rs:60:
"NO_CONSTRAINT" => None при выборе x-openai-account-routing-override header.
Это отсутствие override HEADER, не обещание отсутствия региональной маршрутизации:
backendOrigin всё ещё применяется, но в G не копируется. Остальные непустые значения
(us/us_cr/неизвестные) остаются UNBOUND; исходный override в G не записывается.
Пустая строка/null допускаются как пустое значение по наряду; отсутствующее поле
или неверный тип — ACCOUNT_READ_SCHEMA_INVALID.
EN: The same spawned Codex app-server is queried after initialization, before turn/start, and again before the G terminal record. Equal SHA256 account IDs produce engine-account-read proof containing only accountRef, derived authEpoch, account.type as authMode, and the strict PlanType enum. No email, email hash, raw ID, token, backend origin or full reply is retained. Observed ID changes are sticky through the turn; an earlier named failure keeps priority. account/updated only requests a fresh read; it is not identity evidence. Reads are coalesced and bounded at2000ms each. Errors/timeouts produce named unbound records; late replies cannot upgrade a closed observer. NO_CONSTRAINT alone is accepted as the documented absence of a routing-override header; other nonempty overrides refuse. This attests engine-reported account state at the observed read points, not billing or identity of an unobserved model request. Beta separately maps accountRef to a subscription slot and updates the AP consumer.
EN: On the first successful account/read, authEpoch = sha256("engine-account-read" ‖ processEpoch ‖ accountRef) (UTF-8 concatenation, no separators); it stays stable for the same account in one process, changes with the process/account, and is null on refusal.
Concatenation is unambiguous while processEpoch is a UUID (36 characters) and accountRef is SHA256 hex (64); if you change either source, add a separator or a length.
G 3.1.8 — writer ротации, только кандидат AP 0.1.10
RU: Старый одиночный gateway-v1.jsonl принимается как active S0, закрывается при append > 8 МиБ или через час от старта; дальше GC через 7 суток от closedAt; .usage-meter из копий не восстанавливать.
EN: A legacy single gateway-v1.jsonl becomes active S0, seals when an append would exceed 8 MiB or one hour after startup, then GC removes it seven days after closedAt; never restore .usage-meter from backups.
G не защищён от намеренной переписи учёткой агента. Печати предназначены для обнаружения случайной порчи. Root-import и parsed/disk cache отсутствуют. Намеренная согласованная перепись bytes/manifest/SHA вне модели угроз.
G is not protected against intentional rewriting by the agent account. Seals address accidental corruption. There is no root import or parsed/disk cache; coordinated rewriting of data and its hashes is outside this threat model.
Потеря G и подмена active · Loss of G and active replacement
Каталог G (.usage-meter) НЕ восстанавливается из копий никогда. Потеря G — потеря учёта за период, а не повод вернуть старое. Восстановление каталога G при ОСТАНОВЛЕННОМ шлюзе, с подменой истории ровно в окне регистрации, не различается; это действие запрещено правилом выше. sourceCreatedAt не является доказательством отсутствия такого восстановления.
Работающий writer сохраняет dev/inode/size и времена своего active. Перед дописыванием смена inode или размера (включая копию с теми же байтами) означает G_ACTIVE_REPLACED. Suspect bytes уходят в segments/ -.replaced 0400; это карантин, не canonical raw и не источник для AP. Writer долговечно пишет вместо утраченного active canonical source_gap с scope=process, reason=G_ACTIVE_REPLACED и replacedFile, закрывает этот gap-сегмент с обычной печатью и открывает следующий пустой active. sourceId/epoch/sourceCreatedAt не меняются. Незавершённый active_gap intent доводится при restart; незавершённый обычный seal не перетирается. При ошибке FS marker может не записаться — отказ остаётся в журнале, полнота не обещается.
Существующий process-scope latch останавливает G всего процесса до restart, модельный HTTP-запрос продолжает выполняться. Restart не лечит старые окна: source_gap/seqhole выбранного полного поколения по-прежнему даёт SOURCE_GAP в groups(); свежий доказанный период проверяется отдельно политикой P1. .replaced удаляется writer вместе со связанным gap-сегментом по его closedAt через 7 суток, не читается как история и учитывается ночным обходом Альфы как дополнительные байты/файл сверх здоровой часовой формулы. На restart заранее восстановленную согласованную историю этот механизм не различает.
The G directory (.usage-meter) must never be restored from backups. Losing G means losing accounting coverage for that period, not permission to restore old history. Restoring G while the gateway is STOPPED, replacing history exactly inside the registration window, cannot be distinguished. That action is prohibited by this rule; sourceCreatedAt does not prove it did not happen.
A running writer remembers active dev/inode/size and timestamps. Before append, changed inode or size, including a byte-identical copied replacement, triggers G_ACTIVE_REPLACED. Suspect bytes move to the0400 .replaced quarantine beside closed segments; readers must never treat it as canonical history. The writer persists a canonical source_gap (scope=process, reason=G_ACTIVE_REPLACED, replacedFile), seals that gap segment and opens the next empty active segment. Source identity and birth are preserved. An active_gap intent supports restart recovery and never replaces a pending ordinary seal. Filesystem failure may prevent the marker itself; a journal message cannot prove complete raw history. The existing process-wide latch disables G until process restart, while model HTTP handling continues. Restart does not repair historical coverage. The AP reader still obtains SOURCE_GAP from groups() for any selected generation with a gap or sequence hole. The writer removes quarantine with its linked gap segment after seven days by closedAt. Alpha's nightly size/count audit includes these extra files beyond the healthy hourly baseline. Restoring consistent history before startup remains outside the live identity check.
Формат для читателя (код AP меняет Бета отдельной дельтой):
/.usage-meter/gateway-v1.jsonl: active regular0600, родитель0700..usage-meter/segments/manifest.json: regular0600, schemaVersion1; sourceId, sourceEpoch, active:{segmentNo,openedAt,origins}, segments:[seal...], deletedMaxObservedAt:null|epoch-ms, retainedFrom. origins: generation→firstSegmentNo..usage-meter/segments/ -.jsonlи.seal.json: regular0400, свой UID/nlink1, каталог0700, no symlink. Номер сегмента монотонен с0 и не seq.- Seal: schemaVersion1, sourceId/sourceEpoch, segmentNo, file, closedAt(epoch-ms), byteLength, sha256(точные bytes сLF), generations:[{generation,firstSeq,finalSeq, finalObservedAt,maxObservedAt,firstSegmentNo}]. Final относится к сегменту, не означает конец поколения; max отдельно нужен для P1 до проверки rewind.
- gateway-v1.jsonl.source.json0400 рядом с active: sourceId/sourceEpoch и sourceCreatedAt (UTC epoch-ms), записанный при первой инициализации. Обычный restart/rotation/GC дату не меняют. UUID служит журналу и согласованию файлов, ручной UUID в профиле AP не требуется. writer.lock0600: постоянный flock FD. Его удалять/подменять при живом writer нельзя. Потерянный manifest при этих метаданных отказывает; это не новый чистый source. intent.json0600 — только незавершённый seal/GC/active_gap; .new временные файлы не являются историей. Два источника в одном нестандартном каталоге API получают отдельные manifest/intent/lock prefixes.
Reader contract (the AP integration is Beta's separate change): active is a 0600 regular file; its parent and segments directory are0700. The0600 manifest carries source identity, active segment number/open time/generation origins, ordered seals, retainedFrom and deletedMaxObservedAt. Each0400 closed JSONL has an identical0400 seal mirrored in the manifest. Per-generation finalSeq and finalObservedAt describe this segment, not end-of-turn; maxObservedAt supports whole-generation P1. All objects must have the gateway UID, one hard link and no symlinks. The0400 source metadata beside active contains sourceCreatedAt (UTC epoch milliseconds), sourceId and sourceEpoch. UUIDs correlate files/logs; there is no manual AP UUID enrollment. Ordinary restart/rotation/GC preserve the birth time. The0600 writer.lock retains flock. Partial loss of segments or manifest refuses instead of silently restarting history. intent.json (seal/GC/active_gap) is recovery state, not an additional raw kind. Temporary .new files are not source records.
Один writer сериализует append/seal/GC. Нужен Linux /usr/bin/flock (util-linux),
он получает inheritedFD3; родитель удерживает тот же open-file-description после
выхода helper. Нет пакетов/демона для этого кода. Второй writer — G_WRITER_BUSY.
Сегмент закрывается перед превышением8МиБ или через1час непустой жизни; idle
таймер тоже зовёт seal. Пустые часы не плодят закрытые файлы. Событие7суток может утратить начало. Нет pins,
вечного conflict-index, quota/PRESSURE. Пороги наблюдения — в настройке стенда
обхода, не здесь. Writer не удаляет сырьё раньше срока ради размера каталога.
Синхронный fsync может зависеть от ФС;32 — предел числа объектов, не обещание
абсолютного5с deadline для системных вызовов.
The writer reclaims segments with closedAt=accept−600с), читает ВСЕ их сегменты отseq1, проверяет SHA/печати и заново разбирает JSON. Кэша нет. cutoff<=deletedMaxObservedAt → RETENTION_GAP. Missing required raw/seal/firstSegmentNo → writer validator G_SEGMENT_MISSING с segmentNo: это вход reader для RETENTION_GAP ДО groups(), не новый raw kind. Порча byte/SHA → G_SEGMENT_CORRUPT; неправильная печать/manifest → G_SEGMENT_INVALID; unsafe mode/link/owner → G_SOURCE_UNSAFE. Raw source_gap/seq-дыра выбранной gen по-прежнему SOURCE_GAP в groups, недоступна вся проекция. ENOSPC может не оставить marker: journal не raw-input; writer-ротация не добавляет health-transport.
The AP reader obtains full active bytes and generation descriptors, applies P1, and reads every segment of each selected generation from seq1. It verifies seals and parses JSON every time. cutoff<=deletedMaxObservedAt is RETENTION_GAP. G_SEGMENT_MISSING with segmentNo identifies missing raw/seal/origin data for reader-side RETENTION_GAP before groups(). G_SEGMENT_CORRUPT identifies byte/hash damage; G_SEGMENT_INVALID identifies bad metadata; G_SOURCE_UNSAFE identifies unsafe ownership/type/mode/link. Raw source_gap or a sequence hole remains SOURCE_GAP in groups(), refusing the whole projection. ENOSPC may prevent a r