Streaming events

​

Streaming events

SessionEvent page explains Laravel-specific helpers for the SessionEvent class itself. This page is a type-and-payload reference for each event.

​

Overview

• Ephemeral event: Real-time only. Not persisted in session logs.
• Persisted event: Stored in session logs and replayed when resuming.
• Delta event: Fragment event (deltaContent, etc.) that you stitch into full content.
• parentId chain: Each event links to its previous event.

​

Event envelope (common fields)

​

Laravel subscription example

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Enums\SessionEventType;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\SessionEvent;

Copilot::start(function (CopilotSession $session): void {
    // All events
    $session->on(function (SessionEvent $event): void {
        info($event->type(), $event->toArray());
    });

    // Specific event type
    $session->on(SessionEventType::ASSISTANT_MESSAGE_DELTA, function (SessionEvent $event): void {
        echo $event->deltaContent();
    });

    $session->sendAndWait(prompt: 'Explain key Laravel strengths');
}, config: new SessionConfig(streaming: true));

​

Major event categories

​

Assistant events

​

assistant.turn_start

• turnId (required)
• interactionId (optional)

​

assistant.intent (ephemeral)

• intent (required)

​

assistant.reasoning

• reasoningId (required)
• content (required)

​

assistant.reasoning_delta (ephemeral)

• reasoningId (required)
• deltaContent (required)

​

assistant.message

• messageId (required)
• content (required)
• toolRequests (optional)
• reasoningOpaque / reasoningText / encryptedContent (optional)
• phase / outputTokens / interactionId (optional)
• parentToolCallId (optional)

​

assistant.message_delta (ephemeral)

• messageId (required)
• deltaContent (required)
• parentToolCallId (optional)

​

assistant.turn_end

• turnId (required)

​

assistant.usage (ephemeral)

• model (required)
• inputTokens / outputTokens / cost / duration (optional)
• apiCallId / providerCallId (optional)
• quotaSnapshots / copilotUsage (optional)

​

assistant.streaming_delta (ephemeral)

• totalResponseSizeBytes (required)

​

Tool execution events

​

tool.execution_start

• toolCallId (required)
• toolName (required)
• arguments / mcpServerName / mcpToolName / parentToolCallId (optional)

​

tool.execution_partial_result (ephemeral)

• toolCallId (required)
• partialOutput (required)

​

tool.execution_progress (ephemeral)

• toolCallId (required)
• progressMessage (required)

​

tool.execution_complete

• toolCallId (required)
• success (required)
• result (on success)
• error (on failure)
• toolTelemetry / parentToolCallId (optional)

​

tool.user_requested

• toolCallId (required)
• toolName (required)
• arguments (optional)

​

Session lifecycle events

​

session.start

• producer (optional)

​

session.idle (ephemeral)

• backgroundTasks (optional)

​

session.error

• errorType (required)
• message (required)
• stack / statusCode / providerCallId (optional)

​

session.compaction_start

​

session.compaction_complete

• success (required)
• error (optional)
• preCompactionTokens / postCompactionTokens (optional)
• summaryContent / checkpointPath (optional)

​

session.title_changed (ephemeral)

• title (required)

​

session.context_changed

• cwd (required)
• gitRoot / repository / branch (optional)

​

session.info

• infoType (required)
• url (optional, e.g. when infoType is remote)

​

session.remote_steerable_changed

• remoteSteerable (optional)

​

session.usage_info (ephemeral)

• tokenLimit (required)
• currentTokens (required)
• messagesLength (required)

​

session.task_complete

• summary (optional)

​

session.shutdown

• shutdownType (required)
• errorReason (optional)
• totalPremiumRequests / totalApiDurationMs (required)
• codeChanges / modelMetrics (required)

​

Permission and user input events

​

permission.requested (ephemeral)

• requestId (required)
• permissionRequest (required)

• shell
• write
• read
• mcp
• url
• memory
• custom-tool

​

permission.completed (ephemeral)

• requestId (required)
• result.kind (required)

​

user_input.requested (ephemeral)

• requestId (required)
• question (required)
• choices / allowFreeform (optional)

​

user_input.completed (ephemeral)

• requestId (required)

​

elicitation.requested (ephemeral)

• requestId (required)
• message (required)
• requestedSchema (required)

​

elicitation.completed (ephemeral)

• requestId (required)

​

Sub-agent and skill events

​

subagent.started

• toolCallId (required)
• agentName / agentDisplayName / agentDescription (required)

​

subagent.completed

• toolCallId (required)
• agentName / agentDisplayName (required)

​

subagent.failed

• toolCallId (required)
• agentName / agentDisplayName (required)
• error (required)

​

subagent.selected

• agentName (required)
• agentDisplayName (required)
• tools (required, can be null)

​

subagent.deselected

​

skill.invoked

• name / path / content (required)
• allowedTools / pluginName / pluginVersion (optional)

​

Other events

​

abort

• reason (required)

​

user.message

• content (required)
• transformedContent / attachments / source / agentMode / interactionId (optional)

​

system.message

• content (required)
• role (required)
• name / metadata (optional)

​

external_tool.requested (ephemeral)

• requestId / sessionId / toolCallId / toolName (required)
• arguments (optional)

​

external_tool.completed (ephemeral)

• requestId (required)

​

exit_plan_mode.requested (ephemeral)

• requestId / summary / planContent / actions / recommendedAction (required)

​

exit_plan_mode.completed (ephemeral)

• requestId (required)

​

command.queued (ephemeral)

• requestId (required)
• command (required)

​

command.completed (ephemeral)

• requestId (required)

​

Typical event order

assistant.turn_start
├── assistant.intent (ephemeral)
├── assistant.reasoning_delta (ephemeral, repeated)
├── assistant.reasoning
├── assistant.message_delta (ephemeral, repeated)
├── assistant.message
├── assistant.usage (ephemeral)
├── [permission / tool.* loops if needed]
assistant.turn_end
session.idle (ephemeral)

​

Quick reference of all events

​

Related docs

• Official streaming events reference
• Laravel event class details: SessionEvent
• Streaming implementation patterns: Streaming