Interface PendingAction

A pending action awaiting human approval.

interface PendingAction {
    actionId: string;
    description: string;
    severity: ActionSeverity;
    category?: "communication" | "data_modification" | "external_api" | "financial" | "system" | "other";
    agentId: string;
    context: Record<string, unknown>;
    potentialConsequences?: string[];
    reversible: boolean;
    estimatedCost?: {
        amount: number;
        currency: string;
    };
    requestedAt: Date;
    timeoutMs?: number;
    alternatives?: AlternativeAction[];
}

Properties

actionId: string

Unique action identifier

description: string

Human-readable description of the action

severity: ActionSeverity

Action severity/risk level

category?: "communication" | "data_modification" | "external_api" | "financial" | "system" | "other"

Category of action

agentId: string

Agent requesting approval

context: Record<string, unknown>

Context/parameters of the action

potentialConsequences?: string[]

Potential consequences if approved

reversible: boolean

Reversibility of the action

estimatedCost?: {
    amount: number;
    currency: string;
}

Estimated cost (if applicable)

Type declaration

  • amount: number
  • currency: string
requestedAt: Date

Timestamp when request was made

timeoutMs?: number

Timeout for approval (ms)

alternatives?: AlternativeAction[]

Alternative actions available