@adcp/sdk 5.23.0

package/dist/lib/discovery/network-consistency-checker.js

@@ -0,0 +1,541 @@
+"use strict";
+/**
+ * Network Consistency Checker for AdCP
+ *
+ * Validates managed publisher network deployments by checking that:
+ * 1. The authoritative adagents.json is well-formed
+ * 2. Each property domain has a valid pointer file
+ * 3. No orphaned or stale pointer files exist
+ * 4. All authorized agent endpoints are reachable
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkConsistencyChecker = void 0;
+const logger_1 = require("../utils/logger");
+const version_1 = require("../version");
+const validate_user_agent_1 = require("../utils/validate-user-agent");
+const validation_1 = require("../validation");
+// ====== Implementation ======
+const DEFAULT_CONCURRENCY = 10;
+const MAX_CONCURRENCY = 50;
+const DEFAULT_TIMEOUT_MS = 10_000;
+const MAX_RESPONSE_BYTES = 1_048_576; // 1 MB
+const FETCH_HEADERS = {
+    Accept: 'application/json, text/plain, */*',
+    'Accept-Language': 'en-US,en;q=0.9',
+    'Accept-Encoding': 'gzip, deflate, br',
+};
+class NetworkConsistencyChecker {
+    authoritativeUrl;
+    domains;
+    concurrency;
+    timeoutMs;
+    logger;
+    userAgentHeader;
+    fromHeader;
+    onProgress;
+    constructor(config) {
+        if (!config.authoritativeUrl && (!config.domains || config.domains.length === 0)) {
+            throw new Error('Either authoritativeUrl or domains must be provided');
+        }
+        if (config.userAgent) {
+            (0, validate_user_agent_1.validateUserAgent)(config.userAgent);
+        }
+        this.authoritativeUrl = config.authoritativeUrl;
+        this.domains = config.domains ?? [];
+        this.concurrency = Math.min(config.concurrency ?? DEFAULT_CONCURRENCY, MAX_CONCURRENCY);
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (this.concurrency < 1)
+            throw new Error('concurrency must be >= 1');
+        if (this.timeoutMs < 1)
+            throw new Error('timeoutMs must be >= 1');
+        this.logger = (0, logger_1.createLogger)({ level: config.logLevel ?? 'warn' }).child('NetworkConsistencyChecker');
+        this.userAgentHeader = `adcp-network-checker/${version_1.LIBRARY_VERSION} (+https://adcontextprotocol.org)`;
+        this.fromHeader = config.userAgent
+            ? `adcp-network-checker@adcontextprotocol.org (${config.userAgent}; v${version_1.LIBRARY_VERSION})`
+            : `adcp-network-checker@adcontextprotocol.org (v${version_1.LIBRARY_VERSION})`;
+        this.onProgress = config.onProgress;
+    }
+    async check() {
+        const report = {
+            checkedAt: new Date().toISOString(),
+            authoritativeUrl: '',
+            coverage: 0,
+            summary: {
+                totalDomains: 0,
+                validPointers: 0,
+                orphanedPointers: 0,
+                stalePointers: 0,
+                missingPointers: 0,
+                schemaErrors: 0,
+                unreachableAgents: 0,
+                totalIssues: 0,
+            },
+            orphanedPointers: [],
+            stalePointers: [],
+            missingPointers: [],
+            schemaErrors: [],
+            agentHealth: [],
+            domains: [],
+        };
+        // Step 1: Resolve and fetch the authoritative file
+        const { url: resolvedUrl, data: authData } = await this.fetchAuthoritative(report);
+        report.authoritativeUrl = resolvedUrl;
+        if (!authData) {
+            this.computeSummary(report, 0);
+            return report;
+        }
+        // Step 2: Validate authoritative file schema
+        this.validateSchema(authData, report);
+        // Step 3: Extract domains from authoritative properties
+        const authoritativeDomains = this.extractDomains(authData.properties ?? []);
+        // Step 4: Check agent endpoint health
+        if (authData.authorized_agents && authData.authorized_agents.length > 0) {
+            report.agentHealth = await this.checkAgentHealth(authData.authorized_agents);
+        }
+        // Step 5: Check pointer files on authoritative domains
+        await this.checkPointers(resolvedUrl, authoritativeDomains, report);
+        // Step 6: Check for orphaned pointers (domains not in authoritative file)
+        const extraDomains = this.domains.filter(d => !authoritativeDomains.has(d));
+        if (extraDomains.length > 0) {
+            await this.checkOrphanedPointers(resolvedUrl, extraDomains, report);
+        }
+        // Step 7: Compute coverage and summary
+        const total = authoritativeDomains.size;
+        const valid = report.domains.filter(d => d.status === 'ok').length;
+        report.coverage = total > 0 ? valid / total : 0;
+        this.computeSummary(report, total);
+        return report;
+    }
+    computeSummary(report, totalDomains) {
+        const unreachableAgents = report.agentHealth.filter(a => !a.reachable).length;
+        report.summary = {
+            totalDomains,
+            validPointers: report.domains.filter(d => d.status === 'ok').length,
+            orphanedPointers: report.orphanedPointers.length,
+            stalePointers: report.stalePointers.length,
+            missingPointers: report.missingPointers.length,
+            schemaErrors: report.schemaErrors.length,
+            unreachableAgents,
+            totalIssues: report.schemaErrors.length +
+                report.missingPointers.length +
+                report.stalePointers.length +
+                report.orphanedPointers.length +
+                unreachableAgents,
+        };
+    }
+    // ---- Internal methods ----
+    async fetchAuthoritative(report) {
+        let url = this.authoritativeUrl;
+        // If no authoritative URL, discover it from the first domain's pointer
+        if (!url) {
+            const firstDomain = this.domains[0];
+            try {
+                const pointerData = await this.fetchJson(`https://${firstDomain}/.well-known/adagents.json`);
+                if (pointerData.authoritative_location) {
+                    url = pointerData.authoritative_location;
+                }
+                else {
+                    return { url: `https://${firstDomain}/.well-known/adagents.json`, data: pointerData };
+                }
+            }
+            catch (error) {
+                report.schemaErrors.push({
+                    field: 'authoritative_location',
+                    message: `Failed to discover authoritative URL from ${firstDomain}: ${this.sanitizeError(error)}`,
+                });
+                return { url: '', data: null };
+            }
+        }
+        try {
+            const data = await this.fetchJson(url);
+            // Follow at most one authoritative_location redirect
+            if (data.authoritative_location && !data.authorized_agents) {
+                const redirectUrl = data.authoritative_location;
+                if (!redirectUrl.startsWith('https://')) {
+                    report.schemaErrors.push({
+                        field: 'authoritative_location',
+                        message: `authoritative_location must use HTTPS: ${redirectUrl}`,
+                    });
+                    return { url, data: null };
+                }
+                if (redirectUrl === url) {
+                    report.schemaErrors.push({
+                        field: 'authoritative_location',
+                        message: 'authoritative_location points to itself',
+                    });
+                    return { url, data: null };
+                }
+                const redirectData = await this.fetchJson(redirectUrl);
+                // Do not follow further redirects from the redirect target
+                return { url: redirectUrl, data: redirectData };
+            }
+            return { url, data };
+        }
+        catch (error) {
+            report.schemaErrors.push({
+                field: '$root',
+                message: `Failed to fetch authoritative file: ${this.sanitizeError(error)}`,
+            });
+            return { url: url ?? '', data: null };
+        }
+    }
+    validateSchema(data, report) {
+        if (!data.authorized_agents || !Array.isArray(data.authorized_agents)) {
+            report.schemaErrors.push({
+                field: 'authorized_agents',
+                message: 'Missing or invalid authorized_agents array',
+            });
+        }
+        else {
+            data.authorized_agents.forEach((agent, i) => {
+                if (!agent.url) {
+                    report.schemaErrors.push({
+                        field: `authorized_agents[${i}].url`,
+                        message: 'Missing required url field',
+                    });
+                }
+                if (!agent.authorized_for) {
+                    report.schemaErrors.push({
+                        field: `authorized_agents[${i}].authorized_for`,
+                        message: 'Missing required authorized_for field',
+                    });
+                }
+            });
+        }
+        if (data.properties && Array.isArray(data.properties)) {
+            data.properties.forEach((prop, i) => {
+                if (!prop.name) {
+                    report.schemaErrors.push({
+                        field: `properties[${i}].name`,
+                        message: 'Missing required name field',
+                    });
+                }
+                if (!prop.property_type) {
+                    report.schemaErrors.push({
+                        field: `properties[${i}].property_type`,
+                        message: 'Missing required property_type field',
+                    });
+                }
+                if (!prop.identifiers || !Array.isArray(prop.identifiers) || prop.identifiers.length === 0) {
+                    report.schemaErrors.push({
+                        field: `properties[${i}].identifiers`,
+                        message: 'Missing or empty identifiers array',
+                    });
+                }
+            });
+        }
+    }
+    extractDomains(properties) {
+        const domains = new Set();
+        for (const prop of properties) {
+            for (const id of prop.identifiers ?? []) {
+                if (id.type === 'domain' || id.type === 'subdomain') {
+                    domains.add(id.value.toLowerCase());
+                }
+            }
+            if (prop.publisher_domain) {
+                domains.add(prop.publisher_domain.toLowerCase());
+            }
+        }
+        return domains;
+    }
+    async checkAgentHealth(agents) {
+        let completed = 0;
+        return this.runConcurrent(agents, async (agent) => {
+            const result = await this.probeAgent(agent);
+            completed++;
+            this.onProgress?.({ phase: 'agents', completed, total: agents.length });
+            return result;
+        });
+    }
+    async probeAgent(agent) {
+        try {
+            (0, validation_1.validateAgentUrl)(agent.url);
+        }
+        catch (error) {
+            return {
+                url: agent.url,
+                reachable: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                let response = await fetch(agent.url, {
+                    method: 'HEAD',
+                    signal: controller.signal,
+                    redirect: 'manual',
+                    headers: {
+                        ...FETCH_HEADERS,
+                        'User-Agent': this.userAgentHeader,
+                        From: this.fromHeader,
+                    },
+                });
+                // Follow one redirect with SSRF validation
+                if (response.status >= 300 && response.status < 400) {
+                    const location = response.headers.get?.('location');
+                    if (!location) {
+                        return { url: agent.url, reachable: false, error: 'Redirect with no Location header' };
+                    }
+                    const redirectUrl = new URL(location, agent.url).toString();
+                    if (!redirectUrl.startsWith('https://')) {
+                        return { url: agent.url, reachable: false, error: 'Redirect to non-HTTPS URL' };
+                    }
+                    (0, validation_1.validateAgentUrl)(redirectUrl);
+                    response = await fetch(redirectUrl, {
+                        method: 'HEAD',
+                        signal: controller.signal,
+                        redirect: 'error',
+                        headers: {
+                            ...FETCH_HEADERS,
+                            'User-Agent': this.userAgentHeader,
+                            From: this.fromHeader,
+                        },
+                    });
+                }
+                return {
+                    url: agent.url,
+                    reachable: response.ok || response.status === 405, // 405 = HEAD rejected but server is alive
+                    statusCode: response.status,
+                };
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch (error) {
+            return {
+                url: agent.url,
+                reachable: false,
+                error: this.sanitizeError(error),
+            };
+        }
+    }
+    async checkPointers(authoritativeUrl, authoritativeDomains, report) {
+        const domains = Array.from(authoritativeDomains);
+        let completed = 0;
+        const results = await this.runConcurrent(domains, async (domain) => {
+            const result = await this.checkDomainPointer(domain, authoritativeUrl);
+            completed++;
+            this.onProgress?.({ phase: 'pointers', completed, total: domains.length, domain });
+            return result;
+        });
+        for (const result of results) {
+            report.domains.push(result.detail);
+            if (result.missing)
+                report.missingPointers.push(result.missing);
+            if (result.stale)
+                report.stalePointers.push(result.stale);
+        }
+    }
+    async checkDomainPointer(domain, authoritativeUrl) {
+        const url = `https://${domain}/.well-known/adagents.json`;
+        try {
+            const data = await this.fetchJson(url);
+            if (data.authoritative_location) {
+                if (data.authoritative_location === authoritativeUrl) {
+                    return {
+                        detail: {
+                            domain,
+                            status: 'ok',
+                            pointerUrl: data.authoritative_location,
+                            errors: [],
+                        },
+                    };
+                }
+                else {
+                    return {
+                        detail: {
+                            domain,
+                            status: 'stale_pointer',
+                            pointerUrl: data.authoritative_location,
+                            errors: [`Pointer references ${data.authoritative_location}, expected ${authoritativeUrl}`],
+                        },
+                        stale: {
+                            domain,
+                            pointerUrl: data.authoritative_location,
+                            expectedUrl: authoritativeUrl,
+                        },
+                    };
+                }
+            }
+            // No authoritative_location — the domain hosts its own file
+            if (url === authoritativeUrl) {
+                return {
+                    detail: { domain, status: 'ok', errors: [] },
+                };
+            }
+            return {
+                detail: {
+                    domain,
+                    status: 'stale_pointer',
+                    errors: [`adagents.json exists but has no authoritative_location pointing to ${authoritativeUrl}`],
+                },
+                stale: {
+                    domain,
+                    pointerUrl: url,
+                    expectedUrl: authoritativeUrl,
+                },
+            };
+        }
+        catch (error) {
+            const msg = this.sanitizeError(error);
+            this.logger.debug(`Failed to fetch pointer from ${domain}: ${msg}`);
+            return {
+                detail: { domain, status: 'missing_pointer', errors: [msg] },
+                missing: { domain, error: msg },
+            };
+        }
+    }
+    async checkOrphanedPointers(authoritativeUrl, extraDomains, report) {
+        let completed = 0;
+        const results = await this.runConcurrent(extraDomains, async (domain) => {
+            try {
+                const data = await this.fetchJson(`https://${domain}/.well-known/adagents.json`);
+                const result = data.authoritative_location === authoritativeUrl
+                    ? { domain, orphaned: true, pointerUrl: data.authoritative_location }
+                    : null;
+                return result;
+            }
+            catch {
+                return null;
+            }
+            finally {
+                completed++;
+                this.onProgress?.({ phase: 'orphans', completed, total: extraDomains.length, domain });
+            }
+        });
+        for (const result of results) {
+            if (result?.orphaned) {
+                report.orphanedPointers.push({
+                    domain: result.domain,
+                    pointerUrl: result.pointerUrl,
+                });
+                report.domains.push({
+                    domain: result.domain,
+                    status: 'orphaned_pointer',
+                    pointerUrl: result.pointerUrl,
+                    errors: ['Domain has pointer file but is not listed in authoritative properties'],
+                });
+            }
+        }
+    }
+    async fetchJson(url) {
+        (0, validation_1.validateAgentUrl)(url);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            let response = await fetch(url, {
+                signal: controller.signal,
+                redirect: 'manual',
+                headers: {
+                    ...FETCH_HEADERS,
+                    'User-Agent': this.userAgentHeader,
+                    From: this.fromHeader,
+                },
+            });
+            // Follow one HTTP redirect with SSRF validation
+            if (response.status >= 300 && response.status < 400) {
+                const location = response.headers.get?.('location');
+                if (!location) {
+                    throw new Error(`HTTP ${response.status} redirect with no Location header`);
+                }
+                const redirectUrl = new URL(location, url).toString();
+                if (!redirectUrl.startsWith('https://')) {
+                    throw new Error('Redirect to non-HTTPS URL not allowed');
+                }
+                (0, validation_1.validateAgentUrl)(redirectUrl);
+                response = await fetch(redirectUrl, {
+                    signal: controller.signal,
+                    redirect: 'error',
+                    headers: {
+                        ...FETCH_HEADERS,
+                        'User-Agent': this.userAgentHeader,
+                        From: this.fromHeader,
+                    },
+                });
+            }
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const contentLength = response.headers.get?.('content-length');
+            if (contentLength && parseInt(contentLength, 10) > MAX_RESPONSE_BYTES) {
+                throw new Error('Response too large');
+            }
+            const text = await response.text();
+            if (Buffer.byteLength(text, 'utf-8') > MAX_RESPONSE_BYTES) {
+                throw new Error('Response too large');
+            }
+            return JSON.parse(text);
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`Request timed out after ${this.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    sanitizeError(error) {
+        if (error instanceof Error) {
+            if (error.name === 'AbortError')
+                return 'Request timed out';
+            if (error.message.startsWith('HTTP '))
+                return error.message;
+            if (error.message.startsWith('Request timed out'))
+                return error.message;
+            if (error.message.includes('ECONNREFUSED'))
+                return 'Connection refused';
+            if (error.message.includes('ENOTFOUND'))
+                return 'DNS resolution failed';
+            if (error.message.includes('certificate'))
+                return 'TLS error';
+            if (error.message.includes('Response too large'))
+                return 'Response too large';
+            if (error.message.includes('not allowed'))
+                return error.message;
+            if (error.message.includes('must use HTTPS'))
+                return error.message;
+            if (error.message.includes('no Location header'))
+                return error.message;
+        }
+        return 'Request failed';
+    }
+    /**
+     * Run async operations with concurrency limit, preserving input order.
+     */
+    async runConcurrent(items, fn) {
+        const results = new Array(items.length);
+        let active = 0;
+        let nextIdx = 0;
+        return new Promise((resolve, reject) => {
+            if (items.length === 0)
+                return resolve([]);
+            const next = () => {
+                while (active < this.concurrency && nextIdx < items.length) {
+                    const i = nextIdx++;
+                    active++;
+                    fn(items[i])
+                        .then(r => {
+                        results[i] = r;
+                        active--;
+                        if (nextIdx >= items.length && active === 0) {
+                            resolve(results);
+                        }
+                        else {
+                            next();
+                        }
+                    })
+                        .catch(reject);
+                }
+            };
+            next();
+        });
+    }
+}
+exports.NetworkConsistencyChecker = NetworkConsistencyChecker;
+//# sourceMappingURL=network-consistency-checker.js.map

package/dist/lib/discovery/network-consistency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-consistency-checker.js","sourceRoot":"","sources":["../../../src/lib/discovery/network-consistency-checker.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,4CAA8D;AAC9D,wCAA6C;AAC7C,sEAAiE;AACjE,8CAAiD;AA2FjD,+BAA+B;AAE/B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,kBAAkB,GAAG,SAAS,CAAC,CAAC,OAAO;AAE7C,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,mCAAmC;IAC3C,iBAAiB,EAAE,gBAAgB;IACnC,iBAAiB,EAAE,mBAAmB;CACvC,CAAC;AAEF,MAAa,yBAAyB;IACnB,gBAAgB,CAAU;IAC1B,OAAO,CAAW;IAClB,WAAW,CAAS;IACpB,SAAS,CAAS;IAClB,MAAM,CAAkC;IACxC,eAAe,CAAS;IACxB,UAAU,CAAS;IACnB,UAAU,CAAqC;IAEhE,YAAY,MAAuC;QACjD,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,IAAA,uCAAiB,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACxF,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACxD,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACpG,IAAI,CAAC,eAAe,GAAG,wBAAwB,yBAAe,mCAAmC,CAAC;QAClG,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS;YAChC,CAAC,CAAC,+CAA+C,MAAM,CAAC,SAAS,MAAM,yBAAe,GAAG;YACzF,CAAC,CAAC,gDAAgD,yBAAe,GAAG,CAAC;QACvE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAuB;YACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,gBAAgB,EAAE,EAAE;YACpB,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE;gBACP,YAAY,EAAE,CAAC;gBACf,aAAa,EAAE,CAAC;gBAChB,gBAAgB,EAAE,CAAC;gBACnB,aAAa,EAAE,CAAC;gBAChB,eAAe,EAAE,CAAC;gBAClB,YAAY,EAAE,CAAC;gBACf,iBAAiB,EAAE,CAAC;gBACpB,WAAW,EAAE,CAAC;aACf;YACD,gBAAgB,EAAE,EAAE;YACpB,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,EAAE;YACnB,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,EAAE;SACZ,CAAC;QAEF,mDAAmD;QACnD,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACnF,MAAM,CAAC,gBAAgB,GAAG,WAAW,CAAC;QAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC/B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,6CAA6C;QAC7C,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEtC,wDAAwD;QACxD,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAE5E,sCAAsC;QACtC,IAAI,QAAQ,CAAC,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAC/E,CAAC;QAED,uDAAuD;QACvD,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAEpE,0EAA0E;QAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;QAED,uCAAuC;QACvC,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;QACnE,MAAM,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,MAA0B,EAAE,YAAoB;QACrE,MAAM,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAC9E,MAAM,CAAC,OAAO,GAAG;YACf,YAAY;YACZ,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM;YACnE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM;YAChD,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM;YAC1C,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM;YAC9C,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;YACxC,iBAAiB;YACjB,WAAW,EACT,MAAM,CAAC,YAAY,CAAC,MAAM;gBAC1B,MAAM,CAAC,eAAe,CAAC,MAAM;gBAC7B,MAAM,CAAC,aAAa,CAAC,MAAM;gBAC3B,MAAM,CAAC,gBAAgB,CAAC,MAAM;gBAC9B,iBAAiB;SACpB,CAAC;IACJ,CAAC;IAED,6BAA6B;IAErB,KAAK,CAAC,kBAAkB,CAAC,MAA0B;QACzD,IAAI,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAEhC,uEAAuE;QACvE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,WAAW,WAAW,4BAA4B,CAAC,CAAC;gBAC3G,IAAI,WAAW,CAAC,sBAAsB,EAAE,CAAC;oBACvC,GAAG,GAAG,WAAW,CAAC,sBAAsB,CAAC;gBAC3C,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,GAAG,EAAE,WAAW,WAAW,4BAA4B,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACxF,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;oBACvB,KAAK,EAAE,wBAAwB;oBAC/B,OAAO,EAAE,6CAA6C,WAAW,KAAK,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;iBAClG,CAAC,CAAC;gBACH,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,GAAG,CAAC,CAAC;YAErD,qDAAqD;YACrD,IAAI,IAAI,CAAC,sBAAsB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC;gBAChD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBACxC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,wBAAwB;wBAC/B,OAAO,EAAE,0CAA0C,WAAW,EAAE;qBACjE,CAAC,CAAC;oBACH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC7B,CAAC;gBACD,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;oBACxB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,wBAAwB;wBAC/B,OAAO,EAAE,yCAAyC;qBACnD,CAAC,CAAC;oBACH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC7B,CAAC;gBACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,WAAW,CAAC,CAAC;gBACrE,2DAA2D;gBAC3D,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAClD,CAAC;YAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;gBACvB,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,uCAAuC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;aAC5E,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,IAAkB,EAAE,MAA0B;QACnE,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;gBACvB,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,4CAA4C;aACtD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACf,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,qBAAqB,CAAC,OAAO;wBACpC,OAAO,EAAE,4BAA4B;qBACtC,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;oBAC1B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,qBAAqB,CAAC,kBAAkB;wBAC/C,OAAO,EAAE,uCAAuC;qBACjD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBAClC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,cAAc,CAAC,QAAQ;wBAC9B,OAAO,EAAE,6BAA6B;qBACvC,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;oBACxB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,cAAc,CAAC,iBAAiB;wBACvC,OAAO,EAAE,sCAAsC;qBAChD,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3F,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBACvB,KAAK,EAAE,cAAc,CAAC,eAAe;wBACrC,OAAO,EAAE,oCAAoC;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,UAAsB;QAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBACxC,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,MAAyB;QACtD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC5C,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAsB;QAC7C,IAAI,CAAC;YACH,IAAA,6BAAgB,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACrE,IAAI,CAAC;gBACH,IAAI,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;oBACpC,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,QAAQ,EAAE,QAAQ;oBAClB,OAAO,EAAE;wBACP,GAAG,aAAa;wBAChB,YAAY,EAAE,IAAI,CAAC,eAAe;wBAClC,IAAI,EAAE,IAAI,CAAC,UAAU;qBACtB;iBACF,CAAC,CAAC;gBAEH,2CAA2C;gBAC3C,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;oBACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACd,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;oBACzF,CAAC;oBACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAC5D,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;wBACxC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;oBAClF,CAAC;oBACD,IAAA,6BAAgB,EAAC,WAAW,CAAC,CAAC;oBAC9B,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE;wBAClC,MAAM,EAAE,MAAM;wBACd,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE;4BACP,GAAG,aAAa;4BAChB,YAAY,EAAE,IAAI,CAAC,eAAe;4BAClC,IAAI,EAAE,IAAI,CAAC,UAAU;yBACtB;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO;oBACL,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,0CAA0C;oBAC7F,UAAU,EAAE,QAAQ,CAAC,MAAM;iBAC5B,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,gBAAwB,EACxB,oBAAiC,EACjC,MAA0B;QAE1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAEjD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;YAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;YACvE,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACnF,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,MAAM,CAAC,KAAK;gBAAE,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,MAAc,EACd,gBAAwB;QAMxB,MAAM,GAAG,GAAG,WAAW,MAAM,4BAA4B,CAAC;QAE1D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,GAAG,CAAC,CAAC;YAErD,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,sBAAsB,KAAK,gBAAgB,EAAE,CAAC;oBACrD,OAAO;wBACL,MAAM,EAAE;4BACN,MAAM;4BACN,MAAM,EAAE,IAAI;4BACZ,UAAU,EAAE,IAAI,CAAC,sBAAsB;4BACvC,MAAM,EAAE,EAAE;yBACX;qBACF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO;wBACL,MAAM,EAAE;4BACN,MAAM;4BACN,MAAM,EAAE,eAAe;4BACvB,UAAU,EAAE,IAAI,CAAC,sBAAsB;4BACvC,MAAM,EAAE,CAAC,sBAAsB,IAAI,CAAC,sBAAsB,cAAc,gBAAgB,EAAE,CAAC;yBAC5F;wBACD,KAAK,EAAE;4BACL,MAAM;4BACN,UAAU,EAAE,IAAI,CAAC,sBAAsB;4BACvC,WAAW,EAAE,gBAAgB;yBAC9B;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,4DAA4D;YAC5D,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;gBAC7B,OAAO;oBACL,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;iBAC7C,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,MAAM,EAAE;oBACN,MAAM;oBACN,MAAM,EAAE,eAAe;oBACvB,MAAM,EAAE,CAAC,sEAAsE,gBAAgB,EAAE,CAAC;iBACnG;gBACD,KAAK,EAAE;oBACL,MAAM;oBACN,UAAU,EAAE,GAAG;oBACf,WAAW,EAAE,gBAAgB;iBAC9B;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO;gBACL,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;gBAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,gBAAwB,EACxB,YAAsB,EACtB,MAA0B;QAE1B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CACtC,YAAY,EACZ,KAAK,EACH,MAAM,EAKE,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,WAAW,MAAM,4BAA4B,CAAC,CAAC;gBAC/F,MAAM,MAAM,GACV,IAAI,CAAC,sBAAsB,KAAK,gBAAgB;oBAC9C,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE;oBACrE,CAAC,CAAC,IAAI,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,SAAS,EAAE,CAAC;gBACZ,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACzF,CAAC;QACH,CAAC,CACF,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACrB,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC;oBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B,CAAC,CAAC;gBACH,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;oBAClB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,kBAAkB;oBAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,MAAM,EAAE,CAAC,uEAAuE,CAAC;iBAClF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAI,GAAW;QACpC,IAAA,6BAAgB,EAAC,GAAG,CAAC,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,IAAI,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE;oBACP,GAAG,aAAa;oBAChB,YAAY,EAAE,IAAI,CAAC,eAAe;oBAClC,IAAI,EAAE,IAAI,CAAC,UAAU;iBACtB;aACF,CAAC,CAAC;YAEH,gDAAgD;YAChD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;gBACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,mCAAmC,CAAC,CAAC;gBAC9E,CAAC;gBACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACtD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,CAAC;gBACD,IAAA,6BAAgB,EAAC,WAAW,CAAC,CAAC;gBAC9B,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE;oBAClC,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE;wBACP,GAAG,aAAa;wBAChB,YAAY,EAAE,IAAI,CAAC,eAAe;wBAClC,IAAI,EAAE,IAAI,CAAC,UAAU;qBACtB;iBACF,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,CAAC;YAC/D,IAAI,aAAa,IAAI,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,kBAAkB,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAc;QAClC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;gBAAE,OAAO,mBAAmB,CAAC;YAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;YAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;YACxE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,oBAAoB,CAAC;YACxE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,OAAO,uBAAuB,CAAC;YACxE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAAE,OAAO,WAAW,CAAC;YAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAAE,OAAO,oBAAoB,CAAC;YAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;YAChE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;YACnE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;QACzE,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAO,KAAU,EAAE,EAA2B;QACvE,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,IAAI,OAAO,CAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;YAE3C,MAAM,IAAI,GAAG,GAAS,EAAE;gBACtB,OAAO,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC3D,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;oBACpB,MAAM,EAAE,CAAC;oBACT,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;yBACV,IAAI,CAAC,CAAC,CAAC,EAAE;wBACR,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;wBACf,MAAM,EAAE,CAAC;wBACT,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;4BAC5C,OAAO,CAAC,OAAO,CAAC,CAAC;wBACnB,CAAC;6BAAM,CAAC;4BACN,IAAI,EAAE,CAAC;wBACT,CAAC;oBACH,CAAC,CAAC;yBACD,KAAK,CAAC,MAAM,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC;YACF,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAxiBD,8DAwiBC"}

package/dist/lib/discovery/property-crawler.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Property Crawler for AdCP v2.2.0
+ *
+ * Discovers properties by:
+ * 1. Calling listAuthorizedProperties() on agents → get publisher_domains[]
+ * 2. Fetching /.well-known/adagents.json from each publisher domain
+ * 3. Extracting Property definitions from adagents.json
+ * 4. Building property → agents mapping
+ */
+import { type LogLevel } from '../utils/logger';
+import type { Property } from './types';
+export interface AgentInfo {
+    agent_url: string;
+    protocol?: 'a2a' | 'mcp';
+    auth_token?: string;
+}
+export interface CrawlResult {
+    successfulAgents: number;
+    failedAgents: number;
+    totalPublisherDomains: number;
+    totalProperties: number;
+    errors: Array<{
+        agent_url: string;
+        error: string;
+    }>;
+    warnings: Array<{
+        domain: string;
+        message: string;
+    }>;
+}
+export interface PropertyCrawlerConfig {
+    logLevel?: LogLevel;
+    /** Custom identifier for outbound requests. Used as User-Agent for protocol
+     *  calls to agents and included in the From header for direct property fetches. */
+    userAgent?: string;
+}
+export declare class PropertyCrawler {
+    private logger;
+    private userAgent?;
+    constructor(config?: PropertyCrawlerConfig);
+    /**
+     * Crawl multiple agents to discover their publisher domains and properties
+     */
+    crawlAgents(agents: AgentInfo[]): Promise<CrawlResult>;
+    /**
+     * Crawl a single agent to get its authorized publisher domains via capabilities
+     */
+    crawlAgent(agentInfo: AgentInfo): Promise<string[]>;
+    /**
+     * Fetch adagents.json from multiple publisher domains
+     */
+    fetchPublisherProperties(domains: string[]): Promise<{
+        properties: Record<string, Property[]>;
+        warnings: Array<{
+            domain: string;
+            message: string;
+        }>;
+    }>;
+    /**
+     * Expected failure patterns for .well-known/adagents.json fetches.
+     * These are common scenarios where domains don't have adagents.json files.
+     */
+    private static readonly EXPECTED_FAILURE_PATTERNS;
+    /**
+     * Determine if a fetch failure is expected (404, missing file, HTML response).
+     * Expected failures are logged at debug level; unexpected failures at error level.
+     *
+     * @param errorMessage - The error message to check
+     * @returns true if the error is expected and can be safely ignored
+     */
+    private isExpectedFailure;
+    /** Maximum number of authoritative_location redirects to follow */
+    private static readonly MAX_REDIRECT_DEPTH;
+    /**
+     * Fetch and parse adagents.json from a publisher domain.
+     * Handles authoritative_location redirects per AdCP spec.
+     */
+    fetchAdAgentsJson(domain: string): Promise<{
+        properties: Property[];
+        warning?: string;
+    }>;
+    /**
+     * Internal method to fetch adagents.json with redirect handling.
+     * @param url - URL to fetch from
+     * @param originalDomain - The original publisher domain (for property defaults)
+     * @param visitedUrls - Set of URLs already visited (loop detection)
+     * @param depth - Current redirect depth
+     */
+    private fetchAdAgentsJsonFromUrl;
+}
+//# sourceMappingURL=property-crawler.d.ts.map

package/dist/lib/discovery/property-crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-crawler.d.ts","sourceRoot":"","sources":["../../../src/lib/discovery/property-crawler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;uFACmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,CAAC,EAAE,qBAAqB;IAS1C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAqE5D;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BzD;;OAEG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACzD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvC,QAAQ,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtD,CAAC;IA+BF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAO/C;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAIzB,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;IAE/C;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,UAAU,EAAE,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAKF;;;;;;OAMG;YACW,wBAAwB;CA8HvC"}