chia-explorer 0.1.6 → 0.2.1

package/dist/chips/parser.js

@@ -0,0 +1,208 @@
+const KEY_MAP = {
+    'chip number': 'number',
+    'chip-number': 'number',
+    number: 'number',
+    title: 'title',
+    description: 'description',
+    author: 'authors',
+    authors: 'authors',
+    editor: 'editors',
+    editors: 'editors',
+    'comments-uri': 'comments_uri',
+    comments_uri: 'comments_uri',
+    status: 'status',
+    category: 'category',
+    'sub-category': 'sub_category',
+    sub_category: 'sub_category',
+    type: 'type',
+    created: 'created',
+    updated: 'updated',
+    requires: 'requires',
+    replaces: 'replaces',
+    'superseded-by': 'superseded_by',
+    superseded_by: 'superseded_by',
+};
+function stripTablePipes(line) {
+    let s = line.trim();
+    if (s.startsWith('|'))
+        s = s.slice(1);
+    if (s.endsWith('|'))
+        s = s.slice(0, -1);
+    return s;
+}
+function isSeparatorRow(cells) {
+    if (cells.length === 0)
+        return false;
+    return cells.every((c) => /^:?-+:?$/.test(c.trim()));
+}
+function isBlankOrNone(value) {
+    const v = value.trim().toLowerCase();
+    return v === '' || v === 'none' || v === '-' || v === 'n/a';
+}
+export function parseAuthors(raw) {
+    const trimmed = raw.trim();
+    if (isBlankOrNone(trimmed))
+        return [];
+    const out = [];
+    const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+    const seen = [];
+    let match;
+    while ((match = linkPattern.exec(trimmed)) !== null) {
+        out.push({ name: match[1].trim(), url: match[2].trim() });
+        seen.push({ start: match.index, end: match.index + match[0].length });
+    }
+    if (out.length > 0)
+        return out;
+    for (const part of trimmed.split(',')) {
+        const name = part.trim();
+        if (name)
+            out.push({ name, url: null });
+    }
+    return out;
+}
+function parseChipNumber(raw) {
+    const m = raw.trim().match(/^\d+/);
+    if (!m)
+        return null;
+    const n = Number(m[0]);
+    return Number.isFinite(n) ? n : null;
+}
+function assignField(fm, field, value) {
+    switch (field) {
+        case 'number':
+            fm.number = parseChipNumber(value);
+            return;
+        case 'authors':
+            fm.authors = parseAuthors(value);
+            return;
+        case 'editors':
+            fm.editors = parseAuthors(value);
+            return;
+        case 'extra':
+            return;
+    }
+    const normalized = isBlankOrNone(value) ? null : value;
+    switch (field) {
+        case 'title':
+            fm.title = normalized;
+            return;
+        case 'description':
+            fm.description = normalized;
+            return;
+        case 'comments_uri':
+            fm.comments_uri = normalized;
+            return;
+        case 'status':
+            fm.status = normalized;
+            return;
+        case 'category':
+            fm.category = normalized;
+            return;
+        case 'sub_category':
+            fm.sub_category = normalized;
+            return;
+        case 'type':
+            fm.type = normalized;
+            return;
+        case 'created':
+            fm.created = normalized;
+            return;
+        case 'updated':
+            fm.updated = normalized;
+            return;
+        case 'requires':
+            fm.requires = normalized;
+            return;
+        case 'replaces':
+            fm.replaces = normalized;
+            return;
+        case 'superseded_by':
+            fm.superseded_by = normalized;
+            return;
+    }
+}
+function emptyFrontMatter() {
+    return {
+        number: null,
+        title: null,
+        description: null,
+        authors: [],
+        editors: [],
+        comments_uri: null,
+        status: null,
+        category: null,
+        sub_category: null,
+        type: null,
+        created: null,
+        updated: null,
+        requires: null,
+        replaces: null,
+        superseded_by: null,
+        extra: {},
+    };
+}
+export function parseChipFrontMatter(markdown) {
+    const fm = emptyFrontMatter();
+    const lines = markdown.split(/\r?\n/);
+    for (const raw of lines) {
+        if (/^##\s/.test(raw))
+            break;
+        if (/^#\s/.test(raw))
+            continue;
+        const trimmed = raw.trim();
+        if (!trimmed)
+            continue;
+        if (!trimmed.includes('|'))
+            continue;
+        const cells = stripTablePipes(trimmed)
+            .split('|')
+            .map((c) => c.trim());
+        if (cells.length < 2)
+            continue;
+        if (isSeparatorRow(cells))
+            continue;
+        const key = cells[0].toLowerCase();
+        const value = cells.slice(1).join('|').trim();
+        const mapped = KEY_MAP[key];
+        if (!mapped) {
+            if (key)
+                fm.extra[key] = value;
+            continue;
+        }
+        assignField(fm, mapped, value);
+    }
+    return fm;
+}
+export function extractAbstract(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        if (/^##\s+abstract\s*$/i.test(lines[i].trim()))
+            break;
+        i++;
+    }
+    if (i >= lines.length)
+        return null;
+    i++;
+    const buf = [];
+    while (i < lines.length) {
+        const line = lines[i];
+        if (/^#{1,6}\s/.test(line.trim()))
+            break;
+        buf.push(line);
+        i++;
+    }
+    const text = buf.join('\n').trim();
+    return text || null;
+}
+export function buildChipFileName(number) {
+    return `chip-${String(number).padStart(4, '0')}.md`;
+}
+const CHIP_FILE_PATTERN = /CHIPs\/chip-(\d{1,5})\.md$/i;
+export function extractChipPathInfo(path) {
+    const m = CHIP_FILE_PATTERN.exec(path);
+    if (!m)
+        return null;
+    return { number: Number(m[1]), filename: path };
+}
+//# sourceMappingURL=parser.js.map

package/dist/chips/parser.js.map

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

package/dist/chips/readme-index.d.ts

@@ -0,0 +1,12 @@
+export type ChipReadmeEntryKind = 'file' | 'pr' | 'external';
+export interface ChipReadmeEntry {
+    number: number | null;
+    title: string;
+    status: string;
+    url: string;
+    kind: ChipReadmeEntryKind;
+    filename: string | null;
+    prNumber: number | null;
+}
+export declare function parseChipReadmeIndex(markdown: string): ChipReadmeEntry[];
+export declare function getChipReadmeIndex(): Promise<ChipReadmeEntry[]>;

package/dist/chips/readme-index.js

@@ -0,0 +1,82 @@
+import { fetchRawFile } from '../github/client.js';
+import { getCached } from '../github/cache.js';
+const REPO = 'Chia-Network/chips';
+const DEFAULT_REF = 'main';
+const README_PATH = 'README.md';
+const README_TTL_MS = 5 * 60_000;
+const BULLET_PATTERN = /^\*\s+\[(.+?)\]\((.+?)\)/;
+const FILE_LINK_PATTERN = /^\/?CHIPs\/(chip-\d{1,5}\.md)$/i;
+const PR_LINK_PATTERN = /^https?:\/\/github\.com\/Chia-Network\/chips\/pull\/(\d+)\/?$/i;
+function parseLabel(label) {
+    const m = label.match(/^\s*(\d+)\s*[-–—:]\s*(.+?)\s*$/);
+    if (m) {
+        return { number: Number(m[1]), title: m[2].trim() };
+    }
+    return { number: null, title: label.trim() };
+}
+function classify(url) {
+    const fileMatch = url.match(FILE_LINK_PATTERN);
+    if (fileMatch) {
+        const filename = `CHIPs/${fileMatch[1]}`;
+        return {
+            kind: 'file',
+            filename,
+            prNumber: null,
+            absoluteUrl: `https://github.com/${REPO}/blob/${DEFAULT_REF}/${filename}`,
+        };
+    }
+    const prMatch = url.match(PR_LINK_PATTERN);
+    if (prMatch) {
+        return {
+            kind: 'pr',
+            filename: null,
+            prNumber: Number(prMatch[1]),
+            absoluteUrl: url,
+        };
+    }
+    return { kind: 'external', filename: null, prNumber: null, absoluteUrl: url };
+}
+export function parseChipReadmeIndex(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    const entries = [];
+    let currentStatus = null;
+    for (const raw of lines) {
+        const line = raw.trim();
+        const heading = line.match(/^###\s+(.+?)\s*$/);
+        if (heading) {
+            currentStatus = heading[1].trim();
+            continue;
+        }
+        if (line.startsWith('## ')) {
+            currentStatus = null;
+            continue;
+        }
+        if (!currentStatus)
+            continue;
+        const bullet = line.match(BULLET_PATTERN);
+        if (!bullet)
+            continue;
+        const [, label, url] = bullet;
+        if (!label || !url)
+            continue;
+        const { number, title } = parseLabel(label);
+        const { kind, filename, prNumber, absoluteUrl } = classify(url);
+        entries.push({
+            number,
+            title,
+            status: currentStatus,
+            url: absoluteUrl,
+            kind,
+            filename,
+            prNumber,
+        });
+    }
+    return entries;
+}
+export async function getChipReadmeIndex() {
+    return getCached(`chips:readme:${DEFAULT_REF}`, async () => {
+        const body = await fetchRawFile(REPO, DEFAULT_REF, README_PATH);
+        return parseChipReadmeIndex(body);
+    }, README_TTL_MS);
+}
+//# sourceMappingURL=readme-index.js.map

package/dist/chips/readme-index.js.map

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

package/dist/github/cache.d.ts

@@ -0,0 +1,3 @@
+export declare function getCached<T>(key: string, loader: () => Promise<T>, ttlMs?: number): Promise<T>;
+export declare function invalidate(key: string): void;
+export declare function resetCache(): void;

package/dist/github/cache.js

@@ -0,0 +1,18 @@
+const DEFAULT_TTL_MS = 5 * 60_000;
+const cache = new Map();
+export async function getCached(key, loader, ttlMs = DEFAULT_TTL_MS) {
+    const now = Date.now();
+    const entry = cache.get(key);
+    if (entry && entry.expiresAt > now)
+        return entry.value;
+    const value = await loader();
+    cache.set(key, { value, expiresAt: now + ttlMs });
+    return value;
+}
+export function invalidate(key) {
+    cache.delete(key);
+}
+export function resetCache() {
+    cache.clear();
+}
+//# sourceMappingURL=cache.js.map

package/dist/github/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/github/cache.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AAOlC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,MAAwB,EACxB,QAAgB,cAAc;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAyB,CAAC;IACrD,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/github/client.d.ts

@@ -0,0 +1,5 @@
+export declare function githubApi<T>(path: string): Promise<T>;
+export declare function fetchRawFile(repo: string, ref: string, path: string): Promise<string>;
+export declare class FileNotFoundError extends Error {
+    constructor(message: string);
+}

package/dist/github/client.js

@@ -0,0 +1,68 @@
+const GITHUB_API_BASE = 'https://api.github.com';
+const RAW_BASE = 'https://raw.githubusercontent.com';
+const REQUEST_TIMEOUT_MS = 10_000;
+const USER_AGENT = 'chia-explorer-mcp';
+function authHeaders() {
+    const headers = {
+        accept: 'application/vnd.github+json',
+        'x-github-api-version': '2022-11-28',
+        'user-agent': USER_AGENT,
+    };
+    const token = process.env.GITHUB_TOKEN;
+    if (token)
+        headers['authorization'] = `Bearer ${token}`;
+    return headers;
+}
+function rateLimitMessage(res, body) {
+    if (res.status !== 403 && res.status !== 429)
+        return null;
+    const remaining = res.headers.get('x-ratelimit-remaining');
+    const reset = res.headers.get('x-ratelimit-reset');
+    if (remaining === '0' || /rate limit/i.test(body)) {
+        const resetAt = reset ? new Date(Number(reset) * 1000).toISOString() : 'unknown';
+        const tokenHint = process.env.GITHUB_TOKEN
+            ? ''
+            : ' Set GITHUB_TOKEN to raise the limit from 60/hr to 5000/hr.';
+        return `github rate limit exhausted (resets at ${resetAt}).${tokenHint}`;
+    }
+    return null;
+}
+export async function githubApi(path) {
+    const url = path.startsWith('http') ? path : `${GITHUB_API_BASE}${path}`;
+    const res = await fetch(url, {
+        headers: authHeaders(),
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        const rateLimit = rateLimitMessage(res, body);
+        if (rateLimit)
+            throw new Error(rateLimit);
+        const detail = body ? `: ${body.slice(0, 200)}` : '';
+        throw new Error(`github ${res.status} ${res.statusText}${detail}`);
+    }
+    return (await res.json());
+}
+export async function fetchRawFile(repo, ref, path) {
+    const url = `${RAW_BASE}/${repo}/${ref}/${path}`;
+    const res = await fetch(url, {
+        headers: { 'user-agent': USER_AGENT },
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    if (res.status === 404) {
+        throw new FileNotFoundError(`raw file not found: ${repo}@${ref}/${path}`);
+    }
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        const detail = body ? `: ${body.slice(0, 200)}` : '';
+        throw new Error(`raw.githubusercontent ${res.status} ${res.statusText}${detail}`);
+    }
+    return await res.text();
+}
+export class FileNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FileNotFoundError';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

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

package/dist/schemas/chips.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const chipNumberSchema: z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>, z.ZodNumber>;
+export declare const chipStatusFilterSchema: z.ZodOptional<z.ZodString>;
+export declare const chipCategoryFilterSchema: z.ZodOptional<z.ZodString>;
+export declare const includeBodySchema: z.ZodDefault<z.ZodBoolean>;
+export declare const searchQuerySchema: z.ZodString;
+export declare const searchSourceSchema: z.ZodDefault<z.ZodEnum<["merged", "draft", "both"]>>;
+export declare const searchLimitSchema: z.ZodDefault<z.ZodNumber>;

package/dist/schemas/chips.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export const chipNumberSchema = z
+    .union([z.number().int().nonnegative(), z.string().regex(/^\d+$/)])
+    .transform((v) => (typeof v === 'string' ? Number(v) : v))
+    .pipe(z.number().int().min(0).max(99999))
+    .describe('CHIP number, e.g. 42 or "0042". Accepts the integer or a zero-padded string.');
+export const chipStatusFilterSchema = z
+    .string()
+    .min(1)
+    .max(40)
+    .optional()
+    .describe("Restrict to a status, e.g. 'Final', 'Review', 'Draft', 'Last Call', 'Living', 'Stagnant', 'Withdrawn', 'Obsolete'. Case-insensitive.");
+export const chipCategoryFilterSchema = z
+    .string()
+    .min(1)
+    .max(40)
+    .optional()
+    .describe("Restrict to a category, e.g. 'Standards Track', 'Process', 'Informational'. Case-insensitive.");
+export const includeBodySchema = z
+    .boolean()
+    .default(false)
+    .describe('If true, include the full markdown body of the CHIP. Defaults to false.');
+export const searchQuerySchema = z
+    .string()
+    .min(1)
+    .max(200)
+    .describe('Case-insensitive keyword matched against title, description, abstract, and authors.');
+export const searchSourceSchema = z
+    .enum(['merged', 'draft', 'both'])
+    .default('both')
+    .describe("Where to search: 'merged' (CHIPs on main), 'draft' (open PRs), or 'both' (default).");
+export const searchLimitSchema = z
+    .number()
+    .int()
+    .positive()
+    .max(100)
+    .default(20)
+    .describe('Maximum results. Default 20, max 100.');
+//# sourceMappingURL=chips.js.map

package/dist/schemas/chips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chips.js","sourceRoot":"","sources":["../../src/schemas/chips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;KAClE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACzD,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;KACxC,QAAQ,CAAC,8EAA8E,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,QAAQ,EAAE;KACV,QAAQ,CACP,sIAAsI,CACvI,CAAC;AAEJ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,QAAQ,EAAE;KACV,QAAQ,CACP,+FAA+F,CAChG,CAAC;AAEJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,OAAO,EAAE;KACT,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CAAC,yEAAyE,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,QAAQ,CAAC,qFAAqF,CAAC,CAAC;AAEnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;KACjC,OAAO,CAAC,MAAM,CAAC;KACf,QAAQ,CAAC,qFAAqF,CAAC,CAAC;AAEnG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,EAAE;KACV,GAAG,CAAC,GAAG,CAAC;KACR,OAAO,CAAC,EAAE,CAAC;KACX,QAAQ,CAAC,uCAAuC,CAAC,CAAC"}

package/dist/server.js

@@ -26,6 +26,10 @@ import { register as registerDecompilePuzzle } from './tools/offers/decompile-pu
 import { register as registerGetMempool } from './tools/mempool/get-mempool.js';
 import { register as registerIsInMempool } from './tools/mempool/is-in-mempool.js';
 import { register as registerEstimateFee } from './tools/mempool/estimate-fee.js';
+import { register as registerListChips } from './tools/chips/list-chips.js';
+import { register as registerGetChip } from './tools/chips/get-chip.js';
+import { register as registerListChipDrafts } from './tools/chips/list-chip-drafts.js';
+import { register as registerSearchChips } from './tools/chips/search-chips.js';
 import { register as registerNetworkStatusPrompt } from './prompts/network-status.js';
 import { register as registerAddressSummaryPrompt } from './prompts/address-summary.js';
 import { register as registerBlockSummaryPrompt } from './prompts/block-summary.js';
@@ -33,11 +37,13 @@ import { register as registerPrefarmSummaryPrompt } from './prompts/prefarm-summ
 export function createServer() {
     const server = new McpServer({ name: 'chia-explorer', version: VERSION }, {
         instructions: 'chia-explorer answers questions about the Chia blockchain via the public coinset.org API, ' +
-            'plus XCH spot price and fiat conversion via the public CoinGecko API. ' +
+            'plus XCH spot price and fiat conversion via the public CoinGecko API, ' +
+            'plus Chia Improvement Proposals (CHIPs) read directly from the Chia-Network/chips GitHub repo (merged on main and open PR drafts). ' +
             'Read-only: no signing, no key material, no push_tx. ' +
             "Blockchain tools accept an optional `network: 'mainnet' | 'testnet11'` argument; mainnet is the default. " +
             'When an address is provided, the network is auto-detected from the prefix (xch / txch). ' +
-            'Price tools take no network argument.',
+            'Price and CHIPs tools take no network argument. ' +
+            'An optional GITHUB_TOKEN env var lifts the unauthenticated GitHub rate limit on CHIPs listings.',
     });
     registerGetBlockchainState(server);
     registerGetNetspace(server);
@@ -65,6 +71,10 @@ export function createServer() {
     registerGetMempool(server);
     registerIsInMempool(server);
     registerEstimateFee(server);
+    registerListChips(server);
+    registerGetChip(server);
+    registerListChipDrafts(server);
+    registerSearchChips(server);
     registerNetworkStatusPrompt(server);
     registerAddressSummaryPrompt(server);
     registerBlockSummaryPrompt(server);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACpG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACjG,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAC5G,OAAO,EAAE,QAAQ,IAAI,oCAAoC,EAAE,MAAM,wDAAwD,CAAC;AAE1H,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,QAAQ,IAAI,kCAAkC,EAAE,MAAM,kDAAkD,CAAC;AAClH,OAAO,EAAE,QAAQ,IAAI,iCAAiC,EAAE,MAAM,iDAAiD,CAAC;AAChH,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAEpG,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AACtG,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAEtG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAE5F,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAErG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAEzF,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAElF,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAExF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAC3C;QACE,YAAY,EACV,4FAA4F;YAC5F,wEAAwE;YACxE,sDAAsD;YACtD,2GAA2G;YAC3G,0FAA0F;YAC1F,uCAAuC;KAC1C,CACF,CAAC;IAEF,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,oCAAoC,CAAC,MAAM,CAAC,CAAC;IAE7C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC3C,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1C,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEpC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEjC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/chips/get-chip.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/chips/get-chip.js

@@ -0,0 +1,30 @@
+import { findChipByNumber } from '../../chips/index.js';
+import { chipNumberSchema, includeBodySchema } from '../../schemas/chips.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_chip', 'Get a single CHIP by number. Looks first on main (merged) and also surfaces any open PRs proposing changes to the same number. Returns parsed front matter, abstract, source URL, and (with include_body=true) the full markdown body.', {
+        number: chipNumberSchema,
+        include_body: includeBodySchema,
+    }, async ({ number, include_body }) => {
+        try {
+            const { merged, drafts } = await findChipByNumber(number, { includeBody: include_body });
+            if (!merged && drafts.length === 0) {
+                return jsonText({
+                    number,
+                    found: false,
+                    message: `no CHIP ${number} on main or in open PRs`,
+                });
+            }
+            return jsonText({
+                number,
+                found: true,
+                merged,
+                drafts,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-chip.js.map

package/dist/tools/chips/get-chip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chip.js","sourceRoot":"","sources":["../../../src/tools/chips/get-chip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,UAAU,EACV,wOAAwO,EACxO;QACE,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,iBAAiB;KAChC,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;YACzF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,OAAO,QAAQ,CAAC;oBACd,MAAM;oBACN,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,WAAW,MAAM,yBAAyB;iBACpD,CAAC,CAAC;YACL,CAAC;YACD,OAAO,QAAQ,CAAC;gBACd,MAAM;gBACN,KAAK,EAAE,IAAI;gBACX,MAAM;gBACN,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/chips/list-chip-drafts.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/chips/list-chip-drafts.js

@@ -0,0 +1,19 @@
+import { listChipDrafts } from '../../chips/index.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('list_chip_drafts', 'List the live state of every open pull request against Chia-Network/chips that adds or modifies a CHIP file. Use this for PR review context (author, requested reviewers, draft flag, updated_at) and the modifies_existing flag for amendments. PRs that do not touch a CHIPs/chip-*.md file are filtered out. For the canonical CHIP index across all statuses (including Draft proposals), use list_chips.', {}, async () => {
+        try {
+            const drafts = await listChipDrafts();
+            return jsonText({
+                source: 'github',
+                repo: 'Chia-Network/chips',
+                count: drafts.length,
+                drafts,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=list-chip-drafts.js.map

package/dist/tools/chips/list-chip-drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-chip-drafts.js","sourceRoot":"","sources":["../../../src/tools/chips/list-chip-drafts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,+YAA+Y,EAC/Y,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;YACtC,OAAO,QAAQ,CAAC;gBACd,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,oBAAoB;gBAC1B,KAAK,EAAE,MAAM,CAAC,MAAM;gBACpB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/chips/list-chips.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;