@cyanheads/brapi-mcp-server 0.3.5

package/dist/mcp-server/tools/shared/orientation-envelope.js

@@ -0,0 +1,254 @@
+/**
+ * @fileoverview Shared builder for the BrAPI orientation envelope returned
+ * by both `brapi_connect` (inlined after registration) and
+ * `brapi_server_info` (on-demand). Pulls from CapabilityRegistry and the
+ * active ServerRegistry entry, then layers in cheap opportunistic counts via
+ * `pageSize=0` probes. Counts degrade silently — a server that doesn't
+ * honor the probe just omits the field rather than failing the whole call.
+ *
+ * @module mcp-server/tools/shared/orientation-envelope
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/**
+ * BrAPI endpoints we treat as the "common floor" — their absence is worth
+ * surfacing as a notable gap in the orientation envelope so the agent knows
+ * which tools will fail before they call them.
+ */
+const COMMON_FLOOR = [
+    'studies',
+    'germplasm',
+    'observations',
+    'observationunits',
+    'variables',
+    'programs',
+    'trials',
+    'locations',
+    'seasons',
+    'search/studies',
+    'search/germplasm',
+    'search/observations',
+];
+export const ServerIdentitySchema = z
+    .object({
+    name: z.string().optional().describe('Server display name from /serverinfo.'),
+    description: z.string().optional().describe('Free-form server description.'),
+    organizationName: z.string().optional().describe('Hosting organization.'),
+    organizationURL: z.string().optional().describe('Organization website.'),
+    documentationURL: z.string().optional().describe('Documentation URL for this server.'),
+    contactEmail: z.string().optional().describe('Contact email for the operator.'),
+    brapiVersion: z.string().optional().describe('Highest BrAPI version the server reports.'),
+})
+    .describe('Normalized identity fields from /serverinfo. Every field is optional.');
+export const OrientationAuthSchema = z
+    .object({
+    mode: z
+        .enum(['none', 'sgn', 'oauth2', 'api_key', 'bearer'])
+        .describe('Auth mode of the active connection.'),
+    headerName: z.string().optional().describe('HTTP header carrying credentials.'),
+    expiresAt: z.string().optional().describe('ISO 8601 token-expiry timestamp, when known.'),
+})
+    .describe('Auth summary for the active connection — no secrets returned.');
+export const OrientationCapabilitiesSchema = z
+    .object({
+    supportedCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('Total distinct services the server advertises in /calls.'),
+    supported: z
+        .array(z.string().describe('BrAPI service name (e.g. "studies", "search/germplasm").'))
+        .describe('Sorted list of supported service names.'),
+    notableGaps: z
+        .array(z.string().describe('Common-floor service the server does not expose.'))
+        .describe('Common-floor services this server does NOT expose.'),
+})
+    .describe('Capability profile summary. Downstream tools pre-flight against `supported`.');
+export const OrientationContentSchema = z
+    .object({
+    crops: z
+        .array(z.string().describe('Common crop name as returned by /commoncropnames.'))
+        .describe('Crops the server declares via /commoncropnames.'),
+    studyCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Total studies hosted, when the server exposes a cheap count.'),
+    germplasmCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Total germplasm hosted, when the server exposes a cheap count.'),
+    programCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Total programs hosted, when the server exposes a cheap count.'),
+    locationCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Total locations hosted, when the server exposes a cheap count.'),
+})
+    .describe('Content summary. Counts are populated only when the server supports cheap totals.');
+export const OrientationEnvelopeSchema = z.object({
+    alias: z.string().describe('Connection alias.'),
+    baseUrl: z.string().describe('BrAPI v2 base URL for this connection.'),
+    server: ServerIdentitySchema.describe('Normalized server identity block.'),
+    auth: OrientationAuthSchema.describe('Auth summary for the active connection.'),
+    capabilities: OrientationCapabilitiesSchema.describe('Capability profile derived from /serverinfo.'),
+    content: OrientationContentSchema.describe('Content summary (crops + optional totals).'),
+    notes: z
+        .array(z.string().describe('Server-specific quirk or degradation note.'))
+        .describe('Server-specific quirks or degradation notes.'),
+    fetchedAt: z.string().describe('ISO 8601 timestamp of when this envelope was composed.'),
+});
+/**
+ * Compose the orientation envelope for a connected server. Runs the
+ * CapabilityRegistry profile (cached after the first call) plus a parallel
+ * set of cheap `pageSize=0` probes for totals.
+ */
+export async function buildOrientationEnvelope(ctx, connection, deps) {
+    const baseRequestOptions = {};
+    if (connection.resolvedAuth)
+        baseRequestOptions.auth = connection.resolvedAuth;
+    const capabilityLookup = {};
+    if (connection.resolvedAuth)
+        capabilityLookup.auth = connection.resolvedAuth;
+    const profile = await deps.registry.profile(connection.baseUrl, ctx, capabilityLookup);
+    const supportedServices = Object.keys(profile.supported).sort();
+    const supportedSet = new Set(supportedServices);
+    const notableGaps = COMMON_FLOOR.filter((svc) => !supportedSet.has(svc));
+    const notes = [];
+    if (supportedServices.length === 0) {
+        notes.push('Server did not advertise any calls via /serverinfo or /calls — downstream tools will fail until the capability profile populates.');
+    }
+    if (!profile.server.brapiVersion) {
+        notes.push('Server did not declare a BrAPI version; treating as v2 by default. Behavior may vary.');
+    }
+    const counts = await fetchOpportunisticCounts(deps.client, connection.baseUrl, ctx, supportedSet, baseRequestOptions);
+    const content = { crops: profile.crops };
+    if (counts.studyCount !== undefined)
+        content.studyCount = counts.studyCount;
+    if (counts.germplasmCount !== undefined)
+        content.germplasmCount = counts.germplasmCount;
+    if (counts.programCount !== undefined)
+        content.programCount = counts.programCount;
+    if (counts.locationCount !== undefined)
+        content.locationCount = counts.locationCount;
+    const auth = { mode: connection.authMode };
+    if (connection.resolvedAuth?.headerName)
+        auth.headerName = connection.resolvedAuth.headerName;
+    if (connection.resolvedAuth?.expiresAt)
+        auth.expiresAt = connection.resolvedAuth.expiresAt;
+    return {
+        alias: connection.alias,
+        baseUrl: connection.baseUrl,
+        server: { ...profile.server },
+        auth,
+        capabilities: {
+            supportedCount: supportedServices.length,
+            supported: supportedServices,
+            notableGaps,
+        },
+        content,
+        notes,
+        fetchedAt: new Date().toISOString(),
+    };
+}
+async function fetchOpportunisticCounts(client, baseUrl, ctx, supportedSet, baseOptions) {
+    const probes = [
+        { key: 'studyCount', path: '/studies', service: 'studies' },
+        { key: 'germplasmCount', path: '/germplasm', service: 'germplasm' },
+        { key: 'programCount', path: '/programs', service: 'programs' },
+        { key: 'locationCount', path: '/locations', service: 'locations' },
+    ];
+    const attempts = probes
+        .filter((probe) => supportedSet.has(probe.service))
+        .map(async (probe) => {
+        try {
+            const env = await client.get(baseUrl, probe.path, ctx, {
+                ...baseOptions,
+                params: { pageSize: 0 },
+            });
+            const total = env.metadata?.pagination?.totalCount;
+            if (typeof total === 'number' && Number.isFinite(total)) {
+                return { key: probe.key, total };
+            }
+        }
+        catch (err) {
+            ctx.log.debug('Opportunistic count probe failed', {
+                path: probe.path,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return;
+    });
+    const settled = await Promise.all(attempts);
+    const result = {};
+    for (const entry of settled) {
+        if (!entry)
+            continue;
+        result[entry.key] = entry.total;
+    }
+    return result;
+}
+export function formatOrientationEnvelope(envelope) {
+    const lines = [];
+    const title = envelope.server.name ?? envelope.alias;
+    lines.push(`# Connected: ${title}`);
+    lines.push('');
+    lines.push(`- **Alias:** ${envelope.alias}`);
+    lines.push(`- **Base URL:** ${envelope.baseUrl}`);
+    lines.push(`- **BrAPI version:** ${envelope.server.brapiVersion ?? 'unknown'}`);
+    if (envelope.server.organizationName)
+        lines.push(`- **Organization:** ${envelope.server.organizationName}`);
+    if (envelope.server.description)
+        lines.push(`- **Description:** ${envelope.server.description}`);
+    if (envelope.server.documentationURL)
+        lines.push(`- **Docs:** ${envelope.server.documentationURL}`);
+    if (envelope.server.contactEmail)
+        lines.push(`- **Contact:** ${envelope.server.contactEmail}`);
+    if (envelope.server.organizationURL)
+        lines.push(`- **Organization URL:** ${envelope.server.organizationURL}`);
+    lines.push('');
+    lines.push(`**Auth:** ${envelope.auth.mode}${envelope.auth.headerName ? ` (header: ${envelope.auth.headerName})` : ''}${envelope.auth.expiresAt ? ` · expires ${envelope.auth.expiresAt}` : ''}`);
+    lines.push('');
+    lines.push('## Capabilities');
+    lines.push(`- ${envelope.capabilities.supportedCount} service(s) advertised`);
+    if (envelope.capabilities.supported.length > 0) {
+        lines.push(`- Supported: ${envelope.capabilities.supported.join(', ')}`);
+    }
+    if (envelope.capabilities.notableGaps.length > 0) {
+        lines.push(`- Notable gaps (missing from the common floor): ${envelope.capabilities.notableGaps.join(', ')}`);
+    }
+    lines.push('');
+    lines.push('## Content');
+    if (envelope.content.crops.length > 0) {
+        lines.push(`- **Crops (${envelope.content.crops.length}):** ${envelope.content.crops.join(', ')}`);
+    }
+    else {
+        lines.push('- Crops: — (server did not expose /commoncropnames)');
+    }
+    if (envelope.content.studyCount !== undefined)
+        lines.push(`- Studies: ${envelope.content.studyCount}`);
+    if (envelope.content.germplasmCount !== undefined)
+        lines.push(`- Germplasm: ${envelope.content.germplasmCount}`);
+    if (envelope.content.programCount !== undefined)
+        lines.push(`- Programs: ${envelope.content.programCount}`);
+    if (envelope.content.locationCount !== undefined)
+        lines.push(`- Locations: ${envelope.content.locationCount}`);
+    if (envelope.notes.length > 0) {
+        lines.push('');
+        lines.push('## Notes');
+        for (const note of envelope.notes)
+            lines.push(`- ${note}`);
+    }
+    lines.push('');
+    lines.push(`_Fetched at ${envelope.fetchedAt}._`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=orientation-envelope.js.map

package/dist/mcp-server/tools/shared/orientation-envelope.js.map

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

package/dist/mcp-server/tools/shared/raw-routing-hints.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Routing nudges emitted by `brapi_raw_get` / `brapi_raw_search`
+ * when the target endpoint is already covered by a curated goal-shaped tool.
+ * Keeps the raw surface honest about its role as a last-resort escape hatch.
+ *
+ * @module mcp-server/tools/shared/raw-routing-hints
+ */
+export declare function suggestForGet(path: string): string | undefined;
+export declare function suggestForSearch(noun: string): string | undefined;
+//# sourceMappingURL=raw-routing-hints.d.ts.map

package/dist/mcp-server/tools/shared/raw-routing-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-routing-hints.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/shared/raw-routing-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8CH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE"}

package/dist/mcp-server/tools/shared/raw-routing-hints.js

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Routing nudges emitted by `brapi_raw_get` / `brapi_raw_search`
+ * when the target endpoint is already covered by a curated goal-shaped tool.
+ * Keeps the raw surface honest about its role as a last-resort escape hatch.
+ *
+ * @module mcp-server/tools/shared/raw-routing-hints
+ */
+/**
+ * Map from a normalized path segment (no leading slash, no query) to the
+ * goal-shaped tool that enriches it. Only endpoints that a curated tool
+ * strictly supersedes should appear here; niche endpoints stay quiet.
+ */
+const GET_NUDGES = {
+    studies: 'This endpoint is also served by `brapi_find_studies` which enriches with program/trial/location FKs and returns distributions in one call.',
+    germplasm: 'This endpoint is also served by `brapi_find_germplasm` which adds distributions and dataset spillover.',
+    observations: 'This endpoint is also served by `brapi_find_observations` which adds distributions and dataset spillover.',
+    variables: 'This endpoint is also served by `brapi_find_variables` which adds free-text ranking via OntologyResolver.',
+    images: 'This endpoint is also served by `brapi_find_images`; use `brapi_get_image` to pull bytes inline.',
+    variants: 'This endpoint is also served by `brapi_find_variants` which handles distributions and dataset spillover.',
+    locations: 'This endpoint is also served by `brapi_find_locations` which adds distributions and optional bounding-box filtering.',
+    serverinfo: 'For a full orientation envelope, call `brapi_server_info` (which uses the cached capability profile).',
+    calls: 'The `brapi_server_info` envelope already surfaces the supported call set.',
+    commoncropnames: 'Crop names are included in `brapi_server_info.content.crops`.',
+};
+const SEARCH_NUDGES = {
+    studies: 'Consider `brapi_find_studies` — handles async polling + FK resolution automatically.',
+    germplasm: 'Consider `brapi_find_germplasm` — handles distributions + spillover.',
+    observations: 'Consider `brapi_find_observations` — handles spillover and distributions.',
+    variables: 'Consider `brapi_find_variables` — ranked client-side via OntologyResolver when text is provided.',
+    calls: 'Consider `brapi_find_genotype_calls` — handles async-search polling, maxCalls cap, and dataset spillover automatically.',
+    images: 'Consider `brapi_find_images`.',
+    variants: 'Consider `brapi_find_variants`.',
+    locations: 'Consider `brapi_find_locations`.',
+};
+/** Normalize "/images/123/imagecontent" → "images". */
+function rootSegment(path) {
+    return path.replace(/^\/+/, '').split('/')[0] ?? '';
+}
+export function suggestForGet(path) {
+    const seg = rootSegment(path);
+    return GET_NUDGES[seg];
+}
+export function suggestForSearch(noun) {
+    return SEARCH_NUDGES[noun.replace(/^\/+/, '')];
+}
+//# sourceMappingURL=raw-routing-hints.js.map

package/dist/mcp-server/tools/shared/raw-routing-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-routing-hints.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/shared/raw-routing-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,UAAU,GAA2B;IACzC,OAAO,EACL,4IAA4I;IAC9I,SAAS,EACP,wGAAwG;IAC1G,YAAY,EACV,2GAA2G;IAC7G,SAAS,EACP,2GAA2G;IAC7G,MAAM,EACJ,kGAAkG;IACpG,QAAQ,EACN,0GAA0G;IAC5G,SAAS,EACP,sHAAsH;IACxH,UAAU,EACR,uGAAuG;IACzG,KAAK,EAAE,2EAA2E;IAClF,eAAe,EAAE,+DAA+D;CACjF,CAAC;AAEF,MAAM,aAAa,GAA2B;IAC5C,OAAO,EAAE,sFAAsF;IAC/F,SAAS,EAAE,sEAAsE;IACjF,YAAY,EAAE,2EAA2E;IACzF,SAAS,EACP,kGAAkG;IACpG,KAAK,EACH,yHAAyH;IAC3H,MAAM,EAAE,+BAA+B;IACvC,QAAQ,EAAE,iCAAiC;IAC3C,SAAS,EAAE,kCAAkC;CAC9C,CAAC;AAEF,uDAAuD;AACvD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/services/brapi-client/brapi-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Low-level HTTP client for BrAPI v2 servers. Handles URL
+ * construction, header assembly, JSON envelope parsing, retry with exponential
+ * backoff, and the async-search poll loop
+ * (`POST /search/{noun}` → `searchResultsDbId` → `GET /search/{noun}/{id}`).
+ * Stateless across connections — callers pass `baseUrl` and resolved auth per
+ * call; connection state is owned by `ServerRegistry` (added in a later phase).
+ *
+ * @module services/brapi-client/brapi-client
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { FetchWithTimeoutOptions } from '@cyanheads/mcp-ts-core/utils';
+import type { ServerConfig } from '../../config/server-config.js';
+import type { BinaryResponse, BrapiEnvelope, BrapiRequestOptions, SearchResponse } from './types.js';
+/**
+ * Signature of the underlying HTTP fetcher. Accepts the handler `Context`
+ * directly so callers (and tests) don't have to cast; the default
+ * implementation adapts to `fetchWithTimeout`.
+ */
+export type Fetcher = (url: string | URL, timeoutMs: number, context: Context, options?: FetchWithTimeoutOptions) => Promise<Response>;
+export declare class BrapiClient {
+    private readonly serverConfig;
+    private readonly fetcher;
+    constructor(serverConfig: ServerConfig, fetcher?: Fetcher);
+    /** GET /{path} with optional query params and auth. */
+    get<T>(baseUrl: string, path: string, ctx: Context, options?: BrapiRequestOptions): Promise<BrapiEnvelope<T>>;
+    /**
+     * GET /{path} returning raw bytes — used for image content and other binary
+     * payloads. Honors the same retry policy as `get()`. The `accept` option
+     * overrides the default `image/*`.
+     */
+    getBinary(baseUrl: string, path: string, ctx: Context, options?: BrapiRequestOptions & {
+        accept?: string;
+    }): Promise<BinaryResponse>;
+    /**
+     * Fetch binary bytes from an arbitrary URL — used as a fallback when a
+     * BrAPI server doesn't expose `/images/{id}/imagecontent` but the image's
+     * metadata carries an `imageURL` (CDN, S3, etc.). No auth is attached; the
+     * assumption is that these URLs are publicly reachable. Still honors the
+     * private-IP guard and request timeout.
+     */
+    fetchBinaryUrl(url: string, ctx: Context, accept?: string): Promise<BinaryResponse>;
+    /**
+     * POST /search/{noun}. Returns a discriminated union — `sync` when the
+     * server returns full results inline, `async` when it returns a
+     * `searchResultsDbId` the caller must poll via `getSearchResults`.
+     */
+    postSearch<T>(baseUrl: string, noun: string, body: Record<string, unknown>, ctx: Context, options?: BrapiRequestOptions): Promise<SearchResponse<T>>;
+    /**
+     * POST /{path} with a JSON body. Used for write endpoints (e.g. creating
+     * observations). Same retry + classification policy as `get()`. The body is
+     * serialized as JSON and `Content-Type: application/json` is forced.
+     */
+    post<T>(baseUrl: string, path: string, body: unknown, ctx: Context, options?: BrapiRequestOptions): Promise<BrapiEnvelope<T>>;
+    /**
+     * PUT /{path} with a JSON body. Used for upsert / update endpoints. BrAPI
+     * routes update calls (`PUT /observations`, `PUT /germplasm`) through this.
+     */
+    put<T>(baseUrl: string, path: string, body: unknown, ctx: Context, options?: BrapiRequestOptions): Promise<BrapiEnvelope<T>>;
+    private sendJson;
+    /**
+     * Poll `GET /search/{noun}/{searchResultsDbId}`. Returns the envelope once
+     * the server replies with 200. 202 means "still processing" — the method
+     * sleeps `searchPollIntervalMs` and retries until `searchPollTimeoutMs`.
+     */
+    getSearchResults<T>(baseUrl: string, noun: string, searchResultsDbId: string, ctx: Context, options?: BrapiRequestOptions): Promise<BrapiEnvelope<T>>;
+    private doFetch;
+    private buildUrl;
+    private buildHeaders;
+    private parseEnvelope;
+}
+export declare function initBrapiClient(serverConfig: ServerConfig, fetcher?: Fetcher): void;
+export declare function getBrapiClient(): BrapiClient;
+/** Test-only — clears the singleton so successive suites start clean. */
+export declare function resetBrapiClient(): void;
+//# sourceMappingURL=brapi-client.d.ts.map

package/dist/services/brapi-client/brapi-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brapi-client.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-client/brapi-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAYtD,OAAO,KAAK,EAAE,uBAAuB,EAAkB,MAAM,8BAA8B,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EAEnB,cAAc,EACf,MAAM,YAAY,CAAC;AAWpB;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC;AAKvB,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,OAAwB;IAGpD,uDAAuD;IACvD,GAAG,CAAC,CAAC,EACH,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAqB5B;;;;OAIG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,mBAAmB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,OAAO,CAAC,cAAc,CAAC;IAyB1B;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,SAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAY5F;;;;OAIG;IACH,UAAU,CAAC,CAAC,EACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAiC7B;;;;OAIG;IACH,IAAI,CAAC,CAAC,EACJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAI5B;;;OAGG;IACH,GAAG,CAAC,CAAC,EACH,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAI5B,OAAO,CAAC,QAAQ;IAmChB;;;;OAIG;IACG,gBAAgB,CAAC,CAAC,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM,EACzB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAmCd,OAAO;IAkBrB,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,YAAY;YAQN,aAAa;CAyB5B;AA2ED,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAEnF;AAED,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}