gencode-ai 0.4.0 → 0.5.0

package/dist/cli/prompts/index.js

@@ -0,0 +1,315 @@
+/**
+ * Prompt Loader - Load prompts from .txt files
+ *
+ * This module provides utilities for loading system prompts and tool descriptions
+ * from separate .txt files, enabling easier maintenance and prompt engineering.
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+import * as os from 'os';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Path to providers.json config
+const PROVIDERS_CONFIG_PATH = join(homedir(), '.gen', 'providers.json');
+// Resolve prompts directory - check both src and dist locations
+function getPromptsDir() {
+    // If running from dist, look for prompts in src
+    if (__dirname.includes('/dist/')) {
+        const srcPath = __dirname.replace('/dist/', '/src/');
+        if (existsSync(srcPath)) {
+            return srcPath;
+        }
+    }
+    return __dirname;
+}
+const promptsDir = getPromptsDir();
+/**
+ * Load providers config from ~/.gen/providers.json
+ */
+function loadProvidersConfig() {
+    try {
+        if (existsSync(PROVIDERS_CONFIG_PATH)) {
+            const data = readFileSync(PROVIDERS_CONFIG_PATH, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return null;
+}
+/**
+ * Look up which provider owns a given model ID
+ * Searches through ~/.gen/providers.json to find the provider
+ *
+ * @param model - The model ID (e.g., "claude-sonnet-4-5@20250929")
+ * @returns The provider name (e.g., "anthropic") or null if not found
+ */
+export function getProviderForModel(model) {
+    const config = loadProvidersConfig();
+    if (!config?.models) {
+        return null;
+    }
+    for (const [provider, cache] of Object.entries(config.models)) {
+        if (cache.list?.some((m) => m.id === model)) {
+            return provider;
+        }
+    }
+    return null;
+}
+/**
+ * Map provider names to prompt types
+ * Falls back to 'generic' for unknown providers
+ * Handles both "provider" and "provider:authMethod" formats
+ */
+export function mapProviderToPromptType(provider) {
+    // Extract provider prefix (e.g., "google:api_key" → "google")
+    const providerPrefix = provider.split(':')[0];
+    switch (providerPrefix) {
+        case 'anthropic':
+            return 'anthropic';
+        case 'openai':
+            return 'openai';
+        case 'google':
+            return 'gemini'; // Google provider uses Gemini models, so use gemini prompt
+        default:
+            return 'generic';
+    }
+}
+/**
+ * Get prompt type for a model
+ * Flow: model → provider (from providers.json) → prompt type
+ *
+ * @param model - The model ID
+ * @param fallbackProvider - Provider to use if model lookup fails
+ * @returns The prompt type to use
+ */
+export function getPromptTypeForModel(model, fallbackProvider) {
+    // First, try to look up the provider for this model
+    const provider = getProviderForModel(model);
+    if (provider) {
+        return mapProviderToPromptType(provider);
+    }
+    // Fall back to the provided provider if model lookup fails
+    if (fallbackProvider) {
+        return mapProviderToPromptType(fallbackProvider);
+    }
+    // Default to generic
+    return 'generic';
+}
+/**
+ * Load a prompt file from a category subdirectory
+ */
+export function loadPrompt(category, name) {
+    const path = join(promptsDir, category, `${name}.txt`);
+    return readFileSync(path, 'utf-8');
+}
+/**
+ * Load the complete system prompt for a specific provider
+ */
+export function loadSystemPrompt(provider) {
+    const base = loadPrompt('system', 'base');
+    const providerSpecific = loadPrompt('system', provider);
+    return `${base}\n\n${providerSpecific}`;
+}
+/**
+ * Load a tool description from the tools directory
+ */
+export function loadToolDescription(toolName) {
+    try {
+        return loadPrompt('tools', toolName.toLowerCase());
+    }
+    catch {
+        // Fallback if file doesn't exist (for tools without description files)
+        return `Tool: ${toolName}`;
+    }
+}
+/**
+ * Get current environment info
+ */
+export function getEnvironmentInfo(cwd, isGitRepo = false) {
+    return {
+        cwd,
+        platform: process.platform,
+        osVersion: `${os.type()} ${os.release()}`,
+        date: new Date().toISOString().split('T')[0],
+        isGitRepo,
+    };
+}
+/**
+ * Format environment info for injection into system prompt
+ */
+export function formatEnvironmentInfo(env) {
+    return `<env>
+Working directory: ${env.cwd}
+Is directory a git repo: ${env.isGitRepo ? 'Yes' : 'No'}
+Platform: ${env.platform}
+OS Version: ${env.osVersion}
+Today's date: ${env.date}
+</env>`;
+}
+/**
+ * Build the complete system prompt with environment info
+ */
+export function buildSystemPrompt(provider, cwd, isGitRepo = false) {
+    const prompt = loadSystemPrompt(provider);
+    const envInfo = formatEnvironmentInfo(getEnvironmentInfo(cwd, isGitRepo));
+    return prompt.replace('{{ENVIRONMENT}}', envInfo);
+}
+/**
+ * Format memory context for injection into system prompt
+ * Uses <claudeMd> tag for optimal compatibility with Claude models
+ */
+export function formatMemoryContext(memoryContext) {
+    if (!memoryContext) {
+        return '';
+    }
+    return `
+<claudeMd>
+Codebase and user instructions are shown below. Be sure to adhere to these instructions. IMPORTANT: These instructions OVERRIDE any default behavior and you MUST follow them exactly as written.
+
+${memoryContext}
+
+IMPORTANT: this context may or may not be relevant to your tasks. You should not respond to this context unless it is highly relevant to your task.
+</claudeMd>`;
+}
+/**
+ * Build the complete system prompt with environment info and memory context
+ */
+export function buildSystemPromptWithMemory(provider, cwd, isGitRepo = false, memoryContext) {
+    let prompt = buildSystemPrompt(provider, cwd, isGitRepo);
+    if (memoryContext) {
+        prompt += formatMemoryContext(memoryContext);
+    }
+    return prompt;
+}
+/**
+ * Build system prompt for a model
+ * Flow: model → provider (from providers.json) → prompt
+ *
+ * This is the recommended way to build system prompts as it automatically
+ * looks up the provider for the given model from ~/.gen/providers.json
+ *
+ * @param model - The model ID (e.g., "claude-sonnet-4-5@20250929")
+ * @param cwd - Current working directory
+ * @param isGitRepo - Whether the cwd is a git repository
+ * @param memoryContext - Optional memory context to include
+ * @param fallbackProvider - Provider to use if model lookup fails
+ */
+export function buildSystemPromptForModel(model, cwd, isGitRepo = false, memoryContext, fallbackProvider) {
+    const promptType = getPromptTypeForModel(model, fallbackProvider);
+    return buildSystemPromptWithMemory(promptType, cwd, isGitRepo, memoryContext);
+}
+/**
+ * Load plan mode prompt if it exists
+ */
+export function loadPlanModePrompt() {
+    try {
+        return loadPrompt('system', 'plan-mode');
+    }
+    catch {
+        // Plan mode prompt not found - return empty string
+        return '';
+    }
+}
+/**
+ * Build system prompt with plan mode context
+ * Appends plan mode instructions when plan mode is active
+ *
+ * @param model - The model ID
+ * @param cwd - Current working directory
+ * @param isGitRepo - Whether the cwd is a git repository
+ * @param memoryContext - Optional memory context to include
+ * @param fallbackProvider - Provider to use if model lookup fails
+ * @param planModeActive - Whether plan mode is currently active
+ * @param planFilePath - Path to the plan file (if in plan mode)
+ */
+export function buildSystemPromptWithPlanMode(model, cwd, isGitRepo = false, memoryContext, fallbackProvider, planModeActive = false, planFilePath) {
+    let prompt = buildSystemPromptForModel(model, cwd, isGitRepo, memoryContext, fallbackProvider);
+    if (planModeActive) {
+        const planModePrompt = loadPlanModePrompt();
+        if (planModePrompt) {
+            prompt += '\n\n' + planModePrompt;
+            // Add plan file path context if available
+            if (planFilePath) {
+                prompt += `\n\n## Current Plan File\n\nYour plan file is located at: ${planFilePath}\n\nWrite your implementation plan to this file when you reach Phase 4 (Final Plan).`;
+            }
+        }
+    }
+    return prompt;
+}
+/**
+ * Debug utility to verify prompt loading at runtime
+ * Set GEN_DEBUG_PROMPTS=1 for summary, GEN_DEBUG_PROMPTS=2 for full content
+ *
+ * @param model - The model ID
+ * @param fallbackProvider - Provider to use if model lookup fails
+ * @param planModeActive - Whether plan mode is currently active
+ * @param planFilePath - Path to the plan file (if in plan mode)
+ */
+export function debugPromptLoading(model, fallbackProvider, planModeActive = false, planFilePath) {
+    const debugLevel = process.env.GEN_DEBUG_PROMPTS;
+    if (!debugLevel || debugLevel === '0') {
+        return;
+    }
+    const promptType = getPromptTypeForModel(model, fallbackProvider);
+    const basePrompt = loadPrompt('system', 'base');
+    const providerPrompt = loadPrompt('system', promptType);
+    const planModePrompt = planModeActive ? loadPlanModePrompt() : '';
+    console.error('[PROMPT DEBUG] ================================');
+    console.error(`[PROMPT DEBUG] Model: ${model}`);
+    console.error(`[PROMPT DEBUG] Fallback Provider: ${fallbackProvider || 'none'}`);
+    console.error(`[PROMPT DEBUG] Resolved Prompt Type: ${promptType}`);
+    console.error(`[PROMPT DEBUG] Plan Mode Active: ${planModeActive}`);
+    if (planModeActive && planFilePath) {
+        console.error(`[PROMPT DEBUG] Plan File: ${planFilePath}`);
+    }
+    console.error(`[PROMPT DEBUG] base.txt lines: ${basePrompt.split('\n').length}`);
+    console.error(`[PROMPT DEBUG] ${promptType}.txt lines: ${providerPrompt.split('\n').length}`);
+    if (planModeActive) {
+        console.error(`[PROMPT DEBUG] plan-mode.txt lines: ${planModePrompt.split('\n').length}`);
+    }
+    console.error(`[PROMPT DEBUG] Total chars: ${basePrompt.length + providerPrompt.length + planModePrompt.length}`);
+    // Verify key content
+    const checks = [
+        { name: 'Token minimization', pattern: /minimize output tokens/i },
+        { name: 'CommonMark', pattern: /CommonMark/i },
+        { name: 'Examples', pattern: /<example>/ },
+        { name: 'Environment placeholder', pattern: /\{\{ENVIRONMENT\}\}/ },
+    ];
+    for (const check of checks) {
+        const found = check.pattern.test(basePrompt);
+        console.error(`[PROMPT DEBUG] ✓ ${check.name}: ${found ? 'OK' : 'MISSING'}`);
+    }
+    // Plan mode specific checks
+    if (planModeActive) {
+        const planChecks = [
+            { name: 'Plan Mode Header', pattern: /# Plan Mode/i },
+            { name: 'Workflow', pattern: /Workflow|phase/i },
+            { name: 'Tool Access', pattern: /Blocked|Available/i },
+            { name: 'ExitPlanMode', pattern: /ExitPlanMode/i },
+        ];
+        for (const check of planChecks) {
+            const found = check.pattern.test(planModePrompt);
+            console.error(`[PROMPT DEBUG] ✓ Plan: ${check.name}: ${found ? 'OK' : 'MISSING'}`);
+        }
+    }
+    console.error('[PROMPT DEBUG] ================================');
+    // Print full content if level >= 2
+    if (debugLevel === '2') {
+        console.error('\n[PROMPT DEBUG] === base.txt ===\n');
+        console.error(basePrompt);
+        console.error(`\n[PROMPT DEBUG] === ${promptType}.txt ===\n`);
+        console.error(providerPrompt);
+        if (planModeActive) {
+            console.error('\n[PROMPT DEBUG] === plan-mode.txt ===\n');
+            console.error(planModePrompt);
+            if (planFilePath) {
+                console.error(`\n[PROMPT DEBUG] Plan file path: ${planFilePath}`);
+            }
+        }
+        console.error('\n[PROMPT DEBUG] === END ===\n');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/prompts/index.js.map

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

package/dist/core/agent/agent.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Agent - Core agent implementation with tool loop and session support
+ */
+import type { Message, Provider } from '../providers/types.js';
+import { PermissionManager, type ApprovalAction, type ApprovalSuggestion, type PromptPermission, type PermissionSettings } from '../permissions/index.js';
+import { SessionManager } from '../session/index.js';
+import { MemoryManager, type LoadedMemory } from '../memory/index.js';
+import type { AgentConfig, AgentEvent } from './types.js';
+import type { Question, QuestionAnswer } from '../tools/types.js';
+import { type PlanModeManager, type ModeType, type AllowedPrompt } from '../../cli/planning/index.js';
+import type { HooksConfig } from '../../ext/hooks/index.js';
+export type AskUserCallback = (questions: Question[]) => Promise<QuestionAnswer[]>;
+export declare class Agent {
+    private provider;
+    private registry;
+    private registryPromise;
+    private commandManager;
+    private commandManagerPromise;
+    private permissions;
+    private sessionManager;
+    private memoryManager;
+    private planModeManager;
+    private hooksManager;
+    private config;
+    private sessionId;
+    private loadedMemory;
+    private askUserCallback;
+    private askPermissionCallback;
+    constructor(config: AgentConfig);
+    /**
+     * Ensure tool registry is initialized (lazy loading for async skill discovery)
+     * Thread-safe: Prevents concurrent initialization using a mutex
+     */
+    private ensureRegistry;
+    /**
+     * Ensure command manager is initialized (lazy loading for async command discovery)
+     * Thread-safe: Prevents concurrent initialization using a mutex
+     */
+    private ensureCommandManager;
+    /**
+     * Initialize permission system (load persisted rules)
+     */
+    initializePermissions(settings?: PermissionSettings): Promise<void>;
+    /**
+     * Initialize hooks system (load hooks configuration)
+     */
+    initializeHooks(hooksConfig?: HooksConfig): void;
+    /**
+     * Set simple permission confirmation callback (backward compatible)
+     */
+    setConfirmCallback(callback: (tool: string, input: unknown) => Promise<boolean>): void;
+    /**
+     * Set enhanced permission confirmation callback with approval options
+     */
+    setEnhancedConfirmCallback(callback: (tool: string, input: unknown, suggestions: ApprovalSuggestion[]) => Promise<ApprovalAction>): void;
+    /**
+     * Add prompt-based permissions (Claude Code ExitPlanMode style)
+     */
+    addAllowedPrompts(prompts: PromptPermission[]): void;
+    /**
+     * Clear prompt-based permissions
+     */
+    clearAllowedPrompts(): void;
+    /**
+     * Set callback to save permission rules to settings
+     * This enables saving rules to settings.local.json instead of permissions.json
+     */
+    setSaveRuleCallback(callback: (tool: string, pattern?: string) => Promise<void>): void;
+    /**
+     * Get permission manager for direct access
+     */
+    getPermissionManager(): PermissionManager;
+    /**
+     * Set callback for AskUserQuestion tool
+     * This allows the CLI to handle user questioning
+     */
+    setAskUserCallback(callback: AskUserCallback): void;
+    /**
+     * Set callback for tools to request permission with metadata (e.g., diff preview)
+     * This allows tools like Edit to show rich previews before execution
+     */
+    setAskPermissionCallback(callback: (request: import('../tools/types.js').PermissionRequest) => Promise<ApprovalAction | undefined>): void;
+    /**
+     * Get memory manager for direct access
+     */
+    getMemoryManager(): MemoryManager;
+    /**
+     * Get loaded memory (null if not loaded yet)
+     */
+    getLoadedMemory(): LoadedMemory | null;
+    /**
+     * Load memory for the current working directory
+     */
+    loadMemory(): Promise<LoadedMemory>;
+    /**
+     * Get plan mode manager for external access
+     */
+    getPlanModeManager(): PlanModeManager;
+    /**
+     * Check if plan mode is active
+     */
+    isPlanModeActive(): boolean;
+    /**
+     * Get current mode (build or plan)
+     */
+    getCurrentMode(): ModeType;
+    /**
+     * Enter plan mode programmatically
+     */
+    enterPlanMode(taskDescription?: string): Promise<string>;
+    /**
+     * Exit plan mode
+     */
+    exitPlanMode(approved?: boolean): void;
+    /**
+     * Toggle plan mode
+     */
+    togglePlanMode(): Promise<void>;
+    /**
+     * Get plan mode requested permissions
+     */
+    getPlanModePermissions(): AllowedPrompt[];
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string | null;
+    /**
+     * Get session manager for external access
+     */
+    getSessionManager(): SessionManager;
+    /**
+     * Set the model to use (auto-switches provider if needed)
+     * @param model Model ID to use
+     * @param provider Optional: explicit provider (otherwise inferred from model name)
+     * @param authMethod Optional: explicit auth method (otherwise inferred or use current)
+     */
+    setModel(model: string, provider?: string, authMethod?: string): void;
+    /**
+     * Get current model
+     */
+    getModel(): string;
+    /**
+     * Get current provider
+     */
+    getProvider(): Provider;
+    /**
+     * Get model information for compression
+     */
+    getModelInfo(): {
+        contextWindow: number;
+        outputLimit?: number;
+    };
+    /**
+     * List available models from the provider API
+     */
+    listModels(): Promise<{
+        id: string;
+        name: string;
+    }[]>;
+    /**
+     * Start a new session
+     */
+    startSession(title?: string): Promise<string>;
+    /**
+     * Resume an existing session
+     */
+    resumeSession(sessionId: string): Promise<boolean>;
+    /**
+     * Resume the most recent session
+     */
+    resumeLatest(): Promise<boolean>;
+    /**
+     * Fork current session
+     */
+    forkSession(title?: string): Promise<string | null>;
+    /**
+     * List all sessions
+     */
+    listSessions(): Promise<import("../session/types.js").SessionListItem[]>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Save current session
+     */
+    saveSession(): Promise<void>;
+    /**
+     * Run a single query through the agent
+     */
+    run(prompt: string, signal?: AbortSignal): AsyncGenerator<AgentEvent, void, unknown>;
+    /**
+     * Clear conversation history
+     */
+    clearHistory(): void;
+    /**
+     * Clean up incomplete tool use messages (after interruption)
+     * Removes the last assistant message if it contains tool_use without corresponding tool_result
+     */
+    cleanupIncompleteMessages(): void;
+    /**
+     * Get conversation history
+     */
+    getHistory(): Message[];
+    /**
+     * Get compression statistics
+     */
+    getCompressionStats(): {
+        totalMessages: number;
+        activeMessages: number;
+        summaryCount: number;
+        compressionRatio: number;
+    } | null;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/core/agent/agent.d.ts.map

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