@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.1

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

@@ -0,0 +1,56 @@
+/**
+ * slack_read_channel(channel, limit?, oldest?, includeThreads?) — 채널 대화 읽기.
+ *
+ * conversations.history 로 최근 메시지, 옵션으로 thread replies 까지.
+ * channel 은 이름(#dev / dev) 또는 ID(C…/G…) 허용 — 이름이면 conversations.list 로 resolve.
+ * Bot token 사용. 신뢰 경계 = "봇이 멤버인 채널"(slack_search 와 동일). DM(D…)·그룹 DM 은 읽지 않는다
+ * (봇에게 보낸 개인 DM 이 다른 사용자에게 열리는 것 방지).
+ * 권한 그룹: slack. 채널 범위는 app_users.allowed_slack_channels.
+ */
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    channel: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    oldest: z.ZodOptional<z.ZodString>;
+    includeThreads: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    channel: string;
+    limit: number;
+    includeThreads: boolean;
+    oldest?: string | undefined;
+}, {
+    channel: string;
+    limit?: number | undefined;
+    oldest?: string | undefined;
+    includeThreads?: boolean | undefined;
+}>;
+export declare const slackReadChannelTool: import("../../../plugin/define.js").Tool<z.ZodObject<{
+    channel: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    oldest: z.ZodOptional<z.ZodString>;
+    includeThreads: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    channel: string;
+    limit: number;
+    includeThreads: boolean;
+    oldest?: string | undefined;
+}, {
+    channel: string;
+    limit?: number | undefined;
+    oldest?: string | undefined;
+    includeThreads?: boolean | undefined;
+}>>;
+export declare function handleSlackReadChannel(args: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};

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

@@ -0,0 +1,150 @@
+/**
+ * slack_read_channel(channel, limit?, oldest?, includeThreads?) — 채널 대화 읽기.
+ *
+ * conversations.history 로 최근 메시지, 옵션으로 thread replies 까지.
+ * channel 은 이름(#dev / dev) 또는 ID(C…/G…) 허용 — 이름이면 conversations.list 로 resolve.
+ * Bot token 사용. 신뢰 경계 = "봇이 멤버인 채널"(slack_search 와 동일). DM(D…)·그룹 DM 은 읽지 않는다
+ * (봇에게 보낸 개인 DM 이 다른 사용자에게 열리는 것 방지).
+ * 권한 그룹: 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, SlackError, loadSlackUserMap, loadChannelNameMap, loadBotMemberChannelIds, mapLimit, } from '../api.js';
+const DESCRIPTION = 'Slack 채널의 최근 대화를 읽는다. channel 은 이름(#dev) 또는 ID(C…). ' +
+    '**기본으로 각 메시지의 thread 답글까지 함께 가져온다(includeThreads=true 기본).** ' +
+    'Slack discussions and decisions often live in thread replies, so ' +
+    '윗줄(부모 메시지)만 보면 맥락이 통째로 누락된다 — 답글까지 읽어야 실제 결론이 보인다. ' +
+    '윗줄만 빠르게 훑고 싶을 때만 includeThreads=false 로 끈다. ' +
+    '봇이 해당 채널 멤버여야 조회 가능 (비공개 채널은 초대 필요).';
+const inputSchema = z.object({
+    channel: z.string().min(1).describe('채널 이름(#dev 또는 dev) 또는 ID(C…).'),
+    limit: z.number().int().min(1).max(200).default(50).describe('메시지 수 (1-200). default 50.'),
+    oldest: z.string().optional().describe('선택. 이 시점 이후만 (YYYY-MM-DD 또는 Unix ts).'),
+    includeThreads: z
+        .boolean()
+        .default(true)
+        .describe('thread 답글 포함 여부. **default true** — 답글에 실제 논의가 담겨 있어 기본 포함. 부모 메시지만 빠르게 보려면 false.'),
+});
+export const slackReadChannelTool = defineTool({
+    name: 'slack_read_channel',
+    description: DESCRIPTION,
+    input: inputSchema,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleSlackReadChannel(args),
+});
+/** YYYY-MM-DD → Unix epoch 초. 이미 ts(숫자.숫자)면 그대로. */
+function toOldestTs(oldest) {
+    if (!oldest)
+        return undefined;
+    if (/^\d+(\.\d+)?$/.test(oldest))
+        return oldest;
+    const d = new Date(oldest);
+    if (isNaN(d.getTime()))
+        return undefined;
+    return String(Math.floor(d.getTime() / 1000));
+}
+async function resolveChannelId(input) {
+    // 이미 ID 형태 (공개 C… / 비공개 G…). DM(D…)은 받지 않는다.
+    if (/^D[A-Z0-9]{6,}$/.test(input))
+        throw new SlackError('DM 은 읽을 수 없습니다.');
+    if (/^[CG][A-Z0-9]{6,}$/.test(input))
+        return { id: input, name: null };
+    const cleaned = input.replace(/^#/, '');
+    // 공용 채널명 캐시(TTL) 조회 — 매 호출 conversations.list 순차 순회를 warmup 후 0콜로.
+    const byName = await loadChannelNameMap();
+    const found = byName.get(cleaned);
+    if (found)
+        return { id: found.id, name: found.name };
+    throw new SlackError(`채널 "${input}" 을 찾을 수 없음 (봇이 멤버가 아니거나 이름 오타).`);
+}
+// user-map·mapLimit 은 slack.ts 공용 버전(loadSlackUserMap·mapLimit) 사용 — 도구별 중복 구현·캐시
+// 분절을 제거해, search 가 데운 캐시를 read_channel 이 재사용(반대도)하고 users.list 왕복이 실질 제거.
+export async function handleSlackReadChannel(args) {
+    const auth = getAuth();
+    const { channel, limit, oldest, includeThreads } = args;
+    try {
+        const { id: channelId, name: channelName } = await resolveChannelId(channel);
+        // 신뢰 경계: 봇이 멤버인 (공개+비공개) 채널만. 그룹 DM(G…)·DM 은 conversations.list 에 없어 여기서 걸린다.
+        const botMemberIds = await loadBotMemberChannelIds();
+        if (!botMemberIds.has(channelId)) {
+            return {
+                content: [
+                    { type: 'text', text: `[forbidden] 채널 '${channel}' 은 봇이 멤버가 아닙니다. 봇을 채널에 초대해야 읽을 수 있습니다.` },
+                ],
+                isError: true,
+            };
+        }
+        // 직원별 Slack 채널 scope 체크 (admin·미설정 = 전체)
+        const channelScope = allowedSlackChannels(auth);
+        if (channelScope && !channelScope.has(channelId)) {
+            return {
+                content: [
+                    { type: 'text', text: `[forbidden] 채널 '${channel}' 은 현재 직원 권한으로 접근 불가입니다.` },
+                ],
+                isError: true,
+            };
+        }
+        // user map(캐시)과 채널 history 를 병렬 — 서로 독립. (예전엔 userMap 직렬 후 history)
+        const [userMap, hist] = await Promise.all([
+            loadSlackUserMap(),
+            slackApi('conversations.history', { channel: channelId, limit, oldest: toOldestTs(oldest) }, 'bot'),
+        ]);
+        const nameOf = (m) => m.user ? (userMap[m.user] ?? m.user) : (m.bot_id ? `bot:${m.bot_id}` : null);
+        // thread replies 를 동시성 6 으로 병렬(순차 N+1 제거). thread 하나 실패가 전체를 안 깨게 격리.
+        const messages = await mapLimit(hist.messages ?? [], 6, async (m) => {
+            const hasThread = !!m.thread_ts && (m.reply_count ?? 0) > 0;
+            const entry = {
+                ts: m.ts,
+                datetime: m.ts ? new Date(Number(m.ts) * 1000).toISOString() : null,
+                user: nameOf(m),
+                text: m.text ?? '',
+            };
+            // 부모 메시지면 답글 수를 항상 노출 — 확장이 꺼지거나 실패해도 "답글이 더 있다"는 신호는 남긴다.
+            if (hasThread)
+                entry.reply_count = m.reply_count;
+            if (includeThreads && hasThread) {
+                try {
+                    const rep = await slackApi('conversations.replies', { channel: channelId, ts: m.thread_ts, limit: 100 }, 'bot');
+                    // replies[0] == 부모 메시지 → 제외
+                    entry.replies = (rep.messages ?? []).slice(1).map((r) => ({
+                        ts: r.ts,
+                        datetime: r.ts ? new Date(Number(r.ts) * 1000).toISOString() : null,
+                        user: nameOf(r),
+                        text: r.text ?? '',
+                    }));
+                }
+                catch {
+                    // 한 thread 실패가 채널 읽기 전체를 깨지 않게. 단 빈 []로 숨기지 않고 명시 —
+                    // rate-limit 등으로 답글을 못 가져온 경우 "답글 0개"로 오인되지 않게 신호를 남긴다.
+                    entry.replies = [];
+                    entry.replies_error = true;
+                }
+            }
+            return entry;
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        channel: channelName ? `#${channelName}` : channelId,
+                        channelId,
+                        count: messages.length,
+                        includeThreads,
+                        messages,
+                    }, 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_read_channel.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * slack_search(query, count?) — Slack 워크스페이스 메시지 검색.
+ *
+ * search.messages API 사용 → User token (xoxp-…, search:read scope) 필수.
+ * 권한 그룹: slack. 결과는 봇이 멤버인 채널과 직원 채널 범위로 거른다.
+ */
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    count: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["score", "timestamp"]>>;
+    expandThreads: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    sort: "timestamp" | "score";
+    count: number;
+    query: string;
+    expandThreads: boolean;
+}, {
+    query: string;
+    sort?: "timestamp" | "score" | undefined;
+    count?: number | undefined;
+    expandThreads?: boolean | undefined;
+}>;
+export declare const slackSearchTool: import("../../../plugin/define.js").Tool<z.ZodObject<{
+    query: z.ZodString;
+    count: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["score", "timestamp"]>>;
+    expandThreads: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    sort: "timestamp" | "score";
+    count: number;
+    query: string;
+    expandThreads: boolean;
+}, {
+    query: string;
+    sort?: "timestamp" | "score" | undefined;
+    count?: number | undefined;
+    expandThreads?: boolean | undefined;
+}>>;
+export declare function handleSlackSearch(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_search.js

@@ -0,0 +1,132 @@
+/**
+ * slack_search(query, count?) — Slack 워크스페이스 메시지 검색.
+ *
+ * search.messages API 사용 → User token (xoxp-…, search:read scope) 필수.
+ * 권한 그룹: slack. 결과는 봇이 멤버인 채널과 직원 채널 범위로 거른다.
+ */
+import { z } from 'zod';
+import { defineTool } from '../../../plugin/define.js';
+import { getAuth } from '../../../core/context.js';
+import { allowedSlackChannels } from '../../../core/scope.js';
+import { slackApi, SlackError, loadSlackUserMap, mapLimit, loadBotMemberChannelIds, } from '../api.js';
+const DESCRIPTION = 'Slack 워크스페이스에서 메시지를 키워드로 검색. Slack 검색 연산자 사용 가능 ' +
+    '(예: "배포 in:#dev", "from:@alex 결정", "JSON-LD after:2026-01-01"). ' +
+    '사내 논의·결정이 Slack 에 있을 때 Drive 검색과 함께 사용. ' +
+    '**기본으로 봇이 멤버인 모든 채널을 검색한다**(공개·비공개 무관, 봇이 초대된 채널 전체). 채널을 좁히지 말고 바로 키워드로 검색하라 — 특정 채널만 한정할 때만 in:#채널. DM·봇 미초대 채널은 제외. ' +
+    '**검색은 단일 메시지만 매칭한다 — 실제 논의·결론은 그 메시지의 thread 답글에 있는 경우가 많다.** ' +
+    '기본(expandThreads=true)으로 봇이 읽을 수 있는 채널의 매칭은 주변 thread 맥락까지 함께 가져온다. ' +
+    'thread_unavailable=true 면 답글이 더 있으나 봇이 그 채널 멤버가 아니라 못 읽은 것 — slack_read_channel 로도 막힌다. ' +
+    '**"최근/근황/최신 진행상황/누가 뭐라 했나" 처럼 최신성이 중요한 질문이면 sort="timestamp"(최신순) 를 써라.** User token 필요.';
+const inputSchema = z.object({
+    query: z.string().min(1).describe('검색어. Slack 연산자(in:, from:, after:, before:) 지원.'),
+    count: z.number().int().min(1).max(50).default(20).describe('최대 결과 수 (1-50). default 20.'),
+    sort: z
+        .enum(['score', 'timestamp'])
+        .default('score')
+        .describe('"score"(관련도, default) 또는 "timestamp"(최신순). 최신 논의·근황 질문이면 timestamp.'),
+    expandThreads: z
+        .boolean()
+        .default(true)
+        .describe('매칭 메시지가 thread 안이면 주변 답글까지 가져온다. default true(논의 맥락 보존). 평면 결과만 빠르게 보려면 false.'),
+});
+export const slackSearchTool = defineTool({
+    name: 'slack_search',
+    description: DESCRIPTION,
+    input: inputSchema,
+    annotations: { readOnlyHint: true },
+    run: (args) => handleSlackSearch(args),
+});
+/**
+ * 검색 표면 = "봇이 멤버인 채널" — read_channel 과 동일한 신뢰 경계.
+ *
+ * search.messages 는 User token(xoxp) 권한이라 토큰 소유자의 개인 DM·비공개 채널까지 보인다.
+ * 그대로 노출하면 토큰 소유자의 사적 대화가 새므로, "봇이 초대된 채널"로만 한정한다
+ * (봇 초대 = 어시스턴트가 읽어도 된다고 팀이 허가한 채널). 채널이 대부분 비공개라,
+ * 과거의 'public만' 필터는 사실상 전부를 막아 검색이 0건이었다.
+ *   - DM(D…)·그룹DM(mpim): conversations.list 에 안 잡혀 botMemberIds 에 자연 부재 → 제외.
+ *   - 봇 미초대 비공개 채널: 허가되지 않음 → 제외(read_channel 로도 못 읽음).
+ */
+function isAllowedSearchMatch(m, botMemberIds) {
+    const c = m.channel;
+    if (!c?.id)
+        return false;
+    if (c.is_im || c.is_mpim)
+        return false; // 이중 방어 — DM 은 절대 검색 표면에 안 올림
+    return botMemberIds.has(c.id);
+}
+export async function handleSlackSearch(args) {
+    const auth = getAuth();
+    const { query, count, sort, expandThreads } = args;
+    try {
+        const res = await slackApi('search.messages', { query, count, sort, highlight: false }, 'search');
+        // 1) 봇이 멤버인 채널만 (DM·봇 미초대 비공개 채널 제외 — User token 의 개인 가시범위 차단)
+        // 2) 직원별 Slack 채널 scope (admin·미설정 = 전체). 결과 메시지를 허용 채널로 필터.
+        const channelScope = allowedSlackChannels(auth);
+        const botMemberIds = await loadBotMemberChannelIds();
+        const matches = (res.messages?.matches ?? []).filter((m) => isAllowedSearchMatch(m, botMemberIds) &&
+            (!channelScope || (m.channel?.id != null && channelScope.has(m.channel.id))));
+        const results = matches.map((m) => ({
+            ts: m.ts,
+            datetime: m.ts ? new Date(Number(m.ts) * 1000).toISOString() : null,
+            user: m.username ?? m.user ?? null,
+            channel: m.channel?.name ? `#${m.channel.name}` : (m.channel?.id ?? null),
+            channelId: m.channel?.id ?? null,
+            text: m.text ?? '',
+            permalink: m.permalink ?? null,
+        }));
+        // search.messages 는 단일 메시지만 반환 — 매칭이 thread 안이면 주변 답글 맥락이 누락된다.
+        // 봇이 멤버인 채널은 conversations.replies(ts=매칭ts)로 thread 전체를 가져와 붙인다.
+        // (Slack 은 thread 내 아무 메시지 ts 로도 thread 전체를 돌려준다 — 부모/답글 무관)
+        // 봇 미참여 채널은 not_in_channel 등으로 실패 → thread_unavailable 로만 표기(평면 결과 유지).
+        if (expandThreads && results.length > 0) {
+            const userMap = await loadSlackUserMap();
+            const nameOf = (t) => t.user ? (userMap[t.user] ?? t.user) : t.bot_id ? `bot:${t.bot_id}` : null;
+            const seenThreads = new Set(); // channelId:rootTs — 같은 thread 중복 확장 방지
+            await mapLimit(results, 6, async (r) => {
+                if (!r.channelId || !r.ts)
+                    return;
+                try {
+                    const rep = await slackApi('conversations.replies', { channel: r.channelId, ts: r.ts, limit: 100 }, 'bot');
+                    const msgs = rep.messages ?? [];
+                    if (msgs.length <= 1)
+                        return; // thread 아님(단일 메시지) — 붙일 맥락 없음
+                    const rootTs = msgs[0]?.ts ?? r.ts;
+                    const key = `${r.channelId}:${rootTs}`;
+                    if (seenThreads.has(key)) {
+                        r.thread_root_ts = rootTs; // 이미 다른 매칭에서 확장한 thread
+                        return;
+                    }
+                    seenThreads.add(key);
+                    r.thread = msgs.map((t) => ({
+                        ts: t.ts,
+                        user: nameOf(t),
+                        text: t.text ?? '',
+                        is_match: t.ts === r.ts, // 검색에 걸린 바로 그 메시지 표시
+                    }));
+                }
+                catch {
+                    // 봇이 채널 멤버가 아님(not_in_channel) 등 → 답글이 더 있을 수 있으나 못 읽음
+                    r.thread_unavailable = true;
+                }
+            });
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(
+                    // total(Slack 원본 건수)은 싣지 않는다 — DM·권한 밖 채널의 일치 건수까지 드러난다.
+                    { query, count: results.length, results }, 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_search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack_search.js","sourceRoot":"","sources":["../../../../src/plugins/slack/tools/slack_search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,GACf,kDAAkD;IAClD,kEAAkE;IAClE,0CAA0C;IAC1C,yHAAyH;IACzH,gEAAgE;IAChE,sEAAsE;IACtE,0FAA0F;IAC1F,0FAA0F,CAAC;AAE7F,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC1F,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;SAC5B,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,qEAAqE,CAAC;IAClF,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gFAAgF,CAAC;CAC9F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,WAAW;IACxB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;IACnC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;CACvC,CAAC,CAAC;AA0BH;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,CAAmB,EAAE,YAAyB;IAC1E,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IACpB,IAAI,CAAC,CAAC,EAAE,EAAE;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC,CAAC,8BAA8B;IACtE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAiC;IACvE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAGxB,iBAAiB,EACjB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EACxC,QAAQ,CACT,CAAC;QAEF,+DAA+D;QAC/D,6DAA6D;QAC7D,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,MAAM,uBAAuB,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CACJ,oBAAoB,CAAC,CAAC,EAAE,YAAY,CAAC;YACrC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAC/E,CAAC;QACF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YACnE,IAAI,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI;YAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI,CAAC;YACzE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;SAC/B,CAAC,CAAC,CAAC;QAEJ,gEAAgE;QAChE,iEAAiE;QACjE,6DAA6D;QAC7D,wEAAwE;QACxE,IAAI,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,CAAC,CAAY,EAAE,EAAE,CAC9B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC,CAAC,wCAAwC;YAE/E,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;gBACrC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE;oBAAE,OAAO;gBAClC,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,uBAAuB,EACvB,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAC9C,KAAK,CACN,CAAC;oBACF,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;oBAChC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;wBAAE,OAAO,CAAC,+BAA+B;oBAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;oBACnC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;oBACvC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACxB,CAAS,CAAC,cAAc,GAAG,MAAM,CAAC,CAAC,wBAAwB;wBAC5D,OAAO;oBACT,CAAC;oBACD,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACpB,CAAS,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACnC,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;wBACf,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;wBAClB,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,qBAAqB;qBAC/C,CAAC,CAAC,CAAC;gBACN,CAAC;gBAAC,MAAM,CAAC;oBACP,uDAAuD;oBACtD,CAAS,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBACvC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS;oBAClB,yDAAyD;oBACzD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EACzC,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,GAAG,EAAE,EAAE,CAAC;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from './plugin/define.js';
+export interface RunOptions {
+    /** Plugins to serve. Default: the built-in Drive, Slack, GitHub and Railway plugins. */
+    plugins?: Plugin[];
+    /** Arguments without node and the script path. Default: process.argv.slice(2). */
+    argv?: string[];
+}
+export declare function run(opts?: RunOptions): Promise<void>;