Watch a Devin session with the SDK

run() and stream() cover the turn you sent. session.events() covers everything that happens in the session — turns started from the web app, Slack or another process included — as the same typed events, until the connection closes. Attach to sessions you did not start and the cloud pushes each status change the moment it happens:

const session = await devin.attach("devin-…"); // no onPermission: observers don't decide
for await (const event of session.events()) {
  switch (event.type) {
    case "status": // working / blocked / finished, with what the user must do
      console.log(event.status, event.userActionRequired ?? event.message);
      break;
    case "pull_request": // a PR attached to the session changed; refetch
      console.log(event.prUrl);
      break;
    case "plan": // what is left to do
      console.log(event.entries.filter((e) => e.status !== "completed"));
  }
}

Every session exposes two views of its updates. run(), stream() and streamUpdates() are scoped to a turn this client sent. events() and updates() are scoped to the session: every live update for it, whoever started the turn, until the connection closes. Both typed flavours use the same SessionEventReducer, so a SessionEvent means the same thing wherever it came from.

The cloud pushes status transitions live but replays only the latest one, so a client that was offline cannot reconstruct what it missed. Seed from listSessions() (each entry’s _meta carries statusEnum, userActionRequired, pendingRequest, sessionPRs, …) and stay attached for transitions. session.meta holds the latest session snapshot stamped on any update.

Observers should leave onPermission unset: an answer from an observer is a real decision, and the protocol has no “abstain”. See the session-board example for a dashboard built this way.

Get started

Sessions

Integrations

Examples

SDK reference

API client

Resources

Watch a Devin session with the SDK