AgentEventDetails

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"
  Type d’événement qui sélectionne la charge utile : phase, summary, warning, text, text-delta, result, prompt, tool, tool-result, tool-output, tool-denied, file-change, reasoning, step, hook, instructions-loaded, skills-loaded, model-route, model-request, model-response, model-retry, model-error, stop-prevented, steer, compaction, subagent, conversation, usage, message-usage, quota, fallback, stderr, stopped, failure, finished or raw.
• 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.
• 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 AgentEventDetails =
  | ModelRouteEvent
  | {
      readonly kind: "subagent";
      readonly id: string;
      readonly callId: string;
      readonly name: string;
      readonly status: "started" | "finished" | "failed";
      readonly conversation?: string;
    }
  | {
      readonly kind: "message-usage";
      readonly tokens: Usage;
      readonly messageId?: string;
      readonly parentCallId?: string;
    }
  | {
      readonly kind: "stderr";
      readonly text: string;
      readonly truncated?: boolean;
    }
  | {
      readonly kind: "stopped";
      readonly reason:
        | "completion"
        | "idle-timeout"
        | "deadline"
        | "aborted"
        | "oversized-event"
        | "steered";
    }
  | {
      readonly kind: "steer";
      readonly text: string;
      readonly mode: SteeringMode;
    }
  | {
      readonly kind: "reasoning";
      readonly text: string;
      readonly parentCallId?: string;
    }
  | {
      readonly kind: "file-change";
      readonly changes: unknown;
      readonly callId?: string;
    }
  | {
      readonly kind: "model-request";
      readonly request: unknown;
    }
  | {
      readonly kind: "model-response";
      readonly response: unknown;
    }
  | {
      readonly kind: "model-retry";
      readonly attempt: number;
      readonly message?: string;
    }
  | {
      readonly kind: "model-error";
      readonly message: string;
    }
  | {
      readonly kind: "hook";
      readonly phase: string;
      readonly changed: boolean;
    }
  | {
      readonly kind: "instructions-loaded";
      readonly count: number;
    }
  | {
      readonly kind: "skills-loaded";
      readonly names: readonly string[];
    }
  | {
      readonly kind: "tool-output";
      readonly callId: string;
      readonly channel: "stdout" | "stderr";
      readonly text: string;
    }
  | {
      readonly kind: "phase";
      readonly name: string;
      readonly agent?: string;
      readonly branch?: string;
      readonly directory?: string;
    }
  | {
      readonly kind: "summary";
      readonly durationMs: number;
      readonly status: number;
      readonly tokens: Usage;
    }
  | {
      readonly kind: "warning";
      readonly message: string;
    }
  | {
      readonly kind: "text";
      readonly text: string;
    }
  | {
      readonly kind: "text-delta";
      readonly text: string;
    }
  | {
      readonly kind: "result";
      readonly text: string;
    }
  | {
      readonly kind: "prompt";
      readonly text: string;
    }
  | {
      readonly kind: "tool";
      readonly name: string;
      readonly input: unknown;
      readonly callId?: string;
      readonly parentCallId?: string;
    }
  | {
      readonly kind: "tool-result";
      readonly callId: string;
      readonly name: string;
      readonly isError: boolean;
      readonly preview: string;
      readonly characters: number;
      readonly parentCallId?: string;
    }
  | {
      readonly kind: "step";
      readonly index: number;
    }
  | {
      readonly kind: "tool-denied";
      readonly callId: string;
      readonly name: string;
      readonly reason: string;
    }
  | {
      readonly kind: "stop-prevented";
      readonly message: string;
    }
  | {
      readonly kind: "compaction";
      readonly strategy: string;
      readonly messages: number;
    }
  | {
      readonly kind: "conversation";
      readonly id: string;
    }
  | {
      readonly kind: "usage";
      readonly tokens: Usage;
      readonly cumulative?: boolean;
    }
  | {
      readonly kind: "failure";
      readonly message: string;
    }
  | {
      readonly kind: "quota";
      readonly message: string;
      readonly resetAt?: string;
    }
  | {
      readonly kind: "fallback";
      readonly from: FallbackCandidate;
      readonly to: FallbackCandidate;
      readonly failure: FallbackTrigger;
      readonly message: string;
      readonly resetAt?: string;
    }
  | {
      readonly kind: "finished";
    }
  | {
      readonly kind: "raw";
      readonly value: unknown;
      readonly bytes?: number;
      readonly truncated?: boolean;
    };

Contrats associés

• FallbackCandidate
• FallbackTrigger
• ModelRouteEvent
• SteeringMode
• Usage