@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.0

package/dist/plugins/drive/tools/list_drive_folder.js

@@ -0,0 +1,221 @@
+/**
+ * list_drive_folder — Drive 폴더 자식 list (배치 + 재귀 depth).
+ *
+ * 배치/재귀: 폴더 N개·하위 트리를 1회 호출로. 에이전트가 폴더마다 순차 호출(= per-call
+ *   네트워크 floor + 그 사이 LLM 추론 턴 ×N)하던 것을 1회로 접어 체감 지연을 N→1 로 줄인다.
+ *   read_drive_file 의 fileIds 배치와 같은 패턴(서버가 Drive I/O 를 자기↔구글 빠른 망에서 병렬).
+ *
+ *   - folderNames[] / folderIds[] : 서로 다른 위치의 폴더 여러 개를 병렬 list.
+ *   - depth (1~3)                 : 한 폴더의 하위 트리를 N단계까지 한 번에.
+ *     예) 고객사 10곳 + 각 폴더 문서 → list_drive_folder({ folderName: "01_고객사", depth: 2 }).
+ *
+ * 보안: 시작 폴더는 색인 root 하위이고 제외 폴더(PII·계약·HR 등)를 거치지 않을 때만 연다(read_drive_file 과 동일 가드).
+ *   이름으로 찾을 때도 root 하위 후보만 고른다. 재귀 walk 는 제외 폴더로 확산하지 않는다
+ *   (해당 폴더는 이름만 표기하고 자식 미전개 — excluded:true).
+ *
+ * 안전장치: 총 폴더 방문(=Drive list 호출) 상한 MAX_FOLDER_VISITS — 깊고 넓은 트리의 호출 폭발 방지.
+ */
+import { z } from 'zod';
+import { defineTool } from '../../../plugin/define.js';
+import { getDriveClient, escapeDriveQuery } from '../client.js';
+import { getAuth } from '../../../core/context.js';
+import { isExcludedName } from '../exclude.js';
+import { allowedDriveFolders, isPathInScope } from '../../../core/scope.js';
+import { classifyFolder } from '../path.js';
+const FOLDER_MIME = 'application/vnd.google-apps.folder';
+const MAX_FOLDER_VISITS = 120; // 재귀 폭발 방지 — 총 폴더 방문(list 호출) 상한
+const DESCRIPTION = 'Google Drive 폴더의 자식 파일·폴더 list. folderId/folderName(단일) 또는 folderIds/folderNames(여러 개 한 번에). ' +
+    '**"고객사 전부/명단", "X 폴더에 뭐 있어" 같은 전수·구조 질문은 semantic_search 가 아니라 이 도구.** ' +
+    '**여러 폴더거나 하위까지 봐야 하면 폴더마다 따로 호출하지 말고 한 번에 묶어라:** ' +
+    'folderNames=[...] 로 여러 폴더를 병렬, 또는 depth(1~3)로 하위 트리까지 한 번에 ' +
+    '(예: 고객사 10곳 + 각 폴더 문서 → folderName="01_고객사", depth=2). ' +
+    'folderName 은 이름으로 ID 를 자동 resolve. 결과의 id 로 read_drive_file 호출해 원문 read.';
+const inputSchema = z
+    .object({
+    folderId: z.string().min(1).optional().describe('Drive folder ID (단일). "root" = My Drive 최상위.'),
+    folderName: z.string().min(1).optional().describe('폴더 이름 (단일, 예: "01_고객사"). ID 를 몰라도 이름으로 조회.'),
+    folderIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(20)
+        .optional()
+        .describe('여러 folder ID 를 한 번에 병렬 list (1~20). 순차 호출보다 훨씬 빠름.'),
+    folderNames: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(20)
+        .optional()
+        .describe('여러 폴더 이름을 한 번에 병렬 list (1~20). 순차 호출보다 훨씬 빠름.'),
+    depth: z
+        .number()
+        .int()
+        .min(1)
+        .max(3)
+        .default(1)
+        .describe('재귀 깊이 1~3. default 1(직속 자식만). 2=손자까지, 3=증손자까지 — 하위 트리를 1회 호출로 받는다.'),
+    pageSize: z.number().int().min(1).max(200).default(50).describe('폴더당 최대 자식 수 (1-200). default 50.'),
+})
+    .refine((v) => v.folderId || v.folderName || v.folderIds?.length || v.folderNames?.length, { message: 'folderId / folderName / folderIds / folderNames 중 하나는 필수' });
+export const listDriveFolderTool = defineTool({
+    name: 'list_drive_folder',
+    description: DESCRIPTION,
+    input: inputSchema,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleListDriveFolder(args),
+});
+const ALL_DRIVES = { supportsAllDrives: true, includeItemsFromAllDrives: true };
+/**
+ * folderName → 색인 root 하위의 열 수 있는 폴더 (Shared Drive 포함). 못 찾으면 null.
+ * 같은 이름 폴더가 여럿이면 root 밖·제외 경로 후보를 건너뛰고 처음 'ok' 인 것을 고른다.
+ */
+async function resolveFolderId(drive, name) {
+    const res = await drive.files.list({
+        q: `name = '${escapeDriveQuery(name)}' and mimeType = '${FOLDER_MIME}' and trashed = false`,
+        fields: 'files(id, name)',
+        pageSize: 10,
+        ...ALL_DRIVES,
+    });
+    for (const f of res.data.files ?? []) {
+        if (!f.id)
+            continue;
+        const c = await classifyFolder(drive, f.id);
+        if (c.cls === 'ok')
+            return { id: f.id, path: c.path };
+    }
+    return null;
+}
+/**
+ * 폴더 fid 의 자식을 list 하고, depthLeft 가 남으면 (제외 폴더를 제외하고) 자식 폴더를 병렬 재귀.
+ * 같은 레벨 폴더는 Promise.all 로 동시에 펼친다. budget 으로 총 방문 수를 캡.
+ */
+async function walkFolder(drive, fid, depthLeft, pageSize, budget) {
+    const res = await drive.files.list({
+        q: `'${escapeDriveQuery(fid)}' in parents and trashed = false`,
+        fields: 'nextPageToken, files(id, name, mimeType, modifiedTime, size)',
+        pageSize,
+        orderBy: 'folder, name',
+        ...ALL_DRIVES,
+    });
+    // pageSize 초과 자식이 더 있으면 hasMore — 예전엔 조용히 잘려 "전수 목록" 을 오인할 수 있었다.
+    const hasMore = !!res.data.nextPageToken;
+    const nodes = (res.data.files || []).map((f) => ({
+        id: f.id,
+        name: f.name,
+        mimeType: f.mimeType,
+        isFolder: f.mimeType === FOLDER_MIME,
+        modifiedTime: f.modifiedTime,
+        size: f.size,
+    }));
+    if (depthLeft <= 1)
+        return { children: nodes, hasMore };
+    // 자식 폴더 중 제외(PII/계약/HR/deprecated 등) 아닌 것만 재귀. 제외 폴더는 이름만 남기고 미전개.
+    const toRecurse = nodes.filter((n) => {
+        if (!n.isFolder)
+            return false;
+        if (isExcludedName(n.name)) {
+            n.excluded = true;
+            return false;
+        }
+        return true;
+    });
+    await Promise.all(toRecurse.map(async (n) => {
+        // check + increment 는 동기(중간 await 없음) → 병렬 콜백 간에도 cap 정확.
+        if (budget.visits >= MAX_FOLDER_VISITS) {
+            n.truncated = true;
+            return;
+        }
+        budget.visits += 1;
+        const sub = await walkFolder(drive, n.id, depthLeft - 1, pageSize, budget);
+        n.children = sub.children;
+        if (sub.hasMore)
+            n.childrenTruncated = true;
+    }));
+    return { children: nodes, hasMore };
+}
+/** 재귀 트리를 직원별 Drive 폴더 scope 로 후처리 필터. 폴더는 자식이 scope 에 걸리면 유지(하위 도달 보장). */
+function filterTreeByScope(nodes, parentPath, scope) {
+    return nodes.filter((n) => {
+        const p = parentPath ? `${parentPath}/${n.name ?? ''}` : n.name ?? '';
+        if (n.isFolder) {
+            if (n.children)
+                n.children = filterTreeByScope(n.children, p, scope);
+            return isPathInScope(p, scope) || (n.children !== undefined && n.children.length > 0);
+        }
+        return isPathInScope(p, scope);
+    });
+}
+export async function handleListDriveFolder(args) {
+    const auth = getAuth();
+    const { folderId, folderName, folderIds, folderNames, depth, pageSize } = args;
+    const drive = await getDriveClient();
+    const folderScope = allowedDriveFolders(auth);
+    // 단수 + 배치 입력을 루트 명세로 통합.
+    const rootSpecs = [];
+    if (folderId)
+        rootSpecs.push({ id: folderId });
+    if (folderName)
+        rootSpecs.push({ name: folderName });
+    for (const id of folderIds ?? [])
+        rootSpecs.push({ id });
+    for (const name of folderNames ?? [])
+        rootSpecs.push({ name });
+    const budget = { visits: rootSpecs.length }; // 루트도 방문 1회로 카운트
+    try {
+        const roots = await Promise.all(rootSpecs.map(async (spec) => {
+            let fid;
+            let rootPath;
+            if (spec.id) {
+                // 시작 폴더 가드 — 색인 root 하위 + 제외 폴더 미경유일 때만 연다.
+                const c = await classifyFolder(drive, spec.id);
+                if (c.cls !== 'ok') {
+                    return { folderId: spec.id, folderName: null, error: '[forbidden] 접근 범위 밖 폴더입니다 (색인 대상 root 밖 / 민감 폴더).' };
+                }
+                fid = spec.id;
+                rootPath = c.path;
+            }
+            else {
+                const resolved = await resolveFolderId(drive, spec.name);
+                if (!resolved) {
+                    return { folderId: null, folderName: spec.name, error: `폴더 "${spec.name}" 을 찾지 못함 (색인 대상 root 하위만 조회)` };
+                }
+                fid = resolved.id;
+                rootPath = resolved.path;
+            }
+            const rootWalk = await walkFolder(drive, fid, depth, pageSize, budget);
+            let items = rootWalk.children;
+            // 직원별 Drive 폴더 scope 후처리 (admin·미설정 = 전체). root 기준 경로로 트리 필터.
+            if (folderScope)
+                items = filterTreeByScope(items, rootPath, folderScope);
+            return {
+                folderId: fid,
+                folderName: spec.name ?? null,
+                count: items.length,
+                childrenTruncated: rootWalk.hasMore || undefined,
+                items,
+            };
+        }));
+        const truncated = budget.visits >= MAX_FOLDER_VISITS;
+        // 하위호환: 단일 루트 + depth=1 + 배치 미사용 → 기존 응답 형식 그대로(기존 호출자 무손상).
+        const isLegacy = !folderIds && !folderNames && depth === 1 && rootSpecs.length === 1;
+        if (isLegacy) {
+            const r = roots[0];
+            if ('error' in r && r.error) {
+                return { content: [{ type: 'text', text: `[error] ${r.error}` }], isError: true };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(r, null, 2) }] };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ rootCount: roots.length, depth, folderVisits: budget.visits, truncated, roots }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: 'text', text: `[error] ${msg}` }], isError: true };
+    }
+}
+//# sourceMappingURL=list_drive_folder.js.map

package/dist/plugins/drive/tools/list_drive_folder.js.map

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

package/dist/plugins/drive/tools/read_drive_file.d.ts

@@ -0,0 +1,66 @@
+/**
+ * read_drive_file(fileId | fileIds, maxChars?) — Drive 파일 본문 read.
+ *
+ * Markdown / text 는 raw media. Google Docs/Sheets/Slides 는 export.
+ *
+ * 배치: fileIds 로 여러 파일을 한 번에 **병렬** read.
+ *   순차 호출(파일당 MCP 왕복 + Drive API 2회)을 1회 호출로 합쳐 per-call 네트워크
+ *   floor 를 N→1 로 줄이고 Drive I/O 도 동시 처리. 원문 여러 개를 비교/요약할 때 핵심.
+ */
+import { z } from 'zod';
+declare const inputSchema: z.ZodEffects<z.ZodObject<{
+    fileId: z.ZodOptional<z.ZodString>;
+    fileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxChars: number;
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+    maxChars?: number | undefined;
+}>, {
+    maxChars: number;
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+    maxChars?: number | undefined;
+}>;
+export declare const readDriveFileTool: import("../../../plugin/define.js").Tool<z.ZodEffects<z.ZodObject<{
+    fileId: z.ZodOptional<z.ZodString>;
+    fileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxChars: number;
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+    maxChars?: number | undefined;
+}>, {
+    maxChars: number;
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    fileId?: string | undefined;
+    fileIds?: string[] | undefined;
+    maxChars?: number | undefined;
+}>>;
+export declare function handleReadDriveFile(args: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};

package/dist/plugins/drive/tools/read_drive_file.js

@@ -0,0 +1,206 @@
+/**
+ * read_drive_file(fileId | fileIds, maxChars?) — Drive 파일 본문 read.
+ *
+ * Markdown / text 는 raw media. Google Docs/Sheets/Slides 는 export.
+ *
+ * 배치: fileIds 로 여러 파일을 한 번에 **병렬** read.
+ *   순차 호출(파일당 MCP 왕복 + Drive API 2회)을 1회 호출로 합쳐 per-call 네트워크
+ *   floor 를 N→1 로 줄이고 Drive I/O 도 동시 처리. 원문 여러 개를 비교/요약할 때 핵심.
+ */
+import { z } from 'zod';
+import { defineTool } from '../../../plugin/define.js';
+import { getDriveClient } from '../client.js';
+import { getAuth } from '../../../core/context.js';
+import { allowedDriveFolders, isPathInScope } from '../../../core/scope.js';
+import { classifyAndPath } from '../path.js';
+import { extractText } from '../extract_text.js';
+import { getQdrantClient, DRIVE_COLLECTION } from '../qdrant.js';
+import { MAX_FILE_BYTES } from '../settings.js';
+const DESCRIPTION = 'Google Drive 파일 본문 read. markdown/text 는 raw, Google Docs/Sheets/Slides 는 export, ' +
+    '**PDF·Word(docx)·PowerPoint(pptx)·Excel(xlsx)·이미지는 본문 텍스트로 추출**(스캔 PDF·이미지는 OCR). ' +
+    'search_drive / semantic_search_drive 응답의 id (File ID) 사용. ' +
+    'semantic_search_drive 로 관련 청크를 찾은 뒤 원문 전체 맥락이 필요할 때 호출하는 2단계 검색의 2단계. ' +
+    '**여러 문서를 읽어야 하면 fileId 를 하나씩 여러 번 호출하지 말고 fileIds=[...] 로 한 번에 (병렬 — 순차보다 훨씬 빠름).** ' +
+    '큰 파일은 maxChars 로 truncate.';
+const inputSchema = z
+    .object({
+    fileId: z.string().min(1).optional().describe('Drive file ID (단일). fileIds 와 둘 중 하나.'),
+    fileIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(10)
+        .optional()
+        .describe('여러 Drive file ID 를 한 번에 병렬 read (1~10개). 순차 호출보다 훨씬 빠름. fileId 와 둘 중 하나.'),
+    maxChars: z.number().int().min(1000).max(200000).default(50000).describe('파일당 최대 반환 문자 수 (1000-200000). default 50000.'),
+})
+    .refine((d) => d.fileId || (d.fileIds && d.fileIds.length > 0), {
+    message: 'fileId 또는 fileIds 중 하나는 필수',
+});
+export const readDriveFileTool = defineTool({
+    name: 'read_drive_file',
+    description: DESCRIPTION,
+    input: inputSchema,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleReadDriveFile(args),
+});
+const GOOGLE_DOC_EXPORT = {
+    'application/vnd.google-apps.document': 'text/markdown',
+    'application/vnd.google-apps.spreadsheet': 'text/csv',
+    'application/vnd.google-apps.presentation': 'text/plain',
+};
+/** raw text 로 읽으면 깨지는 바이너리 — extract_text 파이프라인으로 본문 추출해야 하는 형식. */
+function isExtractableBinary(mime) {
+    return (mime === 'application/pdf' ||
+        mime.includes('wordprocessingml') || // .docx
+        mime.includes('presentationml') || // .pptx
+        mime.includes('spreadsheetml') || // .xlsx
+        mime.startsWith('image/'));
+}
+/**
+ * 색인된 파일이면 Qdrant 청크를 chunk_index 순으로 재조립해 원문 복원 — 색인 시 이미 추출(스캔본은 OCR)한
+ * 텍스트를 재사용하므로 재다운로드·재OCR 비용 0(스캔 PDF 를 읽을 때마다 Mathpix 를 다시 태우지 않음).
+ * 미색인이거나 조회 실패면 null(→ extract_text 폴백). 청크 overlap 접두("…") 는 best-effort 제거.
+ */
+async function reassembleFromIndex(fileId) {
+    try {
+        const res = await (await getQdrantClient()).scroll(DRIVE_COLLECTION, {
+            filter: { must: [{ key: 'file_id', match: { value: fileId } }] },
+            limit: 1000,
+            with_payload: true,
+            with_vector: false,
+        });
+        const chunks = (res.points ?? [])
+            .map((pt) => {
+            const p = pt.payload;
+            return {
+                content: typeof p?.content === 'string' ? p.content : null,
+                idx: typeof p?.chunk_index === 'number' ? p.chunk_index : 0,
+            };
+        })
+            .filter((c) => c.content !== null)
+            .sort((a, b) => a.idx - b.idx);
+        if (chunks.length === 0)
+            return null;
+        return chunks
+            .map((c, i) => {
+            if (i === 0 || !c.content.startsWith('…'))
+                return c.content;
+            const nl = c.content.indexOf('\n\n'); // overlap 접두(…tail\n\n) 제거
+            return nl >= 0 ? c.content.slice(nl + 2) : c.content;
+        })
+            .join('\n\n');
+    }
+    catch {
+        return null;
+    }
+}
+/** 파일 1개 read → 구조화 객체 (배치에서 파일별 에러 격리용으로 throw 대신 error 필드 반환). */
+async function readOne(drive, fileId, maxChars, folderScope) {
+    try {
+        const meta = await drive.files.get({
+            fileId,
+            fields: 'id, name, mimeType, parents, size, modifiedTime, webViewLink',
+        });
+        const m = meta.data;
+        const mimeType = m.mimeType || '';
+        if (mimeType === 'application/vnd.google-apps.folder') {
+            return { fileId, error: 'fileId is a folder. use list_drive_folder instead.' };
+        }
+        // 보안: dev/biz root 하위 + 제외 폴더(PII·계약·HR·deprecated) 미경유 + 직원 폴더 scope.
+        // search_drive / semantic_search_drive 와 동일 가드 — 임의 File ID 직접 입력으로
+        // 색인 대상 밖·민감 폴더·권한 밖 파일을 읽는 우회를 차단한다.
+        const { cls, path } = await classifyAndPath(drive, m.parents ?? undefined);
+        if (cls !== 'ok' || !isPathInScope(path, folderScope)) {
+            return {
+                fileId,
+                error: '[forbidden] 접근 범위 밖 파일입니다 (색인 대상 root 밖 / 민감 폴더 / 직원 권한 밖).',
+            };
+        }
+        // 크기 상한 — 파일을 통째로 메모리에 올리므로 거대한 파일(영상·대용량 PDF)이 서버를 죽이지 않게 막는다.
+        // 색인 재조립본이 있으면 그것으로 읽는다(재다운로드 없음). Google 문서는 size 가 없어 해당 없음.
+        const tooLarge = !!m.size && Number(m.size) > MAX_FILE_BYTES;
+        const tooLargeError = {
+            fileId,
+            error: `파일이 너무 커서 읽지 않습니다 (${m.size}B > ${MAX_FILE_BYTES}B, DRIVE_MAX_FILE_BYTES).`,
+        };
+        let body;
+        let extractMethod;
+        if (GOOGLE_DOC_EXPORT[mimeType]) {
+            const res = await drive.files.export({ fileId, mimeType: GOOGLE_DOC_EXPORT[mimeType] }, { responseType: 'text' });
+            body = String(res.data ?? '');
+        }
+        else if (isExtractableBinary(mimeType)) {
+            // PDF·docx·pptx·xlsx·image. 색인된 파일이면 Qdrant 청크 재조립(색인 시 추출·OCR 한 텍스트 재사용
+            // → 재다운로드·재OCR 0)을 우선. 미색인이면 extract_text 파이프라인(pdf-parse·mammoth·Mathpix OCR 등).
+            // 예전엔 바이너리를 String() 해 깨진 텍스트를 반환했다(검색 챗봇 PDF 읽기 실패의 원인).
+            const reassembled = await reassembleFromIndex(fileId);
+            if (reassembled && reassembled.trim()) {
+                body = reassembled;
+                extractMethod = 'index-reassembled';
+            }
+            else {
+                if (tooLarge)
+                    return tooLargeError;
+                const r = await extractText(drive, fileId, mimeType);
+                if (r.needsOcr || !r.text.trim()) {
+                    return {
+                        fileId,
+                        error: `본문 추출 불가/미지원입니다 (mimeType=${mimeType}). 스캔 품질이 낮거나 지원하지 않는 형식일 수 있습니다.`,
+                    };
+                }
+                body = r.text;
+                extractMethod = r.method;
+            }
+        }
+        else {
+            if (tooLarge)
+                return tooLargeError;
+            const res = await drive.files.get({ fileId, alt: 'media' }, { responseType: 'text' });
+            body = String(res.data ?? '');
+        }
+        let truncated = false;
+        if (body.length > maxChars) {
+            body = body.slice(0, maxChars);
+            truncated = true;
+        }
+        return {
+            meta: {
+                id: m.id,
+                name: m.name,
+                mimeType: m.mimeType,
+                size: m.size,
+                modifiedTime: m.modifiedTime,
+                viewUrl: m.webViewLink,
+                ...(extractMethod ? { extractMethod } : {}),
+            },
+            truncated,
+            charCount: body.length,
+            body,
+        };
+    }
+    catch (e) {
+        return { fileId, error: e instanceof Error ? e.message : String(e) };
+    }
+}
+export async function handleReadDriveFile(args) {
+    const auth = getAuth();
+    const { fileId, fileIds, maxChars } = args;
+    const drive = await getDriveClient();
+    const folderScope = allowedDriveFolders(auth);
+    // 배치: fileIds 면 병렬 read (per-call floor 1회 + Drive I/O 동시).
+    if (fileIds && fileIds.length > 0) {
+        const files = await Promise.all(fileIds.map((id) => readOne(drive, id, maxChars, folderScope)));
+        return {
+            content: [
+                { type: 'text', text: JSON.stringify({ count: files.length, files }, null, 2) },
+            ],
+        };
+    }
+    // 단일 (하위호환): 기존 응답 형식 유지.
+    const result = await readOne(drive, fileId, maxChars, folderScope);
+    if ('error' in result) {
+        return { content: [{ type: 'text', text: `[error] ${result.error}` }], isError: true };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+//# sourceMappingURL=read_drive_file.js.map

package/dist/plugins/drive/tools/read_drive_file.js.map

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

package/dist/plugins/drive/tools/search_drive.d.ts

@@ -0,0 +1,52 @@
+/**
+ * search_drive(query, mode?, mimeType?, pageSize?) — Google Drive 파일 검색.
+ *
+ * 권한 그룹: drive. 폴더 범위는 app_users.allowed_drive_folders. Drive 접근은 서버 자격증명.
+ */
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<["title", "fullText"]>>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    mode: "title" | "fullText";
+    pageSize: number;
+    mimeType?: string | undefined;
+}, {
+    query: string;
+    mimeType?: string | undefined;
+    mode?: "title" | "fullText" | undefined;
+    pageSize?: number | undefined;
+}>;
+export declare const searchDriveTool: import("../../../plugin/define.js").Tool<z.ZodObject<{
+    query: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<["title", "fullText"]>>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    mode: "title" | "fullText";
+    pageSize: number;
+    mimeType?: string | undefined;
+}, {
+    query: string;
+    mimeType?: string | undefined;
+    mode?: "title" | "fullText" | undefined;
+    pageSize?: number | undefined;
+}>>;
+export declare function handleSearchDrive(args: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};

package/dist/plugins/drive/tools/search_drive.js

@@ -0,0 +1,78 @@
+/**
+ * search_drive(query, mode?, mimeType?, pageSize?) — Google Drive 파일 검색.
+ *
+ * 권한 그룹: drive. 폴더 범위는 app_users.allowed_drive_folders. Drive 접근은 서버 자격증명.
+ */
+import { z } from 'zod';
+import { defineTool } from '../../../plugin/define.js';
+import { getDriveClient, escapeDriveQuery } from '../client.js';
+import { getAuth } from '../../../core/context.js';
+import { allowedDriveFolders, isPathInScope } from '../../../core/scope.js';
+import { classifyAndPath } from '../path.js';
+const DESCRIPTION = 'Google Drive 에서 파일 검색. mode="title" 은 파일명, "fullText" 는 본문까지. ' +
+    'Unified search across your indexed Drive assets. ' +
+    '검색 범위는 설정한 Drive root 하위로 한정되며, 설정의 제외 폴더(excludeFolders)를 거치는 파일은 결과에서 빠진다. ' +
+    'search → read_drive_file 순서로 사용.';
+const inputSchema = z.object({
+    query: z.string().min(1).describe('검색어'),
+    mode: z.enum(['title', 'fullText']).default('title').describe('"title" 또는 "fullText". default "title" (신뢰성 ↑).'),
+    mimeType: z.string().optional().describe('선택. 예: "text/markdown" 또는 "application/vnd.google-apps.folder"'),
+    pageSize: z.number().int().min(1).max(50).default(10).describe('최대 결과 수 (1-50). default 10.'),
+});
+export const searchDriveTool = defineTool({
+    name: 'search_drive',
+    description: DESCRIPTION,
+    input: inputSchema,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleSearchDrive(args),
+});
+export async function handleSearchDrive(args) {
+    const auth = getAuth();
+    const { query, mode, mimeType, pageSize } = args;
+    const drive = await getDriveClient();
+    const escaped = escapeDriveQuery(query);
+    let q = mode === 'fullText' ? `fullText contains '${escaped}'` : `name contains '${escaped}'`;
+    if (mimeType) {
+        q += ` and mimeType = '${escapeDriveQuery(mimeType)}'`;
+    }
+    q += ' and trashed = false';
+    try {
+        const res = await drive.files.list({
+            q,
+            fields: 'files(id, name, mimeType, parents, modifiedTime, size, webViewLink, owners(emailAddress))',
+            pageSize,
+            orderBy: 'modifiedTime desc',
+        });
+        const raw = (res.data.files || []).map((f) => ({
+            id: f.id,
+            name: f.name,
+            mimeType: f.mimeType,
+            parents: f.parents ?? undefined,
+            modifiedTime: f.modifiedTime,
+            size: f.size,
+            viewUrl: f.webViewLink,
+            owners: (f.owners || []).map((o) => o.emailAddress).filter(Boolean),
+        }));
+        // 보안: 민감/제외 폴더(PII·계약·HR·deprecated)·색인 대상 밖 제거 + 직원별 Drive 폴더 scope.
+        const folderScope = allowedDriveFolders(auth);
+        const cps = await Promise.all(raw.map((f) => classifyAndPath(drive, f.parents)));
+        const files = raw.filter((_, i) => cps[i].cls === 'ok' && (!folderScope || isPathInScope(cps[i].path, folderScope)));
+        const filtered = raw.length - files.length;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ count: files.length, mode, query, filteredOut: filtered, files }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            content: [{ type: 'text', text: `[error] ${msg}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=search_drive.js.map