ObservationEvent

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" | "workspace-commits" | "workspace-commits" | "decision" | "decision-request" | "decision-response" | "operation" | "dispatch-start" | "workflow" | "dispatch-finished" | "command-output" | "candidate" | "queue"
  Discriminant sélectionnant les données observées : événements d’agent et de harness, résumés et données verbose de décision, workflows, opérations, dispatches, commits de workspace, commandes, candidats ou files.
• 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 | string
  Sur model-route, le modèle AgentModel effectif et ses réglages. Sur decision, le modèle nommé du service de décision, avec le modèle réellement renvoyé en cas de succès.
• 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.
• subagentIdSelon la variante
  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.
• idSelon la variante
  string
  Identifiant d’opération, de conversation, de sous-agent ou de job en file, selon kind.
• 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 d’opération, de phase, d’outil ou d’outil de délégation, selon kind.
• statusSelon la variante
  "started" | "finished" | "failed" | number | "started" | "finished" | "failed" | "started" | "finished" | "failed" | "failed" | "done" | "cancelled" | "validated" | "accepted" | "rejected" | "cleanup" | "failed" | "enqueued" | "polled" | "completed"
  État d’opération, résultat de dispatch, sélection du candidat ou transition de queue selon kind ; les résumés d’agent conservent le statut de sortie numérique.
• 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
  Sur decision, troncature d’entrée signalée ; son absence ne prouve pas une entrée complète. Sur stderr ou raw, fragment textuel ou aperçu borné.
• 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 complète de modèle ou de décision, émise seulement pour une observation verbose ; les requêtes de décision contiennent l’état et les questions déclarées.
• responseSelon la variante
  unknown
  Réponse complète de modèle ou résultat normalisé de décision, émis seulement pour une observation verbose ; les résultats de décision conservent les métadonnées natives.
• 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 stdout ou stderr des sorties de commandes de tâche et d’outil.
• 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 | number | undefined | number | undefined
  Millisecondes écoulées pour la décision, l’opération, la tâche de workflow, le candidat ou le dispatch indiqué par kind ; les résumés d’agent agrègent tous les tours du passage.
• 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.
• baselineSelon la variante
  RecordedRevision | RecordedRevision | undefined
  Commit et arbre de départ du dispatch en sandbox, pour workspace-commits.
• commitsSelon la variante
  readonly RecordedCommit[] | readonly Commit[] | undefined
  Commits du dispatch sur dispatch-finished : issus du résultat en cas de succès, du recovery de l’erreur en cas d’échec.
• unavailableSelon la variante
  string
  Raison pour laquelle les commits du workspace n’ont pas pu être enregistrés pour le rejeu, pour workspace-commits.
• providerSelon la variante
  string
  Nom du provider de décision ; aucun identifiant secret n’est inclus.
• usageSelon la variante
  Usage | undefined | Usage
  Usage cumulé du dispatch, incluant l’usage observé avant un échec. Les événements de décision incluent l’usage normalisé du routeur lorsqu’il est disponible.
• codeSelon la variante
  string | undefined
  Code d’erreur Outpost lors d’une évaluation en échec, lorsque l’erreur en possède un.
• eventSelon la variante
  WorkflowEvent
  Événement de cycle de vie original du workflow lorsque kind vaut workflow.
• completedSelon la variante
  boolean
  Indique si le dispatch a satisfait son marqueur de complétion ou son contrat de réponse structurée.
• errorSelon la variante
  { readonly code?: string; readonly message: string; } | undefined
  Code et message de l’erreur qui a fait échouer ou annulé le dispatch, pour dispatch-finished.

Signature

export type ObservationEvent =
  | DecisionEvent
  | {
      readonly kind: "decision-request";
      readonly request: unknown;
    }
  | {
      readonly kind: "decision-response";
      readonly response: unknown;
    }
  | AgentEvent
  | OperationEvent
  | {
      readonly kind: "dispatch-start";
    }
  | {
      readonly kind: "workflow";
      readonly event: WorkflowEvent;
    }
  | {
      readonly kind: "dispatch-finished";
      readonly status: "done" | "failed" | "cancelled";
      readonly completed: boolean;
      readonly branch?: string;
      readonly commits?: readonly Commit[];
      readonly usage: Usage;
      readonly error?: {
        readonly code?: string;
        readonly message: string;
      };
    }
  | WorkspaceCommitsEvent
  | {
      readonly kind: "command-output";
      readonly channel: "stdout" | "stderr";
      readonly text: string;
    }
  | {
      readonly kind: "candidate";
      readonly status: "validated" | "accepted" | "rejected" | "cleanup";
    }
  | {
      readonly kind: "queue";
      readonly id: string;
      readonly status: "enqueued" | "polled" | "completed" | "failed";
    };

Contrats associés

• AgentEvent
• DecisionEvent
• OperationEvent
• WorkflowEvent
• WorkspaceCommitsEvent