claude-threads 0.15.0 → 0.16.3

package/dist/persistence/session-store.d.ts

@@ -1,71 +0,0 @@
-/**
- * Worktree information for a session
- */
-export interface WorktreeInfo {
-    repoRoot: string;
-    worktreePath: string;
-    branch: string;
-}
-/**
- * Persisted session state for resuming after bot restart
- */
-export interface PersistedSession {
-    platformId: string;
-    threadId: string;
-    claudeSessionId: string;
-    startedBy: string;
-    startedAt: string;
-    sessionNumber: number;
-    workingDir: string;
-    sessionAllowedUsers: string[];
-    forceInteractivePermissions: boolean;
-    sessionStartPostId: string | null;
-    tasksPostId: string | null;
-    lastActivityAt: string;
-    planApproved: boolean;
-    worktreeInfo?: WorktreeInfo;
-    pendingWorktreePrompt?: boolean;
-    worktreePromptDisabled?: boolean;
-    queuedPrompt?: string;
-}
-/**
- * SessionStore - Persistence layer for session state
- * Stores session data as JSON file for resume after restart
- */
-export declare class SessionStore {
-    private debug;
-    constructor();
-    /**
-     * Load all persisted sessions
-     * Returns Map with composite sessionId ("platformId:threadId") as key
-     */
-    load(): Map<string, PersistedSession>;
-    /**
-     * Save a session (creates or updates)
-     * @param sessionId - Composite key "platformId:threadId"
-     * @param session - Session data to persist
-     */
-    save(sessionId: string, session: PersistedSession): void;
-    /**
-     * Remove a session
-     * @param sessionId - Composite key "platformId:threadId"
-     */
-    remove(sessionId: string): void;
-    /**
-     * Remove sessions older than maxAgeMs
-     * @returns Array of sessionIds that were removed
-     */
-    cleanStale(maxAgeMs: number): string[];
-    /**
-     * Clear all sessions
-     */
-    clear(): void;
-    /**
-     * Load raw data from file
-     */
-    private loadRaw;
-    /**
-     * Write data atomically (write to temp file, then rename)
-     */
-    private writeAtomic;
-}

package/dist/persistence/session-store.js

@@ -1,152 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
-const STORE_VERSION = 2; // v2: Added platformId for multi-platform support
-const CONFIG_DIR = join(homedir(), '.config', 'claude-threads');
-const SESSIONS_FILE = join(CONFIG_DIR, 'sessions.json');
-/**
- * SessionStore - Persistence layer for session state
- * Stores session data as JSON file for resume after restart
- */
-export class SessionStore {
-    debug = process.env.DEBUG === '1' || process.argv.includes('--debug');
-    constructor() {
-        // Ensure config directory exists
-        if (!existsSync(CONFIG_DIR)) {
-            mkdirSync(CONFIG_DIR, { recursive: true });
-        }
-    }
-    /**
-     * Load all persisted sessions
-     * Returns Map with composite sessionId ("platformId:threadId") as key
-     */
-    load() {
-        const sessions = new Map();
-        if (!existsSync(SESSIONS_FILE)) {
-            if (this.debug)
-                console.log('  [persist] No sessions file found');
-            return sessions;
-        }
-        try {
-            const data = JSON.parse(readFileSync(SESSIONS_FILE, 'utf-8'));
-            // Migration: v1 → v2 (add platformId and convert keys to composite format)
-            if (data.version === 1) {
-                console.log('  [persist] Migrating sessions from v1 to v2 (adding platformId)');
-                const newSessions = {};
-                for (const [_oldKey, session] of Object.entries(data.sessions)) {
-                    const v1Session = session;
-                    if (!v1Session.platformId) {
-                        v1Session.platformId = 'default';
-                    }
-                    // Convert key from threadId to platformId:threadId
-                    const newKey = `${v1Session.platformId}:${v1Session.threadId}`;
-                    newSessions[newKey] = v1Session;
-                }
-                data.sessions = newSessions;
-                data.version = 2;
-                // Save migrated data
-                this.writeAtomic(data);
-            }
-            else if (data.version !== STORE_VERSION) {
-                console.warn(`  [persist] Sessions file version ${data.version} not supported, starting fresh`);
-                return sessions;
-            }
-            // Load sessions with composite sessionId as key
-            for (const session of Object.values(data.sessions)) {
-                const sessionId = `${session.platformId}:${session.threadId}`;
-                sessions.set(sessionId, session);
-            }
-            if (this.debug) {
-                console.log(`  [persist] Loaded ${sessions.size} session(s)`);
-            }
-        }
-        catch (err) {
-            console.error('  [persist] Failed to load sessions:', err);
-        }
-        return sessions;
-    }
-    /**
-     * Save a session (creates or updates)
-     * @param sessionId - Composite key "platformId:threadId"
-     * @param session - Session data to persist
-     */
-    save(sessionId, session) {
-        const data = this.loadRaw();
-        // Use sessionId as key (already composite)
-        data.sessions[sessionId] = session;
-        this.writeAtomic(data);
-        if (this.debug) {
-            const shortId = sessionId.substring(0, 20);
-            console.log(`  [persist] Saved session ${shortId}...`);
-        }
-    }
-    /**
-     * Remove a session
-     * @param sessionId - Composite key "platformId:threadId"
-     */
-    remove(sessionId) {
-        const data = this.loadRaw();
-        if (data.sessions[sessionId]) {
-            delete data.sessions[sessionId];
-            this.writeAtomic(data);
-            if (this.debug) {
-                const shortId = sessionId.substring(0, 20);
-                console.log(`  [persist] Removed session ${shortId}...`);
-            }
-        }
-    }
-    /**
-     * Remove sessions older than maxAgeMs
-     * @returns Array of sessionIds that were removed
-     */
-    cleanStale(maxAgeMs) {
-        const data = this.loadRaw();
-        const now = Date.now();
-        const staleIds = [];
-        for (const [sessionId, session] of Object.entries(data.sessions)) {
-            const lastActivity = new Date(session.lastActivityAt).getTime();
-            if (now - lastActivity > maxAgeMs) {
-                staleIds.push(sessionId);
-                delete data.sessions[sessionId];
-            }
-        }
-        if (staleIds.length > 0) {
-            this.writeAtomic(data);
-            if (this.debug) {
-                console.log(`  [persist] Cleaned ${staleIds.length} stale session(s)`);
-            }
-        }
-        return staleIds;
-    }
-    /**
-     * Clear all sessions
-     */
-    clear() {
-        this.writeAtomic({ version: STORE_VERSION, sessions: {} });
-        if (this.debug) {
-            console.log('  [persist] Cleared all sessions');
-        }
-    }
-    /**
-     * Load raw data from file
-     */
-    loadRaw() {
-        if (!existsSync(SESSIONS_FILE)) {
-            return { version: STORE_VERSION, sessions: {} };
-        }
-        try {
-            return JSON.parse(readFileSync(SESSIONS_FILE, 'utf-8'));
-        }
-        catch {
-            return { version: STORE_VERSION, sessions: {} };
-        }
-    }
-    /**
-     * Write data atomically (write to temp file, then rename)
-     */
-    writeAtomic(data) {
-        const tempFile = `${SESSIONS_FILE}.tmp`;
-        writeFileSync(tempFile, JSON.stringify(data, null, 2), 'utf-8');
-        renameSync(tempFile, SESSIONS_FILE);
-    }
-}

package/dist/platform/client.d.ts

@@ -1,140 +0,0 @@
-import { EventEmitter } from 'events';
-import type { PlatformUser, PlatformPost, PlatformReaction, PlatformFile } from './types.js';
-import type { PlatformFormatter } from './formatter.js';
-/**
- * Events emitted by PlatformClient
- */
-export interface PlatformClientEvents {
-    connected: () => void;
-    disconnected: () => void;
-    error: (error: Error) => void;
-    message: (post: PlatformPost, user: PlatformUser | null) => void;
-    reaction: (reaction: PlatformReaction, user: PlatformUser | null) => void;
-}
-/**
- * Platform-agnostic client interface
- *
- * All platform implementations (Mattermost, Slack) must implement this interface.
- * This allows SessionManager and other code to work with any platform without
- * knowing the specific implementation details.
- */
-export interface PlatformClient extends EventEmitter {
-    /**
-     * Unique identifier for this platform instance
-     * e.g., 'mattermost-internal', 'slack-eng'
-     */
-    readonly platformId: string;
-    /**
-     * Platform type
-     * e.g., 'mattermost', 'slack'
-     */
-    readonly platformType: string;
-    /**
-     * Human-readable display name
-     * e.g., 'Internal Team', 'Engineering Slack'
-     */
-    readonly displayName: string;
-    /**
-     * Connect to the platform (WebSocket, Socket Mode, etc.)
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from the platform
-     */
-    disconnect(): void;
-    /**
-     * Get the bot's own user info
-     */
-    getBotUser(): Promise<PlatformUser>;
-    /**
-     * Get a user by their ID
-     */
-    getUser(userId: string): Promise<PlatformUser | null>;
-    /**
-     * Check if a username is in the allowed users list
-     */
-    isUserAllowed(username: string): boolean;
-    /**
-     * Get the bot's mention name (e.g., 'claude-code')
-     */
-    getBotName(): string;
-    /**
-     * Get platform config for MCP permission server
-     */
-    getMcpConfig(): {
-        type: string;
-        url: string;
-        token: string;
-        channelId: string;
-        allowedUsers: string[];
-    };
-    /**
-     * Get the platform-specific markdown formatter
-     * Use this to format bold, code, etc. in a platform-appropriate way.
-     */
-    getFormatter(): PlatformFormatter;
-    /**
-     * Create a new post/message
-     * @param message - Message text
-     * @param threadId - Optional thread parent ID
-     * @returns The created post
-     */
-    createPost(message: string, threadId?: string): Promise<PlatformPost>;
-    /**
-     * Update an existing post/message
-     * @param postId - Post ID to update
-     * @param message - New message text
-     * @returns The updated post
-     */
-    updatePost(postId: string, message: string): Promise<PlatformPost>;
-    /**
-     * Create a post with reaction options (for interactive prompts)
-     * @param message - Message text
-     * @param reactions - Array of emoji names to add as options
-     * @param threadId - Optional thread parent ID
-     * @returns The created post
-     */
-    createInteractivePost(message: string, reactions: string[], threadId?: string): Promise<PlatformPost>;
-    /**
-     * Get a post by ID
-     * @param postId - Post ID
-     * @returns The post, or null if not found/deleted
-     */
-    getPost(postId: string): Promise<PlatformPost | null>;
-    /**
-     * Add a reaction to a post
-     * @param postId - Post ID
-     * @param emojiName - Emoji name (e.g., '+1', 'white_check_mark')
-     */
-    addReaction(postId: string, emojiName: string): Promise<void>;
-    /**
-     * Check if a message mentions the bot
-     * @param message - Message text
-     */
-    isBotMentioned(message: string): boolean;
-    /**
-     * Extract the prompt from a message (remove bot mention)
-     * @param message - Message text
-     * @returns The message with bot mention removed
-     */
-    extractPrompt(message: string): string;
-    /**
-     * Send typing indicator to show bot is "thinking"
-     * @param threadId - Optional thread ID
-     */
-    sendTyping(threadId?: string): void;
-    /**
-     * Download a file attachment
-     * @param fileId - File ID
-     * @returns File contents as Buffer
-     */
-    downloadFile?(fileId: string): Promise<Buffer>;
-    /**
-     * Get file metadata
-     * @param fileId - File ID
-     * @returns File metadata
-     */
-    getFileInfo?(fileId: string): Promise<PlatformFile>;
-    on<K extends keyof PlatformClientEvents>(event: K, listener: PlatformClientEvents[K]): this;
-    emit<K extends keyof PlatformClientEvents>(event: K, ...args: Parameters<PlatformClientEvents[K]>): boolean;
-}

package/dist/platform/client.js

@@ -1 +0,0 @@
-export {};

package/dist/platform/formatter.d.ts

@@ -1,74 +0,0 @@
-/**
- * Platform-agnostic markdown formatter interface
- *
- * Different platforms have slightly different markdown dialects:
- * - Mattermost: Standard markdown (**bold**, _italic_, @username)
- * - Slack: mrkdwn (*bold*, _italic_, <@U123> for mentions)
- *
- * This interface abstracts those differences.
- */
-export interface PlatformFormatter {
-    /**
-     * Format text as bold
-     * Mattermost: **text**
-     * Slack: *text*
-     */
-    formatBold(text: string): string;
-    /**
-     * Format text as italic
-     * Mattermost: _text_ or *text*
-     * Slack: _text_
-     */
-    formatItalic(text: string): string;
-    /**
-     * Format text as inline code
-     * Both: `code`
-     */
-    formatCode(text: string): string;
-    /**
-     * Format text as code block with optional language
-     * Both: ```lang\ncode\n```
-     */
-    formatCodeBlock(code: string, language?: string): string;
-    /**
-     * Format a user mention
-     * Mattermost: @username
-     * Slack: <@U123456> (requires user ID)
-     */
-    formatUserMention(username: string, userId?: string): string;
-    /**
-     * Format a hyperlink
-     * Mattermost: [text](url)
-     * Slack: <url|text>
-     */
-    formatLink(text: string, url: string): string;
-    /**
-     * Format a bulleted list item
-     * Both: - item or * item
-     */
-    formatListItem(text: string): string;
-    /**
-     * Format a numbered list item
-     * Both: 1. item
-     */
-    formatNumberedListItem(number: number, text: string): string;
-    /**
-     * Format a blockquote
-     * Both: > text
-     */
-    formatBlockquote(text: string): string;
-    /**
-     * Format a horizontal rule
-     * Both: ---
-     */
-    formatHorizontalRule(): string;
-    /**
-     * Format a heading
-     * Both: # Heading (level 1), ## Heading (level 2), etc.
-     */
-    formatHeading(text: string, level: number): string;
-    /**
-     * Escape special characters in text to prevent formatting
-     */
-    escapeText(text: string): string;
-}

package/dist/platform/formatter.js

@@ -1 +0,0 @@
-export {};

package/dist/platform/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Platform abstraction layer
- *
- * This module provides platform-agnostic interfaces and types that allow
- * claude-threads to work with multiple chat platforms (Mattermost, Slack, etc.)
- * without coupling the core logic to any specific platform.
- */
-export type { PlatformClient, PlatformClientEvents } from './client.js';
-export type { PlatformFormatter } from './formatter.js';
-export type { PermissionApi, PermissionApiConfig, ReactionEvent, PostedMessage, } from './permission-api.js';
-export type { PlatformUser, PlatformPost, PlatformReaction, PlatformFile, CreatePostRequest, UpdatePostRequest, AddReactionRequest, } from './types.js';

package/dist/platform/index.js

@@ -1,8 +0,0 @@
-/**
- * Platform abstraction layer
- *
- * This module provides platform-agnostic interfaces and types that allow
- * claude-threads to work with multiple chat platforms (Mattermost, Slack, etc.)
- * without coupling the core logic to any specific platform.
- */
-export {};

package/dist/platform/mattermost/client.d.ts

@@ -1,70 +0,0 @@
-import { EventEmitter } from 'events';
-import type { MattermostPlatformConfig } from '../../config/migration.js';
-import type { PlatformClient, PlatformUser, PlatformPost, PlatformFile } from '../index.js';
-import type { PlatformFormatter } from '../formatter.js';
-export declare class MattermostClient extends EventEmitter implements PlatformClient {
-    readonly platformId: string;
-    readonly platformType: "mattermost";
-    readonly displayName: string;
-    private ws;
-    private url;
-    private token;
-    private channelId;
-    private botName;
-    private allowedUsers;
-    private reconnectAttempts;
-    private maxReconnectAttempts;
-    private reconnectDelay;
-    private userCache;
-    private botUserId;
-    private readonly formatter;
-    private pingInterval;
-    private lastMessageAt;
-    private readonly PING_INTERVAL_MS;
-    private readonly PING_TIMEOUT_MS;
-    constructor(platformConfig: MattermostPlatformConfig);
-    private normalizePlatformUser;
-    private normalizePlatformPost;
-    private normalizePlatformReaction;
-    private normalizePlatformFile;
-    private api;
-    getBotUser(): Promise<PlatformUser>;
-    getUser(userId: string): Promise<PlatformUser | null>;
-    createPost(message: string, threadId?: string): Promise<PlatformPost>;
-    updatePost(postId: string, message: string): Promise<PlatformPost>;
-    addReaction(postId: string, emojiName: string): Promise<void>;
-    /**
-     * Create a post with reaction options for user interaction
-     *
-     * This is a common pattern for interactive posts that need user response
-     * via reactions (e.g., approval prompts, questions, permission requests).
-     *
-     * @param message - Post message content
-     * @param reactions - Array of emoji names to add as reaction options
-     * @param threadId - Optional thread root ID
-     * @returns The created post
-     */
-    createInteractivePost(message: string, reactions: string[], threadId?: string): Promise<PlatformPost>;
-    downloadFile(fileId: string): Promise<Buffer>;
-    getFileInfo(fileId: string): Promise<PlatformFile>;
-    getPost(postId: string): Promise<PlatformPost | null>;
-    connect(): Promise<void>;
-    private handleEvent;
-    private scheduleReconnect;
-    private startHeartbeat;
-    private stopHeartbeat;
-    isUserAllowed(username: string): boolean;
-    isBotMentioned(message: string): boolean;
-    extractPrompt(message: string): string;
-    getBotName(): string;
-    getMcpConfig(): {
-        type: string;
-        url: string;
-        token: string;
-        channelId: string;
-        allowedUsers: string[];
-    };
-    getFormatter(): PlatformFormatter;
-    sendTyping(parentId?: string): void;
-    disconnect(): void;
-}