@breign/db-schemas 0.1.76 → 0.1.78

package/dist/types/project.d.ts

@@ -16,11 +16,23 @@ export type MemberRef = {
  * `direct`, le ticket est créé tout de suite et la création reste annulable.
  */
 export type AgentTicketCreation = 'confirm' | 'direct';
+/**
+ * Ce qui se passe quand un agent assigne un autre agent du projet à un ticket : `confirm`, l'agent
+ * assigné attend le feu vert d'un responsable humain ; `direct`, il se met au travail tout de suite.
+ */
+export type AgentAssignment = '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;
+    /** Assignation d'un agent par un autre agent. Absent = `confirm`. */
+    agentAssignment?: AgentAssignment;
 };
 export type Project = {
     id: string;

package/dist/types/ticket.d.ts

@@ -57,7 +57,7 @@ export type TicketEvent = {
     body: string | null;
     /**
      * Selon le type : `event` → `{ action, from?, to?, member? }`, `report` → `{ title }`,
-     * `question` → `{ humanRequest }` ; les mentions dans `{ mentions: MemberRef[] }`.
+     * `question` → `{ humanRequest: TicketQuestion }` ; les mentions dans `{ mentions: MemberRef[] }`.
      */
     data: Record<string, unknown>;
     artifactIds: string[];
@@ -114,3 +114,79 @@ export type TicketProposal = {
     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/package.json

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

package/src/types/project.ts

@@ -21,12 +21,25 @@ export type MemberRef = {
  */
 export type AgentTicketCreation = 'confirm' | 'direct';
 
+/**
+ * Ce qui se passe quand un agent assigne un autre agent du projet à un ticket : `confirm`, l'agent
+ * assigné attend le feu vert d'un responsable humain ; `direct`, il se met au travail tout de suite.
+ */
+export type AgentAssignment = '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;
+  /** Assignation d'un agent par un autre agent. Absent = `confirm`. */
+  agentAssignment?: AgentAssignment;
 };
 
 export type Project = {

package/src/types/ticket.ts

@@ -70,7 +70,7 @@ export type TicketEvent = {
   body: string | null;
   /**
    * Selon le type : `event` → `{ action, from?, to?, member? }`, `report` → `{ title }`,
-   * `question` → `{ humanRequest }` ; les mentions dans `{ mentions: MemberRef[] }`.
+   * `question` → `{ humanRequest: TicketQuestion }` ; les mentions dans `{ mentions: MemberRef[] }`.
    */
   data: Record<string, unknown>;
   artifactIds: string[];
@@ -128,3 +128,91 @@ export type TicketProposal = {
   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;
+};