Summary

Add a session:end internal hook event that fires when a session completes.

Use Case

Integrating OpenClaw with workflow orchestration systems like Temporal. When an agent session completes, we want to signal back to a waiting workflow so it can proceed to the next step.

Current workaround requires agents to explicitly run a CLI command at the end of their task, which is fragile and adds cognitive load to agent instructions.

Proposed Behavior

// Hook event structure
{
  type: 'session',
  action: 'end',
  sessionKey: string,
  sessionId: string,
  timestamp: Date,
  context: {
    stopReason: 'stop' | 'toolUse' | 'maxTokens' | 'error',
    lastMessage?: string,
    metadata?: Record<string, any>  // Custom data passed when session started
  }
}

Example Hook

const handler: HookHandler = async (event) => {
  if (event.type !== 'session' || event.action !== 'end') return;
  
  const workflowId = event.context.metadata?.workflowId;
  if (workflowId) {
    // Signal Temporal workflow
    await exec(`temporal workflow signal --workflow-id ${workflowId} --name complete`);
  }
};

Notes

The docs mention session:end as a planned future event. This issue tracks that feature request.

Related: session:start would also be useful for the same integration patterns.