ikie-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ikie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# ikie
+
+**Agentic coding CLI** — your terminal AI pair programmer.
+
+```bash
+npm install -g ikie-cli
+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
+- Interactive REPL with slash commands, markdown rendering, and session management
+- One-shot mode: `ikie "your prompt"`
+- Image paste support (Ctrl+V)
+- Theming (7 color schemes)
+
+## Quick start
+
+```bash
+# Install
+npm install -g ikie
+
+# Set your API key
+export FIREWORKS_API_KEY=fw_...
+
+# Start coding
+ikie "refactor this file and add tests"
+```
+
+## Requirements
+
+- Node.js 20+
+- A Fireworks AI API key (or any OpenAI-compatible endpoint via `--base-url`)

package/dist/agent.d.ts

@@ -0,0 +1,62 @@
+import OpenAI from 'openai';
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions.js';
+import type { IkieConfig } from './config.js';
+import type { UserContentPart } from './attachments.js';
+export interface AgentOptions {
+    autoApprove?: boolean;
+    signal?: AbortSignal;
+    startedAt?: number;
+}
+export interface AgentTurnStats {
+    modelCalls: number;
+    toolCalls: number;
+    filesChanged: number;
+}
+export declare function estimateTokens(chars: number): number;
+/**
+ * Safely restore previously-saved stdin listeners after a raw-mode interaction
+ * (permission prompt, ask_user, theme picker, agent turn).
+ *
+ * Re-adding 'keypress' listeners makes Node's readline re-attach its OWN 'data'
+ * decoder via emitKeypressEvents' `newListener` hook. The REPL already forwards
+ * raw bytes to that decoder manually, so a freshly auto-attached decoder is a
+ * duplicate — and two decoders for the same bytes double-echo every keystroke.
+ * To avoid that, we add keypress listeners first, then reset the 'data' listener
+ * set to EXACTLY the saved set, dropping any stray decoder.
+ */
+export declare function restoreStdinListeners(savedDataListeners: Function[], savedKeypressListeners: Function[]): void;
+export declare class Agent {
+    private client;
+    private config;
+    private conversation;
+    private systemPrompt;
+    private sessionAllowList;
+    private sessionDenyList;
+    private depth;
+    private indent;
+    private activeTurnStats;
+    private activeChangedFiles;
+    private lastTurnStats;
+    constructor(client: OpenAI, config: IkieConfig, systemPrompt: string, depth?: number);
+    clearConversation(): void;
+    getConversation(): ChatCompletionMessageParam[];
+    setConversation(messages: ChatCompletionMessageParam[]): void;
+    getLastTurnStats(): AgentTurnStats;
+    send(userMessage: string | UserContentPart[], opts?: AgentOptions): Promise<void>;
+    private recordChangedFile;
+    private groupToolCalls;
+    private formatGroupSummary;
+    private runLoop;
+    private callModel;
+    private buildParams;
+    private throttleModelRequest;
+    private callModelStreaming;
+    private callModelNonStreaming;
+    private handleToolCall;
+    private askUser;
+    private runSubagent;
+    getLastAssistantText(): string;
+    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 function buildSystemPrompt(projectContext: string, memoryContext: string): string;