@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.1

package/dist/plugins/drive/client.js

@@ -0,0 +1,220 @@
+/**
+ * Google Drive API (v3, read-only) over plain HTTPS.
+ *
+ * 인증 옵션 (우선순위 순):
+ *   1. Service Account JSON (권장 — production-grade)
+ *      - GOOGLE_SERVICE_ACCOUNT_KEY (inline JSON, Railway 친화)
+ *      - GOOGLE_APPLICATION_CREDENTIALS (JSON 파일 path. service_account 또는 authorized_user)
+ *
+ *   2. OAuth Refresh Token (fallback, single-user)
+ *      - GOOGLE_OAUTH_CLIENT_ID + GOOGLE_OAUTH_CLIENT_SECRET + GOOGLE_OAUTH_REFRESH_TOKEN
+ *      - Legacy DRIVE_* fallback
+ *
+ * Service Account 사용 시:
+ *   - Drive 폴더에 service account email (xxx@<project>.iam.gserviceaccount.com) viewer 공유 필수
+ *   - refresh_token 만료·rotation 없음
+ *
+ * googleapis 대신 직접 부르는 이유: googleapis(google-auth-library → gaxios → node-fetch → fetch-blob)는
+ * 최신판도 폐기된 패키지(node-domexception, 옛 판은 uuid)를 끌어와 설치마다 경고를 남겼고, 불러오는 데만
+ * CPU 1초가 넘게 들었다. 이 서버가 쓰는 Drive 엔드포인트는 5개뿐이다. 호출 모양(drive.files.list 등,
+ * { data } 반환)은 googleapis 와 같게 둬서 도구 코드는 바꾸지 않았다.
+ */
+import { readFileSync } from 'node:fs';
+import { SignJWT, importPKCS8 } from 'jose';
+const DRIVE_READONLY_SCOPE = 'https://www.googleapis.com/auth/drive.readonly';
+const DEFAULT_TOKEN_URI = 'https://oauth2.googleapis.com/token';
+const DRIVE_API = 'https://www.googleapis.com/drive/v3';
+// Drive API 전역 timeout — 명시 timeout 이 없으면 매달린 호출 하나가 도구 호출 전체를 멈춘다.
+const DRIVE_TIMEOUT_MS = Number(process.env.DRIVE_TIMEOUT_MS ?? 15_000);
+const RETRIES = 3; // 429·5xx·네트워크 오류. GET 만 쓰므로 다시 보내도 안전하다
+export class DriveApiError extends Error {
+    code;
+    constructor(message, 
+    /** HTTP status (0 = network or timeout). googleapis put the same value in `code`. */
+    code) {
+        super(message);
+        this.code = code;
+        this.name = 'DriveApiError';
+    }
+}
+function credentialsFromJson(raw, source) {
+    let j;
+    try {
+        j = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`[drive] ${source} is not valid JSON: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (j.type === 'authorized_user') {
+        return {
+            kind: 'refresh_token',
+            clientId: String(j.client_id ?? ''),
+            clientSecret: String(j.client_secret ?? ''),
+            refreshToken: String(j.refresh_token ?? ''),
+            tokenUri: DEFAULT_TOKEN_URI,
+        };
+    }
+    if (typeof j.client_email !== 'string' || typeof j.private_key !== 'string') {
+        throw new Error(`[drive] ${source} must be a service account key (client_email, private_key) or an authorized_user file`);
+    }
+    return {
+        kind: 'service_account',
+        clientEmail: j.client_email,
+        privateKey: j.private_key,
+        tokenUri: typeof j.token_uri === 'string' ? j.token_uri : DEFAULT_TOKEN_URI,
+    };
+}
+/** Which credentials the env provides. Throws with the options when none are set. */
+export function resolveCredentials(env = process.env) {
+    if (env.GOOGLE_SERVICE_ACCOUNT_KEY)
+        return credentialsFromJson(env.GOOGLE_SERVICE_ACCOUNT_KEY, 'GOOGLE_SERVICE_ACCOUNT_KEY');
+    if (env.GOOGLE_APPLICATION_CREDENTIALS) {
+        const path = env.GOOGLE_APPLICATION_CREDENTIALS;
+        let raw;
+        try {
+            raw = readFileSync(path, 'utf8');
+        }
+        catch (e) {
+            throw new Error(`[drive] cannot read GOOGLE_APPLICATION_CREDENTIALS (${path}): ${e instanceof Error ? e.message : String(e)}`);
+        }
+        return credentialsFromJson(raw, 'GOOGLE_APPLICATION_CREDENTIALS');
+    }
+    const clientId = env.GOOGLE_OAUTH_CLIENT_ID || env.DRIVE_CLIENT_ID;
+    const clientSecret = env.GOOGLE_OAUTH_CLIENT_SECRET || env.DRIVE_CLIENT_SECRET;
+    const refreshToken = env.GOOGLE_OAUTH_REFRESH_TOKEN || env.DRIVE_REFRESH_TOKEN;
+    if (clientId && clientSecret && refreshToken) {
+        return { kind: 'refresh_token', clientId, clientSecret, refreshToken, tokenUri: DEFAULT_TOKEN_URI };
+    }
+    throw new Error('[drive] Drive credentials missing. Use one of:\n' +
+        '  (1) GOOGLE_SERVICE_ACCOUNT_KEY (inline JSON) ← 권장\n' +
+        '  (2) GOOGLE_APPLICATION_CREDENTIALS (JSON file path) ← 권장\n' +
+        '  (3) GOOGLE_OAUTH_CLIENT_ID + _SECRET + _REFRESH_TOKEN ← fallback');
+}
+async function requestToken(creds) {
+    const form = new URLSearchParams();
+    if (creds.kind === 'service_account') {
+        // OAuth 2.0 JWT bearer grant (RFC 7523): 서비스 계정 키로 서명한 assertion 을 토큰으로 바꾼다.
+        const now = Math.floor(Date.now() / 1000);
+        const key = await importPKCS8(creds.privateKey, 'RS256');
+        const assertion = await new SignJWT({ scope: DRIVE_READONLY_SCOPE })
+            .setProtectedHeader({ alg: 'RS256', typ: 'JWT' })
+            .setIssuer(creds.clientEmail)
+            .setAudience(creds.tokenUri)
+            .setIssuedAt(now)
+            .setExpirationTime(now + 3600)
+            .sign(key);
+        form.set('grant_type', 'urn:ietf:params:oauth:grant-type:jwt-bearer');
+        form.set('assertion', assertion);
+    }
+    else {
+        form.set('grant_type', 'refresh_token');
+        form.set('client_id', creds.clientId);
+        form.set('client_secret', creds.clientSecret);
+        form.set('refresh_token', creds.refreshToken);
+    }
+    const res = await fetch(creds.tokenUri, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: form,
+        signal: AbortSignal.timeout(DRIVE_TIMEOUT_MS),
+    });
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok || !body.access_token) {
+        // Google 은 오류 본문에 토큰이나 키를 돌려주지 않는다. 오류 코드와 설명만 남긴다.
+        throw new DriveApiError(`[drive] token request failed ${res.status}: ${body.error ?? ''} ${body.error_description ?? ''}`.trim(), res.status);
+    }
+    return { token: body.access_token, expiresAt: Date.now() + (body.expires_in ?? 3600) * 1000 };
+}
+/** Builds a client. `apiBase` and credentials are injectable for tests; production uses env and Google URLs. */
+export function createDriveClient(creds, apiBase = DRIVE_API) {
+    let cached = null;
+    let pending = null;
+    const accessToken = () => {
+        if (cached && cached.expiresAt - 60_000 > Date.now())
+            return Promise.resolve(cached.token);
+        pending ??= requestToken(creds)
+            .then((t) => {
+            cached = t;
+            return t.token;
+        })
+            .finally(() => {
+            pending = null;
+        });
+        return pending;
+    };
+    const get = async (path, params = {}, responseType = 'json') => {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(params))
+            if (v !== undefined)
+                qs.set(k, String(v));
+        const url = `${apiBase}${path}${qs.size ? `?${qs}` : ''}`;
+        for (let attempt = 0;; attempt++) {
+            let res;
+            try {
+                res = await fetch(url, {
+                    headers: { Authorization: `Bearer ${await accessToken()}`, Accept: responseType === 'json' ? 'application/json' : '*/*' },
+                    signal: AbortSignal.timeout(DRIVE_TIMEOUT_MS),
+                });
+            }
+            catch (e) {
+                if (e instanceof DriveApiError)
+                    throw e; // token request failed
+                if (attempt + 1 < RETRIES) {
+                    await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
+                    continue;
+                }
+                const reason = e instanceof Error && e.name === 'TimeoutError' ? `timeout ${DRIVE_TIMEOUT_MS}ms` : String(e);
+                throw new DriveApiError(`[drive] GET ${path} failed: ${reason}`, 0);
+            }
+            if (res.status === 401 && attempt === 0) {
+                cached = null; // revoked or expired early: get a new token once
+                continue;
+            }
+            if ((res.status === 429 || res.status >= 500) && attempt + 1 < RETRIES) {
+                const after = Number(res.headers.get('retry-after'));
+                await res.arrayBuffer().catch(() => undefined);
+                await new Promise((r) => setTimeout(r, Number.isFinite(after) && after > 0 ? after * 1000 : 500 * 2 ** attempt));
+                continue;
+            }
+            if (!res.ok) {
+                const text = await res.text().catch(() => '');
+                let msg = text.slice(0, 300);
+                try {
+                    msg = JSON.parse(text).error?.message ?? msg;
+                }
+                catch {
+                    /* not JSON */
+                }
+                throw new DriveApiError(`[drive] ${res.status} ${path}: ${msg}`, res.status);
+            }
+            if (responseType === 'arraybuffer')
+                return { data: await res.arrayBuffer() };
+            if (responseType === 'text')
+                return { data: await res.text() };
+            return { data: await res.json() };
+        }
+    };
+    const fileId = (id) => encodeURIComponent(id);
+    return {
+        files: {
+            list: (params) => get('/files', params),
+            get: ({ fileId: id, ...params }, opts) => get(`/files/${fileId(id)}`, params, opts?.responseType ?? 'json'),
+            export: ({ fileId: id, ...params }, opts) => get(`/files/${fileId(id)}/export`, params, opts?.responseType ?? 'text'),
+        },
+        changes: {
+            getStartPageToken: (params) => get('/changes/startPageToken', params),
+            list: (params) => get('/changes', params),
+        },
+    };
+}
+let _client = null;
+/** The process-wide Drive client, built from env on first use. */
+export async function getDriveClient() {
+    _client ??= createDriveClient(resolveCredentials());
+    return _client;
+}
+/** Google Drive query language 의 single-quote escape. */
+export function escapeDriveQuery(s) {
+    return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+//# sourceMappingURL=client.js.map

package/dist/plugins/drive/client.js.map

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

package/dist/plugins/drive/embeddings.d.ts

@@ -0,0 +1,15 @@
+export declare const EMBEDDING_MODEL = "text-embedding-3-small";
+export declare const EMBEDDING_DIM = 1536;
+interface EmbedPolicy {
+    maxRetries: number;
+    timeoutMs: number;
+}
+export type EmbedTaskType = 'RETRIEVAL_DOCUMENT' | 'RETRIEVAL_QUERY' | 'SEMANTIC_SIMILARITY' | 'CLASSIFICATION' | 'CLUSTERING';
+/**
+ * 여러 텍스트 → embedding 벡터들 (input 순서 보장).
+ * BATCH_SIZE 씩 묶어 batch 호출. policy 기본 = 색인용(patient). 쿼리는 embedQuery 가 fail-fast 사용.
+ */
+export declare function embedTexts(texts: string[], _taskType?: EmbedTaskType, policy?: EmbedPolicy): Promise<number[][]>;
+/** 단일 query → 벡터. 인터랙티브 검색 경로라 fail-fast 정책(QUERY_POLICY) 사용. */
+export declare function embedQuery(query: string): Promise<number[]>;
+export {};

package/dist/plugins/drive/embeddings.js

@@ -0,0 +1,118 @@
+/**
+ * Embedding 헬퍼 — OpenAI `text-embedding-3-small` (2026-05-28 비용 전환).
+ *
+ * 기존 Gemini `gemini-embedding-2` → OpenAI 3-small 전환 이유:
+ *   - 비용 ~1/10 ($0.02/1M vs Gemini ~$0.20/1M)
+ *   - 429 rate limit 여유 (Gemini free tier 한도 잦은 429 → drive-sync 에러 로그)
+ *   - backend 가 이미 3-small 사용(한국어 KG 임베딩 검증됨)
+ *   - 1536 dim 동일 → Qdrant collection 차원 유지 (벡터 공간만 다름 → 전환 시 전체 재색인 필수)
+ *   - input 한도 8191 토큰 → Gemini 대비 큰 청크 Bad Request 완화
+ *
+ * 호출 패턴:
+ *   OpenAI embeddings API 는 `input` 배열 batch 지원 → 한 호출에 여러 청크 (Gemini individual call 대비 빠르고 rate limit ↓).
+ *   429/5xx → exponential backoff + jitter retry. timeout 방어(무응답 hang).
+ */
+const OPENAI_EMBEDDINGS_URL = 'https://api.openai.com/v1/embeddings';
+export const EMBEDDING_MODEL = 'text-embedding-3-small';
+export const EMBEDDING_DIM = 1536;
+// 한 batch 당 input 수 (OpenAI 는 배열 input 지원). 토큰 한도 여유 위해 보수적 128.
+const BATCH_SIZE = Number(process.env.EMBED_BATCH ?? 128);
+const INDEX_POLICY = {
+    maxRetries: Number(process.env.EMBED_INDEX_RETRIES ?? 5),
+    timeoutMs: Number(process.env.EMBED_TIMEOUT_MS ?? 10_000),
+};
+const QUERY_POLICY = {
+    maxRetries: Number(process.env.EMBED_QUERY_RETRIES ?? 2),
+    timeoutMs: Number(process.env.EMBED_QUERY_TIMEOUT_MS ?? 5_000),
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function withTimeout(p, ms, label) {
+    let t;
+    const timer = new Promise((_, reject) => {
+        t = setTimeout(() => reject(new Error(`${label}: 504 deadline (timeout ${ms}ms)`)), ms);
+    });
+    return Promise.race([p, timer]).finally(() => clearTimeout(t));
+}
+function getApiKey() {
+    const key = process.env.OPENAI_API_KEY;
+    if (!key)
+        throw new Error('[embeddings] OPENAI_API_KEY env missing');
+    return key;
+}
+/** 재시도 가능 여부 (429 rate limit 또는 5xx/timeout). */
+function parseRetryable(status, msg) {
+    const is429 = status === 429 || /rate limit|quota|too many requests/i.test(msg);
+    const is5xx = (typeof status === 'number' && status >= 500 && status <= 599) ||
+        /\b(500|502|503|504)\b|timeout|deadline|ECONNRESET|ETIMEDOUT|fetch failed/i.test(msg);
+    return is429 || is5xx;
+}
+// lone surrogate 방어 — 깨진 이모지 반쪽이 들어오면 400. 빈 입력도 400 → 공백 fallback.
+function sanitize(text) {
+    const s = text.replace(/[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]/g, '');
+    return s.length > 0 ? s : ' ';
+}
+/** input 배열 → 임베딩 배열 (batch 1회 호출 + retry). 순서 보장. policy 로 재시도·timeout 경로별 분리. */
+async function embedBatch(texts, policy) {
+    const apiKey = getApiKey();
+    const inputs = texts.map(sanitize);
+    for (let attempt = 0;; attempt++) {
+        try {
+            const resp = await withTimeout(fetch(OPENAI_EMBEDDINGS_URL, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
+                body: JSON.stringify({ model: EMBEDDING_MODEL, input: inputs, dimensions: EMBEDDING_DIM }),
+            }), policy.timeoutMs, '[embeddings] openai');
+            if (!resp.ok) {
+                const body = await resp.text();
+                const retryable = parseRetryable(resp.status, body);
+                if (!retryable || attempt >= policy.maxRetries) {
+                    throw new Error(`OpenAI embeddings ${resp.status}: ${body.slice(0, 200)}`);
+                }
+                const m = body.match(/try again in ([\d.]+)s/i);
+                const base = m ? Math.ceil(parseFloat(m[1]) * 1000) : Math.min(60_000, 1000 * 2 ** attempt);
+                const wait = Math.round(base + base * 0.3 * Math.random());
+                console.error(`[embeddings] ${resp.status} retry ${attempt + 1}/${policy.maxRetries} — ${wait}ms 대기`);
+                await sleep(wait);
+                continue;
+            }
+            const j = (await resp.json());
+            // index 순 정렬 후 벡터만 (OpenAI 는 보통 정렬돼 오지만 방어)
+            const sorted = [...j.data].sort((a, b) => a.index - b.index);
+            const vecs = sorted.map((d) => d.embedding);
+            if (vecs.length !== inputs.length || vecs[0]?.length !== EMBEDDING_DIM) {
+                throw new Error(`[embeddings] 응답 불일치 — vecs=${vecs.length}/${inputs.length}, dim=${vecs[0]?.length}/${EMBEDDING_DIM}`);
+            }
+            return vecs;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (attempt >= policy.maxRetries || !parseRetryable(null, msg))
+                throw err;
+            const base = Math.min(60_000, 1000 * 2 ** attempt);
+            const wait = Math.round(base + base * 0.3 * Math.random());
+            console.error(`[embeddings] 예외 retry ${attempt + 1}/${policy.maxRetries} — ${wait}ms 대기 (${msg.slice(0, 80)})`);
+            await sleep(wait);
+        }
+    }
+}
+/**
+ * 여러 텍스트 → embedding 벡터들 (input 순서 보장).
+ * BATCH_SIZE 씩 묶어 batch 호출. policy 기본 = 색인용(patient). 쿼리는 embedQuery 가 fail-fast 사용.
+ */
+export async function embedTexts(texts, _taskType = 'RETRIEVAL_DOCUMENT', policy = INDEX_POLICY) {
+    if (texts.length === 0)
+        return [];
+    const results = [];
+    for (let i = 0; i < texts.length; i += BATCH_SIZE) {
+        const slice = texts.slice(i, i + BATCH_SIZE);
+        const embeds = await embedBatch(slice, policy);
+        results.push(...embeds);
+    }
+    return results;
+}
+/** 단일 query → 벡터. 인터랙티브 검색 경로라 fail-fast 정책(QUERY_POLICY) 사용. */
+export async function embedQuery(query) {
+    const [vec] = await embedTexts([query], 'RETRIEVAL_QUERY', QUERY_POLICY);
+    return vec;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/plugins/drive/embeddings.js.map

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

package/dist/plugins/drive/exclude.d.ts

@@ -0,0 +1,11 @@
+/** Normalized form used for every exclusion comparison. */
+export declare function normalizeFolderName(name: string): string;
+/** Merged exclusion set (normalized): built-in dev artifacts + configured sensitive folders. */
+export declare const EXCLUDED_FOLDER_NAMES: Set<string>;
+/** True if this single folder name is excluded. */
+export declare function isExcludedName(name: string | null | undefined): boolean;
+/**
+ * True if any path segment matches an excluded folder name.
+ * Segment-wise (not includes()) so e.g. "rebuild.md" doesn't match "build".
+ */
+export declare function isExcludedPath(path: string): boolean;

package/dist/plugins/drive/exclude.js

@@ -0,0 +1,36 @@
+/**
+ * Search-index folder exclusions — single source of truth.
+ *
+ * Shared by full reindex (reindex.ts), incremental sync (sync.ts) and the read/list/search
+ * tools (path.ts). Two buckets:
+ *   1. Built-in dev artifacts (node_modules, .git, build outputs) — always excluded so whole code
+ *      projects in Drive don't flood the index with library-doc noise.
+ *   2. Configured sensitive folders (config.drive.excludeFolders) — your PII/contract/HR/backup folders.
+ *
+ * Names are compared after normalization (Unicode NFC, trimmed, lower-cased). Drive keeps whatever form the
+ * uploader sent, so a macOS-uploaded Korean folder name can arrive as NFD and "HR " or "hr" must still match.
+ */
+import { getConfig } from '../../core/config.js';
+const BUILTIN_EXCLUDES = [
+    'node_modules', '.git', '.next', '.nuxt', '.svelte-kit',
+    'dist', 'build', 'coverage', '.cache', '.turbo', '.parcel-cache',
+    '__pycache__', '.venv', 'venv', '.pytest_cache', '.mypy_cache',
+];
+/** Normalized form used for every exclusion comparison. */
+export function normalizeFolderName(name) {
+    return name.normalize('NFC').trim().toLowerCase();
+}
+/** Merged exclusion set (normalized): built-in dev artifacts + configured sensitive folders. */
+export const EXCLUDED_FOLDER_NAMES = new Set([...BUILTIN_EXCLUDES, ...getConfig().drive.excludeFolders].map(normalizeFolderName));
+/** True if this single folder name is excluded. */
+export function isExcludedName(name) {
+    return !!name && EXCLUDED_FOLDER_NAMES.has(normalizeFolderName(name));
+}
+/**
+ * True if any path segment matches an excluded folder name.
+ * Segment-wise (not includes()) so e.g. "rebuild.md" doesn't match "build".
+ */
+export function isExcludedPath(path) {
+    return path.split('/').some((seg) => isExcludedName(seg));
+}
+//# sourceMappingURL=exclude.js.map

package/dist/plugins/drive/exclude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclude.js","sourceRoot":"","sources":["../../../src/plugins/drive/exclude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,gBAAgB,GAAG;IACvB,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa;IACvD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe;IAChE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa;CAC/D,CAAC;AAEF,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAC1C,CAAC,GAAG,gBAAgB,EAAE,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CACpF,CAAC;AAEF,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,IAA+B;IAC5D,OAAO,CAAC,CAAC,IAAI,IAAI,qBAAqB,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/plugins/drive/extract_text.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 문서 형식별 텍스트 추출 router. 벡터 색인 전처리.
+ *
+ * 무료 추출 (OCR 불필요):
+ *   - text/markdown, text/plain      → 그대로
+ *   - Google Docs                    → Drive export text/markdown
+ *   - Google Sheets                  → Drive export text/csv
+ *   - Google Slides                  → Drive export text/plain
+ *   - Word .docx                     → ooxml.ts (zip 안 XML 의 문단 텍스트)
+ *   - PDF (digital)                  → pdf-parse (텍스트 레이어)
+ *
+ * OCR 필요 (후속 — Mathpix):
+ *   - PDF (스캔본, 텍스트 부족)        → Mathpix
+ *   - .pptx / image                  → Mathpix / Gemini multimodal
+ *
+ * lazy import (pdf-parse, xlsx) — 필요 시에만 로드.
+ */
+import type { DriveClient } from './client.js';
+export interface ExtractResult {
+    text: string;
+    method: string;
+    needsOcr?: boolean;
+    meta?: Record<string, unknown>;
+}
+/** 추출 + 정제 (노이즈 cleanup). 색인·검색 진입점. */
+export declare function extractText(drive: DriveClient, fileId: string, mimeType: string): Promise<ExtractResult>;

package/dist/plugins/drive/extract_text.js

@@ -0,0 +1,95 @@
+import { cleanExtractedText } from './clean_text.js';
+/** 스캔본 판정 threshold — 페이지당 평균 글자 수 */
+const MIN_CHARS_PER_PAGE = 80;
+async function downloadText(drive, fileId) {
+    const r = await drive.files.get({ fileId, alt: 'media', supportsAllDrives: true }, { responseType: 'text' });
+    return r.data;
+}
+async function downloadBuffer(drive, fileId) {
+    const r = await drive.files.get({ fileId, alt: 'media', supportsAllDrives: true }, { responseType: 'arraybuffer' });
+    return Buffer.from(r.data);
+}
+async function exportGoogle(drive, fileId, mimeType) {
+    const r = await drive.files.export({ fileId, mimeType }, { responseType: 'text' });
+    return r.data;
+}
+/** 추출 + 정제 (노이즈 cleanup). 색인·검색 진입점. */
+export async function extractText(drive, fileId, mimeType) {
+    const raw = await extractRaw(drive, fileId, mimeType);
+    return { ...raw, text: cleanExtractedText(raw.text) };
+}
+/** 형식별 원본 추출 (정제 전). */
+async function extractRaw(drive, fileId, mimeType) {
+    // 1. Native text
+    if (mimeType === 'text/markdown' || mimeType === 'text/plain') {
+        return { text: await downloadText(drive, fileId), method: 'native' };
+    }
+    // 2. Google Workspace — Drive export (무료)
+    if (mimeType === 'application/vnd.google-apps.document') {
+        return { text: await exportGoogle(drive, fileId, 'text/markdown'), method: 'gdoc→md' };
+    }
+    if (mimeType === 'application/vnd.google-apps.spreadsheet') {
+        return { text: await exportGoogle(drive, fileId, 'text/csv'), method: 'gsheet→csv' };
+    }
+    if (mimeType === 'application/vnd.google-apps.presentation') {
+        return { text: await exportGoogle(drive, fileId, 'text/plain'), method: 'gslide→txt' };
+    }
+    // 3. Word .docx — 의존성 없는 zip/XML 읽기 (ooxml.ts). 문단 사이 빈 줄 — 예전 mammoth extractRawText 와 같은 모양
+    if (mimeType.includes('wordprocessingml')) {
+        const { docxText } = await import('./ooxml.js');
+        const buffer = await downloadBuffer(drive, fileId);
+        return { text: docxText(buffer), method: 'docx→ooxml' };
+    }
+    // 4. PDF — pdf-parse v2. digital 텍스트, 스캔본(<MIN) 은 Mathpix OCR fallback
+    if (mimeType === 'application/pdf') {
+        const buffer = await downloadBuffer(drive, fileId);
+        const { PDFParse } = (await import('pdf-parse'));
+        const parser = new PDFParse({ data: new Uint8Array(buffer) });
+        let text = '';
+        let pages = 1;
+        try {
+            const result = await parser.getText();
+            text = result.text ?? '';
+            pages = result.total ?? 1;
+        }
+        finally {
+            await parser.destroy();
+        }
+        const charsPerPage = text.replace(/\s/g, '').length / Math.max(pages, 1);
+        if (charsPerPage >= MIN_CHARS_PER_PAGE) {
+            return { text, method: 'pdf-parse', meta: { pages, charsPerPage: Math.round(charsPerPage) } };
+        }
+        // 스캔본 → Mathpix OCR
+        const { mathpixPdfToMarkdown } = await import('./mathpix.js');
+        const md = await mathpixPdfToMarkdown(buffer);
+        return {
+            text: md,
+            method: 'pdf→mathpix-ocr',
+            meta: { pages, charsPerPage: Math.round(charsPerPage), ocr: true },
+        };
+    }
+    // 5. PowerPoint .pptx → 슬라이드마다 "## Slide N" + 본문 + 발표자 노트 (ooxml.ts)
+    if (mimeType.includes('presentationml')) {
+        const { pptxText } = await import('./ooxml.js');
+        const buffer = await downloadBuffer(drive, fileId);
+        return { text: pptxText(buffer), method: 'pptx→ooxml' };
+    }
+    // 6. Excel .xlsx → SheetJS (시트별 csv)
+    if (mimeType.includes('spreadsheetml')) {
+        const XLSX = await import('xlsx');
+        const buffer = await downloadBuffer(drive, fileId);
+        const wb = XLSX.read(buffer, { type: 'buffer' });
+        const text = wb.SheetNames.map((n) => `## ${n}\n${XLSX.utils.sheet_to_csv(wb.Sheets[n])}`).join('\n\n');
+        return { text, method: 'xlsx→sheetjs' };
+    }
+    // 7. 이미지 → Mathpix OCR (v3/text, 즉시)
+    if (mimeType.startsWith('image/')) {
+        const buffer = await downloadBuffer(drive, fileId);
+        const { mathpixImageToMarkdown } = await import('./mathpix.js');
+        const md = await mathpixImageToMarkdown(buffer, mimeType);
+        return { text: md, method: 'image→mathpix' };
+    }
+    // 8. 미지원
+    return { text: '', method: `unsupported:${mimeType}`, needsOcr: true };
+}
+//# sourceMappingURL=extract_text.js.map

package/dist/plugins/drive/extract_text.js.map

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

package/dist/plugins/drive/get_token.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `knowledge-mcp drive get-token` — opens Google sign-in and prints a Drive refresh token.
+ * The token is written with process.stdout.write: console output is masked and would hide it.
+ */
+export declare function runGetToken(): Promise<void>;