@linkegringo/mcp 1.0.5 → 1.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muriel Gasparini
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,72 +1,11 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import http from 'node:http';
+import { EventEmitter } from 'node:events';
 import { z } from 'zod';
 import { Experience } from '@linkegringo/core';
 
 declare function createLinkeGringoMcpServer(): McpServer;
 
-interface ChromeVersionResponse {
-    Browser: string;
-    'Protocol-Version': string;
-    'User-Agent': string;
-    'V8-Version': string;
-    'WebKit-Version': string;
-    webSocketDebuggerUrl?: string;
-}
-interface ChromeTabInfo {
-    id: string;
-    title: string;
-    type: string;
-    url: string;
-    description?: string;
-    webSocketDebuggerUrl?: string;
-    devtoolsFrontendUrl?: string;
-}
-interface LinkeGringoTabInfo {
-    id: string;
-    title: string;
-    url: string;
-    webSocketDebuggerUrl?: string;
-}
-interface LinkeGringoSessionState {
-    hasUploadedProfile: boolean;
-    candidateName?: string;
-    targetRole?: string;
-    step?: string;
-    inboundScore?: number;
-    profile?: any;
-    review?: any;
-}
-interface CdpStatus {
-    isRunning: boolean;
-    port: number;
-    host: string;
-    browser?: string;
-    protocolVersion?: string;
-    /**
-     * Abas ativas restritas estritamente ao escopo do LinkeGringo (Privacy Shield).
-     * Abas pessoais (e-mails, mensageiros, bancos) são completamente omitidas.
-     */
-    activeTabs: LinkeGringoTabInfo[];
-    linkeGringoTabs: LinkeGringoTabInfo[];
-    otherTabsCount: number;
-    linkeGringoTabFound: boolean;
-    linkeGringoTabUrl?: string;
-    sessionState?: LinkeGringoSessionState | null;
-    error?: string;
-}
-
-declare function isLinkeGringoUrl(url?: string): boolean;
-declare function findDevToolsActivePort(): {
-    port: number;
-    wsPath: string;
-} | null;
-declare function probeViaWebSocket(port: number, wsPath: string, timeoutMs?: number): Promise<{
-    linkeGringoTabs: LinkeGringoTabInfo[];
-    otherTabsCount: number;
-    sessionState: LinkeGringoSessionState | null;
-} | null>;
-declare function checkChromeCdp(port?: number, host?: string, timeoutMs?: number): Promise<CdpStatus>;
-
 interface McpTarget {
     id: string;
     client: string;
@@ -92,6 +31,87 @@ declare function installMcpServerConfig(configPath: string): {
 declare function parseArgs(args?: string[]): InstallerOptions;
 declare function runInstaller(args?: string[]): InstallResult[];
 
+type JobType = 'parse_and_diagnose' | 'generate_interview' | 'evaluate_progress' | 'generate_rewritten_profile' | 'chat_message';
+type JobStatus = 'pending' | 'processing' | 'completed' | 'failed';
+interface BridgeJob<TPayload = any, TResult = any> {
+    id: string;
+    type: JobType;
+    payload: TPayload;
+    status: JobStatus;
+    createdAt: number;
+    updatedAt: number;
+    result?: TResult;
+    error?: string;
+}
+interface BridgeServerOptions {
+    port?: number;
+    host?: string;
+    onJobCreated?: (job: BridgeJob) => void;
+}
+
+declare function createBridgeHttpServer(options?: BridgeServerOptions): http.Server;
+declare function startBridgeServer(options?: BridgeServerOptions): Promise<{
+    server: http.Server;
+    port: number;
+    close: () => Promise<void>;
+}>;
+declare function stopBridgeServer(): Promise<void>;
+
+/**
+ * Busca o próximo job pendente no Bridge HTTP local (porta 5174).
+ * Se o bridge HTTP estiver offline ou inacessível, realiza fallback para o bridgeJobStore em memória.
+ */
+declare function getRemoteOrLocalPendingJob(jobId?: string, bridgeUrl?: string): Promise<BridgeJob | undefined>;
+/**
+ * Conclui um job enviando o resultado estruturado para o Bridge HTTP local.
+ * Se o bridge HTTP estiver offline, conclui diretamente na store em memória.
+ */
+declare function completeRemoteOrLocalJob(jobId: string, result: any, bridgeUrl?: string): Promise<BridgeJob>;
+/**
+ * Marca um job com falha no Bridge HTTP local ou na store em memória.
+ */
+declare function failRemoteOrLocalJob(jobId: string, error: string, bridgeUrl?: string): Promise<BridgeJob>;
+
+interface WatcherOptions {
+    bridgeUrl?: string;
+    once?: boolean;
+    onJob?: (job: {
+        id: string;
+        type: string;
+        createdAt: number;
+    }) => void;
+    onConnect?: (info: {
+        watcherId: string;
+        pendingCount: number;
+    }) => void;
+    onError?: (err: Error) => void;
+}
+declare function startBridgeWatcher(options?: WatcherOptions): {
+    close: () => void;
+};
+
+declare class BridgeJobStore extends EventEmitter {
+    private jobs;
+    private pendingQueue;
+    createJob<TPayload = any>(type: JobType, payload: TPayload): BridgeJob<TPayload>;
+    getJob(id: string): BridgeJob | undefined;
+    getPendingJob(id?: string): BridgeJob | undefined;
+    markProcessing(id: string): BridgeJob | undefined;
+    completeJob<TResult = any>(id: string, result: TResult): BridgeJob;
+    failJob(id: string, error: string): BridgeJob;
+    waitForJob(id: string, timeoutMs?: number): Promise<BridgeJob>;
+    getAllJobs(): BridgeJob[];
+    getPendingCount(): number;
+    private activeWatchers;
+    registerWatcher(id: string): void;
+    unregisterWatcher(id: string): void;
+    getWatcherCount(): number;
+    hasActiveWatcher(): boolean;
+    cancelAllPending(reason?: string): number;
+    clear(): void;
+}
+declare const bridgeJobStore: BridgeJobStore;
+
 interface SparseExperience {
     company: string;
     title: string;
@@ -166,9 +186,11 @@ declare function handleAuditProfile(input: AuditProfileInput): Promise<{
     }[];
     structuredData: {
         status: string;
-        linkeGringoTabUrl: string | undefined;
-        message: string;
+        jobId: string;
+        jobType: JobType;
+        payload: any;
         actionRequired: string;
+        message?: undefined;
         score?: undefined;
         targetRole?: undefined;
         headline?: undefined;
@@ -187,7 +209,9 @@ declare function handleAuditProfile(input: AuditProfileInput): Promise<{
         status: string;
         message: string;
         actionRequired: string;
-        linkeGringoTabUrl?: undefined;
+        jobId?: undefined;
+        jobType?: undefined;
+        payload?: undefined;
         score?: undefined;
         targetRole?: undefined;
         headline?: undefined;
@@ -212,9 +236,11 @@ declare function handleAuditProfile(input: AuditProfileInput): Promise<{
         triageBottlenecks: string[];
         issues: AuditIssue[];
         status?: undefined;
-        linkeGringoTabUrl?: undefined;
-        message?: undefined;
+        jobId?: undefined;
+        jobType?: undefined;
+        payload?: undefined;
         actionRequired?: undefined;
+        message?: undefined;
     };
 }>;
 
@@ -347,26 +373,94 @@ declare function handleGenerateHeadline(input: GenerateHeadlineInput): Promise<{
     };
 }>;
 
-declare const checkChromeCdpInputSchema: z.ZodObject<{
-    port: z.ZodDefault<z.ZodNumber>;
-    host: z.ZodDefault<z.ZodString>;
-    timeoutMs: z.ZodDefault<z.ZodNumber>;
+declare const getPendingJobInputSchema: z.ZodObject<{
+    jobId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    port: number;
-    host: string;
-    timeoutMs: number;
+    jobId?: string | undefined;
+}, {
+    jobId?: string | undefined;
+}>;
+type GetPendingJobInput = z.infer<typeof getPendingJobInputSchema>;
+declare function handleGetPendingJob(input?: GetPendingJobInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredData: {
+        jobFound: boolean;
+        pendingCount: number;
+        job?: undefined;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredData: {
+        jobFound: boolean;
+        job: {
+            id: string;
+            type: JobType;
+            payload: any;
+            createdAt: number;
+        };
+        pendingCount?: undefined;
+    };
+}>;
+
+declare const submitJobResultInputSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    result: z.ZodAny;
+    status: z.ZodDefault<z.ZodEnum<["completed", "failed"]>>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "failed";
+    jobId: string;
+    result?: any;
+    error?: string | undefined;
 }, {
-    port?: number | undefined;
-    host?: string | undefined;
-    timeoutMs?: number | undefined;
+    jobId: string;
+    result?: any;
+    error?: string | undefined;
+    status?: "completed" | "failed" | undefined;
 }>;
-type CheckChromeCdpInput = z.infer<typeof checkChromeCdpInputSchema>;
-declare function handleCheckChromeCdp(input: CheckChromeCdpInput): Promise<{
+type SubmitJobResultInput = z.infer<typeof submitJobResultInputSchema>;
+declare function handleSubmitJobResult(input: SubmitJobResultInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredData: {
+        success: boolean;
+        jobId: string;
+        status: string;
+        type?: undefined;
+        error?: undefined;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredData: {
+        success: boolean;
+        jobId: string;
+        status: string;
+        type: JobType;
+        error?: undefined;
+    };
+} | {
     content: {
         type: "text";
         text: string;
     }[];
-    structuredData: CdpStatus;
+    structuredData: {
+        success: boolean;
+        error: any;
+        jobId?: undefined;
+        status?: undefined;
+        type?: undefined;
+    };
 }>;
 
-export { type AuditIssue, type AuditProfileInput, type CdpStatus, type CheckChromeCdpInput, type ChromeTabInfo, type ChromeVersionResponse, type ConvertToXyzBulletInput, type GenerateHeadlineInput, type InstallResult, type InstallerOptions, type LinkeGringoSessionState, type LinkeGringoTabInfo, type McpTarget, type SimulateRecruiterSearchInput, type SparseExperience, auditProfileInputSchema, checkChromeCdp, checkChromeCdpInputSchema, convertToXyzBulletInputSchema, createLinkeGringoMcpServer, detectSparseExperiences, findDevToolsActivePort, formatGoogleXyzBullet, generateHeadlineInputSchema, getExperienceBulletCount, getMcpConfigsForSystem, handleAuditProfile, handleCheckChromeCdp, handleConvertToXyzBullet, handleGenerateHeadline, handleSimulateRecruiterSearch, installMcpServerConfig, isLinkeGringoUrl, parseArgs, probeViaWebSocket, runInstaller, simulateRecruiterSearchInputSchema };
+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 };