@evolinkai/mcp 0.0.0-stage → 1.3.0

package/dist/core/src/services/http-policy.js

@@ -0,0 +1,120 @@
+import { randomUUID } from 'node:crypto';
+import { currentClientName } from '../request-context.js';
+import { MCP_VERSION } from '../version.js';
+export const DEFAULT_READ_TIMEOUT_MS = 15_000;
+export const DEFAULT_WRITE_TIMEOUT_MS = 120_000;
+/** A generation submit only queues a task; keep it well inside the ~60 s tool-call limit of Codex and Cursor. */
+export const DEFAULT_SUBMIT_TIMEOUT_MS = 30_000;
+export const MAX_RETRY_DELAY_MS = 30_000;
+/** Public site for console links in errors and results. */
+export const EVOLINK_SITE = 'https://evolink.ai';
+export const TOP_UP_URL = `${EVOLINK_SITE}/dashboard/credits`;
+export const API_KEYS_URL = `${EVOLINK_SITE}/dashboard/keys`;
+/**
+ * Where a signed-in user manages the EvoLink MCP limit and pause. Until the
+ * console has an MCP section, the account's internal MCP key is listed under
+ * API Keys (as MCP_KEY_NAME) and its limit and on/off switch are set there.
+ * The gateway's action_url, when it sends one, takes precedence.
+ */
+export const MCP_CONSOLE_URL = API_KEYS_URL;
+/** Name of the account's internal MCP key in the API Keys list (set by the gateway). */
+export const MCP_KEY_NAME = 'EvoLink MCP (OAuth)';
+/** The gateway accepts Idempotency-Key values of 16–96 characters from this set. */
+export const CLIENT_REQUEST_ID_PATTERN = /^[A-Za-z0-9._-]{16,96}$/;
+export class RequestTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`request timed out after ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'RequestTimeoutError';
+    }
+}
+export class PaidRequestOutcomeUnknownError extends Error {
+    cause;
+    idempotencyKey;
+    constructor(cause, idempotencyKey) {
+        super('paid request outcome is unknown after the bounded idempotent retry; do not create a new paid intent');
+        this.cause = cause;
+        this.idempotencyKey = idempotencyKey;
+        this.name = 'PaidRequestOutcomeUnknownError';
+    }
+}
+export function newRunId() {
+    return `run_${randomUUID().replaceAll('-', '')}`;
+}
+/** Headers that tell the gateway this call came from the MCP server, which tool and which assistant. */
+export function evoHeaders(tool) {
+    const headers = {
+        'X-Evo-Client': 'mcp',
+        'X-Evo-Client-Version': MCP_VERSION,
+        'X-Evo-Tool': tool,
+    };
+    const clientName = currentClientName();
+    if (clientName)
+        headers['X-Evo-Client-Name'] = clientName;
+    return headers;
+}
+/** Turns a console path such as /dashboard/credits into a full link; full https links pass through. */
+export function siteUrl(pathOrUrl, fallback) {
+    const value = (pathOrUrl ?? '').trim();
+    if (value.startsWith('https://'))
+        return value;
+    if (value.startsWith('/') && !value.startsWith('//'))
+        return `${EVOLINK_SITE}${value}`;
+    return fallback;
+}
+export function timeoutFromEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed < 1_000 || parsed > 600_000) {
+        throw new Error(`${name} must be an integer between 1000 and 600000 milliseconds`);
+    }
+    return parsed;
+}
+export function parseRetryAfter(value, nowMs = Date.now()) {
+    if (!value)
+        return undefined;
+    const seconds = Number(value.trim());
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return Math.min(Math.ceil(seconds * 1000), MAX_RETRY_DELAY_MS);
+    }
+    const dateMs = Date.parse(value);
+    if (!Number.isFinite(dateMs))
+        return undefined;
+    return Math.min(Math.max(0, dateMs - nowMs), MAX_RETRY_DELAY_MS);
+}
+export function responseRequestId(headers) {
+    return headers.get('x-request-id')?.trim()
+        || headers.get('x-oneapi-request-id')?.trim()
+        || undefined;
+}
+export async function fetchWithTimeout(url, init, timeoutMs, fetchImpl = fetch) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetchImpl(url, { ...init, signal: controller.signal });
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new RequestTimeoutError(timeoutMs);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function readJsonBody(response) {
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { message: text.slice(0, 2_000) };
+    }
+}
+//# sourceMappingURL=http-policy.js.map

package/dist/core/src/services/http-policy.js.map

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

package/dist/core/src/services/model-catalog.d.ts

@@ -0,0 +1,24 @@
+import { type MediaKind, type ModelParams } from '../data/model-params.js';
+import { type PricedModel } from './pricing-client.js';
+/** A model as the tools see it: documented parameters, published prices, or both. */
+export interface CatalogEntry {
+    id: string;
+    kind: MediaKind;
+    spec?: ModelParams;
+    priced?: PricedModel;
+}
+export interface Catalog {
+    entries: CatalogEntry[];
+    /** Why prices are missing, when the pricing list could not be loaded. */
+    pricingWarning?: string;
+}
+/** Merges the bundled parameter index with the live price list; works without prices if the list is unreachable. */
+export declare function loadCatalog(): Promise<Catalog>;
+export declare function findEntry(catalog: Catalog, id: string): CatalogEntry | undefined;
+export declare function suggestModels(catalog: Catalog, id: string, kind?: MediaKind): string[];
+/** Looks a model up for one request; prices are best effort. */
+export declare function resolveModel(id: string): Promise<{
+    catalog: Catalog;
+    entry?: CatalogEntry;
+}>;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/core/src/services/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../../../core/src/services/model-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5G,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEnE,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,oHAAoH;AACpH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAgBpD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGhF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,EAAE,CAGtF;AAED,gEAAgE;AAChE,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAKlG"}

package/dist/core/src/services/model-catalog.js

@@ -0,0 +1,45 @@
+import { allModelParams, findModelParams } from '../data/model-params.js';
+import { closestMatches } from './param-validator.js';
+import { getPricing } from './pricing-client.js';
+function isMediaKind(value) {
+    return value === 'image' || value === 'video' || value === 'audio';
+}
+/** Merges the bundled parameter index with the live price list; works without prices if the list is unreachable. */
+export async function loadCatalog() {
+    const entries = new Map();
+    for (const spec of allModelParams())
+        entries.set(spec.model, { id: spec.model, kind: spec.kind, spec });
+    let pricingWarning;
+    try {
+        const pricing = await getPricing();
+        if (pricing.source === 'stale-cache')
+            pricingWarning = 'Prices could not be refreshed; showing the last known prices.';
+        for (const priced of pricing.models.values()) {
+            const existing = entries.get(priced.id);
+            if (existing)
+                existing.priced = priced;
+            else if (isMediaKind(priced.kind))
+                entries.set(priced.id, { id: priced.id, kind: priced.kind, priced });
+        }
+    }
+    catch (error) {
+        pricingWarning = `Prices are unavailable right now (${error instanceof Error ? error.message : 'unknown error'}).`;
+    }
+    return { entries: [...entries.values()], pricingWarning };
+}
+export function findEntry(catalog, id) {
+    const lower = id.trim().toLowerCase();
+    return catalog.entries.find(entry => entry.id === id.trim()) ?? catalog.entries.find(entry => entry.id.toLowerCase() === lower);
+}
+export function suggestModels(catalog, id, kind) {
+    const pool = catalog.entries.filter(entry => !kind || entry.kind === kind).map(entry => entry.id);
+    return closestMatches(id, pool, 5);
+}
+/** Looks a model up for one request; prices are best effort. */
+export async function resolveModel(id) {
+    const spec = findModelParams(id);
+    const catalog = await loadCatalog();
+    const entry = spec ? findEntry(catalog, spec.model) : findEntry(catalog, id);
+    return { catalog, entry };
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/core/src/services/model-catalog.js.map

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

package/dist/core/src/services/param-validator.d.ts

@@ -0,0 +1,21 @@
+import type { ModelParams } from '../data/model-params.js';
+export interface ValidationIssue {
+    param: string;
+    problem: string;
+}
+export interface ValidationResult {
+    /** The request would be rejected; it is not submitted. */
+    errors: ValidationIssue[];
+    /** Worth telling the user, but the gateway has the final say (for example prompt length, which it counts in tokens). */
+    warnings: ValidationIssue[];
+}
+/** Up to `limit` candidates that look like `value`, best first. */
+export declare function closestMatches(value: string, candidates: string[], limit?: number): string[];
+/**
+ * Checks a generation input against the documented parameters before
+ * anything is sent: unknown names, wrong types, values outside the documented
+ * choices or ranges. The gateway still validates the request in full.
+ */
+export declare function validateInput(spec: ModelParams, input: Record<string, unknown>): ValidationResult;
+export declare function formatIssues(issues: ValidationIssue[]): string[];
+//# sourceMappingURL=param-validator.d.ts.map

package/dist/core/src/services/param-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-validator.d.ts","sourceRoot":"","sources":["../../../../../core/src/services/param-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,yBAAyB,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,wHAAwH;IACxH,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AA2BD,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAavF;AAoGD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAkBjG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAEhE"}

package/dist/core/src/services/param-validator.js

@@ -0,0 +1,164 @@
+/** Parameters an assistant may not set through MCP, with the reason shown to it. */
+const BLOCKED_PARAMS = {
+    callback_url: 'callbacks are not available through MCP; use get_task to wait for the result',
+};
+/** Levenshtein distance, capped for long strings. */
+function distance(a, b) {
+    if (a === b)
+        return 0;
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    let previous = Array.from({ length: cols }, (_, j) => j);
+    for (let i = 1; i < rows; i++) {
+        const current = [i];
+        for (let j = 1; j < cols; j++) {
+            current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        previous = current;
+    }
+    return previous[cols - 1];
+}
+/** Up to `limit` candidates that look like `value`, best first. */
+export function closestMatches(value, candidates, limit = 3) {
+    const needle = value.toLowerCase();
+    return candidates
+        .map(candidate => {
+        const lower = candidate.toLowerCase();
+        const contains = lower.includes(needle) || needle.includes(lower);
+        const score = distance(needle, lower) / Math.max(needle.length, lower.length, 1) - (contains ? 0.5 : 0);
+        return { candidate, score };
+    })
+        .filter(item => item.score <= 0.45)
+        .sort((a, b) => a.score - b.score || a.candidate.localeCompare(b.candidate))
+        .slice(0, limit)
+        .map(item => item.candidate);
+}
+function describeType(type) {
+    return type.split('|').map(part => (part === 'integer' ? 'a whole number' : part === 'array' ? 'a list' : `a ${part}`)).join(' or ');
+}
+function matchesType(type, value) {
+    if (!type)
+        return true;
+    return type.split('|').some(part => {
+        switch (part) {
+            case 'string': return typeof value === 'string';
+            case 'integer': return typeof value === 'number' && Number.isInteger(value);
+            case 'number': return typeof value === 'number' && Number.isFinite(value);
+            case 'boolean': return typeof value === 'boolean';
+            case 'array': return Array.isArray(value);
+            case 'object': return !!value && typeof value === 'object' && !Array.isArray(value);
+            case 'null': return value === null;
+            default: return true;
+        }
+    });
+}
+function show(value) {
+    const json = JSON.stringify(value);
+    return json && json.length > 60 ? `${json.slice(0, 57)}…` : json ?? String(value);
+}
+function checkValue(name, spec, value, result) {
+    if (value === undefined)
+        return;
+    if (!matchesType(spec.type, value)) {
+        const numericString = typeof value === 'string' && value.trim() !== '' && !Number.isNaN(Number(value));
+        const hint = numericString && /integer|number/.test(spec.type ?? '') ? ` Use ${Number(value)} (a number), not "${value}".` : '';
+        result.errors.push({ param: name, problem: `must be ${describeType(spec.type)}, got ${show(value)}.${hint}` });
+        return;
+    }
+    if (spec.enum && spec.enum.length > 0 && (typeof value !== 'object' || value === null)) {
+        if (!spec.enum.some(option => option === value)) {
+            const caseMatch = typeof value === 'string'
+                ? spec.enum.find(option => typeof option === 'string' && option.toLowerCase() === value.toLowerCase())
+                : undefined;
+            result.errors.push({
+                param: name,
+                problem: caseMatch !== undefined
+                    ? `use ${show(caseMatch)} (values are case-sensitive), got ${show(value)}.`
+                    : `must be one of ${spec.enum.map(show).join(', ')}; got ${show(value)}.`,
+            });
+            return;
+        }
+    }
+    if (typeof value === 'number') {
+        if (spec.minimum !== undefined && value < spec.minimum)
+            result.errors.push({ param: name, problem: `must be at least ${spec.minimum}, got ${value}.` });
+        if (spec.maximum !== undefined && value > spec.maximum)
+            result.errors.push({ param: name, problem: `must be at most ${spec.maximum}, got ${value}.` });
+        if (spec.exclusiveMinimum !== undefined && value <= spec.exclusiveMinimum)
+            result.errors.push({ param: name, problem: `must be greater than ${spec.exclusiveMinimum}, got ${value}.` });
+        if (spec.exclusiveMaximum !== undefined && value >= spec.exclusiveMaximum)
+            result.errors.push({ param: name, problem: `must be less than ${spec.exclusiveMaximum}, got ${value}.` });
+    }
+    if (typeof value === 'string') {
+        if (spec.maxLength !== undefined && value.length > spec.maxLength) {
+            result.warnings.push({ param: name, problem: `is ${value.length} characters; the documented limit is ${spec.maxLength}. The gateway may reject it.` });
+        }
+        if (spec.minLength !== undefined && value.length < spec.minLength) {
+            result.errors.push({ param: name, problem: `must be at least ${spec.minLength} characters.` });
+        }
+    }
+    if (Array.isArray(value)) {
+        if (spec.maxItems !== undefined && value.length > spec.maxItems)
+            result.errors.push({ param: name, problem: `allows at most ${spec.maxItems} items, got ${value.length}.` });
+        if (spec.minItems !== undefined && value.length < spec.minItems)
+            result.errors.push({ param: name, problem: `needs at least ${spec.minItems} items, got ${value.length}.` });
+        const items = spec.items;
+        if (items) {
+            value.forEach((item, position) => {
+                checkValue(`${name}[${position}]`, { type: items.type, enum: items.enum, properties: items.properties }, item, result);
+            });
+        }
+    }
+    if (spec.properties && value && typeof value === 'object' && !Array.isArray(value)) {
+        checkObject(name, spec.properties, value, result);
+    }
+}
+function checkObject(prefix, properties, value, result) {
+    const known = Object.keys(properties);
+    for (const [key, nested] of Object.entries(value)) {
+        const spec = properties[key];
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (!spec) {
+            const suggestions = closestMatches(key, known);
+            result.errors.push({
+                param: path,
+                problem: `is not a parameter here.${suggestions.length ? ` Did you mean ${suggestions.map(s => `"${s}"`).join(' or ')}?` : ''} Allowed: ${known.join(', ') || 'none'}.`,
+            });
+            continue;
+        }
+        checkValue(path, spec, nested, result);
+    }
+    for (const [key, spec] of Object.entries(properties)) {
+        if (spec.required && value[key] === undefined) {
+            result.errors.push({ param: prefix ? `${prefix}.${key}` : key, problem: 'is required.' });
+        }
+    }
+}
+/**
+ * Checks a generation input against the documented parameters before
+ * anything is sent: unknown names, wrong types, values outside the documented
+ * choices or ranges. The gateway still validates the request in full.
+ */
+export function validateInput(spec, input) {
+    const result = { errors: [], warnings: [] };
+    const rest = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (key === 'model') {
+            if (value !== undefined && value !== spec.model) {
+                result.errors.push({ param: 'model', problem: `set the model with the model argument, not inside input (input has ${show(value)}).` });
+            }
+            continue;
+        }
+        if (BLOCKED_PARAMS[key]) {
+            result.errors.push({ param: key, problem: `${BLOCKED_PARAMS[key]}.` });
+            continue;
+        }
+        rest[key] = value;
+    }
+    checkObject('', spec.params, rest, result);
+    return result;
+}
+export function formatIssues(issues) {
+    return issues.map(issue => `- ${issue.param} ${issue.problem}`);
+}
+//# sourceMappingURL=param-validator.js.map

package/dist/core/src/services/param-validator.js.map

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

package/dist/core/src/services/pricing-client.d.ts

@@ -0,0 +1,77 @@
+import type { ModelParams } from '../data/model-params.js';
+/** One SKU from the public pricing endpoint (GET /web/api/models/pricing, default price group). */
+export interface PricingSku {
+    sku_id: string;
+    sku_name: string;
+    model_name: string;
+    model_type: string;
+    description?: string;
+    vendor_slug?: string;
+    billing_rule: string;
+    cny_price?: number;
+    min_charge_uc?: number;
+    metadata?: string;
+    resolution_multipliers?: Record<string, number>;
+    price_range?: {
+        min_usd?: number;
+        max_usd?: number;
+    };
+    routing_note?: string;
+}
+/** What one SKU costs, in the unit the gateway bills it. */
+export interface SkuPrice {
+    sku_id: string;
+    name: string;
+    /** "image", "second", "request", "1M tokens", "1K tokens", "token" or "hour". */
+    unit: string;
+    min_usd: number;
+    max_usd: number;
+    /** output: the main charge; add_on: extra inputs or features; token: usage-based. */
+    role: 'output' | 'add_on' | 'token';
+    multipliers?: Record<string, number>;
+    min_charge_usd?: number;
+}
+export interface PricedModel {
+    id: string;
+    kind: string;
+    vendor?: string;
+    description?: string;
+    prices: SkuPrice[];
+}
+export interface PricingSnapshot {
+    models: Map<string, PricedModel>;
+    fetchedAt: number;
+    source: 'live' | 'cache' | 'stale-cache';
+}
+/** Base for the public web API (pricing); EVOLINK_CONTROL_BASE points it at a staging host. */
+export declare function controlBaseURL(): string;
+/** Unit and USD price of one SKU: the gateway's routing note first (it carries the corrected unit), the raw fields second. */
+export declare function skuPrice(sku: PricingSku): SkuPrice | undefined;
+/** Image, video and audio models with their published unit prices; cached for five minutes, served stale for a day if a refresh fails. */
+export declare function getPricing(): Promise<PricingSnapshot>;
+export declare function resetPricingCacheForTests(): void;
+export declare function findPricedModel(models: Map<string, PricedModel>, id: string): PricedModel | undefined;
+export declare function formatPrice(price: SkuPrice): string;
+/** Lowest main unit price, for listings ("from $0.04 per image"). */
+export declare function startingPrice(model: PricedModel): SkuPrice | undefined;
+export interface CostEstimate {
+    /** estimated: a range was computed; token_billed: billed by usage, unknown up front; needs_input: a quantity is missing; no_price: nothing published. */
+    status: 'estimated' | 'token_billed' | 'needs_input' | 'no_price';
+    min_usd?: number;
+    max_usd?: number;
+    min_credits?: number;
+    max_credits?: number;
+    /** How the range was computed, one line per charge. */
+    basis: string[];
+    /** Extra charges that may apply but are not in the range. */
+    possible_extras: string[];
+    notes: string[];
+}
+/**
+ * Interim media estimate: published unit price × images or seconds, plus
+ * per-input-image charges. The gateway's own pre-charge at submit time is
+ * authoritative; this only tells the user what to expect.
+ */
+export declare function estimateCost(model: PricedModel | undefined, kind: string, input: Record<string, unknown>, spec?: ModelParams): CostEstimate;
+export declare function formatEstimateRange(estimate: CostEstimate): string | undefined;
+//# sourceMappingURL=pricing-client.d.ts.map

package/dist/core/src/services/pricing-client.d.ts.map

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