Viv JavaScript Runtime - v0.10.2
    Preparing search index...

    Interface HostApplicationAdapterObservabilityCallbacks

    An object specifying observability callbacks.

    interface HostApplicationAdapterObservabilityCallbacks {
        onActionTargetingEvent?: (event: ActionTargetingEvent) => void;
        onPlanExecutionEvent?: (event: PlanExecutionEvent) => void;
    }
    Index

    Properties

    onActionTargetingEvent?: (event: ActionTargetingEvent) => void

    If supplied, a callback that will be invoked during action targeting to provide real-time observability into the action-selection process.

    The callback receives an ActionTargetingEvent for each action targeting attempt, indicating whether targeting has started, succeeded, or failed. This is useful for monitoring long-running simulations involving many characters and timesteps.

    Important: The runtime does not catch errors thrown by your callback. If the callback throws, the error will propagate through the runtime, in accordance with the broader adapter error contract.

    onPlanExecutionEvent?: (event: PlanExecutionEvent) => void

    If supplied, a callback that will be invoked during plan execution to provide real-time observability into plan lifecycle events.

    The callback receives a PlanExecutionEvent for each significant plan-execution event, including launch, phase advancement, blocking (on waits or reaction windows), and termination (success or failure).

    Important: The runtime does not catch errors thrown by your callback. If the callback throws, the error will propagate through the runtime, in accordance with the broader adapter error contract.