Перейти к содержанию

Объекты владельца

Команды владельца читают серверные объекты, принадлежащие этой учётной записи, а также точные версии одного объекта. Это операции чтения. Они не публикуют, не предоставляют доступ и не меняют видимость.

Публичный каталог показывает то, что уже открыто. Эта группа показывает то, чем владеете вы, включая приватные версии, данные жизненного цикла и возможность начать публикацию версии.

Локальный черновик от component adopt не является объектом владельца. Он становится таковым, когда публикация сохранит его на сервере. Гранты, которые вы получили, отображаются в Грантах доступа, а не здесь.

Таблица команд

Команда Изменяемость Подтверждение Когда
ai-stp owner objects read none список объектов, принадлежащих аутентифицированной учётной записи
ai-stp owner object show read none чтение одного серверного авторизованного объекта владельца и его точных версий
ai-stp owner version show read none чтение одной точной версии владельца и её серверных данных жизненного цикла

--json — глобальный флаг. Передавайте его всегда. Ни одна из этих команд не принимает --confirm.

Список

ai-stp owner objects --json
ai-stp owner objects --kind component --json
ai-stp owner objects --kind setup --page-size 20 --json
ai-stp owner objects --cursor <cursor> --json

--kind необязателен: component или setup. --cursor — непрозрачный курсор, возвращённый предыдущей страницей. --page-size по умолчанию равен 20.

Поля успеха: items, page. Каждый элемент — это сводка объекта владельца: стабильный id, вид и имя. page содержит следующий курсор, если остались ещё данные. --page-size ограничен; не придумывайте размер страницы вне контракта. Проходите страницы, пока курсор не станет пустым. Первая страница без элементов — это типизированная пустота, а не ошибка.

Показ объекта

ai-stp owner object show --kind component --id <stable_id> --json
ai-stp owner object show --kind setup --id <stable_id> --json

--kind и --id обязательны.

Поля успеха: stable_id, object_kind, name, versions. Каждая сводка версии включает version, visibility (public или private), trust_lane (authoritative или experimental), author_verified, component_verified, content_digest, lifecycle_state, install_eligible, can_start_publication, published_at.

author_verified и component_verified независимы. Подтверждённый автор может владеть неподтверждённой версией. can_start_publication — это разрешение начать план, а не завершённая публикация.

visibility — это public или private для данной версии. Изменение видимости — не эта команда. trust_lane в представлении владельца — это authoritative или experimental. install_eligible — серверный бит для данной версии; локальная пригодность по-прежнему определяется через select eligibility. lifecycle_state — это серверный жизненный цикл, а не локальный журнал установки.

Показ версии

ai-stp owner version show \
  --kind component \
  --id <stable_id> \
  --version 1.0 \
  --json

--kind, --id и --version обязательны. --version — точный X.Y.

Ответ — полная версия владельца плюс серверные данные жизненного цикла: те же координаты, что и в сводке, с данными, которые сервер сохранил для этой точной версии. Используйте перед publication plan. Сравните content_digest с локальным паспортом перед планированием. Расхождение означает, что локальный head сдвинулся; выпустите новый X.Y вместо пере-публикации старого номера.

Не ожидайте, что эта команда вернёт байты артефакта. Получайте опубликованные байты через Реестр registry fetch. Не ожидайте, что она вернёт получателей грантов; это grant list.

Счастливый путь

auth status
→ owner objects --kind component
→ owner object show --kind component --id <id>
→ owner version show --kind component --id <id> --version 1.0
→ publication plan --id <id> --version 1.0

Для графа сетапа — тот же цикл с --kind setup, затем setup publish plan.

После публикации:

owner version show --kind component --id <id> --version <X.Y>
→ visibility public, can_start_publication больше не является следующим шагом
→ registry version --kind component --id <id> --version <X.Y>

Именованные поля успеха

Команда Поля для чтения
objects items, page
object show stable_id, object_kind, name, versions
version show version, content_digest, lifecycle_state, can_start_publication, author_verified, component_verified

Для каждой версии также читайте visibility, trust_lane и install_eligible.

Отказы

Что вы видите Что это означает Что делать
AI_STP_AUTH_REQUIRED нет выполненного входа task start --intent account --idempotency-key account-session-01 --json
AI_STP_PERMISSION_DENIED эта учётная запись не владеет данным объектом вы получатель гранта или читатель каталога; используйте registry show
AI_STP_NOT_FOUND id или версия отсутствуют на сервере owner objects; локальный черновик здесь не отображается
AI_STP_VALIDATION_ERROR отсутствует --kind на show или --version --kind обязателен для object и version show
AI_STP_DEVICE_REVOKED ключ устройства отозван для облачного чтения новое устройство + вход
интерпретация can_start_publication как опубликованного это бит разрешения всё ещё нужно выполнить publication plan, затем confirm
ожидание, что experimental будет скрыт представление владельца включает то, чем вы владеете дорожки публичного каталога — это другая поверхность

Локальные черновики от component adopt не являются объектами владельца, пока они не будут опубликованы или иным образом сохранены на сервере. owner objects на новой учётной записи — это типизированная пустота.

Связанные ссылки

Флаги берутся из continuation argv

ai-stp task intents --json

Не дампьте help --agent как прелюдию. Флаги текущей задачи — в continuation argv.

Эта страница группирует команды владельца для удобства поиска. Установленный CLI является источником флагов, схем и next_actions. Если эта страница и CLI расходятся, следуйте CLI.