@sugukuru/mcp-houjin-bangou 0.2.0

package/dist/api/csv-parser.js

@@ -0,0 +1,189 @@
+/**
+ * 国税庁 Web-API Ver.4.0 の CSV レスポンスを JSON 化
+ * Parse NTA Web-API Ver.4.0 CSV responses into JSON
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 別紙1 リソース定義書 (36 項目、CSV 順序は同表に準拠)
+ *   レスポンス形式: type=02 (CSV/UTF-8/JIS 第一〜第四水準)
+ *
+ * 1行目: ヘッダー (lastUpdateDate, count, divideNumber, divideSize)
+ * 2行目以降: 法人データ (30列 = 項番7〜36)
+ *
+ * CSVエスケープ:
+ *   - フィールド値はダブルクォーテーション（"）で囲まれる
+ *   - 値内の " は "" にエスケープ
+ */
+/**
+ * NTA CSV をパースして構造化
+ *
+ * @param csvText UTF-8 でデコード済みの CSV 本体
+ */
+export function parseNtaCsv(csvText) {
+    const lines = splitCsvLines(csvText);
+    if (lines.length === 0) {
+        throw new Error('Empty NTA CSV response');
+    }
+    const headerLine = lines[0];
+    if (headerLine === undefined) {
+        throw new Error('Missing header line in NTA CSV');
+    }
+    const headerFields = parseCsvLine(headerLine);
+    if (headerFields.length < 4) {
+        throw new Error(`Invalid header line: expected 4 fields, got ${headerFields.length}`);
+    }
+    const header = {
+        lastUpdateDate: headerFields[0] ?? '',
+        count: toInt(headerFields[1]),
+        divideNumber: toInt(headerFields[2]),
+        divideSize: toInt(headerFields[3]),
+    };
+    const corporations = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line.trim() === '')
+            continue;
+        const fields = parseCsvLine(line);
+        if (fields.length < 30) {
+            // 項番7〜36 の 30 列を期待 (項番7=一連番号から項番36=検索対象除外まで)
+            continue;
+        }
+        corporations.push(rowToCorporation(fields));
+    }
+    return { header, corporations };
+}
+function toInt(raw) {
+    if (raw === undefined || raw === '')
+        return 0;
+    const n = Number.parseInt(raw, 10);
+    return Number.isNaN(n) ? 0 : n;
+}
+/**
+ * CSV 1行をフィールド配列に分解 (RFC 4180、ダブルクォート + "" エスケープ対応)
+ */
+export function parseCsvLine(line) {
+    const fields = [];
+    let current = '';
+    let inQuotes = false;
+    let i = 0;
+    while (i < line.length) {
+        const ch = line[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (line[i + 1] === '"') {
+                    current += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i += 1;
+                continue;
+            }
+            current += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '"') {
+            inQuotes = true;
+            i += 1;
+            continue;
+        }
+        if (ch === ',') {
+            fields.push(current);
+            current = '';
+            i += 1;
+            continue;
+        }
+        current += ch;
+        i += 1;
+    }
+    fields.push(current);
+    return fields;
+}
+/**
+ * CSV 本体を行に分割。ダブルクォート内の改行を無視し、CRLF / LF を扱う。
+ */
+function splitCsvLines(csv) {
+    const lines = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < csv.length; i++) {
+        const ch = csv[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (csv[i + 1] === '"') {
+                    current += '""';
+                    i += 1;
+                    continue;
+                }
+                inQuotes = false;
+            }
+            current += ch;
+            continue;
+        }
+        if (ch === '"') {
+            inQuotes = true;
+            current += ch;
+            continue;
+        }
+        if (ch === '\r') {
+            if (csv[i + 1] === '\n')
+                i += 1;
+            if (current.length > 0) {
+                lines.push(current);
+                current = '';
+            }
+            continue;
+        }
+        if (ch === '\n') {
+            if (current.length > 0) {
+                lines.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (current.length > 0)
+        lines.push(current);
+    return lines;
+}
+/**
+ * CSV 1行を Corporation オブジェクトに変換
+ * フィールド順は 第二編 別紙1 の項番7〜36 (30項目)
+ */
+function rowToCorporation(f) {
+    const g = (idx) => f[idx] ?? '';
+    return {
+        sequence_number: toInt(g(0)),
+        corporate_number: g(1),
+        process: g(2),
+        correct: (g(3) === '1' ? '1' : '0'),
+        update_date: g(4),
+        change_date: g(5),
+        name: g(6),
+        name_image_id: g(7),
+        kind: g(8),
+        prefecture_name: g(9),
+        city_name: g(10),
+        street_number: g(11),
+        address_image_id: g(12),
+        prefecture_code: g(13),
+        city_code: g(14),
+        post_code: g(15),
+        address_outside: g(16),
+        address_outside_image_id: g(17),
+        close_date: g(18),
+        close_cause: g(19),
+        successor_corporate_number: g(20),
+        change_cause: g(21),
+        assignment_date: g(22),
+        latest: (g(23) === '0' ? '0' : '1'),
+        en_name: g(24),
+        en_prefecture_name: g(25),
+        en_city_name: g(26),
+        en_address_outside: g(27),
+        furigana: g(28),
+        hihyoji: (g(29) === '1' ? '1' : '0'),
+    };
+}
+//# sourceMappingURL=csv-parser.js.map

package/dist/api/csv-parser.js.map

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

package/dist/api/nta-client.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 国税庁 法人番号 Web-API Ver.4.0 クライアント
+ * National Tax Agency Corporate Number Web-API Ver.4.0 client
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 (概要) + 第六編 (Ver.4.0)
+ *   エンドポイント: https://api.houjin-bangou.nta.go.jp/4/{num|diff|name}
+ *   応答形式: type=02 (CSV UTF-8)
+ *
+ * DI seam: fetchImpl でテスト時差替え可能
+ */
+import { NtaApiError } from '../lib/errors.js';
+import { Result } from '../lib/result.js';
+import { type ParsedNtaResponse } from './csv-parser.js';
+export interface NtaClientConfig {
+    applicationId: string;
+    baseUrl: string;
+    timeoutMs: number;
+    rps: number;
+    userAgent?: string;
+    fetchImpl?: typeof fetch;
+    /** バックオフ発動時のフック (Logging 連携用) */
+    onBackoff?: (waitMs: number) => void;
+}
+/**
+ * 法人番号指定検索 (/4/num) のパラメータ
+ * 根拠: 第六編 §2.1, 第二編 §2.1.3
+ */
+export interface LookupByNumberParams {
+    /** 13桁の法人番号、最大10件 */
+    numbers: string[];
+    /** 変更履歴要否 (0=最新のみ / 1=含める)、デフォルト 0 */
+    history?: '0' | '1';
+}
+/**
+ * 法人名指定検索 (/4/name) のパラメータ
+ * 根拠: 第六編 §4.1, 第二編 §4.1.3
+ */
+export interface SearchByNameParams {
+    /** 商号又は名称 (UTF-8、最大150文字 日本語 / 300文字 英語) */
+    name: string;
+    /** 検索方式 (1=前方一致 / 2=部分一致)、デフォルト 1 */
+    mode?: '1' | '2';
+    /** 検索対象 (1=JIS1-2水準あいまい / 2=JIS1-4水準完全 / 3=英語)、デフォルト 1 */
+    target?: '1' | '2' | '3';
+    /** 所在地 (都道府県コード2桁 or 都道府県+市区町村5桁) */
+    address?: string;
+    /** 法人種別 (01/02/03/04、最大4件カンマ区切り) */
+    kind?: string;
+    /** 変更履歴を含めるか (0/1)、デフォルト 0 */
+    change?: '0' | '1';
+    /** 登記記録の閉鎖等を含めるか (0/1)、デフォルト 1 */
+    close?: '0' | '1';
+    /** 法人番号指定年月日 開始 (YYYY-MM-DD) */
+    from?: string;
+    /** 法人番号指定年月日 終了 (YYYY-MM-DD) */
+    to?: string;
+    /** 分割番号 (1-99999)、デフォルト 1 */
+    divide?: number;
+}
+export interface NtaClient {
+    lookupByNumber(params: LookupByNumberParams): Promise<Result<ParsedNtaResponse, NtaApiError>>;
+    searchByName(params: SearchByNameParams): Promise<Result<ParsedNtaResponse, NtaApiError>>;
+    /** 3年無利用停止を防止するための health ping */
+    ping(): Promise<Result<true, NtaApiError>>;
+}
+/**
+ * NtaClient のファクトリ関数 (DI seam)
+ */
+export declare function createNtaClient(config: NtaClientConfig): NtaClient;
+//# sourceMappingURL=nta-client.d.ts.map

package/dist/api/nta-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nta-client.d.ts","sourceRoot":"","sources":["../../src/api/nta-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,iCAAiC;IACjC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACjB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC9F,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1F,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CA8GlE"}

package/dist/api/nta-client.js

@@ -0,0 +1,117 @@
+/**
+ * 国税庁 法人番号 Web-API Ver.4.0 クライアント
+ * National Tax Agency Corporate Number Web-API Ver.4.0 client
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 (概要) + 第六編 (Ver.4.0)
+ *   エンドポイント: https://api.houjin-bangou.nta.go.jp/4/{num|diff|name}
+ *   応答形式: type=02 (CSV UTF-8)
+ *
+ * DI seam: fetchImpl でテスト時差替え可能
+ */
+import { NtaApiError } from '../lib/errors.js';
+import { Result } from '../lib/result.js';
+import { TokenBucket } from './rate-limiter.js';
+import { parseNtaCsv } from './csv-parser.js';
+/**
+ * NtaClient のファクトリ関数 (DI seam)
+ */
+export function createNtaClient(config) {
+    const fetchImpl = config.fetchImpl ?? globalThis.fetch;
+    const limiter = new TokenBucket({ rps: config.rps });
+    const userAgent = config.userAgent ?? '@sugukuru/mcp-houjin-bangou';
+    async function callApi(path, params) {
+        await limiter.acquire();
+        params.set('id', config.applicationId);
+        params.set('type', '02'); // ADR-0003: CSV UTF-8 固定
+        const url = `${config.baseUrl}${path}?${params.toString()}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), config.timeoutMs);
+        try {
+            const res = await fetchImpl(url, {
+                method: 'GET',
+                signal: controller.signal,
+                headers: {
+                    'User-Agent': userAgent,
+                    Accept: 'text/csv',
+                },
+            });
+            if (res.status === 403) {
+                const waitMs = limiter.triggerBackoff();
+                if (config.onBackoff)
+                    config.onBackoff(waitMs);
+                return Result.err(NtaApiError.fromHttpStatus(403, `Rate limited by NTA. Backoff ${waitMs}ms applied. (別添1 第9条第1項三号)`));
+            }
+            if (!res.ok) {
+                const body = await res.text().catch(() => '');
+                return Result.err(NtaApiError.fromHttpStatus(res.status, body));
+            }
+            limiter.resetBackoff();
+            const csvText = await res.text();
+            try {
+                const parsed = parseNtaCsv(csvText);
+                return Result.ok(parsed);
+            }
+            catch (err) {
+                return Result.err(new NtaApiError(`Failed to parse NTA CSV: ${err instanceof Error ? err.message : String(err)}`, 'parse_error'));
+            }
+        }
+        catch (err) {
+            return Result.err(NtaApiError.fromUnknown(err));
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    return {
+        async lookupByNumber(params) {
+            if (params.numbers.length === 0 || params.numbers.length > 10) {
+                return Result.err(new NtaApiError('numbers must contain 1-10 corporate numbers (第二編 §2.1.3)', 'http_400'));
+            }
+            const search = new URLSearchParams({
+                number: params.numbers.join(','),
+                history: params.history ?? '0',
+            });
+            return callApi('/num', search);
+        },
+        async searchByName(params) {
+            if (params.name.length === 0) {
+                return Result.err(new NtaApiError('name parameter is required (第二編 §4.1.3)', 'http_400'));
+            }
+            const search = new URLSearchParams();
+            search.set('name', params.name);
+            if (params.mode !== undefined)
+                search.set('mode', params.mode);
+            if (params.target !== undefined)
+                search.set('target', params.target);
+            if (params.address !== undefined)
+                search.set('address', params.address);
+            if (params.kind !== undefined)
+                search.set('kind', params.kind);
+            if (params.change !== undefined)
+                search.set('change', params.change);
+            if (params.close !== undefined)
+                search.set('close', params.close);
+            if (params.from !== undefined)
+                search.set('from', params.from);
+            if (params.to !== undefined)
+                search.set('to', params.to);
+            if (params.divide !== undefined)
+                search.set('divide', String(params.divide));
+            return callApi('/name', search);
+        },
+        async ping() {
+            // ダミー番号 0000000000000 → 404 相当の応答が返る (または 200 空結果)
+            // 目的は ID の active 状態維持 (第一編 §5.3、3年無利用停止防止)
+            const result = await this.lookupByNumber({ numbers: ['0000000000000'] });
+            if (Result.isOk(result))
+                return Result.ok(true);
+            const err = result.error;
+            // 404 は「該当なし」で OK、403 は rate limit、その他は真のエラー
+            if (err.code === 'http_404')
+                return Result.ok(true);
+            return Result.err(err);
+        },
+    };
+}
+//# sourceMappingURL=nta-client.js.map

package/dist/api/nta-client.js.map

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

package/dist/api/rate-limiter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Token bucket レートリミッター
+ * Token bucket rate limiter for NTA API
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 別紙2: HTTP 403 は「同一アプリケーションIDで一定期間内に多数アクセス」で発動
+ *   別添1 第9条第1項三号: 短時間における大量アクセスは禁止
+ *   → 保守的に 1 RPS デフォルト、403 受信時は指数バックオフ
+ */
+export interface RateLimiterOptions {
+    /** リクエスト毎秒 (requests per second) */
+    rps: number;
+    /** バケット最大容量 (burst 許容量) */
+    maxBurst?: number;
+}
+export declare class TokenBucket {
+    private tokens;
+    private readonly capacity;
+    private readonly refillPerMs;
+    private lastRefill;
+    private backoffUntil;
+    private backoffLevel;
+    constructor(options: RateLimiterOptions);
+    private refill;
+    /**
+     * 1トークン獲得するまで待機
+     * Awaits until a token is available (resolves immediately if bucket full)
+     */
+    acquire(): Promise<void>;
+    /**
+     * 403 受信時の指数バックオフを発動 (30s → 1m → 5m → 30m)
+     */
+    triggerBackoff(): number;
+    /** 正常完了時にバックオフをリセット */
+    resetBackoff(): void;
+    /** テスト・観測用: 現在のトークン数を返す */
+    getTokens(): number;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/api/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/api/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;gBAEb,OAAO,EAAE,kBAAkB;IAQvC,OAAO,CAAC,MAAM;IASd;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;OAEG;IACH,cAAc,IAAI,MAAM;IAQxB,uBAAuB;IACvB,YAAY,IAAI,IAAI;IAKpB,2BAA2B;IAC3B,SAAS,IAAI,MAAM;CAIpB"}

package/dist/api/rate-limiter.js

@@ -0,0 +1,74 @@
+/**
+ * Token bucket レートリミッター
+ * Token bucket rate limiter for NTA API
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 別紙2: HTTP 403 は「同一アプリケーションIDで一定期間内に多数アクセス」で発動
+ *   別添1 第9条第1項三号: 短時間における大量アクセスは禁止
+ *   → 保守的に 1 RPS デフォルト、403 受信時は指数バックオフ
+ */
+export class TokenBucket {
+    tokens;
+    capacity;
+    refillPerMs;
+    lastRefill;
+    backoffUntil = 0;
+    backoffLevel = 0;
+    constructor(options) {
+        const capacity = options.maxBurst ?? Math.max(1, Math.ceil(options.rps));
+        this.capacity = capacity;
+        this.tokens = capacity;
+        this.refillPerMs = options.rps / 1000;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        if (elapsed > 0) {
+            this.tokens = Math.min(this.capacity, this.tokens + elapsed * this.refillPerMs);
+            this.lastRefill = now;
+        }
+    }
+    /**
+     * 1トークン獲得するまで待機
+     * Awaits until a token is available (resolves immediately if bucket full)
+     */
+    async acquire() {
+        const now = Date.now();
+        if (now < this.backoffUntil) {
+            const waitMs = this.backoffUntil - now;
+            await sleep(waitMs);
+        }
+        this.refill();
+        while (this.tokens < 1) {
+            const neededMs = Math.ceil((1 - this.tokens) / this.refillPerMs);
+            await sleep(neededMs);
+            this.refill();
+        }
+        this.tokens -= 1;
+    }
+    /**
+     * 403 受信時の指数バックオフを発動 (30s → 1m → 5m → 30m)
+     */
+    triggerBackoff() {
+        const schedule = [30_000, 60_000, 5 * 60_000, 30 * 60_000];
+        const waitMs = schedule[Math.min(this.backoffLevel, schedule.length - 1)] ?? 30_000;
+        this.backoffLevel += 1;
+        this.backoffUntil = Date.now() + waitMs;
+        return waitMs;
+    }
+    /** 正常完了時にバックオフをリセット */
+    resetBackoff() {
+        this.backoffLevel = 0;
+        this.backoffUntil = 0;
+    }
+    /** テスト・観測用: 現在のトークン数を返す */
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/api/rate-limiter.js.map

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

package/dist/completion/handler.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP Completion handler (completion/complete)
+ *
+ * Resource Template `corp://{corporate_number}` の引数補完では、
+ * normalizeCompanyName (T7) を裏で駆動して会社名ベースの候補を返す実装も可能だが、
+ * corporate_number は数字13桁なので、国税庁 API を叩かず「ローカルでのチェックデジット
+ * 検証済み候補」を補完対象とする。
+ *
+ * 根拠 / Source: MCP 公式仕様 server/utilities/completion
+ *   values: max 100 items
+ *   total: optional
+ *   hasMore: boolean
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { McpLogger } from '../lib/mcp-logger.js';
+export declare function registerCompletionHandler(server: Server, deps: {
+    logger: McpLogger;
+}): void;
+//# sourceMappingURL=handler.d.ts.map

package/dist/completion/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/completion/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAkC3F"}