edsger 0.77.0 → 0.79.0

package/dist/utils/logger.js

@@ -1,167 +0,0 @@
-import { callMcpEndpoint } from '../api/mcp-client.js';
-import { getUserId } from '../auth/auth-store.js';
-import { getVersion } from '../constants.js';
-import { ensureSupabaseSession, getSupabase } from '../supabase/client.js';
-export const colors = {
-    reset: '\x1b[0m',
-    bright: '\x1b[1m',
-    red: '\x1b[31m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    cyan: '\x1b[36m',
-    gray: '\x1b[90m',
-};
-export const colorize = (text, color) => {
-    return `${colors[color]}${text}${colors.reset}`;
-};
-/**
- * Get version prefix for log lines
- */
-const versionPrefix = () => {
-    const v = getVersion();
-    return `[v${v}]`;
-};
-let _logBuffer = [];
-let _logSyncSessionId = null;
-let _logFlushTimer;
-/** How often to flush logs to server (5 seconds) */
-const LOG_FLUSH_INTERVAL = 5_000;
-/** Max buffer size before forcing a flush */
-const LOG_BUFFER_MAX = 50;
-function bufferLog(level, message) {
-    if (!_logSyncSessionId) {
-        return;
-    }
-    _logBuffer.push({ level, message, created_at: new Date().toISOString() });
-    if (_logBuffer.length >= LOG_BUFFER_MAX) {
-        flushLogs().catch(() => {
-            /* noop */
-        });
-    }
-}
-/**
- * Flush buffered logs to the server. Best-effort, failures are silent.
- */
-export async function flushLogs() {
-    if (!_logSyncSessionId || _logBuffer.length === 0) {
-        return;
-    }
-    const batch = _logBuffer.splice(0);
-    const sessionId = _logSyncSessionId;
-    try {
-        const userId = getUserId();
-        if (userId && (await ensureSupabaseSession())) {
-            // Direct-SDK path. user_id is set explicitly per row to satisfy the
-            // cli_logs RLS check (auth.uid() = user_id). Gating on a confirmed
-            // session keeps a stale token (→ anon) from writing as anon and tripping
-            // RLS — desktop refreshes the token into auth.json before spawning.
-            const rows = batch.slice(0, 200).map((log) => ({
-                session_id: sessionId,
-                user_id: userId,
-                level: log.level,
-                message: log.message,
-                created_at: log.created_at,
-            }));
-            const { error } = await getSupabase().from('cli_logs').insert(rows);
-            if (error) {
-                throw new Error(error.message);
-            }
-        }
-        else {
-            await callMcpEndpoint('cli_logs/batch', {
-                session_id: sessionId,
-                logs: batch,
-            });
-        }
-    }
-    catch {
-        // Best-effort: put logs back if send fails (drop if buffer is huge)
-        if (_logBuffer.length < 500) {
-            _logBuffer.unshift(...batch);
-        }
-    }
-}
-/**
- * Start log sync for a CLI session. Call after session registration.
- */
-export function initLogSync(sessionId) {
-    _logSyncSessionId = sessionId;
-    _logBuffer = [];
-    _logFlushTimer = setInterval(() => {
-        flushLogs().catch(() => {
-            /* noop */
-        });
-    }, LOG_FLUSH_INTERVAL);
-}
-/**
- * Stop log sync and flush remaining logs. Call before session deregistration.
- */
-export async function stopLogSync() {
-    if (_logFlushTimer) {
-        clearInterval(_logFlushTimer);
-        _logFlushTimer = undefined;
-    }
-    await flushLogs();
-    _logSyncSessionId = null;
-}
-// ---- Logger Functions ----
-export const logInfo = (message) => {
-    console.log(colorize(`${versionPrefix()} ℹ ${message}`, 'blue'));
-    bufferLog('info', message);
-};
-export const logSuccess = (message) => {
-    console.log(colorize(`${versionPrefix()} ✓ ${message}`, 'green'));
-    bufferLog('success', message);
-};
-export const logWarning = (message) => {
-    console.log(colorize(`${versionPrefix()} ⚠ ${message}`, 'yellow'));
-    bufferLog('warning', message);
-};
-export const logError = (message) => {
-    console.error(colorize(`${versionPrefix()} ✗ ${message}`, 'red'));
-    bufferLog('error', message);
-};
-/** Verbose-only debug logging. Only outputs when verbose is true. */
-export const logDebug = (message, verbose) => {
-    if (!verbose) {
-        return;
-    }
-    console.log(colorize(`${versionPrefix()} 🔍 ${message}`, 'gray'));
-    bufferLog('info', `[debug] ${message}`);
-};
-/** Raw output without version prefix. For streaming AI responses, formatting, etc. */
-export const logRaw = (message) => {
-    console.log(message);
-};
-export const logProgress = (current, total, file) => {
-    const percentage = Math.round((current / total) * 100);
-    const progress = `[${current}/${total}] ${percentage}%`;
-    console.log(colorize(`${progress} Reviewing ${file}`, 'gray'));
-    bufferLog('info', `${progress} Reviewing ${file}`);
-};
-export const logResults = (results, verbose = false) => {
-    const okCount = results.filter((r) => r.status === 'OK').length;
-    const warnCount = results.filter((r) => r.status === 'WARN').length;
-    const blockCount = results.filter((r) => r.status === 'BLOCK').length;
-    console.log(`\n${colorize('='.repeat(60), 'gray')}`);
-    console.log(colorize('Review Results', 'bright'));
-    console.log(colorize('='.repeat(60), 'gray'));
-    results.forEach((result) => {
-        const nonOkIcon = result.status === 'WARN' ? '⚠' : '✗';
-        const icon = result.status === 'OK' ? '✓' : nonOkIcon;
-        const nonOkColor = result.status === 'WARN' ? 'yellow' : 'red';
-        const color = result.status === 'OK' ? 'green' : nonOkColor;
-        console.log(colorize(`${icon} ${result.file}: ${result.message}`, color));
-        if (verbose && result.details && result.status !== 'OK') {
-            console.log(colorize(`   Details: ${result.details}`, 'gray'));
-        }
-    });
-    console.log(`\n${colorize('Summary:', 'bright')}`);
-    console.log(colorize(`  ✓ Passed: ${okCount}`, 'green'));
-    console.log(colorize(`  ⚠ Warnings: ${warnCount}`, 'yellow'));
-    console.log(colorize(`  ✗ Blocked: ${blockCount}`, 'red'));
-    console.log(colorize(`  Total: ${results.length} files reviewed`, 'gray'));
-    bufferLog('info', `Review complete: ${okCount} passed, ${warnCount} warnings, ${blockCount} blocked (${results.length} files)`);
-};

package/dist/utils/pipeline-logger.d.ts

@@ -1,8 +0,0 @@
-/**
- * Logging utilities for pipeline execution
- */
-import { type PipelineResult } from '../types/pipeline.js';
-export declare const logPipelineStart: (issueId: string, verbose?: boolean) => void;
-export declare const logPhaseResult: (result: PipelineResult, verbose?: boolean) => PipelineResult;
-export declare const logPipelineComplete: (results: readonly PipelineResult[], verbose?: boolean) => readonly PipelineResult[];
-export declare const shouldContinuePipeline: (results: readonly PipelineResult[]) => boolean;

package/dist/utils/pipeline-logger.js

@@ -1,38 +0,0 @@
-/**
- * Logging utilities for pipeline execution
- */
-import { logDebug, logError, logSuccess } from './logger.js';
-// Pipeline execution utilities
-export const logPipelineStart = (issueId, verbose) => {
-    logDebug(`Starting complete pipeline for issue: ${issueId}`, verbose);
-    logDebug('Pipeline phases: issue-analysis → technical-design → code-implementation → functional-testing', verbose);
-};
-export const logPhaseResult = (result, verbose) => {
-    if (verbose) {
-        if (result.status === 'success') {
-            logSuccess(`${result.phase}: ${result.message}`);
-        }
-        else {
-            logError(`${result.phase}: ${result.message}`);
-        }
-    }
-    return result;
-};
-export const logPipelineComplete = (results, verbose) => {
-    if (verbose) {
-        const lastResult = results[results.length - 1];
-        const issueId = lastResult?.issueId;
-        if (lastResult?.status === 'success') {
-            logSuccess(`Complete pipeline finished successfully for issue: ${issueId}`);
-        }
-        else {
-            logError(`Pipeline failed at ${lastResult?.phase}: ${lastResult?.message}`);
-        }
-    }
-    return results;
-};
-// Pure function to check if pipeline should continue
-export const shouldContinuePipeline = (results) => {
-    const lastResult = results[results.length - 1];
-    return lastResult?.status === 'success';
-};

package/dist/utils/validation.d.ts

@@ -1,68 +0,0 @@
-import { loadConfig } from '../config.js';
-import { type CliOptions } from '../types/index.js';
-/**
- * Determine the correct npm install target for optional dependencies.
- *
- * `Function('return import("pkg")')()` resolves from the edsger module's
- * own location, walking up the node_modules chain.  We need to install
- * packages into a directory that sits on that resolution path.
- *
- * - Source checkout / monorepo  → `npm install` in the edsger package dir
- * - Project dependency  → `npm install` in the project root (has package.json)
- * - Global-style install  → `npm install -g --prefix <prefix>`
- *
- * The global-style case covers both a plain `npm install -g edsger` and the
- * desktop app's managed install (`npm install -g edsger --prefix <userData>/cli`).
- * In both, edsger lives at `<prefix>/lib/node_modules/edsger` (or
- * `<prefix>/node_modules/edsger` on Windows) and there is NO package.json at
- * the directory that owns that node_modules. Running a *project-local*
- * `npm install` there would treat every already-installed package — including
- * edsger and all its dependencies — as extraneous and PRUNE them, destroying
- * the install. We must install with `--prefix` into the same prefix instead.
- */
-export interface NpmInstallTarget {
-    global: boolean;
-    cwd?: string;
-    prefix?: string;
-}
-/**
- * Pure resolution of the npm install target, given edsger's own directory and
- * a predicate for testing whether a path exists. Separated from
- * {@link getNpmInstallTarget} so it can be unit-tested without touching the
- * real filesystem or `import.meta.url`.
- */
-export declare function resolveNpmInstallTarget(edsgerDir: string, fileExists: (p: string) => boolean): NpmInstallTarget;
-export interface ValidationResult {
-    config: ReturnType<typeof loadConfig>;
-    mcpServerUrl: string;
-    mcpToken: string;
-}
-/**
- * Common configuration validation for all CLI commands
- */
-export declare const validateConfiguration: (options: CliOptions) => ReturnType<typeof loadConfig>;
-/**
- * Validate MCP environment variables and URL format
- */
-export declare const validateMCPEnvironment: () => {
-    mcpServerUrl: string;
-    mcpToken: string;
-};
-/**
- * Combined validation for commands that need both config and MCP setup
- */
-export declare const validateCommandEnvironment: (options: CliOptions) => ValidationResult;
-/**
- * Ensure Playwright is installed, auto-installing if necessary.
- * Installs the npm package where edsger's module resolution can find it,
- * plus the Chromium browser binary.
- */
-export declare const ensurePlaywright: (checkFunction: () => Promise<boolean>) => Promise<void>;
-/**
- * Ensure an npm package is installed, auto-installing if necessary.
- */
-export declare const ensureNpmPackage: (checkFunction: () => Promise<boolean>, packageName: string) => Promise<void>;
-/**
- * Ensure ffmpeg is installed, auto-installing via Homebrew on macOS if possible.
- */
-export declare const ensureFFmpeg: (checkFunction: () => boolean) => void;

package/dist/utils/validation.js

@@ -1,229 +0,0 @@
-import { execSync, spawnSync } from 'child_process';
-import { existsSync } from 'fs';
-import { basename, dirname, join, resolve, sep } from 'path';
-import { fileURLToPath } from 'url';
-import { getMcpServerUrl, getMcpToken } from '../auth/auth-store.js';
-import { loadConfig, validateConfig } from '../config.js';
-import { logInfo, logWarning } from './logger.js';
-/**
- * Pure resolution of the npm install target, given edsger's own directory and
- * a predicate for testing whether a path exists. Separated from
- * {@link getNpmInstallTarget} so it can be unit-tested without touching the
- * real filesystem or `import.meta.url`.
- */
-export function resolveNpmInstallTarget(edsgerDir, fileExists) {
-    const nodeModulesSegment = `${sep}node_modules${sep}`;
-    if (!edsgerDir.includes(nodeModulesSegment)) {
-        // Source checkout / monorepo — install in edsger's own package dir
-        return { global: false, cwd: edsgerDir };
-    }
-    // edsger is inside some node_modules tree. The directory that owns the
-    // outermost node_modules containing edsger is the candidate install root.
-    const installRoot = edsgerDir.split(nodeModulesSegment)[0];
-    // A real project dependency has a package.json at that root, so a
-    // project-local install safely adds to its dependencies without pruning.
-    if (fileExists(join(installRoot, 'package.json'))) {
-        return { global: false, cwd: installRoot };
-    }
-    // No package.json → global-style install. Derive the npm prefix so the
-    // package lands on edsger's resolution path. Unix global installs nest
-    // under `<prefix>/lib`; Windows installs put node_modules directly under
-    // `<prefix>`.
-    const prefix = basename(installRoot) === 'lib' ? dirname(installRoot) : installRoot;
-    return { global: true, prefix };
-}
-/**
- * Determine the correct npm install target for optional dependencies.
- *
- * `Function('return import("pkg")')()` resolves from the edsger module's
- * own location, walking up the node_modules chain.  We need to install
- * packages into a directory that sits on that resolution path.
- *
- * - Source checkout / monorepo  → `npm install` in the edsger package dir
- * - Project dependency  → `npm install` in the project root (has package.json)
- * - Global-style install  → `npm install -g --prefix <prefix>`
- *
- * The global-style case covers both a plain `npm install -g edsger` and the
- * desktop app's managed install (`npm install -g edsger --prefix <userData>/cli`).
- * In both, edsger lives at `<prefix>/lib/node_modules/edsger` (or
- * `<prefix>/node_modules/edsger` on Windows) and there is NO package.json at
- * the directory that owns that node_modules. Running a *project-local*
- * `npm install` there would treat every already-installed package — including
- * edsger and all its dependencies — as extraneous and PRUNE them, destroying
- * the install. We must install with `--prefix` into the same prefix instead.
- */
-function getNpmInstallTarget() {
-    const edsgerDir = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
-    return resolveNpmInstallTarget(edsgerDir, existsSync);
-}
-/**
- * Common configuration validation for all CLI commands
- */
-export const validateConfiguration = (options) => {
-    const config = loadConfig(options.config);
-    const configErrors = validateConfig(config);
-    if (configErrors.length > 0) {
-        throw new Error(`Configuration errors:\n${configErrors.map((e) => `  - ${e}`).join('\n')}`);
-    }
-    if (options.verbose) {
-        logInfo('Configuration loaded successfully');
-    }
-    return config;
-};
-/**
- * Validate MCP environment variables and URL format
- */
-export const validateMCPEnvironment = () => {
-    const mcpServerUrl = getMcpServerUrl();
-    const mcpToken = getMcpToken();
-    if (!mcpServerUrl) {
-        throw new Error('Not authenticated. Run `edsger login` or set EDSGER_MCP_SERVER_URL environment variable.');
-    }
-    if (!mcpToken) {
-        throw new Error('Not authenticated. Run `edsger login` or set EDSGER_MCP_TOKEN environment variable.');
-    }
-    // Validate MCP server URL format
-    try {
-        new URL(mcpServerUrl);
-    }
-    catch {
-        throw new Error('Invalid MCP server URL format. Use http:// or https://');
-    }
-    return { mcpServerUrl, mcpToken };
-};
-/**
- * Combined validation for commands that need both config and MCP setup
- */
-export const validateCommandEnvironment = (options) => {
-    const config = validateConfiguration(options);
-    const { mcpServerUrl, mcpToken } = validateMCPEnvironment();
-    return {
-        config,
-        mcpServerUrl,
-        mcpToken,
-    };
-};
-/**
- * Re-exec the current CLI command in a fresh process.
- * Node.js caches failed module resolutions for the lifetime of a process,
- * so after installing a new package we must restart to pick it up.
- * An env flag prevents infinite restart loops.
- */
-const restartProcess = (envFlag) => {
-    const result = spawnSync(process.argv[0], process.argv.slice(1), {
-        stdio: 'inherit',
-        env: { ...process.env, [envFlag]: '1' },
-    });
-    return process.exit(result.status ?? 1);
-};
-/**
- * Run `npm install <pkg>` targeting the correct location for edsger's
- * module resolution chain.
- */
-function npmInstall(packageName) {
-    const target = getNpmInstallTarget();
-    const globalFlag = target.global ? ' -g' : '';
-    const prefixFlag = target.prefix ? ` --prefix "${target.prefix}"` : '';
-    const cmd = `npm install${globalFlag}${prefixFlag} ${packageName}`;
-    logInfo(`  $ ${cmd}${target.cwd ? ` (in ${target.cwd})` : ''}`);
-    execSync(cmd, { cwd: target.cwd, stdio: 'inherit' });
-}
-/**
- * Ensure Playwright is installed, auto-installing if necessary.
- * Installs the npm package where edsger's module resolution can find it,
- * plus the Chromium browser binary.
- */
-export const ensurePlaywright = async (checkFunction) => {
-    if (await checkFunction()) {
-        return;
-    }
-    // Already attempted install in a previous run — don't loop
-    if (process.env.__EDSGER_PW_INSTALLED) {
-        throw new Error('Playwright auto-install succeeded but it is still not loadable.\n\n' +
-            '  Please install it manually:\n\n' +
-            '    npm install playwright\n' +
-            '    npx playwright install chromium\n\n' +
-            '  Then re-run this command. Use --listings-only to skip screenshots.');
-    }
-    logWarning('Playwright is not installed. Installing automatically (this may take a minute)...');
-    try {
-        npmInstall('playwright');
-        logInfo('  Installing Chromium browser...');
-        execSync('npx playwright install chromium', { stdio: 'inherit' });
-    }
-    catch {
-        throw new Error('Failed to auto-install Playwright.\n\n' +
-            '  Please install it manually:\n\n' +
-            '    npm install playwright\n' +
-            '    npx playwright install chromium\n\n' +
-            '  Then re-run this command. Use --listings-only to skip screenshots.');
-    }
-    logInfo('  Playwright installed successfully! Restarting command...\n');
-    restartProcess('__EDSGER_PW_INSTALLED');
-};
-/**
- * Ensure an npm package is installed, auto-installing if necessary.
- */
-export const ensureNpmPackage = async (checkFunction, packageName) => {
-    if (await checkFunction()) {
-        return;
-    }
-    const envFlag = `__EDSGER_PKG_${packageName.replace(/[^a-zA-Z0-9]/g, '_').toUpperCase()}`;
-    // Already attempted install in a previous run — don't loop
-    if (process.env[envFlag]) {
-        throw new Error(`${packageName} auto-install succeeded but it is still not loadable.\n\n` +
-            `  Please install it manually:\n\n` +
-            `    npm install ${packageName}`);
-    }
-    logWarning(`${packageName} is not installed. Installing automatically...`);
-    try {
-        npmInstall(packageName);
-    }
-    catch {
-        throw new Error(`Failed to auto-install ${packageName}.\n\n` +
-            `  Please install it manually:\n\n` +
-            `    npm install ${packageName}`);
-    }
-    logInfo(`  ${packageName} installed successfully! Restarting command...\n`);
-    restartProcess(envFlag);
-};
-/**
- * Ensure ffmpeg is installed, auto-installing via Homebrew on macOS if possible.
- */
-export const ensureFFmpeg = (checkFunction) => {
-    if (checkFunction()) {
-        return;
-    }
-    // Attempt auto-install on macOS via Homebrew
-    if (process.platform === 'darwin') {
-        try {
-            execSync('which brew', { stdio: 'ignore' });
-        }
-        catch {
-            throw new Error('ffmpeg is not installed and Homebrew was not found.\n\n' +
-                '  Install Homebrew first (https://brew.sh), then run:\n\n' +
-                '    brew install ffmpeg');
-        }
-        logWarning('ffmpeg is not installed. Installing via Homebrew (this may take a few minutes)...');
-        try {
-            execSync('brew install ffmpeg', { stdio: 'inherit' });
-        }
-        catch {
-            throw new Error('Failed to auto-install ffmpeg via Homebrew.\n\n' +
-                '  Please install it manually:\n\n' +
-                '    brew install ffmpeg');
-        }
-        if (!checkFunction()) {
-            throw new Error('ffmpeg was installed but is still not available.\n\n' +
-                '  Try installing manually:\n\n' +
-                '    brew install ffmpeg');
-        }
-        logInfo('  ffmpeg installed successfully!');
-        return;
-    }
-    // Non-macOS: provide platform-specific instructions
-    throw new Error('ffmpeg is not installed. Install it:\n' +
-        '  Ubuntu/Debian: sudo apt install ffmpeg\n' +
-        '  Fedora: sudo dnf install ffmpeg\n' +
-        '  Windows: choco install ffmpeg');
-};

package/dist/utils/workflow-utils.d.ts

@@ -1,22 +0,0 @@
-import { type CliOptions } from '../types/index.js';
-import { validateConfiguration } from './validation.js';
-/**
- * Validate workflow-specific environment variables
- */
-export declare const validateWorkflowEnvironment: () => {
-    productId: string;
-    mcpServerUrl: string;
-    mcpToken: string;
-};
-/**
- * Setup workflow processor parameters
- */
-export declare const setupWorkflowProcessor: (options: CliOptions) => {
-    config: ReturnType<typeof validateConfiguration>;
-    params: {
-        productId: string;
-        mcpServerUrl: string;
-        mcpToken: string;
-        verbose?: boolean;
-    };
-};

package/dist/utils/workflow-utils.js

@@ -1,48 +0,0 @@
-import { getMcpServerUrl, getMcpToken } from '../auth/auth-store.js';
-import { logInfo } from './logger.js';
-import { validateConfiguration } from './validation.js';
-/**
- * Validate workflow-specific environment variables
- */
-export const validateWorkflowEnvironment = () => {
-    const productId = process.env.EDSGER_PRODUCT_ID;
-    const mcpServerUrl = getMcpServerUrl();
-    const mcpToken = getMcpToken();
-    if (!productId) {
-        throw new Error('Product ID is required. Set EDSGER_PRODUCT_ID environment variable.');
-    }
-    if (!mcpServerUrl) {
-        throw new Error('MCP server URL is required. Set EDSGER_MCP_SERVER_URL environment variable.');
-    }
-    if (!mcpToken) {
-        throw new Error('MCP token is required. Set EDSGER_MCP_TOKEN environment variable.');
-    }
-    // Validate MCP server URL format
-    try {
-        new URL(mcpServerUrl);
-    }
-    catch {
-        throw new Error('Invalid MCP server URL format. Use http:// or https://');
-    }
-    return { productId, mcpServerUrl, mcpToken };
-};
-/**
- * Setup workflow processor parameters
- */
-export const setupWorkflowProcessor = (options) => {
-    const config = validateConfiguration(options);
-    if (options.verbose) {
-        logInfo('Starting workflow processor mode...');
-    }
-    const { productId, mcpServerUrl, mcpToken } = validateWorkflowEnvironment();
-    logInfo('🚀 Starting workflow processor...');
-    return {
-        config,
-        params: {
-            productId,
-            mcpServerUrl,
-            mcpToken,
-            verbose: options.verbose,
-        },
-    };
-};

package/dist/workspace/session-workspace.d.ts

@@ -1,43 +0,0 @@
-/**
- * Session workspace — clones a product's configured repositories into a single
- * local "session directory", one subdirectory per repo.
- *
- * A chat session (an `ai_assistant` channel) is bound to a product, and a
- * product can span several repositories. For the session agent's read-only
- * tools (Read / Grep / Glob) to inspect the real code, we clone every in-scope
- * repo into:
- *
- *   <workspace>/sessions/<channelId>/<owner>_<repo>/
- *
- * and point the agent's cwd at the per-session directory. The clones are reused
- * (and fetched) across turns of the same session rather than re-cloned each
- * time, so follow-up turns are fast and always see the latest code.
- *
- * Repo resolution and the secure-token clone are shared with flow generation
- * (`phases/diagram-shared/clone-repos.ts`).
- */
-import { type ClonedRepo } from '../phases/diagram-shared/clone-repos.js';
-export interface SessionWorkspace {
-    /** Directory holding every cloned repo as a subdirectory; the agent's cwd. */
-    sessionDir: string;
-    /** The repos that were successfully cloned/refreshed for this session. */
-    repos: ClonedRepo[];
-}
-/**
- * Clone (or refresh) every repository the session's product is scoped to into a
- * single local session directory. Returns the directory to use as the agent's
- * cwd plus the cloned repos, or `null` when no repo could be made available
- * (no GitHub config, or every clone failed) so the caller can still run the
- * agent without a codebase.
- */
-export declare function cloneSessionRepos(opts: {
-    channelId: string;
-    productId: string;
-    repositoryIds: string[];
-    verbose?: boolean;
-}): Promise<SessionWorkspace | null>;
-/**
- * Build a note for the agent's system prompt describing where each repo is
- * checked out, so it points Read / Grep / Glob at the right subdirectory.
- */
-export declare function describeSessionRepos(repos: ClonedRepo[]): string;