@cyanheads/zenodo-mcp-server 0.1.1

package/dist/services/zenodo/http.js

@@ -0,0 +1,378 @@
+/**
+ * @fileoverview The single fetch boundary to the Zenodo REST API. Per-call status
+ * accept-lists (206/301/302/403/404/410/416 are outcomes here, not errors), the
+ * rate-limit header gate, two pacers (search and general buckets), and the retry
+ * matrix. Only paths the service builds are fetched, against a constant base URL,
+ * and redirects are followed only within zenodo.org.
+ * @module services/zenodo/http
+ */
+import { JsonRpcErrorCode, McpError, rateLimited, serviceUnavailable, timeout, } from '@cyanheads/mcp-ts-core/errors';
+import { createPacer, httpErrorFromResponse, withRetry, } from '@cyanheads/mcp-ts-core/utils';
+const ORIGIN = 'https://zenodo.org';
+const BASE_URL = `${ORIGIN}/api`;
+const REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308]);
+const MAX_REDIRECTS = 3;
+/** Largest JSON or text body read; the heaviest upstream page observed is 8.4 MB. */
+const MAX_BODY_BYTES = 32 * 1024 * 1024;
+/** Per-attempt budgets. Multi-thousand-file record GETs legitimately take 32–34 s. */
+export const JSON_ATTEMPT_MS = 45_000;
+export const CONTENT_ATTEMPT_MS = 20_000;
+const LADDER_DEADLINE_MS = 50_000;
+const PACER_MAX_WAIT_MS = 20_000;
+/** A 504 slower than this is Zenodo's ~30 s gateway cutoff — deterministic, never retried. */
+const SLOW_GATEWAY_MS = 10_000;
+function headerNumber(headers, name) {
+    const value = headers.get(name);
+    if (value === null || value.trim() === '')
+        return;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : undefined;
+}
+function looksLikeHtml(text) {
+    return /^\s*<(?:!doctype\s+html|html[\s>]|head[\s>]|body[\s>])/i.test(text);
+}
+/** Cancels a response body that will not be read, releasing the connection. */
+export async function discardBody(res) {
+    await res.body?.cancel().catch(() => undefined);
+}
+/** Reads a UTF-8 body of at most {@link MAX_BODY_BYTES}; a larger one is refused, not buffered. */
+export async function readText(res) {
+    const { bytes, more } = await readCapped(res, MAX_BODY_BYTES);
+    if (more) {
+        throw serviceUnavailable(`Zenodo returned a response body over ${MAX_BODY_BYTES} bytes; it was not read.`, { status: res.status, retryable: false });
+    }
+    return new TextDecoder().decode(bytes);
+}
+/** Reads a JSON body. An HTML page or unparseable body on a 2xx is a transient upstream fault. */
+export async function readJson(res) {
+    const text = await readText(res);
+    if (res.ok && looksLikeHtml(text)) {
+        throw serviceUnavailable('Zenodo returned an HTML page instead of JSON (edge error page).', {
+            status: res.status,
+        });
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (cause) {
+        throw serviceUnavailable('Zenodo returned a body that is not valid JSON.', { status: res.status }, { cause });
+    }
+}
+/**
+ * Streams a body, keeping at most `maxBytes` after skipping `skipBytes`, and
+ * cancels the stream as soon as the cap is passed. `more` is true when bytes
+ * remained past the cap.
+ */
+export async function readCapped(res, maxBytes, skipBytes = 0) {
+    const reader = res.body?.getReader();
+    if (!reader)
+        return { bytes: new Uint8Array(0), more: false };
+    const chunks = [];
+    let kept = 0;
+    let toSkip = skipBytes;
+    let more = false;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        let chunk = value;
+        if (toSkip > 0) {
+            const drop = Math.min(toSkip, chunk.length);
+            toSkip -= drop;
+            chunk = chunk.subarray(drop);
+            if (chunk.length === 0)
+                continue;
+        }
+        if (kept + chunk.length > maxBytes) {
+            chunks.push(chunk.subarray(0, maxBytes - kept));
+            kept = maxBytes;
+            more = true;
+            break;
+        }
+        chunks.push(chunk);
+        kept += chunk.length;
+    }
+    if (more)
+        await reader.cancel().catch(() => undefined);
+    const bytes = new Uint8Array(kept);
+    let offset = 0;
+    for (const c of chunks) {
+        bytes.set(c, offset);
+        offset += c.length;
+    }
+    return { bytes, more };
+}
+/** The HTTP client: pacing, header gate, retry ladder, and status mapping. */
+export class ZenodoHttp {
+    #general;
+    #headers = { search: {}, general: {} };
+    #search;
+    #token;
+    #userAgent;
+    constructor(options) {
+        this.#token = options.accessToken;
+        this.#userAgent = options.userAgent;
+        const cooldown = { baseMs: 2_000, maxMs: 60_000 };
+        this.#search = createPacer({
+            name: 'zenodo-search',
+            limits: [{ requests: 25, perMs: 60_000 }],
+            maxConcurrent: 2,
+            cooldown,
+        });
+        this.#general = createPacer({
+            name: 'zenodo-general',
+            limits: this.#token
+                ? [
+                    { requests: 90, perMs: 60_000 },
+                    { requests: 4_800, perMs: 3_600_000 },
+                ]
+                : [
+                    { requests: 55, perMs: 60_000 },
+                    { requests: 1_900, perMs: 3_600_000 },
+                ],
+            maxConcurrent: 4,
+            cooldown,
+        });
+    }
+    /** Rejects queued waiters and clears the pacers' timers. */
+    dispose() {
+        this.#search.dispose();
+        this.#general.dispose();
+    }
+    /**
+     * Runs one request through the retry ladder (outside) and the bucket's pacer
+     * (inside). `read` consumes the response of an accepted status and runs inside
+     * the attempt, so parse faults are retried with the fetch.
+     */
+    async request(req, read, ctx) {
+        try {
+            return await withRetry((attempt) => this.#paced(req, read, ctx, attempt), {
+                maxRetries: 1,
+                baseDelayMs: 1_000,
+                maxDelayMs: 15_000,
+                deadlineMs: LADDER_DEADLINE_MS,
+                signal: ctx.signal,
+                operation: req.operation,
+                context: ctx,
+            });
+        }
+        catch (error) {
+            if (!(error instanceof McpError))
+                throw error;
+            const reason = error.data?.reason;
+            if (reason === 'pacer_shed') {
+                const retryAfter = error.data?.retryAfter;
+                throw rateLimited("Zenodo request queue is full; this server's shared rate budget is spent for now.", {
+                    reason: 'rate_limited',
+                    ...(retryAfter !== undefined ? { retryAfter } : {}),
+                    ...ctx.recoveryFor('rate_limited'),
+                }, { cause: error });
+            }
+            if (reason === 'retry_deadline_exceeded')
+                throw this.#timeoutError(req, ctx, error);
+            throw error;
+        }
+    }
+    #paced(req, read, ctx, attempt) {
+        const options = { signal: attempt.signal, maxWaitMs: PACER_MAX_WAIT_MS };
+        const task = (signal) => this.#dispatch(req, read, ctx, signal, attempt.remainingMs);
+        if (req.bucket === 'general')
+            return this.#general.run(task, options);
+        // A search also counts against the global budget: reserve a general start slot,
+        // then run in the search pacer, so a search 429 closes only the search gate.
+        return this.#general
+            .run(async () => undefined, options)
+            .then(() => this.#search.run(task, options));
+    }
+    async #dispatch(req, read, ctx, signal, remainingMs) {
+        this.#checkGate(req.bucket, ctx);
+        const budget = Math.max(1, Math.min(req.attemptMs, remainingMs));
+        const deadline = new AbortController();
+        const timer = setTimeout(() => deadline.abort(), budget);
+        const started = Date.now();
+        try {
+            const res = await this.#fetchWithinZenodo(req, AbortSignal.any([signal, deadline.signal]));
+            if (!req.okStatuses.includes(res.status)) {
+                throw await this.#statusError(req, res, ctx, Date.now() - started);
+            }
+            return await read(res);
+        }
+        catch (error) {
+            if (error instanceof McpError)
+                throw error;
+            if (deadline.signal.aborted && !signal.aborted)
+                throw this.#timeoutError(req, ctx, error);
+            if (signal.aborted)
+                throw error;
+            throw serviceUnavailable(`Zenodo request failed before a response arrived (${req.operation}).`, { operation: req.operation }, { cause: error });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Fetches with `redirect: 'manual'` and follows a redirect only while its target
+     * stays on zenodo.org, so neither the request nor its Authorization header can be
+     * sent to another host. A `manual` request gets the 3xx itself.
+     */
+    async #fetchWithinZenodo(req, signal) {
+        let url = this.#url(req);
+        for (let hops = 0;; hops++) {
+            const res = await fetch(url, {
+                headers: this.#requestHeaders(req),
+                redirect: 'manual',
+                signal,
+            });
+            this.#track(req.bucket, res.headers);
+            const location = res.headers.get('location');
+            if (req.redirect === 'manual' || !REDIRECT_STATUSES.has(res.status) || location === null) {
+                return res;
+            }
+            await discardBody(res);
+            const next = URL.parse(location, url);
+            if (next?.origin !== ORIGIN || hops === MAX_REDIRECTS) {
+                throw serviceUnavailable(hops === MAX_REDIRECTS
+                    ? `Zenodo redirected ${req.operation} more than ${MAX_REDIRECTS} times.`
+                    : `Zenodo redirected ${req.operation} off zenodo.org; the redirect was not followed.`, { status: res.status, retryable: false });
+            }
+            url = next.href;
+        }
+    }
+    #url(req) {
+        const query = req.query?.length
+            ? `?${new URLSearchParams(req.query)}`
+            : '';
+        return `${BASE_URL}${req.path}${query}`;
+    }
+    #requestHeaders(req) {
+        return {
+            Accept: req.accept,
+            'User-Agent': this.#userAgent,
+            ...(this.#token ? { Authorization: `Bearer ${this.#token}` } : {}),
+            ...(req.range ? { Range: req.range } : {}),
+        };
+    }
+    /** Records `X-RateLimit-*` for the bucket — on every response, error statuses included. */
+    #track(bucket, headers) {
+        const limit = headerNumber(headers, 'x-ratelimit-limit');
+        const remaining = headerNumber(headers, 'x-ratelimit-remaining');
+        const resetAt = headerNumber(headers, 'x-ratelimit-reset');
+        if (limit === undefined && remaining === undefined && resetAt === undefined)
+            return;
+        this.#headers[bucket] = {
+            ...(limit !== undefined ? { limit } : {}),
+            ...(remaining !== undefined ? { remaining } : {}),
+            ...(resetAt !== undefined ? { resetAt } : {}),
+        };
+    }
+    /** Refuses to dispatch while the bucket's advertised window is spent. */
+    #checkGate(bucket, ctx) {
+        const { remaining, resetAt } = this.#headers[bucket];
+        if (remaining === undefined || resetAt === undefined || remaining > 0)
+            return;
+        const waitMs = resetAt * 1000 - Date.now();
+        if (waitMs <= 0)
+            return;
+        throw rateLimited(`Zenodo's ${bucket} rate-limit window is spent until it resets.`, {
+            reason: 'rate_limited',
+            retryAfter: Math.ceil(waitMs / 1000),
+            ...ctx.recoveryFor('rate_limited'),
+        });
+    }
+    async #statusError(req, res, ctx, elapsedMs) {
+        const status = res.status;
+        if (status === 429) {
+            const reset = headerNumber(res.headers, 'x-ratelimit-reset');
+            const retryAfter = headerNumber(res.headers, 'retry-after') ??
+                (reset === undefined ? undefined : Math.max(1, Math.ceil(reset - Date.now() / 1000)));
+            await discardBody(res);
+            return rateLimited('Zenodo answered HTTP 429 (rate limit reached).', {
+                reason: 'rate_limited',
+                status,
+                ...(retryAfter !== undefined ? { retryAfter } : {}),
+                ...ctx.recoveryFor('rate_limited'),
+            });
+        }
+        if (status >= 500) {
+            await discardBody(res);
+            if (status === 504 && elapsedMs >= SLOW_GATEWAY_MS)
+                return this.#timeoutError(req, ctx);
+            if (status === 500)
+                return this.#serverError(req, ctx);
+            return serviceUnavailable(`Zenodo answered HTTP ${status} (${req.operation}).`, { status });
+        }
+        const error = await httpErrorFromResponse(res, {
+            service: 'Zenodo',
+            data: { operation: req.operation },
+        });
+        // Zenodo sends Retry-After on every response, counting to its window reset; it
+        // means "wait" only on a 429, which is mapped above.
+        const { retryAfter: _windowReset, ...data } = error.data ?? {};
+        return new McpError(error.code, error.message, data);
+    }
+    /**
+     * A ZIP Zenodo cannot open: its `/container` listing or member read answered 500
+     * (after the one retry) or never finished. The message names the archive's
+     * download URL, the path that still works.
+     */
+    #archiveError(req, ctx, failure, cause) {
+        const what = failure === 'status_500' ? 'HTTP 500' : 'no complete response in time';
+        return new McpError(JsonRpcErrorCode.ServiceUnavailable, `Zenodo could not open this .zip archive (${what}); download it from ${req.downloadUrl ?? 'its download_url'} instead.`, {
+            reason: 'archive_unavailable',
+            ...(failure === 'status_500' ? { status: 500 } : { retryable: false }),
+            ...ctx.recoveryFor('archive_unavailable'),
+        }, cause === undefined ? undefined : { cause });
+    }
+    /** HTTP 500, per the retry matrix. */
+    #serverError(req, ctx) {
+        switch (req.endpoint) {
+            case 'search':
+                return serviceUnavailable('Zenodo answered HTTP 500 for this search query.', {
+                    reason: 'query_failed',
+                    status: 500,
+                    retryable: false,
+                    ...ctx.recoveryFor('query_failed'),
+                });
+            case 'doi_lookup':
+                return serviceUnavailable('Zenodo answered HTTP 500 while resolving the DOI.', {
+                    reason: 'record_unavailable',
+                    status: 500,
+                    retryable: false,
+                    ...ctx.recoveryFor('record_unavailable'),
+                });
+            case 'record':
+            case 'versions':
+                return serviceUnavailable('Zenodo answered HTTP 500 for this record.', {
+                    reason: 'record_unavailable',
+                    status: 500,
+                    ...ctx.recoveryFor('record_unavailable'),
+                });
+            case 'archive':
+                return this.#archiveError(req, ctx, 'status_500');
+            default:
+                return serviceUnavailable(`Zenodo answered HTTP 500 (${req.operation}).`, { status: 500 });
+        }
+    }
+    /** Slow 504, attempt timeout, or ladder deadline — deterministic for oversized payloads, never retried. */
+    #timeoutError(req, ctx, cause) {
+        const options = cause === undefined ? undefined : { cause };
+        switch (req.endpoint) {
+            case 'search':
+                return timeout('Zenodo did not finish the search page within its time budget; large file manifests in the hits make pages heavy.', { reason: 'upstream_timeout', retryable: false, ...ctx.recoveryFor('upstream_timeout') }, options);
+            case 'versions':
+                return timeout('Zenodo did not finish the versions page within its time budget; the series holds large file manifests.', { reason: 'upstream_timeout', retryable: false, ...ctx.recoveryFor('upstream_timeout') }, options);
+            case 'record':
+            case 'doi_lookup':
+                return new McpError(JsonRpcErrorCode.ServiceUnavailable, 'Zenodo did not serve this record within its time budget (gateway cutoff or timeout).', {
+                    reason: 'record_unavailable',
+                    retryable: false,
+                    ...ctx.recoveryFor('record_unavailable'),
+                }, options);
+            case 'archive':
+                return this.#archiveError(req, ctx, 'timeout', cause);
+            default:
+                return timeout(`Zenodo did not respond within the time budget (${req.operation}).`, { retryable: false }, options);
+        }
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/services/zenodo/http.js.map

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

package/dist/services/zenodo/identifiers.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview Pure parsers for the identifier forms Zenodo tools accept: record
+ * references (record ids, Zenodo and external DOIs, zenodo.org and doi.org URLs),
+ * funder, award, ORCID, and community references, plus file-key path encoding.
+ * Nothing here touches the network; URLs are parsed locally and never fetched.
+ * @module services/zenodo/identifiers
+ */
+/** How an `id` input was written. */
+export type InputKind = 'record_id' | 'zenodo_doi' | 'external_doi' | 'url';
+/** A record reference resolved to a Zenodo record id without any upstream call. */
+export interface RecidRef {
+    inputKind: InputKind;
+    kind: 'recid';
+    recid: string;
+}
+/**
+ * A DOI minted outside Zenodo's `10.5281/zenodo.N` scheme. `doi` is the form as
+ * given; `strippedDoi` is the form with trailing `.`/`,`/`;` removed, tried only
+ * when the as-given form misses.
+ */
+export interface ExternalDoiRef {
+    doi: string;
+    inputKind: InputKind;
+    kind: 'external_doi';
+    strippedDoi?: string;
+}
+/** An input that matches no accepted form. `message` says why. */
+export interface ParseFailure {
+    kind: 'invalid';
+    message: string;
+}
+export type RecordRef = RecidRef | ExternalDoiRef;
+/**
+ * Classifies a record reference. Accepts a record id, `zenodo.N`, a Zenodo DOI
+ * (any case, optionally `doi:`-prefixed), another DOI, a doi.org URL, or a
+ * zenodo.org record/DOI/badge URL. Wrapping `<>` / quotes (with any punctuation
+ * after them) and trailing punctuation after a record id or Zenodo DOI are
+ * stripped, in whichever order they were combined. Query strings and
+ * fragments are ignored. Never fetches anything.
+ */
+export declare function parseRecordRef(raw: string): RecordRef | ParseFailure;
+/** True when `raw` parses as a single DOI or URL record reference (not a bare number). */
+export declare function isWholeIdentifier(raw: string): boolean;
+/** A funder reference as the service resolves it. */
+export type FunderRef = {
+    kind: 'ror';
+    ror: string;
+} | {
+    kind: 'funder_doi';
+    doi: string;
+};
+/**
+ * Parses a funder reference: a ROR id (`01cwqze88`), a ROR URL, or a Crossref
+ * Funder DOI (`10.13039/100000002`, bare, `doi:`-prefixed, or as a doi.org URL).
+ * Returns `undefined` for anything else — funder names are never matched.
+ */
+export declare function parseFunderRef(raw: string): FunderRef | undefined;
+/** European Commission ROR id — the funder behind CORDIS award DOIs (`10.3030/N`). */
+export declare const EUROPEAN_COMMISSION_ROR = "00k4n6c32";
+/** How an award reference filters: by full award id, or by grant number alone. */
+export type AwardRef = {
+    field: 'id';
+    value: string;
+} | {
+    field: 'number';
+    value: string;
+};
+/**
+ * Parses an award reference: `<funder-ror>::<number>`, a CORDIS award DOI
+ * (`10.3030/<n>` → European Commission), or a bare grant number.
+ */
+export declare function parseAwardRef(raw: string): AwardRef;
+/**
+ * Normalizes an ORCID input: strips an `orcid.org/` URL prefix and uppercases a
+ * trailing check character `x`. Validation is separate ({@link isValidOrcid}).
+ */
+export declare function normalizeOrcid(raw: string): string;
+/** The `0000-0000-0000-000X` shape of an ORCID iD. */
+export declare const ORCID_PATTERN: RegExp;
+/** True when `orcid` has the {@link ORCID_PATTERN} shape and a valid ISO 7064 mod 11-2 check digit. */
+export declare function isValidOrcid(orcid: string): boolean;
+/**
+ * Parses a community reference: a slug, a UUID, or a `zenodo.org/communities/<slug>`
+ * URL (scheme optional). Returns `undefined` when the value cannot be a
+ * community identifier, so it is never interpolated into a request path.
+ */
+export declare function parseCommunityRef(raw: string): string | undefined;
+/**
+ * True when a `/`-separated key or member path has a `.` or `..` segment.
+ * `encodeURIComponent` leaves those literal and the URL parser resolves them, so
+ * such a path would reach a different zenodo.org endpoint instead of naming a file.
+ */
+export declare function hasDotSegment(key: string): boolean;
+/**
+ * Encodes a file key (or ZIP member path) for a URL path: each `/`-separated
+ * segment is percent-encoded. Request paths must reject {@link hasDotSegment}
+ * keys first, since `.` and `..` survive encoding.
+ */
+export declare function encodeKeySegments(key: string): string;
+/** The public download URL for a top-level file. */
+export declare function downloadUrl(recid: string, key: string): string;
+/** The public landing page for a record. */
+export declare function recordUrl(recid: string): string;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/services/zenodo/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../../src/services/zenodo/identifiers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,KAAK,CAAC;AAE5E,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AA4IlD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAwBpE;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAI3F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAOjE;AAED,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAOnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,sDAAsD;AACtD,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}