> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lifecycle Command Decision • AI Agent SDK

> LifecycleCommandDecision: Closed decision shape for a self-lifecycle command evaluation.

# LifecycleCommandDecision

> Defined in the [**protocols**](../modules/protocols) module.

<Badge color="blue">AI Agent</Badge>

Closed decision shape for a self-lifecycle command evaluation.

Attributes:
allow: Whether the command may run (`True`) or is refused
(`False`) because it targets this gateway's own lifecycle.
reason: Model-readable explanation, populated on denial so the caller
can surface *why* the command was blocked.
matched: The specific command fragment that triggered the deny (for
logging / the blocked-attempt audit line); empty when allowed.

## Properties

<ResponseField name="allow" type="bool">
  No description available.
</ResponseField>

<ResponseField name="reason" type="str">
  No description available.
</ResponseField>

<ResponseField name="matched" type="str">
  No description available.
</ResponseField>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L4940">
  `praisonaiagents/gateway/protocols.py` at line 4940
</Card>