@coldiq/mcp 0.3.11 → 0.3.12

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAMD,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAqBjE;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,WAAW,CAAC,CA0DtB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAMD,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAqBjE;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,WAAW,CAAC,CA6DtB"}

package/dist/client.js

@@ -1,4 +1,5 @@
 import { Agent, setGlobalDispatcher } from 'undici';
+import { recordChargeFromHeaders } from './session-usage.js';
 let _apiUrl;
 let _apiKey;
 let _httpTimeoutMs;
@@ -54,6 +55,9 @@ export async function callApi(method, path, body, queryParams) {
         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) {

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAU5D,IAAI,OAAe,CAAA;AACnB,IAAI,OAAe,CAAA;AACnB,IAAI,cAAsB,CAAA;AAE1B,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,MAAe;IACzD,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,wBAAwB,CAAA;IAC1E,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAA;IACpD,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,EAAE,EAAE,CAAC,CAAA;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAA;IACvG,CAAC;IACD,uBAAuB;IACvB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAErC,mEAAmE;IACnE,uFAAuF;IACvF,qFAAqF;IACrF,mBAAmB,CACjB,IAAI,KAAK,CAAC;QACR,gBAAgB,EAAE,MAAM;QACxB,mBAAmB,EAAE,MAAM;QAC3B,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,CAAC;KACd,CAAC,CACH,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAsB,EACtB,IAAY,EACZ,IAAc,EACd,WAAoC;IAEpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO,MAAM,IAAI,EAAE,CAAC,CAAA;IAC3C,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,OAAO,EAAE;KACnC,CAAA;IAED,MAAM,IAAI,GAAgB;QACxB,MAAM;QACN,OAAO;QACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC;KAC5C,CAAA;IAED,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAA;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAA;QAC7C,IAAI,IAAa,CAAA;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAA;QAChD,CAAC;QACD,MAAM,OAAO,GAA2B,EAAE,CAAA;QAC1C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAA;QACpC,CAAC,CAAC,CAAA;QACF,0EAA0E;QAC1E,4EAA4E;QAC5E,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACtC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GACb,GAAG,YAAY,KAAK;YACpB,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,CAAA;QAC5D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;gBACpC,OAAO,EAAE,EAAE;aACZ,CAAA;QACH,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACpG,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;YAChC,OAAO,EAAE,EAAE;SACZ,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -20,6 +20,7 @@ import { searchSeoName, searchSeoDescription, searchSeoSchema, searchSeoHandler,
 import { findSignalsName, findSignalsDescription, findSignalsSchema, findSignalsHandler, } from './tools/find-signals.js';
 import { fetchPageContentName, fetchPageContentDescription, fetchPageContentSchema, fetchPageContentHandler, } from './tools/fetch-page-content.js';
 import { getCreditBalanceName, getCreditBalanceDescription, getCreditBalanceSchema, getCreditBalanceHandler, } from './tools/get-credit-balance.js';
+import { getSessionUsageName, getSessionUsageDescription, getSessionUsageSchema, getSessionUsageHandler, } from './tools/get-session-usage.js';
 import { extractPostEngagementName, extractPostEngagementDescription, extractPostEngagementSchema, extractPostEngagementHandler, } from './tools/extract-post-engagement.js';
 import { getPlaceReviewsName, getPlaceReviewsDescription, getPlaceReviewsSchema, getPlaceReviewsHandler, } from './tools/get-place-reviews.js';
 import { listDataSourcesName, listDataSourcesDescription, listDataSourcesSchema, listDataSourcesHandler, } from './tools/list-data-sources.js';
@@ -59,6 +60,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/dist/index.js.map

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

package/dist/session-usage.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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.
+ */
+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;
+    }>;
+}
+/**
+ * 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 declare function recordCharge(endpoint: string, charged: number, remaining?: number): void;
+/**
+ * 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 declare function recordChargeFromHeaders(endpoint: string, headers: Record<string, string>): void;
+/** Build a snapshot of session spend so far. `now` is injectable for tests. */
+export declare function getSessionUsage(now?: number): SessionUsageSnapshot;
+/** Test-only: reset the accumulator to a known clean state. */
+export declare function resetSessionUsage(startedAt?: number): void;
+//# sourceMappingURL=session-usage.d.ts.map

package/dist/session-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-usage.d.ts","sourceRoot":"","sources":["../src/session-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,mDAAmD;IACnD,UAAU,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACxE;AA6BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAcxF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI/F;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAmB,GAAG,oBAAoB,CAgB9E;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAmB,GAAG,IAAI,CAMtE"}

package/dist/session-usage.js

@@ -0,0 +1,96 @@
+/**
+ * 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';
+const state = {
+    startedAt: Date.now(),
+    billedCalls: 0,
+    totalCreditsCharged: 0,
+    byEndpoint: new Map(),
+};
+function parseHeaderNumber(raw) {
+    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) {
+    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, charged, remaining) {
+    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, headers) {
+    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 = Date.now()) {
+    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 = {
+        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 = Date.now()) {
+    state.startedAt = startedAt;
+    state.billedCalls = 0;
+    state.totalCreditsCharged = 0;
+    state.balanceAfterLastCharge = undefined;
+    state.byEndpoint.clear();
+}
+//# sourceMappingURL=session-usage.js.map

package/dist/session-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-usage.js","sourceRoot":"","sources":["../src/session-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,cAAc,GAAG,0BAA0B,CAAA;AACjD,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAgCrD,MAAM,KAAK,GAAiB;IAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;IACrB,WAAW,EAAE,CAAC;IACd,mBAAmB,EAAE,CAAC;IACtB,UAAU,EAAE,IAAI,GAAG,EAAE;CACtB,CAAA;AAED,SAAS,iBAAiB,CAAC,GAAuB;IAChD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACvC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACrB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC3C,CAAC;AAED,0EAA0E;AAC1E,6DAA6D;AAC7D,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAe,EAAE,SAAkB;IAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAM;IACpD,KAAK,CAAC,WAAW,IAAI,CAAC,CAAA;IACtB,KAAK,CAAC,mBAAmB,IAAI,OAAO,CAAA;IACpC,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,sBAAsB,GAAG,SAAS,CAAA;IAC1C,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAA;QACnB,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAChE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,OAA+B;IACvF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;IAC1D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAM;IACjC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;SACjF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;IAExC,MAAM,IAAI,GAAyB;QACjC,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;QAClD,UAAU,EAAE,GAAG,GAAG,KAAK,CAAC,SAAS;QACjC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC;QACrD,UAAU;KACX,CAAA;IACD,IAAI,KAAK,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,CAAA;IAC5D,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,YAAoB,IAAI,CAAC,GAAG,EAAE;IAC9D,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,KAAK,CAAC,WAAW,GAAG,CAAC,CAAA;IACrB,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAA;IAC7B,KAAK,CAAC,sBAAsB,GAAG,SAAS,CAAA;IACxC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;AAC1B,CAAC"}

package/dist/tools/get-session-usage.d.ts

@@ -0,0 +1,10 @@
+export declare const getSessionUsageName = "get_session_usage";
+export declare const getSessionUsageDescription: string;
+export declare const getSessionUsageSchema: {};
+export declare function getSessionUsageHandler(_input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-session-usage.d.ts.map

package/dist/tools/get-session-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-usage.d.ts","sourceRoot":"","sources":["../../src/tools/get-session-usage.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,sBAAsB,CAAA;AAEtD,eAAO,MAAM,0BAA0B,QAMuB,CAAA;AAE9D,eAAO,MAAM,qBAAqB,IAAK,CAAA;AAEvC,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAG3E"}

package/dist/tools/get-session-usage.js

@@ -0,0 +1,14 @@
+import { getSessionUsage } from '../session-usage.js';
+export const getSessionUsageName = 'get_session_usage';
+export const getSessionUsageDescription = 'Report the ColdIQ credits spent so far in THIS conversation (the current MCP session). ' +
+    'Returns the total credits charged, the number of billed calls, a per-endpoint breakdown of where ' +
+    'credits went (highest spend first), and the account balance reported after the most recent billed call. ' +
+    'Use this to answer "how many credits has this chat used" or "what did I spend credits on here". ' +
+    'Note: it counts only calls made during the current session and resets if the conversation restarts; ' +
+    'for the authoritative live balance use get_credit_balance.';
+export const getSessionUsageSchema = {};
+export async function getSessionUsageHandler(_input) {
+    const usage = getSessionUsage();
+    return { content: [{ type: 'text', text: JSON.stringify({ data: usage }) }] };
+}
+//# sourceMappingURL=get-session-usage.js.map

package/dist/tools/get-session-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-usage.js","sourceRoot":"","sources":["../../src/tools/get-session-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAA;AAEtD,MAAM,CAAC,MAAM,0BAA0B,GACrC,yFAAyF;IACzF,mGAAmG;IACnG,0GAA0G;IAC1G,kGAAkG;IAClG,sGAAsG;IACtG,4DAA4D,CAAA;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEvC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAA+B;IAC1E,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldiq/mcp",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "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/get-session-usage.ts

@@ -0,0 +1,18 @@
+import { getSessionUsage } from '../session-usage.js'
+
+export const getSessionUsageName = 'get_session_usage'
+
+export const getSessionUsageDescription =
+  'Report the ColdIQ credits spent so far in THIS conversation (the current MCP session). ' +
+  'Returns the total credits charged, the number of billed calls, a per-endpoint breakdown of where ' +
+  'credits went (highest spend first), and the account balance reported after the most recent billed call. ' +
+  'Use this to answer "how many credits has this chat used" or "what did I spend credits on here". ' +
+  'Note: it counts only calls made during the current session and resets if the conversation restarts; ' +
+  'for the authoritative live balance use get_credit_balance.'
+
+export const getSessionUsageSchema = {}
+
+export async function getSessionUsageHandler(_input: Record<string, unknown>) {
+  const usage = getSessionUsage()
+  return { content: [{ type: 'text' as const, text: JSON.stringify({ data: usage }) }] }
+}

package/tests/executor.test.ts

@@ -1,6 +1,7 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
 import { initClient } from '../src/client.js'
 import { executeWithFallback } from '../src/executor.js'
+import { getSessionUsage, resetSessionUsage } from '../src/session-usage.js'
 import * as registry from '../src/registry.js'
 import type { ProviderEntry } from '../src/registry.js'
 
@@ -225,6 +226,74 @@ describe('executor exception safety', () => {
   })
 })
 
+// ---------------------------------------------------------------------------
+// Session-usage integration — the async create/poll path must record a charge
+// exactly once. Locks in the "no double count" guarantee against future
+// refactors of executeAsync's header merging.
+// ---------------------------------------------------------------------------
+
+describe('executor records session credit usage exactly once on the async path', () => {
+  const originalFetch = globalThis.fetch
+
+  beforeEach(() => {
+    initClient('http://test-api.local', 'test-key-123')
+    resetSessionUsage(0)
+  })
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+    vi.restoreAllMocks()
+  })
+
+  it('charge header on the create response is counted once; polls add nothing', async () => {
+    stubProviders([
+      makeProvider({
+        id: 'async-charged',
+        endpoint: '/async-charged',
+        hasResult: (data) => (data as Record<string, unknown>).done === true,
+        async: {
+          extractId: () => 'job-1',
+          pollEndpoint: (id) => `/poll/${id}`,
+          pollIntervalMs: 5,
+          timeoutMs: 500,
+          // Complete only once the poll body says so, forcing ≥1 poll round.
+          isComplete: (data) => (data as Record<string, unknown>).done === true,
+        },
+      }),
+    ])
+
+    let pollCount = 0
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const u = url.toString()
+      if (u.includes('/poll/')) {
+        pollCount++
+        // First poll still processing (no charge header), second completes.
+        const body = pollCount >= 2 ? { done: true } : { status: 'processing' }
+        return new Response(JSON.stringify(body), { status: 200 })
+      }
+      // Create response — carries the billing headers, like the real API.
+      return new Response(JSON.stringify({ job_id: 'job-1' }), {
+        status: 200,
+        headers: {
+          'X-ColdIQ-Credits-Charged': '5',
+          'X-ColdIQ-Credits-Remaining': '120',
+        },
+      })
+    }) as typeof fetch
+
+    const result = await executeWithFallback('find_people', { domain: 'coldiq.com' })
+
+    expect('data' in result).toBe(true)
+    expect(pollCount).toBeGreaterThanOrEqual(2)
+
+    const usage = getSessionUsage()
+    expect(usage.billedCalls).toBe(1)
+    expect(usage.totalCreditsCharged).toBe(5)
+    expect(usage.balanceAfterLastCharge).toBe(120)
+    expect(usage.byEndpoint).toEqual([{ endpoint: '/async-charged', calls: 1, credits: 5 }])
+  })
+})
+
 // ---------------------------------------------------------------------------
 // postFilter integration (existing tests)
 // ---------------------------------------------------------------------------

package/tests/session-usage.test.ts

@@ -0,0 +1,130 @@
+import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest'
+import {
+  recordCharge,
+  recordChargeFromHeaders,
+  getSessionUsage,
+  resetSessionUsage,
+} from '../src/session-usage.js'
+import { initClient, callApi } from '../src/client.js'
+
+describe('session-usage accumulator', () => {
+  beforeEach(() => {
+    resetSessionUsage(1_000)
+  })
+
+  it('starts empty', () => {
+    const usage = getSessionUsage(1_000)
+    expect(usage.billedCalls).toBe(0)
+    expect(usage.totalCreditsCharged).toBe(0)
+    expect(usage.byEndpoint).toEqual([])
+    expect(usage.balanceAfterLastCharge).toBeUndefined()
+    expect(usage.startedAt).toBe(new Date(1_000).toISOString())
+  })
+
+  it('accumulates charges and tracks the last reported balance', () => {
+    recordCharge('/prospeo/find-email', 1, 99)
+    recordCharge('/prospeo/find-email', 1, 98)
+    recordCharge('/companyenrich/companies/search', 3, 95)
+
+    const usage = getSessionUsage(2_000)
+    expect(usage.billedCalls).toBe(3)
+    expect(usage.totalCreditsCharged).toBe(5)
+    expect(usage.balanceAfterLastCharge).toBe(95)
+    expect(usage.durationMs).toBe(1_000)
+  })
+
+  it('breaks down per endpoint sorted by credits descending', () => {
+    recordCharge('/cheap', 1)
+    recordCharge('/expensive', 10)
+    recordCharge('/cheap', 1)
+
+    const { byEndpoint } = getSessionUsage()
+    expect(byEndpoint).toEqual([
+      { endpoint: '/expensive', calls: 1, credits: 10 },
+      { endpoint: '/cheap', calls: 2, credits: 2 },
+    ])
+  })
+
+  it('rounds fractional credit sums to avoid float noise', () => {
+    recordCharge('/x', 0.1)
+    recordCharge('/x', 0.2)
+    expect(getSessionUsage().totalCreditsCharged).toBe(0.3)
+  })
+
+  it('ignores malformed and negative charges', () => {
+    recordCharge('/x', Number.NaN)
+    recordCharge('/x', -5)
+    recordCharge('/x', Infinity)
+    const usage = getSessionUsage()
+    expect(usage.billedCalls).toBe(0)
+    expect(usage.totalCreditsCharged).toBe(0)
+  })
+
+  describe('recordChargeFromHeaders', () => {
+    it('records when the charge header is present', () => {
+      recordChargeFromHeaders('/find-email', {
+        'x-coldiq-credits-charged': '2',
+        'x-coldiq-credits-remaining': '198',
+      })
+      const usage = getSessionUsage()
+      expect(usage.billedCalls).toBe(1)
+      expect(usage.totalCreditsCharged).toBe(2)
+      expect(usage.balanceAfterLastCharge).toBe(198)
+    })
+
+    it('is a no-op when no charge header is present (e.g. a poll response)', () => {
+      recordChargeFromHeaders('/poll', { 'content-type': 'application/json' })
+      expect(getSessionUsage().billedCalls).toBe(0)
+    })
+
+    it('records the charge even when the remaining header is absent', () => {
+      recordChargeFromHeaders('/x', { 'x-coldiq-credits-charged': '4' })
+      const usage = getSessionUsage()
+      expect(usage.totalCreditsCharged).toBe(4)
+      expect(usage.balanceAfterLastCharge).toBeUndefined()
+    })
+  })
+})
+
+describe('callApi records credit charges into session usage', () => {
+  const originalFetch = globalThis.fetch
+
+  beforeEach(() => {
+    initClient('http://test-api.local', 'test-key')
+    resetSessionUsage(0)
+  })
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+  })
+
+  it('tallies a charge surfaced in response headers', async () => {
+    globalThis.fetch = vi.fn(async () =>
+      new Response(JSON.stringify({ email: 'michel@coldiq.com' }), {
+        status: 200,
+        headers: {
+          'X-ColdIQ-Credits-Charged': '1',
+          'X-ColdIQ-Credits-Remaining': '249',
+        },
+      }),
+    ) as typeof fetch
+
+    await callApi('POST', '/prospeo/find-email', { domain: 'coldiq.com' })
+
+    const usage = getSessionUsage()
+    expect(usage.billedCalls).toBe(1)
+    expect(usage.totalCreditsCharged).toBe(1)
+    expect(usage.balanceAfterLastCharge).toBe(249)
+    expect(usage.byEndpoint).toEqual([{ endpoint: '/prospeo/find-email', calls: 1, credits: 1 }])
+  })
+
+  it('does not tally calls that return no charge header', async () => {
+    globalThis.fetch = vi.fn(async () =>
+      new Response(JSON.stringify({ status: 'processing' }), { status: 200 }),
+    ) as typeof fetch
+
+    await callApi('GET', '/jobs/abc123')
+
+    expect(getSessionUsage().billedCalls).toBe(0)
+  })
+})

package/tests/tools/get-session-usage.test.ts

@@ -0,0 +1,44 @@
+import { describe, it, expect, beforeEach } from 'vitest'
+import {
+  getSessionUsageHandler,
+  getSessionUsageName,
+  getSessionUsageSchema,
+} from '../../src/tools/get-session-usage.js'
+import { recordCharge, resetSessionUsage } from '../../src/session-usage.js'
+
+describe('get_session_usage handler', () => {
+  beforeEach(() => {
+    resetSessionUsage()
+  })
+
+  it('is registered as a zero-arg tool', () => {
+    expect(getSessionUsageName).toBe('get_session_usage')
+    expect(getSessionUsageSchema).toEqual({})
+  })
+
+  it('returns an empty snapshot before any billed call', async () => {
+    const result = await getSessionUsageHandler({})
+    expect(result.isError).toBeFalsy()
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed.data.billedCalls).toBe(0)
+    expect(parsed.data.totalCreditsCharged).toBe(0)
+    expect(parsed.data.byEndpoint).toEqual([])
+  })
+
+  it('reflects recorded charges with a per-endpoint breakdown', async () => {
+    recordCharge('/prospeo/find-email', 1, 99)
+    recordCharge('/companyenrich/companies/search', 3, 96)
+
+    const result = await getSessionUsageHandler({})
+    const parsed = JSON.parse(result.content[0].text)
+
+    expect(parsed.data.billedCalls).toBe(2)
+    expect(parsed.data.totalCreditsCharged).toBe(4)
+    expect(parsed.data.balanceAfterLastCharge).toBe(96)
+    expect(parsed.data.byEndpoint[0]).toEqual({
+      endpoint: '/companyenrich/companies/search',
+      calls: 1,
+      credits: 3,
+    })
+  })
+})