@breign/db-schemas 0.1.81 → 0.1.82

package/dist/types/gitlab-integration.d.ts

@@ -94,17 +94,33 @@ export type ExternalEventRouting = {
     agentName: string | null;
     instruction: string;
 };
-/** Un événement reçu d'une source externe, et son passage dans la file. */
-export type ExternalEvent = {
+/**
+ * Ce qu'on garde d'un appel de webhook générique. `body` est le JSON reçu s'il tient dans la
+ * limite de stockage ; sinon `body` est `null` et `bodyText` en garde le début.
+ */
+export type WebhookEventPayload = {
+    contentType: string;
+    body: unknown;
+    bodyText: string | null;
+    bodyTruncated: boolean;
+    /** Une liste blanche d'en-têtes (jamais `Authorization`), noms en minuscules. */
+    headers: Record<string, string>;
+    /** `X-Breign-Thread` tel qu'envoyé : les appels de même clé reprennent la même conversation. */
+    thread: string | null;
+};
+type ExternalEventBase = {
     id: string;
-    integrationId: string;
     organizationId: string;
-    /** `X-Gitlab-Event-UUID` : unique avec l'intégration, un renvoi n'est pas rejoué. */
+    /**
+     * GitLab : `X-Gitlab-Event-UUID` ; webhook : `<endpointId>:<Idempotency-Key>` (ou un uuid
+     * généré), préfixé pour rester unique entre endpoints. Unique avec l'intégration ou l'endpoint :
+     * un renvoi n'est pas rejoué.
+     */
     eventUuid: string;
-    source: 'gitlab';
-    kind: ExternalEventKind;
-    payload: ExternalEventPayload;
-    /** Instance + projet + objet + discussion : deux mentions d'un même fil s'y retrouvent. */
+    /**
+     * GitLab : instance + projet + objet + discussion ; webhook : endpoint + clé de fil, ou
+     * l'événement seul. Deux événements d'un même fil s'y retrouvent, l'un après l'autre.
+     */
     threadKey: string;
     botAccountId: string | null;
     agentId: string | null;
@@ -125,7 +141,51 @@ export type ExternalEvent = {
     finishedAt: string | null;
     updatedAt: string;
 };
-/** La conversation d'un agent dans un fil GitLab : les mentions suivantes la reprennent. */
+/** Une mention reçue d'une intégration GitLab. */
+export type GitlabExternalEvent = ExternalEventBase & {
+    source: 'gitlab';
+    integrationId: string;
+    webhookEndpointId: null;
+    kind: ExternalEventKind;
+    payload: ExternalEventPayload;
+};
+/**
+ * Un appel du webhook d'une automatisation : l'automatisation et l'agent sont connus dès la
+ * réception, il n'y a pas de routage (ni compte bot, ni réponse dans un fil).
+ */
+export type WebhookExternalEvent = ExternalEventBase & {
+    source: 'webhook';
+    integrationId: null;
+    webhookEndpointId: string;
+    kind: 'webhook';
+    payload: WebhookEventPayload;
+};
+/** Un événement reçu d'une source externe, et son passage dans la file. */
+export type ExternalEvent = GitlabExternalEvent | WebhookExternalEvent;
+export type ExternalEventSource = ExternalEvent['source'];
+export type WebhookEndpointStatus = 'active' | 'disabled';
+/**
+ * L'adresse publique d'une automatisation déclenchée par webhook :
+ * `POST /webhooks/automations/:id`. Régénérer l'URL crée un nouvel `id`, l'ancien répond 404.
+ */
+export type WebhookEndpoint = {
+    id: string;
+    organizationId: string;
+    /** Une automatisation a au plus un endpoint. */
+    taskId: string;
+    /** Le secret (Bearer ou clé HMAC), chiffré en base. */
+    secret: string;
+    /**
+     * Le membre de l'organisation au nom duquel tournent les conversations : outils MCP de portée
+     * utilisateur, quotas, et qui retrouve la conversation dans son historique.
+     */
+    runAsUserId: string;
+    status: WebhookEndpointStatus;
+    lastEventAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** La conversation d'un agent dans un fil (GitLab, ou clé de fil d'un webhook) : les événements suivants la reprennent. */
 export type ExternalThread = {
     threadKey: string;
     agentId: string;
@@ -134,3 +194,4 @@ export type ExternalThread = {
     createdAt: string;
     lastRunAt: string | null;
 };
+export {};

package/dist/types/scheduled-task-run.d.ts

@@ -10,7 +10,7 @@ export type RunStep = {
 };
 /**
  * Qui exécute le run : `external`, l'exécuteur des tâches programmées (via la file) ;
- * `internal`, brain-api lui-même (runs déclenchés par un événement). L'exécuteur externe et la
+ * `internal`, brain-api lui-même (runs déclenchés par un événement ou un webhook). L'exécuteur externe et la
  * reprise des runs bloqués ignorent les runs `internal`.
  */
 export type RunExecutor = 'internal' | 'external';
@@ -26,7 +26,7 @@ export type ScheduledTaskRun = {
     claimedAt?: Date;
     retryCount: number;
     steps: RunStep[];
-    /** L'événement externe à l'origine du run (mention GitLab). */
+    /** L'événement externe à l'origine du run (mention GitLab, appel de webhook). */
     triggerEventId?: string;
     /** Absent : `external`. */
     executor?: RunExecutor;

package/dist/types/scheduled-task.d.ts

@@ -48,7 +48,14 @@ export type TaskTriggerEvent = {
         ack: boolean;
     };
 };
-export type TaskTrigger = TaskTriggerSchedule | TaskTriggerEvent;
+/**
+ * Déclenchée par un appel de son webhook (`WebhookEndpoint`, retrouvé par l'automatisation) : le
+ * payload remplit le modèle, le résultat part sur `callbackUrl`.
+ */
+export type TaskTriggerWebhook = {
+    type: 'webhook';
+};
+export type TaskTrigger = TaskTriggerSchedule | TaskTriggerEvent | TaskTriggerWebhook;
 export type ScheduledTask = {
     id: string;
     agentId: string;
@@ -57,7 +64,7 @@ export type ScheduledTask = {
     message: string;
     mode: TaskMode;
     status: TaskStatus;
-    /** `null` pour une automatisation déclenchée par un événement. */
+    /** `null` pour une automatisation déclenchée par un événement ou un webhook. */
     schedule: TaskSchedule | null;
     /** Absent : `{ type: 'schedule' }`. */
     trigger?: TaskTrigger;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breign/db-schemas",
-  "version": "0.1.81",
+  "version": "0.1.82",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/types/gitlab-integration.ts

@@ -114,17 +114,34 @@ export type ExternalEventRouting = {
   instruction: string;
 };
 
-/** Un événement reçu d'une source externe, et son passage dans la file. */
-export type ExternalEvent = {
+/**
+ * Ce qu'on garde d'un appel de webhook générique. `body` est le JSON reçu s'il tient dans la
+ * limite de stockage ; sinon `body` est `null` et `bodyText` en garde le début.
+ */
+export type WebhookEventPayload = {
+  contentType: string;
+  body: unknown;
+  bodyText: string | null;
+  bodyTruncated: boolean;
+  /** Une liste blanche d'en-têtes (jamais `Authorization`), noms en minuscules. */
+  headers: Record<string, string>;
+  /** `X-Breign-Thread` tel qu'envoyé : les appels de même clé reprennent la même conversation. */
+  thread: string | null;
+};
+
+type ExternalEventBase = {
   id: string;
-  integrationId: string;
   organizationId: string;
-  /** `X-Gitlab-Event-UUID` : unique avec l'intégration, un renvoi n'est pas rejoué. */
+  /**
+   * GitLab : `X-Gitlab-Event-UUID` ; webhook : `<endpointId>:<Idempotency-Key>` (ou un uuid
+   * généré), préfixé pour rester unique entre endpoints. Unique avec l'intégration ou l'endpoint :
+   * un renvoi n'est pas rejoué.
+   */
   eventUuid: string;
-  source: 'gitlab';
-  kind: ExternalEventKind;
-  payload: ExternalEventPayload;
-  /** Instance + projet + objet + discussion : deux mentions d'un même fil s'y retrouvent. */
+  /**
+   * GitLab : instance + projet + objet + discussion ; webhook : endpoint + clé de fil, ou
+   * l'événement seul. Deux événements d'un même fil s'y retrouvent, l'un après l'autre.
+   */
   threadKey: string;
   botAccountId: string | null;
   agentId: string | null;
@@ -146,7 +163,57 @@ export type ExternalEvent = {
   updatedAt: string;
 };
 
-/** La conversation d'un agent dans un fil GitLab : les mentions suivantes la reprennent. */
+/** Une mention reçue d'une intégration GitLab. */
+export type GitlabExternalEvent = ExternalEventBase & {
+  source: 'gitlab';
+  integrationId: string;
+  webhookEndpointId: null;
+  kind: ExternalEventKind;
+  payload: ExternalEventPayload;
+};
+
+/**
+ * Un appel du webhook d'une automatisation : l'automatisation et l'agent sont connus dès la
+ * réception, il n'y a pas de routage (ni compte bot, ni réponse dans un fil).
+ */
+export type WebhookExternalEvent = ExternalEventBase & {
+  source: 'webhook';
+  integrationId: null;
+  webhookEndpointId: string;
+  kind: 'webhook';
+  payload: WebhookEventPayload;
+};
+
+/** Un événement reçu d'une source externe, et son passage dans la file. */
+export type ExternalEvent = GitlabExternalEvent | WebhookExternalEvent;
+
+export type ExternalEventSource = ExternalEvent['source'];
+
+export type WebhookEndpointStatus = 'active' | 'disabled';
+
+/**
+ * L'adresse publique d'une automatisation déclenchée par webhook :
+ * `POST /webhooks/automations/:id`. Régénérer l'URL crée un nouvel `id`, l'ancien répond 404.
+ */
+export type WebhookEndpoint = {
+  id: string;
+  organizationId: string;
+  /** Une automatisation a au plus un endpoint. */
+  taskId: string;
+  /** Le secret (Bearer ou clé HMAC), chiffré en base. */
+  secret: string;
+  /**
+   * Le membre de l'organisation au nom duquel tournent les conversations : outils MCP de portée
+   * utilisateur, quotas, et qui retrouve la conversation dans son historique.
+   */
+  runAsUserId: string;
+  status: WebhookEndpointStatus;
+  lastEventAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+/** La conversation d'un agent dans un fil (GitLab, ou clé de fil d'un webhook) : les événements suivants la reprennent. */
 export type ExternalThread = {
   threadKey: string;
   agentId: string;

package/src/types/scheduled-task-run.ts

@@ -17,7 +17,7 @@ export type RunStep = {
 
 /**
  * Qui exécute le run : `external`, l'exécuteur des tâches programmées (via la file) ;
- * `internal`, brain-api lui-même (runs déclenchés par un événement). L'exécuteur externe et la
+ * `internal`, brain-api lui-même (runs déclenchés par un événement ou un webhook). L'exécuteur externe et la
  * reprise des runs bloqués ignorent les runs `internal`.
  */
 export type RunExecutor = 'internal' | 'external';
@@ -34,7 +34,7 @@ export type ScheduledTaskRun = {
   claimedAt?: Date;
   retryCount: number;
   steps: RunStep[];
-  /** L'événement externe à l'origine du run (mention GitLab). */
+  /** L'événement externe à l'origine du run (mention GitLab, appel de webhook). */
   triggerEventId?: string;
   /** Absent : `external`. */
   executor?: RunExecutor;

package/src/types/scheduled-task.ts

@@ -38,7 +38,13 @@ export type TaskTriggerEvent = {
   reply: { thread: boolean; ack: boolean };
 };
 
-export type TaskTrigger = TaskTriggerSchedule | TaskTriggerEvent;
+/**
+ * Déclenchée par un appel de son webhook (`WebhookEndpoint`, retrouvé par l'automatisation) : le
+ * payload remplit le modèle, le résultat part sur `callbackUrl`.
+ */
+export type TaskTriggerWebhook = { type: 'webhook' };
+
+export type TaskTrigger = TaskTriggerSchedule | TaskTriggerEvent | TaskTriggerWebhook;
 
 export type ScheduledTask = {
   id: string;
@@ -48,7 +54,7 @@ export type ScheduledTask = {
   message: string;
   mode: TaskMode;
   status: TaskStatus;
-  /** `null` pour une automatisation déclenchée par un événement. */
+  /** `null` pour une automatisation déclenchée par un événement ou un webhook. */
   schedule: TaskSchedule | null;
   /** Absent : `{ type: 'schedule' }`. */
   trigger?: TaskTrigger;