AgentFailedEvent
junjo.hooks.AgentFailedEvent
Kind: Class
SDK version: 0.69.0
Documentation channel: Stable release
Signature
Section titled “Signature”AgentFailedEvent(agent_key: str, store_id: str, error: AgentExecutionError, state: agent_state.AgentStateSnapshot, application_store_id: str | None = None, application_state: BaseState | None = None, *, run_id: str, executable_definition_id: str, name: str, trace_id: str, span_id: str, executable_type: ExecutableType, executable_runtime_id: str, executable_structural_id: str, parent_executable_definition_id: str | None = None, parent_executable_runtime_id: str | None = None, parent_executable_structural_id: str | None = None, parent_executable_type: ExecutableType | None = None)Payload delivered after an admitted Agent execution fails.
Members
Section titled “Members”run_id
Section titled “run_id”run_id: strInvocation identity carried by this lifecycle event; not a Studio evaluation run identifier.
executable_definition_id
Section titled “executable_definition_id”executable_definition_id: strDefinition identity of the executable that emitted this event.
name: strDisplay name of the executable that emitted this event.
trace_id
Section titled “trace_id”trace_id: strActive OpenTelemetry trace identity for linking the callback to execution evidence.
span_id
Section titled “span_id”span_id: strActive OpenTelemetry span identity associated with this lifecycle event.
executable_type
Section titled “executable_type”executable_type: ExecutableTypeKind of executable that emitted this event.
executable_runtime_id
Section titled “executable_runtime_id”executable_runtime_id: strPer-invocation identity of the executable that emitted this event.
executable_structural_id
Section titled “executable_structural_id”executable_structural_id: strCompiled structural identity of the executable that emitted this event.
parent_executable_definition_id
Section titled “parent_executable_definition_id”parent_executable_definition_id: str | None = NoneDefinition identity of the enclosing executable, when one exists.
parent_executable_runtime_id
Section titled “parent_executable_runtime_id”parent_executable_runtime_id: str | None = NoneInvocation identity of the enclosing executable, when one exists.
parent_executable_structural_id
Section titled “parent_executable_structural_id”parent_executable_structural_id: str | None = NoneCompiled structural identity of the enclosing executable, when one exists.
parent_executable_type
Section titled “parent_executable_type”parent_executable_type: ExecutableType | None = NoneKind of the enclosing executable, when one exists.
hook_name
Section titled “hook_name”hook_name: strReturn the public lifecycle hook name for this payload.
This is derived from the concrete event class name so callers can log the event type directly without each payload redefining its own string constant.
agent_key
Section titled “agent_key”agent_key: strApplication-owned stable key of the Agent that emitted this event.
store_id
Section titled “store_id”store_id: strIdentity of the private Agent runtime Store.
error: AgentExecutionErrorExecution exception delivered to this observer; callback failures do not replace the application error.
state: agent_state.AgentStateSnapshotDetached private Agent runtime state at this lifecycle point.
application_store_id
Section titled “application_store_id”application_store_id: str | None = NoneIdentity of the optional live application Store used by this execution.
application_state
Section titled “application_state”application_state: BaseState | None = NoneDetached application-state checkpoint, when available.