Function bgAgentStatus

internal/app/harness.go:196–224

bgAgentStatus returns the live background-agent entry for a task's bound session, or nil if the task isn't bg-bound, has no session, the harness can't host background agents, or the session isn't currently running. Used by `flow show` to surface a bg session's status/state/pid via a per-render `clau

(t *flowdb.Task)

// Used by `flow show` to surface a bg session's status/state/pid via a
// per-render `claude agents --json` lookup.
func bgAgentStatus(t *flowdb.Task) *harness.BackgroundAgent {
	if t == nil || !t.SessionID.Valid || t.SessionID.String == "" {
		return nil
	}
	// Only consult the registry in bg mode — see liveSessionsForTasks.
	// Keeps `flow show` free of a `claude agents` subprocess for non-bg
	// users (and avoids surfacing bg state they never opted into).
	if !spawner.IsBackground() {
		return nil
	}
	h, err := harnessForTask(t)
	if err != nil {
		return nil
	}
	bg, ok := h.(harness.BackgroundLauncher)
	if !ok {
		return nil
	}
	agents, err := bg.BackgroundAgents()
	if err != nil {
		return nil
	}
	for i := range agents {
		if strings.EqualFold(agents[i].SessionID, t.SessionID.String) {
			return &agents[i]
		}
	}
	return nil
}