@cesteral/meta-mcp 1.0.0

package/dist/mcp-server/tools/utils/resolve-session.js

@@ -0,0 +1,6 @@
+import { resolveSessionServicesFromStore } from "@cesteral/shared";
+import { sessionServiceStore } from "../../../services/session-services.js";
+export function resolveSessionServices(sdkContext) {
+    return resolveSessionServicesFromStore(sessionServiceStore, sdkContext);
+}
+//# sourceMappingURL=resolve-session.js.map

package/dist/mcp-server/tools/utils/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAOlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.d.ts

@@ -0,0 +1,53 @@
+import type { Logger } from "pino";
+export declare const createMcpHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "meta-bearer" | "jwt" | "none";
+    metaApiBaseUrl: string;
+    metaApiVersion: string;
+    metaRateLimitPerMinute: number;
+    metaVideoUploadPollIntervalMs: number;
+    metaVideoUploadMaxPollAttempts: number;
+    metaVideoUploadMaxBufferedBytes: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    metaAccessToken?: string | undefined;
+    metaAppId?: string | undefined;
+    metaAppSecret?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "meta-bearer" | "jwt" | "none";
+    metaApiBaseUrl: string;
+    metaApiVersion: string;
+    metaRateLimitPerMinute: number;
+    metaVideoUploadPollIntervalMs: number;
+    metaVideoUploadMaxPollAttempts: number;
+    metaVideoUploadMaxBufferedBytes: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    metaAccessToken?: string | undefined;
+    metaAppId?: string | undefined;
+    metaAppSecret?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
+//# sourceMappingURL=streamable-http-transport.d.ts.map

package/dist/mcp-server/transports/streamable-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAwHnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.js

@@ -0,0 +1,80 @@
+import { createMcpServer } from "../server.js";
+import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
+import { MetaBearerAuthStrategy } from "../../auth/meta-auth-strategy.js";
+import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
+import { rateLimiter } from "../../utils/platform.js";
+function buildPlatformConfig(config, logger) {
+    return {
+        authStrategy: config.mcpAuthMode === "meta-bearer"
+            ? new MetaBearerAuthStrategy(config.metaApiBaseUrl, logger)
+            : createAuthStrategy(config.mcpAuthMode, {
+                jwtSecret: config.mcpAuthSecretKey,
+                logger,
+            }),
+        corsAllowHeaders: [
+            "Content-Type",
+            "Authorization",
+            "Mcp-Session-Id",
+            "MCP-Protocol-Version",
+            "X-Meta-App-Id",
+            "X-Meta-App-Secret",
+        ],
+        authErrorHint: config.mcpAuthMode === "meta-bearer"
+            ? "Provide a Meta access token via Authorization: Bearer <token> header."
+            : "Provide a valid Bearer token in the Authorization header.",
+        sessionServiceStore,
+        rateLimiter,
+        async createSessionForAuth(authResult, sessionId, appConfig, log) {
+            const adapter = authResult.platformAuthAdapter;
+            if (adapter) {
+                const services = createSessionServices(adapter, { baseUrl: appConfig.metaApiBaseUrl }, log, rateLimiter);
+                sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                return { services };
+            }
+            if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
+                const cfg = appConfig;
+                const metaToken = cfg.metaAccessToken;
+                if (metaToken && cfg.metaAppId && cfg.metaAppSecret) {
+                    const { MetaRefreshTokenAdapter } = await import("../../auth/meta-auth-adapter.js");
+                    const envAdapter = new MetaRefreshTokenAdapter(metaToken, { appId: cfg.metaAppId, appSecret: cfg.metaAppSecret }, cfg.metaApiBaseUrl);
+                    await envAdapter.validate();
+                    const services = createSessionServices(envAdapter, { baseUrl: cfg.metaApiBaseUrl }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                if (metaToken) {
+                    const { MetaAccessTokenAdapter } = await import("../../auth/meta-auth-adapter.js");
+                    const envAdapter = new MetaAccessTokenAdapter(metaToken, cfg.metaApiBaseUrl);
+                    await envAdapter.validate();
+                    const services = createSessionServices(envAdapter, { baseUrl: appConfig.metaApiBaseUrl }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                if (appConfig.mcpAuthMode !== "none") {
+                    return {
+                        services: null,
+                        error: {
+                            message: "Meta access token required. Set META_ACCESS_TOKEN env var, or use MCP_AUTH_MODE=meta-bearer.",
+                            status: 400,
+                        },
+                    };
+                }
+                return { services: null };
+            }
+            return {
+                services: null,
+                error: {
+                    message: "Meta API credentials required for this server.",
+                    status: 400,
+                },
+            };
+        },
+        async createMcpServer(log, sessionId, gcsBucket) {
+            return createMcpServer(log, sessionId, gcsBucket);
+        },
+        packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
+        serverCard: buildServerCardExtras("meta-mcp"),
+    };
+}
+export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
+//# sourceMappingURL=streamable-http-transport.js.map

package/dist/mcp-server/transports/streamable-http-transport.js.map

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

package/dist/services/meta/meta-graph-api-client.d.ts

@@ -0,0 +1,19 @@
+import type { Logger } from "pino";
+import type { MetaAuthAdapter } from "../../auth/meta-auth-adapter.js";
+import type { RequestContext } from "@cesteral/shared";
+export declare class MetaGraphApiClient {
+    private authAdapter;
+    private baseUrl;
+    private logger;
+    constructor(authAdapter: MetaAuthAdapter, baseUrl: string, logger: Logger);
+    get(path: string, params?: Record<string, string>, context?: RequestContext): Promise<unknown>;
+    post(path: string, data?: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    delete(path: string, context?: RequestContext): Promise<unknown>;
+    postMultipart(path: string, fields: Record<string, string>, fileField: string, fileBuffer: Buffer, filename: string, fileContentType: string, context?: RequestContext): Promise<unknown>;
+    private buildUrl;
+    private buildFormBody;
+    private request;
+    private logRateLimitHeaders;
+    private parseUsagePercent;
+}
+//# sourceMappingURL=meta-graph-api-client.d.ts.map

package/dist/services/meta/meta-graph-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-graph-api-client.d.ts","sourceRoot":"","sources":["../../../src/services/meta/meta-graph-api-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAmHpE,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBAFN,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAMlB,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IASb,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAgBb,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAgBnB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,aAAa;YAcP,OAAO;IAuDrB,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,iBAAiB;CAuB1B"}

package/dist/services/meta/meta-graph-api-client.js

@@ -0,0 +1,226 @@
+import { JsonRpcErrorCode } from "@cesteral/shared";
+import { executeWithRetry, fetchWithTimeout, buildMultipartFormData } from "@cesteral/shared";
+import { withMetaApiSpan } from "../../utils/platform.js";
+const RATE_LIMIT_CODES = new Set([4, 17, 32]);
+const RATE_LIMIT_WARNING_PERCENT = 80;
+const META_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialBackoffMs: 2_000,
+    maxBackoffMs: 30_000,
+    timeoutMs: 30_000,
+    platformName: "Meta",
+    tokenExpiryHint: "Meta access token expired. Generate a new token in Meta Business Suite or use a System User token.",
+};
+function parseMetaCode(body) {
+    try {
+        return JSON.parse(body).error?.code ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function isRetryableMetaError(code, httpStatus) {
+    return httpStatus === 429 || httpStatus >= 500 || RATE_LIMIT_CODES.has(code);
+}
+function buildMetaNextAction(_status, errorBody, defaultHint) {
+    let parsed;
+    try {
+        parsed = JSON.parse(errorBody).error;
+    }
+    catch {
+        return defaultHint;
+    }
+    if (!parsed)
+        return defaultHint;
+    const { code, error_subcode: subcode, message } = parsed;
+    if (code === 190) {
+        if (subcode === 463) {
+            return "Access token expired. Generate a new System User token in Meta Business Suite (Business Settings → Users → System Users) and update META_ACCESS_TOKEN.";
+        }
+        if (subcode === 467) {
+            return "Access token was revoked. Re-authenticate the System User and update META_ACCESS_TOKEN.";
+        }
+        return defaultHint;
+    }
+    if (code === 100) {
+        if (typeof message === "string" && /unknown field|nonexisting field/i.test(message)) {
+            return "Unknown or non-existent field in this request. Use meta_validate_entity to confirm field names for the entity type before retrying.";
+        }
+        if (typeof message === "string" && /permission/i.test(message)) {
+            return "The token does not have permission to read or write this field. Verify required permission with meta_validate_entity, then add the missing scope (e.g., ads_management) to the token.";
+        }
+        return "Invalid parameter. Check field names, IDs, and value formats with meta_validate_entity, then retry.";
+    }
+    if (code === 200) {
+        return "Missing permission. Add the required scope (typically ads_management or ads_read) to the access token, or grant the System User access to this ad account.";
+    }
+    if (code === 368) {
+        return "Account temporarily blocked for policy violations. Wait — Meta restores access automatically — and review the offending content in Meta Business Suite.";
+    }
+    if (code === 1487390 || code === 1487079 || code === 1487194) {
+        return "Creative or campaign rejected for policy violation. Review the policy reason in Ads Manager and revise the creative before resubmitting.";
+    }
+    return defaultHint;
+}
+function mapMetaErrorToJsonRpc(metaCode, httpStatus) {
+    if (RATE_LIMIT_CODES.has(metaCode) || httpStatus === 429) {
+        return JsonRpcErrorCode.RateLimited;
+    }
+    if (metaCode === 190 || httpStatus === 401) {
+        return JsonRpcErrorCode.Unauthorized;
+    }
+    if (metaCode === 10 || httpStatus === 403) {
+        return JsonRpcErrorCode.Forbidden;
+    }
+    if (httpStatus >= 500) {
+        return JsonRpcErrorCode.ServiceUnavailable;
+    }
+    return JsonRpcErrorCode.InvalidRequest;
+}
+export class MetaGraphApiClient {
+    authAdapter;
+    baseUrl;
+    logger;
+    constructor(authAdapter, baseUrl, logger) {
+        this.authAdapter = authAdapter;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+    }
+    async get(path, params, context) {
+        const url = this.buildUrl(path, params);
+        return this.request(url, context, { method: "GET" });
+    }
+    async post(path, data, context) {
+        const url = this.buildUrl(path);
+        const formBody = this.buildFormBody(data);
+        return this.request(url, context, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body: formBody,
+        });
+    }
+    async delete(path, context) {
+        const url = this.buildUrl(path);
+        return this.request(url, context, { method: "DELETE" });
+    }
+    async postMultipart(path, fields, fileField, fileBuffer, filename, fileContentType, context) {
+        const { body, contentType } = buildMultipartFormData(fields, fileField, fileBuffer, filename, fileContentType);
+        const url = this.buildUrl(path);
+        return this.request(url, context, {
+            method: "POST",
+            headers: { "Content-Type": contentType },
+            body,
+        });
+    }
+    buildUrl(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        return url.toString();
+    }
+    buildFormBody(data) {
+        if (!data)
+            return "";
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(data)) {
+            if (value === undefined || value === null)
+                continue;
+            if (typeof value === "object") {
+                params.set(key, JSON.stringify(value));
+            }
+            else {
+                params.set(key, String(value));
+            }
+        }
+        return params.toString();
+    }
+    async request(url, context, options) {
+        const method = options?.method || "GET";
+        return withMetaApiSpan(`api.${method}`, url, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            return executeWithRetry(META_RETRY_CONFIG, {
+                url,
+                fetchOptions: options,
+                context,
+                logger: this.logger,
+                fetchFn: (u, timeout, ctx, opts) => fetchWithTimeout(u, timeout, ctx, opts, (s) => s.replace(/access_token=[^&]+/, "access_token=***")),
+                getHeaders: async () => {
+                    const accessToken = await this.authAdapter.getAccessToken();
+                    return { Authorization: `Bearer ${accessToken}` };
+                },
+                mapStatusCode: (status, body) => mapMetaErrorToJsonRpc(parseMetaCode(body), status),
+                parseErrorBody: (body) => {
+                    try {
+                        return JSON.parse(body).error?.message ?? body.substring(0, 500);
+                    }
+                    catch {
+                        return body.substring(0, 500);
+                    }
+                },
+                isRetryable: (status, body) => isRetryableMetaError(parseMetaCode(body), status),
+                onResponse: (response, ctx) => {
+                    this.logRateLimitHeaders(response, ctx);
+                },
+                buildNextAction: buildMetaNextAction,
+                buildErrorData: (_status, body) => {
+                    try {
+                        const parsed = JSON.parse(body);
+                        return {
+                            metaCode: parsed.error?.code,
+                            metaSubcode: parsed.error?.error_subcode,
+                            metaType: parsed.error?.type,
+                            fbtraceId: parsed.error?.fbtrace_id,
+                        };
+                    }
+                    catch {
+                        return {};
+                    }
+                },
+            });
+        });
+    }
+    logRateLimitHeaders(response, context) {
+        const businessUsage = response.headers.get("x-business-use-case-usage");
+        const appUsage = response.headers.get("x-app-usage");
+        const adAccountUsage = response.headers.get("x-ad-account-usage");
+        if (businessUsage || appUsage || adAccountUsage) {
+            this.logger.debug({
+                requestId: context?.requestId,
+                businessUsage: businessUsage ? this.parseUsagePercent(businessUsage) : undefined,
+                appUsage: appUsage ? this.parseUsagePercent(appUsage) : undefined,
+                adAccountUsage: adAccountUsage ? this.parseUsagePercent(adAccountUsage) : undefined,
+            }, "Meta API rate limit headers");
+            const maxUsage = Math.max(businessUsage ? this.parseUsagePercent(businessUsage) : 0, appUsage ? this.parseUsagePercent(appUsage) : 0, adAccountUsage ? this.parseUsagePercent(adAccountUsage) : 0);
+            if (maxUsage >= RATE_LIMIT_WARNING_PERCENT) {
+                this.logger.warn({ maxUsage, requestId: context?.requestId }, "Meta API rate limit usage approaching threshold");
+            }
+        }
+    }
+    parseUsagePercent(headerValue) {
+        try {
+            const parsed = JSON.parse(headerValue);
+            if (parsed.percent_used !== undefined) {
+                return parsed.percent_used;
+            }
+            if (parsed.call_count !== undefined) {
+                return Math.max(parsed.call_count ?? 0, parsed.total_cputime ?? 0, parsed.total_time ?? 0);
+            }
+            for (const values of Object.values(parsed)) {
+                if (Array.isArray(values) && values.length > 0) {
+                    const entry = values[0];
+                    return Math.max(entry.call_count ?? 0, entry.total_cputime ?? 0, entry.total_time ?? 0);
+                }
+            }
+        }
+        catch {
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=meta-graph-api-client.js.map

package/dist/services/meta/meta-graph-api-client.js.map

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

package/dist/services/meta/meta-insights-service.d.ts

@@ -0,0 +1,76 @@
+import type { MetaGraphApiClient } from "./meta-graph-api-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import type { RequestContext } from "@cesteral/shared";
+import type { Logger } from "pino";
+export declare class MetaInsightsService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    constructor(rateLimiter: RateLimiter, httpClient: MetaGraphApiClient, logger: Logger);
+    private validateDateRangeInputs;
+    getInsights(entityId: string, options: {
+        fields?: string[];
+        datePreset?: string;
+        timeRange?: {
+            since: string;
+            until: string;
+        };
+        timeIncrement?: string;
+        level?: string;
+        limit?: number;
+        after?: string;
+    }, context?: RequestContext): Promise<{
+        data: unknown[];
+        nextCursor?: string;
+        summary?: unknown;
+    }>;
+    submitInsightsReport(entityId: string, options: {
+        fields?: string[];
+        datePreset?: string;
+        timeRange?: {
+            since: string;
+            until: string;
+        };
+        timeIncrement?: string;
+        level?: string;
+        breakdowns?: string[];
+    }, context?: RequestContext): Promise<{
+        reportRunId: string;
+    }>;
+    checkReportStatus(reportRunId: string, context?: RequestContext): Promise<{
+        reportRunId: string;
+        status: string;
+        asyncPercentCompletion?: number;
+        errorCode?: number;
+        errorMessage?: string;
+        errorSubcode?: number;
+        errorUserTitle?: string;
+        errorUserMsg?: string;
+    }>;
+    getReportResults(reportRunId: string, options: {
+        limit?: number;
+        after?: string;
+    }, context?: RequestContext): Promise<{
+        data: unknown[];
+        fetchedAllRows: boolean;
+        nextCursor?: string;
+    }>;
+    getInsightsBreakdowns(entityId: string, options: {
+        breakdowns: string[];
+        fields?: string[];
+        datePreset?: string;
+        timeRange?: {
+            since: string;
+            until: string;
+        };
+        timeIncrement?: string;
+        level?: string;
+        limit?: number;
+        after?: string;
+        actionAttributionWindows?: string[];
+    }, context?: RequestContext): Promise<{
+        data: unknown[];
+        nextCursor?: string;
+    }>;
+}
+//# sourceMappingURL=meta-insights-service.d.ts.map

package/dist/services/meta/meta-insights-service.d.ts.map

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