AgentObservation

Paramètres et propriétés

Les champs ci-dessous couvrent toutes les variantes ; la signature précise leurs combinaisons autorisées.

• kindRequis
  "model-route" | "subagent" | "message-usage" | "stderr" | "stopped" | "steer" | "reasoning" | "file-change" | "model-request" | "model-response" | "model-retry" | "model-error" | "hook" | "instructions-loaded" | "skills-loaded" | "tool-output" | "phase" | "summary" | "warning" | "text" | "text-delta" | "result" | "prompt" | "tool" | "tool-result" | "step" | "tool-denied" | "stop-prevented" | "compaction" | "conversation" | "usage" | "failure" | "quota" | "fallback" | "finished" | "raw"
  Discriminant sélectionnant les données de l’événement d’agent hérité ; model-route identifie une sélection effective de modèle.
• stepSelon la variante
  number
  Étape du harness pour laquelle ce modèle effectif a été sélectionné.
• choiceSelon la variante
  string
  Clé effective de candidat après application des règles de repli de confiance et disponibilité.
• modelSelon la variante
  AgentModel
  Modèle normalisé sélectionné avec ses propres réglages de raisonnement et de sortie.
• reasonSelon la variante
  "unavailable" | "selected" | "confidence" | "completion" | "idle-timeout" | "deadline" | "aborted" | "oversized-event" | "steered" | string
  Sur tool-denied, le motif du refus. Sur stopped, la raison de l’arrêt du processus : completion, idle-timeout, deadline, aborted, oversized-event ou steered. Sur model-route, selected, confidence ou unavailable explique la sélection effective.
• confidenceSelon la variante
  number | undefined
  Confiance native de décision, présente seulement lorsqu’une réponse choice valide a été reçue.
• subagentIdOptionnel
  string | undefined
  Identifiant de l’enfant intégré qui a émis l’événement ; absent pour le harness racine. Les événements de cycle de vie relient cet identifiant à l’appel d’outil de délégation.
• passRequis
  number
  Numéro de passe, à partir de 1, dans le dispatch ; 1 quand le scope n’en porte pas.
• atRequis
  string
  Horodatage ISO attribué à l’observation d’agent.
• seqOptionnel
  number | undefined
  Numéro de séquence du hub, présent quand l’observation est passée par un hub ; absent sur les observations que vous construisez vous-même.
• sourceOptionnel
  ObservationSource | undefined
  Sous-système producteur lorsque l’observation est passée par un hub.
• scopeOptionnel
  ObservationScope | undefined
  Scope de l’observation dans le hub : identifiants d’exécution de workflow, de tâche, de tentative, de dispatch, de passe, de sous-agent et de candidat connus à l’émission.
• idSelon la variante
  string
  Identifiant de conversation pour les événements conversation, ou identifiant unique d’exécution enfant pour les événements de cycle de vie subagent.
• callIdSelon la variante
  string | string | undefined | string | string | undefined | string | string
  Identifiant d’appel d’outil qui relie les événements tool, tool-result, tool-output, tool-denied, file-change et subagent d’un même appel. Les adapters CLI reprennent l’identifiant natif quand le protocole en fournit un.
• nameSelon la variante
  string
  Nom de la phase pour phase ; nom de l’outil pour tool, tool-result et tool-denied ; nom de l’outil de délégation pour subagent.
• statusSelon la variante
  "started" | "finished" | "failed" | number
  Sur summary, le statut de sortie du dernier tour de la passe, toujours 0 car une sortie non nulle rejette le dispatch. Sur subagent, started, finished ou failed.
• conversationSelon la variante
  string | undefined
  Identifiant de conversation enfant persistée lorsque l’enfant active le stockage des transcripts.
• tokensSelon la variante
  Usage
  Compteurs de tokens : un incrément sur usage, le total de la passe sur summary, l’usage d’un message sur message-usage.
• messageIdSelon la variante
  string | undefined
  Identifiant Claude Code du message dont un événement message-usage rapporte l’usage.
• parentCallIdSelon la variante
  string | undefined
  Appel d’outil parent fourni par la CLI pour un message de sous-agent ou un événement d’outil.
• textSelon la variante
  string
  Texte de l’événement selon kind : texte de l’agent, fragment diffusé, réponse finale, prompt rendu, consigne de steering, raisonnement, ligne de stderr ou morceau de sortie d’outil.
• truncatedSelon la variante
  boolean | undefined
  Indique si le fragment stderr ou l’aperçu brut trop volumineux a été borné avant livraison.
• modeSelon la variante
  SteeringMode
  Manière dont un événement steer a atteint l’agent : injecté dans le tour en cours, ou repris dans un nouveau tour de la même conversation.
• changesSelon la variante
  unknown
  Modifications de fichiers telles que Codex les rapporte, transmises sans modification.
• requestSelon la variante
  unknown
  Requête modèle observée uniquement si le hub active explicitement les contenus détaillés ; peut contenir des instructions et messages privés.
• responseSelon la variante
  unknown
  Réponse modèle observée uniquement lorsque les contenus détaillés sont activés, avec appels d’outils et contenu rejouable.
• attemptSelon la variante
  number
  Tentative de reprise explicitement signalée par un fournisseur modèle ; Outpost ne déduit pas les reprises cachées.
• messageSelon la variante
  string | undefined | string | string | string | string | string | string
  Message d’un événement warning, failure, quota, fallback, model-retry ou model-error, ou message renvoyé au modèle par un hook d’arrêt sur stop-prevented.
• phaseSelon la variante
  string
  Phase du hook de harness qui vient de se terminer.
• changedSelon la variante
  boolean
  Indique si le hook a renvoyé une décision ou modifié son entrée observable.
• countSelon la variante
  number
  Nombre de sources d’instructions non vides résolues pour ce tour de harness.
• namesSelon la variante
  readonly string[]
  Skills nouvellement chargés dans la conversation et disponibles aux étapes modèle suivantes.
• channelSelon la variante
  "stdout" | "stderr"
  Flux de sortie de la commande pour l’événement tool-output : stdout ou stderr.
• agentSelon la variante
  string | undefined
  Nom de l’agent qui exécute la passe, sur les événements phase : claude, codex, antigravity, copilot ou kimi, custom pour un agent du harness intégré, replay pour un agent de rejeu.
• branchSelon la variante
  string | undefined
  Nom de la branche de travail utilisée ou observée pendant l’exécution.
• directorySelon la variante
  string | undefined
  Dossier hôte du workspace utilisé pour cette exécution.
• durationMsSelon la variante
  number
  Durée de la passe en millisecondes, cumulée sur ses tours, sur les événements summary.
• inputSelon la variante
  unknown
  Arguments bruts fournis à l’outil nommé par cet événement tool.
• isErrorSelon la variante
  boolean
  Indique si l’appel d’outil a échoué ou signalé une erreur.
• previewSelon la variante
  string
  Les 2000 premiers caractères du résultat de l’outil.
• charactersSelon la variante
  number
  Longueur complète du résultat de l’outil avant toute troncature.
• indexSelon la variante
  number
  Numéro d’étape, à partir de 1, dans un tour du harness intégré.
• strategySelon la variante
  string
  Nom de la stratégie de contexte qui a réécrit l’historique.
• messagesSelon la variante
  number
  Nombre de messages de l’historique après compaction.
• cumulativeSelon la variante
  boolean | undefined
  true quand un adapter rapporte un total courant de la session native au lieu d’un incrément. Outpost soustrait la base de la session et l’usage déjà compté : les observateurs reçoivent toujours des événements usage incrémentaux, sans indicateur cumulative.
• resetAtSelon la variante
  string | undefined
  Horodatage ISO auquel un événement quota ou fallback indique la réinitialisation de la limite d’usage ou de débit ; présent uniquement lorsqu’il est fourni sous forme structurée.
• fromSelon la variante
  FallbackCandidate
  Candidat qui s’est arrêté dans un événement fallback : sa position, le nom de son adapter et le nom de son modèle s’il a été choisi.
• toSelon la variante
  FallbackCandidate
  Candidat qui prend le relais dans un événement fallback : sa position, le nom de son adapter et le nom de son modèle s’il a été choisi.
• failureSelon la variante
  FallbackTrigger
  Catégorie qui a arrêté le candidat précédent dans un événement fallback : quota ou unavailable.
• valueSelon la variante
  unknown
  Ligne brute du protocole telle que l’agent l’a écrite ; pour une ligne trop grande, seulement ses 2000 premiers caractères.
• bytesSelon la variante
  number | undefined
  Taille UTF-8 constatée d’une ligne de protocole trop volumineuse ou du préfixe reçu avant l’arrêt.

Signature

export type AgentObservation = AgentEvent & {
  readonly pass: number;
  readonly at: string;
  readonly seq?: number;
  readonly source?: ObservationSource;
  readonly scope?: ObservationScope;
};

Contrats associés

• AgentEvent