@breign/db-schemas 0.1.72 → 0.1.74

package/dist/types/agent.d.ts

@@ -47,6 +47,8 @@ export type Agent = {
     sandboxConfiguration?: AgentSandboxConfiguration;
     computerUseConfiguration?: AgentComputerUseConfiguration;
     agentCallConfiguration?: AgentCallConfiguration;
+    mcpExposureConfiguration?: AgentMcpExposureConfiguration;
+    humanEscalationConfiguration?: AgentHumanEscalationConfiguration;
     codeModeConfiguration?: AgentCodeModeConfiguration;
     speechToText?: SpeechToTextConfig;
 };
@@ -70,6 +72,24 @@ export type AgentCallConfiguration = {
     enabled?: boolean;
     allowedAgentIds?: string[];
 };
+/**
+ * Reachability from local agents (Claude Code, Pi, Hermes…) through Breign's MCP server.
+ * Opt-in: an agent nobody exposed stays invisible to `list_agents` and refuses `ask_agent`.
+ */
+export type AgentMcpExposureConfiguration = {
+    enabled?: boolean;
+};
+/**
+ * Human_ask tool, offered only in task conversations (a local agent or another agent asking).
+ * The question goes to the first valid referent; without one, to the user who owns the task —
+ * the person who connected the local agent.
+ */
+export type AgentHumanEscalationConfiguration = {
+    enabled?: boolean;
+    referentUserIds?: string[];
+    /** How long a question stays answerable. Past it, the agent resumes on its own assumption. */
+    questionTtlHours?: number;
+};
 export type AgentCodeModeConfiguration = {
     enabled?: boolean;
 };

package/dist/types/conversation.d.ts

@@ -85,6 +85,33 @@ export type ConversationMessageApproval = {
     /** Quand la décision a été prise, ISO. */
     at: string;
 };
+/**
+ * Une question qu'un agent pose à un humain depuis une conversation de tâche (outil `Human_ask`).
+ *
+ * Portée par un message-miroir déposé dans la conversation `chat` de l'humain avec cet agent : c'est
+ * là qu'il la voit et y répond. La tâche, elle, reste suspendue sur l'appel différé `callId` ; la
+ * réponse termine cet appel et relance le tour de la tâche.
+ */
+export type ConversationHumanRequest = {
+    /** L'appel différé (`PendingToolCall.id`, outil `Human_ask`) que la réponse termine. */
+    callId: string;
+    taskConversationId: string;
+    taskMessageId: string;
+    question: string;
+    options?: string[];
+    /** Ce qui bloque et pourquoi, tel que formulé par l'agent. */
+    context?: string;
+    requestedBy: {
+        kind: 'local_agent' | 'agent';
+        label?: string;
+    };
+    status: 'pending' | 'answered' | 'declined' | 'expired';
+    answer?: string;
+    /** Nom ou e-mail de la personne qui a répondu, figé à cet instant. */
+    answeredBy?: string;
+    answeredAt?: string;
+    expiresAt?: string;
+};
 export type ConversationMessage = {
     id: string;
     role: ChatMessageRoleUio;
@@ -104,6 +131,8 @@ export type ConversationMessage = {
     }[];
     /** Décisions d'autorisation prises pendant ce message. Voir ConversationMessageApproval. */
     approvals?: ConversationMessageApproval[];
+    /** Question posée à l'humain par une tâche. Voir ConversationHumanRequest. */
+    humanRequest?: ConversationHumanRequest;
     suggestions?: {
         id: string;
         text: string;
@@ -144,6 +173,16 @@ export type ConversationContext = {
     };
     custom?: Record<string, string>;
     lastActivityAt?: string;
+    /** Tâche ouverte par un agent local via le serveur MCP de Breign. */
+    externalCaller?: ConversationExternalCaller;
+};
+export type ConversationExternalCaller = {
+    kind: 'local_agent';
+    /** Le propriétaire du token : seul lui peut relancer ou lire cette tâche via MCP. */
+    userId: string;
+    /** Nom annoncé par le client MCP (ex. « claude-code »). */
+    clientName?: string;
+    openedAt: string;
 };
 export type Conversation = {
     id: string;

package/dist/types/tool-result.d.ts

@@ -8,9 +8,16 @@ import type { ConversationAttachment } from './conversation';
 export type ToolAction = {
     code: string;
 } & Record<string, unknown>;
+export type ImageRef = {
+    source: 'kb' | 'conversation';
+    fileId: string;
+    imageId: string;
+    alt: string;
+};
 export type ToolResult = {
     text: string;
     attachments?: ConversationAttachment[];
+    imageRefs?: ImageRef[];
     askConfirmation?: boolean;
     confirmationLink?: string;
     actions?: ToolAction[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breign/db-schemas",
-  "version": "0.1.72",
+  "version": "0.1.74",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -14,7 +14,7 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@breign/client": "1.0.156",
+    "@breign/client": "1.0.158",
     "prettier": "^3.5.3",
     "zx": "^8.5.5"
   }

package/src/types/agent.ts

@@ -40,6 +40,8 @@ export type Agent = {
   sandboxConfiguration?: AgentSandboxConfiguration;
   computerUseConfiguration?: AgentComputerUseConfiguration;
   agentCallConfiguration?: AgentCallConfiguration;
+  mcpExposureConfiguration?: AgentMcpExposureConfiguration;
+  humanEscalationConfiguration?: AgentHumanEscalationConfiguration;
   codeModeConfiguration?: AgentCodeModeConfiguration;
   speechToText?: SpeechToTextConfig;
 };
@@ -67,6 +69,27 @@ export type AgentCallConfiguration = {
   enabled?: boolean;
   allowedAgentIds?: string[];
 };
+
+/**
+ * Reachability from local agents (Claude Code, Pi, Hermes…) through Breign's MCP server.
+ * Opt-in: an agent nobody exposed stays invisible to `list_agents` and refuses `ask_agent`.
+ */
+export type AgentMcpExposureConfiguration = {
+  enabled?: boolean;
+};
+
+/**
+ * Human_ask tool, offered only in task conversations (a local agent or another agent asking).
+ * The question goes to the first valid referent; without one, to the user who owns the task —
+ * the person who connected the local agent.
+ */
+export type AgentHumanEscalationConfiguration = {
+  enabled?: boolean;
+  referentUserIds?: string[];
+  /** How long a question stays answerable. Past it, the agent resumes on its own assumption. */
+  questionTtlHours?: number;
+};
+
 export type AgentCodeModeConfiguration = {
   enabled?: boolean;
 };

package/src/types/conversation.ts

@@ -95,6 +95,31 @@ export type ConversationMessageApproval = {
   at: string;
 };
 
+/**
+ * Une question qu'un agent pose à un humain depuis une conversation de tâche (outil `Human_ask`).
+ *
+ * Portée par un message-miroir déposé dans la conversation `chat` de l'humain avec cet agent : c'est
+ * là qu'il la voit et y répond. La tâche, elle, reste suspendue sur l'appel différé `callId` ; la
+ * réponse termine cet appel et relance le tour de la tâche.
+ */
+export type ConversationHumanRequest = {
+  /** L'appel différé (`PendingToolCall.id`, outil `Human_ask`) que la réponse termine. */
+  callId: string;
+  taskConversationId: string;
+  taskMessageId: string;
+  question: string;
+  options?: string[];
+  /** Ce qui bloque et pourquoi, tel que formulé par l'agent. */
+  context?: string;
+  requestedBy: { kind: 'local_agent' | 'agent'; label?: string };
+  status: 'pending' | 'answered' | 'declined' | 'expired';
+  answer?: string;
+  /** Nom ou e-mail de la personne qui a répondu, figé à cet instant. */
+  answeredBy?: string;
+  answeredAt?: string;
+  expiresAt?: string;
+};
+
 export type ConversationMessage = {
   id: string;
   role: ChatMessageRoleUio;
@@ -109,6 +134,8 @@ export type ConversationMessage = {
   }[];
   /** Décisions d'autorisation prises pendant ce message. Voir ConversationMessageApproval. */
   approvals?: ConversationMessageApproval[];
+  /** Question posée à l'humain par une tâche. Voir ConversationHumanRequest. */
+  humanRequest?: ConversationHumanRequest;
   suggestions?: {
     id: string;
     text: string;
@@ -147,6 +174,17 @@ export type ConversationContext = {
   };
   custom?: Record<string, string>;
   lastActivityAt?: string;
+  /** Tâche ouverte par un agent local via le serveur MCP de Breign. */
+  externalCaller?: ConversationExternalCaller;
+};
+
+export type ConversationExternalCaller = {
+  kind: 'local_agent';
+  /** Le propriétaire du token : seul lui peut relancer ou lire cette tâche via MCP. */
+  userId: string;
+  /** Nom annoncé par le client MCP (ex. « claude-code »). */
+  clientName?: string;
+  openedAt: string;
 };
 
 export type Conversation = {

package/src/types/tool-result.ts

@@ -10,9 +10,17 @@ export type ToolAction = {
   code: string;
 } & Record<string, unknown>;
 
+export type ImageRef = {
+  source: 'kb' | 'conversation';
+  fileId: string;
+  imageId: string;
+  alt: string;
+};
+
 export type ToolResult = {
   text: string;
   attachments?: ConversationAttachment[];
+  imageRefs?: ImageRef[];
   askConfirmation?: boolean;
   confirmationLink?: string;
   actions?: ToolAction[];