@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.0

package/dist/plugins/slack/index.js

@@ -0,0 +1,80 @@
+/**
+ * Slack plugin — read-only: channel map, channel history with threads, files, and message search.
+ *
+ *   SLACK_BOT_TOKEN  (xoxb-…)  every tool; the bot only sees channels it was invited to
+ *   SLACK_USER_TOKEN (xoxp-…)  slack_search as well (results are limited to the bot's channels)
+ * The two never stand in for each other — see api.ts.
+ */
+import { parseArgs } from 'node:util';
+import { definePlugin } from '../../plugin/define.js';
+import { getStore } from '../../store/index.js';
+import { slackBotToken, slackUserToken } from './api.js';
+import { slackListChannelsTool } from './tools/slack_list_channels.js';
+import { slackReadChannelTool } from './tools/slack_read_channel.js';
+import { slackFindFilesTool, slackGetFileTool } from './tools/slack_files.js';
+import { slackSearchTool } from './tools/slack_search.js';
+const BOT = 'set SLACK_BOT_TOKEN (xoxb-…)';
+/** `knowledge-mcp slack channels` — the purpose map that slack_list_channels shows. */
+async function listChannels() {
+    const rows = await (await getStore()).listSlackChannels();
+    if (!rows.length) {
+        console.error('No channels yet. Call slack_list_channels once (it syncs from Slack), then set purposes here.');
+        return;
+    }
+    for (const r of rows) {
+        process.stdout.write(`${r.enabled ? 'on ' : 'off'}  #${r.channel_name.padEnd(28)} ${(r.channel_id ?? '-').padEnd(12)} ${r.category ?? ''}  ${r.purpose}\n`);
+    }
+}
+/** `knowledge-mcp slack channel <#name|id> [--purpose P] [--category C] [--on|--off] [--order N]` */
+async function editChannel(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            purpose: { type: 'string' },
+            category: { type: 'string' },
+            on: { type: 'boolean' },
+            off: { type: 'boolean' },
+            order: { type: 'string' },
+        },
+    });
+    const target = positionals[0]?.replace(/^#/, '');
+    if (!target)
+        throw new Error('usage: knowledge-mcp slack channel <#name|id> [--purpose P] [--category C] [--on|--off] [--order N]');
+    const store = await getStore();
+    const row = (await store.listSlackChannels()).find((r) => r.channel_id === target || r.channel_name === target);
+    if (!row)
+        throw new Error(`channel ${target} is not in the map yet — call slack_list_channels once to sync it`);
+    const patch = {};
+    if (values.purpose !== undefined)
+        patch.purpose = values.purpose;
+    if (values.category !== undefined)
+        patch.category = values.category || null;
+    if (values.on)
+        patch.enabled = true;
+    if (values.off)
+        patch.enabled = false;
+    if (values.order !== undefined)
+        patch.sort_order = Number(values.order);
+    await store.updateSlackChannel(row.id, patch);
+    console.error(`Updated #${row.channel_name}. slack_list_channels shows it within SLACK_LIST_CACHE_TTL_MS (default 60s).`);
+}
+export const slackPlugin = definePlugin({
+    id: 'slack',
+    description: 'Slack channels, threads, files and search (read-only)',
+    enabled: () => !!slackBotToken() || BOT,
+    tools: [
+        slackListChannelsTool,
+        slackReadChannelTool,
+        slackFindFilesTool,
+        slackGetFileTool,
+        { ...slackSearchTool, enabled: () => !!slackUserToken() || 'set SLACK_USER_TOKEN (xoxp-…) for search' },
+    ],
+    instructions: 'Slack: start with slack_list_channels to see which channels exist and which the bot can read; ' +
+        'latest discussion → slack_search (sort="timestamp" for recency) or slack_read_channel.',
+    commands: {
+        channels: { description: 'list the channel purpose map', run: () => listChannels() },
+        channel: { description: 'edit one channel: --purpose, --category, --on/--off, --order', run: (args) => editChannel(args) },
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/plugins/slack/index.js.map

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

package/dist/plugins/slack/tools/slack_files.d.ts

@@ -0,0 +1,87 @@
+/**
+ * slack_find_files / slack_get_file — Slack 파일 검색 + 다운로드 (read-only).
+ *
+ * - slack_find_files: query 있으면 search.files(User token), 없으면 files.list(Bot token, 필터).
+ * - slack_get_file:   files.info 메타 + 텍스트 파일이면 본문 다운로드.
+ * 권한 그룹: slack. 채널 범위는 app_users.allowed_slack_channels.
+ */
+import { z } from 'zod';
+declare const findInput: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    count: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    channel?: string | undefined;
+    query?: string | undefined;
+    user?: string | undefined;
+}, {
+    count?: number | undefined;
+    channel?: string | undefined;
+    query?: string | undefined;
+    user?: string | undefined;
+}>;
+export declare const slackFindFilesTool: import("../../../plugin/define.js").Tool<z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    count: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    channel?: string | undefined;
+    query?: string | undefined;
+    user?: string | undefined;
+}, {
+    count?: number | undefined;
+    channel?: string | undefined;
+    query?: string | undefined;
+    user?: string | undefined;
+}>>;
+export declare function handleSlackFindFiles(args: z.infer<typeof findInput>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+declare const getInput: z.ZodObject<{
+    fileId: z.ZodString;
+    maxBytes: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fileId: string;
+    maxBytes: number;
+}, {
+    fileId: string;
+    maxBytes?: number | undefined;
+}>;
+export declare const slackGetFileTool: import("../../../plugin/define.js").Tool<z.ZodObject<{
+    fileId: z.ZodString;
+    maxBytes: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fileId: string;
+    maxBytes: number;
+}, {
+    fileId: string;
+    maxBytes?: number | undefined;
+}>>;
+export declare function handleSlackGetFile(args: z.infer<typeof getInput>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};

package/dist/plugins/slack/tools/slack_files.js

@@ -0,0 +1,204 @@
+/**
+ * slack_find_files / slack_get_file — Slack 파일 검색 + 다운로드 (read-only).
+ *
+ * - slack_find_files: query 있으면 search.files(User token), 없으면 files.list(Bot token, 필터).
+ * - slack_get_file:   files.info 메타 + 텍스트 파일이면 본문 다운로드.
+ * 권한 그룹: slack. 채널 범위는 app_users.allowed_slack_channels.
+ */
+import { z } from 'zod';
+import { defineTool } from '../../../plugin/define.js';
+import { getAuth } from '../../../core/context.js';
+import { allowedSlackChannels } from '../../../core/scope.js';
+import { slackApi, downloadSlackFile, isTextualMime, SlackError, loadBotMemberChannelIds, } from '../api.js';
+/* ── slack_find_files ─────────────────────────────────── */
+const findInput = z.object({
+    query: z.string().optional().describe('선택. 파일명/내용 키워드 검색 (User token 필요).'),
+    channel: z.string().optional().describe('선택. 채널 ID(C…) 로 필터 (목록 모드).'),
+    user: z.string().optional().describe('선택. 업로더 user ID 로 필터 (목록 모드).'),
+    count: z.number().int().min(1).max(50).default(20).describe('최대 결과 수 (1-50). default 20.'),
+});
+export const slackFindFilesTool = defineTool({
+    name: 'slack_find_files',
+    description: 'Slack 파일을 검색/목록. query 가 있으면 키워드 검색(User token — 봇이 멤버인 채널에 공유된 파일만), ' +
+        '없으면 채널/유저 필터로 목록(Bot token — 봇이 초대된 대화). ' +
+        '결과의 fileId 를 slack_get_file 에 넘겨 본문 다운로드.',
+    input: findInput,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleSlackFindFiles(args),
+});
+/** 파일이 공유된 모든 대화 ID (공개 채널 + 비공개 그룹 + DM). 직원 채널 scope 판정용. */
+function fileConversationIds(f) {
+    return [...(f.channels ?? []), ...(f.groups ?? []), ...(f.ims ?? [])];
+}
+/**
+ * 직원 채널 scope 안에서 이 파일이 보이는가. scope=null(admin·미설정)=전체 허용.
+ * 보수적(over-deny): 파일이 공유된 대화가 scope 와 하나도 겹치지 않으면 제한 직원에게 노출하지 않는다.
+ */
+function fileInScope(f, scope) {
+    if (!scope)
+        return true;
+    return fileConversationIds(f).some((id) => scope.has(id));
+}
+function mapFile(f) {
+    return {
+        fileId: f.id,
+        name: f.name ?? f.title ?? '(이름 없음)',
+        title: f.title ?? null,
+        mimetype: f.mimetype ?? null,
+        filetype: f.filetype ?? null,
+        size: f.size ?? null,
+        created: f.created ? new Date(f.created * 1000).toISOString() : null,
+        uploader: f.user ?? null,
+        channels: f.channels ?? [],
+        permalink: f.permalink ?? null,
+    };
+}
+export async function handleSlackFindFiles(args) {
+    const auth = getAuth();
+    const { query, channel, user, count } = args;
+    const channelScope = allowedSlackChannels(auth);
+    // 채널 scope 제한 직원이 scope 밖 channel 을 명시 필터하면 거부 (slack_read_channel 과 동일).
+    if (channelScope && channel && !channelScope.has(channel)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[forbidden] 채널 '${channel}' 은 현재 직원 권한으로 접근 불가입니다.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        let files;
+        let mode;
+        if (query && query.trim().length > 0) {
+            mode = 'search.files';
+            const res = await slackApi('search.files', { query, count }, 'search');
+            // search.files 는 User token(xoxp) 권한 — 토큰 소유자의 DM·비공개 채널 파일까지 보인다.
+            // 노출 표면 = "봇이 멤버인 채널에 공유된 파일"(slack_search 와 동일 신뢰 경계, 2026-06-19).
+            //   - 비공개 채널 공유 파일은 file.groups 에 담긴다 — 과거 channels>0
+            //     필터는 이를 전부 떨궈 파일 검색이 사실상 0건이었다.
+            //   - DM 전용 파일(ims): conversations.list 에 없는 D… id → botMemberIds 에 부재 → 자연 제외.
+            //   - 봇 미초대 비공개 채널 파일: 허가 안 됨 → 제외.
+            // files.list(bot token) 모드는 봇이 초대된 대화만 보이므로 이 제한이 자동 적용된다.
+            const botMemberIds = await loadBotMemberChannelIds();
+            files = (res.files?.matches ?? []).filter((f) => fileConversationIds(f).some((id) => botMemberIds.has(id)));
+        }
+        else {
+            mode = 'files.list';
+            const res = await slackApi('files.list', { channel, user, count }, 'bot');
+            // files.list 는 봇에게 온 DM 파일까지 돌려준다 — 검색 모드와 같은 경계(봇 멤버 채널에 공유된 파일)로 거른다.
+            const botMemberIds = await loadBotMemberChannelIds();
+            files = (res.files ?? []).filter((f) => fileConversationIds(f).some((id) => botMemberIds.has(id)));
+        }
+        // 직원별 Slack 채널 scope 필터 (admin·미설정 = 전체). scope 밖 대화의 파일 제거.
+        const visible = files.filter((f) => fileInScope(f, channelScope));
+        const filteredOut = files.length - visible.length;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ mode, count: visible.length, filteredOut, files: visible.map(mapFile) }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof SlackError ? e.message : e instanceof Error ? e.message : String(e);
+        return {
+            content: [{ type: 'text', text: `[error] ${msg}` }],
+            isError: true,
+        };
+    }
+}
+/* ── slack_get_file ───────────────────────────────────── */
+const getInput = z.object({
+    fileId: z.string().min(1).describe('Slack 파일 ID (예: F0123ABCD).'),
+    maxBytes: z.number().int().min(1).max(1_000_000).default(200_000).describe('텍스트 본문 최대 바이트 (default 200000).'),
+});
+export const slackGetFileTool = defineTool({
+    name: 'slack_get_file',
+    description: 'Slack 파일 1개의 메타데이터 + 본문을 가져온다. 텍스트 파일(.md/.txt/.csv/.json/코드)은 ' +
+        '본문을 반환하고, 이미지·PDF 등 바이너리는 메타 + 다운로드 URL 만 반환. ' +
+        'fileId 는 slack_find_files 결과에서 얻는다.',
+    input: getInput,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleSlackGetFile(args),
+});
+export async function handleSlackGetFile(args) {
+    const auth = getAuth();
+    const { fileId, maxBytes } = args;
+    const channelScope = allowedSlackChannels(auth);
+    try {
+        const res = await slackApi('files.info', { file: fileId }, 'bot');
+        const f = res.file;
+        if (!f) {
+            return {
+                content: [{ type: 'text', text: `[not found] file ${fileId}` }],
+                isError: true,
+            };
+        }
+        // 신뢰 경계: 봇이 멤버인 채널에 공유된 파일만 (DM 전용 파일 차단 — find_files 와 동일).
+        const botMemberIds = await loadBotMemberChannelIds();
+        if (!fileConversationIds(f).some((id) => botMemberIds.has(id))) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `[forbidden] 파일 '${fileId}' 은 봇이 멤버인 채널에 공유된 파일이 아닙니다.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // 직원별 Slack 채널 scope: 이 파일이 보이는 대화가 전부 권한 밖이면 거부.
+        if (!fileInScope(f, channelScope)) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `[forbidden] 파일 '${fileId}' 은 현재 직원 권한으로 접근 불가입니다 (허용 채널 밖).`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const meta = mapFile(f);
+        const textual = isTextualMime(f.mimetype, f.filetype);
+        const downloadUrl = f.url_private_download;
+        if (textual && downloadUrl) {
+            const dl = await downloadSlackFile(downloadUrl, { asText: true, maxBytes });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ ...meta, bytes: dl.bytes, truncated: dl.truncated, content: dl.text ?? '' }, null, 2),
+                    },
+                ],
+            };
+        }
+        // 바이너리 — 메타 + 다운로드 URL (Bearer 인증 필요 안내)
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...meta,
+                        binary: true,
+                        note: '바이너리 파일 — 본문 미포함. downloadUrl 은 Authorization: Bearer <SLACK token> 헤더로 받아야 함.',
+                        downloadUrl: downloadUrl ?? null,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof SlackError ? e.message : e instanceof Error ? e.message : String(e);
+        return {
+            content: [{ type: 'text', text: `[error] ${msg}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=slack_files.js.map

package/dist/plugins/slack/tools/slack_files.js.map

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

package/dist/plugins/slack/tools/slack_list_channels.d.ts

@@ -0,0 +1,46 @@
+/**
+ * slack_list_channels(enabledOnly?) — Slack 채널 지형(용도 매핑) 반환 + 자동 동기화.
+ *
+ * 데이터: 저장소 `slack_channels`(용도 매핑, single source — SQLite 파일 또는 Supabase)
+ *         + Slack `conversations.list`(실시간 채널·멤버십) join.
+ *
+ * 자동 동기화 (호출 시 lazy — 변경분이 있을 때만 write):
+ *   - 기존 채널 이름 변경  → channel_name 갱신 (channel_id 가 매칭 기준이라 이름이 바뀌어도 안 깨짐)
+ *   - channel_id 미기록 행 → 이름으로 매칭해 channel_id backfill (최초 1회 정착)
+ *   - 신규 채널           → enabled=false 로 추가 (사람이 `knowledge-mcp slack channel` 명령이나
+ *                           Supabase 표에서 purpose 를 채우고 켜면 노출)
+ * bot_can_read 판정도 channel_id 기준 — 이름 변경에 강건.
+ *
+ * 봇/챗봇은 Slack 관련 질문에서 이 툴을 먼저 호출해 "어느 채널이 무슨 용도인지,
+ * 봇이 읽을 수 있는지(bot_can_read)" 를 파악한 뒤 slack_search(in:#채널) /
+ * slack_read_channel 을 타겟팅한다. 두 도구 모두 봇이 멤버인 채널만 돌려준다.
+ */
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    enabledOnly: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    enabledOnly: boolean;
+}, {
+    enabledOnly?: boolean | undefined;
+}>;
+export declare const slackListChannelsTool: import("../../../plugin/define.js").Tool<z.ZodObject<{
+    enabledOnly: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    enabledOnly: boolean;
+}, {
+    enabledOnly?: boolean | undefined;
+}>>;
+export declare function handleSlackListChannels(args: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};

package/dist/plugins/slack/tools/slack_list_channels.js

@@ -0,0 +1,197 @@
+/**
+ * slack_list_channels(enabledOnly?) — Slack 채널 지형(용도 매핑) 반환 + 자동 동기화.
+ *
+ * 데이터: 저장소 `slack_channels`(용도 매핑, single source — SQLite 파일 또는 Supabase)
+ *         + Slack `conversations.list`(실시간 채널·멤버십) join.
+ *
+ * 자동 동기화 (호출 시 lazy — 변경분이 있을 때만 write):
+ *   - 기존 채널 이름 변경  → channel_name 갱신 (channel_id 가 매칭 기준이라 이름이 바뀌어도 안 깨짐)
+ *   - channel_id 미기록 행 → 이름으로 매칭해 channel_id backfill (최초 1회 정착)
+ *   - 신규 채널           → enabled=false 로 추가 (사람이 `knowledge-mcp slack channel` 명령이나
+ *                           Supabase 표에서 purpose 를 채우고 켜면 노출)
+ * bot_can_read 판정도 channel_id 기준 — 이름 변경에 강건.
+ *
+ * 봇/챗봇은 Slack 관련 질문에서 이 툴을 먼저 호출해 "어느 채널이 무슨 용도인지,
+ * 봇이 읽을 수 있는지(bot_can_read)" 를 파악한 뒤 slack_search(in:#채널) /
+ * slack_read_channel 을 타겟팅한다. 두 도구 모두 봇이 멤버인 채널만 돌려준다.
+ */
+import { z } from 'zod';
+import { defineTool } from '../../../plugin/define.js';
+import { getAuth } from '../../../core/context.js';
+import { allowedSlackChannels } from '../../../core/scope.js';
+import { getStore } from '../../../store/index.js';
+import { slackApi } from '../api.js';
+const inputSchema = z.object({
+    enabledOnly: z
+        .boolean()
+        .default(true)
+        .describe('true(default) 면 활성 채널만. false 면 비활성(미분류 신규 포함) 포함.'),
+});
+export const slackListChannelsTool = defineTool({
+    name: 'slack_list_channels',
+    description: 'Returns the Slack channel landscape — each channel purpose and whether the bot can read it (bot_can_read). ' +
+        'Slack 관련 질문에서 가장 먼저 호출해 "어느 채널을 검색/읽을지" 판단하라. ' +
+        'bot_can_read=true 면 slack_read_channel·slack_search 로 읽기 가능, false 면 봇을 그 채널에 초대해야 읽거나 검색할 수 있다. ' +
+        '호출 시 Slack 실제 채널과 자동 동기화된다(이름 변경·신규 채널 반영). 용도 매핑은 서버 저장소의 slack_channels 에서 관리.',
+    input: inputSchema,
+    run: (args) => handleSlackListChannels(args),
+});
+// ── 응답 TTL 캐시 ──
+// 이 도구는 매 호출마다 conversations.list(Slack) + 동기화 write + DB read 를 수행한다.
+// 여러 사용자가 Slack 질문을 동시에 던지면 같은 작업이 중복되므로, 짧은 TTL 로 최종 응답을 캐시한다.
+// (채널 추가/이름변경 반영 지연은 최대 TTL 초 — lazy 동기화 특성상 허용 범위)
+const LIST_CACHE_TTL_MS = Number(process.env.SLACK_LIST_CACHE_TTL_MS ?? 60_000);
+const _listCache = new Map();
+/**
+ * conversations.list 결과로 slack_channels 동기화 (변경분만 write).
+ * graceful — 실패해도 throw 하지 않고 0 카운트 반환 (read 는 계속 진행).
+ */
+async function syncChannels(store, rows, live) {
+    const byId = new Map();
+    const byName = new Map();
+    for (const r of rows) {
+        if (r.channel_id)
+            byId.set(r.channel_id, r);
+        byName.set(r.channel_name, r);
+    }
+    const toInsert = [];
+    const toUpdate = [];
+    for (const c of live) {
+        const hit = byId.get(c.id);
+        if (hit) {
+            // 이미 id 로 정착된 채널 — 이름이 바뀌었으면 갱신
+            if (hit.channel_name !== c.name)
+                toUpdate.push({ id: hit.id, patch: { channel_name: c.name } });
+            continue;
+        }
+        const named = byName.get(c.name);
+        if (named && !named.channel_id) {
+            // 이름은 매칭되나 channel_id 미기록 — 최초 backfill
+            toUpdate.push({ id: named.id, patch: { channel_id: c.id } });
+            continue;
+        }
+        if (!named) {
+            // DB 에 없는 신규 채널 — 비활성으로 추가 (사람이 purpose 채우면 노출)
+            toInsert.push({ channel_id: c.id, channel_name: c.name, purpose: '', category: null, enabled: false, sort_order: 100 });
+        }
+    }
+    let inserted = 0;
+    let renamed = 0;
+    let linked = 0;
+    try {
+        if (toInsert.length) {
+            await store.insertSlackChannels(toInsert);
+            inserted = toInsert.length;
+        }
+        for (const u of toUpdate) {
+            await store.updateSlackChannel(u.id, u.patch);
+            if ('channel_name' in u.patch)
+                renamed++;
+            else
+                linked++;
+        }
+    }
+    catch {
+        /* sync 실패해도 매핑 read 는 진행 */
+    }
+    return { inserted, renamed, linked };
+}
+export async function handleSlackListChannels(args) {
+    // 저장소 read 의 네트워크 throw 가 [fatal] 로 누수하지 않게 graceful 래핑. 입력은 registry 가 검증했다.
+    try {
+        return await _handleSlackListChannels(args);
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `[error] 채널 목록 조회 일시 오류 (${e instanceof Error ? e.message : String(e)}).` }],
+            isError: true,
+        };
+    }
+}
+async function _handleSlackListChannels(args) {
+    const auth = getAuth();
+    const { enabledOnly } = args;
+    const channelScope = allowedSlackChannels(auth);
+    // 캐시 hit — Slack 호출·동기화·DB read 전부 skip. scope 있는 직원은 캐시 오염 방지 위해 skip.
+    const cacheKey = enabledOnly ? 'enabled' : 'all';
+    if (!channelScope) {
+        const cached = _listCache.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            return { content: [{ type: 'text', text: cached.text }] };
+        }
+    }
+    const store = await getStore();
+    // 1. 저장소의 현재 매핑 (sync 비교용 — enabled 무관 전체)
+    let rows;
+    try {
+        rows = await store.listSlackChannels();
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `[error] slack_channels 조회 실패: ${e instanceof Error ? e.message : String(e)}` }],
+            isError: true,
+        };
+    }
+    // 2. 실시간 채널 (Slack 안 되면 매핑만 반환 — graceful). cursor 로 끝까지 — Slack 은 limit 보다
+    //    적게 주고 cursor 를 줄 수 있어, 첫 페이지만 보면 뒤 채널이 bot_can_read=false 로 잘못 나온다.
+    const live = [];
+    try {
+        let cursor;
+        for (let page = 0; page < 15; page++) {
+            const r = await slackApi('conversations.list', { types: 'public_channel,private_channel', limit: 1000, exclude_archived: true, cursor }, 'bot');
+            for (const c of r.channels ?? []) {
+                if (c.id && c.name)
+                    live.push({ id: c.id, name: c.name, is_member: !!c.is_member });
+            }
+            cursor = r.response_metadata?.next_cursor || undefined;
+            if (!cursor)
+                break;
+        }
+    }
+    catch {
+        /* slack 토큰/스코프 문제여도 매핑은 반환 */
+    }
+    // 3. 자동 동기화 (live 가 있을 때만 — 빈 응답으로 DB 를 망가뜨리지 않게)
+    let synced = { inserted: 0, renamed: 0, linked: 0 };
+    if (live.length > 0) {
+        synced = await syncChannels(store, rows, live);
+    }
+    // 4. 동기화로 바뀐 게 있으면 반영본 재조회
+    let outRows = rows;
+    if (synced.inserted || synced.renamed || synced.linked) {
+        outRows = await store.listSlackChannels().catch(() => rows);
+    }
+    if (enabledOnly)
+        outRows = outRows.filter((r) => r.enabled);
+    // 직원별 Slack 채널 scope (admin·미설정 = 전체). channel_id 기준.
+    if (channelScope)
+        outRows = outRows.filter((r) => r.channel_id && channelScope.has(r.channel_id));
+    // 5. bot_can_read — channel_id 기준 (이름 변경에 강건), 미링크 행은 이름 fallback
+    const liveById = new Map();
+    const liveByName = new Map();
+    for (const c of live) {
+        liveById.set(c.id, c.is_member);
+        liveByName.set(c.name, c.is_member);
+    }
+    const channels = outRows.map((r) => ({
+        channel: `#${r.channel_name}`,
+        purpose: r.purpose,
+        category: r.category,
+        bot_can_read: r.channel_id ? !!liveById.get(r.channel_id) : !!liveByName.get(r.channel_name),
+        enabled: r.enabled,
+    }));
+    const syncNote = synced.inserted || synced.renamed || synced.linked
+        ? ` (동기화: 신규 ${synced.inserted}·이름갱신 ${synced.renamed}·id연결 ${synced.linked})`
+        : '';
+    const text = JSON.stringify({
+        count: channels.length,
+        note: 'bot_can_read=true → slack_read_channel·slack_search 가능. false → 봇 초대 필요.' + syncNote,
+        channels,
+    }, null, 2);
+    // Slack 응답이 정상일 때만 캐시 (live 비었으면 일시 장애일 수 있어 캐시 안 함 → 다음 호출 재시도)
+    if (live.length > 0 && !channelScope) {
+        _listCache.set(cacheKey, { text, expiresAt: Date.now() + LIST_CACHE_TTL_MS });
+    }
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=slack_list_channels.js.map

package/dist/plugins/slack/tools/slack_list_channels.js.map

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