@breign/db-schemas 0.1.79 → 0.1.80

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

@@ -0,0 +1,136 @@
+/**
+ * Les niveaux d'accès d'un membre de projet GitLab : Guest (10), Reporter (20), Developer (30),
+ * Maintainer (40), Owner (50).
+ */
+export type GitlabAccessLevel = 10 | 20 | 30 | 40 | 50;
+export type GitlabIntegrationStatus = 'active' | 'disabled';
+/**
+ * Une instance GitLab reliée à une organisation : elle reçoit les webhooks des projets qui la
+ * déclarent, à l'adresse `/webhooks/gitlab/:id`.
+ */
+export type GitlabIntegration = {
+    id: string;
+    organizationId: string;
+    name: string;
+    /** `https://gitlab.exemple.com`, sans `/` final. */
+    baseUrl: string;
+    /** Le « Secret token » du webhook, chiffré en base. */
+    webhookSecret: string;
+    /** Niveau minimal de l'auteur d'une mention sur le projet pour réveiller un agent. */
+    minAccessLevel: GitlabAccessLevel;
+    status: GitlabIntegrationStatus;
+    lastEventAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** `token_invalid` : GitLab a refusé le token (401/403), le compte ne répond plus. */
+export type GitlabBotAccountStatus = 'active' | 'token_invalid' | 'disabled';
+/**
+ * Un compte GitLab que l'on mentionne pour réveiller un agent. `@bot Agent …` réveille l'agent
+ * nommé s'il est appelable, sinon tout le texte part à l'agent par défaut.
+ */
+export type GitlabBotAccount = {
+    id: string;
+    integrationId: string;
+    organizationId: string;
+    gitlabUserId: number | null;
+    /** Sans `@`. */
+    username: string;
+    /** Token d'accès personnel du compte, chiffré en base. */
+    token: string;
+    tokenExpiresAt: string | null;
+    defaultAgentId: string | null;
+    /** `null` : tous les agents de l'organisation sont appelables par leur nom. */
+    callableAgentIds: string[] | null;
+    /**
+     * 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: GitlabBotAccountStatus;
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** Le type d'objet GitLab sur lequel porte une mention. */
+export type ExternalEventTargetType = 'merge_request' | 'issue' | 'work_item' | 'commit';
+/** Le `object_kind` du webhook GitLab. */
+export type ExternalEventKind = 'note' | 'issue' | 'merge_request' | 'work_item';
+/** Ce qu'on garde d'un webhook GitLab : jamais le JSON complet. */
+export type ExternalEventPayload = {
+    instanceUrl: string;
+    projectId: number;
+    /** `groupe/projet`. */
+    projectPath: string;
+    targetType: ExternalEventTargetType;
+    /** `!142`, `#88` : l'iid ; absent pour un commit. */
+    targetIid: number | null;
+    /** Identifiant global de l'objet (work item : sert à l'API GraphQL). */
+    targetId: number | null;
+    targetTitle: string | null;
+    targetUrl: string | null;
+    commitSha: string | null;
+    /** Absent quand la mention vient de la description d'une MR ou d'une issue. */
+    noteId: number | null;
+    discussionId: string | null;
+    noteUrl: string | null;
+    authorId: number;
+    authorUsername: string;
+    authorName: string | null;
+    /** Le texte, tronqué à 20 ko. */
+    body: string;
+    bodyTruncated: boolean;
+};
+/**
+ * `received` → (routage) → `ignored` | `no_automation` | `queued` → `running` → `replying` →
+ * `done`. Un échec transitoire repasse `queued` (plus tard) ; au-delà des essais, `dead`.
+ * `expired` : resté trop longtemps en file. `dropped_overload` : écarté par le garde-fou de débit.
+ */
+export type ExternalEventStatus = 'received' | 'queued' | 'running' | 'replying' | 'done' | 'ignored' | 'no_automation' | 'expired' | 'dead' | 'dropped_overload';
+/** `named` : premier mot = agent appelable ; `default` : tout le texte à l'agent par défaut. */
+export type ExternalEventRouting = {
+    mode: 'named' | 'default' | 'help';
+    /** Le nom tel qu'écrit dans la mention, quand il a désigné l'agent. */
+    agentName: string | null;
+    instruction: string;
+};
+/** Un événement reçu d'une source externe, et son passage dans la file. */
+export type ExternalEvent = {
+    id: string;
+    integrationId: string;
+    organizationId: string;
+    /** `X-Gitlab-Event-UUID` : unique avec l'intégration, 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. */
+    threadKey: string;
+    botAccountId: string | null;
+    agentId: string | null;
+    taskId: string | null;
+    runId: string | null;
+    conversationId: string | null;
+    routing: ExternalEventRouting | null;
+    status: ExternalEventStatus;
+    availableAt: string;
+    attempts: number;
+    claimedBy: string | null;
+    leaseUntil: string | null;
+    lastError: string | null;
+    /** La note de réponse, dès qu'elle existe : un nouvel essai ne la reposte pas. */
+    replyNoteId: string | null;
+    replyUrl: string | null;
+    receivedAt: string;
+    finishedAt: string | null;
+    updatedAt: string;
+};
+/** La conversation d'un agent dans un fil GitLab : les mentions suivantes la reprennent. */
+export type ExternalThread = {
+    threadKey: string;
+    agentId: string;
+    organizationId: string;
+    conversationId: string;
+    createdAt: string;
+    lastRunAt: string | null;
+};

package/dist/types/gitlab-integration.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -8,6 +8,7 @@ export * from './engine';
 export * from './file';
 export * from './flow';
 export * from './flow-editor';
+export * from './gitlab-integration';
 export * from './inbox';
 export * from './knowledge';
 export * from './ocr';

package/dist/types/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./engine"), exports);
 __exportStar(require("./file"), exports);
 __exportStar(require("./flow"), exports);
 __exportStar(require("./flow-editor"), exports);
+__exportStar(require("./gitlab-integration"), exports);
 __exportStar(require("./inbox"), exports);
 __exportStar(require("./knowledge"), exports);
 __exportStar(require("./ocr"), exports);

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

@@ -8,6 +8,12 @@ export type RunStep = {
     tokens?: number;
     error?: string;
 };
+/**
+ * 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
+ * reprise des runs bloqués ignorent les runs `internal`.
+ */
+export type RunExecutor = 'internal' | 'external';
 export type ScheduledTaskRun = {
     id: string;
     taskId: string;
@@ -20,5 +26,9 @@ export type ScheduledTaskRun = {
     claimedAt?: Date;
     retryCount: number;
     steps: RunStep[];
+    /** L'événement externe à l'origine du run (mention GitLab). */
+    triggerEventId?: string;
+    /** Absent : `external`. */
+    executor?: RunExecutor;
     createdAt: Date;
 };

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

@@ -28,6 +28,27 @@ export type TaskSchedule = {
     start?: string;
     end?: TaskEnd;
 };
+export type TaskTriggerSchedule = {
+    type: 'schedule';
+};
+/** Les objets GitLab dans lesquels une mention déclenche l'automatisation. */
+export type TaskEventKind = 'merge_request' | 'issue' | 'work_item' | 'commit';
+/**
+ * Déclenchée par une mention d'un compte bot GitLab, au lieu d'un horaire. `projects` vide : tous
+ * les projets ; sinon `groupe/projet` ou `groupe/*`.
+ */
+export type TaskTriggerEvent = {
+    type: 'event';
+    source: 'gitlab_mention';
+    botAccountIds: string[];
+    kinds: TaskEventKind[];
+    projects: string[];
+    reply: {
+        thread: boolean;
+        ack: boolean;
+    };
+};
+export type TaskTrigger = TaskTriggerSchedule | TaskTriggerEvent;
 export type ScheduledTask = {
     id: string;
     agentId: string;
@@ -36,7 +57,10 @@ export type ScheduledTask = {
     message: string;
     mode: TaskMode;
     status: TaskStatus;
-    schedule: TaskSchedule;
+    /** `null` pour une automatisation déclenchée par un événement. */
+    schedule: TaskSchedule | null;
+    /** Absent : `{ type: 'schedule' }`. */
+    trigger?: TaskTrigger;
     cronExpression: string;
     timezone: string;
     lang: string;

package/package.json

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

package/src/types/gitlab-integration.ts

@@ -0,0 +1,157 @@
+/**
+ * Les niveaux d'accès d'un membre de projet GitLab : Guest (10), Reporter (20), Developer (30),
+ * Maintainer (40), Owner (50).
+ */
+export type GitlabAccessLevel = 10 | 20 | 30 | 40 | 50;
+
+export type GitlabIntegrationStatus = 'active' | 'disabled';
+
+/**
+ * Une instance GitLab reliée à une organisation : elle reçoit les webhooks des projets qui la
+ * déclarent, à l'adresse `/webhooks/gitlab/:id`.
+ */
+export type GitlabIntegration = {
+  id: string;
+  organizationId: string;
+  name: string;
+  /** `https://gitlab.exemple.com`, sans `/` final. */
+  baseUrl: string;
+  /** Le « Secret token » du webhook, chiffré en base. */
+  webhookSecret: string;
+  /** Niveau minimal de l'auteur d'une mention sur le projet pour réveiller un agent. */
+  minAccessLevel: GitlabAccessLevel;
+  status: GitlabIntegrationStatus;
+  lastEventAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+/** `token_invalid` : GitLab a refusé le token (401/403), le compte ne répond plus. */
+export type GitlabBotAccountStatus = 'active' | 'token_invalid' | 'disabled';
+
+/**
+ * Un compte GitLab que l'on mentionne pour réveiller un agent. `@bot Agent …` réveille l'agent
+ * nommé s'il est appelable, sinon tout le texte part à l'agent par défaut.
+ */
+export type GitlabBotAccount = {
+  id: string;
+  integrationId: string;
+  organizationId: string;
+  gitlabUserId: number | null;
+  /** Sans `@`. */
+  username: string;
+  /** Token d'accès personnel du compte, chiffré en base. */
+  token: string;
+  tokenExpiresAt: string | null;
+  defaultAgentId: string | null;
+  /** `null` : tous les agents de l'organisation sont appelables par leur nom. */
+  callableAgentIds: string[] | null;
+  /**
+   * 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: GitlabBotAccountStatus;
+  lastError: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+/** Le type d'objet GitLab sur lequel porte une mention. */
+export type ExternalEventTargetType = 'merge_request' | 'issue' | 'work_item' | 'commit';
+
+/** Le `object_kind` du webhook GitLab. */
+export type ExternalEventKind = 'note' | 'issue' | 'merge_request' | 'work_item';
+
+/** Ce qu'on garde d'un webhook GitLab : jamais le JSON complet. */
+export type ExternalEventPayload = {
+  instanceUrl: string;
+  projectId: number;
+  /** `groupe/projet`. */
+  projectPath: string;
+  targetType: ExternalEventTargetType;
+  /** `!142`, `#88` : l'iid ; absent pour un commit. */
+  targetIid: number | null;
+  /** Identifiant global de l'objet (work item : sert à l'API GraphQL). */
+  targetId: number | null;
+  targetTitle: string | null;
+  targetUrl: string | null;
+  commitSha: string | null;
+  /** Absent quand la mention vient de la description d'une MR ou d'une issue. */
+  noteId: number | null;
+  discussionId: string | null;
+  noteUrl: string | null;
+  authorId: number;
+  authorUsername: string;
+  authorName: string | null;
+  /** Le texte, tronqué à 20 ko. */
+  body: string;
+  bodyTruncated: boolean;
+};
+
+/**
+ * `received` → (routage) → `ignored` | `no_automation` | `queued` → `running` → `replying` →
+ * `done`. Un échec transitoire repasse `queued` (plus tard) ; au-delà des essais, `dead`.
+ * `expired` : resté trop longtemps en file. `dropped_overload` : écarté par le garde-fou de débit.
+ */
+export type ExternalEventStatus =
+  | 'received'
+  | 'queued'
+  | 'running'
+  | 'replying'
+  | 'done'
+  | 'ignored'
+  | 'no_automation'
+  | 'expired'
+  | 'dead'
+  | 'dropped_overload';
+
+/** `named` : premier mot = agent appelable ; `default` : tout le texte à l'agent par défaut. */
+export type ExternalEventRouting = {
+  mode: 'named' | 'default' | 'help';
+  /** Le nom tel qu'écrit dans la mention, quand il a désigné l'agent. */
+  agentName: string | null;
+  instruction: string;
+};
+
+/** Un événement reçu d'une source externe, et son passage dans la file. */
+export type ExternalEvent = {
+  id: string;
+  integrationId: string;
+  organizationId: string;
+  /** `X-Gitlab-Event-UUID` : unique avec l'intégration, 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. */
+  threadKey: string;
+  botAccountId: string | null;
+  agentId: string | null;
+  taskId: string | null;
+  runId: string | null;
+  conversationId: string | null;
+  routing: ExternalEventRouting | null;
+  status: ExternalEventStatus;
+  availableAt: string;
+  attempts: number;
+  claimedBy: string | null;
+  leaseUntil: string | null;
+  lastError: string | null;
+  /** La note de réponse, dès qu'elle existe : un nouvel essai ne la reposte pas. */
+  replyNoteId: string | null;
+  replyUrl: string | null;
+  receivedAt: string;
+  finishedAt: string | null;
+  updatedAt: string;
+};
+
+/** La conversation d'un agent dans un fil GitLab : les mentions suivantes la reprennent. */
+export type ExternalThread = {
+  threadKey: string;
+  agentId: string;
+  organizationId: string;
+  conversationId: string;
+  createdAt: string;
+  lastRunAt: string | null;
+};

package/src/types/index.ts

@@ -8,6 +8,7 @@ export * from './engine';
 export * from './file';
 export * from './flow';
 export * from './flow-editor';
+export * from './gitlab-integration';
 export * from './inbox';
 export * from './knowledge';
 export * from './ocr';

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

@@ -15,6 +15,13 @@ export type RunStep = {
   error?: string;
 };
 
+/**
+ * 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
+ * reprise des runs bloqués ignorent les runs `internal`.
+ */
+export type RunExecutor = 'internal' | 'external';
+
 export type ScheduledTaskRun = {
   id: string;
   taskId: string;
@@ -27,5 +34,9 @@ export type ScheduledTaskRun = {
   claimedAt?: Date;
   retryCount: number;
   steps: RunStep[];
+  /** L'événement externe à l'origine du run (mention GitLab). */
+  triggerEventId?: string;
+  /** Absent : `external`. */
+  executor?: RunExecutor;
   createdAt: Date;
 };

package/src/types/scheduled-task.ts

@@ -20,6 +20,26 @@ export type TaskSchedule = {
   end?: TaskEnd;
 };
 
+export type TaskTriggerSchedule = { type: 'schedule' };
+
+/** Les objets GitLab dans lesquels une mention déclenche l'automatisation. */
+export type TaskEventKind = 'merge_request' | 'issue' | 'work_item' | 'commit';
+
+/**
+ * Déclenchée par une mention d'un compte bot GitLab, au lieu d'un horaire. `projects` vide : tous
+ * les projets ; sinon `groupe/projet` ou `groupe/*`.
+ */
+export type TaskTriggerEvent = {
+  type: 'event';
+  source: 'gitlab_mention';
+  botAccountIds: string[];
+  kinds: TaskEventKind[];
+  projects: string[];
+  reply: { thread: boolean; ack: boolean };
+};
+
+export type TaskTrigger = TaskTriggerSchedule | TaskTriggerEvent;
+
 export type ScheduledTask = {
   id: string;
   agentId: string;
@@ -28,7 +48,10 @@ export type ScheduledTask = {
   message: string;
   mode: TaskMode;
   status: TaskStatus;
-  schedule: TaskSchedule;
+  /** `null` pour une automatisation déclenchée par un événement. */
+  schedule: TaskSchedule | null;
+  /** Absent : `{ type: 'schedule' }`. */
+  trigger?: TaskTrigger;
   cronExpression: string;
   timezone: string;
   lang: string;