notsleep 1.0.0

package/dist/config.js

@@ -0,0 +1,265 @@
+"use strict";
+// ============================================================
+// NotSleep - Configuration Loader
+// ============================================================
+//
+// Priority (highest wins):
+//   1. CLI flags / programmatic overrides
+//   2. Project config file  (./notsleep.json)
+//   3. Global config file   (~/.notsleep/config.json)
+//   4. Environment / .env
+//   5. Built-in defaults
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SYSTEM_PROMPT = void 0;
+exports.markContextLimitSource = markContextLimitSource;
+exports.getConfigSources = getConfigSources;
+exports.loadConfig = loadConfig;
+const dotenv = __importStar(require("dotenv"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const fileconfig_1 = require("./fileconfig");
+const cost_1 = require("./cost");
+const registry_1 = require("./registry");
+const modelsdev_1 = require("./modelsdev");
+exports.DEFAULT_SYSTEM_PROMPT = `You are NotSleep, a long-horizon autonomous AI agent. You have been given a task and you must complete it fully before stopping. You have access to tools that let you execute shell commands, read/write files, and search the web.
+
+CRITICAL RULES:
+1. NEVER stop until the task is fully complete. If you encounter errors, debug and fix them.
+2. Break large tasks into smaller subtasks and track your progress.
+3. After completing each subtask, report progress and move to the next one.
+4. If you are unsure about something, investigate before acting.
+5. Always verify your work - run tests, check outputs, validate results.
+6. If the context gets too long, you will be asked to summarize your progress. Be thorough in your summary.
+7. Think step by step. Plan before you act.
+8. Use "add_task" to queue follow-up work you discover (improvements, tests, documentation, refactoring).
+9. Use "list_tasks" to see the current task queue and progress.
+
+When you have fully completed the CURRENT task, call the "task_complete" tool with a summary of everything you accomplished. In continuous mode, you will automatically receive the next task from the queue.`;
+/** Override the recorded context-limit source (e.g. after a /models endpoint hit). */
+function markContextLimitSource(src) {
+    lastConfigSources.contextLimitSource = src;
+}
+let lastConfigSources = {
+    fileConfigSources: [],
+    envLoaded: false,
+    warnings: [],
+    contextLimitSource: 'static',
+    instructionFiles: [],
+};
+function getConfigSources() {
+    return lastConfigSources;
+}
+/** Pick the first defined value from a list of candidates. */
+function firstDefined(...vals) {
+    for (const v of vals) {
+        if (v !== undefined && v !== null && !(typeof v === 'string' && v === ''))
+            return v;
+    }
+    return undefined;
+}
+function loadConfig(overrides) {
+    // ── 1. Load .env from current working directory ──
+    const envPath = path.resolve(process.cwd(), '.env');
+    let envLoaded = false;
+    if (fs.existsSync(envPath)) {
+        dotenv.config({ path: envPath });
+        envLoaded = true;
+    }
+    else {
+        const r = dotenv.config();
+        envLoaded = !r.error;
+    }
+    // ── 2. Load file config (global + project), env refs resolved ──
+    const { config: file, sources, warnings } = (0, fileconfig_1.loadFileConfig)();
+    // ── 3. Resolve provider (override > file > env > default) ──
+    const provider = (overrides?.provider ||
+        file.provider ||
+        process.env.NOTSLEEP_PROVIDER ||
+        'openai');
+    // ── 4. Merge each field with correct priority ──
+    const config = {
+        provider,
+        openai: {
+            apiKey: firstDefined(overrides?.openai?.apiKey, file.openai?.apiKey, process.env.OPENAI_API_KEY) || '',
+            model: firstDefined(overrides?.openai?.model, file.openai?.model, process.env.OPENAI_MODEL) || 'gpt-4o',
+            baseURL: firstDefined(overrides?.openai?.baseURL, file.openai?.baseURL, process.env.OPENAI_BASE_URL),
+        },
+        anthropic: {
+            apiKey: firstDefined(overrides?.anthropic?.apiKey, file.anthropic?.apiKey, process.env.ANTHROPIC_API_KEY) || '',
+            model: firstDefined(overrides?.anthropic?.model, file.anthropic?.model, process.env.ANTHROPIC_MODEL) || 'claude-sonnet-4-20250514',
+            baseURL: firstDefined(overrides?.anthropic?.baseURL, file.anthropic?.baseURL, process.env.ANTHROPIC_BASE_URL),
+        },
+        maxIterations: firstDefined(overrides?.maxIterations, file.maxIterations, process.env.NOTSLEEP_MAX_ITERATIONS ? parseInt(process.env.NOTSLEEP_MAX_ITERATIONS, 10) : undefined) ?? 1000,
+        maxIterationsPerTask: firstDefined(overrides?.maxIterationsPerTask, file.maxIterationsPerTask, process.env.NOTSLEEP_MAX_ITERATIONS_PER_TASK ? parseInt(process.env.NOTSLEEP_MAX_ITERATIONS_PER_TASK, 10) : undefined) ?? 0, // 0 = no per-task cap
+        checkpointDir: firstDefined(overrides?.checkpointDir, file.checkpointDir, process.env.NOTSLEEP_CHECKPOINT_DIR) ?? '.notsleep/checkpoints',
+        logDir: firstDefined(overrides?.logDir, file.logDir, process.env.NOTSLEEP_LOG_DIR) ?? '.notsleep/logs',
+        // Context window limit: if not explicitly set, auto-detect from the
+        // model name so we never exceed what the model actually supports.
+        // The old hard-coded default of 120 000 was wrong for models like
+        // GPT-4 (8K) or Claude (200K).
+        contextWindowLimit: firstDefined(overrides?.contextWindowLimit, file.contextWindowLimit, process.env.NOTSLEEP_CONTEXT_WINDOW_LIMIT ? parseInt(process.env.NOTSLEEP_CONTEXT_WINDOW_LIMIT, 10) : undefined) ?? 0, // 0 = auto-detect (resolved below after model is known)
+        summarizeThreshold: firstDefined(overrides?.summarizeThreshold, file.summarizeThreshold, process.env.NOTSLEEP_SUMMARIZE_THRESHOLD ? parseFloat(process.env.NOTSLEEP_SUMMARIZE_THRESHOLD) : undefined) ?? 0.75,
+        maxRetries: firstDefined(overrides?.maxRetries, file.maxRetries, process.env.NOTSLEEP_MAX_RETRIES ? parseInt(process.env.NOTSLEEP_MAX_RETRIES, 10) : undefined) ?? 10,
+        retryBaseDelayMs: firstDefined(overrides?.retryBaseDelayMs, file.retryBaseDelayMs, process.env.NOTSLEEP_RETRY_BASE_DELAY_MS ? parseInt(process.env.NOTSLEEP_RETRY_BASE_DELAY_MS, 10) : undefined) ?? 1000,
+        toolTimeoutMs: firstDefined(overrides?.toolTimeoutMs, file.toolTimeoutMs, process.env.NOTSLEEP_TOOL_TIMEOUT_MS ? parseInt(process.env.NOTSLEEP_TOOL_TIMEOUT_MS, 10) : undefined) ?? 120000,
+        systemPrompt: firstDefined(overrides?.systemPrompt, file.systemPrompt) ?? exports.DEFAULT_SYSTEM_PROMPT,
+        continuous: firstDefined(overrides?.continuous, file.continuous, process.env.NOTSLEEP_CONTINUOUS === 'true' ? true : undefined) ?? false,
+        stopFile: firstDefined(overrides?.stopFile, file.stopFile, process.env.NOTSLEEP_STOP_FILE) ?? '.notsleep/STOP',
+        maxCostUsd: firstDefined(overrides?.maxCostUsd, file.maxCostUsd, process.env.NOTSLEEP_MAX_COST_USD ? parseFloat(process.env.NOTSLEEP_MAX_COST_USD) : undefined),
+        customTools: overrides?.customTools ?? file.customTools,
+        autoCommit: firstDefined(overrides?.autoCommit, file.autoCommit, process.env.NOTSLEEP_AUTO_COMMIT === 'true' ? true : undefined) ?? false,
+        dashboard: {
+            enabled: firstDefined(overrides?.dashboard?.enabled, file.dashboard?.enabled, process.env.NOTSLEEP_DASHBOARD === 'true' ? true : undefined) ?? false,
+            port: firstDefined(overrides?.dashboard?.port, file.dashboard?.port, process.env.NOTSLEEP_DASHBOARD_PORT ? parseInt(process.env.NOTSLEEP_DASHBOARD_PORT, 10) : undefined) ?? 3120,
+        },
+    };
+    // ── 4b. Unified "provider/model" registry selector (OpenCode-style) ──
+    // If a `model` selector like "groq/llama-3.3-70b-versatile" is given, resolve
+    // it against the built-in provider registry (overlaid with the user's
+    // `providers` map) and populate the legacy provider + openai/anthropic block
+    // from the result. All downstream code (provider.ts, agent.ts) then works
+    // unchanged — it only ever reads config.provider and the two blocks.
+    const providers = overrides?.providers ?? file.providers;
+    const modelRef = firstDefined(overrides?.model, file.model, process.env.NOTSLEEP_MODEL);
+    if ((0, registry_1.isModelRef)(modelRef)) {
+        const resolved = (0, registry_1.resolveModelRef)(modelRef, providers);
+        config.provider = resolved.type;
+        config.model = modelRef;
+        config.providers = providers;
+        const block = { apiKey: resolved.apiKey, model: resolved.model, baseURL: resolved.baseURL };
+        if (resolved.type === 'anthropic') {
+            config.anthropic = block;
+        }
+        else {
+            config.openai = block;
+        }
+    }
+    // ── 4c. Optional small model for the agent's internal calls ──
+    // A "provider/model" ref resolves via the registry (its own creds); a bare
+    // model id reuses the PRIMARY provider's key + baseURL (e.g. primary gpt-4o,
+    // small_model "gpt-4o-mini"). Left unset → internal calls use the primary.
+    const smallRef = firstDefined(overrides?.smallModelRef, file.small_model, file.smallModel, process.env.NOTSLEEP_SMALL_MODEL);
+    if (smallRef) {
+        if ((0, registry_1.isModelRef)(smallRef)) {
+            const r = (0, registry_1.resolveModelRef)(smallRef, providers);
+            config.smallModel = { provider: r.type, apiKey: r.apiKey, model: r.model, baseURL: r.baseURL };
+        }
+        else {
+            const primaryKey = config.provider === 'openai' ? config.openai.apiKey : config.anthropic.apiKey;
+            const primaryBase = config.provider === 'openai' ? config.openai.baseURL : config.anthropic.baseURL;
+            config.smallModel = {
+                provider: config.provider,
+                apiKey: primaryKey,
+                model: smallRef,
+                baseURL: primaryBase,
+            };
+        }
+    }
+    // ── Filter warnings: drop "not set" noise for the INACTIVE provider ──
+    // (init writes both provider blocks by default; only warn about the one in use.)
+    const inactiveKeyField = provider === 'openai' ? 'anthropic.apiKey' : 'openai.apiKey';
+    const relevantWarnings = warnings.filter((w) => {
+        // Keep all malformed-ref warnings; only suppress "not set" for the inactive provider.
+        if (w.startsWith(inactiveKeyField) && w.includes('is not set'))
+            return false;
+        return true;
+    });
+    // ── 5. Resolve the context window limit ──
+    // Priority: an explicit user value wins. Otherwise auto-detect, preferring
+    // LIVE metadata from the models.dev catalog (populated by ensureModelCatalog()
+    // before loadConfig in the CLI paths; empty in offline/unit-test contexts, in
+    // which case we fall back to the static table in cost.ts). We store 90% of the
+    // real window as the limit, leaving headroom for the completion.
+    let contextLimitSource = 'explicit';
+    if (config.contextWindowLimit <= 0) {
+        const modelId = config.provider === 'openai'
+            ? config.openai.model
+            : config.anthropic.model;
+        const providerName = (0, registry_1.isModelRef)(config.model)
+            ? (0, registry_1.parseModelRef)(config.model).providerName
+            : config.provider;
+        const live = (0, modelsdev_1.liveContextLimit)(providerName, modelId);
+        if (live !== undefined) {
+            config.contextWindowLimit = Math.floor(live * 0.9);
+            contextLimitSource = 'catalog';
+        }
+        else {
+            config.contextWindowLimit = (0, cost_1.safeContextLimit)(modelId);
+            contextLimitSource = 'static';
+        }
+    }
+    // ── 5b. Fold instruction files into the system prompt ──
+    // Explicit `instructions` (relative to the project config) plus auto-loaded
+    // AGENTS.md / NOTSLEEP.md from the project root, appended as clearly-labeled
+    // context. This is only for the default/base prompt; if the user supplied a
+    // fully custom systemPrompt via override we still append project guidance.
+    const projectPath = (0, fileconfig_1.findProjectConfig)();
+    const projectDir = projectPath ? path.dirname(projectPath) : process.cwd();
+    const instr = (0, fileconfig_1.gatherInstructions)(file, projectDir);
+    if (instr.text) {
+        config.systemPrompt += `\n\n--- PROJECT INSTRUCTIONS ---\n\n${instr.text}`;
+    }
+    lastConfigSources = {
+        fileConfigSources: sources,
+        envLoaded,
+        warnings: relevantWarnings,
+        contextLimitSource,
+        instructionFiles: instr.files,
+    };
+    // ── 6. Validate ──
+    // Reject unknown providers early with a clear message. Otherwise an invalid
+    // value silently falls through to the anthropic branch and later fails with
+    // a confusing "client not initialized" error deep in the run.
+    if (config.provider !== 'openai' && config.provider !== 'anthropic') {
+        throw new Error(`Unknown provider "${config.provider}". Valid providers are: openai, anthropic.`);
+    }
+    const activeKey = config.provider === 'openai' ? config.openai?.apiKey : config.anthropic?.apiKey;
+    if (!activeKey) {
+        if ((0, registry_1.isModelRef)(config.model)) {
+            // Registry path: name the provider and how to supply its key.
+            const providerName = config.model.slice(0, config.model.indexOf('/'));
+            throw new Error(`No API key for provider "${providerName}" (model "${config.model}"). ` +
+                `Set its key in the "providers" section of notsleep.json ` +
+                `(e.g. "providers": { "${providerName}": { "apiKey": "{env:${providerName.toUpperCase()}_API_KEY}" } }) ` +
+                `or export the matching environment variable.`);
+        }
+        const envVar = config.provider === 'openai' ? 'OPENAI_API_KEY' : 'ANTHROPIC_API_KEY';
+        throw new Error(`${envVar} is required when using the ${config.provider} provider. Set it in .env, notsleep.json, or pass it directly. Run "notsleep init" to set up config.`);
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,15 @@
+export interface ProjectContext {
+    cwd: string;
+    language: string;
+    framework: string;
+    packageManager: string;
+    gitBranch: string | null;
+    gitDirty: boolean;
+    readme: string | null;
+    dependencies: string[];
+    fileTree: string;
+    configFiles: string[];
+    summary: string;
+}
+export declare function detectProjectContext(cwd?: string): ProjectContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CA+KjE"}

package/dist/context.js

@@ -0,0 +1,237 @@
+"use strict";
+// ============================================================
+// NotSleep - Project Context Auto-Detector
+// ============================================================
+//
+// Scans the current working directory to understand the project:
+//   - Git status & branch
+//   - package.json / requirements.txt / go.mod etc.
+//   - README
+//   - File tree (top 3 levels)
+//   - Existing config files
+//
+// Produces a context string injected into the system prompt
+// so the agent already knows what it's working with.
+//
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProjectContext = detectProjectContext;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+function detectProjectContext(cwd) {
+    const dir = cwd || process.cwd();
+    const ctx = {
+        cwd: dir,
+        language: 'unknown',
+        framework: 'unknown',
+        packageManager: 'unknown',
+        gitBranch: null,
+        gitDirty: false,
+        readme: null,
+        dependencies: [],
+        fileTree: '',
+        configFiles: [],
+        summary: '',
+    };
+    // ─── Git ──────────────────────────────────────────────
+    try {
+        ctx.gitBranch = (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD', { cwd: dir, stdio: ['pipe', 'pipe', 'pipe'] })
+            .toString().trim();
+        const status = (0, child_process_1.execSync)('git status --porcelain', { cwd: dir, stdio: ['pipe', 'pipe', 'pipe'] })
+            .toString().trim();
+        ctx.gitDirty = status.length > 0;
+    }
+    catch {
+        // not a git repo
+    }
+    // ─── Language / Package Manager Detection ─────────────
+    const detectors = [
+        {
+            file: 'package.json', lang: 'JavaScript/TypeScript', pm: 'npm',
+            framework: (pkg) => {
+                const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+                if (deps['next'])
+                    return 'Next.js';
+                if (deps['nuxt'])
+                    return 'Nuxt';
+                if (deps['react'])
+                    return 'React';
+                if (deps['vue'])
+                    return 'Vue';
+                if (deps['svelte'])
+                    return 'Svelte';
+                if (deps['express'])
+                    return 'Express';
+                if (deps['fastify'])
+                    return 'Fastify';
+                if (deps['nestjs'] || deps['@nestjs/core'])
+                    return 'NestJS';
+                if (deps['angular'] || deps['@angular/core'])
+                    return 'Angular';
+                return 'Node.js';
+            }
+        },
+        { file: 'requirements.txt', lang: 'Python', pm: 'pip' },
+        { file: 'pyproject.toml', lang: 'Python', pm: 'poetry/pip' },
+        { file: 'Pipfile', lang: 'Python', pm: 'pipenv' },
+        { file: 'go.mod', lang: 'Go', pm: 'go modules' },
+        { file: 'Cargo.toml', lang: 'Rust', pm: 'cargo' },
+        { file: 'pom.xml', lang: 'Java', pm: 'maven' },
+        { file: 'build.gradle', lang: 'Java/Kotlin', pm: 'gradle' },
+        { file: 'Gemfile', lang: 'Ruby', pm: 'bundler' },
+        { file: 'composer.json', lang: 'PHP', pm: 'composer' },
+        { file: 'pubspec.yaml', lang: 'Dart/Flutter', pm: 'pub' },
+    ];
+    for (const det of detectors) {
+        const filePath = path.join(dir, det.file);
+        if (fs.existsSync(filePath)) {
+            ctx.language = det.lang;
+            ctx.packageManager = det.pm;
+            // Detect framework from package.json
+            if (det.file === 'package.json' && det.framework) {
+                try {
+                    const pkg = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+                    ctx.framework = det.framework(pkg);
+                    // Extract top dependencies
+                    const deps = Object.keys(pkg.dependencies || {}).slice(0, 15);
+                    const devDeps = Object.keys(pkg.devDependencies || {}).slice(0, 10);
+                    ctx.dependencies = [...deps, ...devDeps.map(d => `${d} (dev)`)];
+                    // Check for yarn/pnpm
+                    if (fs.existsSync(path.join(dir, 'yarn.lock')))
+                        ctx.packageManager = 'yarn';
+                    if (fs.existsSync(path.join(dir, 'pnpm-lock.yaml')))
+                        ctx.packageManager = 'pnpm';
+                    if (fs.existsSync(path.join(dir, 'bun.lockb')))
+                        ctx.packageManager = 'bun';
+                }
+                catch { /* ignore parse errors */ }
+            }
+            // Check for TypeScript
+            if (fs.existsSync(path.join(dir, 'tsconfig.json'))) {
+                ctx.language = 'TypeScript';
+            }
+            break;
+        }
+    }
+    // ─── README ───────────────────────────────────────────
+    const readmeNames = ['README.md', 'readme.md', 'README.txt', 'README'];
+    for (const name of readmeNames) {
+        const readmePath = path.join(dir, name);
+        if (fs.existsSync(readmePath)) {
+            try {
+                const content = fs.readFileSync(readmePath, 'utf-8');
+                // Take first 2000 chars
+                ctx.readme = content.substring(0, 2000);
+                if (content.length > 2000)
+                    ctx.readme += '\n... [truncated]';
+            }
+            catch { /* ignore */ }
+            break;
+        }
+    }
+    // ─── Config Files ─────────────────────────────────────
+    const configPatterns = [
+        '.env', '.env.example', '.gitignore', 'Dockerfile', 'docker-compose.yml',
+        'tsconfig.json', '.eslintrc.js', '.prettierrc', 'jest.config.js',
+        'vite.config.ts', 'next.config.js', 'webpack.config.js',
+        '.github/workflows', 'Makefile', 'vercel.json', 'netlify.toml',
+    ];
+    for (const p of configPatterns) {
+        if (fs.existsSync(path.join(dir, p))) {
+            ctx.configFiles.push(p);
+        }
+    }
+    // ─── File Tree (top 3 levels) ─────────────────────────
+    const treeLines = [];
+    const skipDirs = new Set(['node_modules', '.git', 'dist', 'build', '__pycache__', '.next', '.nuxt', 'target', 'vendor', '.venv', 'venv']);
+    function walk(d, prefix, depth) {
+        if (depth > 3 || treeLines.length > 80)
+            return;
+        try {
+            const entries = fs.readdirSync(d, { withFileTypes: true })
+                .filter(e => !e.name.startsWith('.') || e.name === '.env.example' || e.name === '.gitignore')
+                .filter(e => !skipDirs.has(e.name))
+                .sort((a, b) => {
+                // Dirs first
+                if (a.isDirectory() && !b.isDirectory())
+                    return -1;
+                if (!a.isDirectory() && b.isDirectory())
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+            for (let i = 0; i < entries.length; i++) {
+                if (treeLines.length > 80) {
+                    treeLines.push(prefix + '... (truncated)');
+                    return;
+                }
+                const isLast = i === entries.length - 1;
+                const connector = isLast ? '└── ' : '├── ';
+                const childPrefix = isLast ? '    ' : '│   ';
+                const entry = entries[i];
+                treeLines.push(prefix + connector + entry.name + (entry.isDirectory() ? '/' : ''));
+                if (entry.isDirectory()) {
+                    walk(path.join(d, entry.name), prefix + childPrefix, depth + 1);
+                }
+            }
+        }
+        catch { /* ignore permission errors */ }
+    }
+    walk(dir, '', 0);
+    ctx.fileTree = treeLines.join('\n');
+    // ─── Build Summary ────────────────────────────────────
+    const parts = [];
+    parts.push(`Working directory: ${dir}`);
+    parts.push(`Language: ${ctx.language} | Framework: ${ctx.framework} | Package manager: ${ctx.packageManager}`);
+    if (ctx.gitBranch) {
+        parts.push(`Git branch: ${ctx.gitBranch}${ctx.gitDirty ? ' (dirty - uncommitted changes)' : ' (clean)'}`);
+    }
+    if (ctx.configFiles.length > 0) {
+        parts.push(`Config files: ${ctx.configFiles.join(', ')}`);
+    }
+    if (ctx.dependencies.length > 0) {
+        parts.push(`Key dependencies: ${ctx.dependencies.join(', ')}`);
+    }
+    if (ctx.fileTree) {
+        parts.push(`\nProject structure:\n${ctx.fileTree}`);
+    }
+    if (ctx.readme) {
+        parts.push(`\nREADME (excerpt):\n${ctx.readme}`);
+    }
+    ctx.summary = parts.join('\n');
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/cost.d.ts

@@ -0,0 +1,26 @@
+export interface ModelPrice {
+    /** USD per 1M input (prompt) tokens */
+    input: number;
+    /** USD per 1M output (completion) tokens */
+    output: number;
+}
+/**
+ * Look up the context window size (max input tokens) for a model.
+ * Returns the raw model limit; callers should apply a safety margin.
+ */
+export declare function contextWindowForModel(model: string): number;
+/**
+ * Compute a safe context window limit for the agent, leaving room for
+ * the model's output. Uses 90% of the model's context window, capped
+ * so we never exceed what the model actually supports.
+ */
+export declare function safeContextLimit(model: string): number;
+/** Look up the per-1M price for a model name (case-insensitive substring). */
+export declare function priceForModel(model: string): ModelPrice;
+/**
+ * Estimate the USD cost of a single call given its token usage.
+ */
+export declare function estimateCost(model: string, promptTokens: number, completionTokens: number): number;
+/** Format a USD amount for display (4 decimals under $1, else 2). */
+export declare function formatUsd(amount: number): string;
+//# sourceMappingURL=cost.d.ts.map

package/dist/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAyGD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAGlG;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGhD"}