diff --git a/doc/contributors/extensions/events.json.js b/doc/contributors/extensions/events.json.js
index 82aaedf2f..7edd7958c 100644
--- a/doc/contributors/extensions/events.json.js
+++ b/doc/contributors/extensions/events.json.js
@@ -1,753 +1,952 @@
 export default [
-    {
-        id: 'core.ai.prompt.check-usage',
-        description: `
-            This event is emitted for ai prompt check usage operations.
+  {
+    id: "core.ai.prompt.check-usage",
+    description: `
+            This event is emitted when checking if an AI prompt operation should be allowed.
+            Extensions can use this event to implement custom usage limits or restrictions.
         `,
-        properties: {
-            allow: {
-                type: 'boolean',
-                mutability: 'mutable',
-                summary: 'whether the operation is allowed',
-                notes: [],
-            },
-            intended_service: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'intended service',
-                notes: [],
-            },
-            parameters: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'parameters',
-                notes: [],
-            }
-        },
+    properties: {
+      allow: {
+        type: "boolean",
+        mutability: "mutable",
+        summary: "whether the operation is allowed",
+        notes: [],
+      },
+      intended_service: {
+        type: "any",
+        mutability: "mutable",
+        summary: "intended service",
+        notes: [],
+      },
+      parameters: {
+        type: "any",
+        mutability: "mutable",
+        summary: "parameters",
+        notes: [],
+      },
     },
-    {
-        id: 'core.ai.prompt.complete',
-        description: `
+  },
+  {
+    id: "core.ai.prompt.complete",
+    description: `
             This event is emitted for ai prompt complete operations.
         `,
-        properties: {
-            username: {
-                type: 'string',
-                mutability: 'mutable',
-                summary: 'username',
-                notes: [],
-            },
-            intended_service: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'intended service',
-                notes: [],
-            },
-            parameters: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'parameters',
-                notes: [],
-            },
-            result: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'result',
-                notes: [],
-            },
-            model_used: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'model used',
-                notes: [],
-            },
-            service_used: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'service used',
-                notes: [],
-            }
-        },
+    properties: {
+      username: {
+        type: "string",
+        mutability: "mutable",
+        summary: "username",
+        notes: [],
+      },
+      intended_service: {
+        type: "any",
+        mutability: "mutable",
+        summary: "intended service",
+        notes: [],
+      },
+      parameters: {
+        type: "any",
+        mutability: "mutable",
+        summary: "parameters",
+        notes: [],
+      },
+      result: {
+        type: "any",
+        mutability: "mutable",
+        summary: "result",
+        notes: [],
+      },
+      model_used: {
+        type: "any",
+        mutability: "mutable",
+        summary: "model used",
+        notes: [],
+      },
+      service_used: {
+        type: "any",
+        mutability: "mutable",
+        summary: "service used",
+        notes: [],
+      },
     },
-    {
-        id: 'core.ai.prompt.report-usage',
-        description: `
+  },
+  {
+    id: "core.ai.prompt.report-usage",
+    description: `
             This event is emitted for ai prompt report usage operations.
         `,
-    },
-    {
-        id: 'core.ai.prompt.validate',
-        description: `
+  },
+  {
+    id: "core.ai.prompt.validate",
+    description: `
             This event is emitted when a validate is being validated.
             The event can be used to block certain validates from being validated.
         `,
-        properties: {
-            allow: {
-                type: 'boolean',
-                mutability: 'mutable',
-                summary: 'whether the operation is allowed',
-                notes: [
-                    'If set to false, the ai will be considered invalid.',
-                ],
-            },
-            intended_service: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'intended service',
-                notes: [],
-            },
-            parameters: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'parameters',
-                notes: [],
-            }
-        },
+    properties: {
+      allow: {
+        type: "boolean",
+        mutability: "mutable",
+        summary: "whether the operation is allowed",
+        notes: ["If set to false, the ai will be considered invalid."],
+      },
+      intended_service: {
+        type: "any",
+        mutability: "mutable",
+        summary: "intended service",
+        notes: [],
+      },
+      parameters: {
+        type: "any",
+        mutability: "mutable",
+        summary: "parameters",
+        notes: [],
+      },
     },
-    {
-        id: 'core.app.new-icon',
-        description: `
+  },
+  {
+    id: "core.app.new-icon",
+    description: `
             This event is emitted for app new icon operations.
         `,
-        properties: {
-            app_uid: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'app uid',
-                notes: [],
-            },
-            data_url: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'data url',
-                notes: [],
-            }
-        },
+    properties: {
+      app_uid: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "app uid",
+        notes: [],
+      },
+      data_url: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "data url",
+        notes: [],
+      },
     },
-    {
-        id: 'core.app.rename',
-        description: `
+  },
+  {
+    id: "core.app.rename",
+    description: `
             This event is emitted for app rename operations.
         `,
-        properties: {
-            app_uid: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'app uid',
-                notes: [],
-            },
-            data_url: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'data url',
-                notes: [],
-            }
-        },
+    properties: {
+      app_uid: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "app uid",
+        notes: [],
+      },
+      data_url: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "data url",
+        notes: [],
+      },
     },
-    {
-        id: 'core.apps.invalidate',
-        description: `
-            This event is emitted when a invalidate is being validated.
-            The event can be used to block certain invalidates from being validated.
+  },
+  {
+    id: "core.apps.invalidate",
+    description: `
+            This event is emitted when the app cache needs to be invalidated.
+            This typically happens when apps are installed, updated, or removed.
         `,
-        properties: {
-            options: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'options',
-                notes: [],
-            },
-            apps: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'apps',
-                notes: [],
-            }
-        },
+    properties: {
+      options: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "options",
+        notes: [],
+      },
+      apps: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "apps",
+        notes: [],
+      },
     },
-    {
-        id: 'core.email.validate',
-        description: `
+  },
+  {
+    id: "core.email.validate",
+    description: `
             This event is emitted when an email is being validated.
             The event can be used to block certain emails from being validated.
         `,
-        properties: {
-            email: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'the email being validated',
-                notes: [
-                    'The email may have already been cleaned.'
-                ]
-            },
-            allow: {
-                type: 'boolean',
-                mutability: 'mutable',
-                summary: 'whether the email is allowed',
-                notes: [
-                    'If set to false, the email will be considered invalid.'
-                ]
-            }
-        },
+    properties: {
+      email: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "the email being validated",
+        notes: ["The email may have already been cleaned."],
+      },
+      allow: {
+        type: "boolean",
+        mutability: "mutable",
+        summary: "whether the email is allowed",
+        notes: ["If set to false, the email will be considered invalid."],
+      },
     },
-    {
-        id: 'core.fs.create.directory',
-        description: `
+  },
+  {
+    id: "core.fs.create.directory",
+    description: `
             This event is emitted when a directory is created.
         `,
-        properties: {
-            node: {
-                type: 'FSNodeContext',
-                mutability: 'no-effect',
-                summary: 'the directory that was created'
-            },
-            context: {
-                type: 'Context',
-                mutability: 'no-effect',
-                summary: 'current context'
-            }
-        },
+    properties: {
+      node: {
+        type: "FSNodeContext",
+        mutability: "no-effect",
+        summary: "the directory that was created",
+      },
+      context: {
+        type: "Context",
+        mutability: "no-effect",
+        summary: "current context",
+      },
     },
-    {
-        id: 'core.fs.create.file',
-        description: `
+  },
+  {
+    id: "core.fs.create.file",
+    description: `
             This event is emitted when a file is created.
         `,
-        properties: {
-            node: {
-                type: 'FSNodeContext',
-                mutability: 'no-effect',
-                summary: 'the file that was affected',
-                notes: [],
-            },
-            context: {
-                type: 'Context',
-                mutability: 'no-effect',
-                summary: 'current context',
-                notes: [],
-            }
-        },
+    properties: {
+      node: {
+        type: "FSNodeContext",
+        mutability: "no-effect",
+        summary: "the file that was affected",
+        notes: [],
+      },
+      context: {
+        type: "Context",
+        mutability: "no-effect",
+        summary: "current context",
+        notes: [],
+      },
     },
-    {
-        id: 'core.fs.create.shortcut',
-        description: `
+  },
+  {
+    id: "core.fs.create.shortcut",
+    description: `
             This event is emitted when a shortcut is created.
         `,
-    },
-    {
-        id: 'core.fs.create.symlink',
-        description: `
+  },
+  {
+    id: "core.fs.create.symlink",
+    description: `
             This event is emitted when a symlink is created.
         `,
-    },
-    {
-        id: 'core.fs.move.file',
-        description: `
+  },
+  {
+    id: "core.fs.move.file",
+    description: `
             This event is emitted for fs move file operations.
         `,
-        properties: {
-            context: {
-                type: 'Context',
-                mutability: 'no-effect',
-                summary: 'current context',
-                notes: [],
-            },
-            moved: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'moved',
-                notes: [],
-            },
-            old_path: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'path to the affected resource',
-                notes: [],
-            }
-        },
+    properties: {
+      context: {
+        type: "Context",
+        mutability: "no-effect",
+        summary: "current context",
+        notes: [],
+      },
+      moved: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "moved",
+        notes: [],
+      },
+      old_path: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "path to the affected resource",
+        notes: [],
+      },
     },
-    {
-        id: 'core.fs.pending.file',
-        description: `
+  },
+  {
+    id: "core.fs.pending.file",
+    description: `
             This event is emitted for fs pending file operations.
         `,
-    },
-    {
-        id: 'core.fs.storage.progress.copy',
-        description: `
-            This event reports progress of a copy operation.
+  },
+  {
+    id: "core.fs.storage.progress.copy",
+    description: `
+            This event reports progress during a file copy operation.
+            It provides detailed information about the progress of large file transfers.
         `,
-        properties: {
-            upload_tracker: {
-                type: 'ProgressTracker',
-                mutability: 'no-effect',
-                summary: 'tracks progress of the operation',
-                notes: [],
-            },
-            context: {
-                type: 'Context',
-                mutability: 'no-effect',
-                summary: 'current context',
-                notes: [],
-            },
-            meta: {
-                type: 'object',
-                mutability: 'no-effect',
-                summary: 'additional metadata for the operation',
-                notes: [],
-            },
-            item_path: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'path to the affected resource',
-                notes: [],
-            }
-        },
+    properties: {
+      upload_tracker: {
+        type: "ProgressTracker",
+        mutability: "no-effect",
+        summary: "tracks progress of the operation",
+        notes: [],
+      },
+      context: {
+        type: "Context",
+        mutability: "no-effect",
+        summary: "current context",
+        notes: [],
+      },
+      meta: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "additional metadata for the operation",
+        notes: [],
+      },
+      item_path: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "path to the affected resource",
+        notes: [],
+      },
     },
-    {
-        id: 'core.fs.storage.upload-progress',
-        description: `
-            This event reports progress of a upload-progress operation.
+  },
+  {
+    id: "core.fs.storage.upload-progress",
+    description: `
+            This event reports progress during a file upload operation.
+            It provides real-time updates about the progress of file uploads.
         `,
+    properties: {
+      progress: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "upload progress percentage (0-100)",
+        notes: [],
+      },
+      bytes_uploaded: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "number of bytes uploaded so far",
+        notes: [],
+      },
+      total_bytes: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "total number of bytes to upload",
+        notes: [],
+      },
     },
-    {
-        id: 'core.fs.write.file',
-        description: `
+  },
+  {
+    id: "core.fs.write.file",
+    description: `
             This event is emitted when a file is updated.
         `,
-        properties: {
-            node: {
-                type: 'FSNodeContext',
-                mutability: 'no-effect',
-                summary: 'the file that was affected',
-                notes: [],
-            },
-            context: {
-                type: 'Context',
-                mutability: 'no-effect',
-                summary: 'current context',
-                notes: [],
-            }
-        },
+    properties: {
+      node: {
+        type: "FSNodeContext",
+        mutability: "no-effect",
+        summary: "the file that was affected",
+        notes: [],
+      },
+      context: {
+        type: "Context",
+        mutability: "no-effect",
+        summary: "current context",
+        notes: [],
+      },
     },
-    {
-        id: 'core.ip.validate',
-        description: `
-            This event is emitted when a validate is being validated.
-            The event can be used to block certain validates from being validated.
+  },
+  {
+    id: "core.ip.validate",
+    description: `
+            This event is emitted when validating an IP address.
+            Extensions can use this event to implement IP-based access control.
         `,
-        properties: {
-            allow: {
-                type: 'boolean',
-                mutability: 'mutable',
-                summary: 'whether the operation is allowed',
-                notes: [
-                    'If set to false, the ip will be considered invalid.',
-                ],
-            },
-            ip: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'ip',
-                notes: [],
-            }
-        },
+    properties: {
+      allow: {
+        type: "boolean",
+        mutability: "mutable",
+        summary: "whether the IP address is allowed",
+        notes: ["If set to false, access from this IP will be blocked"],
+      },
+      ip: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "the IP address being validated",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.fs.write-hash',
-        description: `
+  },
+  {
+    id: "core.outer.fs.write-hash",
+    description: `
             This event is emitted when a write-hash is updated.
         `,
-        properties: {
-            hash: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'hash',
-                notes: [],
-            },
-            uuid: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'uuid',
-                notes: [],
-            }
-        },
+    properties: {
+      hash: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "hash",
+        notes: [],
+      },
+      uuid: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "uuid",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.item.added',
-        description: `
+  },
+  {
+    id: "core.outer.gui.item.added",
+    description: `
             This event is emitted for outer gui item added operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.item.moved',
-        description: `
+  },
+  {
+    id: "core.outer.gui.item.moved",
+    description: `
             This event is emitted for outer gui item moved operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.item.pending',
-        description: `
+  },
+  {
+    id: "core.outer.gui.item.pending",
+    description: `
             This event is emitted for outer gui item pending operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.item.updated',
-        description: `
+  },
+  {
+    id: "core.outer.gui.item.updated",
+    description: `
             This event is emitted when a updated is updated.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.notif.ack',
-        description: `
+  },
+  {
+    id: "core.outer.gui.notif.ack",
+    description: `
             This event is emitted for outer gui notif ack operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.notif.message',
-        description: `
+  },
+  {
+    id: "core.outer.gui.notif.message",
+    description: `
             This event is emitted for outer gui notif message operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            },
-            notification: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'notification',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
+      notification: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "notification",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.notif.persisted',
-        description: `
+  },
+  {
+    id: "core.outer.gui.notif.persisted",
+    description: `
             This event is emitted for outer gui notif persisted operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.notif.unreads',
-        description: `
+  },
+  {
+    id: "core.outer.gui.notif.unreads",
+    description: `
             This event is emitted for outer gui notif unreads operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.outer.gui.submission.done',
-        description: `
+  },
+  {
+    id: "core.outer.gui.submission.done",
+    description: `
             This event is emitted for outer gui submission done operations.
         `,
-        properties: {
-            user_id_list: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id list',
-                notes: [],
-            },
-            response: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'response',
-                notes: [],
-            }
-        },
+    properties: {
+      user_id_list: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user id list",
+        notes: [],
+      },
+      response: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "response",
+        notes: [],
+      },
     },
-    {
-        id: 'core.puter-exec.submission.done',
-        description: `
+  },
+  {
+    id: "core.puter-exec.submission.done",
+    description: `
             This event is emitted for puter-exec submission done operations.
         `,
-    },
-    {
-        id: 'core.request.measured',
-        description: `
-            This event is emitted when a requests incoming and outgoing bytes
-            have been measured.
+  },
+  {
+    id: "core.request.measured",
+    description: `
+            This event is emitted when a request has been measured for performance metrics.
         `,
-        example: {
-            language: 'javascript',
-            code: /*javascript*/`
-                extension.on('core.request.measured', data => {
-                    const measurements = data.measurements;
-                    //    measurements = { sz_incoming: integer, sz_outgoing: integer }
-
-                    const actor = data.actor; // instance of Actor
-
-                    console.log('\x1B[36;1m === MEASUREMENT ===\x1B[0m\n', {
-                        actor: data.actor.uid,
-                        measurements: data.measurements
-                    });
-                });
-            `
-        },
+    properties: {
+      duration: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "request duration in milliseconds",
+        notes: [],
+      },
+      path: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "request path",
+        notes: [],
+      },
     },
-    {
-        id: 'core.sns',
-        description: `
+  },
+  {
+    id: "core.sns",
+    description: `
             This event is emitted for sns operations.
         `,
-        properties: {
-            message: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'message',
-                notes: [],
-            }
-        },
+    properties: {
+      message: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "message",
+        notes: [],
+      },
     },
-    {
-        id: 'core.template-service.hello',
-        description: `
+  },
+  {
+    id: "core.template-service.hello",
+    description: `
             This event is emitted for template-service hello operations.
         `,
-        properties: {
-            message: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'message',
-                notes: [],
-            }
-        },
+    properties: {
+      message: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "message",
+        notes: [],
+      },
     },
-    {
-        id: 'core.usages.query',
-        description: `
+  },
+  {
+    id: "core.usages.query",
+    description: `
             This event is emitted for usages query operations.
         `,
-        properties: {
-            actor: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'actor',
-                notes: [],
-            },
-            usages: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'usages',
-                notes: [],
-            }
-        },
+    properties: {
+      actor: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "actor",
+        notes: [],
+      },
+      usages: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "usages",
+        notes: [],
+      },
     },
-    {
-        id: 'core.user.email-changed',
-        description: `
-            This event is emitted for user email changed operations.
+  },
+  {
+    id: "core.user.email-changed",
+    description: `
+            This event is emitted when a user changes their email address.
         `,
-        properties: {
-            user_id: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user id',
-                notes: [],
-            },
-            new_email: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'new email',
-                notes: [],
-            }
-        },
+    properties: {
+      user: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "user object",
+        notes: [],
+      },
+      old_email: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "previous email address",
+        notes: [],
+      },
+      new_email: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "new email address",
+        notes: [],
+      },
     },
-    {
-        id: 'core.user.email-confirmed',
-        description: `
+  },
+  {
+    id: "core.user.email-confirmed",
+    description: `
             This event is emitted for user email confirmed operations.
         `,
-        properties: {
-            user_uid: {
-                type: 'string',
-                mutability: 'no-effect',
-                summary: 'user uid',
-                notes: [],
-            },
-            email: {
-                type: 'any',
-                mutability: 'no-effect',
-                summary: 'email',
-                notes: [],
-            }
-        },
+    properties: {
+      user_uid: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "user uid",
+        notes: [],
+      },
+      email: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "email",
+        notes: [],
+      },
     },
-    {
-        id: 'core.user.save_account',
-        description: `
-            This event is emitted for user save_account operations.
+  },
+  {
+    id: "core.user.save_account",
+    description: `
+            This event is emitted when a user's account details are saved.
         `,
-        properties: {
-            user: {
-                type: 'User',
-                mutability: 'no-effect',
-                summary: 'user associated with the operation',
-                notes: [],
-            }
-        },
+    properties: {
+      user: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "user object with updated details",
+        notes: [],
+      },
     },
-    {
-        id: 'core.web.socket.connected',
-        description: `
+  },
+  {
+    id: "core.web.socket.connected",
+    description: `
             This event is emitted for web socket connected operations.
         `,
-        properties: {
-            socket: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'socket',
-                notes: [],
-            },
-            user: {
-                type: 'User',
-                mutability: 'mutable',
-                summary: 'user associated with the operation',
-                notes: [],
-            }
-        },
+    properties: {
+      socket: {
+        type: "any",
+        mutability: "mutable",
+        summary: "socket",
+        notes: [],
+      },
+      user: {
+        type: "User",
+        mutability: "mutable",
+        summary: "user associated with the operation",
+        notes: [],
+      },
     },
-    {
-        id: 'core.web.socket.user-connected',
-        description: `
+  },
+  {
+    id: "core.web.socket.user-connected",
+    description: `
             This event is emitted for web socket user connected operations.
         `,
-        properties: {
-            socket: {
-                type: 'any',
-                mutability: 'mutable',
-                summary: 'socket',
-                notes: [],
-            },
-            user: {
-                type: 'User',
-                mutability: 'mutable',
-                summary: 'user associated with the operation',
-                notes: [],
-            }
-        },
+    properties: {
+      socket: {
+        type: "any",
+        mutability: "mutable",
+        summary: "socket",
+        notes: [],
+      },
+      user: {
+        type: "User",
+        mutability: "mutable",
+        summary: "user associated with the operation",
+        notes: [],
+      },
     },
-    {
-        id: 'core.wisp.get-policy',
-        description: `
+  },
+  {
+    id: "core.wisp.get-policy",
+    description: `
             This event is emitted for wisp get policy operations.
         `,
-        properties: {
-            allow: {
-                type: 'boolean',
-                mutability: 'mutable',
-                summary: 'whether the operation is allowed',
-                notes: [],
-            },
-            policy: {
-                type: 'Policy',
-                mutability: 'mutable',
-                summary: 'policy information for the operation',
-                notes: [],
-            }
-        },
-    }
+    properties: {
+      allow: {
+        type: "boolean",
+        mutability: "mutable",
+        summary: "whether the operation is allowed",
+        notes: [],
+      },
+      policy: {
+        type: "Policy",
+        mutability: "mutable",
+        summary: "policy information for the operation",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.credit.check-available",
+    description: `
+            This event is emitted when checking if a user has enough credits available for an operation.
+        `,
+    properties: {
+      amount: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "the amount of credits to check",
+        notes: [],
+      },
+      user: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "user object",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.credit.record-cost",
+    description: `
+            This event is emitted when recording a cost against a user's credits.
+        `,
+    properties: {
+      amount: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "the amount of credits to deduct",
+        notes: [],
+      },
+      user: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "user object",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.credit.funding-update",
+    description: `
+            This event is emitted when a user's credit balance is updated.
+        `,
+    properties: {
+      user: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "user object",
+        notes: [],
+      },
+      balance: {
+        type: "number",
+        mutability: "no-effect",
+        summary: "new balance",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.driver.create-call-context",
+    description: `
+            This event is emitted when a driver call context is being created.
+        `,
+    properties: {
+      context: {
+        type: "Context",
+        mutability: "no-effect",
+        summary: "current context",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.thread.notify-subscribers",
+    description: `
+            This event is emitted when thread subscribers need to be notified of changes.
+        `,
+    properties: {
+      uid: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "thread unique identifier",
+        notes: [],
+      },
+      action: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "action that occurred",
+        notes: [],
+      },
+      data: {
+        type: "any",
+        mutability: "no-effect",
+        summary: "data associated with the action",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.request.will-be-handled",
+    description: `
+            This event is emitted just before a request is handled by the web server.
+            It allows extensions to perform pre-request processing.
+        `,
+    properties: {
+      request: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "the HTTP request object",
+        notes: [],
+      },
+      response: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "the HTTP response object",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.puter.signup",
+    description: `
+            This event is emitted when a new user signs up.
+        `,
+    properties: {
+      user: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "the newly created user object",
+        notes: [],
+      },
+      email: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "email address of the new user",
+        notes: [],
+      },
+    },
+  },
+  {
+    id: "core.captcha.check",
+    description: `
+            This event is emitted when a CAPTCHA verification needs to be performed.
+        `,
+    properties: {
+      token: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "CAPTCHA token to verify",
+        notes: [],
+      },
+      allow: {
+        type: "boolean",
+        mutability: "mutable",
+        summary: "whether the CAPTCHA verification passed",
+        notes: ["If set to false, the request will be rejected"],
+      },
+    },
+  },
+  {
+    id: "core.outer.gui.usage.update",
+    description: `
+            This event is emitted when a user's usage statistics need to be updated.
+        `,
+    properties: {
+      user_id: {
+        type: "string",
+        mutability: "no-effect",
+        summary: "ID of the user whose usage is being updated",
+        notes: [],
+      },
+      usage: {
+        type: "object",
+        mutability: "no-effect",
+        summary: "updated usage statistics",
+        notes: [],
+      },
+    },
+  },
 ];