@coldiq/mcp 0.3.11 → 0.3.13

package/dist/verb-client.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Thin client for the deployed /v1 GTM verb endpoints.
+ *
+ * Each verb takes an envelope `{ input: {...filters}, provider?, fields?, reveal? }`
+ * (or `{ inputs: [...] }` for bulk) and returns `{ data, _meta }` (or `{ results }`
+ * for bulk, or `{ error, providers_tried }` on failure with a 4xx/5xx status).
+ *
+ * The MCP tool schemas expose `use_providers` (the ordered provider list) and the
+ * optional `fields` / `reveal` knobs alongside the verb's filter fields. This helper
+ * splits those out and maps everything else into the verb envelope, so each tool
+ * handler collapses to a single delegating call.
+ *
+ * A few MCP tool schemas predate the verb input schemas and need light mapping:
+ *   - `remap`: rename input keys before building the envelope (e.g. find_phone's
+ *     `company_domain` → the verb's `domain`).
+ *   - `providerFromField`: a tool-specific provider-pin field (e.g. search_places'
+ *     `provider: openmart|google_maps`) → the envelope's provider list.
+ *   - `reattachIdField`: bulk verbs return `results` positionally with no echo of the
+ *     per-item correlation id, so re-attach `input[bulkField][i][id]` onto `results[i]`
+ *     so callers can still match results back.
+ */
+export interface CallVerbOptions {
+    bulkField?: string;
+    remap?: Record<string, string>;
+    providerFromField?: string;
+    reattachIdField?: string;
+}
+export declare function callVerb(verbPath: string, input: Record<string, unknown>, opts?: CallVerbOptions): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+    isError?: boolean;
+}>;
+//# sourceMappingURL=verb-client.d.ts.map

package/dist/verb-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verb-client.d.ts","sourceRoot":"","sources":["../src/verb-client.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA0D3E"}

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.11",
+  "version": "0.3.13",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/client.ts

@@ -1,4 +1,5 @@
 import { Agent, setGlobalDispatcher } from 'undici'
+import { recordChargeFromHeaders } from './session-usage.js'
 
 export type ApiResponse = {
   ok: boolean
@@ -75,6 +76,9 @@ export async function callApi(
     res.headers.forEach((value, key) => {
       headers[key.toLowerCase()] = value
     })
+    // Tally this call's credit charge for the per-session usage report. No-op
+    // unless the response carries a charge header, so polls/errors are skipped.
+    recordChargeFromHeaders(path, headers)
     return { ok: res.ok, status: res.status, data, headers }
   } catch (err) {
     const isTimeout =

package/src/index.ts

@@ -130,6 +130,13 @@ import {
   getCreditBalanceHandler,
 } from './tools/get-credit-balance.js'
 
+import {
+  getSessionUsageName,
+  getSessionUsageDescription,
+  getSessionUsageSchema,
+  getSessionUsageHandler,
+} from './tools/get-session-usage.js'
+
 import {
   extractPostEngagementName,
   extractPostEngagementDescription,
@@ -192,6 +199,7 @@ server.tool(searchSeoName, searchSeoDescription, searchSeoSchema, searchSeoHandl
 server.tool(findSignalsName, findSignalsDescription, findSignalsSchema, findSignalsHandler)
 server.tool(fetchPageContentName, fetchPageContentDescription, fetchPageContentSchema, fetchPageContentHandler)
 server.tool(getCreditBalanceName, getCreditBalanceDescription, getCreditBalanceSchema, getCreditBalanceHandler)
+server.tool(getSessionUsageName, getSessionUsageDescription, getSessionUsageSchema, getSessionUsageHandler)
 server.tool(listDataSourcesName, listDataSourcesDescription, listDataSourcesSchema, listDataSourcesHandler)
 server.tool(extractPostEngagementName, extractPostEngagementDescription, extractPostEngagementSchema, extractPostEngagementHandler)
 server.tool(getPlaceReviewsName, getPlaceReviewsDescription, getPlaceReviewsSchema, getPlaceReviewsHandler)

package/src/session-usage.ts

@@ -0,0 +1,130 @@
+/**
+ * In-process ColdIQ credit accumulator for one MCP session ("campaign").
+ *
+ * The ColdIQ MCP server runs as a stdio subprocess spawned per client
+ * conversation, so a module-level singleton here is naturally scoped to a
+ * single campaign: it starts empty when the process boots and is discarded
+ * when the conversation's server exits. We tally the per-call charges the API
+ * already reports via the `X-ColdIQ-Credits-Charged` / `-Remaining` response
+ * headers (the same signal the executor surfaces in `_meta`), so reporting
+ * session spend never issues an extra billable call.
+ *
+ * Caveats this module deliberately accepts (and the tool surfaces to the user):
+ * - It only counts calls made during the current process lifetime; resuming or
+ *   restarting the conversation starts a fresh tally.
+ * - `charged` reflects what the API billed at call time. For async jobs that is
+ *   the submit-time reservation; later webhook settlement is not visible here.
+ */
+
+const CHARGED_HEADER = 'x-coldiq-credits-charged'
+const REMAINING_HEADER = 'x-coldiq-credits-remaining'
+
+export interface EndpointUsage {
+  /** Number of billed calls to this endpoint this session. */
+  calls: number
+  /** Total net ColdIQ credits charged across those calls. */
+  credits: number
+}
+
+export interface SessionUsageSnapshot {
+  /** ISO 8601 timestamp of when this MCP session (process) started. */
+  startedAt: string
+  /** Milliseconds elapsed since the session started. */
+  durationMs: number
+  /** Count of calls that charged credits this session. */
+  billedCalls: number
+  /** Sum of net credits charged across all billed calls this session. */
+  totalCreditsCharged: number
+  /** Balance the API reported after the most recent billed call, if any. */
+  balanceAfterLastCharge?: number
+  /** Per-endpoint breakdown, highest spend first. */
+  byEndpoint: Array<{ endpoint: string; calls: number; credits: number }>
+}
+
+interface MutableState {
+  startedAt: number
+  billedCalls: number
+  totalCreditsCharged: number
+  balanceAfterLastCharge?: number
+  byEndpoint: Map<string, EndpointUsage>
+}
+
+const state: MutableState = {
+  startedAt: Date.now(),
+  billedCalls: 0,
+  totalCreditsCharged: 0,
+  byEndpoint: new Map(),
+}
+
+function parseHeaderNumber(raw: string | undefined): number | undefined {
+  if (raw === undefined) return undefined
+  const n = Number(raw)
+  return Number.isFinite(n) ? n : undefined
+}
+
+// Credits can be fractional (settlement refunds). Round to 4 dp so summed
+// floating-point noise never leaks into the reported totals.
+function round(n: number): number {
+  return Math.round(n * 10000) / 10000
+}
+
+/**
+ * Record a single billed call. `charged` is the net credits for this call;
+ * `remaining`, when present, is the authoritative balance afterwards.
+ * Non-finite or negative charges are ignored so a malformed header can't
+ * corrupt the running total.
+ */
+export function recordCharge(endpoint: string, charged: number, remaining?: number): void {
+  if (!Number.isFinite(charged) || charged < 0) return
+  state.billedCalls += 1
+  state.totalCreditsCharged += charged
+  if (remaining !== undefined && Number.isFinite(remaining)) {
+    state.balanceAfterLastCharge = remaining
+  }
+  const existing = state.byEndpoint.get(endpoint)
+  if (existing) {
+    existing.calls += 1
+    existing.credits += charged
+  } else {
+    state.byEndpoint.set(endpoint, { calls: 1, credits: charged })
+  }
+}
+
+/**
+ * Record a charge from a response's (lowercased) header map. A no-op when the
+ * response carries no charge header — polls, errors, and unbilled routes are
+ * silently skipped, so this is safe to call after every request.
+ */
+export function recordChargeFromHeaders(endpoint: string, headers: Record<string, string>): void {
+  const charged = parseHeaderNumber(headers[CHARGED_HEADER])
+  if (charged === undefined) return
+  recordCharge(endpoint, charged, parseHeaderNumber(headers[REMAINING_HEADER]))
+}
+
+/** Build a snapshot of session spend so far. `now` is injectable for tests. */
+export function getSessionUsage(now: number = Date.now()): SessionUsageSnapshot {
+  const byEndpoint = Array.from(state.byEndpoint.entries())
+    .map(([endpoint, u]) => ({ endpoint, calls: u.calls, credits: round(u.credits) }))
+    .sort((a, b) => b.credits - a.credits)
+
+  const snap: SessionUsageSnapshot = {
+    startedAt: new Date(state.startedAt).toISOString(),
+    durationMs: now - state.startedAt,
+    billedCalls: state.billedCalls,
+    totalCreditsCharged: round(state.totalCreditsCharged),
+    byEndpoint,
+  }
+  if (state.balanceAfterLastCharge !== undefined) {
+    snap.balanceAfterLastCharge = state.balanceAfterLastCharge
+  }
+  return snap
+}
+
+/** Test-only: reset the accumulator to a known clean state. */
+export function resetSessionUsage(startedAt: number = Date.now()): void {
+  state.startedAt = startedAt
+  state.billedCalls = 0
+  state.totalCreditsCharged = 0
+  state.balanceAfterLastCharge = undefined
+  state.byEndpoint.clear()
+}

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)
 }