eniac-slack 0.0.2

package/SPEC.md

@@ -0,0 +1,240 @@
+# eniac-slack — Slack Bot for Claude Code Sessions
+
+## Overview
+
+Slack 소켓모드 봇으로, 멘션을 통해 Claude Code 세션을 시작하고 스레드 단위로 대화를 이어갈 수 있다. GitHub 레포지토리 연동 및 도구 실행 권한 승인을 Slack 버튼으로 처리한다.
+
+## Architecture
+
+```
+┌─────────────┐     Socket Mode     ┌──────────────────┐
+│  Slack API   │◄──────────────────►│   Bolt App       │
+│              │                    │   (app.ts)       │
+└─────────────┘                    └────────┬─────────┘
+                                            │
+                         ┌──────────────────┼──────────────────┐
+                         │                  │                  │
+                   ┌─────▼─────┐     ┌──────▼──────┐    ┌─────▼──────┐
+                   │  Mention   │     │   Thread    │    │  Action    │
+                   │  Handler   │     │   Handler   │    │  Handler   │
+                   └─────┬─────┘     └──────┬──────┘    │ (buttons)  │
+                         │                  │           └─────┬──────┘
+                         └────────┬─────────┘                 │
+                                  │                           │
+                           ┌──────▼──────┐             ┌──────▼──────┐
+                           │  Claude     │◄───────────►│ Permissions │
+                           │  Service    │  canUseTool  │  Service    │
+                           │  (SDK API)  │  callback   │             │
+                           └──────┬──────┘             └─────────────┘
+                                  │
+                           ┌──────▼──────┐
+                           │ Slack       │
+                           │ Messenger   │
+                           │ (streaming) │
+                           └─────────────┘
+```
+
+## Modules
+
+### `cli.ts` — Entry Point
+
+- `.env` 로드 (실행 디렉토리 및 상위 디렉토리)
+- 필수 환경변수 검증: `SLACK_BOT_TOKEN`, `SLACK_APP_TOKEN`
+- `REPOS_BASE_DIR` (선택, 기본: `~/.eniac/repos`)
+- Bolt 앱 시작
+
+### `app.ts` — Slack Bolt App
+
+- Socket Mode로 Slack 연결
+- 이벤트 등록:
+  - `app_mention` → `handleMention`
+  - `message` → `handleThreadMessage`
+- 액션 등록:
+  - `approve_permission` → 도구 실행 승인
+  - `deny_permission` → 도구 실행 거부
+
+### `handlers/mention.ts` — @Mention Handler
+
+**새 메시지 (thread 아닌 경우):**
+
+1. 메시지에서 봇 멘션 제거
+2. GitHub repo 패턴 감지:
+   - **있으면:** bare clone → worktree 생성 → Claude 세션 시작
+   - **없으면:** temp 디렉토리 생성 → Claude 세션 시작
+3. Claude 응답을 스레드에 스트리밍
+
+**스레드 내 멘션:**
+
+- 기존 세션이 있으면 이어서 진행
+- 없으면 temp 디렉토리에 새 세션 생성
+
+### `handlers/thread.ts` — Thread Reply Handler
+
+- 봇이 활성 세션을 가진 스레드의 일반 메시지 처리
+- 봇 자신의 메시지, subtype 메시지 무시
+- `file_share` subtype은 허용 (이미지 첨부 메시지)
+- 기존 세션에 이어서 Claude에 전달
+
+### `services/claude.ts` — Claude Code Session Manager
+
+**세션 관리:**
+
+- `Map<thread_ts, Session>` 으로 메모리에 유지
+- `~/.eniac/sessions.json`에 영구 저장 (서버 재시작 시 복원)
+- 세션 ID: UUID (랜덤 생성)
+- `hasStarted` 플래그로 첫 실행(`sessionId`) / 재개(`resume`) 구분
+
+**세션 생명주기:**
+
+- `createSession(threadTs, workDir, authorUserId)` → 새 세션 생성
+- `getSession(threadTs)` → 기존 세션 조회
+- `lastActivityAt` 매 대화마다 갱신
+- 서버 시작 시 2주 이상 비활성 세션 자동 정리 (SDK `.jsonl` + worktree 삭제)
+
+**Claude SDK 호출:**
+
+```typescript
+query({
+  prompt: userMessage,
+  options: {
+    cwd: session.workDir,
+    canUseTool,                          // 커스텀 권한 콜백
+    permissionMode: "bypassPermissions", // SDK 내장 권한 비활성화
+    allowDangerouslySkipPermissions: true,
+    includePartialMessages: true,        // 실시간 스트리밍
+    sessionId: session.sessionId,        // 첫 호출
+    // 또는
+    resume: session.sessionId,           // 이후 호출
+  },
+});
+```
+
+**도구 권한 분류:**
+
+| 자동 허용 | Slack 버튼 승인 필요 |
+|-----------|---------------------|
+| Read, Glob, Grep | Bash |
+| WebSearch, WebFetch | Edit, Write |
+| Agent, TodoRead | 기타 모든 도구 |
+| ListMcpResources, ReadMcpResource | |
+
+**ChatEvent 타입:**
+
+```typescript
+type ChatEvent =
+  | { type: "text"; content: string }
+  | { type: "error"; message: string };
+```
+
+### `services/permissions.ts` — Permission Bridge
+
+**플로우:**
+
+```
+Claude canUseTool 콜백 호출 (위험 도구)
+  → Slack에 Block Kit 버튼 메시지 포스트
+    ┌──────────────────────────────────┐
+    │ 🔒 Permission Required           │
+    │                                  │
+    │ Tool: `Bash`                     │
+    │ ```                              │
+    │ npm install express              │
+    │ ```                              │
+    │                                  │
+    │ [Approve]  [Deny]                │
+    └──────────────────────────────────┘
+  → Promise로 대기 (5분 타임아웃)
+  → 스레드 작성자가 버튼 클릭
+  → Promise resolve(true/false)
+  → 버튼 메시지를 결과로 업데이트
+    "✅ Approved by @user" 또는 "🚫 Denied by @user"
+```
+
+**보안:**
+
+- 스레드 작성자만 승인/거부 가능 (`authorUserId` 검증)
+- 5분 타임아웃 후 자동 거부
+
+**API:**
+
+- `requestPermission(client, channel, threadTs, permissionId, toolName, description, authorUserId)` → `Promise<boolean>`
+- `resolvePermission(client, permissionId, granted, clickedUserId)` → `Promise<void>`
+
+### `services/slack-messenger.ts` — Streaming Message Updater
+
+- 초기 메시지 "⏳ Thinking..." 포스트
+- `ChatEvent` 스트림을 소비하며:
+  - `text` → 텍스트 누적 후 메시지 업데이트
+  - `error` → 에러 메시지 추가
+- 500ms 스로틀링으로 Slack rate limit 방지
+- 중간 업데이트 시 단어 경계에서 텍스트 자르기 (한글 punycode 버그 방지)
+
+### `services/git.ts` — Repository Manager
+
+**전략: bare repo + worktree**
+
+```
+{REPOS_BASE_DIR}/
+  └── {owner}/
+      ├── {repo}.git/          # bare clone (공유)
+      └── {repo}/
+          └── worktrees/
+              ├── 1710000000/   # worktree 1 (branch: eniac/1710000000)
+              └── 1710000001/   # worktree 2 (branch: eniac/1710000001)
+```
+
+1. bare repo가 없으면 `git clone --bare`
+2. bare repo가 있으면 `git fetch --all`
+3. `git worktree add -b eniac/{timestamp} {path} {defaultBranch}` 로 작업 디렉토리 생성
+4. default branch는 `HEAD` symbolic ref에서 자동 감지
+5. 스레드마다 독립 브랜치 → PR 생성 가능
+
+### `utils/parse.ts` — Message Parser
+
+- `removeMention(text)`: `<@BOTID>` 제거
+- `extractGithubRepo(text)`: GitHub repo 추출
+  - `https://github.com/owner/repo` ✅
+  - `github.com/owner/repo` ✅
+  - `owner/repo` ✅ (유효한 GitHub 네이밍 규칙 충족 시)
+  - `../path` ❌ (파일 경로 형태 거부)
+
+## Data Storage
+
+| 데이터 | 경로 | 내용 |
+|--------|------|------|
+| 세션 매핑 | `~/.eniac/sessions.json` | `threadTs → { sessionId, workDir, authorUserId, ... }` |
+| SDK 대화 기록 | `~/.claude/projects/{cwd-encoded}/{sessionId}.jsonl` | 전체 대화 히스토리 (SDK 자동 관리) |
+| Git bare repos | `{REPOS_BASE_DIR}/{owner}/{repo}.git/` | 공유 bare clone |
+| Git worktrees | `{REPOS_BASE_DIR}/{owner}/{repo}/worktrees/{timestamp}/` | 스레드별 작업 디렉토리 |
+
+**세션 만료:** `lastActivityAt` 기준 2주 경과 시 서버 시작 시점에 자동 정리 (세션 파일 + worktree 삭제)
+
+## Environment Variables
+
+| 변수 | 필수 | 설명 |
+|------|------|------|
+| `SLACK_BOT_TOKEN` | ✅ | `xoxb-` 봇 토큰 |
+| `SLACK_APP_TOKEN` | ✅ | `xapp-` 앱 레벨 토큰 (소켓모드) |
+| `REPOS_BASE_DIR` | ❌ | 레포 저장 경로 (기본: `~/.eniac/repos`) |
+
+## Tech Stack
+
+- **Runtime:** Node.js ≥ 18
+- **Language:** TypeScript (ES2022, ESM)
+- **Package Manager:** Yarn 4 (Berry, node-modules linker)
+- **Monorepo:** Yarn Workspaces (`services/*`, `packages/*`)
+- **Slack:** `@slack/bolt` v4 (Socket Mode)
+- **Claude:** `@anthropic-ai/claude-agent-sdk` v0.2.72 (`query()` API)
+- **Git:** `simple-git`
+
+## Slack App 설정 요구사항
+
+1. **Socket Mode** 활성화
+2. **Event Subscriptions:**
+   - `app_mention`
+   - `message.channels` / `message.groups`
+3. **Bot Token Scopes:**
+   - `app_mentions:read`
+   - `chat:write`
+   - `channels:history` / `groups:history`
+4. **Interactivity** 활성화 (버튼 클릭 처리용)

package/dist/app.d.ts

@@ -0,0 +1,8 @@
+import { App } from "@slack/bolt";
+export interface AppConfig {
+    slackBotToken: string;
+    slackAppToken: string;
+    reposBaseDir: string;
+}
+export declare function createAndStartApp(config: AppConfig): Promise<App>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAKlC,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CA0CvE"}

package/dist/app.js

@@ -0,0 +1,44 @@
+import { App } from "@slack/bolt";
+import { handleMention, setReposBaseDir } from "./handlers/mention.js";
+import { handleThreadMessage } from "./handlers/thread.js";
+import { resolvePermission } from "./services/permissions.js";
+export async function createAndStartApp(config) {
+    const { slackBotToken, slackAppToken, reposBaseDir } = config;
+    setReposBaseDir(reposBaseDir);
+    const app = new App({
+        token: slackBotToken,
+        appToken: slackAppToken,
+        socketMode: true,
+    });
+    // Event handlers
+    app.event("app_mention", handleMention);
+    app.event("message", handleThreadMessage);
+    // Permission button handlers
+    app.action("approve_permission", async ({ action, ack, client, body }) => {
+        await ack();
+        console.log(`[action] approve_permission fired! action.type=${action.type}, body.user=${JSON.stringify(body.user)}`);
+        if (action.type !== "button")
+            return;
+        const permissionId = action.value;
+        const clickedUserId = body.user?.id ?? "someone";
+        console.log(`[action] approve: permissionId=${permissionId}, clickedUserId=${clickedUserId}`);
+        if (permissionId) {
+            await resolvePermission(client, permissionId, true, clickedUserId);
+        }
+    });
+    app.action("deny_permission", async ({ action, ack, client, body }) => {
+        await ack();
+        console.log(`[action] deny_permission fired!`);
+        if (action.type !== "button")
+            return;
+        const permissionId = action.value;
+        const clickedUserId = body.user?.id ?? "someone";
+        console.log(`[action] deny: permissionId=${permissionId}, clickedUserId=${clickedUserId}`);
+        if (permissionId) {
+            await resolvePermission(client, permissionId, false, clickedUserId);
+        }
+    });
+    await app.start();
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAQ9D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAiB;IACvD,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAE9D,eAAe,CAAC,YAAY,CAAC,CAAC;IAE9B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAClB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,aAAa;QACvB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,iBAAiB;IACjB,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACxC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAE1C,6BAA6B;IAC7B,GAAG,CAAC,MAAM,CAAC,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACvE,MAAM,GAAG,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,kDAAkD,MAAM,CAAC,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrH,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACrC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,SAAS,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,kCAAkC,YAAY,mBAAmB,aAAa,EAAE,CAAC,CAAC;QAC9F,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACpE,MAAM,GAAG,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACrC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,SAAS,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,+BAA+B,YAAY,mBAAmB,aAAa,EAAE,CAAC,CAAC;QAC3F,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAClB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import path from "node:path";
+import os from "node:os";
+import dotenv from "dotenv";
+import { createAndStartApp } from "./app.js";
+// Load .env — try cwd first, then walk up to find it
+dotenv.config();
+dotenv.config({ path: path.resolve(process.cwd(), "../../.env") });
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        console.error(`[eniac-slack] Missing required environment variable: ${name}`);
+        console.error(`Create a .env file or export ${name} in your shell.`);
+        process.exit(1);
+    }
+    return value;
+}
+async function main() {
+    const slackBotToken = requireEnv("SLACK_BOT_TOKEN");
+    const slackAppToken = requireEnv("SLACK_APP_TOKEN");
+    const reposBaseDir = process.env["REPOS_BASE_DIR"]?.replace(/^~/, os.homedir()) ??
+        path.join(os.homedir(), ".eniac", "repos");
+    console.log("[eniac-slack] Starting Slack bot...");
+    console.log(`[eniac-slack] Repos base directory: ${reposBaseDir}`);
+    try {
+        await createAndStartApp({
+            slackBotToken,
+            slackAppToken,
+            reposBaseDir,
+        });
+        console.log("[eniac-slack] Bot is running! Listening for events...");
+    }
+    catch (error) {
+        console.error("[eniac-slack] Failed to start:", error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,qDAAqD;AACrD,MAAM,CAAC,MAAM,EAAE,CAAC;AAChB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;AAEnE,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,wDAAwD,IAAI,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,iBAAiB,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,aAAa,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAEpD,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,uCAAuC,YAAY,EAAE,CAAC,CAAC;IAEnE,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC;YACtB,aAAa;YACb,aAAa;YACb,YAAY;SACb,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/handlers/mention.d.ts

@@ -0,0 +1,10 @@
+import type { AllMiddlewareArgs, SlackEventMiddlewareArgs } from "@slack/bolt";
+export declare function setReposBaseDir(dir: string): void;
+/**
+ * Handle `app_mention` events.
+ *
+ * - New mention (not in a thread): start a new Claude session.
+ * - Mention in a thread: forward to thread handler logic.
+ */
+export declare function handleMention(args: AllMiddlewareArgs & SlackEventMiddlewareArgs<"app_mention">): Promise<void>;
+//# sourceMappingURL=mention.d.ts.map

package/dist/handlers/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../../src/handlers/mention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAW/E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD;AASD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,GAAG,wBAAwB,CAAC,aAAa,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC,CAgEf"}

package/dist/handlers/mention.js

@@ -0,0 +1,96 @@
+import { removeMention, extractGithubRepo } from "../utils/parse.js";
+import { createSession, getSession, chat } from "../services/claude.js";
+import { prepareWorkDir } from "../services/git.js";
+import { postStreamingReply } from "../services/slack-messenger.js";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+let reposBaseDir;
+export function setReposBaseDir(dir) {
+    reposBaseDir = dir;
+}
+function getReposBaseDir() {
+    if (!reposBaseDir) {
+        reposBaseDir = path.join(os.homedir(), ".eniac", "repos");
+    }
+    return reposBaseDir;
+}
+/**
+ * Handle `app_mention` events.
+ *
+ * - New mention (not in a thread): start a new Claude session.
+ * - Mention in a thread: forward to thread handler logic.
+ */
+export async function handleMention(args) {
+    const { event, client } = args;
+    const { text, channel, ts, thread_ts } = event;
+    const authorUserId = event.user ?? "unknown";
+    // If the mention is inside an existing thread, treat it as a thread reply
+    if (thread_ts) {
+        await handleThreadedMention(client, channel, thread_ts, text, authorUserId);
+        return;
+    }
+    // New conversation — ts becomes the thread_ts
+    const threadTs = ts;
+    const cleanText = removeMention(text);
+    if (!cleanText) {
+        await client.chat.postMessage({
+            channel,
+            thread_ts: threadTs,
+            text: "How can I help you? You can ask me coding questions, or mention a GitHub repo (e.g. `owner/repo`) to work with its code.",
+        });
+        return;
+    }
+    // Check for GitHub repo in message
+    const repoInfo = extractGithubRepo(cleanText);
+    let workDir;
+    if (repoInfo) {
+        try {
+            await client.chat.postMessage({
+                channel,
+                thread_ts: threadTs,
+                text: `:file_folder: Setting up repository \`${repoInfo.owner}/${repoInfo.repo}\`...`,
+            });
+            workDir = await prepareWorkDir(repoInfo, getReposBaseDir());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await client.chat.postMessage({
+                channel,
+                thread_ts: threadTs,
+                text: `:x: Failed to set up repository: ${message}`,
+            });
+            return;
+        }
+    }
+    else {
+        // Create a temp directory for non-repo conversations
+        workDir = await fs.mkdtemp(path.join(os.tmpdir(), "eniac-"));
+    }
+    // Create a Claude session
+    createSession(threadTs, workDir, authorUserId);
+    // Build context-aware first message
+    let userMessage = cleanText;
+    if (repoInfo) {
+        userMessage = `[Working directory: ${workDir} — Repository: ${repoInfo.owner}/${repoInfo.repo}]\n\n${cleanText}`;
+    }
+    // Stream the response
+    const stream = chat(threadTs, userMessage, client, channel);
+    await postStreamingReply(client, channel, threadTs, stream);
+}
+/**
+ * Handle a mention that occurs inside an existing thread.
+ */
+async function handleThreadedMention(client, channel, threadTs, text, authorUserId) {
+    const cleanText = removeMention(text);
+    if (!cleanText)
+        return;
+    let session = getSession(threadTs);
+    if (!session) {
+        const workDir = await fs.mkdtemp(path.join(os.tmpdir(), "eniac-"));
+        session = createSession(threadTs, workDir, authorUserId);
+    }
+    const stream = chat(threadTs, cleanText, client, channel);
+    await postStreamingReply(client, channel, threadTs, stream);
+}
+//# sourceMappingURL=mention.js.map

package/dist/handlers/mention.js.map

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

package/dist/handlers/thread.d.ts

@@ -0,0 +1,8 @@
+import type { AllMiddlewareArgs, SlackEventMiddlewareArgs } from "@slack/bolt";
+/**
+ * Handle messages posted in threads where the bot has an active session.
+ *
+ * Only responds to human messages (ignores bot messages and subtypes).
+ */
+export declare function handleThreadMessage(args: AllMiddlewareArgs & SlackEventMiddlewareArgs<"message">): Promise<void>;
+//# sourceMappingURL=thread.d.ts.map

package/dist/handlers/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/handlers/thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAI/E;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GAAG,wBAAwB,CAAC,SAAS,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/handlers/thread.js

@@ -0,0 +1,50 @@
+import { getSession, chat } from "../services/claude.js";
+import { postStreamingReply } from "../services/slack-messenger.js";
+/**
+ * Handle messages posted in threads where the bot has an active session.
+ *
+ * Only responds to human messages (ignores bot messages and subtypes).
+ */
+export async function handleThreadMessage(args) {
+    const { event, client, context } = args;
+    const subtype = event.subtype ?? "none";
+    const threadTs = "thread_ts" in event ? event.thread_ts : undefined;
+    const botId = "bot_id" in event ? event.bot_id : undefined;
+    const userId = "user" in event ? event.user : undefined;
+    console.log(`[thread] message event: subtype=${subtype}, thread_ts=${threadTs ?? "none"}, bot_id=${botId ?? "none"}, user=${userId ?? "none"}`);
+    // Skip non-user subtypes (message_changed, bot_message, etc.)
+    // But allow file_share (image/file attachments) — those are real user messages
+    const allowedSubtypes = new Set(["file_share"]);
+    if (event.subtype !== undefined && !allowedSubtypes.has(event.subtype)) {
+        console.log(`[thread] skipped: subtype=${subtype}`);
+        return;
+    }
+    // Must be in a thread
+    if (!threadTs) {
+        console.log(`[thread] skipped: not in a thread`);
+        return;
+    }
+    // Ignore messages from the bot itself
+    if (botId || userId === context.botUserId) {
+        console.log(`[thread] skipped: bot message`);
+        return;
+    }
+    const text = "text" in event ? event.text : undefined;
+    const channel = event.channel;
+    // Only respond if we have an active session for this thread
+    const session = getSession(threadTs);
+    if (!session) {
+        console.log(`[thread] skipped: no session for thread_ts=${threadTs}`);
+        return;
+    }
+    console.log(`[thread] session found! sessionId=${session.sessionId}, text=${text?.slice(0, 50)}`);
+    if (!text || text.trim().length === 0)
+        return;
+    // Strip any bot mentions from the text (user might @mention the bot in-thread)
+    const cleanText = text.replace(/<@[A-Z0-9]+>/g, "").trim();
+    if (!cleanText)
+        return;
+    const stream = chat(threadTs, cleanText, client, channel);
+    await postStreamingReply(client, channel, threadTs, stream);
+}
+//# sourceMappingURL=thread.js.map

package/dist/handlers/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../src/handlers/thread.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAA6D;IAE7D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAExC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC;IACxC,MAAM,QAAQ,GAAG,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,KAAK,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,mCAAmC,OAAO,eAAe,QAAQ,IAAI,MAAM,YAAY,KAAK,IAAI,MAAM,UAAU,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAEhJ,8DAA8D;IAC9D,+EAA+E;IAC/E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,IAAI,KAAK,IAAI,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAE9B,4DAA4D;IAC5D,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,OAAO,CAAC,SAAS,UAAU,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAElG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE9C,+EAA+E;IAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/dist/services/claude.d.ts

@@ -0,0 +1,27 @@
+import type { WebClient } from "@slack/web-api";
+interface Session {
+    sessionId: string;
+    workDir: string;
+    hasStarted: boolean;
+    authorUserId: string;
+    createdAt: number;
+    lastActivityAt: number;
+}
+export type ChatEvent = {
+    type: "text";
+    content: string;
+} | {
+    type: "error";
+    message: string;
+};
+export declare function createSession(threadTs: string, workDir: string, authorUserId: string): Session;
+export declare function getSession(threadTs: string): Session | undefined;
+/**
+ * Send a message to a Claude session via the SDK.
+ *
+ * Uses `canUseTool` callback to handle permission requests
+ * through Slack interactive buttons.
+ */
+export declare function chat(threadTs: string, userMessage: string, slackClient: WebClient, channel: string): AsyncGenerator<ChatEvent, void, unknown>;
+export {};
+//# sourceMappingURL=claude.d.ts.map

package/dist/services/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/services/claude.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,UAAU,OAAO;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAgFvC,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAaT;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEhE;AAkBD;;;;;GAKG;AACH,wBAAuB,IAAI,CACzB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,GACd,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CA6H1C"}