@cliwant/mcp-sam-gov 0.2.1

package/README.md

@@ -0,0 +1,397 @@
+# @cliwant/mcp-sam-gov
+
+> **The most comprehensive keyless federal-data MCP server.**
+> 36 tools for SAM.gov + USAspending + Federal Register + eCFR + Grants.gov.
+> No API key, no registration, no signup. Works in Claude Desktop, Claude Code,
+> Codex CLI, Cursor, Continue, Gemini CLI, and any MCP-aware host.
+
+[한국어 README](./README.ko.md) · [日本語 README](./README.ja.md)
+
+---
+
+## What this gives Claude (and other AI agents)
+
+| Domain | What you can ask | Tools |
+|---|---|---|
+| 🔍 **Active opportunities** | "Find SAM.gov solicitations under NAICS 541512 closing this month" | 5 SAM.gov tools |
+| 💰 **Awards & recipients** | "Show me Booz Allen wins at VA last fiscal year" | 8 USAspending tools |
+| 📊 **Aggregate analysis** | "Top 10 PSC categories at DoD by spending FY26" | 6 USAspending tools |
+| 🏛 **Agency profiles** | "What's VA's mission? FY25 budget breakdown?" | 3 USAspending tools |
+| 🏢 **Recipient profiles** | "Pull Booz Allen's full recipient profile + alternate names" | 2 USAspending tools |
+| 🧠 **Anti-hallucination** | NAICS / recipient / agency autocomplete + glossary | 5 USAspending tools |
+| 📜 **Federal Register** | "What VA cybersecurity rules were published this quarter?" | 3 tools |
+| ⚖️ **Regulations (FAR/CFR)** | "Find FAR sections about SDVOSB set-aside" | 2 eCFR tools |
+| 🎓 **Federal grants** | "Cybersecurity grants posted in the last 30 days" | 2 Grants.gov tools |
+
+**36 tools total. Zero API keys. p50 latency 257ms, p95 766ms** (live benchmarks against federal APIs).
+
+---
+
+## How do I install it? Pick the path that matches you.
+
+### 🟢 Path 1 — Claude Desktop, one-click (no terminal needed)
+
+Best for non-developers. Just download a file and double-click.
+
+1. Download **`mcp-sam-gov.mcpb`** from the [latest release](https://github.com/cliwant/mcp-sam-gov/releases/latest).
+2. Double-click the file. Claude Desktop opens with an "Install Extension" dialog.
+3. Click **Install**.
+4. Done. Start a new conversation and ask "Find active SAM.gov opportunities under NAICS 541512".
+
+That's it. No PowerShell, no `npm`, nothing.
+
+> Requires Claude Desktop ≥ 1.0 (which ships its own Node.js runtime).
+
+### 🟡 Path 2 — Claude Code, one command
+
+If you already use Claude Code (the CLI):
+
+```bash
+/plugin install cliwant/mcp-sam-gov
+```
+
+This installs the MCP server **plus** a [SKILL.md](./skills/sam-gov/SKILL.md) workflow guide that teaches Claude when + how to use each of the 36 tools.
+
+### 🔵 Path 3 — Manual install for any MCP host (Codex, Cursor, Continue, Gemini)
+
+For Codex CLI / Cursor / Continue / Gemini CLI / anything that speaks MCP:
+
+```bash
+gh repo clone cliwant/mcp-sam-gov
+cd mcp-sam-gov
+npm install --omit=dev
+npm install -g .
+```
+
+After install, the binary `mcp-sam-gov` is on your PATH. Add this to your host config:
+
+```json
+{
+  "mcpServers": {
+    "sam-gov": {
+      "command": "mcp-sam-gov"
+    }
+  }
+}
+```
+
+Specific config locations per host: see [Host configurations](#host-configurations) below.
+
+### ⚪ Path 4 — Direct path (zero install, just point at the file)
+
+Skip installation entirely:
+
+```bash
+gh repo clone cliwant/mcp-sam-gov
+cd mcp-sam-gov
+npm install --omit=dev   # only runtime deps; dist/ is pre-built
+```
+
+Then point your host config at the absolute path:
+
+```jsonc
+{
+  "mcpServers": {
+    "sam-gov": {
+      "command": "node",
+      "args": ["C:\\Users\\you\\mcp-sam-gov\\dist\\server.js"]
+    }
+  }
+}
+```
+
+---
+
+## Host configurations
+
+### Claude Desktop
+
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "sam-gov": { "command": "mcp-sam-gov" }
+  }
+}
+```
+
+(Or skip this entirely — use Path 1's `.mcpb` and it auto-configures.)
+
+Restart Claude Desktop fully (system tray quit on Windows / Quit menu on macOS), then look for the 🔨 icon. You should see "sam-gov (36 tools)".
+
+### Claude Code
+
+Per-project `.mcp.json`:
+
+```json
+{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }
+```
+
+Or globally:
+
+```bash
+claude mcp add sam-gov mcp-sam-gov
+```
+
+### Codex CLI
+
+`~/.codex/config.toml`:
+
+```toml
+[mcp_servers.sam-gov]
+command = "mcp-sam-gov"
+args = []
+```
+
+### Cursor
+
+Settings → MCP → Add new MCP server:
+
+```json
+{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }
+```
+
+### Continue
+
+`~/.continue/config.json`:
+
+```json
+{
+  "experimental": {
+    "modelContextProtocolServer": {
+      "transport": { "type": "stdio", "command": "mcp-sam-gov" }
+    }
+  }
+}
+```
+
+### Gemini CLI
+
+`~/.gemini/settings.json`:
+
+```json
+{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }
+```
+
+### Anything else
+
+If your host speaks MCP over stdio, point it at `mcp-sam-gov`. No host-specific code.
+
+---
+
+## What questions can I ask?
+
+Once installed, you can ask in natural language. The agent picks the right tool sequence automatically.
+
+### Discovery
+- "NAICS 541512 의 메릴랜드 입찰 중 30일 안에 마감되는 것 찾아줘"
+- "Find active SAM.gov solicitations under NAICS 541512, MD only, closing in 30 days"
+- "What's the canonical NAICS code for 'computer systems design'?"
+
+### RFP analysis
+- "Pull noticeId 5ef3db5daeb54099a96d487783a38bd0 — give me the SOW, contracting officer, and attachments"
+- "Show me the full RFP body for that notice"
+
+### Competitive landscape
+- "Top 5 recipients of VA contracts in NAICS 541519 last fiscal year"
+- "Show me Booz Allen's individual awards at DISA"
+- "Who are the sub-contractors on Leidos' VA contracts?"
+- "What's CMS in USAspending? (resolve the abbreviation)"
+
+### Trends & aggregation
+- "How has VA 541512 spending trended over the last 5 fiscal years?"
+- "Top 10 states by federal contracting spend in 541512"
+- "Top PSC categories at DoD by spending"
+- "Federal grant programs in cybersecurity by total $"
+
+### Agency intelligence (capture brief)
+- "Give me a capture brief on VA: mission, FY26 budget breakdown, top sub-agencies"
+- "What's VA's transaction volume for FY25?"
+
+### Recompete radar
+- "VA 541512 contracts expiring in next 12 months over $1M"
+- "Pull period of performance for award CONT_AWD_..."
+
+### Regulatory
+- "Find FAR sections about SDVOSB set-aside requirements"
+- "What new VA cybersecurity rules were published this quarter?"
+- "Is there a Federal Register doc number 2026-08333? Pull the citation."
+
+### Grants
+- "Cybersecurity grants posted in the last 30 days"
+- "Pull grant id 361238"
+
+---
+
+## Optional — higher rate limits + archives
+
+The MCP server runs **keyless** by default. For higher SAM.gov rate limits + the full archive (notices older than ~12 months), set `SAM_GOV_API_KEY` in your host's env block:
+
+```json
+{
+  "mcpServers": {
+    "sam-gov": {
+      "command": "mcp-sam-gov",
+      "env": { "SAM_GOV_API_KEY": "your-key-here" }
+    }
+  }
+}
+```
+
+Get a free key at [sam.gov/SAM/pages/public/searchKeyData.jsf](https://sam.gov/SAM/pages/public/searchKeyData.jsf). The agent doesn't need to know — the key path is transparent.
+
+---
+
+## Tool catalog (36 tools)
+
+<details>
+<summary><b>SAM.gov — opportunities + attachments (5 tools)</b></summary>
+
+- `sam_search_opportunities` — keyless HAL search (~47K active)
+- `sam_get_opportunity` — full detail by 32-char hex noticeId (POCs + attachments + body)
+- `sam_fetch_description` — full RFP body as plain text
+- `sam_attachment_url` — public download URL for resourceId
+- `sam_lookup_organization` — federal-organization id → fullParentPathName
+</details>
+
+<details>
+<summary><b>USAspending — awards + recipients (8 tools)</b></summary>
+
+- `usas_search_awards` — share-of-wallet at agency × NAICS
+- `usas_search_individual_awards` — line items (returns generatedInternalId)
+- `usas_search_subagency_spending` — buyer-office breakdown
+- `usas_lookup_agency` — abbreviation → canonical name
+- `usas_search_awards_by_recipient` — recipient win history
+- `usas_search_subawards` — supply-chain / teaming
+- `usas_search_expiring_contracts` — recompete radar
+- `usas_get_award_detail` — period of performance, options, set-aside, competition
+</details>
+
+<details>
+<summary><b>USAspending — aggregate analysis (6 tools)</b></summary>
+
+- `usas_spending_over_time` — fiscal_year / quarter / month time series
+- `usas_search_psc_spending` — PSC market structure
+- `usas_search_state_spending` — geographic distribution
+- `usas_search_cfda_spending` — grant programs
+- `usas_search_federal_account_spending` — Treasury Account Symbols (TAS)
+- `usas_search_agency_spending` — top buying agencies for NAICS / set-aside
+</details>
+
+<details>
+<summary><b>USAspending — agency profile (3 tools)</b></summary>
+
+- `usas_get_agency_profile` — mission, abbreviation, website
+- `usas_get_agency_awards_summary` — transaction count + obligations
+- `usas_get_agency_budget_function` — budget breakdown by program area
+</details>
+
+<details>
+<summary><b>USAspending — recipient profile (2 tools)</b></summary>
+
+- `usas_search_recipients` — list with parent/child hierarchy
+- `usas_get_recipient_profile` — full detail (DUNS, UEI, alternate names, totals)
+</details>
+
+<details>
+<summary><b>USAspending — reference / autocomplete (5 tools)</b></summary>
+
+- `usas_autocomplete_naics` — anti-hallucination NAICS guard
+- `usas_autocomplete_recipient` — anti-hallucination recipient guard
+- `usas_naics_hierarchy` — navigate NAICS tree
+- `usas_glossary` — 151 federal-spending terms
+- `usas_list_toptier_agencies` — list all toptier agencies + obligations
+</details>
+
+<details>
+<summary><b>Federal Register — rules + notices (3 tools)</b></summary>
+
+- `fed_register_search_documents` — search by query / agency / type / date
+- `fed_register_get_document` — citation, body URL, CFR refs
+- `fed_register_list_agencies` — agency slugs reference
+</details>
+
+<details>
+<summary><b>eCFR — Code of Federal Regulations (2 tools)</b></summary>
+
+- `ecfr_search` — full-text search (titleNumber=48 for FAR)
+- `ecfr_list_titles` — all 50 CFR titles + last-amended dates
+</details>
+
+<details>
+<summary><b>Grants.gov — federal grants (2 tools)</b></summary>
+
+- `grants_search` — opportunity search
+- `grants_get_opportunity` — full grant detail
+</details>
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| Claude Desktop 🔨 menu doesn't show `sam-gov` | Fully quit Claude Desktop (system tray on Windows / Quit menu on macOS) and reopen. Check `%APPDATA%\Claude\logs\mcp*.log` |
+| `command not found: mcp-sam-gov` | Confirm `npm install -g .` succeeded; check that npm's global bin is on PATH (`npm config get prefix`) |
+| `MODULE_NOT_FOUND ...dist/server.js` after `npm install -g github:...` | npm bug with git-dep symlinks on Windows. Use the clone + `npm install -g .` recipe (Path 3) instead. |
+| `EPERM: operation not permitted, rmdir` during install | Previous failed install left dangling files. Run `rmdir /s /q "%APPDATA%\npm\node_modules\@cliwant"` (or `@govicon` if you installed an early version) then retry. |
+| `npm install` fails with "private repo" / 404 | The repo is now public — should not happen. If it does, try `git clone https://github.com/cliwant/mcp-sam-gov.git` directly. |
+| Tools return empty results | SAM.gov rate-limits aggressive callers. Wait 1 minute. Or set `SAM_GOV_API_KEY` for the higher-rate authenticated path. |
+| "Tool error: USAspending POST returned 400" | Usually means a field has a wrong type (e.g. fiscal year as string). Check the tool input schema in your host's tool browser. |
+
+---
+
+## Use as a TypeScript / JavaScript library (no MCP)
+
+Beyond the MCP server, this package also exports the underlying federal-data
+clients as importable modules. Useful if you're building your own SaaS, AI
+agent, or CLI and want programmatic access without spawning an MCP server.
+
+```bash
+npm install @cliwant/mcp-sam-gov
+```
+
+```ts
+// SAM.gov client
+import { SamGovClient } from "@cliwant/mcp-sam-gov/sam-gov";
+
+const sam = new SamGovClient(); // keyless
+const result = await sam.searchOpportunities({ ncode: "541512", limit: 5 });
+const opp = await sam.getOpportunity("5ef3db5daeb54099a96d487783a38bd0");
+```
+
+```ts
+// USAspending wrappers (22 functions)
+import * as usas from "@cliwant/mcp-sam-gov/usaspending";
+
+const recompete = await usas.searchExpiringContracts({
+  agency: "Department of Veterans Affairs",
+  naics: "541512",
+  monthsUntilExpiry: 12,
+});
+const recipient = await usas.getRecipientProfile("ed02855e-60d7-2540-...-P");
+```
+
+```ts
+// Federal Register / eCFR / Grants.gov
+import * as fedreg from "@cliwant/mcp-sam-gov/federal-register";
+import * as ecfr from "@cliwant/mcp-sam-gov/ecfr";
+import * as grants from "@cliwant/mcp-sam-gov/grants";
+
+const farResults = await ecfr.search({ query: "SDVOSB", titleNumber: 48 });
+```
+
+This is the canonical home for the Cliwant federal-data libraries — there
+is no separate library package. Two earlier repos (`govicon-sam-gov` and
+`govicon-mcp-sam-gov`) have been archived and consolidated here. All
+client code lives in `src/sam-gov/`, `src/usaspending.ts`,
+`src/federal-register.ts`, `src/ecfr.ts`, `src/grants.ts`.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+## Disclaimer
+
+This server uses **publicly available** federal API endpoints. It is not affiliated with the General Services Administration, SAM.gov, USAspending.gov, the Office of the Federal Register, the National Archives, Grants.gov, or any federal agency. Federal procurement, spending, and regulation data is in the public domain.

package/dist/ecfr.d.ts

@@ -0,0 +1,44 @@
+/**
+ * eCFR (Electronic Code of Federal Regulations) wrappers (keyless).
+ *
+ * eCFR is the up-to-date version of the CFR — Title 48 = FAR (Federal
+ * Acquisition Regulation), Title 2 = Federal financial assistance, etc.
+ * For a federal contractor, eCFR is the primary source for regulation
+ * text the agent should quote when answering compliance questions.
+ *
+ * Endpoints:
+ *   - /versioner/v1/titles.json — list 50 CFR titles + last-amended dates
+ *   - /search/v1/results — full-text search across the entire CFR
+ *
+ * Both keyless. Documented at https://www.ecfr.gov/developers/.
+ */
+export declare function listTitles(): Promise<{
+    titles: {
+        number: number;
+        name: string;
+        latestAmendedOn: string | undefined;
+        latestIssueDate: string | undefined;
+        upToDateAsOf: string | undefined;
+        reserved: boolean;
+    }[];
+}>;
+export declare function search(args: {
+    query: string;
+    titleNumber?: number;
+    perPage?: number;
+}): Promise<{
+    results: {
+        type: string;
+        title: string;
+        chapter: string | undefined;
+        part: string | undefined;
+        subpart: string | undefined;
+        section: string | undefined;
+        headingPath: string;
+        excerpt: string;
+        score: number;
+        ecfrUrl: string;
+        effectiveOn: string;
+    }[];
+}>;
+//# sourceMappingURL=ecfr.d.ts.map

package/dist/ecfr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecfr.d.ts","sourceRoot":"","sources":["../src/ecfr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,wBAAsB,UAAU;;;;;;;;;GAsB/B;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;;;;;;;;;;;;;GAkDA"}

package/dist/ecfr.js

@@ -0,0 +1,86 @@
+/**
+ * eCFR (Electronic Code of Federal Regulations) wrappers (keyless).
+ *
+ * eCFR is the up-to-date version of the CFR — Title 48 = FAR (Federal
+ * Acquisition Regulation), Title 2 = Federal financial assistance, etc.
+ * For a federal contractor, eCFR is the primary source for regulation
+ * text the agent should quote when answering compliance questions.
+ *
+ * Endpoints:
+ *   - /versioner/v1/titles.json — list 50 CFR titles + last-amended dates
+ *   - /search/v1/results — full-text search across the entire CFR
+ *
+ * Both keyless. Documented at https://www.ecfr.gov/developers/.
+ */
+const ECFR = "https://www.ecfr.gov/api";
+async function fetchJson(url) {
+    const r = await fetch(url, {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!r.ok) {
+        throw new Error(`eCFR ${url} returned ${r.status}`);
+    }
+    return (await r.json());
+}
+export async function listTitles() {
+    const json = await fetchJson(`${ECFR}/versioner/v1/titles.json`);
+    return {
+        titles: (json.titles ?? []).map((t) => ({
+            number: t.number ?? 0,
+            name: t.name ?? "",
+            latestAmendedOn: t.latest_amended_on,
+            latestIssueDate: t.latest_issue_date,
+            upToDateAsOf: t.up_to_date_as_of,
+            reserved: !!t.reserved,
+        })),
+    };
+}
+export async function search(args) {
+    const url = new URL(`${ECFR}/search/v1/results`);
+    url.searchParams.set("query", args.query);
+    url.searchParams.set("per_page", String(args.perPage ?? 5));
+    if (args.titleNumber) {
+        // eCFR search filter: hierarchy[title]=N (NOT just title=N — that's
+        // an "unpermitted parameter" error from the eCFR API).
+        url.searchParams.set("hierarchy[title]", String(args.titleNumber));
+    }
+    const json = await fetchJson(url.toString());
+    return {
+        results: (json.results ?? []).map((r) => ({
+            type: r.type ?? "",
+            title: r.hierarchy?.title ?? "",
+            chapter: r.hierarchy?.chapter,
+            part: r.hierarchy?.part,
+            subpart: r.hierarchy?.subpart,
+            section: r.hierarchy?.section,
+            headingPath: Object.values(r.hierarchy_headings ?? {})
+                .filter(Boolean)
+                .join(" › "),
+            excerpt: stripHtml(r.full_text_excerpt ?? ""),
+            score: r.score ?? 0,
+            // Stable ecfr.gov URL pattern from the hierarchy
+            ecfrUrl: r.hierarchy
+                ? buildEcfrUrl(r.hierarchy)
+                : "",
+            effectiveOn: r.starts_on ?? "",
+        })),
+    };
+}
+function stripHtml(s) {
+    return s
+        .replace(/<[^>]+>/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function buildEcfrUrl(h) {
+    const base = `https://www.ecfr.gov/current/title-${h.title}`;
+    if (h.section)
+        return `${base}/section-${h.section}`;
+    if (h.part)
+        return `${base}/part-${h.part}`;
+    if (h.chapter)
+        return `${base}/chapter-${h.chapter}`;
+    return base;
+}
+//# sourceMappingURL=ecfr.js.map

package/dist/ecfr.js.map

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

package/dist/federal-register.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Federal Register API v1 wrappers (keyless, no registration).
+ *
+ * Federal Register is the daily journal of the US federal government —
+ * proposed rules, final rules, presidential documents, public notices.
+ * Critical context for any federal contracting question that touches
+ * regulation, set-aside policy, or new acquisition guidance.
+ *
+ * Endpoints:
+ *   - documents.json — search across documents (filters: agencies,
+ *     conditions, type, date range)
+ *   - documents/{number}.json — single document detail (full body URL,
+ *     abstract, citation, effective date)
+ *   - agencies.json — agency reference list
+ *
+ * All endpoints are public + keyless (no API key, no registration).
+ * Rate-limit: documented as ~1000 req/hour per IP (informal).
+ */
+export type FedRegDocumentType = "RULE" | "PRORULE" | "NOTICE" | "PRESDOCU" | "UNKNOWN";
+export declare function searchDocuments(args: {
+    query?: string;
+    agencySlugs?: string[];
+    type?: "RULE" | "PRORULE" | "NOTICE" | "PRESDOCU";
+    publicationDateFrom?: string;
+    publicationDateTo?: string;
+    effectiveDateFrom?: string;
+    perPage?: number;
+}): Promise<{
+    totalRecords: number;
+    totalPages: number;
+    documents: {
+        documentNumber: string;
+        title: string;
+        type: FedRegDocumentType;
+        typeDisplay: string;
+        abstract: string;
+        htmlUrl: string;
+        pdfUrl: string | undefined;
+        publicationDate: string;
+        effectiveDate: string | undefined;
+        agencies: {
+            name: string;
+            slug: string;
+        }[];
+    }[];
+}>;
+export declare function getDocument(documentNumber: string): Promise<{
+    documentNumber: string;
+    title: string;
+    type: FedRegDocumentType;
+    typeDisplay: string;
+    abstract: string;
+    htmlUrl: string;
+    pdfUrl: string | undefined;
+    rawTextUrl: string | undefined;
+    publicationDate: string;
+    effectiveDate: string | undefined;
+    citation: string | undefined;
+    pageCount: number | undefined;
+    agencies: {
+        name: string;
+        slug: string;
+    }[];
+    cfrReferences: {
+        title: string;
+        part: string | undefined;
+        chapter: string | undefined;
+    }[];
+}>;
+export declare function listAgencies(args: {
+    perPage?: number;
+}): Promise<{
+    agencies: {
+        id: number;
+        name: string;
+        shortName: string | undefined;
+        slug: string;
+        description: string;
+        parentId: number | null | undefined;
+    }[];
+}>;
+//# sourceMappingURL=federal-register.d.ts.map

package/dist/federal-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federal-register.d.ts","sourceRoot":"","sources":["../src/federal-register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AASd,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAClD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;;;;;;;;;;;;;;;;;GAkEA;AAED,wBAAsB,WAAW,CAAC,cAAc,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;GA2CvD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;GAuB5D"}