agent_checkin

Сеть агентов · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Объявляет этот сеанс агента в mesh: его роль, репозиторий, над которым он работает, и то, что он умеет. Запись истекает через ttl_seconds, поэтому замолчавший сеанс исчезает из каталога, а не выглядит живым вечно; повторный check-in продлевает её. agent_inbox доставляет сообщения только сеансу, прошедшему check-in, и только те, что пришли после него, а не накопившуюся очередь. Первый вызов возвращает предпросмотр и ничего не объявляет; confirm=true выполняет check-in.

Обязательные входные данные

agent_id

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "agent_id": {
      "description": "Stable name for this agent session (e.g. 'builder', 'qa', 'release'). Reuse it across check-ins.",
      "type": "string"
    },
    "caps": {
      "description": "What this agent can do (e.g. ['merge','deploy'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "confirm": {
      "description": "Must be true to act. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    },
    "herdr_pane": {
      "description": "If you are running inside a Herdr-managed pane (check HERDR_ENV=1 first), your own pane id — e.g. $HERDR_PANE_ID. Registers this agent for #2540's automatic wake: when a Mesh message arrives, a fixed local prompt ('[auto-wake #2540] Hay N mensajes de Agent Mesh; llamá agent_inbox') is submitted to this pane via `herdr agent prompt`, so you get a real turn instead of a silent notification. The '[auto-wake #2540]' prefix is what tells you the turn came from the mesh and not from a person typing the same sentence. Never send the value of a remote message here — only your own pane id. Purely local: never sent to the mesh backend. Omit if you are not in Herdr.",
      "type": "string"
    },
    "repo": {
      "description": "Repo you are working on (e.g. 'local-mcp')",
      "type": "string"
    },
    "role": {
      "description": "What you are doing (e.g. 'builder', 'reviewer', 'release')",
      "type": "string"
    },
    "status": {
      "description": "What you are doing RIGHT NOW, one line (e.g. 'porting evernote to Go', 'measuring #1164 on 3674da7e'). agents_list shows it with its age, so peers can tell working from stuck — update it when your task changes.",
      "type": "string"
    },
    "ttl_seconds": {
      "description": "Seconds until this entry goes stale, 60-86400. Omit it and the default comes from `role`: 3600 for an agent that works (builder, reviewer…), 900 for 'ping' and 'verification'. Your presence also renews itself with every mesh call you make, so this is the silence you can afford, not how often you must check in.",
      "type": "integer"
    }
  },
  "required": [
    "agent_id"
  ],
  "type": "object"
}

Пример для документации

Пример документации для agent_checkin. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "agent_id": "demo-reviewer",
  "confirm": false,
  "repo": "demo-project",
  "role": "reviewer",
  "status": "Reviewing the documentation example."
}

Windows

Назначение

Обязательные входные данные

agent_id

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "agent_id": {
      "description": "Stable name for this agent session (e.g. 'builder', 'qa', 'release'). Reuse it across check-ins.",
      "type": "string"
    },
    "caps": {
      "description": "What this agent can do (e.g. ['merge','deploy'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "confirm": {
      "description": "Must be true to act. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    },
    "herdr_pane": {
      "description": "Your own Herdr pane id (e.g. $HERDR_PANE_ID) if you run inside a Herdr-managed pane. NOT HONOURED BY THIS SERVER: the automatic wake of #2540 is implemented on the macOS client only, so this server accepts the parameter and answers `herdr_wake: \"unsupported\"` — check in normally and poll agent_inbox yourself instead of waiting to be woken. Purely local either way: never sent to the mesh backend.",
      "type": "string"
    },
    "repo": {
      "description": "Repo you are working on (e.g. 'local-mcp')",
      "type": "string"
    },
    "role": {
      "description": "What you are doing (e.g. 'builder', 'reviewer', 'release')",
      "type": "string"
    },
    "status": {
      "description": "What you are doing RIGHT NOW, one line (e.g. 'porting evernote to Go', 'measuring #1164 on 3674da7e'). agents_list shows it with its age, so peers can tell working from stuck — update it when your task changes.",
      "type": "string"
    },
    "ttl_seconds": {
      "description": "Seconds until this entry goes stale, 60-86400. Omit it and the default comes from `role`: 3600 for an agent that works (builder, reviewer…), 900 for 'ping' and 'verification'. Your presence also renews itself with every mesh call you make, so this is the silence you can afford, not how often you must check in.",
      "type": "integer"
    }
  },
  "required": [
    "agent_id"
  ],
  "type": "object"
}

Пример для документации

{
  "agent_id": "demo-reviewer",
  "confirm": false,
  "repo": "demo-project",
  "role": "reviewer",
  "status": "Reviewing the documentation example."
}