@coldiq/mcp 0.3.12 → 0.3.14

package/dist/verb-client.js

@@ -0,0 +1,57 @@
+import { callApi } from './client.js';
+export async function callVerb(verbPath, input, opts) {
+    // 1. Rename any schema-drift field names before splitting the envelope.
+    let work = input;
+    if (opts?.remap) {
+        work = {};
+        for (const [k, v] of Object.entries(input)) {
+            work[opts.remap[k] ?? k] = v;
+        }
+    }
+    const { use_providers, fields, reveal, ...rest } = work;
+    // 2. Resolve the provider pin: explicit use_providers wins; otherwise a
+    //    tool-specific provider field (e.g. search_places `provider`).
+    let providerPin = Array.isArray(use_providers) && use_providers.length ? use_providers : undefined;
+    if (opts?.providerFromField && rest[opts.providerFromField] !== undefined) {
+        const v = rest[opts.providerFromField];
+        delete rest[opts.providerFromField];
+        if (!providerPin && typeof v === 'string' && v)
+            providerPin = [v];
+    }
+    // 3. Build the envelope (single vs bulk).
+    let envelope;
+    let list;
+    if (opts?.bulkField) {
+        const { [opts.bulkField]: l, ...siblings } = rest;
+        list = Array.isArray(l) ? l : [];
+        envelope = { ...siblings, inputs: list };
+    }
+    else {
+        envelope = { input: rest };
+    }
+    if (providerPin)
+        envelope.provider = providerPin;
+    if (fields !== undefined)
+        envelope.fields = fields;
+    if (reveal !== undefined)
+        envelope.reveal = reveal;
+    const res = await callApi('POST', verbPath, envelope);
+    // 4. Re-attach the per-item correlation id to bulk results (positional).
+    let data = res.data;
+    if (opts?.reattachIdField && opts?.bulkField && list &&
+        data && typeof data === 'object' && Array.isArray(data.results)) {
+        const idField = opts.reattachIdField;
+        const results = data.results.map((r, i) => {
+            const id = list?.[i]?.[idField];
+            return id !== undefined && r && typeof r === 'object' && !Array.isArray(r)
+                ? { [idField]: id, ...r }
+                : r;
+        });
+        data = { ...data, results };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data) }],
+        isError: !res.ok,
+    };
+}
+//# sourceMappingURL=verb-client.js.map

package/dist/verb-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verb-client.js","sourceRoot":"","sources":["../src/verb-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldiq/mcp",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/client.ts

@@ -16,7 +16,12 @@ let _httpTimeoutMs: number
 export function initClient(apiUrl?: string, apiKey?: string): void {
   _apiUrl = apiUrl ?? process.env.COLDIQ_API_URL ?? 'https://api.coldiq.com'
   _apiKey = apiKey ?? process.env.COLDIQ_API_KEY ?? ''
-  _httpTimeoutMs = parseInt(process.env.COLDIQ_HTTP_TIMEOUT_MS ?? '30000', 10)
+  // Default 120s: each tool now makes ONE call that runs the FULL provider
+  // waterfall server-side, and async-tier verbs (find_people via LeadsFactory,
+  // search_jobs/places, etc.) routinely take 20-90s. The old 30s default — fine
+  // when the waterfall ran locally with per-provider budgets — times out those
+  // verbs intermittently. Override with COLDIQ_HTTP_TIMEOUT_MS.
+  _httpTimeoutMs = parseInt(process.env.COLDIQ_HTTP_TIMEOUT_MS ?? '120000', 10)
   if (!_apiKey) {
     throw new Error('COLDIQ_API_KEY is required — set it in .mcp.json env or as an environment variable')
   }

package/src/tools/enrich-company.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
-import { executeWithFallback, isExecutionError } from '../executor.js'
-import { resolvePreferredProviders, getProvidersForCapability } from '../utils/provider-resolver.js'
+import { callVerb } from '../verb-client.js'
+import { getProvidersForCapability } from '../utils/provider-resolver.js'
 
 export const enrichCompanyName = 'enrich_company'
 
@@ -15,18 +15,5 @@ export const enrichCompanySchema = {
 }
 
 export async function enrichCompanyHandler(input: Record<string, unknown>) {
-  const { use_providers: rawUseProviders, ...restInput } = input
-  if (!restInput.domain && !restInput.linkedin_url && !restInput.name) {
-    const err = { error: 'At least one of domain, linkedin_url, or name is required', providers_tried: [] }
-    return { content: [{ type: 'text' as const, text: JSON.stringify(err) }], isError: true }
-  }
-  const resolved = resolvePreferredProviders('enrich_company', restInput, rawUseProviders)
-  if (!resolved.ok) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(resolved.error) }], isError: true }
-  }
-  const result = await executeWithFallback('enrich_company', restInput, { providers: resolved.providers, matchedFrom: resolved.matchedFrom })
-  if (isExecutionError(result)) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(result) }], isError: true }
-  }
-  return { content: [{ type: 'text' as const, text: JSON.stringify(result) }] }
+  return callVerb('/company/enrich', input)
 }

package/src/tools/enrich-person.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
-import { executeWithFallback, isExecutionError } from '../executor.js'
-import { resolvePreferredProviders, getProvidersForCapability } from '../utils/provider-resolver.js'
+import { callVerb } from '../verb-client.js'
+import { getProvidersForCapability } from '../utils/provider-resolver.js'
 
 export const enrichPersonName = 'enrich_person'
 
@@ -22,14 +22,5 @@ export const enrichPersonSchema = {
 }
 
 export async function enrichPersonHandler(input: Record<string, unknown>) {
-  const { use_providers: rawUseProviders, ...restInput } = input
-  const resolved = resolvePreferredProviders('enrich_person', restInput, rawUseProviders)
-  if (!resolved.ok) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(resolved.error) }], isError: true }
-  }
-  const result = await executeWithFallback('enrich_person', restInput, { providers: resolved.providers, matchedFrom: resolved.matchedFrom })
-  if (isExecutionError(result)) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(result) }], isError: true }
-  }
-  return { content: [{ type: 'text' as const, text: JSON.stringify(result) }] }
+  return callVerb('/person/enrich', input)
 }

package/src/tools/fetch-page-content.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
-import { executeWithFallback, isExecutionError } from '../executor.js'
-import { resolvePreferredProviders, getProvidersForCapability } from '../utils/provider-resolver.js'
+import { callVerb } from '../verb-client.js'
+import { getProvidersForCapability } from '../utils/provider-resolver.js'
 
 export const fetchPageContentName = 'fetch_page_content'
 
@@ -30,14 +30,5 @@ export const fetchPageContentSchema = {
 }
 
 export async function fetchPageContentHandler(input: Record<string, unknown>) {
-  const { use_providers: rawUseProviders, ...restInput } = input
-  const resolved = resolvePreferredProviders('fetch_page_content', restInput, rawUseProviders)
-  if (!resolved.ok) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(resolved.error) }], isError: true }
-  }
-  const result = await executeWithFallback('fetch_page_content', restInput, { providers: resolved.providers, matchedFrom: resolved.matchedFrom })
-  if (isExecutionError(result)) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(result) }], isError: true }
-  }
-  return { content: [{ type: 'text' as const, text: JSON.stringify(result) }] }
+  return callVerb('/web/fetch', input)
 }

package/src/tools/find-email.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
-import { executeWithFallback, isExecutionError } from '../executor.js'
-import { resolvePreferredProviders, getProvidersForCapability } from '../utils/provider-resolver.js'
+import { callVerb } from '../verb-client.js'
+import { getProvidersForCapability } from '../utils/provider-resolver.js'
 
 export const findEmailName = 'find_email'
 
@@ -19,45 +19,6 @@ export const findEmailSchema = {
   use_providers: z.array(z.string()).optional().describe(`Optional ordered list of providers to use. Leave empty to let ColdIQ automatically pick the best tool for your inputs — recommended for most use cases. Available providers: ${getProvidersForCapability('find_email').join(', ')}. Provider names are matched fuzzily, so minor typos are tolerated.`),
 }
 
-const inputSchema = z
-  .object({
-    first_name: z.string().optional(),
-    last_name: z.string().optional(),
-    domain: z.string().optional(),
-    company_name: z.string().optional(),
-    linkedin_url: z.string().optional(),
-  })
-  .superRefine((val, ctx) => {
-    const hasLinkedIn = typeof val.linkedin_url === 'string' && val.linkedin_url.length > 0
-    const hasName = typeof val.first_name === 'string' && val.first_name.length > 0
-    const hasDomain =
-      (typeof val.domain === 'string' && val.domain.length > 0) ||
-      (typeof val.company_name === 'string' && val.company_name.length > 0)
-    if (!hasLinkedIn && !(hasName && hasDomain)) {
-      ctx.addIssue({
-        code: 'custom',
-        message: 'Provide either linkedin_url or both first_name and domain/company_name',
-      })
-    }
-  })
-
 export async function findEmailHandler(input: Record<string, unknown>) {
-  const { use_providers: rawUseProviders, ...restInput } = input
-  const resolved = resolvePreferredProviders('find_email', restInput, rawUseProviders)
-  if (!resolved.ok) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(resolved.error) }], isError: true }
-  }
-  const validation = inputSchema.safeParse(restInput)
-  if (!validation.success) {
-    const msg = validation.error.issues.map((i) => i.message).join('; ')
-    return {
-      content: [{ type: 'text' as const, text: JSON.stringify({ error: msg }) }],
-      isError: true,
-    }
-  }
-  const result = await executeWithFallback('find_email', restInput, { providers: resolved.providers, matchedFrom: resolved.matchedFrom })
-  if (isExecutionError(result)) {
-    return { content: [{ type: 'text' as const, text: JSON.stringify(result) }], isError: true }
-  }
-  return { content: [{ type: 'text' as const, text: JSON.stringify(result) }] }
+  return callVerb('/email/find', input)
 }