जीवनचक्र हुक

Product UI update करने, audit records लिखने या agent activity को मौजूदा telemetry से जोड़ने के लिए onEvent का उपयोग करें।

रन की घटनाएँ सुनें

const result = await agent.run({
  input,
  client,
  onEvent(event) {
    console.log(event.type, event.runId);
  },
});

Event handlers छोटे रखें। धीमे network या storage काम को run में देरी नहीं करनी चाहिए, तो उसे अपने app की queue में भेजें।

Family	Events
Run	`run.started`, `run.resumed`, `run.waiting_for_human`, `run.cancelled`, `run.completed`, `run.failed`
Step	`step.started`, `step.completed`, `step.failed`, `step.cancelled`
Model	`model.requested`, `model.completed`, `model.failed`
Tool	`tool.started`, `tool.preliminary_result`, `tool.completed`, `tool.failed`
State	`checkpoint.saved`

Completed step checkpoint होने के बाद step.completed emit होता है। इससे persistence या telemetry consumer इसे stable boundary मान सकते हैं।

Live answer text के लिए स्ट्रीमिंग के model deltas का उपयोग करें।
Tool-call cards और progress indicators के लिए tool events का उपयोग करें।
Approval या input controls दिखाने के लिए run.waiting_for_human का उपयोग करें।
Loading states बंद करने और outcomes दर्ज करने के लिए terminal run events का उपयोग करें।