ResourceActivityRecord

import type { ResourceActivityRecord } from "@elie-laloum/outpost";

Paramètres et propriétés

versionRequis
1
Version de ce format d’enregistrement sérialisé ; actuellement 1.
idRequis
string
UUID aléatoire de l’enregistrement, stocké sous resources/<id>.json.
pidRequis
number
PID du processus Outpost qui a provisionné la sandbox, et non d’un processus qu’elle exécute.
identityOptionnel
LocalProcessIdentity | undefined
Hôte, démarrage, espace de noms PID et heure de début du processus auteur, pour distinguer un propriétaire vivant d’un PID réutilisé. Absente hors Linux ; la possession est alors unknown.
sandboxProviderRequis
string
Nom du provider qui a alloué la sandbox, comme docker ou vercel.
placementRequis
"mounted" | "remote" | "host"
Accès de la sandbox au workspace : mounted (worktree hôte monté, Docker ou Podman), remote (copie synchronisée avec l’hôte : Vercel, Daytona, Firecracker, conteneurs isolés) ou host (provider local).
workspaceRequis
string
Chemin hôte du worktree sur lequel travaille la sandbox. La rétention de récupération ne supprime jamais un workspace nommé par un enregistrement.
createdAtRequis
string
Horodatage ISO de l’enregistrement de la sandbox, avant son acquisition par le provider.
updatedAtRequis
string
Horodatage ISO du dernier changement de phase ou d’opération.
phaseRequis
"allocating" | "ready" | "closing" | "cleanup-failed" | "allocation-uncertain"
Dernière phase de cycle de vie enregistrée : allocating, ready, closing, cleanup-failed ou allocation-uncertain.
operationsRequis
readonly ResourceOperation[]
Opérations en cours lors de l’écriture de l’enregistrement, une entrée par type avec son nombre d’exécutions simultanées. Vide quand la sandbox est inactive.
lastOperationOptionnel
ResourceOperationResult | undefined
Dernière opération terminée, réussie ou en échec.
lastFailureOptionnel
ResourceOperationResult | undefined
Dernière opération enregistrée en échec, conservée après les succès ultérieurs.

Signature

export interface ResourceActivityRecord {
  readonly version: 1;
  readonly id: string;
  readonly pid: number;
  readonly identity?: LocalProcessIdentity;
  readonly sandboxProvider: string;
  readonly placement: "mounted" | "remote" | "host";
  readonly workspace: string;
  readonly createdAt: string;
  readonly updatedAt: string;
  readonly phase: ResourcePhase;
  readonly operations: readonly ResourceOperation[];
  readonly lastOperation?: ResourceOperationResult;
  readonly lastFailure?: ResourceOperationResult;
}

Paramètres et propriétés

Signature

Contrats associés