@linkegringo/mcp 1.0.9 → 1.0.11

package/dist/index.d.ts

@@ -392,8 +392,7 @@ declare function handleGetPendingJob(input?: GetPendingJobInput): Promise<{
     }[];
     structuredData: {
         jobFound: boolean;
-        pendingCount: number;
-        job?: undefined;
+        job: BridgeJob<any, any>;
     };
 } | {
     content: {
@@ -402,13 +401,7 @@ declare function handleGetPendingJob(input?: GetPendingJobInput): Promise<{
     }[];
     structuredData: {
         jobFound: boolean;
-        job: {
-            id: string;
-            type: JobType;
-            payload: any;
-            createdAt: number;
-        };
-        pendingCount?: undefined;
+        pendingCount: number;
     };
 }>;
 

package/dist/index.js

@@ -172,9 +172,9 @@ var DEFAULT_BRIDGE_URL = process.env.LINKEGRINGO_BRIDGE_URL || (process.env.NODE
 async function getRemoteOrLocalPendingJob(jobId, bridgeUrl = DEFAULT_BRIDGE_URL) {
   if (bridgeUrl) {
     try {
-      const url = jobId ? `${bridgeUrl}/api/jobs/pending?id=${encodeURIComponent(jobId)}` : `${bridgeUrl}/api/jobs/pending`;
+      const url = jobId ? `${bridgeUrl}/api/jobs/${encodeURIComponent(jobId)}` : `${bridgeUrl}/api/jobs/pending`;
       const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), 2e3);
+      const timer = setTimeout(() => controller.abort(), 15e3);
       const res = await fetch(url, { signal: controller.signal });
       clearTimeout(timer);
       if (res.ok) {
@@ -192,7 +192,7 @@ async function completeRemoteOrLocalJob(jobId, result, bridgeUrl = DEFAULT_BRIDG
   if (bridgeUrl) {
     try {
       const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), 5e3);
+      const timer = setTimeout(() => controller.abort(), 15e3);
       const res = await fetch(`${bridgeUrl}/api/jobs/${encodeURIComponent(jobId)}/complete`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -1256,26 +1256,10 @@ ${proposals.map(
 
 // src/tools/get-pending-job.ts
 import { z as z11 } from "zod";
-var getPendingJobInputSchema = z11.object({
-  jobId: z11.string().optional().describe("ID espec\xEDfico do job a ser buscado (opcional. Se omitido, pega o pr\xF3ximo da fila)")
-});
-async function handleGetPendingJob(input = {}) {
-  const job = await getRemoteOrLocalPendingJob(input.jobId);
-  if (!job) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: "Nenhum job pendente no momento na interface web do LinkeGringo."
-        }
-      ],
-      structuredData: {
-        jobFound: false,
-        pendingCount: bridgeJobStore.getPendingCount()
-      }
-    };
-  }
-  bridgeJobStore.markProcessing(job.id);
+
+// src/tools/format-job.ts
+function formatJobResponse(job) {
+  let instructions = "";
   let details = "";
   if (job.type === "parse_and_diagnose") {
     const p = job.payload || {};
@@ -1284,53 +1268,210 @@ async function handleGetPendingJob(input = {}) {
 - **Cargo Almejado**: ${p.targetRole || "N\xE3o especificado"}
 - **Possui PDF Base64**: ${Boolean(p.pdfBase64)} (${p.pdfBase64 ? Math.round(p.pdfBase64.length / 1024) + " KB base64" : "N/A"})
 - **Possui Texto**: ${Boolean(p.pdfText)}
+`.trim();
+    instructions = `
+### \u26A0\uFE0F DIRETRIZES OBRIGAT\xD3RIAS PARA O AGENTE DE IA:
+1. **Zero Scripts**: N\xC3O execute scripts Python/Node no disco. N\xC3O salve arquivos no sistema de arquivos. N\xC3O inspecione arquivos locais de c\xF3digo.
+2. **Processamento Multimodal**: Analise o PDF/dados recebidos diretamente no seu racioc\xEDnio em 1 \xFAnico turno.
+3. **Submiss\xE3o Imediata**: Chame a ferramenta \`submit_job_result\` com o JSON estruturado no campo \`result\`.
+
+### \u{1F4CB} Estrutura JSON Exata para \`submit_job_result\`:
+\`\`\`json
+{
+  "jobId": "${job.id}",
+  "result": {
+    "profile": {
+      "firstName": "Nome",
+      "lastName": "Sobrenome",
+      "headline": "Role Anchor | Core Techs | Scale/Impact | US Remote",
+      "location": "Cidade, Pa\xEDs",
+      "summary": "Resumo profissional com foco em impacto t\xE9cnico...",
+      "experiences": [
+        {
+          "title": "Senior Software Engineer",
+          "companyName": "Nome da Empresa",
+          "workplaceType": "remote",
+          "location": "Local",
+          "current": true,
+          "startDate": { "year": 2022, "month": 1 },
+          "endDate": undefined,
+          "description": "Responsabilidades e impacto..."
+        }
+      ],
+      "education": [
+        {
+          "schoolName": "Universidade",
+          "degreeName": "Bacharelado",
+          "fieldOfStudy": "Ci\xEAncia da Computa\xE7\xE3o"
+        }
+      ],
+      "skills": [
+        { "name": "Node.js" },
+        { "name": "TypeScript" }
+      ],
+      "languages": [
+        { "name": "English", "proficiency": "professional" }
+      ]
+    },
+    "review": {
+      "targetMarket": "United States Remote",
+      "language": "en",
+      "overallScore": 82,
+      "scores": {
+        "searchRelevance": 85,
+        "humanVoice": 80,
+        "credibility": 80,
+        "positioningClarity": 85,
+        "evidenceCoverage": 80
+      },
+      "scoreExplanations": {
+        "searchRelevance": "Avalia\xE7\xE3o de indexa\xE7\xE3o ATS...",
+        "humanVoice": "Tom profissional e aut\xEAntico...",
+        "credibility": "Evid\xEAncias t\xE9cnicas e consist\xEAncia...",
+        "positioningClarity": "Clareza do papel s\xEAnior...",
+        "evidenceCoverage": "Densidade de m\xE9tricas quantific\xE1veis..."
+      },
+      "executiveSummary": "Resumo executivo do diagn\xF3stico e posicionamento para vagas nos EUA...",
+      "profileDirection": {
+        "positioning": "Senior Full-Stack Engineer",
+        "primaryRole": "${p.targetRole || "Senior Full-Stack Engineer"}",
+        "openToWorkTitles": [
+          "Senior Full Stack Engineer",
+          "Senior Backend Engineer",
+          "Staff Software Engineer",
+          "Lead Software Engineer",
+          "Full Stack Developer"
+        ],
+        "rationale": "Justificativa do posicionamento estrat\xE9gico para o mercado americano..."
+      },
+      "triageBottlenecks": [
+        "Gargalo 1: Descri\xE7\xF5es de cargos com poucos bullets quantific\xE1veis",
+        "Gargalo 2: Headline precisa de palavras-chave de indexa\xE7\xE3o booleana"
+      ],
+      "critique": [
+        {
+          "section": "Headline",
+          "assessment": "Avalia\xE7\xE3o da headline atual",
+          "strengths": ["Clareza do cargo principal"],
+          "issues": ["Falta men\xE7\xE3o a escala e especializa\xE7\xE3o"],
+          "severity": "medium"
+        }
+      ]
+    }
+  }
+}
+\`\`\`
 `.trim();
   } else if (job.type === "generate_interview") {
+    const p = job.payload || {};
     details = `
 - **Tipo de A\xE7\xE3o**: Gera\xE7\xE3o de Perguntas de Entrevista T\xE9cnica
-- **Candidato**: ${job.payload?.profile?.name || "N\xE3o informado"}
-- **Cargo Almejado**: ${job.payload?.objective?.primaryRole || "N\xE3o informado"}
+- **Candidato**: ${p.profile?.firstName || ""} ${p.profile?.lastName || ""}
+- **Cargo Almejado**: ${p.objective?.primaryRole || "N\xE3o informado"}
+`.trim();
+    instructions = `
+### \u26A0\uFE0F DIRETRIZES OBRIGAT\xD3RIAS PARA O AGENTE DE IA:
+1. Gere perguntas t\xE9cnicas focando nos gargalos e lacunas identificados no perfil.
+2. N\xC3O execute scripts nem inspecione arquivos.
+3. Chame a ferramenta \`submit_job_result\` com a estrutura:
+
+\`\`\`json
+{
+  "jobId": "${job.id}",
+  "result": {
+    "questions": [
+      {
+        "id": "q1",
+        "category": "scale",
+        "question": "Texto claro da pergunta para investigar o escopo e impacto...",
+        "rationale": "Por que esta pergunta \xE9 importante para o recrutador gringo...",
+        "targetSignal": "M\xE9tricas de escala, throughput ou lat\xEAncia que queremos capturar"
+      }
+    ]
+  }
+}
+\`\`\`
 `.trim();
   } else if (job.type === "generate_rewritten_profile") {
+    const p = job.payload || {};
     details = `
-- **Tipo de A\xE7\xE3o**: Reescrita do Perfil com Bullets Google XYZ
-- **Candidato**: ${job.payload?.profile?.name || "N\xE3o informado"}
-- **Fatos Confirmados**: ${job.payload?.confirmedFacts?.length || 0} fatos
+- **Tipo de A\xE7\xE3o**: Reescrita Completa de Perfil com Bullets Google XYZ
+- **Candidato**: ${p.profile?.firstName || ""} ${p.profile?.lastName || ""}
+- **Fatos Confirmados**: ${p.confirmedFacts?.length || 0}
+`.trim();
+    instructions = `
+### \u26A0\uFE0F DIRETRIZES OBRIGAT\xD3RIAS PARA O AGENTE DE IA:
+1. Reescreva o perfil aplicando a f\xF3rmula Google XYZ (*Accomplished [X], measured by [Y], by doing [Z]*) e Headline $\\le$ 160 caracteres.
+2. N\xC3O execute scripts nem inspecione arquivos.
+3. Chame a ferramenta \`submit_job_result\` com a estrutura:
+
+\`\`\`json
+{
+  "jobId": "${job.id}",
+  "result": {
+    "rewritten": {
+      "headline": "Role Anchor | 3-4 Core Techs | Scale/Impact | US Remote",
+      "summary": "Resumo About reformulado com gancho forte nos primeiros 250 caracteres...",
+      "experiences": [
+        {
+          "title": "Senior Software Engineer",
+          "companyName": "Nome da Empresa",
+          "workplaceType": "remote",
+          "location": "Local",
+          "current": true,
+          "startDate": { "year": 2022, "month": 1 },
+          "endDate": undefined,
+          "description": "Accomplished [X], measured by [Y], by doing [Z]...\\nAccomplished [X], measured by [Y], by doing [Z]..."
+        }
+      ]
+    }
+  }
+}
+\`\`\`
 `.trim();
   }
   return {
     content: [
       {
         type: "text",
-        text: `
-# \u{1F4E5} Job da Interface Web Encontrado!
-
-- **Job ID**: \`${job.id}\`
-- **Tipo**: \`${job.type}\`
-- **Criado em**: ${new Date(job.createdAt).toLocaleTimeString()}
+        text: `\u{1F680} **NOVO JOB RECEBIDO DO LINKEGRINGO**: \`${job.id}\`
 
 ${details}
 
----
-\u{1F4A1} **Instru\xE7\xF5es para o Agente de IA**:
-1. Processe a intelig\xEAncia requerida para este job com base nas diretrizes do LinkeGringo.
-2. Ao concluir, chame a ferramenta \`submit_job_result\` passando \`jobId: "${job.id}"\` e o JSON estruturado no campo \`result\`.
-3. A interface web em \`localhost:5173\` atualizar\xE1 a tela no mesmo instante!
-`.trim()
+${instructions}`
       }
     ],
     structuredData: {
       jobFound: true,
-      job: {
-        id: job.id,
-        type: job.type,
-        payload: job.payload,
-        createdAt: job.createdAt
-      }
+      job
     }
   };
 }
 
+// src/tools/get-pending-job.ts
+var getPendingJobInputSchema = z11.object({
+  jobId: z11.string().optional().describe("ID espec\xEDfico do job a ser buscado (opcional. Se omitido, pega o pr\xF3ximo da fila)")
+});
+async function handleGetPendingJob(input = {}) {
+  const job = await getRemoteOrLocalPendingJob(input.jobId);
+  if (!job) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "Nenhum job pendente no momento na interface web do LinkeGringo."
+        }
+      ],
+      structuredData: {
+        jobFound: false,
+        pendingCount: bridgeJobStore.getPendingCount()
+      }
+    };
+  }
+  bridgeJobStore.markProcessing(job.id);
+  return formatJobResponse(job);
+}
+
 // src/tools/submit-job-result.ts
 import { z as z12 } from "zod";
 var submitJobResultInputSchema = z12.object({
@@ -1501,76 +1642,6 @@ async function waitForNextJob(bridgeUrl, timeoutMs) {
     }
   });
 }
-function formatJobResponse(job) {
-  let instructions = "";
-  let details = "";
-  if (job.type === "parse_and_diagnose") {
-    const p = job.payload || {};
-    details = `
-- **Tipo de A\xE7\xE3o**: Extra\xE7\xE3o Multimodal e Diagn\xF3stico de Perfil (parseAndDiagnose)
-- **Cargo Almejado**: ${p.targetRole || "N\xE3o especificado"}
-- **Possui PDF Base64**: ${Boolean(p.pdfBase64)} (${p.pdfBase64 ? Math.round(p.pdfBase64.length / 1024) + " KB" : "N/A"})
-- **Possui Texto**: ${Boolean(p.pdfText)}
-`.trim();
-    instructions = `
-### Pr\xF3ximos Passos Obrigat\xF3rios:
-1. Extraia e analise o perfil estruturado (\`Profile\`) e o diagn\xF3stico (\`ProfileReview\`) com notas (0-100), gargalos de triagem de recrutadores e lacunas de stack.
-2. Envie o resultado de volta para o navegador chamando a tool \`submit_job_result\`:
-   \`\`\`json
-   {
-     "jobId": "${job.id}",
-     "result": {
-       "profile": { ... },
-       "review": { ... }
-     }
-   }
-   \`\`\`
-3. Ap\xF3s enviar o resultado, execute a tool \`watch_linkegringo\` novamente para aguardar a pr\xF3xima a\xE7\xE3o do usu\xE1rio (entrevista t\xE9cnica ou reescrita).
-`.trim();
-  } else if (job.type === "generate_interview") {
-    const p = job.payload || {};
-    details = `
-- **Tipo de A\xE7\xE3o**: Gera\xE7\xE3o de Perguntas de Entrevista T\xE9cnica
-- **Candidato**: ${p.profile?.name || "N\xE3o informado"}
-- **Cargo Almejado**: ${p.objective?.primaryRole || "N\xE3o informado"}
-`.trim();
-    instructions = `
-### Pr\xF3ximos Passos Obrigat\xF3rios:
-1. Gere as perguntas t\xE9cnicas focando nos gargalos e lacunas identificados.
-2. Envie o resultado chamando \`submit_job_result({ jobId: "${job.id}", result: { questions: [...] } })\`.
-3. Rearme a escuta chamando \`watch_linkegringo\` para aguardar as respostas do candidato.
-`.trim();
-  } else if (job.type === "generate_rewritten_profile") {
-    const p = job.payload || {};
-    details = `
-- **Tipo de A\xE7\xE3o**: Reescrita Completa de Perfil com Bullets Google XYZ
-- **Candidato**: ${p.profile?.name || "N\xE3o informado"}
-- **Fatos Confirmados na Entrevista**: ${p.confirmedFacts?.length || 0}
-`.trim();
-    instructions = `
-### Pr\xF3ximos Passos Obrigat\xF3rios:
-1. Reescreva o perfil aplicando a f\xF3rmula Google XYZ (Accomplished [X], measured by [Y], by doing [Z]) e Headline $\\le$ 160 caracteres.
-2. Envie o resultado chamando \`submit_job_result({ jobId: "${job.id}", result: { rewritten: { ... } } })\`.
-3. Rearme a escuta chamando \`watch_linkegringo\`.
-`.trim();
-  }
-  return {
-    content: [
-      {
-        type: "text",
-        text: `\u{1F680} **NOVO JOB RECEBIDO DO LINKEGRINGO**: \`${job.id}\`
-
-${details}
-
-${instructions}`
-      }
-    ],
-    structuredData: {
-      jobFound: true,
-      job
-    }
-  };
-}
 async function handleWatchLinkeGringo(input = {}) {
   const timeoutSeconds = Math.min(Math.max(input.timeoutSeconds ?? 60, 0.1), 300);
   const timeoutMs = timeoutSeconds * 1e3;
@@ -1653,7 +1724,7 @@ function createLinkeGringoMcpServer() {
   server.registerTool(
     "get_pending_job",
     {
-      description: "Busca o pr\xF3ximo job pendente enviado pela interface gr\xE1fica web do LinkeGringo (ex: upload de perfil para diagn\xF3stico, gera\xE7\xE3o de entrevista, reescrita de perfil).",
+      description: "Obt\xE9m os dados completos de um job pelo ID (ou o pr\xF3ximo da fila). Use APENAS quando for notificado de um job espec\xEDfico (ex: por watcher em background). N\xC3O use esta ferramenta para iniciar escuta ou checar jobs antes de iniciar o watch.",
       inputSchema: getPendingJobInputSchema.shape
     },
     async (args) => {
@@ -1663,7 +1734,7 @@ function createLinkeGringoMcpServer() {
   server.registerTool(
     "submit_job_result",
     {
-      description: "Envia o resultado processado pelo agente de IA de volta para a interface gr\xE1fica web do LinkeGringo, desbloqueando o front-end e atualizando a tela imediatamente.",
+      description: "Envia o resultado estruturado do processamento de um job de volta para o navegador do LinkeGringo, desbloqueando a tela do usu\xE1rio instantaneamente. Sempre chame esta ferramenta imediatamente ap\xF3s processar um job recebido por watch_linkegringo ou get_pending_job.",
       inputSchema: submitJobResultInputSchema.shape
     },
     async (args) => {
@@ -1673,7 +1744,7 @@ function createLinkeGringoMcpServer() {
   server.registerTool(
     "watch_linkegringo",
     {
-      description: "Inicia a escuta ativa por jobs enviados pela interface web do LinkeGringo (upload de perfil para diagn\xF3stico, entrevista t\xE9cnica, reescrita de perfil). Aguarda o job e o retorna imediatamente para processamento.",
+      description: 'Inicia a escuta ativa (watch) por jobs enviados pela interface web do LinkeGringo (http://127.0.0.1:5174). Use esta ferramenta SEMPRE que o usu\xE1rio disser "iniciar watch", "escutar", "conectar ao LinkeGringo" ou similar. N\xC3O chame get_pending_job antes desta ferramenta. Bloqueia aguardando e retorna o job assim que ele for submetido no navegador.',
       inputSchema: watchLinkeGringoInputSchema.shape
     },
     async (args) => {
@@ -2204,16 +2275,17 @@ function startBridgeWatcher(options = {}) {
                       console.log(
                         `[LinkeGringo Watcher] \u{1F7E2} Conectado ao bridge (${bridgeUrl}). Watcher ativo: ${payload.watcherId} (Jobs pendentes: ${payload.pendingCount})`
                       );
-                      if (options.once && payload.pendingCount > 0) {
+                      if (payload.pendingCount > 0 && options.once) {
                         console.log(
-                          `[LinkeGringo Watcher] \u{1F680} JOB DETECTADO NA FILA (${payload.pendingCount} pendente(s)). Finalizando para ativar agente...`
+                          `[LinkeGringo Watcher] \u{1F680} JOB DETECTADO NA FILA (${payload.pendingCount} pendente(s)). Chame get_pending_job para processar e submit_job_result para responder.`
                         );
                         setTimeout(() => process.exit(0), 50);
                       }
                     } else if (payload.type === "job_created") {
                       console.log(
                         `
-[LinkeGringo Watcher] \u{1F680} NOVO JOB DETECTADO: ${payload.job.id} | Tipo: ${payload.job.type}`
+[LinkeGringo Watcher] \u{1F680} NOVO JOB DETECTADO: ${payload.job.id} | Tipo: ${payload.job.type}
+[LinkeGringo Watcher] \u{1F449} Chame get_pending_job({ jobId: '${payload.job.id}' }) e envie o resultado direto com submit_job_result.`
                       );
                       options.onJob?.(payload.job);
                       if (options.once) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkegringo/mcp",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Servidor MCP oficial do LinkeGringo para auditoria e otimização de perfis para o mercado internacional",
   "type": "module",
   "bin": {