ineedcodes 0.1.0

package/packages/cli/dist/setup.js

@@ -0,0 +1,240 @@
+import { bold, dim, green, red, yellow, cyan, truncate } from './ui/colors.js';
+export const PRESETS = [
+    { label: 'OmniRoute (running on this machine)', baseUrl: 'http://127.0.0.1:20128/v1', hint: 'local smart router' },
+    { label: 'OpenAI', baseUrl: 'https://api.openai.com/v1', hint: 'api.openai.com' },
+    { label: 'Other OpenAI-compatible API (custom URL)', baseUrl: '', hint: 'LM Studio, Ollama, vLLM, …' }
+];
+/** Fetch the model list from an OpenAI-compatible server. */
+export async function fetchModels(baseUrl, apiKey, timeoutMs = 15_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${baseUrl.replace(/\/+$/, '')}/models`, {
+            signal: controller.signal,
+            headers: apiKey ? { authorization: `Bearer ${apiKey}` } : {}
+        });
+        if (!res.ok)
+            return [];
+        const body = (await res.json());
+        return (body.data ?? []).map((m) => m.id ?? '').filter(Boolean).sort();
+    }
+    catch {
+        return [];
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Send one tiny chat completion to prove the setup works. */
+export async function testConnection(baseUrl, apiKey, model, timeoutMs = 45_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${baseUrl.replace(/\/+$/, '')}/chat/completions`, {
+            method: 'POST',
+            signal: controller.signal,
+            headers: { 'content-type': 'application/json', authorization: `Bearer ${apiKey}` },
+            body: JSON.stringify({
+                model,
+                messages: [{ role: 'user', content: 'Reply with exactly: OK' }],
+                max_tokens: 20
+            })
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            return { ok: false, detail: `HTTP ${res.status}: ${text.slice(0, 200) || res.statusText}` };
+        }
+        const body = (await res.json());
+        const reply = body.choices?.[0]?.message?.content?.trim().slice(0, 40) ?? '';
+        return { ok: true, detail: reply ? `model replied "${truncate(reply, 30)}"` : 'model replied', servedBy: body.model };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, detail: message };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Interactive model picker against the live server. Returns a model id. */
+export async function pickModel(lr, baseUrl, apiKey, prefill, curated) {
+    // Curated list wins when present: show only those, keep it simple.
+    if (curated && curated.length > 0) {
+        process.stdout.write(green(`\nAvailable models (${curated.length}):\n`));
+        curated.forEach((m, i) => {
+            const marker = m === prefill ? green(' ← current') : '';
+            process.stdout.write(`  ${cyan(String(i + 1).padStart(2))}. ${m}${marker}\n`);
+        });
+        while (true) {
+            const pick = await lr.ask(`Pick a number ${dim('[1]')} (or type a full model id):`);
+            if (pick.cancelled)
+                return undefined;
+            if (!pick.input)
+                return curated[0];
+            const idx = Number.parseInt(pick.input, 10);
+            if (Number.isInteger(idx) && idx >= 1 && idx <= curated.length)
+                return curated[idx - 1];
+            if (pick.input.includes('/'))
+                return pick.input; // escape hatch: any id
+            process.stdout.write(red('Not a valid number. Try again.\n'));
+        }
+    }
+    process.stdout.write(dim('\nFetching the model list from your server…\n'));
+    const models = await fetchModels(baseUrl, apiKey);
+    if (models.length === 0) {
+        const r = await lr.ask(`Model id ${prefill ? dim(`[default: ${prefill}]`) : ''}:`);
+        if (r.cancelled)
+            return undefined;
+        return r.input || prefill || undefined;
+    }
+    process.stdout.write(green(`Found ${models.length} model(s).\n`));
+    while (true) {
+        const filterR = await lr.ask(`Filter models by typing part of the name ${dim(`(e.g. "fast", "claude"; Enter shows popular ones${prefill ? `; default: ${prefill}` : ''})`)}:`);
+        if (filterR.cancelled)
+            return undefined;
+        const typed = filterR.input.trim();
+        if (typed && models.includes(typed))
+            return typed;
+        if (!typed && prefill && models.includes(prefill)) {
+            const keep = await lr.ask(dim(`Keep current model "${prefill}"? [Y/n]:`));
+            if (!keep.cancelled && !/^n/i.test(keep.input))
+                return prefill;
+        }
+        const needle = typed.toLowerCase();
+        const matches = models.filter((m) => m.toLowerCase().includes(needle));
+        if (matches.length === 0) {
+            process.stdout.write(red(`No model matches "${typed}". Try another word.\n`));
+            continue;
+        }
+        const shown = matches.slice(0, 15);
+        process.stdout.write('\n');
+        shown.forEach((m, i) => {
+            process.stdout.write(`  ${cyan(String(i + 1).padStart(2))}. ${m}\n`);
+        });
+        if (matches.length > shown.length) {
+            process.stdout.write(dim(`  … ${matches.length - shown.length} more: type a narrower filter\n`));
+        }
+        const pick = await lr.ask(`Pick a number ${dim('[1]')}:`);
+        if (pick.cancelled)
+            return undefined;
+        if (!pick.input)
+            return shown[0];
+        const idx = Number.parseInt(pick.input, 10);
+        if (Number.isInteger(idx) && idx >= 1 && idx <= shown.length)
+            return shown[idx - 1];
+        if (models.includes(pick.input))
+            return pick.input;
+        process.stdout.write(red('Not a valid number. Try again.\n'));
+    }
+}
+/** Classify why a server did not return a model list. */
+async function diagnoseConnection(baseUrl, apiKey) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 12_000);
+        const res = await fetch(`${baseUrl.replace(/\/+$/, '')}/models`, {
+            signal: controller.signal,
+            headers: apiKey ? { authorization: `Bearer ${apiKey}` } : {}
+        });
+        clearTimeout(timer);
+        if (res.status === 401 || res.status === 403)
+            return 'bad_key';
+        return 'no_models';
+    }
+    catch {
+        return 'unreachable';
+    }
+}
+/**
+ * Full first-run wizard. Saves into ~/.ineedcodes/config.json via onSave.
+ * Returns the configured values, or undefined if the user cancelled.
+ */
+export async function runSetupWizard(lr, existing, onSave) {
+    process.stdout.write('\n' + bold('Welcome to iNeedCodes!') + '\n');
+    process.stdout.write('Let\'s connect it to an AI provider. You only do this once.\n\n');
+    // 1. Preset
+    let selected;
+    while (true) {
+        process.stdout.write(bold('Which provider do you want to use?') + '\n');
+        PRESETS.forEach((p, i) => {
+            process.stdout.write(`  ${cyan(String(i + 1))}. ${p.label} ${dim(`(${p.hint})`)}\n`);
+        });
+        const choice = await lr.ask(`Your choice ${dim('[1]')}:`);
+        if (choice.cancelled)
+            return undefined;
+        const n = Number.parseInt(choice.input || '1', 10);
+        selected = PRESETS[n - 1];
+        if (selected)
+            break;
+        process.stdout.write(red('Pick a number from the list.\n'));
+    }
+    // 2. Base URL
+    let baseUrl = selected.baseUrl;
+    while (true) {
+        const r = await lr.ask(`API base URL ${dim(`[${selected.baseUrl || existing?.baseUrl || 'https://api.openai.com/v1'}]`)}:`);
+        if (r.cancelled)
+            return undefined;
+        const typed = r.input.trim();
+        baseUrl = typed || selected.baseUrl || existing?.baseUrl || 'https://api.openai.com/v1';
+        if (/^https?:\/\//.test(baseUrl))
+            break;
+        process.stdout.write(red('URL must start with http:// or https://\n'));
+    }
+    // 3. API key
+    let apiKey = existing?.apiKey ?? '';
+    while (!apiKey) {
+        const r = await lr.ask('API key (paste it, then Enter):');
+        if (r.cancelled)
+            return undefined;
+        apiKey = r.input.trim();
+        if (!apiKey)
+            process.stdout.write(yellow('An API key is required.\n'));
+    }
+    // 4. Connection check: GET /models proves reachability + auth in one shot.
+    process.stdout.write(dim('\nChecking connection…\n'));
+    const reachable = await fetchModels(baseUrl, apiKey, 12_000);
+    const authProbe = reachable.length > 0
+        ? 'ok'
+        : await diagnoseConnection(baseUrl, apiKey);
+    if (authProbe === 'ok') {
+        process.stdout.write(green('✓ Connected.') + dim(` (${reachable.length} model(s) available)\n`));
+    }
+    else if (authProbe === 'bad_key') {
+        process.stdout.write(red('✗ The server rejected the API key. Let\'s fix that.\n'));
+        const retry = await lr.ask('Paste the API key again (Enter keeps going anyway):');
+        if (retry.cancelled)
+            return undefined;
+        if (retry.input.trim())
+            apiKey = retry.input.trim();
+    }
+    else if (authProbe === 'unreachable') {
+        process.stdout.write(yellow(`⚠ Could not reach ${baseUrl}.\n`));
+        const keep = await lr.ask('Keep this URL anyway? [y/N]:');
+        if (keep.cancelled || !/^y/i.test(keep.input))
+            return undefined;
+    }
+    else {
+        process.stdout.write(yellow('⚠ Server reachable, but no model list endpoint. Continuing anyway.\n'));
+    }
+    // 5. Model picker
+    const model = await pickModel(lr, baseUrl, apiKey, existing?.model ?? '');
+    if (!model)
+        return undefined;
+    // 6. Final verification with the chosen model
+    process.stdout.write(dim(`\nTesting ${model}…\n`));
+    const final = await testConnection(baseUrl, apiKey, model);
+    if (final.ok) {
+        process.stdout.write(green('✓ Works!') + (final.servedBy && final.servedBy !== model ? dim(` (routed to ${final.servedBy})`) : '') + '\n');
+    }
+    else {
+        process.stdout.write(yellow(`⚠ Model test did not pass (${final.detail}). Saving anyway: you can change the model later with /model.\n`));
+    }
+    const values = { baseUrl, apiKey, model };
+    if (onSave) {
+        await onSave(values);
+        process.stdout.write(green('\nSaved to ~/.ineedcodes/config.json') + '\n');
+        process.stdout.write('All set! From now on just run ' + bold('ineed') + ' in any project and say what you want.\n');
+    }
+    return values;
+}
+//# sourceMappingURL=setup.js.map

package/packages/cli/dist/setup.js.map

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

package/packages/cli/dist/tools-setup.d.ts

@@ -0,0 +1,12 @@
+import type { ToolRegistry, ToolContext } from '@ineedcodes/core';
+import { ProcessManager } from '@ineedcodes/core';
+export declare function getProcessManager(): ProcessManager;
+export declare function shutdownProcesses(): void;
+export declare function registerBuiltinTools(registry: ToolRegistry, opts: {
+    webSearch?: {
+        provider: string;
+        apiKey?: string;
+        baseUrl?: string;
+    };
+}): void;
+export declare function buildToolContext(workspaceRoot: string, cwd: string, permissions: ToolContext['permissions']): ToolContext;

package/packages/cli/dist/tools-setup.js

@@ -0,0 +1,28 @@
+import { createFilesystemTools, createSearchTools, createShellTools, createGitTools, createWebTools, ProcessManager } from '@ineedcodes/core';
+let manager;
+export function getProcessManager() {
+    if (!manager) {
+        manager = new ProcessManager();
+        globalThis['__ineedcodesProcessManager'] = manager;
+    }
+    return manager;
+}
+export function shutdownProcesses() {
+    manager?.drain();
+}
+export function registerBuiltinTools(registry, opts) {
+    for (const tool of createFilesystemTools())
+        registry.register(tool);
+    for (const tool of createSearchTools())
+        registry.register(tool);
+    for (const tool of createShellTools())
+        registry.register(tool);
+    for (const tool of createGitTools())
+        registry.register(tool);
+    for (const tool of createWebTools(opts.webSearch))
+        registry.register(tool);
+}
+export function buildToolContext(workspaceRoot, cwd, permissions) {
+    return { workspaceRoot, cwd, permissions, processManager: getProcessManager() };
+}
+//# sourceMappingURL=tools-setup.js.map

package/packages/cli/dist/tools-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-setup.js","sourceRoot":"","sources":["../src/tools-setup.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,IAAI,OAAmC,CAAC;AAExC,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QAC9B,UAA8D,CAAC,4BAA4B,CAAC,GAAG,OAAO,CAAC;IAC1G,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,IAA6E;IAE7E,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpE,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChE,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,aAAqB,EAAE,GAAW,EAAE,WAAuC;IAC1G,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,EAAE,CAAC;AAClF,CAAC"}

package/packages/cli/dist/ui/approval.d.ts

@@ -0,0 +1,12 @@
+import type { PermissionCategory, PermissionDecision } from '@ineedcodes/core';
+/**
+ * Terminal approval prompt used by the permission engine when a high-impact
+ * action needs a decision. Asking is the runtime's job, not the prompt's.
+ */
+export declare function askApproval(question: string, detail?: string): Promise<boolean>;
+export declare function askApprovalWithScope(question: string, detail?: string): Promise<{
+    approved: boolean;
+    always: boolean;
+}>;
+export declare function printDecision(decision: PermissionDecision): void;
+export declare function listCategories(categories: readonly PermissionCategory[]): string;

package/packages/cli/dist/ui/approval.js

@@ -0,0 +1,52 @@
+import { bold, dim, green, red, yellow } from './colors.js';
+/**
+ * Terminal approval prompt used by the permission engine when a high-impact
+ * action needs a decision. Asking is the runtime's job, not the prompt's.
+ */
+export async function askApproval(question, detail) {
+    const { approved } = await askApprovalWithScope(question, detail);
+    return approved;
+}
+export async function askApprovalWithScope(question, detail) {
+    process.stdout.write('\n' + bold(yellow('⚠ Approval needed')) + '\n');
+    process.stdout.write(`  ${question}\n`);
+    if (detail)
+        process.stdout.write(dim(`  ${detail}\n`));
+    process.stdout.write(dim('  [y] yes, once · [a] always for this session · [n] no\n'));
+    const answer = await readLine('your choice: ');
+    const normalized = answer.trim().toLowerCase();
+    if (normalized === 'a')
+        return { approved: true, always: true };
+    return { approved: normalized === 'y', always: false };
+}
+export function printDecision(decision) {
+    if (decision.allowed) {
+        process.stdout.write(green('✓ allowed') + '\n');
+    }
+    else {
+        process.stdout.write(red('✗ blocked') + ' ' + dim(decision.reason) + '\n');
+    }
+}
+export function listCategories(categories) {
+    return categories.join(', ');
+}
+function readLine(promptText) {
+    return new Promise((resolve) => {
+        process.stdout.write(dim(promptText));
+        let input = '';
+        const onData = (chunk) => {
+            input += chunk.toString('utf8');
+            if (input.includes('\n')) {
+                cleanup();
+                resolve(input.trim());
+            }
+        };
+        const cleanup = () => {
+            process.stdin.removeListener('data', onData);
+            process.stdin.pause();
+        };
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+    });
+}
+//# sourceMappingURL=approval.js.map

package/packages/cli/dist/ui/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/ui/approval.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,MAAe;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,MAAe;IAEf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChE,OAAO,EAAE,QAAQ,EAAE,UAAU,KAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAA4B;IACxD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAyC;IACtE,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,QAAQ,CAAC,UAAkB;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QACtC,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/cli/dist/ui/colors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal ANSI helpers: zero dependencies, safe on all modern terminals.
+ */
+export declare function ansi(code: string, text: string): string;
+export declare const bold: (t: string) => string;
+export declare const dim: (t: string) => string;
+export declare const red: (t: string) => string;
+export declare const green: (t: string) => string;
+export declare const yellow: (t: string) => string;
+export declare const blue: (t: string) => string;
+export declare const magenta: (t: string) => string;
+export declare const cyan: (t: string) => string;
+export declare const gray: (t: string) => string;
+export declare function truncate(text: string, max?: number): string;

package/packages/cli/dist/ui/colors.js

@@ -0,0 +1,21 @@
+/**
+ * Minimal ANSI helpers: zero dependencies, safe on all modern terminals.
+ */
+const enabled = process.env['NO_COLOR'] === undefined && process.stdout.isTTY;
+export function ansi(code, text) {
+    return enabled ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+export const bold = (t) => ansi('1', t);
+export const dim = (t) => ansi('2', t);
+export const red = (t) => ansi('31', t);
+export const green = (t) => ansi('32', t);
+export const yellow = (t) => ansi('33', t);
+export const blue = (t) => ansi('34', t);
+export const magenta = (t) => ansi('35', t);
+export const cyan = (t) => ansi('36', t);
+export const gray = (t) => ansi('90', t);
+export function truncate(text, max = 160) {
+    const oneLine = text.replaceAll('\n', ' ⏎ ');
+    return oneLine.length > max ? oneLine.slice(0, max - 1) + '…' : oneLine;
+}
+//# sourceMappingURL=colors.js.map

package/packages/cli/dist/ui/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAE9E,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,IAAY;IAC7C,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAEzD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAG,GAAG,GAAG;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1E,CAAC"}

package/packages/cli/dist/ui/prompts.d.ts

@@ -0,0 +1,46 @@
+/**
+ * One shared line reader for the whole process. Lines that arrive while no
+ * question is pending are buffered, so piped input works too.
+ */
+export declare class LineReader {
+    private rl;
+    private buffered;
+    private pending?;
+    private closed;
+    constructor();
+    ask(label: string): Promise<PromptResult>;
+    /** True once stdin hit EOF: no more input will ever arrive. */
+    isClosed(): boolean;
+    close(): void;
+}
+export interface PromptResult {
+    input: string;
+    cancelled: boolean;
+}
+/** The main session prompt: `ineedcodes ❯` */
+export declare function createPrompt(): {
+    ask(): Promise<PromptResult>;
+    question(text: string): Promise<PromptResult>;
+    isClosed(): boolean;
+    close(): void;
+};
+export declare const BANNER: string;
+export declare function printHelp(): void;
+export declare function printStatus(info: {
+    model: string;
+    provider: string;
+    mode: string;
+    depth: string;
+    projectRoot: string;
+    git: string;
+    memory: string;
+    skills: string[];
+    processes: number;
+    agentMode: 'plan' | 'build';
+    thinking: 'low' | 'medium' | 'high';
+    contextTokens: {
+        total: number;
+        limit: number;
+        compactsAt: number;
+    };
+}): void;

package/packages/cli/dist/ui/prompts.js

@@ -0,0 +1,135 @@
+import * as readline from 'node:readline';
+import { bold, dim, green, cyan, gray, truncate } from './colors.js';
+/**
+ * One shared line reader for the whole process. Lines that arrive while no
+ * question is pending are buffered, so piped input works too.
+ */
+export class LineReader {
+    rl;
+    buffered = [];
+    pending;
+    closed = false;
+    constructor() {
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: '',
+            historySize: 200
+        });
+        this.rl.on('line', (line) => {
+            if (this.pending) {
+                const resolve = this.pending;
+                this.pending = undefined;
+                resolve({ input: line, cancelled: false });
+            }
+            else {
+                this.buffered.push(line);
+            }
+        });
+        this.rl.on('SIGINT', () => {
+            process.stdout.write('\n');
+            if (this.pending) {
+                const resolve = this.pending;
+                this.pending = undefined;
+                resolve({ input: '', cancelled: true });
+            }
+        });
+        this.rl.on('close', () => {
+            this.closed = true;
+            if (this.pending) {
+                const resolve = this.pending;
+                this.pending = undefined;
+                resolve({ input: '', cancelled: true });
+            }
+        });
+    }
+    ask(label) {
+        return new Promise((resolve) => {
+            if (this.buffered.length > 0) {
+                const line = this.buffered.shift() ?? '';
+                resolve({ input: line.trim(), cancelled: false });
+                return;
+            }
+            if (this.closed) {
+                resolve({ input: '', cancelled: true });
+                return;
+            }
+            process.stdout.write(label + ' ');
+            this.pending = resolve;
+        });
+    }
+    /** True once stdin hit EOF: no more input will ever arrive. */
+    isClosed() {
+        return this.closed;
+    }
+    close() {
+        this.rl.close();
+    }
+}
+/** The main session prompt: `ineedcodes ❯` */
+export function createPrompt() {
+    const lr = new LineReader();
+    const label = () => '\n' + bold(green('ineed')) + dim(' ❯');
+    return {
+        ask: () => lr.ask(label()),
+        question: (text) => lr.ask(text),
+        isClosed: () => lr.isClosed(),
+        close: () => lr.close()
+    };
+}
+export const BANNER = String.raw `
+  ██╗███╗   ██╗███████╗███████╗██████╗
+  ██║████╗  ██║██╔════╝██╔════╝██╔══██╗
+  ██║██╔██╗ ██║█████╗  █████╗  ██║  ██║
+  ██║██║╚██╗██║██╔══╝  ██╔══╝  ██║  ██║
+  ██║██║ ╚████║███████╗███████╗██████╔╝
+  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝╚═════╝
+  your terminal, now autonomous
+`;
+export function printHelp() {
+    const rows = [
+        ['/help', 'show this help'],
+        ['/model', 'show current model, or pick one interactively from your provider'],
+        ['/context', 'show what the model can see right now (tokens per part)'],
+        ['/init', 'scan this project and generate AGENTS.md instructions'],
+        ['/status', 'show session status'],
+        ['/agents', 'show sub-agents of the last task'],
+        ['/memory', 'recall or save memories (e.g. /memory save use pnpm, never npm)'],
+        ['/skills', 'list available skills; /skills <name> shows the skill text'],
+        ['/permissions', 'show or change permission mode: ask | workspace | autonomous'],
+        ['/explain', 'set explanation depth: beginner | balanced | terse'],
+        ['/resume', 'resume a previous session'],
+        ['/clear', 'start a fresh session (wipes current conversation)'],
+        ['/copy', 'copy the last answer to your clipboard'],
+        ['/compact', 'compact the conversation context now'],
+        ['/doctor', 'check installation, config, model and memory health'],
+        ['/setup', 're-run the interactive setup wizard'],
+        ['/exit', 'leave iNeedCodes (Ctrl+C twice also works)']
+    ];
+    process.stdout.write('\n' + bold('Slash commands') + gray(': optional shortcuts; plain language always works:') + '\n');
+    for (const [cmd, desc] of rows) {
+        process.stdout.write(`  ${cyan(cmd.padEnd(14))} ${dim(desc)}\n`);
+    }
+    process.stdout.write('\n' + dim('Just type what you want. Examples:') + '\n');
+    process.stdout.write(dim('  fix the build errors in this project\n') + dim('  explain this repository like I am a beginner\n'));
+}
+export function printStatus(info) {
+    process.stdout.write('\n' + bold('Status') + '\n');
+    const rows = [
+        ['model', `${info.model} (${info.provider})`],
+        ['mode', info.agentMode === 'plan' ? 'plan (read-only)' : 'build (full tools)'],
+        ['thinking', info.thinking],
+        ['permission mode', info.mode],
+        ['explanation depth', info.depth],
+        ['context', `${info.contextTokens.total}/${info.contextTokens.limit} tokens (compact at ${info.contextTokens.compactsAt})`],
+        ['project', info.projectRoot],
+        ['git', info.git],
+        ['memory', info.memory],
+        ['skills', info.skills.join(', ') || '(none)'],
+        ['background processes', String(info.processes)]
+    ];
+    for (const [k, v] of rows) {
+        process.stdout.write(`  ${dim(k.padEnd(20))} ${truncate(v, 100)}\n`);
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/packages/cli/dist/ui/prompts.js.map

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

package/packages/cli/dist/ui/renderer.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeEvent } from '@ineedcodes/agent';
+/**
+ * Renders agent runtime events into a readable terminal stream.
+ * Beginners get plain-English narration; the raw data is there for
+ * advanced users in the tool output blocks.
+ */
+export declare class Renderer {
+    private currentTurn;
+    handle(event: RuntimeEvent): Promise<void>;
+    private renderToolResult;
+    private describeInput;
+    private line;
+}