@linkegringo/mcp 1.0.7 → 1.0.9

package/dist/index.d.ts

@@ -108,6 +108,10 @@ declare class BridgeJobStore extends EventEmitter {
     getWatcherCount(): number;
     hasActiveWatcher(): boolean;
     cancelAllPending(reason?: string): number;
+    resetQueue(reason?: string): {
+        canceledCount: number;
+        clearedCount: number;
+    };
     clear(): void;
 }
 declare const bridgeJobStore: BridgeJobStore;
@@ -463,4 +467,38 @@ declare function handleSubmitJobResult(input: SubmitJobResultInput): Promise<{
     };
 }>;
 
-export { type AuditIssue, type AuditProfileInput, type BridgeJob, type BridgeServerOptions, type ConvertToXyzBulletInput, type GenerateHeadlineInput, type GetPendingJobInput, type InstallResult, type InstallerOptions, type JobStatus, type JobType, type McpTarget, type SimulateRecruiterSearchInput, type SparseExperience, type SubmitJobResultInput, type WatcherOptions, auditProfileInputSchema, bridgeJobStore, completeRemoteOrLocalJob, convertToXyzBulletInputSchema, createBridgeHttpServer, createLinkeGringoMcpServer, detectSparseExperiences, failRemoteOrLocalJob, formatGoogleXyzBullet, generateHeadlineInputSchema, getExperienceBulletCount, getMcpConfigsForSystem, getPendingJobInputSchema, getRemoteOrLocalPendingJob, handleAuditProfile, handleConvertToXyzBullet, handleGenerateHeadline, handleGetPendingJob, handleSimulateRecruiterSearch, handleSubmitJobResult, installMcpServerConfig, parseArgs, runInstaller, simulateRecruiterSearchInputSchema, startBridgeServer, startBridgeWatcher, stopBridgeServer, submitJobResultInputSchema };
+declare const watchLinkeGringoInputSchema: z.ZodObject<{
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    bridgeUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    timeoutSeconds?: number | undefined;
+    bridgeUrl?: string | undefined;
+}, {
+    timeoutSeconds?: number | undefined;
+    bridgeUrl?: string | undefined;
+}>;
+type WatchLinkeGringoInput = z.infer<typeof watchLinkeGringoInputSchema>;
+declare function waitForNextJob(bridgeUrl: string, timeoutMs: number): Promise<BridgeJob | null>;
+declare function handleWatchLinkeGringo(input?: WatchLinkeGringoInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredData: {
+        jobFound: boolean;
+        job: BridgeJob<any, any>;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredData: {
+        status: string;
+        timeoutSeconds: number;
+        pendingCount: number;
+        serverOnline: boolean;
+    };
+}>;
+
+export { type AuditIssue, type AuditProfileInput, type BridgeJob, type BridgeServerOptions, type ConvertToXyzBulletInput, type GenerateHeadlineInput, type GetPendingJobInput, type InstallResult, type InstallerOptions, type JobStatus, type JobType, type McpTarget, type SimulateRecruiterSearchInput, type SparseExperience, type SubmitJobResultInput, type WatchLinkeGringoInput, type WatcherOptions, auditProfileInputSchema, bridgeJobStore, completeRemoteOrLocalJob, convertToXyzBulletInputSchema, createBridgeHttpServer, createLinkeGringoMcpServer, detectSparseExperiences, failRemoteOrLocalJob, formatGoogleXyzBullet, generateHeadlineInputSchema, getExperienceBulletCount, getMcpConfigsForSystem, getPendingJobInputSchema, getRemoteOrLocalPendingJob, handleAuditProfile, handleConvertToXyzBullet, handleGenerateHeadline, handleGetPendingJob, handleSimulateRecruiterSearch, handleSubmitJobResult, handleWatchLinkeGringo, installMcpServerConfig, parseArgs, runInstaller, simulateRecruiterSearchInputSchema, startBridgeServer, startBridgeWatcher, stopBridgeServer, submitJobResultInputSchema, waitForNextJob, watchLinkeGringoInputSchema };

package/dist/index.js

@@ -150,6 +150,14 @@ var BridgeJobStore = class extends EventEmitter {
     this.emit("queue:cleared", count);
     return count;
   }
+  resetQueue(reason = "Cancelado pelo usu\xE1rio via interface web") {
+    const canceledCount = this.cancelAllPending(reason);
+    const clearedCount = this.jobs.size;
+    this.jobs.clear();
+    this.pendingQueue = [];
+    this.emit("queue:reset", { canceledCount, clearedCount });
+    return { canceledCount, clearedCount };
+  }
   clear() {
     this.jobs.clear();
     this.pendingQueue = [];
@@ -1388,6 +1396,214 @@ O front-end em \`localhost:5173\` acabou de receber a resposta formatada e atual
   }
 }
 
+// src/tools/watch-linkegringo.ts
+import { z as z13 } from "zod";
+import http from "http";
+var watchLinkeGringoInputSchema = z13.object({
+  timeoutSeconds: z13.number().optional().describe(
+    "Tempo m\xE1ximo em segundos para aguardar a chegada de um novo job da interface web do LinkeGringo (padr\xE3o: 60s, m\xE1x: 300s). Se j\xE1 houver um job na fila, retorna imediatamente."
+  ),
+  bridgeUrl: z13.string().optional().describe("URL base do bridge HTTP local do LinkeGringo (padr\xE3o: http://127.0.0.1:5174)")
+});
+async function waitForNextJob(bridgeUrl, timeoutMs) {
+  const localPending = bridgeJobStore.getPendingJob();
+  if (localPending) {
+    return localPending;
+  }
+  return new Promise((resolve) => {
+    let resolved = false;
+    let req = null;
+    let timer = null;
+    const cleanup = () => {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      if (req) {
+        try {
+          req.destroy();
+        } catch {
+        }
+        req = null;
+      }
+      bridgeJobStore.off("job:created", onLocalJob);
+    };
+    const done = (job) => {
+      if (resolved) return;
+      resolved = true;
+      cleanup();
+      resolve(job);
+    };
+    const onLocalJob = (job) => {
+      done(job);
+    };
+    bridgeJobStore.on("job:created", onLocalJob);
+    timer = setTimeout(() => {
+      done(null);
+    }, timeoutMs);
+    try {
+      const parsed = new URL("/api/jobs/stream", bridgeUrl);
+      req = http.get(
+        {
+          hostname: parsed.hostname,
+          port: parsed.port || 5174,
+          path: parsed.pathname,
+          headers: {
+            Accept: "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive"
+          }
+        },
+        (res) => {
+          if (res.statusCode !== 200) {
+            return;
+          }
+          let buffer = "";
+          res.setEncoding("utf8");
+          res.on("data", (chunk) => {
+            buffer += chunk;
+            const lines = buffer.split("\n\n");
+            buffer = lines.pop() || "";
+            for (const block of lines) {
+              const trimmed = block.trim();
+              if (!trimmed.startsWith("data:")) continue;
+              const jsonStr = trimmed.replace(/^data:\s*/, "");
+              try {
+                const event = JSON.parse(jsonStr);
+                if (event.type === "connected") {
+                  if (event.pendingCount > 0) {
+                    getRemoteOrLocalPendingJob().then((pending) => {
+                      if (pending) done(pending);
+                    });
+                  }
+                } else if (event.type === "job_created" && event.job) {
+                  done(event.job);
+                }
+              } catch {
+              }
+            }
+          });
+          res.on("end", () => {
+            if (!resolved) {
+              const pending = bridgeJobStore.getPendingJob();
+              if (pending) {
+                done(pending);
+              }
+            }
+          });
+          res.on("error", () => {
+          });
+        }
+      );
+      req.on("error", () => {
+      });
+    } catch {
+    }
+  });
+}
+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;
+  const bridgeUrl = input.bridgeUrl || "http://127.0.0.1:5174";
+  const immediateJob = await getRemoteOrLocalPendingJob();
+  if (immediateJob) {
+    bridgeJobStore.markProcessing(immediateJob.id);
+    return formatJobResponse(immediateJob);
+  }
+  const job = await waitForNextJob(bridgeUrl, timeoutMs);
+  if (!job) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `\u{1F7E2} **Modo Watch do LinkeGringo Ativo** (Bridge porta 5174)
+
+Nenhum job recebido nos \xFAltimos ${timeoutSeconds} segundos.
+A interface web est\xE1 conectada ao Bridge. Assim que o usu\xE1rio clicar em **Analisar com Agente MCP**, **Iniciar Entrevista** ou **Gerar Perfil Reescrito**, execute a tool \`watch_linkegringo\` novamente para receber e processar os dados!`
+        }
+      ],
+      structuredData: {
+        status: "waiting",
+        timeoutSeconds,
+        pendingCount: bridgeJobStore.getPendingCount(),
+        serverOnline: true
+      }
+    };
+  }
+  bridgeJobStore.markProcessing(job.id);
+  return formatJobResponse(job);
+}
+
 // src/server.ts
 function createLinkeGringoMcpServer() {
   const server = new McpServer({
@@ -1454,6 +1670,16 @@ function createLinkeGringoMcpServer() {
       return await handleSubmitJobResult(args);
     }
   );
+  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.",
+      inputSchema: watchLinkeGringoInputSchema.shape
+    },
+    async (args) => {
+      return await handleWatchLinkeGringo(args);
+    }
+  );
   server.registerResource(
     "guidelines",
     "linkegringo://guidelines",
@@ -1671,7 +1897,7 @@ function runInstaller(args = process.argv) {
 }
 
 // src/bridge/server.ts
-import http from "http";
+import http2 from "http";
 function setCorsHeaders(res) {
   res.setHeader("Access-Control-Allow-Origin", "*");
   res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
@@ -1704,7 +1930,8 @@ async function parseBody(req) {
   });
 }
 function createBridgeHttpServer(options = {}) {
-  const server = http.createServer(async (req, res) => {
+  const activeSseClients = /* @__PURE__ */ new Map();
+  const server = http2.createServer(async (req, res) => {
     setCorsHeaders(res);
     if (req.method === "OPTIONS") {
       res.writeHead(204);
@@ -1740,11 +1967,25 @@ function createBridgeHttpServer(options = {}) {
         return;
       }
       if (req.method === "POST" && pathname === "/api/bridge/disconnect") {
-        const canceledCount = bridgeJobStore.cancelAllPending("Cancelado pelo usu\xE1rio na interface web.");
+        for (const [id, client] of activeSseClients.entries()) {
+          try {
+            client.res.write(
+              `data: ${JSON.stringify({ type: "disconnect", message: "Desconectado pelo usu\xE1rio na interface web." })}
+
+`
+            );
+            client.res.end();
+          } catch {
+          }
+          client.cleanup();
+        }
+        activeSseClients.clear();
+        const { canceledCount, clearedCount } = bridgeJobStore.resetQueue();
         sendJson(res, 200, {
           ok: true,
           message: "Conex\xE3o cancelada e fila de jobs limpa com sucesso.",
-          canceledCount
+          canceledCount,
+          clearedCount
         });
         return;
       }
@@ -1784,13 +2025,16 @@ function createBridgeHttpServer(options = {}) {
 
 `);
         }, 15e3);
-        req.on("close", () => {
+        const cleanup = () => {
           clearInterval(heartbeat);
           bridgeJobStore.unregisterWatcher(watcherId);
           bridgeJobStore.off("job:created", onJobCreated);
           bridgeJobStore.off("job:completed", onJobCompleted);
           bridgeJobStore.off("job:failed", onJobFailed);
-        });
+          activeSseClients.delete(watcherId);
+        };
+        activeSseClients.set(watcherId, { res, cleanup });
+        req.on("close", cleanup);
         return;
       }
       if (req.method === "POST" && pathname === "/api/jobs") {
@@ -1919,7 +2163,7 @@ async function stopBridgeServer() {
 }
 
 // src/bridge/watcher.ts
-import http2 from "http";
+import http3 from "http";
 function startBridgeWatcher(options = {}) {
   const bridgeUrl = options.bridgeUrl || process.env.LINKEGRINGO_BRIDGE_URL || "http://127.0.0.1:5174";
   let isClosed = false;
@@ -1930,7 +2174,7 @@ function startBridgeWatcher(options = {}) {
     if (isClosed) return;
     try {
       const url = new URL("/api/jobs/stream", bridgeUrl);
-      const req = http2.get(
+      const req = http3.get(
         url.toString(),
         {
           headers: {
@@ -1981,6 +2225,17 @@ function startBridgeWatcher(options = {}) {
                       console.log(
                         `[LinkeGringo Watcher] \u26A0\uFE0F Job cancelado ou com erro: ${payload.job.id} (${payload.job.error})`
                       );
+                    } else if (payload.type === "disconnect") {
+                      console.log(
+                        `
+[LinkeGringo Watcher] \u{1F6D1} Conex\xE3o encerrada pelo servidor (desconectado via interface web).`
+                      );
+                      isClosed = true;
+                      if (currentReq) {
+                        currentReq.destroy();
+                        currentReq = null;
+                      }
+                      setTimeout(() => process.exit(0), 50);
                     }
                   } catch {
                   }
@@ -2099,6 +2354,7 @@ export {
   handleGetPendingJob,
   handleSimulateRecruiterSearch,
   handleSubmitJobResult,
+  handleWatchLinkeGringo,
   installMcpServerConfig,
   parseArgs,
   runInstaller,
@@ -2106,5 +2362,7 @@ export {
   startBridgeServer,
   startBridgeWatcher,
   stopBridgeServer,
-  submitJobResultInputSchema
+  submitJobResultInputSchema,
+  waitForNextJob,
+  watchLinkeGringoInputSchema
 };

package/package.json

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