@convertcom/mcp-server 0.0.1-beta.17 → 0.0.1-beta.18

package/build/failure-attribution.js

@@ -0,0 +1,326 @@
+/**
+ * Closed, identifier-free failure provenance shared by the generated executor,
+ * namespace dispatcher, operator workflows, and hosted telemetry.
+ *
+ * Keep these values small and stable. They may be returned to MCP clients and
+ * persisted as aggregate Analytics Engine dimensions, so raw error text, URLs,
+ * request values, and customer identifiers must never be added here.
+ */
+export const FAILURE_CATEGORIES = [
+    'input',
+    'permission',
+    'not_found',
+    'upstream',
+    'timeout',
+    'network',
+    'cancellation',
+    'internal',
+    'unknown',
+];
+export const FAILURE_SOURCES = ['executor', 'namespace', 'operator'];
+export const FAILURE_STAGES = [
+    'input_validation',
+    'authorization',
+    'upstream_request',
+    'upstream_response',
+    'operator_workflow',
+    'internal',
+    'unknown',
+];
+export const DISPATCH_STATES = ['not_dispatched', 'dispatched', 'unknown'];
+export const VALIDATION_RULES = [
+    'required',
+    'type',
+    'enum',
+    'format',
+    'bounds',
+    'additional_properties',
+    'wrapper',
+    'guardrail',
+    'unknown',
+];
+export const VALIDATION_PATHS = [
+    'root',
+    'path',
+    'query',
+    'body',
+    'request_body',
+    'confirmation',
+    'unknown',
+];
+const CATEGORY_SET = new Set(FAILURE_CATEGORIES);
+const SOURCE_SET = new Set(FAILURE_SOURCES);
+const STAGE_SET = new Set(FAILURE_STAGES);
+const DISPATCH_SET = new Set(DISPATCH_STATES);
+const RULE_SET = new Set(VALIDATION_RULES);
+const PATH_SET = new Set(VALIDATION_PATHS);
+export function isFailureCategory(value) {
+    return typeof value === 'string' && CATEGORY_SET.has(value);
+}
+export function isFailureSource(value) {
+    return typeof value === 'string' && SOURCE_SET.has(value);
+}
+export function isFailureStage(value) {
+    return typeof value === 'string' && STAGE_SET.has(value);
+}
+export function isDispatchState(value) {
+    return typeof value === 'string' && DISPATCH_SET.has(value);
+}
+export function isValidationRule(value) {
+    return typeof value === 'string' && RULE_SET.has(value);
+}
+export function isValidationPath(value) {
+    return typeof value === 'string' && PATH_SET.has(value);
+}
+export function failureAttribution(input) {
+    return {
+        category: input.category,
+        source: input.source,
+        stage: input.stage,
+        dispatch_state: input.dispatchState,
+        code: stableFailureCode(input.code),
+        ...(knownHttpStatus(input.upstreamStatus) ? { upstream_status: Math.trunc(input.upstreamStatus) } : {}),
+        ...(input.validationRule ? { validation_rule: input.validationRule } : {}),
+        ...(input.validationPath ? { validation_path: input.validationPath } : {}),
+    };
+}
+export function inputFailure(code, source, validationRule = 'unknown', validationPath = 'unknown') {
+    return failureAttribution({
+        category: 'input',
+        source,
+        stage: 'input_validation',
+        dispatchState: 'not_dispatched',
+        code,
+        validationRule,
+        validationPath,
+    });
+}
+export function permissionFailure(code, source) {
+    return failureAttribution({
+        category: 'permission',
+        source,
+        stage: 'authorization',
+        dispatchState: 'not_dispatched',
+        code,
+    });
+}
+export function classifyExecutorFailure(error, upstreamStatus, dispatchState) {
+    const errorName = safeErrorName(error);
+    const normalizedName = errorName.toLowerCase();
+    const errorMessage = safeErrorMessage(error);
+    const axiosCode = axiosStyleCode(error);
+    if (normalizedName === 'timeouterror'
+        || (normalizedName === 'aborterror' && /timeout/i.test(errorMessage))
+        || axiosCode === 'ETIMEDOUT'
+        || (axiosCode === 'ECONNABORTED' && /timeout|timed out/i.test(errorMessage))) {
+        return failureAttribution({
+            category: 'timeout',
+            source: 'executor',
+            stage: 'upstream_request',
+            dispatchState,
+            code: 'TimeoutError',
+        });
+    }
+    if (normalizedName === 'aborterror' || normalizedName === 'cancelederror' || axiosCode === 'ERR_CANCELED') {
+        return failureAttribution({
+            category: 'cancellation',
+            source: 'executor',
+            stage: 'upstream_request',
+            dispatchState,
+            code: 'AbortError',
+        });
+    }
+    if (knownHttpStatus(upstreamStatus)) {
+        const status = Math.trunc(upstreamStatus);
+        return failureAttribution({
+            category: status === 401
+                ? 'permission'
+                : status === 404
+                    ? 'not_found'
+                    : 'upstream',
+            source: 'executor',
+            stage: 'upstream_response',
+            dispatchState: 'dispatched',
+            code: `UpstreamHttp${status}`,
+            upstreamStatus: status,
+        });
+    }
+    const looksNetworkRelated = normalizedName === 'typeerror'
+        || normalizedName.includes('network')
+        || normalizedName.includes('fetch')
+        || Boolean(axiosCode && /^(ECONN|ENET|EAI_|ETIMEDOUT|ERR_NETWORK)/i.test(axiosCode));
+    if (looksNetworkRelated) {
+        return failureAttribution({
+            category: /TIMEOUT|TIMEDOUT/i.test(axiosCode ?? '') ? 'timeout' : 'network',
+            source: 'executor',
+            stage: 'upstream_request',
+            dispatchState,
+            code: /TIMEOUT|TIMEDOUT/i.test(axiosCode ?? '') ? 'TimeoutError' : 'NetworkError',
+        });
+    }
+    return failureAttribution({
+        category: 'unknown',
+        source: 'executor',
+        stage: dispatchState === 'not_dispatched' ? 'internal' : 'upstream_request',
+        dispatchState,
+        code: errorName,
+    });
+}
+export function failureFromStructured(structured, fallbackSource) {
+    const existing = safeFailureAttribution(structured.failure);
+    if (existing)
+        return existing;
+    const code = typeof structured.error === 'string' ? structured.error : 'UnknownFailure';
+    const status = knownHttpStatus(structured.status) ? Math.trunc(structured.status) : undefined;
+    const normalizedCode = code.toLowerCase();
+    if (normalizedCode.includes('timeout')) {
+        return failureAttribution({ category: 'timeout', source: fallbackSource, stage: fallbackStage(fallbackSource), dispatchState: 'unknown', code });
+    }
+    if (normalizedCode.includes('abort') || normalizedCode.includes('cancel')) {
+        return failureAttribution({ category: 'cancellation', source: fallbackSource, stage: fallbackStage(fallbackSource), dispatchState: 'unknown', code });
+    }
+    if (normalizedCode.includes('network') || normalizedCode.includes('fetch')) {
+        return failureAttribution({ category: 'network', source: fallbackSource, stage: fallbackStage(fallbackSource), dispatchState: 'unknown', code });
+    }
+    if (status === 401 || status === 403) {
+        return failureAttribution({
+            category: status === 401 || code === 'ProjectCreationPermissionRequired' || code === 'ApprovalRequired'
+                ? 'permission' : 'upstream',
+            source: fallbackSource,
+            stage: 'upstream_response',
+            dispatchState: 'dispatched',
+            code,
+            upstreamStatus: status,
+        });
+    }
+    if (/(permission|authori[sz]|authenticat|approval|required)/i.test(code)) {
+        return permissionFailure(code, fallbackSource);
+    }
+    if (status === 404 || /not.?found/i.test(code)) {
+        return failureAttribution({
+            category: 'not_found',
+            source: fallbackSource,
+            stage: status === 404 ? 'upstream_response' : fallbackStage(fallbackSource),
+            dispatchState: status === 404 ? 'dispatched' : 'unknown',
+            code,
+            upstreamStatus: status,
+        });
+    }
+    if (/^(invalid|missing|unknown|unsupported|wrong)/i.test(code)) {
+        return inputFailure(code, fallbackSource);
+    }
+    if (typeof status === 'number') {
+        return failureAttribution({
+            category: 'upstream',
+            source: fallbackSource,
+            stage: 'upstream_response',
+            dispatchState: 'dispatched',
+            code,
+            upstreamStatus: status,
+        });
+    }
+    if (code === 'AllUpstreamCallsFailed') {
+        return failureAttribution({
+            category: 'upstream',
+            source: fallbackSource,
+            stage: fallbackStage(fallbackSource),
+            dispatchState: 'unknown',
+            code,
+        });
+    }
+    return failureAttribution({
+        category: code === 'OperatorExecutionFailed' ? 'internal' : 'unknown',
+        source: fallbackSource,
+        stage: fallbackStage(fallbackSource),
+        dispatchState: 'unknown',
+        code,
+    });
+}
+export function safeFailureAttribution(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const candidate = value;
+    if (!isFailureCategory(candidate.category)
+        || !isFailureSource(candidate.source)
+        || !isFailureStage(candidate.stage)
+        || !isDispatchState(candidate.dispatch_state)
+        || typeof candidate.code !== 'string')
+        return null;
+    const upstreamStatus = knownHttpStatus(candidate.upstream_status)
+        ? Math.trunc(candidate.upstream_status)
+        : undefined;
+    return {
+        category: candidate.category,
+        source: candidate.source,
+        stage: candidate.stage,
+        dispatch_state: candidate.dispatch_state,
+        code: stableFailureCode(candidate.code),
+        ...(typeof upstreamStatus === 'number' ? { upstream_status: upstreamStatus } : {}),
+        ...(isValidationRule(candidate.validation_rule) ? { validation_rule: candidate.validation_rule } : {}),
+        ...(isValidationPath(candidate.validation_path) ? { validation_path: candidate.validation_path } : {}),
+    };
+}
+export function validationLabels(issues) {
+    const first = Array.isArray(issues) && issues.length > 0 && issues[0] && typeof issues[0] === 'object'
+        ? issues[0]
+        : {};
+    return {
+        rule: validationRuleFrom(first.keyword),
+        path: validationPathFrom(typeof first.instancePath === 'string' ? first.instancePath : first.path),
+    };
+}
+function validationRuleFrom(value) {
+    if (value === 'required' || value === 'type' || value === 'enum' || value === 'format')
+        return value;
+    if (value === 'additionalProperties')
+        return 'additional_properties';
+    if (value === 'minimum' || value === 'maximum' || value === 'minItems' || value === 'maxItems'
+        || value === 'minLength' || value === 'maxLength' || value === 'pattern')
+        return 'bounds';
+    return 'unknown';
+}
+function validationPathFrom(value) {
+    if (typeof value !== 'string' || value.length === 0 || value === '/')
+        return 'root';
+    const normalized = value.replace(/^\//, '').replace(/^\./, '').toLowerCase();
+    if (normalized.startsWith('path'))
+        return 'path';
+    if (normalized.startsWith('query'))
+        return 'query';
+    if (normalized.startsWith('requestbody') || normalized.startsWith('request_body'))
+        return 'request_body';
+    if (normalized.startsWith('body'))
+        return 'body';
+    if (normalized.startsWith('confirmation'))
+        return 'confirmation';
+    return 'unknown';
+}
+function fallbackStage(source) {
+    return source === 'operator' ? 'operator_workflow' : source === 'namespace' ? 'input_validation' : 'internal';
+}
+function stableFailureCode(value) {
+    const normalized = value.trim();
+    return /^[A-Za-z][A-Za-z0-9]{0,63}$/.test(normalized) ? normalized : 'UnknownFailure';
+}
+function knownHttpStatus(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 100 && value <= 599;
+}
+function axiosStyleCode(error) {
+    if (!error || typeof error !== 'object' || Array.isArray(error))
+        return null;
+    const code = error.code;
+    return typeof code === 'string' ? code : null;
+}
+function safeErrorName(error) {
+    if (!error || typeof error !== 'object' || Array.isArray(error))
+        return 'UnknownFailure';
+    const name = error.name;
+    return typeof name === 'string' && name.length > 0 ? name : 'UnknownFailure';
+}
+function safeErrorMessage(error) {
+    if (!error || typeof error !== 'object' || Array.isArray(error))
+        return '';
+    const message = error.message;
+    return typeof message === 'string' ? message : '';
+}
+//# sourceMappingURL=failure-attribution.js.map

package/build/failure-attribution.js.map

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

package/build/image-dimensions.d.ts

@@ -0,0 +1,5 @@
+export type ImageDimensions = {
+    width: number;
+    height: number;
+};
+export declare function imageDimensionsFromBase64(data: string, mimeType: string): ImageDimensions | null;

package/build/image-dimensions.js

@@ -0,0 +1,203 @@
+function uint16be(bytes, at) {
+    return (bytes[at] << 8) | bytes[at + 1];
+}
+function uint16le(bytes, at) {
+    return bytes[at] | (bytes[at + 1] << 8);
+}
+function uint32be(bytes, at) {
+    return ((bytes[at] * 0x1000000) + (bytes[at + 1] << 16)
+        + (bytes[at + 2] << 8) + bytes[at + 3]) >>> 0;
+}
+function ascii(bytes, at, length) {
+    return String.fromCharCode(...bytes.subarray(at, at + length));
+}
+function positive(width, height) {
+    return Number.isSafeInteger(width) && Number.isSafeInteger(height) && width > 0 && height > 0
+        ? { width, height } : null;
+}
+function pngDimensions(bytes) {
+    if (bytes.length < 45 || ascii(bytes, 0, 8) !== '\x89PNG\r\n\x1a\n'
+        || uint32be(bytes, 8) !== 13 || ascii(bytes, 12, 4) !== 'IHDR')
+        return null;
+    const dimensions = positive(uint32be(bytes, 16), uint32be(bytes, 20));
+    if (!dimensions)
+        return null;
+    let at = 8;
+    let sawIdat = false;
+    while (at + 12 <= bytes.length) {
+        const length = uint32be(bytes, at);
+        if (length > bytes.length - at - 12)
+            return null;
+        const kind = ascii(bytes, at + 4, 4);
+        if (kind === 'acTL')
+            return null; // APNG can contain multiple frames.
+        if (kind === 'IDAT' && length > 0)
+            sawIdat = true;
+        if (kind === 'IEND' && length !== 0)
+            return null;
+        at += length + 12;
+        if (kind === 'IEND')
+            return sawIdat && at === bytes.length ? dimensions : null;
+    }
+    return null;
+}
+function jpegDimensions(bytes) {
+    if (bytes.length < 6 || bytes[0] !== 0xff || bytes[1] !== 0xd8
+        || bytes[bytes.length - 2] !== 0xff || bytes[bytes.length - 1] !== 0xd9)
+        return null;
+    let at = 2;
+    let dimensions = null;
+    while (at + 4 <= bytes.length) {
+        if (bytes[at] !== 0xff)
+            return null;
+        while (bytes[at] === 0xff)
+            at++;
+        const marker = bytes[at++];
+        if (marker === 0xd9 || marker === undefined)
+            return null;
+        if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
+            continue;
+        if (at + 2 > bytes.length)
+            return null;
+        const length = uint16be(bytes, at);
+        if (length < 2 || at + length > bytes.length)
+            return null;
+        if (marker === 0xda) {
+            // SOS must follow a frame header and leave entropy bytes before EOI.
+            return dimensions && length >= 6 && at + length < bytes.length - 2 ? dimensions : null;
+        }
+        if ((marker >= 0xc0 && marker <= 0xc3)
+            || (marker >= 0xc5 && marker <= 0xc7)
+            || (marker >= 0xc9 && marker <= 0xcb)
+            || (marker >= 0xcd && marker <= 0xcf)) {
+            if (length < 8 || bytes[at + 7] === 0 || length < 8 + 3 * bytes[at + 7])
+                return null;
+            const frame = positive(uint16be(bytes, at + 5), uint16be(bytes, at + 3));
+            if (!frame || dimensions)
+                return null;
+            dimensions = frame;
+        }
+        at += length;
+    }
+    return null;
+}
+function skipGifSubBlocks(bytes, start) {
+    let at = start;
+    while (at < bytes.length) {
+        const size = bytes[at++];
+        if (size === 0)
+            return at;
+        if (size > bytes.length - at)
+            return null;
+        at += size;
+    }
+    return null;
+}
+function gifDimensions(bytes) {
+    if (bytes.length < 14 || !['GIF87a', 'GIF89a'].includes(ascii(bytes, 0, 6)))
+        return null;
+    const dimensions = positive(uint16le(bytes, 6), uint16le(bytes, 8));
+    if (!dimensions)
+        return null;
+    const tableBytes = bytes[10] & 0x80 ? 3 * (1 << ((bytes[10] & 7) + 1)) : 0;
+    let at = 13 + tableBytes;
+    let frames = 0;
+    while (at < bytes.length) {
+        const marker = bytes[at++];
+        if (marker === 0x3b)
+            return at === bytes.length && frames === 1 ? dimensions : null;
+        if (marker === 0x21) {
+            if (at >= bytes.length)
+                return null;
+            at = skipGifSubBlocks(bytes, at + 1) ?? bytes.length;
+        }
+        else if (marker === 0x2c) {
+            if (at + 9 > bytes.length)
+                return null;
+            const left = uint16le(bytes, at);
+            const top = uint16le(bytes, at + 2);
+            const frame = positive(uint16le(bytes, at + 4), uint16le(bytes, at + 6));
+            if (!frame || left + frame.width > dimensions.width || top + frame.height > dimensions.height)
+                return null;
+            const localTableBytes = bytes[at + 8] & 0x80 ? 3 * (1 << ((bytes[at + 8] & 7) + 1)) : 0;
+            at += 9 + localTableBytes;
+            if (at >= bytes.length)
+                return null;
+            at = skipGifSubBlocks(bytes, at + 1) ?? bytes.length;
+            frames++;
+            if (frames > 1)
+                return null;
+        }
+        else
+            return null;
+    }
+    return null;
+}
+function webpDimensions(bytes) {
+    if (bytes.length < 30 || ascii(bytes, 0, 4) !== 'RIFF' || ascii(bytes, 8, 4) !== 'WEBP')
+        return null;
+    const riffLength = (bytes[4] | (bytes[5] << 8) | (bytes[6] << 16) | (bytes[7] * 0x1000000)) >>> 0;
+    if (riffLength + 8 !== bytes.length)
+        return null;
+    let at = 12;
+    let dimensions = null;
+    let imageChunks = 0;
+    while (at + 8 <= bytes.length) {
+        const kind = ascii(bytes, at, 4);
+        const length = (bytes[at + 4] | (bytes[at + 5] << 8)
+            | (bytes[at + 6] << 16) | (bytes[at + 7] * 0x1000000)) >>> 0;
+        const payload = at + 8;
+        if (length > bytes.length - payload)
+            return null;
+        if (kind === 'ANIM' || kind === 'ANMF')
+            return null;
+        if (kind === 'VP8X') {
+            if (at !== 12 || length < 10 || (bytes[payload] & 0x02))
+                return null;
+            dimensions = positive(1 + bytes[payload + 4] + (bytes[payload + 5] << 8) + (bytes[payload + 6] << 16), 1 + bytes[payload + 7] + (bytes[payload + 8] << 8) + (bytes[payload + 9] << 16));
+            if (!dimensions)
+                return null;
+        }
+        else if (kind === 'VP8 ') {
+            if (length < 10 || bytes[payload + 3] !== 0x9d
+                || bytes[payload + 4] !== 0x01 || bytes[payload + 5] !== 0x2a)
+                return null;
+            imageChunks++;
+            const frame = positive(uint16le(bytes, payload + 6) & 0x3fff, uint16le(bytes, payload + 8) & 0x3fff);
+            if (!frame || (dimensions && (dimensions.width !== frame.width || dimensions.height !== frame.height)))
+                return null;
+            dimensions = frame;
+        }
+        else if (kind === 'VP8L') {
+            if (length < 5 || bytes[payload] !== 0x2f)
+                return null;
+            imageChunks++;
+            const frame = positive(1 + bytes[payload + 1] + ((bytes[payload + 2] & 0x3f) << 8), 1 + (bytes[payload + 2] >> 6) + (bytes[payload + 3] << 2)
+                + ((bytes[payload + 4] & 0x0f) << 10));
+            if (!frame || (dimensions && (dimensions.width !== frame.width || dimensions.height !== frame.height)))
+                return null;
+            dimensions = frame;
+        }
+        at = payload + length + (length % 2);
+    }
+    return at === bytes.length && imageChunks === 1 ? dimensions : null;
+}
+export function imageDimensionsFromBase64(data, mimeType) {
+    let bytes;
+    try {
+        const normalized = data.replace(/-/g, '+').replace(/_/g, '/');
+        const decoded = atob(normalized.padEnd(Math.ceil(normalized.length / 4) * 4, '='));
+        bytes = Uint8Array.from(decoded, char => char.charCodeAt(0));
+    }
+    catch {
+        return null;
+    }
+    switch (mimeType) {
+        case 'image/png': return pngDimensions(bytes);
+        case 'image/jpeg': return jpegDimensions(bytes);
+        case 'image/gif': return gifDimensions(bytes);
+        case 'image/webp': return webpDimensions(bytes);
+        default: return null;
+    }
+}
+//# sourceMappingURL=image-dimensions.js.map

package/build/image-dimensions.js.map

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

package/build/kb-search.js

@@ -238,7 +238,16 @@ function boundedLevenshtein(left, right, maximum) {
 export function normalizeSearchQuery(query) {
     const tokens = query.match(/[\p{L}\p{N}_./:+-]+/gu) ?? [];
     const meaningful = tokens.filter((token) => !QUERY_STOP_WORDS.has(token.toLowerCase()));
-    const normalized = (meaningful.length > 0 ? meaningful : tokens);
+    // API reference titles use imperative verbs; conversational conjugations must
+    // retrieve the same contract in both the local and Worker lexical engines.
+    const verbForms = {
+        creates: 'create', creating: 'create', created: 'create',
+        updates: 'update', updating: 'update', updated: 'update',
+        deletes: 'delete', deleting: 'delete', deleted: 'delete',
+        authenticates: 'authentication', authenticate: 'authentication', authenticating: 'authentication',
+    };
+    const normalized = (meaningful.length > 0 ? meaningful : tokens)
+        .map((token) => verbForms[token.toLowerCase()] ?? token);
     if (/\brevenue\b/i.test(query)
         && /\b(?:do not|don't|doesn't|without|no)\b[^.?!]{0,80}\b(?:ga4|google analytics)\b/i.test(query)) {
         normalized.push('manual', 'revenue', 'tracking', 'pushRevenue', 'goal_id', 'add', 'site');
@@ -257,6 +266,12 @@ export function semanticSearchQuery(query) {
         && /\b(?:do not|don't|doesn't|without|no)\b[^.?!]{0,80}\b(?:ga4|google analytics)\b/i.test(query)) {
         return `${query} Relevant Convert concept: manual revenue tracking with pushRevenue and goal_id, without a Google Analytics integration.`;
     }
+    if (/\b(?:convert\s+)?(?:management\s+)?api\b/i.test(query)
+        && /\bheaders?\b/i.test(query)
+        && /\b(?:auth|authenticate|authentication|hmac|request signing)\b/i.test(query)
+        && !/\b(?:oauth\w*|bearer)\b/i.test(query)) {
+        return `${query} Relevant Convert concept: API key request signing with HMAC using Convert-Application-ID, Expires, and Authorization headers.`;
+    }
     return query;
 }
 const DEVELOPER_INTENT = /\b(api|sdk|webhook|endpoint|request|response|payload|header|hmac|oauth|javascript|typescript|android|ios|fullstack|tracking event|curl|http status)\b/i;