ikie-cli 0.1.4 → 0.1.6

package/README.md

@@ -4,13 +4,13 @@
 
 ```bash
 npm install -g ikie-cli
+ikie login
 ikie "write a rust web server"
 ```
 
 ## Features
 
-- Streaming AI chat completions via Fireworks AI (default: Kimi K2)
-- 10 built-in tools: read/write/edit files, bash, search, grep, memory, agent spawn
+- 12 built-in tools: read/write/edit files, bash, search, grep, memory, agent spawn, web fetch & search
 - Interactive REPL with slash commands, markdown rendering, and session management
 - One-shot mode: `ikie "your prompt"`
 - Image paste support (Ctrl+V)
@@ -22,14 +22,22 @@ ikie "write a rust web server"
 # Install
 npm install -g ikie
 
-# Set your API key
-export FIREWORKS_API_KEY=fw_...
+# Sign in to your ikie account
+ikie login
 
 # Start coding
 ikie "refactor this file and add tests"
 ```
 
+## Web access
+
+ikie can read pages and search the web:
+
+- **`fetch_url`** — read any page or URL (HTML is stripped to plain text).
+- **`web_search`** — search the web and get back titles, URLs, and snippets. Powered by the ikie
+  server — no separate search API key needed; your ikie login is enough.
+
 ## Requirements
 
 - Node.js 20+
-- A Fireworks AI API key (or any OpenAI-compatible endpoint via `--base-url`)
+- An ikie account — sign in with `ikie login`

package/dist/agent.d.ts

@@ -64,5 +64,5 @@ export declare class Agent {
     private checkPermission;
 }
 export declare const SUBAGENT_FRAMING = "You are a focused sub-agent spawned by Ikie to autonomously complete ONE specific task.\nWork independently \u2014 do not ask the user questions. Use your tools to gather what you\nneed, do the work, and verify it. When finished, your FINAL message must be a concise\nsummary of what you did and any key results (paths changed, findings, answers). That\nsummary is the only thing returned to the main agent, so make it self-contained.";
-export declare const PLAN_MODE_ADDENDUM = "\n\n## PLAN MODE (read-only)\nYou are currently in **plan mode**. You have ONLY read-only tools (read_file,\nlist_dir, search_files, grep, spawn_agent, ask_user). You CANNOT write files, edit\nfiles, run shell commands, or change anything \u2014 those tools are unavailable and any\nattempt will be blocked.\n\nYour job is to investigate and produce a clear, actionable plan:\n- Explore the relevant files and understand the current state before proposing anything.\n- Do NOT describe changes as if you already made them. You haven't.\n- End your response with a concise plan: a short **## Plan** heading followed by\n  numbered steps. Name the specific files to change and what to change in each. Call\n  out risks, assumptions, or open questions.\n- Keep it tight \u2014 enough to execute from, not an essay.\n\nAfter you present the plan, the user will be asked whether to execute it. On approval,\nyou'll be switched to agent mode and asked to carry out exactly this plan.";
+export declare const PLAN_MODE_ADDENDUM = "\n\n## PLAN MODE (read-only)\nYou are currently in **plan mode**. You have ONLY read-only tools (read_file,\nlist_dir, search_files, grep, fetch_url, web_search, spawn_agent, ask_user). You CANNOT write files, edit\nfiles, run shell commands, or change anything \u2014 those tools are unavailable and any\nattempt will be blocked.\n\nYour job is to investigate and produce a clear, actionable plan:\n- Explore the relevant files and understand the current state before proposing anything.\n- Do NOT describe changes as if you already made them. You haven't.\n- End your response with a concise plan: a short **## Plan** heading followed by\n  numbered steps. Name the specific files to change and what to change in each. Call\n  out risks, assumptions, or open questions.\n- Keep it tight \u2014 enough to execute from, not an essay.\n\nAfter you present the plan, the user will be asked whether to execute it. On approval,\nyou'll be switched to agent mode and asked to carry out exactly this plan.";
 export declare function buildSystemPrompt(projectContext: string, memoryContext: string): string;

package/dist/agent.js

@@ -47,6 +47,8 @@ function toolPhaseLabel(name) {
         case 'list_dir': return 'Listing directory';
         case 'search_files': return 'Searching';
         case 'grep': return 'Searching';
+        case 'fetch_url': return 'Fetching';
+        case 'web_search': return 'Searching web';
         default: return `Preparing ${name}`;
     }
 }
@@ -621,7 +623,7 @@ export const PLAN_MODE_ADDENDUM = `
 
 ## PLAN MODE (read-only)
 You are currently in **plan mode**. You have ONLY read-only tools (read_file,
-list_dir, search_files, grep, spawn_agent, ask_user). You CANNOT write files, edit
+list_dir, search_files, grep, fetch_url, web_search, spawn_agent, ask_user). You CANNOT write files, edit
 files, run shell commands, or change anything — those tools are unavailable and any
 attempt will be blocked.
 
@@ -715,6 +717,23 @@ changes they didn't ask for.
 - \`search_files\`: Find files by glob pattern
 - \`grep\`: Search file contents by regex
 - \`memory_write\`: Persist important notes across sessions
+- \`fetch_url\`: Fetch a web page or URL and return its readable text (HTML is stripped to plain text).
+  Use it to read docs, articles, or API responses when you have a URL.
+- \`web_search\`: Search the web for a query and get back titles, URLs, and snippets. Works
+  automatically for logged-in ikie users — no separate API key needed. Combine with \`fetch_url\`
+  to read a promising result in full.
+
+## Using web_search correctly
+- **Always search when the user asks about anything current** — versions, prices, news, docs,
+  release dates. Never answer from memory alone for time-sensitive facts.
+- **Check dates in snippets.** Results are ordered by relevance, not recency. If snippets show
+  conflicting versions or dates, fetch the most promising URL to get the ground truth.
+- **For "latest X" queries**, include the current year in your search (e.g. "latest Node.js version 2026")
+  to surface recent results over older cached pages.
+- **If a fetch returns 403/blocked**, try a different URL from the search results — don't give up.
+- **Trust fetched page content over snippet summaries** — snippets can be stale; the live page is authoritative.
+- **Never state a version, date, or fact as definitive if your search results conflict** — say what
+  the most recent source says and link it.
 - \`ask_user\`: Ask the user a clarifying question when you need more info to proceed.
   The user's answer is returned as the tool result. Use sparingly — only when genuinely
   unsure. Don't ask for confirmation on safe operations.

package/dist/auth.js

@@ -85,5 +85,5 @@ export async function login() {
 }
 export function logout() {
     clearLogin();
-    console.log(successLine('Logged out. ikie will use your local API key / Fireworks again.'));
+    console.log(successLine('Logged out. Run `ikie login` to sign back in.'));
 }

package/dist/config.d.ts

@@ -37,5 +37,5 @@ export declare function getApiKey(cfg: IkieConfig): string | undefined;
 export declare function isLoggedIn(cfg: IkieConfig): boolean;
 /** Persist the hosted account login (ik_live_ key from `ikie login`). */
 export declare function saveLogin(apiKey: string): void;
-/** Clear the hosted account login and revert to the default base URL. */
+/** Clear the hosted account login. */
 export declare function clearLogin(): void;

package/dist/config.js

@@ -17,7 +17,7 @@ const DEFAULTS = {
     model: DEFAULT_MODEL,
     maxTokens: 32768,
     autoApprove: false,
-    baseURL: FIREWORKS_BASE_URL,
+    baseURL: IKIE_API_BASE,
     temperature: 0.6,
     topP: 0.95,
     topK: 40,
@@ -47,10 +47,7 @@ export function saveConfig(patch) {
     writeFileSync(CONFIG_FILE, JSON.stringify({ ...current, ...patch }, null, 2));
 }
 export function getApiKey(cfg) {
-    return (process.env.FIREWORKS_API_KEY ??
-        process.env.IKIE_API_KEY ??
-        cfg.account?.apiKey ??
-        cfg.apiKey);
+    return cfg.account?.apiKey;
 }
 /** True when signed into a hosted ikie account. */
 export function isLoggedIn(cfg) {
@@ -60,10 +57,9 @@ export function isLoggedIn(cfg) {
 export function saveLogin(apiKey) {
     saveConfig({ account: { apiKey, loggedInAt: Date.now() }, baseURL: IKIE_API_BASE });
 }
-/** Clear the hosted account login and revert to the default base URL. */
+/** Clear the hosted account login. */
 export function clearLogin() {
     const current = loadConfig();
     delete current.account;
-    current.baseURL = FIREWORKS_BASE_URL;
     writeFileSync(CONFIG_FILE, JSON.stringify(current, null, 2));
 }

package/dist/index.js

@@ -2,7 +2,7 @@
 import process from 'process';
 import OpenAI from 'openai';
 import minimist from 'minimist';
-import { loadConfig, getApiKey, FIREWORKS_BASE_URL, DEFAULT_MODEL, isLoggedIn, IKIE_API_BASE } from './config.js';
+import { loadConfig, getApiKey, IKIE_API_BASE, DEFAULT_MODEL } from './config.js';
 import { detectProjectContext, formatContextForPrompt } from './context.js';
 import { loadAllMemory, formatMemoryForPrompt } from './memory.js';
 import { buildSystemPrompt, Agent } from './agent.js';
@@ -10,7 +10,7 @@ import { startREPL } from './repl.js';
 import { login, logout } from './auth.js';
 import { c, errorLine } from './theme.js';
 const argv = minimist(process.argv.slice(2), {
-    string: ['model', 'api-key', 'base-url', 'rpm'],
+    string: ['model', 'rpm'],
     boolean: ['help', 'version', 'yes', 'verbose'],
     alias: { h: 'help', v: 'version', y: 'yes', m: 'model' },
 });
@@ -28,17 +28,11 @@ ${c.primary('Usage:')}
 ${c.primary('Options:')}
   ${c.accent('-m, --model')} ${c.muted('<id>')}     Model ID (default: ${c.dim(DEFAULT_MODEL)})
   ${c.accent('-y, --yes')}              Auto-approve all tool executions
-  ${c.accent('--api-key')} ${c.muted('<key>')}       Fireworks API key
-  ${c.accent('--base-url')} ${c.muted('<url>')}      API base URL (default: Fireworks AI)
   ${c.accent('--rpm')} ${c.muted('<number>')}        Max model requests per minute (default: 10)
   ${c.accent('--verbose')}             Debug output
   ${c.accent('-h, --help')}            Show this help
   ${c.accent('-v, --version')}         Show version
 
-${c.primary('Environment:')}
-  ${c.muted('FIREWORKS_API_KEY')}        Fireworks AI API key
-  ${c.muted('IKIE_API_KEY')}             Alternative key env var
-
 ${c.primary('In-session commands:')}
   ${c.muted('/help  /clear  /memory  /session  /plan  /agent  /usage  /model  /exit')}
   ${c.muted('Shift+Tab  Toggle plan ⇄ agent mode')}
@@ -79,37 +73,24 @@ async function main() {
         config.model = argv.model;
     if (argv.yes)
         config.autoApprove = true;
-    if (argv['api-key'])
-        config.apiKey = argv['api-key'];
-    if (argv['base-url'])
-        config.baseURL = argv['base-url'];
     if (argv.rpm) {
         const rpm = Number(argv.rpm);
         if (Number.isFinite(rpm) && rpm > 0)
             config.requestsPerMinute = Math.floor(rpm);
     }
-    // When signed into a hosted account, default to the ikie API endpoint
-    // unless the user explicitly overrode it on the CLI.
-    if (isLoggedIn(config) && !argv['base-url']) {
-        config.baseURL = IKIE_API_BASE;
-    }
     const apiKey = getApiKey(config);
     if (!apiKey) {
         console.error(`
 ${errorLine('Not signed in.')}
 
-  Sign in to your ikie account (recommended):
+  Sign in to continue:
     ${c.accent('ikie login')}
-
-  Or bring your own Fireworks key:
-    ${c.accent('export FIREWORKS_API_KEY=fw_...')}
-    ${c.accent('ikie --api-key fw_...')}
 `);
         process.exit(1);
     }
     const client = new OpenAI({
         apiKey,
-        baseURL: config.baseURL ?? FIREWORKS_BASE_URL,
+        baseURL: config.baseURL ?? IKIE_API_BASE,
     });
     const projectCtx = detectProjectContext();
     const projectContextStr = formatContextForPrompt(projectCtx);

package/dist/repl.js

@@ -4,13 +4,13 @@ import { restoreStdinListeners } from './agent.js';
 import { c, PROMPT, CONTINUE_PROMPT, printPromptHeader, modeTag, drawBanner, infoLine, successLine, errorLine, THEMES, setTheme, stripAnsi, } from './theme.js';
 import { renderMarkdown } from './renderer.js';
 import { loadAllMemory } from './memory.js';
-import { HOME_DIR, saveConfig, DEFAULT_MODEL, FIREWORKS_BASE_URL, IKIE_HOST, isLoggedIn, getApiKey } from './config.js';
+import { HOME_DIR, saveConfig, DEFAULT_MODEL, IKIE_HOST, IKIE_API_BASE, isLoggedIn, getApiKey } from './config.js';
 import { login, logout } from './auth.js';
 import { join as pathJoin } from 'path';
 import { deleteSession, listSessions, loadSession, normalizeSessionName, saveSession } from './session.js';
 import { buildUserContent, formatBytes, loadClipboardImageAttachment, loadImageAttachment, hasClipboardImage } from './attachments.js';
 async function fetchModelsFromServer(config) {
-    const baseUrl = config.baseURL || FIREWORKS_BASE_URL;
+    const baseUrl = config.baseURL || IKIE_API_BASE;
     const apiUrl = baseUrl.includes('/api/v1')
         ? baseUrl.replace('/api/v1', '/api/models')
         : `${IKIE_HOST}/api/models`;
@@ -371,7 +371,7 @@ async function handleSlashCommand(input, agent, config, projectContext, rl, sess
                 console.log(`  ${c.secondary('Auto Approve:')}     ${c.white(config.autoApprove ? 'Yes' : 'No')}`);
                 console.log(`  ${c.secondary('Requests/min:')}     ${c.white(config.requestsPerMinute)}`);
                 console.log(`  ${c.secondary('Theme:')}            ${c.white(config.theme)}`);
-                console.log(`  ${c.secondary('Base URL:')}         ${c.white(config.baseURL ?? FIREWORKS_BASE_URL)}`);
+                console.log(`  ${c.secondary('Base URL:')}         ${c.white(config.baseURL ?? IKIE_API_BASE)}`);
                 console.log(`\n  ${c.muted('Use')} ${c.warning('/settings <option> <value>')} ${c.muted('to change settings')}`);
                 console.log(`  ${c.muted('Options:')} model, temperature, max-tokens, top-p, top-k, auto-approve, rpm, theme`);
                 return true;

package/dist/theme.js

@@ -182,6 +182,8 @@ function truncate(str, max) {
     return str.slice(0, Math.max(0, max - 3)) + '...';
 }
 function formatModel(model) {
+    if (!model)
+        return 'none';
     const parts = model.split('/');
     return parts[parts.length - 1] || model;
 }

package/dist/tools.js

@@ -167,15 +167,45 @@ export const TOOL_DEFS = [
             },
         },
     },
+    {
+        type: 'function',
+        function: {
+            name: 'fetch_url',
+            description: 'Fetch a web page (or any URL) over HTTP(S) and return its readable text content. HTML is stripped to plain text; JSON and plain-text responses are returned as-is. Use this to read documentation, articles, or API responses from the web.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    url: { type: 'string', description: 'The URL to fetch. If no scheme is given, https:// is assumed.' },
+                    max_chars: { type: 'number', description: 'Maximum characters to return (default 10000). The result is truncated past this.' },
+                },
+                required: ['url'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'web_search',
+            description: 'Search the web and return a list of results (title, URL, snippet). Requires a search API key configured in the environment (BRAVE_API_KEY, or GOOGLE_API_KEY + GOOGLE_CX). If no key is configured the tool reports that and returns no results — pair it with fetch_url to read a result page in full.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'The search query.' },
+                    count: { type: 'number', description: 'Number of results to return (default 5, max 10).' },
+                },
+                required: ['query'],
+            },
+        },
+    },
 ];
 // ─── Safe tools (auto-approved) ───────────────────────────────────────────────
 // spawn_agent is "safe" at the dispatch layer — the tools the sub-agent itself
 // runs go through their own approval inside the sub-agent loop.
-export const SAFE_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'memory_write', 'spawn_agent', 'ask_user']);
+export const SAFE_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'memory_write', 'spawn_agent', 'ask_user', 'fetch_url', 'web_search']);
 // Tools available in PLAN mode — read-only exploration plus delegation/questions.
 // Everything that mutates the filesystem or runs commands (write_file, edit_file,
 // bash, memory_write) is intentionally excluded so plan mode can only research.
-export const PLAN_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'spawn_agent', 'ask_user']);
+export const PLAN_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'spawn_agent', 'ask_user', 'fetch_url', 'web_search']);
 // ─── Display helpers ──────────────────────────────────────────────────────────
 export function formatToolArgs(name, input) {
     const p = (v) => v != null && v !== 'undefined' ? String(v) : '(missing)';
@@ -206,6 +236,12 @@ export function formatToolArgs(name, input) {
             const task = String(input.task ?? '');
             return `"${task.length > 56 ? task.slice(0, 56) + '…' : task}"`;
         }
+        case 'fetch_url':
+            return `"${p(input.url)}"`;
+        case 'web_search': {
+            const q = String(input.query ?? '');
+            return `"${q.length > 56 ? q.slice(0, 56) + '…' : q}"`;
+        }
         default:
             return JSON.stringify(input).slice(0, 80);
     }
@@ -470,6 +506,112 @@ async function memoryWrite(input) {
         return `Error saving to ${scope} memory: ${msg}`;
     }
 }
+// ─── Web ──────────────────────────────────────────────────────────────────────
+function htmlToText(html) {
+    return html
+        // Drop non-content blocks entirely.
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/<(script|style|noscript|head|svg)[\s\S]*?<\/\1>/gi, '')
+        // Turn block-level boundaries into newlines so text doesn't run together.
+        .replace(/<\/(p|div|section|article|header|footer|li|tr|h[1-6]|ul|ol|table|blockquote)>/gi, '\n')
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<li[^>]*>/gi, '\n• ')
+        // Strip all remaining tags.
+        .replace(/<[^>]+>/g, '')
+        // Decode the handful of entities that actually matter.
+        .replace(/&nbsp;/gi, ' ')
+        .replace(/&amp;/gi, '&')
+        .replace(/&lt;/gi, '<')
+        .replace(/&gt;/gi, '>')
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;|&apos;/gi, "'")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
+        // Collapse whitespace and excess blank lines.
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n[ \t]+/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+async function fetchUrl(input) {
+    let url = (input.url ?? '').trim();
+    if (!url || url === 'undefined')
+        return 'Error: url is required for fetch_url';
+    if (!/^[a-z]+:\/\//i.test(url))
+        url = `https://${url}`;
+    const maxChars = input.max_chars && input.max_chars > 0 ? input.max_chars : 10000;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 15000);
+    try {
+        const res = await fetch(url, {
+            redirect: 'follow',
+            signal: controller.signal,
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (compatible; IkieBot/1.0; +https://ikie.dev)',
+                Accept: 'text/html,application/xhtml+xml,application/json;q=0.9,text/plain;q=0.8,*/*;q=0.5',
+            },
+        });
+        if (!res.ok)
+            return `Error: HTTP ${res.status} ${res.statusText} for ${url}`;
+        const contentType = res.headers.get('content-type') ?? '';
+        const body = await res.text();
+        const text = /text\/html|application\/xhtml/i.test(contentType) ? htmlToText(body) : body.trim();
+        const header = `URL: ${res.url}\nContent-Type: ${contentType || 'unknown'}\n\n`;
+        if (!text)
+            return `${header}(empty response)`;
+        if (text.length > maxChars) {
+            return `${header}${text.slice(0, maxChars)}\n\n…[truncated ${text.length - maxChars} more chars]`;
+        }
+        return `${header}${text}`;
+    }
+    catch (err) {
+        const e = err;
+        if (e.name === 'AbortError')
+            return `Error: request to ${url} timed out after 15s`;
+        return `Error fetching ${url}: ${e.message ?? err}`;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function webSearch(input) {
+    const query = (input.query ?? '').trim();
+    if (!query || query === 'undefined')
+        return 'Error: query is required for web_search';
+    const count = Math.min(Math.max(input.count ?? 5, 1), 10);
+    // Load account key at call time (same pattern as memoryWrite's dynamic import).
+    const { loadConfig, getApiKey, IKIE_API_BASE } = await import('./config.js');
+    const apiKey = getApiKey(loadConfig());
+    if (!apiKey) {
+        return 'web_search requires an ikie account. Sign in with `ikie login` — search is included with your account.';
+    }
+    try {
+        const u = new URL(`${IKIE_API_BASE}/search`);
+        u.searchParams.set('q', query);
+        u.searchParams.set('count', String(count));
+        const res = await fetch(u, {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: 'application/json' },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => res.statusText);
+            return `Error: web_search HTTP ${res.status}: ${body}`;
+        }
+        const data = await res.json();
+        return formatSearchResults(query, data.results ?? []);
+    }
+    catch (err) {
+        const e = err;
+        return `Error during web_search: ${e.message ?? err}`;
+    }
+}
+function formatSearchResults(query, results) {
+    if (!results.length)
+        return `No results for "${query}".`;
+    const lines = results.map((r, i) => {
+        const snippet = (r.snippet ?? '').replace(/\s+/g, ' ').trim();
+        return `${i + 1}. ${r.title ?? '(untitled)'}\n   ${r.url ?? ''}${snippet ? `\n   ${snippet}` : ''}`;
+    });
+    return `Results for "${query}":\n\n${lines.join('\n\n')}`;
+}
 // ─── Dispatcher ───────────────────────────────────────────────────────────────
 export async function executeTool(name, input) {
     switch (name) {
@@ -481,6 +623,8 @@ export async function executeTool(name, input) {
         case 'search_files': return searchFiles(input);
         case 'grep': return grepFiles(input);
         case 'memory_write': return memoryWrite(input);
+        case 'fetch_url': return fetchUrl(input);
+        case 'web_search': return webSearch(input);
         default: return `Unknown tool: ${name}`;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ikie-cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Agentic coding CLI — your terminal AI pair programmer",
   "type": "module",
   "bin": {