@breign/db-schemas 0.1.75 → 0.1.77

package/dist/types/conversation.d.ts

@@ -1,5 +1,7 @@
 import { ChatMessageRoleUio } from '@breign/client';
 import type { ToolCallApprovalScope } from './pending-tool-call';
+import type { AgentTicketCreation } from './project';
+import type { TicketProposalPayload, TicketProposalStatus } from './ticket';
 import type { ToolAction, ToolResult } from './tool-result';
 export type ConversationMessageReaction = 'positive' | 'negative';
 export type ConversationAttachmentStatus = 'TO_UPLOAD' | 'PROCESSING' | 'PROCESSED' | 'ERROR';
@@ -112,6 +114,20 @@ export type ConversationHumanRequest = {
     answeredAt?: string;
     expiresAt?: string;
 };
+/**
+ * Un ticket qu'un agent propose depuis cette conversation (outil `Ticket_create`). La carte affichée
+ * sous le message se met à jour quand la proposition est acceptée, écartée ou annulée.
+ */
+export type ConversationTicketProposal = {
+    proposalId: string;
+    status: TicketProposalStatus;
+    mode: AgentTicketCreation;
+    /** Projet proposé par l'agent ; null = l'humain doit en choisir un. */
+    projectId: string | null;
+    payload: TicketProposalPayload;
+    ticketId: string | null;
+    ticketKey: string | null;
+};
 export type ConversationMessage = {
     id: string;
     role: ChatMessageRoleUio;
@@ -133,6 +149,8 @@ export type ConversationMessage = {
     approvals?: ConversationMessageApproval[];
     /** Question posée à l'humain par une tâche. Voir ConversationHumanRequest. */
     humanRequest?: ConversationHumanRequest;
+    /** Ticket proposé par l'agent dans ce message. Voir ConversationTicketProposal. */
+    ticketProposal?: ConversationTicketProposal;
     suggestions?: {
         id: string;
         text: string;
@@ -175,6 +193,11 @@ export type ConversationContext = {
     lastActivityAt?: string;
     /** Tâche ouverte par un agent local via le serveur MCP de Breign. */
     externalCaller?: ConversationExternalCaller;
+    /** Ticket auquel cette conversation est liée (proposition acceptée, session de travail). */
+    ticket?: {
+        ticketId: string;
+        projectId: string;
+    };
 };
 export type ConversationExternalCaller = {
     kind: 'local_agent';

package/dist/types/inbox.d.ts

@@ -0,0 +1,27 @@
+import type { ActorRef } from './project';
+/**
+ * `question`, `ticket_proposal`, `review` et `go_ahead` sont des actions (onglet « À traiter ») ;
+ * `mention` a son propre onglet.
+ */
+export type InboxItemKind = 'question' | 'ticket_proposal' | 'review' | 'go_ahead' | 'mention';
+/** Ce qui attend un humain : écrit quand l'action naît, résolu quand elle est faite. */
+export type InboxItem = {
+    id: string;
+    organizationId: string;
+    userId: string;
+    kind: InboxItemKind;
+    requestedBy: ActorRef;
+    projectId: string | null;
+    ticketId: string | null;
+    /**
+     * Objet visé : `callId` d'une question, `proposalId` d'une proposition, événement d'une mention,
+     * ticket d'une relecture, ticket d'un feu vert (avec l'agent dans `data.agentId`).
+     */
+    refId: string;
+    summary: string;
+    data: Record<string, unknown>;
+    status: 'pending' | 'done';
+    resolution: Record<string, unknown> | null;
+    createdAt: string;
+    resolvedAt: string | null;
+};

package/dist/types/inbox.js

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

package/dist/types/index.d.ts

@@ -8,16 +8,19 @@ export * from './engine';
 export * from './file';
 export * from './flow';
 export * from './flow-editor';
+export * from './inbox';
 export * from './knowledge';
 export * from './ocr';
 export * from './organization';
 export * from './pending-tool-call';
+export * from './project';
 export * from './permissions';
 export * from './role';
 export * from './scheduled-task';
 export * from './scheduled-task-run';
 export * from './skill';
 export * from './speech-to-text';
+export * from './ticket';
 export * from './tool';
 export * from './tool-approval';
 export * from './tool-result';

package/dist/types/index.js

@@ -24,16 +24,19 @@ __exportStar(require("./engine"), exports);
 __exportStar(require("./file"), exports);
 __exportStar(require("./flow"), exports);
 __exportStar(require("./flow-editor"), exports);
+__exportStar(require("./inbox"), exports);
 __exportStar(require("./knowledge"), exports);
 __exportStar(require("./ocr"), exports);
 __exportStar(require("./organization"), exports);
 __exportStar(require("./pending-tool-call"), exports);
+__exportStar(require("./project"), exports);
 __exportStar(require("./permissions"), exports);
 __exportStar(require("./role"), exports);
 __exportStar(require("./scheduled-task"), exports);
 __exportStar(require("./scheduled-task-run"), exports);
 __exportStar(require("./skill"), exports);
 __exportStar(require("./speech-to-text"), exports);
+__exportStar(require("./ticket"), exports);
 __exportStar(require("./tool"), exports);
 __exportStar(require("./tool-approval"), exports);
 __exportStar(require("./tool-result"), exports);

package/dist/types/project.d.ts

@@ -0,0 +1,56 @@
+/** Auteur ou destinataire d'une action : un humain, un agent ou le système. */
+export type ActorType = 'user' | 'agent' | 'system';
+/** Membre d'un projet ou assigné d'un ticket : un humain ou un agent. */
+export type MemberType = 'user' | 'agent';
+export type ActorRef = {
+    type: ActorType;
+    /** Identifiant de l'utilisateur ou de l'agent ; null pour le système. */
+    id: string | null;
+};
+export type MemberRef = {
+    type: MemberType;
+    id: string;
+};
+/**
+ * Ce qui se passe quand un agent crée un ticket : `confirm`, l'agent propose et un humain confirme ;
+ * `direct`, le ticket est créé tout de suite et la création reste annulable.
+ */
+export type AgentTicketCreation = 'confirm' | 'direct';
+/** `now` : les agents assignés commencent dès l'assignation ; `hold` : ils attendent un feu vert. */
+export type TicketStartMode = 'now' | 'hold';
+export type ProjectSettings = {
+    agentTicketCreation: AgentTicketCreation;
+    defaultStartMode: TicketStartMode;
+    /**
+     * Les agents assignés se mettent au travail d'eux-mêmes quand on leur confie le ticket ou qu'on
+     * leur parle. Absent = activé.
+     */
+    agentsAutoWork?: boolean;
+};
+export type Project = {
+    id: string;
+    organizationId: string;
+    /** Préfixe des identifiants de tickets (BRN donne BRN-142), unique dans l'organisation. */
+    key: string;
+    name: string;
+    description: string | null;
+    color: string | null;
+    dueDate: string | null;
+    settings: ProjectSettings;
+    /** Dernier numéro de ticket attribué ; incrémenté à chaque création. */
+    ticketSeq: number;
+    archivedAt: string | null;
+    createdBy: ActorRef;
+    createdAt: string;
+    updatedAt: string;
+};
+export type ProjectMemberRole = 'owner' | 'member';
+export type ProjectMember = {
+    projectId: string;
+    type: MemberType;
+    id: string;
+    role: ProjectMemberRole;
+    /** Pour un agent, surcharge `ProjectSettings.agentTicketCreation` ; null = réglage du projet. */
+    agentTicketCreation: AgentTicketCreation | null;
+    createdAt: string;
+};

package/dist/types/project.js

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

package/dist/types/ticket.d.ts

@@ -0,0 +1,192 @@
+import type { ActorRef, AgentTicketCreation, MemberRef, MemberType, TicketStartMode } from './project';
+export type TicketStatus = 'backlog' | 'todo' | 'doing' | 'review' | 'done';
+export type TicketPriority = 'low' | 'medium' | 'high';
+export type Ticket = {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    number: number;
+    /** Clé du projet suivie du numéro (BRN-142), unique dans l'organisation. */
+    key: string;
+    title: string;
+    description: string | null;
+    status: TicketStatus;
+    priority: TicketPriority;
+    labels: string[];
+    dueDate: string | null;
+    /** Relecteur optionnel : avec lui, le ticket passe par `review` avant `done`. */
+    reviewer: MemberRef | null;
+    createdBy: ActorRef;
+    /** Conversation dont le ticket est issu, quand un agent l'a proposé. */
+    sourceConversationId: string | null;
+    /** Ordre dans la colonne, croissant. */
+    position: number;
+    /** Compteurs entretenus à l'écriture, pour ne pas compter à chaque lecture du board. */
+    commentCount: number;
+    artifactCount: number;
+    doneAt: string | null;
+    /** Dernier commentaire, changement de statut ou d'assignation ; sert au tri de la liste. */
+    lastActivityAt: string;
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * Où en est un assigné : `assigned` (pas commencé), `held` (attend le feu vert), `working`,
+ * `waiting` (attend une réponse humaine), `blocked`, `done`.
+ */
+export type TicketAssigneeState = 'assigned' | 'held' | 'working' | 'waiting' | 'blocked' | 'done';
+export type TicketAssignee = {
+    ticketId: string;
+    type: MemberType;
+    id: string;
+    state: TicketAssigneeState;
+    stateNote: string | null;
+    updatedAt: string;
+};
+/**
+ * `comment` et `report` sont écrits par un humain ou un agent, `question` porte une question
+ * d'agent à un humain, `event` est une trace (création, statut, assignation…).
+ */
+export type TicketEventKind = 'comment' | 'report' | 'question' | 'event';
+export type TicketEvent = {
+    id: string;
+    ticketId: string;
+    organizationId: string;
+    author: ActorRef;
+    kind: TicketEventKind;
+    body: string | null;
+    /**
+     * Selon le type : `event` → `{ action, from?, to?, member? }`, `report` → `{ title }`,
+     * `question` → `{ humanRequest: TicketQuestion }` ; les mentions dans `{ mentions: MemberRef[] }`.
+     */
+    data: Record<string, unknown>;
+    artifactIds: string[];
+    createdAt: string;
+};
+export type TicketArtifact = {
+    id: string;
+    ticketId: string;
+    organizationId: string;
+    name: string;
+    mimeType: string;
+    size: number | null;
+    /** `file` : téléversé dans le stockage de fichiers ; `workspace` : fichier du workspace d'un agent. */
+    source: 'file' | 'workspace';
+    status: 'uploading' | 'ready';
+    /**
+     * Clé dans le stockage de fichiers. Un fichier du workspace d'un agent y est recopié au moment
+     * où il est joint : l'artefact reste tel qu'il était, même si l'agent réécrit le fichier ensuite.
+     */
+    fileKey: string;
+    /** D'où vient un artefact `workspace` : la conversation de l'agent et le chemin du fichier. */
+    workspaceRef: {
+        conversationId: string | null;
+        path: string;
+    } | null;
+    addedBy: ActorRef;
+    createdAt: string;
+};
+export type TicketProposalStatus = 'pending' | 'accepted' | 'rejected' | 'cancelled';
+export type TicketProposalPayload = {
+    title: string;
+    description: string | null;
+    assignees: MemberRef[];
+    reviewer: MemberRef | null;
+    priority: TicketPriority;
+    startMode: TicketStartMode;
+    /** Fichiers du workspace de la session à joindre comme artefacts. */
+    workspacePaths: string[];
+};
+/** Un ticket qu'un agent propose (ou crée directement) depuis une conversation. */
+export type TicketProposal = {
+    id: string;
+    organizationId: string;
+    conversationId: string;
+    messageId: string;
+    agentId: string;
+    /** Projet proposé par l'agent ; null = l'humain doit en choisir un. */
+    projectId: string | null;
+    mode: AgentTicketCreation;
+    payload: TicketProposalPayload;
+    status: TicketProposalStatus;
+    ticketId: string | null;
+    decidedBy: string | null;
+    decidedAt: string | null;
+    createdAt: string;
+};
+export type TicketQuestionStatus = 'pending' | 'answered' | 'declined' | 'expired';
+/** Question posée par un agent pendant son travail sur un ticket (Human_ask), dans `data.humanRequest`. */
+export type TicketQuestion = {
+    callId: string;
+    status: TicketQuestionStatus;
+    /** L'humain à qui la question est posée ; lui seul y répond. */
+    targetUserId: string;
+    options?: string[];
+    context?: string | null;
+    expiresAt?: string | null;
+    answer?: string | null;
+    /** Nom ou adresse de qui a tranché, tel qu'il était à ce moment. */
+    answeredBy?: string | null;
+    answeredAt?: string | null;
+};
+export type TicketPlanStepStatus = 'todo' | 'doing' | 'done';
+export type TicketAgentPlan = {
+    steps: {
+        title: string;
+        status: TicketPlanStepStatus;
+    }[];
+    updatedAt: string;
+};
+/**
+ * La session de travail d'un agent sur un ticket : une conversation de type `task`, reprise à
+ * chaque réveil. Une seule par ticket et par agent.
+ */
+export type TicketAgentSession = {
+    ticketId: string;
+    agentId: string;
+    organizationId: string;
+    projectId: string;
+    conversationId: string;
+    /** L'humain au nom duquel l'agent travaille : celui qui a lancé le travail. */
+    userId: string | null;
+    plan: TicketAgentPlan | null;
+    /** Date du dernier événement du ticket transmis à l'agent : les suivants sont nouveaux pour lui. */
+    eventCursor: string | null;
+    /**
+     * Réponse de l'agent au dernier réveil : une question y suspend le tour, et la réponse de
+     * l'humain le reprend sur ce même message. Son statut dit si l'agent travaille encore.
+     */
+    lastMessageId: string | null;
+    /** Taille du prompt au dernier réveil, pour l'occupation du contexte sans relire la conversation. */
+    lastPromptTokens: number | null;
+    createdAt: string;
+    lastRunAt: string | null;
+};
+export type TicketWakeupReasonKind = 'assigned' | 'go_ahead' | 'reopened' | 'changes_requested' | 'comment' | 'mention';
+export type TicketWakeupReason = {
+    kind: TicketWakeupReasonKind;
+    eventId?: string | null;
+    by: ActorRef;
+    at: string;
+};
+export type TicketWakeupStatus = 'pending' | 'running' | 'done' | 'skipped' | 'error';
+/** Un réveil d'agent : les raisons de se remettre au travail, regroupées tant qu'il attend. */
+export type TicketWakeup = {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    ticketId: string;
+    agentId: string;
+    /** L'humain qui a lancé le travail ; il devient l'utilisateur d'une nouvelle session. */
+    userId: string | null;
+    reasons: TicketWakeupReason[];
+    status: TicketWakeupStatus;
+    /** Pas avant cette date : le délai de regroupement, puis les reports. */
+    queuedAt: string;
+    attempts: number;
+    claimedAt: string | null;
+    claimedBy: string | null;
+    error: string | null;
+    createdAt: string;
+    updatedAt: string;
+};

package/dist/types/ticket.js

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

package/package.json

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

package/src/types/conversation.ts

@@ -1,5 +1,7 @@
 import { ChatMessageRoleUio } from '@breign/client';
 import type { ToolCallApprovalScope } from './pending-tool-call';
+import type { AgentTicketCreation } from './project';
+import type { TicketProposalPayload, TicketProposalStatus } from './ticket';
 import type { ToolAction, ToolResult } from './tool-result';
 
 export type ConversationMessageReaction = 'positive' | 'negative';
@@ -120,6 +122,21 @@ export type ConversationHumanRequest = {
   expiresAt?: string;
 };
 
+/**
+ * Un ticket qu'un agent propose depuis cette conversation (outil `Ticket_create`). La carte affichée
+ * sous le message se met à jour quand la proposition est acceptée, écartée ou annulée.
+ */
+export type ConversationTicketProposal = {
+  proposalId: string;
+  status: TicketProposalStatus;
+  mode: AgentTicketCreation;
+  /** Projet proposé par l'agent ; null = l'humain doit en choisir un. */
+  projectId: string | null;
+  payload: TicketProposalPayload;
+  ticketId: string | null;
+  ticketKey: string | null;
+};
+
 export type ConversationMessage = {
   id: string;
   role: ChatMessageRoleUio;
@@ -136,6 +153,8 @@ export type ConversationMessage = {
   approvals?: ConversationMessageApproval[];
   /** Question posée à l'humain par une tâche. Voir ConversationHumanRequest. */
   humanRequest?: ConversationHumanRequest;
+  /** Ticket proposé par l'agent dans ce message. Voir ConversationTicketProposal. */
+  ticketProposal?: ConversationTicketProposal;
   suggestions?: {
     id: string;
     text: string;
@@ -176,6 +195,8 @@ export type ConversationContext = {
   lastActivityAt?: string;
   /** Tâche ouverte par un agent local via le serveur MCP de Breign. */
   externalCaller?: ConversationExternalCaller;
+  /** Ticket auquel cette conversation est liée (proposition acceptée, session de travail). */
+  ticket?: { ticketId: string; projectId: string };
 };
 
 export type ConversationExternalCaller = {

package/src/types/inbox.ts

@@ -0,0 +1,29 @@
+import type { ActorRef } from './project';
+
+/**
+ * `question`, `ticket_proposal`, `review` et `go_ahead` sont des actions (onglet « À traiter ») ;
+ * `mention` a son propre onglet.
+ */
+export type InboxItemKind = 'question' | 'ticket_proposal' | 'review' | 'go_ahead' | 'mention';
+
+/** Ce qui attend un humain : écrit quand l'action naît, résolu quand elle est faite. */
+export type InboxItem = {
+  id: string;
+  organizationId: string;
+  userId: string;
+  kind: InboxItemKind;
+  requestedBy: ActorRef;
+  projectId: string | null;
+  ticketId: string | null;
+  /**
+   * Objet visé : `callId` d'une question, `proposalId` d'une proposition, événement d'une mention,
+   * ticket d'une relecture, ticket d'un feu vert (avec l'agent dans `data.agentId`).
+   */
+  refId: string;
+  summary: string;
+  data: Record<string, unknown>;
+  status: 'pending' | 'done';
+  resolution: Record<string, unknown> | null;
+  createdAt: string;
+  resolvedAt: string | null;
+};

package/src/types/index.ts

@@ -8,16 +8,19 @@ export * from './engine';
 export * from './file';
 export * from './flow';
 export * from './flow-editor';
+export * from './inbox';
 export * from './knowledge';
 export * from './ocr';
 export * from './organization';
 export * from './pending-tool-call';
+export * from './project';
 export * from './permissions';
 export * from './role';
 export * from './scheduled-task';
 export * from './scheduled-task-run';
 export * from './skill';
 export * from './speech-to-text';
+export * from './ticket';
 export * from './tool';
 export * from './tool-approval';
 export * from './tool-result';

package/src/types/project.ts

@@ -0,0 +1,65 @@
+/** Auteur ou destinataire d'une action : un humain, un agent ou le système. */
+export type ActorType = 'user' | 'agent' | 'system';
+
+/** Membre d'un projet ou assigné d'un ticket : un humain ou un agent. */
+export type MemberType = 'user' | 'agent';
+
+export type ActorRef = {
+  type: ActorType;
+  /** Identifiant de l'utilisateur ou de l'agent ; null pour le système. */
+  id: string | null;
+};
+
+export type MemberRef = {
+  type: MemberType;
+  id: string;
+};
+
+/**
+ * Ce qui se passe quand un agent crée un ticket : `confirm`, l'agent propose et un humain confirme ;
+ * `direct`, le ticket est créé tout de suite et la création reste annulable.
+ */
+export type AgentTicketCreation = 'confirm' | 'direct';
+
+/** `now` : les agents assignés commencent dès l'assignation ; `hold` : ils attendent un feu vert. */
+export type TicketStartMode = 'now' | 'hold';
+
+export type ProjectSettings = {
+  agentTicketCreation: AgentTicketCreation;
+  defaultStartMode: TicketStartMode;
+  /**
+   * Les agents assignés se mettent au travail d'eux-mêmes quand on leur confie le ticket ou qu'on
+   * leur parle. Absent = activé.
+   */
+  agentsAutoWork?: boolean;
+};
+
+export type Project = {
+  id: string;
+  organizationId: string;
+  /** Préfixe des identifiants de tickets (BRN donne BRN-142), unique dans l'organisation. */
+  key: string;
+  name: string;
+  description: string | null;
+  color: string | null;
+  dueDate: string | null;
+  settings: ProjectSettings;
+  /** Dernier numéro de ticket attribué ; incrémenté à chaque création. */
+  ticketSeq: number;
+  archivedAt: string | null;
+  createdBy: ActorRef;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type ProjectMemberRole = 'owner' | 'member';
+
+export type ProjectMember = {
+  projectId: string;
+  type: MemberType;
+  id: string;
+  role: ProjectMemberRole;
+  /** Pour un agent, surcharge `ProjectSettings.agentTicketCreation` ; null = réglage du projet. */
+  agentTicketCreation: AgentTicketCreation | null;
+  createdAt: string;
+};

package/src/types/ticket.ts

@@ -0,0 +1,218 @@
+import type {
+  ActorRef,
+  AgentTicketCreation,
+  MemberRef,
+  MemberType,
+  TicketStartMode,
+} from './project';
+
+export type TicketStatus = 'backlog' | 'todo' | 'doing' | 'review' | 'done';
+
+export type TicketPriority = 'low' | 'medium' | 'high';
+
+export type Ticket = {
+  id: string;
+  organizationId: string;
+  projectId: string;
+  number: number;
+  /** Clé du projet suivie du numéro (BRN-142), unique dans l'organisation. */
+  key: string;
+  title: string;
+  description: string | null;
+  status: TicketStatus;
+  priority: TicketPriority;
+  labels: string[];
+  dueDate: string | null;
+  /** Relecteur optionnel : avec lui, le ticket passe par `review` avant `done`. */
+  reviewer: MemberRef | null;
+  createdBy: ActorRef;
+  /** Conversation dont le ticket est issu, quand un agent l'a proposé. */
+  sourceConversationId: string | null;
+  /** Ordre dans la colonne, croissant. */
+  position: number;
+  /** Compteurs entretenus à l'écriture, pour ne pas compter à chaque lecture du board. */
+  commentCount: number;
+  artifactCount: number;
+  doneAt: string | null;
+  /** Dernier commentaire, changement de statut ou d'assignation ; sert au tri de la liste. */
+  lastActivityAt: string;
+  createdAt: string;
+  updatedAt: string;
+};
+
+/**
+ * Où en est un assigné : `assigned` (pas commencé), `held` (attend le feu vert), `working`,
+ * `waiting` (attend une réponse humaine), `blocked`, `done`.
+ */
+export type TicketAssigneeState = 'assigned' | 'held' | 'working' | 'waiting' | 'blocked' | 'done';
+
+export type TicketAssignee = {
+  ticketId: string;
+  type: MemberType;
+  id: string;
+  state: TicketAssigneeState;
+  stateNote: string | null;
+  updatedAt: string;
+};
+
+/**
+ * `comment` et `report` sont écrits par un humain ou un agent, `question` porte une question
+ * d'agent à un humain, `event` est une trace (création, statut, assignation…).
+ */
+export type TicketEventKind = 'comment' | 'report' | 'question' | 'event';
+
+export type TicketEvent = {
+  id: string;
+  ticketId: string;
+  organizationId: string;
+  author: ActorRef;
+  kind: TicketEventKind;
+  body: string | null;
+  /**
+   * Selon le type : `event` → `{ action, from?, to?, member? }`, `report` → `{ title }`,
+   * `question` → `{ humanRequest: TicketQuestion }` ; les mentions dans `{ mentions: MemberRef[] }`.
+   */
+  data: Record<string, unknown>;
+  artifactIds: string[];
+  createdAt: string;
+};
+
+export type TicketArtifact = {
+  id: string;
+  ticketId: string;
+  organizationId: string;
+  name: string;
+  mimeType: string;
+  size: number | null;
+  /** `file` : téléversé dans le stockage de fichiers ; `workspace` : fichier du workspace d'un agent. */
+  source: 'file' | 'workspace';
+  status: 'uploading' | 'ready';
+  /**
+   * Clé dans le stockage de fichiers. Un fichier du workspace d'un agent y est recopié au moment
+   * où il est joint : l'artefact reste tel qu'il était, même si l'agent réécrit le fichier ensuite.
+   */
+  fileKey: string;
+  /** D'où vient un artefact `workspace` : la conversation de l'agent et le chemin du fichier. */
+  workspaceRef: { conversationId: string | null; path: string } | null;
+  addedBy: ActorRef;
+  createdAt: string;
+};
+
+export type TicketProposalStatus = 'pending' | 'accepted' | 'rejected' | 'cancelled';
+
+export type TicketProposalPayload = {
+  title: string;
+  description: string | null;
+  assignees: MemberRef[];
+  reviewer: MemberRef | null;
+  priority: TicketPriority;
+  startMode: TicketStartMode;
+  /** Fichiers du workspace de la session à joindre comme artefacts. */
+  workspacePaths: string[];
+};
+
+/** Un ticket qu'un agent propose (ou crée directement) depuis une conversation. */
+export type TicketProposal = {
+  id: string;
+  organizationId: string;
+  conversationId: string;
+  messageId: string;
+  agentId: string;
+  /** Projet proposé par l'agent ; null = l'humain doit en choisir un. */
+  projectId: string | null;
+  mode: AgentTicketCreation;
+  payload: TicketProposalPayload;
+  status: TicketProposalStatus;
+  ticketId: string | null;
+  decidedBy: string | null;
+  decidedAt: string | null;
+  createdAt: string;
+};
+
+export type TicketQuestionStatus = 'pending' | 'answered' | 'declined' | 'expired';
+
+/** Question posée par un agent pendant son travail sur un ticket (Human_ask), dans `data.humanRequest`. */
+export type TicketQuestion = {
+  callId: string;
+  status: TicketQuestionStatus;
+  /** L'humain à qui la question est posée ; lui seul y répond. */
+  targetUserId: string;
+  options?: string[];
+  context?: string | null;
+  expiresAt?: string | null;
+  answer?: string | null;
+  /** Nom ou adresse de qui a tranché, tel qu'il était à ce moment. */
+  answeredBy?: string | null;
+  answeredAt?: string | null;
+};
+
+export type TicketPlanStepStatus = 'todo' | 'doing' | 'done';
+
+export type TicketAgentPlan = {
+  steps: { title: string; status: TicketPlanStepStatus }[];
+  updatedAt: string;
+};
+
+/**
+ * La session de travail d'un agent sur un ticket : une conversation de type `task`, reprise à
+ * chaque réveil. Une seule par ticket et par agent.
+ */
+export type TicketAgentSession = {
+  ticketId: string;
+  agentId: string;
+  organizationId: string;
+  projectId: string;
+  conversationId: string;
+  /** L'humain au nom duquel l'agent travaille : celui qui a lancé le travail. */
+  userId: string | null;
+  plan: TicketAgentPlan | null;
+  /** Date du dernier événement du ticket transmis à l'agent : les suivants sont nouveaux pour lui. */
+  eventCursor: string | null;
+  /**
+   * Réponse de l'agent au dernier réveil : une question y suspend le tour, et la réponse de
+   * l'humain le reprend sur ce même message. Son statut dit si l'agent travaille encore.
+   */
+  lastMessageId: string | null;
+  /** Taille du prompt au dernier réveil, pour l'occupation du contexte sans relire la conversation. */
+  lastPromptTokens: number | null;
+  createdAt: string;
+  lastRunAt: string | null;
+};
+
+export type TicketWakeupReasonKind =
+  | 'assigned'
+  | 'go_ahead'
+  | 'reopened'
+  | 'changes_requested'
+  | 'comment'
+  | 'mention';
+
+export type TicketWakeupReason = {
+  kind: TicketWakeupReasonKind;
+  eventId?: string | null;
+  by: ActorRef;
+  at: string;
+};
+
+export type TicketWakeupStatus = 'pending' | 'running' | 'done' | 'skipped' | 'error';
+
+/** Un réveil d'agent : les raisons de se remettre au travail, regroupées tant qu'il attend. */
+export type TicketWakeup = {
+  id: string;
+  organizationId: string;
+  projectId: string;
+  ticketId: string;
+  agentId: string;
+  /** L'humain qui a lancé le travail ; il devient l'utilisateur d'une nouvelle session. */
+  userId: string | null;
+  reasons: TicketWakeupReason[];
+  status: TicketWakeupStatus;
+  /** Pas avant cette date : le délai de regroupement, puis les reports. */
+  queuedAt: string;
+  attempts: number;
+  claimedAt: string | null;
+  claimedBy: string | null;
+  error: string | null;
+  createdAt: string;
+  updatedAt: string;
+};