merlion 0.1.0

package/dist/config/wizard.d.ts

@@ -0,0 +1,27 @@
+import { type MerlionConfig } from './store.ts';
+export declare const DEFAULT_MODEL = "google/gemini-2.5-flash-preview";
+export declare const DEFAULT_BASE_URL = "https://openrouter.ai/api/v1";
+export interface WizardIO {
+    /** Prompt the user and return their answer (without the trailing newline). */
+    prompt(question: string): Promise<string>;
+    /** Like prompt but input is not echoed (for secrets). */
+    promptSecret(question: string): Promise<string>;
+    write(text: string): void;
+}
+/** Default IO implementation backed by real stdin/stdout. */
+export declare function createStdioWizardIO(): WizardIO;
+export interface WizardResult {
+    /** true → config was filled in and saved; false → user aborted */
+    ok: boolean;
+    config: MerlionConfig;
+}
+/**
+ * Runs the interactive first-run setup wizard.
+ *
+ * @param existingConfig  Values already known (e.g. partially set env vars).
+ *                        Fields present here are shown as pre-filled defaults
+ *                        and skip the corresponding prompt.
+ * @param io              Abstracted IO — real stdio in production, fake in tests.
+ */
+export declare function runConfigWizard(existingConfig?: MerlionConfig, io?: WizardIO): Promise<WizardResult>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/config/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/config/wizard.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAExE,eAAO,MAAM,aAAa,oCAAoC,CAAA;AAC9D,eAAO,MAAM,gBAAgB,iCAAiC,CAAA;AAE9D,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzC,yDAAyD;IACzD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,IAAI,QAAQ,CAmC9C;AAED,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,cAAc,GAAE,aAAkB,EAClC,EAAE,GAAE,QAAgC,GACnC,OAAO,CAAC,YAAY,CAAC,CAsCvB"}

package/dist/config/wizard.js

@@ -0,0 +1,83 @@
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { writeConfig, configPath } from "./store.js";
+export const DEFAULT_MODEL = 'google/gemini-2.5-flash-preview';
+export const DEFAULT_BASE_URL = 'https://openrouter.ai/api/v1';
+/** Default IO implementation backed by real stdin/stdout. */
+export function createStdioWizardIO() {
+    return {
+        async prompt(question) {
+            const rl = createInterface({ input: stdin, output: stdout });
+            try {
+                return await rl.question(question);
+            }
+            finally {
+                rl.close();
+            }
+        },
+        async promptSecret(question) {
+            // Mute stdout while the user types so the key is not echoed.
+            const rl = createInterface({
+                input: stdin,
+                output: stdout,
+                terminal: true
+            });
+            stdout.write(question);
+            rl._writeToOutput = () => { };
+            try {
+                const answer = await rl.question('');
+                stdout.write('\n');
+                return answer;
+            }
+            finally {
+                rl.close();
+            }
+        },
+        write(text) {
+            stdout.write(text);
+        }
+    };
+}
+/**
+ * Runs the interactive first-run setup wizard.
+ *
+ * @param existingConfig  Values already known (e.g. partially set env vars).
+ *                        Fields present here are shown as pre-filled defaults
+ *                        and skip the corresponding prompt.
+ * @param io              Abstracted IO — real stdio in production, fake in tests.
+ */
+export async function runConfigWizard(existingConfig = {}, io = createStdioWizardIO()) {
+    io.write('\n');
+    io.write('  Merlion Setup\n');
+    io.write('  ─────────────────────────────────────────────────\n');
+    io.write('  No API key found. Let\'s get you configured.\n');
+    io.write('\n');
+    // --- API key ---
+    let apiKey;
+    if (existingConfig.apiKey && existingConfig.apiKey.trim() !== '') {
+        apiKey = existingConfig.apiKey;
+        io.write('  OpenRouter API key: (using existing value)\n');
+    }
+    else {
+        const raw = await io.promptSecret('  OpenRouter API key: ');
+        if (raw.trim() === '') {
+            io.write('\n  Setup aborted. Set OPENROUTER_API_KEY or re-run `merlion config`.\n\n');
+            return { ok: false, config: {} };
+        }
+        apiKey = raw.trim();
+    }
+    // --- Model ---
+    const modelDefault = existingConfig.model?.trim() || DEFAULT_MODEL;
+    const modelAnswer = await io.prompt(`  Model [${modelDefault}]: `);
+    const model = modelAnswer.trim() === '' ? modelDefault : modelAnswer.trim();
+    // --- Base URL (not prompted — use default silently) ---
+    const baseURL = existingConfig.baseURL?.trim() || DEFAULT_BASE_URL;
+    const config = { apiKey, model, baseURL };
+    await writeConfig(config);
+    io.write('\n');
+    io.write(`  Config saved to ${configPath()}\n`);
+    io.write('  Run `merlion config` at any time to update settings.\n');
+    io.write('\n');
+    return { ok: true, config };
+}
+//# sourceMappingURL=wizard.js.map

package/dist/config/wizard.js.map

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

package/dist/context/compact.d.ts

@@ -0,0 +1,11 @@
+import type { ChatMessage } from '../types.js';
+export interface CompactOptions {
+    keepRecent?: number;
+}
+export interface CompactResult {
+    messages: ChatMessage[];
+    compacted: boolean;
+}
+export declare function estimateMessagesChars(messages: ChatMessage[]): number;
+export declare function compactMessages(messages: ChatMessage[], options?: CompactOptions): CompactResult;
+//# sourceMappingURL=compact.d.ts.map

package/dist/context/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/context/compact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;CACnB;AAQD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAMrE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CA2BhG"}

package/dist/context/compact.js

@@ -0,0 +1,38 @@
+function summarizeMessage(message, maxChars = 120) {
+    const content = typeof message.content === 'string' ? message.content.replace(/\s+/g, ' ').trim() : '';
+    const clipped = content.length > maxChars ? `${content.slice(0, maxChars)}...` : content;
+    return `- ${message.role}: ${clipped || '(no text)'}`;
+}
+export function estimateMessagesChars(messages) {
+    return messages.reduce((sum, msg) => {
+        const contentLen = typeof msg.content === 'string' ? msg.content.length : 0;
+        const toolCallLen = msg.tool_calls ? JSON.stringify(msg.tool_calls).length : 0;
+        return sum + contentLen + toolCallLen + 24;
+    }, 0);
+}
+export function compactMessages(messages, options) {
+    const keepRecent = Math.max(2, Math.floor(options?.keepRecent ?? 10));
+    if (messages.length <= keepRecent + 2) {
+        return { messages, compacted: false };
+    }
+    const systemMessages = messages.filter((m) => m.role === 'system');
+    const primarySystem = systemMessages[0];
+    const recent = messages.slice(-keepRecent);
+    const recentSet = new Set(recent);
+    const middle = messages.filter((m) => !recentSet.has(m) && m.role !== 'system');
+    if (middle.length === 0) {
+        return { messages, compacted: false };
+    }
+    const summaryLines = middle.slice(-60).map((m) => summarizeMessage(m));
+    const summaryMessage = {
+        role: 'system',
+        content: 'Conversation compact summary (older context compressed; verify with tools before editing):\n' +
+            summaryLines.join('\n'),
+    };
+    const rebuilt = [];
+    if (primarySystem)
+        rebuilt.push(primarySystem);
+    rebuilt.push(summaryMessage, ...recent.filter((m) => m !== primarySystem));
+    return { messages: rebuilt, compacted: true };
+}
+//# sourceMappingURL=compact.js.map

package/dist/context/compact.js.map

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

package/dist/context/orientation.d.ts

@@ -0,0 +1,19 @@
+export interface OrientationBudgets {
+    totalTokens: number;
+    agentsTokens: number;
+    progressTokens: number;
+    indexTokens: number;
+}
+export interface OrientationResult {
+    text: string;
+    tokensEstimate: number;
+    truncated: boolean;
+    sections: Array<{
+        name: 'agents' | 'progress' | 'index';
+        tokensEstimate: number;
+        included: boolean;
+        truncated: boolean;
+    }>;
+}
+export declare function buildOrientationContext(cwd: string, options?: Partial<OrientationBudgets>): Promise<OrientationResult>;
+//# sourceMappingURL=orientation.d.ts.map

package/dist/context/orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../../src/context/orientation.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;QACrC,cAAc,EAAE,MAAM,CAAA;QACtB,QAAQ,EAAE,OAAO,CAAA;QACjB,SAAS,EAAE,OAAO,CAAA;KACnB,CAAC,CAAA;CACH;AAuBD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAiG5B"}

package/dist/context/orientation.js

@@ -0,0 +1,111 @@
+import { loadAgentsGuidance } from "../artifacts/agents.js";
+import { ensureCodebaseIndex, readCodebaseIndex } from "../artifacts/codebase_index.js";
+import { ensureProgressArtifact, readProgressArtifact } from "../artifacts/progress.js";
+const DEFAULT_BUDGETS = {
+    totalTokens: 1200,
+    agentsTokens: 500,
+    progressTokens: 300,
+    indexTokens: 400,
+};
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function truncateToTokens(text, maxTokens) {
+    if (maxTokens <= 0)
+        return { text: '', truncated: text.length > 0 };
+    const maxChars = maxTokens * 4;
+    if (text.length <= maxChars)
+        return { text, truncated: false };
+    return {
+        text: `${text.slice(0, Math.max(0, maxChars - 45))}\n\n[...orientation section truncated...]`,
+        truncated: true,
+    };
+}
+export async function buildOrientationContext(cwd, options) {
+    const budgets = {
+        ...DEFAULT_BUDGETS,
+        ...options,
+    };
+    const safeBudgets = {
+        totalTokens: Math.max(0, Math.floor(budgets.totalTokens)),
+        agentsTokens: Math.max(0, Math.floor(budgets.agentsTokens)),
+        progressTokens: Math.max(0, Math.floor(budgets.progressTokens)),
+        indexTokens: Math.max(0, Math.floor(budgets.indexTokens)),
+    };
+    await ensureProgressArtifact(cwd);
+    await ensureCodebaseIndex(cwd);
+    const [agents, progress, index] = await Promise.all([
+        loadAgentsGuidance(cwd, { maxTokens: safeBudgets.agentsTokens }),
+        readProgressArtifact(cwd, { maxTokens: safeBudgets.progressTokens }),
+        readCodebaseIndex(cwd, { maxTokens: safeBudgets.indexTokens }),
+    ]);
+    let sectionStates = [
+        {
+            name: 'agents',
+            tokensEstimate: agents.tokensEstimate,
+            included: agents.text.trim() !== '',
+            truncated: agents.truncated,
+        },
+        {
+            name: 'progress',
+            tokensEstimate: progress.tokensEstimate,
+            included: progress.text.trim() !== '',
+            truncated: progress.truncated,
+        },
+        {
+            name: 'index',
+            tokensEstimate: index.tokensEstimate,
+            included: index.text.trim() !== '',
+            truncated: index.truncated,
+        },
+    ];
+    let sections = [
+        agents.text.trim() !== '' ? `### AGENTS Guidance\n${agents.text}` : '',
+        progress.text.trim() !== '' ? `### Progress Snapshot\n${progress.text}` : '',
+        index.text.trim() !== '' ? `### Codebase Index\n${index.text}` : '',
+    ].filter((x) => x !== '');
+    let merged = sections.join('\n\n');
+    let truncated = sectionStates.some((s) => s.truncated);
+    let totalTokens = estimateTokens(merged);
+    if (totalTokens > safeBudgets.totalTokens) {
+        const keepAgents = sections[0] ?? '';
+        const keepProgress = sections[1] ?? '';
+        const keepIndex = sections[2] ?? '';
+        const agentsTokens = estimateTokens(keepAgents);
+        const remaining = Math.max(0, safeBudgets.totalTokens - agentsTokens);
+        const progressBudget = Math.min(estimateTokens(keepProgress), Math.floor(remaining * 0.45));
+        const indexBudget = Math.max(0, remaining - progressBudget);
+        const clippedProgress = truncateToTokens(keepProgress, progressBudget);
+        const clippedIndex = truncateToTokens(keepIndex, indexBudget);
+        const rebuilt = [keepAgents, clippedProgress.text, clippedIndex.text].filter((x) => x.trim() !== '');
+        merged = rebuilt.join('\n\n');
+        totalTokens = estimateTokens(merged);
+        truncated = true;
+        sectionStates = sectionStates.map((section) => {
+            if (section.name === 'progress') {
+                return {
+                    ...section,
+                    tokensEstimate: estimateTokens(clippedProgress.text),
+                    truncated: section.truncated || clippedProgress.truncated,
+                    included: clippedProgress.text.trim() !== '',
+                };
+            }
+            if (section.name === 'index') {
+                return {
+                    ...section,
+                    tokensEstimate: estimateTokens(clippedIndex.text),
+                    truncated: section.truncated || clippedIndex.truncated,
+                    included: clippedIndex.text.trim() !== '',
+                };
+            }
+            return section;
+        });
+    }
+    return {
+        text: merged.trim(),
+        tokensEstimate: totalTokens,
+        truncated,
+        sections: sectionStates,
+    };
+}
+//# sourceMappingURL=orientation.js.map

package/dist/context/orientation.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}