Add isolate event handler setup in order to be able to propagate isolate

include/dart_debugger_api.h

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef INCLUDE_DART_DEBUGGER_API_H_
 #define INCLUDE_DART_DEBUGGER_API_H_
 
 #include "include/dart_api.h"
 
 typedef struct _Dart_Breakpoint* Dart_Breakpoint;
 
 typedef struct _Dart_StackTrace* Dart_StackTrace;
 
 typedef struct _Dart_ActivationFrame* Dart_ActivationFrame;
 
 typedef void Dart_BreakpointHandler(
                  Dart_Breakpoint breakpoint,
                  Dart_StackTrace stack_trace);
 
 typedef void Dart_BreakpointResolvedHandler(
                  intptr_t bp_id,
                  Dart_Handle url,
                  intptr_t line_number);
 
 typedef void Dart_ExceptionThrownHandler(
                  Dart_Handle exception_object,
                  Dart_StackTrace stack_trace);
 
+typedef enum {
+  kCreated = 0,
+  kInterrupted,
+  kShutdown,
+} Dart_IsolateEvent;
+
+typedef void Dart_IsolateEventHandler(Dart_Isolate isolate,
+                                      Dart_IsolateEvent kind);
 
 /**
  * Caches a given \object and returns an object id. The object id is only
  * valid while the VM is paused. The cache is invalidated when the VM
  * resumes.
  *
  * Requires there to be a current isolate.
  *
  * Returns an id >= 0 on success, or -1 if there is an error.
  */
@@ skipping 241 matching lines @@
 
 /**
  * Installs a callback function that gets called by the VM when
  * an exception has been thrown.
  *
  * Requires there to be a current isolate.
  */
 DART_EXPORT void Dart_SetExceptionThrownHandler(
                             Dart_ExceptionThrownHandler handler);
 
+/**
+ * Installs a callback function that gets called by the VM when
+ * an isolate event happens, e.g:
+ *   - creation of a new isolate
+ *   - shutdown of an isolate
+ *   - interruption of an isolate
+ */
+DART_EXPORT void Dart_SetIsolateEventHandler(Dart_IsolateEventHandler handler);
 
 // On which exceptions to pause.
 typedef enum {
   kNoPauseOnExceptions = 1,
   kPauseOnUnhandledExceptions,
   kPauseOnAllExceptions,
 } Dart_ExceptionPauseInfo;
 
 /**
  * Define on which exceptions the debugger pauses.
@@ skipping 221 matching lines @@
 * Returns the url of the library \library_id.
 *
 * Requires there to be a current isolate.
 *
 * \return A string handle containing the URL of the library.
 */
 DART_EXPORT Dart_Handle Dart_GetLibraryURL(intptr_t library_id);
 
 
 #endif  // INCLUDE_DART_DEBUGGER_API_H_