@openadapter/koda 1.0.0-beta.10

package/README.md

@@ -0,0 +1,97 @@
+<h1 align="center">Koda</h1>
+
+<p align="center"><strong>The coding agent that makes affordable models actually finish the job.</strong></p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@openadapter/koda"><img alt="npm" src="https://img.shields.io/npm/v/@openadapter/koda/beta?style=flat-square&label=beta" /></a>
+  <a href="https://openadapter.in"><img alt="OpenAdapter" src="https://img.shields.io/badge/built%20for-OpenAdapter-7c3aed?style=flat-square" /></a>
+  <img alt="license" src="https://img.shields.io/badge/license-MIT-green?style=flat-square" />
+</p>
+
+---
+
+**Koda** is a terminal coding agent built for [OpenAdapter](https://openadapter.in). One key gives you many models — and Koda wraps a **reliability layer** around them so cheaper, faster models still ship working code: it never idles on rate limits, fails over when a model stalls, verifies its own work, and steps up to a stronger model only when it has to.
+
+It runs in your terminal like the coding CLIs you already know — just harder to break, and tuned end-to-end for OpenAdapter.
+
+## Install
+
+```bash
+npm i -g @openadapter/koda@beta
+koda
+```
+
+First launch runs a one-time setup: paste your OpenAdapter API key (`sk-cv-…` from your [dashboard](https://openadapter.in)) and Koda wires up the models, tools, and skills. That's it.
+
+```bash
+koda                 # start (or resume) in the current folder
+koda --continue      # reopen the latest session here
+koda --resume        # pick a past session
+koda setup           # re-run setup any time
+koda import          # pull in past sessions from other CLIs (see below)
+```
+
+## What makes Koda different
+
+**One key, many models — tiered.** Point Koda at any OpenAdapter model (max / pro / lite). Koda reads live health/latency signals to route well, and you stay on *your* pick.
+
+**Reliability that keeps cheap models honest:**
+
+- **Never idle on a rate limit** — `/zenitsu` speed mode instantly reroutes a 429 to a healthy, faster model (no waiting), then snaps back to your preferred one the moment it's free.
+- **Failover, not failure** — provider/model hiccups are retried and routed around; a request rarely dies from a single flake.
+- **Run-it verification** — when code changed, Koda runs your build/tests/lint and treats the **exit code as ground truth**, not the model's opinion.
+- **Overseer + escalation** — a stronger model double-checks "done" on smaller models and, if it's stuck, Koda climbs the tier ladder — capped, then sticks.
+- **Heal, don't crash** — loop/state errors recover instead of killing your session; repetition/garbage output is detected and replaced.
+
+**Features that respect your time:**
+
+- **Ask & suggest** — on open-ended requests Koda proposes an approach and asks the decisions that matter (framework, storage…) with a clean multiple-choice card, instead of guessing wrong.
+- **Vision on any model** — paste a screenshot even on a non-vision model; Koda reads it with a vision model and passes the details along.
+- **Bring your history** — `koda import` (and a first-run prompt) imports past sessions from **Claude Code** and **OpenCode** into Koda, organized by project. Nothing left behind.
+- **Memory, web, background tasks** — remember/recall with semantic search, web search + fetch, and long-running servers via `run_background`.
+- **Skills & modes** — drop-in Agent Skills (frontend, debugging, code-review), `/plan` and `/build` modes.
+- **Stays current** — checks for updates and updates itself in the background; the model list auto-refreshes daily so you always have the newest models.
+- **Calm, useful UX** — live working indicator, an end-of-task recap, a session-resume hint when you reopen a folder, and contextual tips that surface the right feature exactly when it helps.
+
+## Common commands
+
+| Command | What it does |
+|---|---|
+| `/zenitsu` | Toggle speed mode (never wait on a rate limit) |
+| `/goal` | Set a session goal Koda tracks to completion |
+| `/plan` · `/build` | Switch between plan and build modes |
+| `/resume` · `/continue` | Open a past session |
+| `/memory` · `/todos` | Memory and task list |
+| `/use <skill>` | Keep a skill active for the session |
+| `/trace` | What the harness did (failover / verify / escalate …) |
+| `/settings` | Settings (incl. "Import past sessions") |
+| `/help` | Full help |
+
+## Configuration (env flags)
+
+| Flag | Effect |
+|---|---|
+| `KODA_ZENITSU=1` | Start in speed mode |
+| `KODA_NO_AUTO_UPDATE=1` | Notify about updates but don't auto-install |
+| `KODA_NO_MODEL_REFRESH=1` | Don't auto-refresh the model list |
+| `KODA_NO_RESUME_HINT=1` | Hide the "past sessions in this folder" hint |
+| `KODA_TIPS=0` | Disable contextual feature tips |
+| `KODA_OFFLINE=1` | No network calls (version check, model refresh, tool downloads) |
+
+## Built on Pi — credit where it's due
+
+Koda stands on **[Pi](https://github.com/earendil-works/pi)**, the excellent open-source terminal coding harness by **Mario Zechner** ([@badlogic](https://github.com/badlogic)). A huge amount of what makes Koda pleasant to use is Pi's, and we're grateful for it.
+
+**Pi provides the foundation** — the interactive TUI + editor, sessions & branching, context compaction, the extension / skill / prompt-template / theme system, prompt-template and package management, and the interactive / print / RPC / SDK run modes.
+
+**Koda adds, on top of Pi:**
+- OpenAdapter integration (one key → many tiered models) and the first-run setup.
+- The reliability layer — zenitsu never-idle rerouting, model failover, run-it verification, the overseer + escalation, heal-don't-crash, poison guard.
+- Ask & suggest, the vision bridge, session import from Claude Code & OpenCode.
+- Auto-update + daily model refresh, the resume hint, contextual tips, recap, and the live status UX.
+
+Thank you to the Pi project and its contributors.
+
+## License
+
+MIT — see [LICENSE](../../LICENSE). Copyright © Mario Zechner (original "pi" project) and OpenAdapter (the "Koda" fork).

package/dist/bun/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bun/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{APP_NAME as r}from"../config.js";process.title=r,process.emitWarning=(()=>{});import{restoreSandboxEnv as o}from"./restore-sandbox-env.js";o(),await import("./register-bedrock.js"),await import("../cli.js");

package/dist/bun/register-bedrock.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bun/register-bedrock.js

@@ -0,0 +1 @@
+import{setBedrockProviderModule as o}from"@openadapter/koda-ai";import{bedrockProviderModule as r}from"@openadapter/koda-ai/bedrock-provider";o(r);

package/dist/bun/restore-sandbox-env.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Workaround for https://github.com/oven-sh/bun/issues/27802
+ *
+ * Bun compiled binaries have an empty `process.env` when running inside
+ * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
+ * the environment from `/proc/self/environ`.
+ */
+/**
+ * Restore environment variables from `/proc/self/environ` when running
+ * inside a sandbox where Bun's `process.env` is empty.
+ */
+export declare function restoreSandboxEnv(): void;

package/dist/bun/restore-sandbox-env.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var o=(n,e)=>s(n,"name",{value:e,configurable:!0});import{readFileSync as t}from"node:fs";function f(){if(process.versions?.bun&&!(Object.keys(process.env).length>0))try{const n=t("/proc/self/environ","utf-8");for(const e of n.split("\0")){const r=e.indexOf("=");r>0&&(process.env[e.slice(0,r)]=e.slice(r+1))}}catch{}}o(f,"restoreSandboxEnv");export{f as restoreSandboxEnv};

package/dist/cli/args.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CLI argument parsing and help display
+ */
+import type { ThinkingLevel } from "@openadapter/koda-agent-core";
+import type { ExtensionFlag } from "../core/extensions/types.ts";
+export type Mode = "text" | "json" | "rpc";
+export interface Args {
+    provider?: string;
+    model?: string;
+    apiKey?: string;
+    systemPrompt?: string;
+    appendSystemPrompt?: string[];
+    thinking?: ThinkingLevel;
+    continue?: boolean;
+    resume?: boolean;
+    help?: boolean;
+    version?: boolean;
+    mode?: Mode;
+    name?: string;
+    noSession?: boolean;
+    session?: string;
+    sessionId?: string;
+    fork?: string;
+    sessionDir?: string;
+    models?: string[];
+    tools?: string[];
+    excludeTools?: string[];
+    noTools?: boolean;
+    noBuiltinTools?: boolean;
+    extensions?: string[];
+    noExtensions?: boolean;
+    print?: boolean;
+    export?: string;
+    noSkills?: boolean;
+    skills?: string[];
+    promptTemplates?: string[];
+    noPromptTemplates?: boolean;
+    themes?: string[];
+    noThemes?: boolean;
+    noContextFiles?: boolean;
+    listModels?: string | true;
+    offline?: boolean;
+    verbose?: boolean;
+    messages: string[];
+    fileArgs: string[];
+    /** Unknown flags (potentially extension flags) - map of flag name to value */
+    unknownFlags: Map<string, boolean | string>;
+    diagnostics: Array<{
+        type: "warning" | "error";
+        message: string;
+    }>;
+}
+export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
+export declare function parseArgs(args: string[]): Args;
+export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;

package/dist/cli/args.js

@@ -0,0 +1,167 @@
+var c=Object.defineProperty;var a=(o,t)=>c(o,"name",{value:t,configurable:!0});import l from"chalk";import{APP_NAME as n,CONFIG_DIR_NAME as d,ENV_AGENT_DIR as u,ENV_SESSION_DIR as A}from"../config.js";const m=["off","minimal","low","medium","high","xhigh"];function f(o){return m.includes(o)}a(f,"isValidThinkingLevel");function _(o){const t={messages:[],fileArgs:[],unknownFlags:new Map,diagnostics:[]};for(let s=0;s<o.length;s++){const e=o[s];if(e==="--help"||e==="-h")t.help=!0;else if(e==="--version"||e==="-v")t.version=!0;else if(e==="--mode"&&s+1<o.length){const i=o[++s];(i==="text"||i==="json"||i==="rpc")&&(t.mode=i)}else if(e==="--continue"||e==="-c")t.continue=!0;else if(e==="--resume"||e==="-r")t.resume=!0;else if(e==="--provider"&&s+1<o.length)t.provider=o[++s];else if(e==="--model"&&s+1<o.length)t.model=o[++s];else if(e==="--api-key"&&s+1<o.length)t.apiKey=o[++s];else if(e==="--system-prompt"&&s+1<o.length)t.systemPrompt=o[++s];else if(e==="--append-system-prompt"&&s+1<o.length)t.appendSystemPrompt=t.appendSystemPrompt??[],t.appendSystemPrompt.push(o[++s]);else if(e==="--name"||e==="-n")s+1<o.length?t.name=o[++s]:t.diagnostics.push({type:"error",message:"--name requires a value"});else if(e==="--no-session")t.noSession=!0;else if(e==="--session"&&s+1<o.length)t.session=o[++s];else if(e==="--session-id"&&s+1<o.length)t.sessionId=o[++s];else if(e==="--fork"&&s+1<o.length)t.fork=o[++s];else if(e==="--session-dir"&&s+1<o.length)t.sessionDir=o[++s];else if(e==="--models"&&s+1<o.length)t.models=o[++s].split(",").map(i=>i.trim());else if(e==="--no-tools"||e==="-nt")t.noTools=!0;else if(e==="--no-builtin-tools"||e==="-nbt")t.noBuiltinTools=!0;else if((e==="--tools"||e==="-t")&&s+1<o.length)t.tools=o[++s].split(",").map(i=>i.trim()).filter(i=>i.length>0);else if((e==="--exclude-tools"||e==="-xt")&&s+1<o.length)t.excludeTools=o[++s].split(",").map(i=>i.trim()).filter(i=>i.length>0);else if(e==="--thinking"&&s+1<o.length){const i=o[++s];f(i)?t.thinking=i:t.diagnostics.push({type:"warning",message:`Invalid thinking level "${i}". Valid values: ${m.join(", ")}`})}else if(e==="--print"||e==="-p"){t.print=!0;const i=o[s+1];i!==void 0&&!i.startsWith("@")&&(!i.startsWith("-")||i.startsWith("---"))&&(t.messages.push(i),s++)}else if(e==="--export"&&s+1<o.length)t.export=o[++s];else if((e==="--extension"||e==="-e")&&s+1<o.length)t.extensions=t.extensions??[],t.extensions.push(o[++s]);else if(e==="--no-extensions"||e==="-ne")t.noExtensions=!0;else if(e==="--skill"&&s+1<o.length)t.skills=t.skills??[],t.skills.push(o[++s]);else if(e==="--prompt-template"&&s+1<o.length)t.promptTemplates=t.promptTemplates??[],t.promptTemplates.push(o[++s]);else if(e==="--theme"&&s+1<o.length)t.themes=t.themes??[],t.themes.push(o[++s]);else if(e==="--no-skills"||e==="-ns")t.noSkills=!0;else if(e==="--no-prompt-templates"||e==="-np")t.noPromptTemplates=!0;else if(e==="--no-themes")t.noThemes=!0;else if(e==="--no-context-files"||e==="-nc")t.noContextFiles=!0;else if(e==="--list-models")s+1<o.length&&!o[s+1].startsWith("-")&&!o[s+1].startsWith("@")?t.listModels=o[++s]:t.listModels=!0;else if(e==="--verbose")t.verbose=!0;else if(e==="--offline")t.offline=!0;else if(e.startsWith("@"))t.fileArgs.push(e.slice(1));else if(e.startsWith("--")){const i=e.indexOf("=");if(i!==-1)t.unknownFlags.set(e.slice(2,i),e.slice(i+1));else{const p=e.slice(2),r=o[s+1];r!==void 0&&!r.startsWith("-")&&!r.startsWith("@")?(t.unknownFlags.set(p,r),s++):t.unknownFlags.set(p,!0)}}else e.startsWith("-")&&!e.startsWith("--")?t.diagnostics.push({type:"error",message:`Unknown option: ${e}`}):e.startsWith("-")||t.messages.push(e)}return t}a(_,"parseArgs");function k(o){const t=o&&o.length>0?`
+${l.bold("Extension CLI Flags:")}
+${o.map(s=>{const e=s.type==="string"?" <value>":"",i=s.description??`Registered by ${s.extensionPath}`;return`  --${s.name}${e}`.padEnd(30)+i}).join(`
+`)}
+`:"";console.log(`${l.bold(n)} - AI coding assistant with read, bash, edit, write tools
+
+${l.bold("Usage:")}
+  ${n} [options] [@files...] [messages...]
+
+${l.bold("Commands:")}
+  ${n} install <source> [-l]     Install extension source and add to settings
+  ${n} remove <source> [-l]      Remove extension source from settings
+  ${n} uninstall <source> [-l]   Alias for remove
+  ${n} update [source|self|koda]   Update koda and installed extensions
+  ${n} list                      List installed extensions from settings
+  ${n} config                    Open TUI to enable/disable package resources
+  ${n} <command> --help          Show help for install/remove/uninstall/update/list
+
+${l.bold("Options:")}
+  --provider <name>              Provider name (default: google)
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --api-key <key>                API key (defaults to env vars)
+  --system-prompt <text>         System prompt (default: coding assistant prompt)
+  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)
+  --mode <mode>                  Output mode: text (default), json, or rpc
+  --print, -p                    Non-interactive mode: process prompt and exit
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path|id>            Use specific session file or partial UUID
+  --session-id <id>              Use exact project session ID, creating it if missing
+  --fork <path|id>               Fork specific session file or partial UUID into a new session
+  --session-dir <dir>            Directory for session storage and lookup
+  --no-session                   Don't save session (ephemeral)
+  --name, -n <name>              Set session display name
+  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
+                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
+  --no-tools, -nt                Disable all tools by default (built-in and extension)
+  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled
+  --tools, -t <tools>            Comma-separated allowlist of tool names to enable
+                                 Applies to built-in, extension, and custom tools
+  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable
+                                 Applies to built-in, extension, and custom tools
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh
+  --extension, -e <path>         Load an extension file (can be used multiple times)
+  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)
+  --skill <path>                 Load a skill file or directory (can be used multiple times)
+  --no-skills, -ns               Disable skills discovery and loading
+  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
+  --no-prompt-templates, -np     Disable prompt template discovery and loading
+  --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --no-themes                    Disable theme discovery and loading
+  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models (with optional fuzzy search)
+  --verbose                      Force verbose startup (overrides quietStartup setting)
+  --offline                      Disable startup network operations (same as KODA_OFFLINE=1)
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Extensions can register additional flags (e.g., --plan from plan-mode extension).${t}
+
+${l.bold("Examples:")}
+  # Interactive mode
+  ${n}
+
+  # Interactive mode with initial prompt
+  ${n} "List all .ts files in src/"
+
+  # Include files in initial message
+  ${n} @prompt.md @image.png "What color is the sky?"
+
+  # Non-interactive mode (process and exit)
+  ${n} -p "List all .ts files in src/"
+
+  # Multiple messages (interactive)
+  ${n} "Read package.json" "What dependencies do we have?"
+
+  # Continue previous session
+  ${n} --continue "What did we discuss?"
+
+  # Start a named session
+  ${n} --name "Refactor auth module"
+
+  # Use different model
+  ${n} --provider openai --model gpt-4o-mini "Help me refactor this code"
+
+  # Use model with provider prefix (no --provider needed)
+  ${n} --model openai/gpt-4o "Help me refactor this code"
+
+  # Use model with thinking level shorthand
+  ${n} --model sonnet:high "Solve this complex problem"
+
+  # Limit model cycling to specific models
+  ${n} --models claude-sonnet,claude-haiku,gpt-4o
+
+  # Limit to a specific provider with glob pattern
+  ${n} --models "github-copilot/*"
+
+  # Cycle models with fixed thinking levels
+  ${n} --models sonnet:high,haiku:low
+
+  # Start with a specific thinking level
+  ${n} --thinking high "Solve this complex problem"
+
+  # Read-only mode (no file modifications possible)
+  ${n} --tools read,grep,find,ls -p "Review the code in src/"
+
+  # Disable one tool while keeping the rest available
+  ${n} --exclude-tools ask_question
+
+  # Export a session file to HTML
+  ${n} --export ~/${d}/agent/sessions/--path--/session.jsonl
+  ${n} --export session.jsonl output.html
+
+${l.bold("Environment Variables:")}
+  ANTHROPIC_API_KEY                - Anthropic Claude API key
+  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
+  OPENAI_API_KEY                   - OpenAI GPT API key
+  AZURE_OPENAI_API_KEY             - Azure OpenAI API key
+  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)
+  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
+  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)
+  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
+  DEEPSEEK_API_KEY                 - DeepSeek API key
+  NVIDIA_API_KEY                   - NVIDIA NIM API key
+  GEMINI_API_KEY                   - Google Gemini API key
+  GROQ_API_KEY                     - Groq API key
+  CEREBRAS_API_KEY                 - Cerebras API key
+  XAI_API_KEY                      - xAI Grok API key
+  FIREWORKS_API_KEY                - Fireworks API key
+  TOGETHER_API_KEY                 - Together AI API key
+  OPENROUTER_API_KEY               - OpenRouter API key
+  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key
+  ZAI_API_KEY                      - ZAI API key
+  MISTRAL_API_KEY                  - Mistral API key
+  MINIMAX_API_KEY                  - MiniMax API key
+  MOONSHOT_API_KEY                 - Moonshot AI API key
+  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key
+  KIMI_API_KEY                     - Kimi For Coding API key
+  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)
+  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)
+  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)
+  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)
+  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)
+  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)
+  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)
+  AWS_PROFILE                      - AWS profile for Amazon Bedrock
+  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
+  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
+  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
+  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
+  ${u.padEnd(32)} - Config directory (default: ~/${d}/agent)
+  ${A.padEnd(32)} - Session storage directory (overridden by --session-dir)
+  KODA_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
+  KODA_OFFLINE                       - Disable startup network operations when set to 1/true/yes
+  KODA_TELEMETRY                     - Override install telemetry when set to 1/true/yes or 0/false/no
+  KODA_SHARE_VIEWER_URL              - Base URL for /share command (default: https://openadapter.in/session/)
+
+${l.bold("Built-in Tool Names:")}
+  read   - Read file contents
+  bash   - Execute bash commands
+  edit   - Edit files with find/replace
+  write  - Write files (creates/overwrites)
+  grep   - Search file contents (read-only, off by default)
+  find   - Find files by glob pattern (read-only, off by default)
+  ls     - List directory contents (read-only, off by default)
+`)}a(k,"printHelp");export{f as isValidThinkingLevel,_ as parseArgs,k as printHelp};

package/dist/cli/config-selector.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TUI config selector for `pi config` command
+ */
+import type { ResolvedPaths } from "../core/package-manager.ts";
+import type { SettingsManager } from "../core/settings-manager.ts";
+export interface ConfigSelectorOptions {
+    resolvedPaths: ResolvedPaths;
+    settingsManager: SettingsManager;
+    cwd: string;
+    agentDir: string;
+}
+/** Show TUI config selector and return when closed */
+export declare function selectConfig(options: ConfigSelectorOptions): Promise<void>;

package/dist/cli/config-selector.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(e,r)=>a(e,"name",{value:r,configurable:!0});import{ProcessTerminal as c,TUI as m}from"@openadapter/koda-tui";import{ConfigSelectorComponent as l}from"../modes/interactive/components/config-selector.js";import{initTheme as g,stopThemeWatcher as i}from"../modes/interactive/theme/theme.js";async function w(e){return g(e.settingsManager.getTheme(),!0),new Promise(r=>{const t=new m(new c);let s=!1;const n=new l(e.resolvedPaths,e.settingsManager,e.cwd,e.agentDir,()=>{s||(s=!0,t.stop(),i(),r())},()=>{t.stop(),i(),process.exit(0)},()=>t.requestRender(),t.terminal.rows);t.addChild(n),t.setFocus(n.getResourceList()),t.start()})}o(w,"selectConfig");export{w as selectConfig};

package/dist/cli/file-processor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Process @file CLI arguments into text content and image attachments
+ */
+import type { ImageContent } from "@openadapter/koda-ai";
+export interface ProcessedFiles {
+    text: string;
+    images: ImageContent[];
+}
+export interface ProcessFileOptions {
+    /** Whether to auto-resize images to 2000x2000 max. Default: true */
+    autoResizeImages?: boolean;
+}
+/** Process @file arguments into text content and image attachments */
+export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;

package/dist/cli/file-processor.js

@@ -0,0 +1,7 @@
+var u=Object.defineProperty;var l=(a,s)=>u(a,"name",{value:s,configurable:!0});import{access as y,readFile as f,stat as $}from"node:fs/promises";import p from"chalk";import{resolve as h}from"path";import{resolveReadPath as w}from"../core/tools/path-utils.js";import{formatDimensionNote as z,resizeImage as F}from"../utils/image-resize.js";import{detectSupportedImageMimeTypeFromFile as I}from"../utils/mime.js";async function N(a,s){const d=s?.autoResizeImages??!0;let o="";const c=[];for(const g of a){const e=h(w(g,process.cwd()));try{await y(e)}catch{console.error(p.red(`Error: File not found: ${e}`)),process.exit(1)}if((await $(e)).size===0)continue;const n=await I(e);if(n){const t=await f(e);let i,m;if(d){const r=await F(t,n);if(!r){o+=`<file name="${e}">[Image omitted: could not be resized below the inline image size limit.]</file>
+`;continue}m=z(r),i={type:"image",mimeType:r.mimeType,data:r.data}}else i={type:"image",mimeType:n,data:t.toString("base64")};c.push(i),m?o+=`<file name="${e}">${m}</file>
+`:o+=`<file name="${e}"></file>
+`}else try{const t=await f(e,"utf-8");o+=`<file name="${e}">
+${t}
+</file>
+`}catch(t){const i=t instanceof Error?t.message:String(t);console.error(p.red(`Error: Could not read file ${e}: ${i}`)),process.exit(1)}}return{text:o,images:c}}l(N,"processFileArguments");export{N as processFileArguments};

package/dist/cli/import-sessions.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Import past sessions from other coding CLIs into Koda's own session store, so
+ * nothing is left behind when you switch. Currently supports:
+ *   - Claude Code  (~/.claude/projects/<cwd>/<uuid>.jsonl)
+ *   - OpenCode     (~/.local/share/opencode/opencode.db — SQLite)
+ *
+ * Each external session is converted to a Koda session (one per source session),
+ * organized under the session's own project cwd so it shows up in `koda --resume`.
+ * Conversion is "text + tool summaries": the full user/assistant conversation as
+ * text, with tool actions noted compactly (e.g. "[tool: edit src/foo.ts]"). It is
+ * idempotent — a small registry tracks imported source ids and skips them on re-run.
+ *
+ * Entry points: `koda import` (CLI) and the first-run setup prompt.
+ */
+export interface ImportCounts {
+    claude: number;
+    opencode: number;
+}
+export interface ImportResult {
+    imported: number;
+    skipped: number;
+    perSource: {
+        claude: number;
+        opencode: number;
+    };
+    errors: number;
+}
+/** Count importable (not-yet-imported) sessions per source. */
+export declare function detectImportable(currentCwdOnly?: string): Promise<ImportCounts>;
+/** Convert + write all not-yet-imported sessions. */
+export declare function importExternalSessions(opts?: {
+    currentCwdOnly?: string;
+    onProgress?: (done: number, total: number) => void;
+}): Promise<ImportResult>;

package/dist/cli/import-sessions.js

@@ -0,0 +1,6 @@
+var _=Object.defineProperty;var a=(t,e)=>_(t,"name",{value:e,configurable:!0});import{existsSync as h,readdirSync as y,readFileSync as S,writeFileSync as b}from"node:fs";import{homedir as m}from"node:os";import{join as f}from"node:path";import{getAgentDir as x}from"../config.js";import{SessionManager as A}from"../core/session-manager.js";const I={input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}};function w(t,e){return{role:"user",content:t,timestamp:e}}a(w,"userMsg");function D(t,e,r){return{role:"assistant",content:[{type:"text",text:t}],api:"openai-completions",provider:"openadapter",model:e||"imported",usage:I,stopReason:"stop",timestamp:r}}a(D,"asstMsg");function W(){return f(m(),".claude","projects")}a(W,"claudeProjectsDir");function C(){return f(m(),".local","share","opencode","opencode.db")}a(C,"openCodeDbPath");function E(t){return f(t,".koda-import.json")}a(E,"registryPath");function $(t){try{return JSON.parse(S(E(t),"utf-8"))}catch{return{}}}a($,"loadRegistry");function P(t,e){try{b(E(t),`${JSON.stringify(e,null,2)}
+`,"utf-8")}catch{}}a(P,"saveRegistry");const M=a((t,e=120)=>t.length>e?`${t.slice(0,e)}\u2026`:t,"trunc");function j(t,e){const r=e?.file_path||e?.path||e?.command||e?.pattern||e?.url||"";return`[tool: ${t}${r?` ${M(String(r),80)}`:""}]`}a(j,"summarizeTool");function R(){const t=W();if(!h(t))return[];const e=[];for(const r of y(t)){const o=f(t,r);let s;try{s=y(o).filter(n=>n.endsWith(".jsonl"))}catch{continue}for(const n of s)try{const c=F(f(o,n),n.replace(/\.jsonl$/,""),r);c?.turns.length&&e.push(c)}catch{}}return e}a(R,"readClaudeSessions");function F(t,e,r){const o=S(t,"utf-8").split(`
+`).filter(Boolean),s=[];let n="",c=e,p=0;for(const u of o){let i;try{i=JSON.parse(u)}catch{continue}if(i?.cwd&&!n&&(n=i.cwd),i?.sessionId&&(c=i.sessionId),i?.timestamp&&!p&&(p=Date.parse(i.timestamp)||0),i?.isSidechain)continue;const d=i?.timestamp&&Date.parse(i.timestamp)||Date.now();if(i?.type==="user"&&i.message){const l=N(i.message.content);l.trim()&&s.push({role:"user",text:l,ts:d})}else if(i?.type==="assistant"&&i.message){const l=T(i.message.content);l.trim()&&s.push({role:"assistant",text:l,model:i.message.model,ts:d})}}return n||(n=J(r)),{source:"claude",sourceId:c,cwd:n,createdMs:p||Date.now(),turns:s}}a(F,"readClaudeFile");function N(t){if(typeof t=="string")return t;if(!Array.isArray(t))return"";const e=[];for(const r of t)if(r?.type==="text"&&r.text)e.push(r.text);else if(r?.type==="tool_result"){const o=typeof r.content=="string"?r.content:Array.isArray(r.content)?r.content.map(s=>s?.text||"").join(" "):"";e.push(`[tool result: ${M(String(o).replace(/\s+/g," "))}]`)}return e.join(`
+`)}a(N,"extractClaudeUser");function T(t){if(typeof t=="string")return t;if(!Array.isArray(t))return"";const e=[];for(const r of t)r?.type==="text"&&r.text?e.push(r.text):r?.type==="tool_use"&&e.push(j(r.name||"call",r.input));return e.join(`
+`)}a(T,"extractClaudeAssistant");function J(t){return t.startsWith("-")?t.replace(/-/g,"/"):t}a(J,"decodeProjectDir");async function O(){const t=C();if(!h(t))return[];const e=process.emitWarning;process.emitWarning=()=>{};let r;try{({DatabaseSync:r}=await import("node:sqlite"))}catch{return[]}finally{process.emitWarning=e}const o=[];let s;try{s=new r(t,{readOnly:!0});const n=s.prepare("SELECT id, title, path, time_created, model FROM session").all(),c=s.prepare("SELECT id, data, time_created FROM message WHERE session_id = ? ORDER BY time_created, id"),p=s.prepare("SELECT data FROM part WHERE message_id = ? ORDER BY time_created, id");for(const u of n)try{const i=[];for(const d of c.all(u.id)){let l;try{l=JSON.parse(d.data)?.role}catch{continue}if(l!=="user"&&l!=="assistant")continue;const g=k(p.all(d.id));g.trim()&&i.push({role:l,text:g,model:u.model,ts:d.time_created||Date.now()})}i.length&&o.push({source:"opencode",sourceId:u.id,cwd:u.path||m(),title:u.title,createdMs:u.time_created||Date.now(),turns:i})}catch{}}catch{return o}finally{try{s?.close()}catch{}}return o}a(O,"readOpenCodeSessions");function k(t){const e=[];for(const r of t){let o;try{o=JSON.parse(r.data)}catch{continue}const s=o?.type;if(s==="text"&&o.text)e.push(o.text);else if(typeof s=="string"&&s.startsWith("tool")){const n=o.tool||o.name||o.toolName||"call";e.push(j(n,o.state?.input||o.input))}}return e.join(`
+`)}a(k,"extractOpenCodeParts");async function K(t){const e=x(),r=$(e),o=R().filter(n=>!r[`claude:${n.sourceId}`]&&(!t||n.cwd===t)).length,s=(await O()).filter(n=>!r[`opencode:${n.sourceId}`]&&(!t||n.cwd===t)).length;return{claude:o,opencode:s}}a(K,"detectImportable");async function q(t){const e=x(),r=$(e),o=[...R(),...await O()].filter(c=>!r[`${c.source}:${c.sourceId}`]&&(!t?.currentCwdOnly||c.cwd===t.currentCwdOnly)),s={imported:0,skipped:0,perSource:{claude:0,opencode:0},errors:0};let n=0;for(const c of o){try{const p=B(c);r[`${c.source}:${c.sourceId}`]=p,s.imported++,s.perSource[c.source]++}catch{s.errors++}t?.onProgress?.(++n,o.length)}return P(e,r),s}a(q,"importExternalSessions");function B(t){const e=A.create(t.cwd),r=t.title?.trim()?`${t.title.trim()} `:"";e.appendMessage(w(`${r}[imported from ${t.source}]`,t.createdMs));let o=!1;for(const s of t.turns){const n=s.role==="user"?w(s.text,s.ts):D(s.text,s.model,s.ts);s.role==="assistant"&&(o=!0),e.appendMessage(n)}return o||e.appendMessage(D("[no assistant response was recorded in the original session]",void 0,t.createdMs)),e.getSessionFile()??""}a(B,"writeKodaSession");export{K as detectImportable,q as importExternalSessions};

package/dist/cli/initial-message.d.ts

@@ -0,0 +1,17 @@
+import type { ImageContent } from "@openadapter/koda-ai";
+import type { Args } from "./args.ts";
+export interface InitialMessageInput {
+    parsed: Args;
+    fileText?: string;
+    fileImages?: ImageContent[];
+    stdinContent?: string;
+}
+export interface InitialMessageResult {
+    initialMessage?: string;
+    initialImages?: ImageContent[];
+}
+/**
+ * Combine stdin content, @file text, and the first CLI message into a single
+ * initial prompt for non-interactive mode.
+ */
+export declare function buildInitialMessage({ parsed, fileText, fileImages, stdinContent }: InitialMessageInput): InitialMessageResult;

package/dist/cli/initial-message.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var t=(s,n)=>g(s,"name",{value:n,configurable:!0});function a({parsed:s,fileText:n,fileImages:e,stdinContent:u}){const i=[];return u!==void 0&&i.push(u),n&&i.push(n),s.messages.length>0&&(i.push(s.messages[0]),s.messages.shift()),{initialMessage:i.length>0?i.join(""):void 0,initialImages:e&&e.length>0?e:void 0}}t(a,"buildInitialMessage");export{a as buildInitialMessage};

package/dist/cli/list-models.d.ts

@@ -0,0 +1,8 @@
+/**
+ * List available models with optional fuzzy search
+ */
+import type { ModelRegistry } from "../core/model-registry.ts";
+/**
+ * List available models, optionally filtered by search pattern
+ */
+export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string): Promise<void>;

package/dist/cli/list-models.js

@@ -0,0 +1,2 @@
+var x=Object.defineProperty;var m=(i,e)=>x(i,"name",{value:e,configurable:!0});import{fuzzyFilter as c}from"@openadapter/koda-tui";import u from"chalk";import{formatNoModelsAvailableMessage as f}from"../core/auth-guidance.js";function p(i){if(i>=1e6){const e=i/1e6;return e%1===0?`${e}M`:`${e.toFixed(1)}M`}if(i>=1e3){const e=i/1e3;return e%1===0?`${e}K`:`${e.toFixed(1)}K`}return i.toString()}m(p,"formatTokenCount");async function O(i,e){const s=i.getError();s&&console.error(u.yellow(`Warning: errors loading models.json:
+${s}`));const l=i.getAvailable();if(l.length===0){console.log(f());return}let a=l;if(e&&(a=c(l,e,o=>`${o.provider} ${o.id}`)),a.length===0){console.log(`No models matching "${e}"`);return}a.sort((o,d)=>{const g=o.provider.localeCompare(d.provider);return g!==0?g:o.id.localeCompare(d.id)});const r=a.map(o=>({provider:o.provider,model:o.id,context:p(o.contextWindow),maxOut:p(o.maxTokens),thinking:o.reasoning?"yes":"no",images:o.input.includes("image")?"yes":"no"})),n={provider:"provider",model:"model",context:"context",maxOut:"max-out",thinking:"thinking",images:"images"},t={provider:Math.max(n.provider.length,...r.map(o=>o.provider.length)),model:Math.max(n.model.length,...r.map(o=>o.model.length)),context:Math.max(n.context.length,...r.map(o=>o.context.length)),maxOut:Math.max(n.maxOut.length,...r.map(o=>o.maxOut.length)),thinking:Math.max(n.thinking.length,...r.map(o=>o.thinking.length)),images:Math.max(n.images.length,...r.map(o=>o.images.length))},h=[n.provider.padEnd(t.provider),n.model.padEnd(t.model),n.context.padEnd(t.context),n.maxOut.padEnd(t.maxOut),n.thinking.padEnd(t.thinking),n.images.padEnd(t.images)].join("  ");console.log(h);for(const o of r){const d=[o.provider.padEnd(t.provider),o.model.padEnd(t.model),o.context.padEnd(t.context),o.maxOut.padEnd(t.maxOut),o.thinking.padEnd(t.thinking),o.images.padEnd(t.images)].join("  ");console.log(d)}}m(O,"listModels");export{O as listModels};

package/dist/cli/openadapter-setup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OpenAdapter first-run setup for Koda.
+ *
+ * Koda ships an OpenAdapter layer (provider config + extensions + skills) that a
+ * fresh install needs wired up. This runs the bundled `setup.mjs` wizard, which
+ * prompts for the user's own sk-cv key, fetches the model list, registers the
+ * extensions, and copies the skills.
+ *
+ *   koda setup            → re-run the wizard any time
+ *   first launch with no  → auto-run once (interactive only)
+ *   OpenAdapter provider
+ */
+/**
+ * Offer to import past sessions from Claude Code + OpenCode so nothing is left
+ * behind. `auto` = called from first-run (skip silently if there's nothing).
+ */
+export declare function runInteractiveImport(opts?: {
+    auto?: boolean;
+}): Promise<void>;
+/**
+ * Once a day, refresh the OpenAdapter model list from the gateway so users
+ * automatically get newly-added models without re-running setup. Best-effort and
+ * throttled (24h); KODA_NO_MODEL_REFRESH=1 or KODA_OFFLINE disables.
+ */
+export declare function maybeRefreshOpenAdapterModels(agentDir: string): Promise<void>;
+/** `koda import` — import sessions from other CLIs any time. */
+export declare function handleImportCommand(args: string[]): Promise<boolean>;
+/** Run the bundled wizard interactively. Returns true on success. */
+export declare function runOpenAdapterSetup(extraArgs?: string[]): boolean;
+/** `koda setup [sk-cv-...]` — explicit (re)configuration. */
+export declare function handleSetupCommand(args: string[]): Promise<boolean>;
+/** True when no OpenAdapter provider is configured yet (a fresh install). */
+export declare function needsOpenAdapterSetup(agentDir: string): boolean;
+/** On the first interactive launch with no OpenAdapter config, run the wizard. */
+export declare function maybeFirstRunSetup(agentDir: string): Promise<void>;

package/dist/cli/openadapter-setup.js

@@ -0,0 +1,4 @@
+var y=Object.defineProperty;var n=(t,e)=>y(t,"name",{value:e,configurable:!0});import{spawnSync as h}from"node:child_process";import{existsSync as S,readFileSync as p,writeFileSync as g}from"node:fs";import{dirname as w,join as i}from"node:path";import{createInterface as O}from"node:readline/promises";import{fileURLToPath as $}from"node:url";import u from"chalk";import{getPackageDir as x}from"../config.js";import{detectImportable as A,importExternalSessions as C}from"./import-sessions.js";async function b(t,e=!0){const r=O({input:process.stdin,output:process.stdout});try{const o=(await r.question(`${t} ${e?"[Y/n]":"[y/N]"} `)).trim().toLowerCase();return o?o==="y"||o==="yes":e}finally{r.close()}}n(b,"askYesNo");async function f(t){let e;try{e=await A()}catch{return}if(e.claude+e.opencode===0){t?.auto||console.log("No new sessions to import from Claude Code or OpenCode.");return}const o=[e.claude?`${e.claude} from Claude Code`:"",e.opencode?`${e.opencode} from OpenCode`:""].filter(Boolean).join(" and ");if(!await b(u.bold(`Import ${o} into Koda so all your history is here?`)))return;process.stdout.write("Importing\u2026 ");const s=await C({onProgress:n((l,c)=>{process.stdout.write(`\rImporting\u2026 ${l}/${c}   `)},"onProgress")});process.stdout.write("\r"),console.log(`\u2713 Imported ${s.imported} session(s) (${s.perSource.claude} Claude Code, ${s.perSource.opencode} OpenCode)${s.errors?`, ${s.errors} skipped`:""}. Find them with \`koda --resume\`.`)}n(f,"runInteractiveImport");async function E(t){if(process.env.KODA_NO_MODEL_REFRESH==="1"||process.env.KODA_OFFLINE)return;const e=i(t,"models.json");let r;try{r=JSON.parse(p(e,"utf-8"))}catch{return}const o=r?.providers?.openadapter;if(!o?.apiKey||!o?.baseUrl)return;const d=typeof o.modelsRefreshedAt=="number"?o.modelsRefreshedAt:0;if(!(Date.now()-d<1440*60*1e3))try{const s=await fetch(`${String(o.baseUrl).replace(/\/$/,"")}/models`,{headers:{Authorization:`Bearer ${o.apiKey}`},signal:AbortSignal.timeout(5e3)});if(!s.ok)return;const c=((await s.json()).data??[]).filter(a=>(a.endpoint_format||a.model_type)==="chat");if(c.length===0)return;o.models=c.map(a=>({id:a.id,name:a.id,input:a.supports_vision?["text","image"]:["text"],maxTokens:16e3})),o.modelsRefreshedAt=Date.now(),g(e,`${JSON.stringify(r,null,2)}
+`,"utf-8")}catch{}}n(E,"maybeRefreshOpenAdapterModels");async function J(t){return t[0]!=="import"?!1:(await f(),!0)}n(J,"handleImportCommand");function I(){const t=w($(import.meta.url)),e=[i(x(),"openadapter","setup.mjs"),i(t,"..","..","openadapter","setup.mjs"),i(t,"..","..","..","..","scripts","setup-openadapter.mjs")];for(const r of e)if(S(r))return r;return null}n(I,"findSetupScript");function m(t=[]){const e=I();return e?h(process.execPath,[e,...t],{stdio:"inherit"}).status===0:(console.error(u.red("Koda setup script not found in this install.")),!1)}n(m,"runOpenAdapterSetup");async function L(t){if(t[0]!=="setup")return!1;const e=t.slice(1).find(r=>r.startsWith("sk-"));return m(e?[e]:[]),!0}n(L,"handleSetupCommand");function K(t){try{if(JSON.parse(p(i(t,"settings.json"),"utf-8"))?.defaultProvider==="openadapter")return!1}catch{}try{if(JSON.parse(p(i(t,"models.json"),"utf-8"))?.providers?.openadapter?.apiKey)return!1}catch{}return!0}n(K,"needsOpenAdapterSetup");async function U(t){if(process.env.KODA_SKIP_SETUP!=="1"&&K(t)){console.log(u.bold(`
+Welcome to Koda \u2014 let's connect it to OpenAdapter (one-time).
+`)),m([]),console.log("");try{await f({auto:!0})}catch{}}}n(U,"maybeFirstRunSetup");export{J as handleImportCommand,L as handleSetupCommand,U as maybeFirstRunSetup,E as maybeRefreshOpenAdapterModels,K as needsOpenAdapterSetup,f as runInteractiveImport,m as runOpenAdapterSetup};

package/dist/cli/session-picker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TUI session selector for --resume flag
+ */
+import type { SessionInfo, SessionListProgress } from "../core/session-manager.ts";
+type SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
+/** Show TUI session selector and return selected session path or null if cancelled */
+export declare function selectSession(currentSessionsLoader: SessionsLoader, allSessionsLoader: SessionsLoader): Promise<string | null>;
+export {};

package/dist/cli/session-picker.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var c=(t,n)=>l(t,"name",{value:n,configurable:!0});import{ProcessTerminal as m,setKeybindings as p,TUI as d}from"@openadapter/koda-tui";import{KeybindingsManager as f}from"../core/keybindings.js";import{SessionSelectorComponent as u}from"../modes/interactive/components/session-selector.js";async function b(t,n){return new Promise(o=>{const e=new d(new m),i=f.create();p(i);let s=!1;const r=new u(t,n,a=>{s||(s=!0,e.stop(),o(a))},()=>{s||(s=!0,e.stop(),o(null))},()=>{e.stop(),process.exit(0)},()=>e.requestRender(),{showRenameHint:!1,keybindings:i});e.addChild(r),e.setFocus(r.getSessionList()),e.start()})}c(b,"selectSession");export{b as selectSession};

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{APP_NAME as r}from"./config.js";import{configureHttpDispatcher as e}from"./core/http-dispatcher.js";import{main as o}from"./main.js";process.title=r,process.env.KODA_CODING_AGENT="true",process.emitWarning=(()=>{}),e(),o(process.argv.slice(2));