Stored conversations 

Open and continue a session 

use Netresearch\NrLlm\Domain\ValueObject\AiActorContext;

$actor = AiActorContext::fromBackendUser($backendUser);
$session = $conversations->startSession(
    $actor,
    'Article review',
    $configuration,
);
$reply = $conversations->send(
    $actor,
    $session->uuid,
    'Suggest a shorter introduction.',
);

Resolve $configuration through the guarded resolver shown in Step 5: Select a database configuration. Construct the actor from authenticated server state, never from user-supplied identity or permission fields.

Method contracts 

`startSession(AiActorContext $actor, string $title = '', ?LlmConfiguration $configuration = null): AiSession Binds the session to a configuration. Omitting it resolves and binds the actor's usable default at creation time. Changing the installation's default later does not switch this session. Throws :php:AccessDeniedException for an unauthenticated actor or :php:ConfigurationNotFoundException` when no usable default exists.

`send(AiActorContext $actor, string $sessionUuid, string $userMessage, ?ChatOptions $options = null): CompletionResponse Replays the stored history, sends the new message and stores the user and assistant turns. Throws :php:InvalidArgumentException for an unknown UUID and :php:AccessDeniedException` when the actor lacks access or the bound configuration is no longer usable.

Knowing a session UUID grants no access. Every call checks the actor against the session owner. CLI and queue callers use an explicitly scoped service account rather than assuming user zero or inheriting a global backend user.

Conversations persist message content. Apply the session retention policy and schedule deletion as described in Data retention & purge.