claudedesk 1.0.0

package/dist/core/claude-session-reader.js

@@ -0,0 +1,184 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+/**
+ * Convert a repo path to Claude's project folder name format
+ * e.g., C:\Users\carlo\Desktop\repos\my-app -> C--Users-carlo-Desktop-repos-my-app
+ */
+function pathToClaudeProjectName(repoPath) {
+    // Claude converts:
+    // - Colon (:) to dash (-)
+    // - Backslash (\) to dash (-)
+    // - Forward slash (/) to dash (-)
+    // So C:\Users\carlo becomes C--Users-carlo (colon and backslash both become dashes)
+    return repoPath
+        .replace(/:/g, '-')
+        .replace(/\\/g, '-')
+        .replace(/\//g, '-');
+}
+/**
+ * Get the Claude projects directory
+ */
+function getClaudeProjectsDir() {
+    return join(homedir(), '.claude', 'projects');
+}
+/**
+ * Read all Claude sessions for a given repository path
+ */
+export function getClaudeSessions(repoPath) {
+    const projectsDir = getClaudeProjectsDir();
+    const projectName = pathToClaudeProjectName(repoPath);
+    const projectDir = join(projectsDir, projectName);
+    console.log(`[ClaudeSessionReader] Looking for sessions:`);
+    console.log(`[ClaudeSessionReader]   Repo path: ${repoPath}`);
+    console.log(`[ClaudeSessionReader]   Project name: ${projectName}`);
+    console.log(`[ClaudeSessionReader]   Project dir: ${projectDir}`);
+    if (!existsSync(projectDir)) {
+        console.log(`[ClaudeSessionReader] No Claude project folder found at ${projectDir}`);
+        return [];
+    }
+    const sessions = [];
+    try {
+        const files = readdirSync(projectDir);
+        for (const file of files) {
+            if (!file.endsWith('.jsonl'))
+                continue;
+            const filePath = join(projectDir, file);
+            const sessionId = file.replace('.jsonl', '');
+            try {
+                const stat = statSync(filePath);
+                const content = readFileSync(filePath, 'utf-8');
+                const lines = content.split('\n').filter(line => line.trim());
+                if (lines.length === 0)
+                    continue;
+                // Parse session data
+                let summary = '';
+                let branch;
+                let messageCount = 0;
+                let firstUserMessage = '';
+                let lastTimestamp;
+                for (const line of lines) {
+                    try {
+                        const data = JSON.parse(line);
+                        // Get the first user message as the title (like Claude Code does)
+                        if (data.type === 'user' && data.message?.role === 'user' && data.message?.content) {
+                            messageCount++;
+                            if (!firstUserMessage) {
+                                // Extract first user message content
+                                const content = typeof data.message.content === 'string'
+                                    ? data.message.content
+                                    : Array.isArray(data.message.content)
+                                        ? data.message.content.find((c) => c.type === 'text')?.content || ''
+                                        : '';
+                                firstUserMessage = content.split('\n')[0].trim(); // First line only
+                            }
+                            // Track timestamp
+                            if (data.timestamp) {
+                                lastTimestamp = new Date(data.timestamp);
+                            }
+                        }
+                        // Count assistant messages too
+                        if (data.type === 'assistant' && data.message?.role === 'assistant') {
+                            messageCount++;
+                            if (data.timestamp) {
+                                lastTimestamp = new Date(data.timestamp);
+                            }
+                        }
+                        // Get git branch
+                        if (data.gitBranch && !branch) {
+                            branch = data.gitBranch;
+                        }
+                        // Also check for summaries as fallback
+                        if (data.type === 'summary' && data.summary && !summary) {
+                            summary = data.summary;
+                        }
+                    }
+                    catch {
+                        // Skip unparseable lines
+                    }
+                }
+                // Use first user message as title, fall back to summary
+                const displayTitle = firstUserMessage || summary || 'Untitled session';
+                sessions.push({
+                    id: sessionId,
+                    summary: displayTitle,
+                    timestamp: lastTimestamp || stat.mtime,
+                    messageCount,
+                    branch,
+                    filePath,
+                });
+            }
+            catch (error) {
+                console.error(`[ClaudeSessionReader] Error reading session ${file}:`, error);
+            }
+        }
+        // Sort by timestamp (most recent first)
+        sessions.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+        console.log(`[ClaudeSessionReader] Found ${sessions.length} sessions for ${repoPath}`);
+        return sessions;
+    }
+    catch (error) {
+        console.error('[ClaudeSessionReader] Error reading sessions:', error);
+        return [];
+    }
+}
+/**
+ * Format relative time (e.g., "10 minutes ago", "3 days ago")
+ */
+export function formatRelativeTime(date) {
+    const now = Date.now();
+    const diff = now - date.getTime();
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
+    if (weeks > 0)
+        return `${weeks} week${weeks > 1 ? 's' : ''} ago`;
+    if (days > 0)
+        return `${days} day${days > 1 ? 's' : ''} ago`;
+    if (hours > 0)
+        return `${hours} hour${hours > 1 ? 's' : ''} ago`;
+    if (minutes > 0)
+        return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;
+    return 'just now';
+}
+/**
+ * Format session list for display (similar to Claude Code's /resume output)
+ */
+export function formatSessionList(sessions, limit = 20) {
+    if (sessions.length === 0) {
+        return '*No Claude sessions found for this repository.*\n\nStart a conversation to create your first session.';
+    }
+    const displaySessions = sessions.slice(0, limit);
+    const lines = displaySessions.map((session, index) => {
+        const relTime = formatRelativeTime(session.timestamp);
+        const msgCount = session.messageCount;
+        const branch = session.branch ? ` · ${session.branch}` : '';
+        // Truncate summary if too long
+        const maxSummaryLen = 80;
+        const summary = session.summary.length > maxSummaryLen
+            ? session.summary.slice(0, maxSummaryLen) + '...'
+            : session.summary;
+        return `**${index + 1}.** ${summary}\n   _${relTime} · ${msgCount} messages${branch}_`;
+    });
+    const header = `**Resume Session** _(${sessions.length} sessions)_\n`;
+    const footer = sessions.length > limit
+        ? `\n\n_Showing ${limit} of ${sessions.length} sessions_`
+        : '';
+    const instructions = '\n\n_Type \`/resume <number>\` to resume a session, or use tabs to switch ClaudeDesk sessions._';
+    return header + '\n' + lines.join('\n\n') + footer + instructions;
+}
+/**
+ * Get a specific session by index (1-based) or ID
+ */
+export function getSessionByRef(sessions, ref) {
+    // Try as number first (1-based index)
+    const num = parseInt(ref, 10);
+    if (!isNaN(num) && num > 0 && num <= sessions.length) {
+        return sessions[num - 1];
+    }
+    // Try as session ID
+    return sessions.find(s => s.id === ref || s.id.startsWith(ref));
+}
+//# sourceMappingURL=claude-session-reader.js.map

package/dist/core/claude-session-reader.js.map

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

package/dist/core/claude-usage-query.d.ts

@@ -0,0 +1,78 @@
+import { ClaudeUsageQuota } from '../types.js';
+/**
+ * Processed usage data for display
+ */
+export interface ClaudeUsageStats {
+    today: {
+        messageCount: number;
+        sessionCount: number;
+        toolCallCount: number;
+        tokensByModel: Record<string, number>;
+    };
+    week: {
+        messageCount: number;
+        sessionCount: number;
+        toolCallCount: number;
+        tokensByModel: Record<string, number>;
+    };
+    modelUsage: Record<string, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheCreationTokens: number;
+    }>;
+    totalSessions: number;
+    totalMessages: number;
+    firstSessionDate: string | null;
+    lastUpdated: string;
+}
+/**
+ * Query Claude Code's local stats cache file.
+ * Results are cached for 30 seconds.
+ *
+ * @param forceRefresh - If true, bypasses the cache
+ * @returns Parsed usage stats, or null if unavailable
+ */
+export declare function queryClaudeUsage(forceRefresh?: boolean): Promise<ClaudeUsageStats | null>;
+/**
+ * Clear the usage cache.
+ */
+export declare function clearUsageCache(): void;
+/**
+ * Check if Claude usage data is available.
+ */
+export declare function hasClaudeUsage(): Promise<boolean>;
+/**
+ * Format model name for display (extract short name)
+ */
+export declare function formatModelName(modelId: string): string;
+/**
+ * Format token count for display
+ */
+export declare function formatTokenCount(tokens: number): string;
+/**
+ * Query Claude usage quota from the Anthropic OAuth API.
+ *
+ * This calls: GET https://api.anthropic.com/api/oauth/usage
+ * Returns the 5-hour and 7-day utilization buckets.
+ *
+ * @param forceRefresh - If true, bypasses the cache
+ */
+export declare function queryClaudeQuota(forceRefresh?: boolean): Promise<ClaudeUsageQuota | null>;
+/**
+ * Clear the quota cache.
+ */
+export declare function clearQuotaCache(): void;
+/**
+ * Check if Claude quota data is available.
+ */
+export declare function hasClaudeQuota(): Promise<boolean>;
+/**
+ * Format quota percentage for display
+ */
+export declare function formatQuotaPercent(utilization: number): string;
+/**
+ * Get time until quota reset in human-readable format
+ */
+export declare function getTimeUntilReset(resetsAt: string): string;
+//# sourceMappingURL=claude-usage-query.d.ts.map

package/dist/core/claude-usage-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-usage-query.d.ts","sourceRoot":"","sources":["../../src/core/claude-usage-query.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAwC/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;IAEF,IAAI,EAAE;QACJ,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;IAEF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IAEH,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AA+ED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA8B7F;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvD;AAiFD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA4D7F;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc1D"}

package/dist/core/claude-usage-query.js

@@ -0,0 +1,294 @@
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// Cache for usage data
+let cachedStats = null;
+let cacheTimestamp = 0;
+const CACHE_TTL_MS = 30_000; // 30 seconds cache
+/**
+ * Get the path to Claude Code's stats-cache.json file
+ */
+function getStatsCachePath() {
+    return join(homedir(), '.claude', 'stats-cache.json');
+}
+/**
+ * Parse the stats-cache.json and compute usage stats
+ */
+function parseStatsCache(raw) {
+    const now = new Date();
+    const todayStr = now.toISOString().split('T')[0];
+    // Calculate week start (Sunday)
+    const dayOfWeek = now.getDay();
+    const weekStart = new Date(now);
+    weekStart.setDate(now.getDate() - dayOfWeek);
+    weekStart.setHours(0, 0, 0, 0);
+    // Today's activity
+    const todayActivity = raw.dailyActivity.find(d => d.date === todayStr);
+    const todayTokens = raw.dailyModelTokens.find(d => d.date === todayStr);
+    // Week's activity (sum of last 7 days from week start)
+    const weekActivity = raw.dailyActivity
+        .filter(d => new Date(d.date) >= weekStart)
+        .reduce((acc, day) => ({
+        messageCount: acc.messageCount + day.messageCount,
+        sessionCount: acc.sessionCount + day.sessionCount,
+        toolCallCount: acc.toolCallCount + day.toolCallCount,
+    }), { messageCount: 0, sessionCount: 0, toolCallCount: 0 });
+    // Week's tokens by model
+    const weekTokensByModel = {};
+    raw.dailyModelTokens
+        .filter(d => new Date(d.date) >= weekStart)
+        .forEach(day => {
+        Object.entries(day.tokensByModel).forEach(([model, tokens]) => {
+            weekTokensByModel[model] = (weekTokensByModel[model] || 0) + tokens;
+        });
+    });
+    return {
+        today: {
+            messageCount: todayActivity?.messageCount || 0,
+            sessionCount: todayActivity?.sessionCount || 0,
+            toolCallCount: todayActivity?.toolCallCount || 0,
+            tokensByModel: todayTokens?.tokensByModel || {},
+        },
+        week: {
+            ...weekActivity,
+            tokensByModel: weekTokensByModel,
+        },
+        modelUsage: Object.fromEntries(Object.entries(raw.modelUsage).map(([model, usage]) => [
+            model,
+            {
+                inputTokens: usage.inputTokens,
+                outputTokens: usage.outputTokens,
+                cacheReadTokens: usage.cacheReadInputTokens,
+                cacheCreationTokens: usage.cacheCreationInputTokens,
+            },
+        ])),
+        totalSessions: raw.totalSessions,
+        totalMessages: raw.totalMessages,
+        firstSessionDate: raw.firstSessionDate || null,
+        lastUpdated: new Date().toISOString(),
+    };
+}
+/**
+ * Query Claude Code's local stats cache file.
+ * Results are cached for 30 seconds.
+ *
+ * @param forceRefresh - If true, bypasses the cache
+ * @returns Parsed usage stats, or null if unavailable
+ */
+export async function queryClaudeUsage(forceRefresh = false) {
+    const now = Date.now();
+    // Return cached data if still valid
+    if (!forceRefresh && cachedStats && (now - cacheTimestamp) < CACHE_TTL_MS) {
+        return cachedStats;
+    }
+    try {
+        const statsPath = getStatsCachePath();
+        if (!existsSync(statsPath)) {
+            console.log('[claude-usage-query] Stats cache file not found:', statsPath);
+            return cachedStats; // Return stale cache if available
+        }
+        const content = readFileSync(statsPath, 'utf-8');
+        const raw = JSON.parse(content);
+        const parsed = parseStatsCache(raw);
+        cachedStats = parsed;
+        cacheTimestamp = now;
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.log('[claude-usage-query] Error reading stats cache:', error.message);
+        }
+        return cachedStats; // Return stale cache if available
+    }
+}
+/**
+ * Clear the usage cache.
+ */
+export function clearUsageCache() {
+    cacheTimestamp = 0;
+}
+/**
+ * Check if Claude usage data is available.
+ */
+export async function hasClaudeUsage() {
+    const stats = await queryClaudeUsage();
+    return stats !== null;
+}
+/**
+ * Format model name for display (extract short name)
+ */
+export function formatModelName(modelId) {
+    if (modelId.includes('opus'))
+        return 'Opus';
+    if (modelId.includes('sonnet'))
+        return 'Sonnet';
+    if (modelId.includes('haiku'))
+        return 'Haiku';
+    return modelId.split('-').slice(1, 3).join(' ');
+}
+/**
+ * Format token count for display
+ */
+export function formatTokenCount(tokens) {
+    if (tokens < 1000)
+        return tokens.toString();
+    if (tokens < 1_000_000)
+        return `${(tokens / 1000).toFixed(1)}K`;
+    if (tokens < 1_000_000_000)
+        return `${(tokens / 1_000_000).toFixed(1)}M`;
+    return `${(tokens / 1_000_000_000).toFixed(2)}B`;
+}
+// ============================================================================
+// Claude OAuth Quota API
+// ============================================================================
+// Cache for quota data
+let cachedQuota = null;
+let quotaCacheTimestamp = 0;
+const QUOTA_CACHE_TTL_MS = 60_000; // 1 minute cache
+/**
+ * Get Claude Code OAuth token from local storage.
+ *
+ * Claude Code stores credentials in ~/.claude/.credentials.json
+ * under the 'claudeAiOauth' key.
+ */
+async function getClaudeOAuthToken() {
+    // Primary location: ~/.claude/.credentials.json
+    const credentialsPath = join(homedir(), '.claude', '.credentials.json');
+    if (existsSync(credentialsPath)) {
+        try {
+            const content = readFileSync(credentialsPath, 'utf-8');
+            const creds = JSON.parse(content);
+            if (creds.claudeAiOauth?.accessToken) {
+                // Check if token is expired
+                if (creds.claudeAiOauth.expiresAt) {
+                    const expiresAt = new Date(creds.claudeAiOauth.expiresAt);
+                    if (expiresAt <= new Date()) {
+                        console.log('[claude-usage-query] OAuth token is expired');
+                        // Token is expired, but we'll still try it - the API will tell us for sure
+                    }
+                }
+                console.log('[claude-usage-query] Found token in .credentials.json');
+                return creds.claudeAiOauth.accessToken;
+            }
+        }
+        catch (error) {
+            console.log('[claude-usage-query] Error reading .credentials.json:', error);
+        }
+    }
+    // Fallback: Check for older credentials.json format (without dot prefix)
+    const oldCredentialsPath = join(homedir(), '.claude', 'credentials.json');
+    if (existsSync(oldCredentialsPath)) {
+        try {
+            const content = readFileSync(oldCredentialsPath, 'utf-8');
+            const creds = JSON.parse(content);
+            // Try both formats
+            const token = creds.claudeAiOauth?.accessToken || creds.accessToken;
+            if (token) {
+                console.log('[claude-usage-query] Found token in credentials.json (legacy)');
+                return token;
+            }
+        }
+        catch (error) {
+            console.log('[claude-usage-query] Error reading credentials.json:', error);
+        }
+    }
+    console.log('[claude-usage-query] No OAuth token found in', credentialsPath);
+    return null;
+}
+/**
+ * Query Claude usage quota from the Anthropic OAuth API.
+ *
+ * This calls: GET https://api.anthropic.com/api/oauth/usage
+ * Returns the 5-hour and 7-day utilization buckets.
+ *
+ * @param forceRefresh - If true, bypasses the cache
+ */
+export async function queryClaudeQuota(forceRefresh = false) {
+    const now = Date.now();
+    // Return cached data if still valid
+    if (!forceRefresh && cachedQuota && (now - quotaCacheTimestamp) < QUOTA_CACHE_TTL_MS) {
+        return cachedQuota;
+    }
+    try {
+        const token = await getClaudeOAuthToken();
+        if (!token) {
+            console.log('[claude-usage-query] No OAuth token available for quota query');
+            return cachedQuota; // Return stale cache if available
+        }
+        const response = await fetch('https://api.anthropic.com/api/oauth/usage', {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'anthropic-beta': 'oauth-2025-04-20',
+                'Accept': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            console.log(`[claude-usage-query] Quota API error (${response.status}):`, errorText);
+            return cachedQuota; // Return stale cache
+        }
+        const data = await response.json();
+        // Parse the response - API returns utilization as 0-100, we normalize to 0-1
+        const quota = {
+            five_hour: {
+                utilization: (data.five_hour?.utilization ?? 0) / 100,
+                resets_at: data.five_hour?.resets_at ?? new Date().toISOString(),
+            },
+            seven_day: {
+                utilization: (data.seven_day?.utilization ?? 0) / 100,
+                resets_at: data.seven_day?.resets_at ?? new Date().toISOString(),
+            },
+            lastUpdated: new Date().toISOString(),
+        };
+        cachedQuota = quota;
+        quotaCacheTimestamp = now;
+        console.log('[claude-usage-query] Quota fetched successfully:', {
+            fiveHour: `${(quota.five_hour.utilization * 100).toFixed(1)}%`,
+            sevenDay: `${(quota.seven_day.utilization * 100).toFixed(1)}%`,
+        });
+        return quota;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.log('[claude-usage-query] Error fetching quota:', error.message);
+        }
+        return cachedQuota; // Return stale cache if available
+    }
+}
+/**
+ * Clear the quota cache.
+ */
+export function clearQuotaCache() {
+    quotaCacheTimestamp = 0;
+}
+/**
+ * Check if Claude quota data is available.
+ */
+export async function hasClaudeQuota() {
+    const quota = await queryClaudeQuota();
+    return quota !== null;
+}
+/**
+ * Format quota percentage for display
+ */
+export function formatQuotaPercent(utilization) {
+    return `${(utilization * 100).toFixed(1)}%`;
+}
+/**
+ * Get time until quota reset in human-readable format
+ */
+export function getTimeUntilReset(resetsAt) {
+    const now = new Date();
+    const resetTime = new Date(resetsAt);
+    const diffMs = resetTime.getTime() - now.getTime();
+    if (diffMs <= 0)
+        return 'now';
+    const hours = Math.floor(diffMs / (1000 * 60 * 60));
+    const minutes = Math.floor((diffMs % (1000 * 60 * 60)) / (1000 * 60));
+    if (hours > 0) {
+        return `${hours}h ${minutes}m`;
+    }
+    return `${minutes}m`;
+}
+//# sourceMappingURL=claude-usage-query.js.map

package/dist/core/claude-usage-query.js.map

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

package/dist/core/git-credential-helper.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Creates a temporary credential helper script that returns the OAuth token.
+ * The script is compatible with git's credential helper protocol.
+ * @param token - The OAuth access token
+ * @param platform - The git platform ('github' or 'gitlab')
+ * @returns Path to the temporary credential helper script
+ */
+export declare function createCredentialHelperScript(token: string, platform: 'github' | 'gitlab'): string;
+/**
+ * Removes a temporary credential helper script.
+ * SEC-06: Improved cleanup with logging for debugging failed deletions.
+ * @param scriptPath - Path to the script to remove
+ */
+export declare function removeCredentialHelperScript(scriptPath: string): void;
+/**
+ * Get environment variables to inject for git authentication.
+ * These environment variables enable git to use the OAuth token for HTTPS operations.
+ *
+ * @param token - The OAuth access token
+ * @param platform - The git platform ('github' or 'gitlab')
+ * @param username - Optional username (defaults based on platform)
+ * @returns Record of environment variables to set
+ */
+export declare function getGitCredentialEnv(token: string, platform: 'github' | 'gitlab', username?: string): Record<string, string>;
+/**
+ * Clean up any temporary files created by getGitCredentialEnv.
+ * Call this after git operations complete.
+ *
+ * @param env - The environment object returned by getGitCredentialEnv
+ */
+export declare function cleanupGitCredentialEnv(env: Record<string, string>): void;
+/**
+ * Configure git to use token authentication for a specific remote URL.
+ * This modifies the URL to include the token inline (for temporary use).
+ *
+ * @param remoteUrl - The original remote URL (e.g., https://github.com/user/repo.git)
+ * @param token - The OAuth access token
+ * @param platform - The git platform
+ * @returns The modified URL with embedded credentials
+ */
+export declare function getAuthenticatedRemoteUrl(remoteUrl: string, token: string, platform: 'github' | 'gitlab'): string;
+/**
+ * Detect the git platform from a remote URL.
+ *
+ * @param remoteUrl - The remote URL to analyze
+ * @returns 'github', 'gitlab', or null if unknown
+ */
+export declare function detectPlatformFromUrl(remoteUrl: string): 'github' | 'gitlab' | null;
+/**
+ * Check if a remote URL is using HTTPS (vs SSH).
+ * OAuth tokens only work with HTTPS remotes.
+ *
+ * @param remoteUrl - The remote URL to check
+ * @returns true if the URL is HTTPS
+ */
+export declare function isHttpsRemote(remoteUrl: string): boolean;
+//# sourceMappingURL=git-credential-helper.d.ts.map

package/dist/core/git-credential-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-credential-helper.d.ts","sourceRoot":"","sources":["../../src/core/git-credential-helper.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAkCjG;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAerE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8BxB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAC5B,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAYnF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD"}