@agifyai/leadify-mcp 9.7.1 → 9.8.0

package/README.md

@@ -505,7 +505,8 @@ moment pour une personne, avec au plus un message Gmail et un message ou une
 invitation LinkedIn. Aucune séquence ni étape future. Le MCP ne contacte jamais
 Gmail ou Unipile pour envoyer : Leadify contrôle et exécute les dépôts acceptés.
 
-`get_mcp_runtime_info` annonce les 16 capacités du paquet et les versions serveur
+`get_mcp_runtime_info` annonce les 30 capacités du paquet, les 13 modules du
+contexte de rédaction (`outreach.contextModules`) et les versions serveur
 attendues. `probe_outreach: true` vérifie en plus le contrat des programmes dans
 l'organisation choisie, sans lire de prospect. `PROGRAM_CONTRACT_VERIFIED` ne
 prouve ni les autres routes ni une autorisation commerciale. Chaque réponse
@@ -533,7 +534,9 @@ Les tests de contrat et de transport sont dans `test/agent-outreach.test.mjs` ;
 | Sélection avant pagination | `query_outreach_prospects` | R | POST A/prospects/query | filtres complets, pages, erreurs |
 | Résumé d'une personne | `get_outreach_prospect_summary` | R | GET A/prospects/:leadId | identité explicite |
 | Historique des contacts | `get_outreach_contact_history` | R | GET A/contacts/:leadId | comptes accessibles, couverture |
-| Contexte frais de rédaction | `get_outreach_prospect_context` | R | GET C/people/:leadId/context | contrat, versions, état prêt ou attente |
+| Contexte de rédaction, entrée légère | `get_outreach_context_summary` | R | GET C/people/:leadId/context/summary | versions, état prêt ou attente, 13 modules avec taille et empreinte, `decisionContext` |
+| Contexte de rédaction, un module | `get_outreach_context_<module>` (13 outils) | R | GET C/people/:leadId/context/modules/:module | module, empreinte, `readAt`, curseur pour `signals` et `history` |
+| Contexte entier (ancien) | `get_outreach_prospect_context` | R | GET C/people/:leadId/context | contrat, versions ; environ 90 Ko, à éviter |
 | Fil exact | `get_outreach_thread` | R | GET C/people/:leadId/thread | account_key, thread_id, curseur |
 | Décisions présentes | `submit_outreach_messages` | W | POST A/messages/batch | schéma, texte intact, reprises, lot partiel |
 | Messages de cette clé | `list_outreach_messages` | read + organisation | GET A/messages | pagination, projection sûre |
@@ -587,10 +590,55 @@ droits est refusé ; aucun redémarrage caché n'a lieu. Programmes, messages et
 conversations utilisent `after_id` pour leur page suivante. Les événements et les
 fils utilisent `cursor`. Les curseurs sont opaques et ne doivent pas être inventés.
 
-`get_outreach_prospect_summary` est un résumé. Avant d'écrire, lire
-`get_outreach_prospect_context`, vérifier `readiness.ready`, puis les fils exacts
-nécessaires avec `get_outreach_thread`. Un corps indisponible ou un simple extrait
-ne vaut pas une conversation complète. Le contexte n'effectue aucune qualification.
+`get_outreach_prospect_summary` est un résumé de la sélection, pas le contexte de
+rédaction. Avant d'écrire, lire `get_outreach_context_summary`, vérifier
+`readiness.ready`, puis chaque module dans l'ordre de `readOrder`, puis les fils
+exacts nécessaires avec `get_outreach_thread`. Un corps indisponible ou un simple
+extrait ne vaut pas une conversation complète. Le contexte n'effectue aucune
+qualification.
+
+#### Contexte de rédaction par modules (PRD-2632)
+
+La lecture entière `get_outreach_prospect_context` pèse près de 90 Ko. Un agent dont
+l'exécution écarte tout résultat d'outil de plus de 50 000 caractères (Hermès) ne la
+voit jamais. Elle est conservée mais déconseillée : lire le sommaire, puis un module
+à la fois. Toutes ces réponses sont en JSON compact, sur une seule ligne.
+
+`get_outreach_context_summary` rend, en quelques Ko : les identifiants, `readiness`,
+les huit `versions`, `contextVersion`, `factsVersion`, `readAt`, `readOrder`, la liste
+des treize modules (`module`, `version` = empreinte, `characters`, `pages`, `purpose`),
+les `warnings` (module trop grand, historique incomplet) et `decisionContext`, le bloc
+à recopier dans le `context` de chaque décision déposée.
+
+Les treize outils `get_outreach_context_<module>`, dans l'ordre de lecture utile :
+
+| Module | Contenu | Pages |
+|---|---|---|
+| `prospect` | identité, coordonnées, langue, poste | 1 |
+| `company` | employeur et fiches entreprise qualifiées | 1 |
+| `workspace` | choix du groupe : persona, verticale, offre, expéditeur, appel à l'action | 1 |
+| `company_brain` | Company Brain de l'organisation qui prospecte | 1 |
+| `vertical` | verticale du persona | 1 |
+| `offers` | offre retenue (trois au plus) | 1 |
+| `persona` | persona et son contrat de rédaction | 1 |
+| `playbook` | playbook commercial publié | 1 |
+| `qualification` | fiche de qualification de la personne | 1 |
+| `signals` | signaux récents, le plus récent d'abord | curseur |
+| `history` | messages échangés avec leur texte, fils connus | curseur |
+| `crm` | statut CRM, exclusion, réception, prise en main humaine | 1 |
+| `authorization` | état du programme, plafonds, expéditeurs, droits | 1 |
+
+Chaque réponse contient `module`, `version` (l'empreinte du module), `readAt`, `data`
+et `page` (null, ou `nextCursor` à repasser tel quel dans `cursor`). Un module paginé
+rend son en-tête avec la première page seulement ; une page tient sous environ
+25 000 caractères. Si `version` diffère de celle du sommaire, le contexte a changé
+entre deux lectures : repartir du sommaire. Un curseur lié à une empreinte périmée est
+refusé (`VERSION_CONFLICT`).
+
+Au dépôt, `context.modules` reprend `decisionContext.modules` à l'identique (les treize
+empreintes). Il est facultatif pour les anciens clients et strict quand il est présent.
+Les huit `versions` restent obligatoires. Si une empreinte a bougé depuis la lecture,
+Leadify refuse avec `CONTEXT_STALE` et nomme les modules (`CONTEXT_MODULE_CHANGED:<module>`).
 
 ### Dépôt et reprise
 
@@ -601,7 +649,9 @@ et `messages` (1 à 2, un par canal).
 
 Le contexte transmis comporte `contract_version: "agent-writing-context.v1"`,
 `context_version`, `facts_version`, `read_at` et l'objet `versions` exact reçu du
-serveur. Les clés de cet objet restent inchangées, dont `contactState`. Un message
+serveur. Les clés de cet objet restent inchangées, dont `contactState`. Quand la
+rédaction vient du contexte par modules, `modules` (les treize empreintes de
+`decisionContext.modules`) l'accompagne. Un message
 contient `channel`, `action`, `sender_id`, `account_key`, `recipient`, `subject`,
 `body`, `thread_id`, `expected_inbound_id`, `technical_parts` (signature et
 unsubscribe). Les champs nullables doivent être présents. Une réponse désigne
@@ -643,3 +693,14 @@ avec l'application, ses écritures enregistrées et sa vérification visuelle.
 La publication suit `publish.yml` après fusion : registre npm, archive de version
 explicite et découverte dans un processus neuf doivent être vérifiés séparément.
 Une conversation Louise déjà ouverte peut conserver un ancien catalogue.
+
+La décision accepte aussi `agent_cycle_id`, facultatif : transmettre uniquement
+l’identifiant réel du cycle courant (1 à 200 caractères, sans espaces ni caractères
+de contrôle). Il devient `agentCycleId` côté serveur ; absent, il reste absent.
+Les lectures des messages conservent `decision.agentCycleId` et, dans chaque
+tentative, `triggerRunId`, `reconciliationRunId` et `reconciliationErrorCode`.
+Une valeur absente ou nulle ne prouve aucune exécution ; ces références ne
+changent pas l’état du message et n’exposent pas l’enveloppe fournisseur brute.
+
+Pour un signal daté, `signal_upsert.date_evidence` fournit le passage source qui
+établit `date`. Le serveur conserve cette preuve ; une date sans preuve est refusée.

package/dist/tools/agent_outreach.d.ts

@@ -2,7 +2,13 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LeadifyClient } from "../client.js";
 import { type ToolResult } from "../types.js";
 export declare const OUTREACH_MCP_CONTRACT = "leadify-outreach-mcp.v1";
-export declare const OUTREACH_TOOL_NAMES: readonly ["list_outreach_programs", "get_outreach_program_context", "query_outreach_prospects", "get_outreach_prospect_summary", "get_outreach_contact_history", "get_outreach_prospect_context", "get_outreach_thread", "submit_outreach_messages", "list_outreach_messages", "get_outreach_message", "cancel_outreach_message", "list_outreach_events", "acknowledge_outreach_events", "get_outreach_reception_health", "list_outreach_conversations", "get_outreach_conversation"];
+/** PRD-2632 : writing context read in pieces. Same order as the server's `readOrder`. */
+export declare const OUTREACH_CONTEXT_MODULES: readonly ["prospect", "company", "workspace", "company_brain", "vertical", "offers", "persona", "playbook", "qualification", "signals", "history", "crm", "authorization"];
+export type OutreachContextModule = typeof OUTREACH_CONTEXT_MODULES[number];
+/** Only these modules are long lists the server pages; every other module is one answer. */
+export declare const OUTREACH_CONTEXT_PAGED_MODULES: readonly ["signals", "history"];
+export declare const OUTREACH_CONTEXT_TOOL_NAMES: readonly ["get_outreach_context_summary", "get_outreach_context_prospect", "get_outreach_context_company", "get_outreach_context_workspace", "get_outreach_context_company_brain", "get_outreach_context_vertical", "get_outreach_context_offers", "get_outreach_context_persona", "get_outreach_context_playbook", "get_outreach_context_qualification", "get_outreach_context_signals", "get_outreach_context_history", "get_outreach_context_crm", "get_outreach_context_authorization"];
+export declare const OUTREACH_TOOL_NAMES: readonly ["list_outreach_programs", "get_outreach_program_context", "query_outreach_prospects", "get_outreach_prospect_summary", "get_outreach_contact_history", "get_outreach_prospect_context", "get_outreach_context_summary", "get_outreach_context_prospect", "get_outreach_context_company", "get_outreach_context_workspace", "get_outreach_context_company_brain", "get_outreach_context_vertical", "get_outreach_context_offers", "get_outreach_context_persona", "get_outreach_context_playbook", "get_outreach_context_qualification", "get_outreach_context_signals", "get_outreach_context_history", "get_outreach_context_crm", "get_outreach_context_authorization", "get_outreach_thread", "submit_outreach_messages", "list_outreach_messages", "get_outreach_message", "cancel_outreach_message", "list_outreach_events", "acknowledge_outreach_events", "get_outreach_reception_health", "list_outreach_conversations", "get_outreach_conversation"];
 export declare const OUTREACH_SERVER_CONTRACTS: {
     readonly program: "1.0.0";
     readonly selection: "1.0.0";

package/dist/tools/agent_outreach.js

@@ -3,8 +3,17 @@ import { getClient } from "../client.js";
 import { LeadifyApiError, toolResult, toolError, handleToolError } from "../types.js";
 import { identifier, scope, querySchema, queryBody, submitSchema, decisionBody, acknowledgeSchema } from "./agent_outreach_schemas.js";
 export const OUTREACH_MCP_CONTRACT = "leadify-outreach-mcp.v1";
+/** PRD-2632 : writing context read in pieces. Same order as the server's `readOrder`. */
+export const OUTREACH_CONTEXT_MODULES = ["prospect", "company", "workspace", "company_brain", "vertical", "offers", "persona", "playbook",
+    "qualification", "signals", "history", "crm", "authorization"];
+/** Only these modules are long lists the server pages; every other module is one answer. */
+export const OUTREACH_CONTEXT_PAGED_MODULES = ["signals", "history"];
+export const OUTREACH_CONTEXT_TOOL_NAMES = ["get_outreach_context_summary", "get_outreach_context_prospect", "get_outreach_context_company",
+    "get_outreach_context_workspace", "get_outreach_context_company_brain", "get_outreach_context_vertical", "get_outreach_context_offers",
+    "get_outreach_context_persona", "get_outreach_context_playbook", "get_outreach_context_qualification", "get_outreach_context_signals",
+    "get_outreach_context_history", "get_outreach_context_crm", "get_outreach_context_authorization"];
 export const OUTREACH_TOOL_NAMES = ["list_outreach_programs", "get_outreach_program_context", "query_outreach_prospects",
-    "get_outreach_prospect_summary", "get_outreach_contact_history", "get_outreach_prospect_context", "get_outreach_thread",
+    "get_outreach_prospect_summary", "get_outreach_contact_history", "get_outreach_prospect_context", ...OUTREACH_CONTEXT_TOOL_NAMES, "get_outreach_thread",
     "submit_outreach_messages", "list_outreach_messages", "get_outreach_message", "cancel_outreach_message", "list_outreach_events",
     "acknowledge_outreach_events", "get_outreach_reception_health", "list_outreach_conversations", "get_outreach_conversation"];
 export const OUTREACH_SERVER_CONTRACTS = { program: "1.0.0", selection: "1.0.0", context: "agent-writing-context.v1", receipt: "agent-message-receipt.v1", journal: "1.0.0" };
@@ -40,10 +49,10 @@ export function projectOutreachMessage(data) {
     const m = object(data);
     const result = pick(m, ["id", "organizationId", "programId", "decisionId", "senderId", "conversationId", "channel", "action", "recipient", "subject", "body", "expectedInboundId", "providerThreadId", "accountKey", "technicalParts", "state", "revision", "reasonCode", "expiresAt", "notBefore", "sentAt", "providerMessageId", "createdAt", "updatedAt"]);
     if (m.decision)
-        result.decision = pick(m.decision, ["id", "personId", "leadId", "requestKey", "purpose", "reason", "sources", "contextVersion", "authorizationRevision", "contextReadAt", "receipt", "createdAt"]);
+        result.decision = pick(m.decision, ["id", "agentCycleId", "personId", "leadId", "requestKey", "purpose", "reason", "sources", "contextVersion", "authorizationRevision", "contextReadAt", "receipt", "createdAt"]);
     if (Array.isArray(m.attempts))
         result.attempts = m.attempts.map(a => {
-            const attempt = pick(a, ["id", "ordinal", "startedAt", "providerBarrierAt", "finishedAt", "outcome", "providerMessageId", "errorCode", "lastReconciledAt", "reconciliationResult"]);
+            const attempt = pick(a, ["id", "ordinal", "startedAt", "providerBarrierAt", "finishedAt", "outcome", "providerMessageId", "errorCode", "lastReconciledAt", "reconciliationResult", "triggerRunId", "reconciliationRunId", "reconciliationErrorCode"]);
             const receipt = object(object(object(a).providerRequest).receipt);
             const safeReceipt = Object.fromEntries([["providerMessageId", receipt.id], ["providerThreadId", receipt.threadId]].filter(([, value]) => typeof value === "string"));
             if (Object.keys(safeReceipt).length)
@@ -52,11 +61,29 @@ export function projectOutreachMessage(data) {
         });
     return result;
 }
+/** One line of JSON: the writing-context tools are read by a runtime that sets aside results above 50,000 characters. */
+const compactResult = (data) => ({ content: [{ type: "text", text: JSON.stringify(data) }] });
+const CONTEXT_MODULE_DESCRIPTION = {
+    prospect: "WHO the person is: identity, contact details, language, job title (the employer is in the company module).",
+    company: "Her EMPLOYER: the employer record and the qualified company cards (each with its document).",
+    workspace: "WHICH choices were made for this group: selected persona, vertical and offer, sender, call to action, plus workspace status and schema readiness. The long texts are in company_brain, vertical, offers, persona and playbook.",
+    company_brain: "The Company Brain of the organisation that prospects: who it is, positioning, vocabulary allowed or forbidden. Read it before writing a word.",
+    vertical: "The VERTICAL attached to the persona: target market and its content.",
+    offers: "The OFFER(S) retained for this group (three at most): what is sold and its limits.",
+    persona: "The PERSONA written to: who she is, her writing contract and description.",
+    playbook: "The published sales PLAYBOOK (GTM) of the organisation.",
+    qualification: "What is KNOWN about the person: qualification document, freshness, failures and any refresh requested. Read the company module for the company cards.",
+    signals: "WHY NOW: recent signals about the person and her company, newest first. Paged.",
+    history: "What was ALREADY SAID: messages exchanged with their text, known threads, the program's own messages, coverage. Newest first. Paged.",
+    crm: "CRM situation, exclusion and contact state: commercial status, reception, human takeover, thread-read readiness, last confirmed outbound and inbound. Check it before any first contact.",
+    authorization: "What is PERMITTED: program state, caps, senders and the key's rights, with the authorization revision to copy into the decision.",
+};
 export function registerAgentOutreachTools(server, client = getClient()) {
-    function register(name, description, schema, action, write = false) {
+    function register(name, description, schema, action, write = false, compact = false) {
         server.registerTool(name, { description: description + readNotice, inputSchema: schema,
             annotations: { readOnlyHint: !write && name !== "query_outreach_prospects", destructiveHint: false, idempotentHint: name !== "query_outreach_prospects", openWorldHint: true } }, (async (input) => { try {
-            return toolResult(await action(schema.parse(input)));
+            const data = await action(schema.parse(input));
+            return compact ? compactResult(data) : toolResult(data);
         }
         catch (e) {
             return outreachError(e);
@@ -68,7 +95,24 @@ export function registerAgentOutreachTools(server, client = getClient()) {
     const personSchema = z.object({ ...scope, lead_id: identifier }).strict();
     register("get_outreach_prospect_summary", "Read a selected person's compact identity, contact counts and selection reasons. This is NOT the writing context: use get_outreach_prospect_context before drafting.", personSchema, v => client.get(`${programPath(v.program_id)}/prospects/${encoded(v.lead_id)}`, params(v.organization_id)));
     register("get_outreach_contact_history", "Read confirmed contact evidence for one person across accessible accounts, including pending, unknown and manual activity. Coverage limits remain explicit.", personSchema, v => client.get(`${programPath(v.program_id)}/contacts/${encoded(v.lead_id)}`, params(v.organization_id)));
-    register("get_outreach_prospect_context", "Read fresh writing context, full-thread readiness, identity, qualification, signals, exclusion, authorizations and Context Workspace. Draft only when readiness.ready=true; WAIT requires resolving the stated reasons. Copy all versions, factsVersion, contextVersion and readAt into the current decision. Never starts qualification. A human takeover can only be resumed by a human in Leadify.", personSchema, async (v) => requireOutreachVersion(await client.get(`${programPath(v.program_id, true)}/people/${encoded(v.lead_id)}/context`, params(v.organization_id)), "agent-writing-context.v1"));
+    register("get_outreach_prospect_context", "LEGACY whole writing context, about 90 KB: runtimes that set aside tool results above 50,000 characters never see it. Agents must NOT call it: read get_outreach_context_summary, then the get_outreach_context_<module> tools. Kept for clients that can read very large results. Draft only when readiness.ready=true; WAIT requires resolving the stated reasons. Copy all versions, factsVersion, contextVersion and readAt into the current decision. Never starts qualification. A human takeover can only be resumed by a human in Leadify.", personSchema, async (v) => requireOutreachVersion(await client.get(`${programPath(v.program_id, true)}/people/${encoded(v.lead_id)}/context`, params(v.organization_id)), "agent-writing-context.v1"));
+    // PRD-2632 : the same context in pieces. Summary first, then one tool per module.
+    const contextPath = (v, tail) => `${programPath(v.program_id, true)}/people/${encoded(v.lead_id)}/context/${tail}`;
+    const expectKind = (data, kind, module) => {
+        const read = requireOutreachVersion(data, "agent-writing-context.v1");
+        if (object(read).responseKind !== kind || (module !== undefined && object(read).module !== module))
+            throw new LeadifyApiError(409, { code: "OUTREACH_CONTRACT_INCOMPATIBLE",
+                error: "Le serveur n'a pas rendu la lecture de contexte attendue. Vérifiez sa version avant de continuer.", expected: { responseKind: kind, module: module ?? null },
+                received: { responseKind: object(read).responseKind ?? null, module: object(read).module ?? null } });
+        return read;
+    };
+    register("get_outreach_context_summary", "START HERE to write for one person. Light read (about 7 KB): ids, readiness, the eight versions, contextVersion, factsVersion, the 13 modules in reading order (readOrder) with characters, pages and fingerprint, warnings, and decisionContext, the block to copy into the context of each deposited decision (modules included). Replaces get_outreach_prospect_context, whose 90 KB result is set aside by agent runtimes. Draft only when readiness.ready=true; otherwise WAIT with the stated reasons. Then read the modules, in readOrder, with get_outreach_context_<module>; each module answer carries its own version, which must equal modules[].version here, else the context moved: restart from this summary. Never starts qualification.", personSchema, async (v) => expectKind(await client.get(contextPath(v, "summary"), params(v.organization_id)), "summary"), false, true);
+    const pagedModules = new Set(OUTREACH_CONTEXT_PAGED_MODULES);
+    for (const module of OUTREACH_CONTEXT_MODULES) {
+        const paged = pagedModules.has(module);
+        const schema = paged ? z.object({ ...scope, lead_id: identifier, cursor: z.string().min(1).max(2000).optional().describe("page.nextCursor from the previous page, unchanged. Omit for the first page.") }).strict() : personSchema;
+        register(`get_outreach_context_${module}`, `Writing context, module ${module}: ${CONTEXT_MODULE_DESCRIPTION[module]} Read get_outreach_context_summary first. Answer: {module, version, readAt, data, page}; compact JSON, kept under about 25,000 characters per page. Compare version with the summary's modules[].version: if it differs, the context moved, restart from the summary.${paged ? " Pass page.nextCursor unchanged as cursor until it is null; the header comes with the first page only." : ""} Never starts qualification.`, schema, async (v) => expectKind(await client.get(contextPath(v, `modules/${module}`), params(v.organization_id, { cursor: v.cursor })), "module", module), false, true);
+    }
     register("get_outreach_thread", "Read one exact person's account/thread with complete bodies or explicit unavailable coverage. Pass nextCursor unchanged as cursor. An excerpt is not a complete conversation.", z.object({ ...scope, lead_id: identifier, account_key: z.string().min(1).max(1000), thread_id: identifier, cursor: z.string().min(1).max(8000).optional(), limit: z.number().int().min(1).max(100).default(50) }).strict(), v => client.get(`${programPath(v.program_id, true)}/people/${encoded(v.lead_id)}/thread`, params(v.organization_id, { accountKey: v.account_key, threadId: v.thread_id, cursor: v.cursor, limit: v.limit })));
     register("submit_outreach_messages", "Deposit 1–20 fresh decisions to Leadify for now, at most one message per channel per person/decision, never a sequence or scheduled steps. Preserve authored text exactly. A reply requires thread_id and expected_inbound_id. Use the SAME request_key and identical payload after interruption; a changed payload needs a new decision after rereading context. Inspect EVERY receipt: a successful call may contain ACCEPTED, WAIT and REFUSED decisions." + receiptNotice, submitSchema, async (v) => requireOutreachVersion(await client.post(postPath(`${programPath(v.program_id)}/messages/batch`, v.organization_id), { decisions: v.decisions.map(decisionBody) }), "agent-message-receipt.v1"), true);
     register("list_outreach_messages", "List this key's deposited messages and decision receipts, including after sender grant revocation. Pagination uses nextCursor as after_id." + receiptNotice, z.object({ ...scope, after_id: identifier.optional(), limit: z.number().int().min(1).max(50).default(25) }).strict(), async (v) => {

package/dist/tools/agent_outreach_schemas.d.ts

@@ -152,6 +152,49 @@ export declare const filters: z.ZodObject<{
     reply?: "TO_HANDLE" | "WAITING" | "NONE" | undefined;
     excluded?: boolean | undefined;
 }>;
+export declare const contextModules: z.ZodObject<{
+    prospect: z.ZodString;
+    company: z.ZodString;
+    workspace: z.ZodString;
+    company_brain: z.ZodString;
+    vertical: z.ZodString;
+    offers: z.ZodString;
+    persona: z.ZodString;
+    playbook: z.ZodString;
+    qualification: z.ZodString;
+    signals: z.ZodString;
+    history: z.ZodString;
+    crm: z.ZodString;
+    authorization: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    prospect: string;
+    company: string;
+    workspace: string;
+    company_brain: string;
+    vertical: string;
+    offers: string;
+    persona: string;
+    playbook: string;
+    qualification: string;
+    signals: string;
+    history: string;
+    crm: string;
+    authorization: string;
+}, {
+    prospect: string;
+    company: string;
+    workspace: string;
+    company_brain: string;
+    vertical: string;
+    offers: string;
+    persona: string;
+    playbook: string;
+    qualification: string;
+    signals: string;
+    history: string;
+    crm: string;
+    authorization: string;
+}>;
 export declare const context: z.ZodObject<{
     contract_version: z.ZodLiteral<"agent-writing-context.v1">;
     context_version: z.ZodString;
@@ -167,54 +210,127 @@ export declare const context: z.ZodObject<{
         authorization: z.ZodString;
         workspace: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        identity: string;
+        workspace: string;
         qualification: string;
         signals: string;
+        authorization: string;
+        identity: string;
         conversation: string;
         contactState: string;
         exclusion: string;
-        authorization: string;
-        workspace: string;
     }, {
-        identity: string;
+        workspace: string;
         qualification: string;
         signals: string;
+        authorization: string;
+        identity: string;
         conversation: string;
         contactState: string;
         exclusion: string;
+    }>;
+    modules: z.ZodOptional<z.ZodObject<{
+        prospect: z.ZodString;
+        company: z.ZodString;
+        workspace: z.ZodString;
+        company_brain: z.ZodString;
+        vertical: z.ZodString;
+        offers: z.ZodString;
+        persona: z.ZodString;
+        playbook: z.ZodString;
+        qualification: z.ZodString;
+        signals: z.ZodString;
+        history: z.ZodString;
+        crm: z.ZodString;
+        authorization: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        prospect: string;
+        company: string;
+        workspace: string;
+        company_brain: string;
+        vertical: string;
+        offers: string;
+        persona: string;
+        playbook: string;
+        qualification: string;
+        signals: string;
+        history: string;
+        crm: string;
         authorization: string;
+    }, {
+        prospect: string;
+        company: string;
         workspace: string;
-    }>;
+        company_brain: string;
+        vertical: string;
+        offers: string;
+        persona: string;
+        playbook: string;
+        qualification: string;
+        signals: string;
+        history: string;
+        crm: string;
+        authorization: string;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     contract_version: "agent-writing-context.v1";
     context_version: string;
     facts_version: string;
     read_at: string;
     versions: {
-        identity: string;
+        workspace: string;
         qualification: string;
         signals: string;
+        authorization: string;
+        identity: string;
         conversation: string;
         contactState: string;
         exclusion: string;
-        authorization: string;
-        workspace: string;
     };
+    modules?: {
+        prospect: string;
+        company: string;
+        workspace: string;
+        company_brain: string;
+        vertical: string;
+        offers: string;
+        persona: string;
+        playbook: string;
+        qualification: string;
+        signals: string;
+        history: string;
+        crm: string;
+        authorization: string;
+    } | undefined;
 }, {
     contract_version: "agent-writing-context.v1";
     context_version: string;
     facts_version: string;
     read_at: string;
     versions: {
-        identity: string;
+        workspace: string;
         qualification: string;
         signals: string;
+        authorization: string;
+        identity: string;
         conversation: string;
         contactState: string;
         exclusion: string;
-        authorization: string;
-        workspace: string;
     };
+    modules?: {
+        prospect: string;
+        company: string;
+        workspace: string;
+        company_brain: string;
+        vertical: string;
+        offers: string;
+        persona: string;
+        playbook: string;
+        qualification: string;
+        signals: string;
+        history: string;
+        crm: string;
+        authorization: string;
+    } | undefined;
 }>;
 export declare const message: z.ZodEffects<z.ZodObject<{
     channel: z.ZodEnum<["GMAIL", "LINKEDIN"]>;
@@ -294,6 +410,7 @@ export declare const message: z.ZodEffects<z.ZodObject<{
     };
 }>;
 export declare const decision: z.ZodEffects<z.ZodObject<{
+    agent_cycle_id: z.ZodOptional<z.ZodString>;
     request_key: z.ZodString;
     lead_id: z.ZodString;
     person_id: z.ZodString;
@@ -324,54 +441,127 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
             authorization: z.ZodString;
             workspace: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         }, {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
+        }>;
+        modules: z.ZodOptional<z.ZodObject<{
+            prospect: z.ZodString;
+            company: z.ZodString;
+            workspace: z.ZodString;
+            company_brain: z.ZodString;
+            vertical: z.ZodString;
+            offers: z.ZodString;
+            persona: z.ZodString;
+            playbook: z.ZodString;
+            qualification: z.ZodString;
+            signals: z.ZodString;
+            history: z.ZodString;
+            crm: z.ZodString;
+            authorization: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
             authorization: string;
+        }, {
+            prospect: string;
+            company: string;
             workspace: string;
-        }>;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        }>>;
     }, "strict", z.ZodTypeAny, {
         contract_version: "agent-writing-context.v1";
         context_version: string;
         facts_version: string;
         read_at: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
     }, {
         contract_version: "agent-writing-context.v1";
         context_version: string;
         facts_version: string;
         read_at: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
     }>;
     authorization_revision: z.ZodNumber;
     messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -467,15 +657,30 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
         facts_version: string;
         read_at: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
     };
     authorization_revision: number;
     messages: {
@@ -493,6 +698,7 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
             unsubscribe: string;
         };
     }[];
+    agent_cycle_id?: string | undefined;
 }, {
     request_key: string;
     lead_id: string;
@@ -509,15 +715,30 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
         facts_version: string;
         read_at: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
     };
     authorization_revision: number;
     messages: {
@@ -535,6 +756,7 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
             unsubscribe: string;
         };
     }[];
+    agent_cycle_id?: string | undefined;
 }>, {
     request_key: string;
     lead_id: string;
@@ -551,15 +773,30 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
         facts_version: string;
         read_at: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
     };
     authorization_revision: number;
     messages: {
@@ -577,6 +814,7 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
             unsubscribe: string;
         };
     }[];
+    agent_cycle_id?: string | undefined;
 }, {
     request_key: string;
     lead_id: string;
@@ -593,15 +831,30 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
         facts_version: string;
         read_at: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
     };
     authorization_revision: number;
     messages: {
@@ -619,6 +872,7 @@ export declare const decision: z.ZodEffects<z.ZodObject<{
             unsubscribe: string;
         };
     }[];
+    agent_cycle_id?: string | undefined;
 }>;
 export declare const querySchema: z.ZodObject<{
     recipe: z.ZodOptional<z.ZodEnum<["never_contacted", "followup_due", "channel_gap", "replies_to_handle"]>>;
@@ -842,6 +1096,7 @@ export declare const querySchema: z.ZodObject<{
 }>;
 export declare const submitSchema: z.ZodObject<{
     decisions: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        agent_cycle_id: z.ZodOptional<z.ZodString>;
         request_key: z.ZodString;
         lead_id: z.ZodString;
         person_id: z.ZodString;
@@ -872,54 +1127,127 @@ export declare const submitSchema: z.ZodObject<{
                 authorization: z.ZodString;
                 workspace: z.ZodString;
             }, "strict", z.ZodTypeAny, {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             }, {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
+            }>;
+            modules: z.ZodOptional<z.ZodObject<{
+                prospect: z.ZodString;
+                company: z.ZodString;
+                workspace: z.ZodString;
+                company_brain: z.ZodString;
+                vertical: z.ZodString;
+                offers: z.ZodString;
+                persona: z.ZodString;
+                playbook: z.ZodString;
+                qualification: z.ZodString;
+                signals: z.ZodString;
+                history: z.ZodString;
+                crm: z.ZodString;
+                authorization: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
                 authorization: string;
+            }, {
+                prospect: string;
+                company: string;
                 workspace: string;
-            }>;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            }>>;
         }, "strict", z.ZodTypeAny, {
             contract_version: "agent-writing-context.v1";
             context_version: string;
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         }, {
             contract_version: "agent-writing-context.v1";
             context_version: string;
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         }>;
         authorization_revision: z.ZodNumber;
         messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -1015,15 +1343,30 @@ export declare const submitSchema: z.ZodObject<{
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         };
         authorization_revision: number;
         messages: {
@@ -1041,6 +1384,7 @@ export declare const submitSchema: z.ZodObject<{
                 unsubscribe: string;
             };
         }[];
+        agent_cycle_id?: string | undefined;
     }, {
         request_key: string;
         lead_id: string;
@@ -1057,15 +1401,30 @@ export declare const submitSchema: z.ZodObject<{
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         };
         authorization_revision: number;
         messages: {
@@ -1083,6 +1442,7 @@ export declare const submitSchema: z.ZodObject<{
                 unsubscribe: string;
             };
         }[];
+        agent_cycle_id?: string | undefined;
     }>, {
         request_key: string;
         lead_id: string;
@@ -1099,15 +1459,30 @@ export declare const submitSchema: z.ZodObject<{
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         };
         authorization_revision: number;
         messages: {
@@ -1125,6 +1500,7 @@ export declare const submitSchema: z.ZodObject<{
                 unsubscribe: string;
             };
         }[];
+        agent_cycle_id?: string | undefined;
     }, {
         request_key: string;
         lead_id: string;
@@ -1141,15 +1517,30 @@ export declare const submitSchema: z.ZodObject<{
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         };
         authorization_revision: number;
         messages: {
@@ -1167,6 +1558,7 @@ export declare const submitSchema: z.ZodObject<{
                 unsubscribe: string;
             };
         }[];
+        agent_cycle_id?: string | undefined;
     }>, "many">;
     organization_id: z.ZodString;
     program_id: z.ZodString;
@@ -1189,15 +1581,30 @@ export declare const submitSchema: z.ZodObject<{
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         };
         authorization_revision: number;
         messages: {
@@ -1215,6 +1622,7 @@ export declare const submitSchema: z.ZodObject<{
                 unsubscribe: string;
             };
         }[];
+        agent_cycle_id?: string | undefined;
     }[];
 }, {
     organization_id: string;
@@ -1235,15 +1643,30 @@ export declare const submitSchema: z.ZodObject<{
             facts_version: string;
             read_at: string;
             versions: {
-                identity: string;
+                workspace: string;
                 qualification: string;
                 signals: string;
+                authorization: string;
+                identity: string;
                 conversation: string;
                 contactState: string;
                 exclusion: string;
-                authorization: string;
-                workspace: string;
             };
+            modules?: {
+                prospect: string;
+                company: string;
+                workspace: string;
+                company_brain: string;
+                vertical: string;
+                offers: string;
+                persona: string;
+                playbook: string;
+                qualification: string;
+                signals: string;
+                history: string;
+                crm: string;
+                authorization: string;
+            } | undefined;
         };
         authorization_revision: number;
         messages: {
@@ -1261,11 +1684,12 @@ export declare const submitSchema: z.ZodObject<{
                 unsubscribe: string;
             };
         }[];
+        agent_cycle_id?: string | undefined;
     }[];
 }>;
-export declare const acknowledgeSchema: z.ZodEffects<z.ZodObject<{
+export declare const acknowledgeSchema: z.ZodObject<{
     cursor: z.ZodString;
-    receipts: z.ZodArray<z.ZodObject<{
+    receipts: z.ZodEffects<z.ZodArray<z.ZodObject<{
         change_id: z.ZodEffects<z.ZodString, string, string>;
         status: z.ZodEnum<["PROCESSED", "DISMISSED"]>;
         reason: z.ZodString;
@@ -1277,28 +1701,18 @@ export declare const acknowledgeSchema: z.ZodEffects<z.ZodObject<{
         status: "PROCESSED" | "DISMISSED";
         reason: string;
         change_id: string;
-    }>, "many">;
-    organization_id: z.ZodString;
-    program_id: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    cursor: string;
-    organization_id: string;
-    program_id: string;
-    receipts: {
+    }>, "many">, {
         status: "PROCESSED" | "DISMISSED";
         reason: string;
         change_id: string;
-    }[];
-}, {
-    cursor: string;
-    organization_id: string;
-    program_id: string;
-    receipts: {
+    }[], {
         status: "PROCESSED" | "DISMISSED";
         reason: string;
         change_id: string;
-    }[];
-}>, {
+    }[]>;
+    organization_id: z.ZodString;
+    program_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
     cursor: string;
     organization_id: string;
     program_id: string;
@@ -1360,19 +1774,34 @@ export declare function decisionBody(d: z.infer<typeof decision>): {
         url: string;
     }[];
     context: {
+        modules?: {
+            prospect: string;
+            company: string;
+            workspace: string;
+            company_brain: string;
+            vertical: string;
+            offers: string;
+            persona: string;
+            playbook: string;
+            qualification: string;
+            signals: string;
+            history: string;
+            crm: string;
+            authorization: string;
+        } | undefined;
         contractVersion: "agent-writing-context.v1";
         contextVersion: string;
         factsVersion: string;
         readAt: string;
         versions: {
-            identity: string;
+            workspace: string;
             qualification: string;
             signals: string;
+            authorization: string;
+            identity: string;
             conversation: string;
             contactState: string;
             exclusion: string;
-            authorization: string;
-            workspace: string;
         };
     };
     authorizationRevision: number;
@@ -1391,4 +1820,5 @@ export declare function decisionBody(d: z.infer<typeof decision>): {
             unsubscribe: string;
         };
     }[];
+    agentCycleId?: string | undefined;
 };

package/dist/tools/agent_outreach_schemas.js

@@ -22,11 +22,16 @@ export const filters = z.object({
     counts: z.array(count).max(6).optional(), never_on: z.array(target).max(3).optional(),
     pending: z.boolean().optional(), unknown: z.boolean().optional(), reply: z.enum(["TO_HANDLE", "WAITING", "NONE"]).optional(), excluded: z.boolean().optional(),
 }).strict();
+// PRD-2632 : one fingerprint per module, copied from get_outreach_context_summary.decisionContext.modules.
+export const contextModules = z.object({ prospect: version, company: version, workspace: version, company_brain: version, vertical: version, offers: version,
+    persona: version, playbook: version, qualification: version, signals: version, history: version, crm: version, authorization: version }).strict();
 export const context = z.object({
     contract_version: z.literal("agent-writing-context.v1"), context_version: version, facts_version: version, read_at: date,
     versions: z.object({ identity: version, qualification: version, signals: version, conversation: version,
         contactState: version, exclusion: version, authorization: version, workspace: version }).strict()
-        .describe("Copy the versions object from get_outreach_prospect_context unchanged, including contactState."),
+        .describe("Copy the versions object from get_outreach_context_summary (or get_outreach_prospect_context) unchanged, including contactState."),
+    modules: contextModules.optional()
+        .describe("Copy decisionContext.modules from get_outreach_context_summary unchanged, all 13 fingerprints. Always send it when you wrote from modules: Leadify then refuses the decision, naming the modules, if one changed after you read it."),
 }).strict();
 export const message = z.object({
     channel, action: z.enum(["MESSAGE", "INVITATION"]), sender_id: identifier, account_key: z.string().min(1).max(1000),
@@ -52,6 +57,7 @@ export const message = z.object({
         issue(["body"], "Renseignez le texte du message.");
 });
 export const decision = z.object({
+    agent_cycle_id: z.string().min(1).max(200).regex(/^[^\s\u0000-\u001f\u007f]+$/).optional().describe("Exact existing agent cycle identifier; omit when unavailable, never invent one."),
     request_key: z.string().min(1).max(200), lead_id: identifier, person_id: identifier,
     purpose: z.enum(["FIRST_CONTACT", "FOLLOW_UP", "REPLY"]), reason: z.string().min(1).max(2000),
     sources: z.array(z.object({ label: exactText.min(1), url: z.string().url().max(20000) }).strict()).max(20),
@@ -75,8 +81,8 @@ export const querySchema = z.object({ ...scope, recipe: z.enum(["never_contacted
 export const submitSchema = z.object({ ...scope, decisions: z.array(decision).min(1).max(20) }).strict();
 export const acknowledgeSchema = z.object({ ...scope, cursor: z.string().min(1).max(2000),
     receipts: z.array(z.object({ change_id: z.string().regex(/^[1-9]\d{0,18}$/).refine(v => /^[1-9]\d{0,18}$/.test(v) && BigInt(v) <= 9223372036854775807n),
-        status: z.enum(["PROCESSED", "DISMISSED"]), reason: z.string().trim().min(1).max(2000) }).strict()).min(1).max(100),
-}).strict().refine(v => new Set(v.receipts.map(r => r.change_id)).size === v.receipts.length, "Chaque changement doit être indiqué une seule fois.");
+        status: z.enum(["PROCESSED", "DISMISSED"]), reason: z.string().trim().min(1).max(2000) }).strict()).min(1).max(100).refine(receipts => new Set(receipts.map(r => r.change_id)).size === receipts.length, "Chaque changement doit être indiqué une seule fois."),
+}).strict();
 export function queryBody(v) {
     const f = v.filters;
     return { recipe: v.recipe, limit: v.limit, cursor: v.cursor, filters: {
@@ -86,9 +92,9 @@ export function queryBody(v) {
         } };
 }
 export function decisionBody(d) {
-    return { requestKey: d.request_key, leadId: d.lead_id, personId: d.person_id, purpose: d.purpose, reason: d.reason, sources: d.sources,
+    return { ...(d.agent_cycle_id !== undefined ? { agentCycleId: d.agent_cycle_id } : {}), requestKey: d.request_key, leadId: d.lead_id, personId: d.person_id, purpose: d.purpose, reason: d.reason, sources: d.sources,
         context: { contractVersion: d.context.contract_version, contextVersion: d.context.context_version, factsVersion: d.context.facts_version,
-            readAt: d.context.read_at, versions: d.context.versions }, authorizationRevision: d.authorization_revision,
+            readAt: d.context.read_at, versions: d.context.versions, ...(d.context.modules ? { modules: d.context.modules } : {}) }, authorizationRevision: d.authorization_revision,
         messages: d.messages.map(m => ({ channel: m.channel, action: m.action, senderId: m.sender_id, accountKey: m.account_key,
             recipient: m.recipient, subject: m.subject, body: m.body, threadId: m.thread_id, expectedInboundId: m.expected_inbound_id, technicalParts: m.technical_parts })) };
 }

package/dist/tools/auth.js

@@ -1,4 +1,4 @@
-import { OUTREACH_MCP_CONTRACT, OUTREACH_SERVER_CONTRACTS, OUTREACH_TOOL_NAMES, requireOutreachVersion, outreachError } from "./agent_outreach.js";
+import { OUTREACH_MCP_CONTRACT, OUTREACH_SERVER_CONTRACTS, OUTREACH_TOOL_NAMES, OUTREACH_CONTEXT_MODULES, requireOutreachVersion, outreachError } from "./agent_outreach.js";
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
 import { z } from "zod";
@@ -13,7 +13,7 @@ export function projectMcpRuntimeInfo(data, organizationId) {
         version: MCP_VERSION,
         organization: organization ? { id: organization.id, name: organization.name ?? null, slug: organization.slug ?? null } : null,
         organizationAccessible: Boolean(organization),
-        outreach: { contract: OUTREACH_MCP_CONTRACT, tools: OUTREACH_TOOL_NAMES, expectedServerContracts: OUTREACH_SERVER_CONTRACTS, serverCompatibility: "NOT_CHECKED", administrativeAuthority: false },
+        outreach: { contract: OUTREACH_MCP_CONTRACT, tools: OUTREACH_TOOL_NAMES, contextModules: OUTREACH_CONTEXT_MODULES, expectedServerContracts: OUTREACH_SERVER_CONTRACTS, serverCompatibility: "NOT_CHECKED", administrativeAuthority: false },
         readOnly: true,
         writes: 0,
         sends: 0,

package/dist/tools/signals.js

@@ -87,7 +87,8 @@ export function registerSignalTools(server) {
                 .optional()
                 .describe("Date the business event actually occurred (≠ insertion date). Partial or full " +
                 "ISO 8601: 'YYYY' / 'YYYY-MM' / 'YYYY-MM-DD' / datetime. Use the finest " +
-                "precision you can reliably determine."),
+                "precision you can reliably determine. When provided, date_evidence is required."),
+            date_evidence: z.string().optional().describe("Source passage or factual evidence establishing the event date. Required and non-empty when date is provided; never infer a date from insertion time."),
             source: z
                 .string()
                 .optional()
@@ -101,7 +102,7 @@ export function registerSignalTools(server) {
             reason: reasonParam,
         },
         annotations: { idempotentHint: true },
-    }, async ({ id, lead_id, level, title, content, ai_summary, date, source, agent_source, source_url, reason, }) => {
+    }, async ({ id, lead_id, level, title, content, ai_summary, date, date_evidence, source, agent_source, source_url, reason, }) => {
         const capError = capExceeded();
         if (capError)
             return capError;
@@ -121,6 +122,8 @@ export function registerSignalTools(server) {
                 body.aiSummary = ai_summary;
             if (date !== undefined)
                 body.date = date;
+            if (date_evidence !== undefined)
+                body.dateEvidence = date_evidence;
             if (source !== undefined)
                 body.source = source;
             if (agent_source !== undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agifyai/leadify-mcp",
-  "version": "9.7.1",
+  "version": "9.8.0",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",