@openadapter/koda 1.0.0-beta.3

package/dist/core/extensions/types.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var t=(o,e)=>r(o,"name",{value:e,configurable:!0});function l(o){return o}t(l,"defineTool");function u(o){return o.toolName==="bash"}t(u,"isBashToolResult");function i(o){return o.toolName==="read"}t(i,"isReadToolResult");function s(o){return o.toolName==="edit"}t(s,"isEditToolResult");function a(o){return o.toolName==="write"}t(a,"isWriteToolResult");function p(o){return o.toolName==="grep"}t(p,"isGrepToolResult");function f(o){return o.toolName==="find"}t(f,"isFindToolResult");function T(o){return o.toolName==="ls"}t(T,"isLsToolResult");function c(o,e){return e.toolName===o}t(c,"isToolCallEventType");export{l as defineTool,u as isBashToolResult,s as isEditToolResult,f as isFindToolResult,p as isGrepToolResult,T as isLsToolResult,i as isReadToolResult,c as isToolCallEventType,a as isWriteToolResult};

package/dist/core/extensions/wrapper.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool wrappers for extension-registered tools.
+ *
+ * These wrappers only adapt tool execution so extension tools receive the runner context.
+ * Tool call and tool result interception is handled by AgentSession via agent-core hooks.
+ */
+import type { AgentTool } from "@openadapter/koda-agent-core";
+import type { ExtensionRunner } from "./runner.ts";
+import type { RegisteredTool } from "./types.ts";
+/**
+ * Wrap a RegisteredTool into an AgentTool.
+ * Uses the runner's createContext() for consistent context across tools and event handlers.
+ */
+export declare function wrapRegisteredTool(registeredTool: RegisteredTool, runner: ExtensionRunner): AgentTool;
+/**
+ * Wrap all registered tools into AgentTools.
+ * Uses the runner's createContext() for consistent context across tools and event handlers.
+ */
+export declare function wrapRegisteredTools(registeredTools: RegisteredTool[], runner: ExtensionRunner): AgentTool[];

package/dist/core/extensions/wrapper.js

@@ -0,0 +1 @@
+var n=Object.defineProperty;var t=(e,o)=>n(e,"name",{value:o,configurable:!0});import{wrapToolDefinition as r,wrapToolDefinitions as p}from"../tools/tool-definition-wrapper.js";function c(e,o){return r(e.definition,()=>o.createContext())}t(c,"wrapRegisteredTool");function d(e,o){return p(e.map(i=>i.definition),()=>o.createContext())}t(d,"wrapRegisteredTools");export{c as wrapRegisteredTool,d as wrapRegisteredTools};

package/dist/core/footer-data-provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Provides git branch and extension statuses - data not otherwise accessible to extensions.
+ * Token stats, model info available via ctx.sessionManager and ctx.model.
+ */
+export declare class FooterDataProvider {
+    private cwd;
+    private static readonly WATCH_DEBOUNCE_MS;
+    private extensionStatuses;
+    private cachedBranch;
+    private gitPaths;
+    private headWatcher;
+    private headWatchFilePath;
+    private headWatchFileListener;
+    private reftableWatcher;
+    private reftableTablesListWatcher;
+    private reftableTablesListPath;
+    private branchChangeCallbacks;
+    private availableProviderCount;
+    private refreshTimer;
+    private gitWatcherRetryTimer;
+    private refreshInFlight;
+    private refreshPending;
+    private disposed;
+    constructor(cwd: string);
+    /** Current git branch, null if not in repo, "detached" if detached HEAD */
+    getGitBranch(): string | null;
+    /** Extension status texts set via ctx.ui.setStatus() */
+    getExtensionStatuses(): ReadonlyMap<string, string>;
+    /** Subscribe to git branch changes. Returns unsubscribe function. */
+    onBranchChange(callback: () => void): () => void;
+    /** Internal: set extension status */
+    setExtensionStatus(key: string, text: string | undefined): void;
+    /** Internal: clear extension statuses */
+    clearExtensionStatuses(): void;
+    /** Number of unique providers with available models (for footer display) */
+    getAvailableProviderCount(): number;
+    /** Internal: update available provider count */
+    setAvailableProviderCount(count: number): void;
+    setCwd(cwd: string): void;
+    /** Internal: cleanup */
+    dispose(): void;
+    private notifyBranchChange;
+    private scheduleRefresh;
+    private refreshGitBranchAsync;
+    private resolveGitBranchSync;
+    private resolveGitBranchAsync;
+    private clearGitWatchers;
+    private scheduleGitWatcherRetry;
+    private handleGitWatcherError;
+    private setupGitWatcher;
+}
+/** Read-only view for extensions - excludes setExtensionStatus, setAvailableProviderCount and dispose */
+export type ReadonlyFooterDataProvider = Pick<FooterDataProvider, "getGitBranch" | "getExtensionStatuses" | "getAvailableProviderCount" | "onBranchChange">;

package/dist/core/footer-data-provider.js

@@ -0,0 +1 @@
+var G=Object.defineProperty;var a=(r,t)=>G(r,"name",{value:t,configurable:!0});import{execFile as B,spawnSync as C}from"child_process";import{existsSync as n,readFileSync as o,statSync as F,unwatchFile as W,watchFile as g}from"fs";import{dirname as b,join as c,resolve as P}from"path";import{closeWatcher as f,FS_WATCH_RETRY_DELAY_MS as S,watchWithErrorHandler as u}from"../utils/fs-watch.js";function T(r){let t=r;for(;;){const e=c(t,".git");if(n(e))try{const i=F(e);if(i.isFile()){const h=o(e,"utf8").trim();if(h.startsWith("gitdir: ")){const l=P(t,h.slice(8).trim()),d=c(l,"HEAD");if(!n(d))return null;const m=c(l,"commondir"),p=n(m)?P(l,o(m,"utf8").trim()):l;return{repoDir:t,commonGitDir:p,headPath:d}}}else if(i.isDirectory()){const h=c(e,"HEAD");return n(h)?{repoDir:t,commonGitDir:e,headPath:h}:null}}catch{return null}const s=b(t);if(s===t)return null;t=s}}a(T,"findGitPaths");function E(r){const t=C("git",["--no-optional-locks","symbolic-ref","--quiet","--short","HEAD"],{cwd:r,encoding:"utf8",stdio:["ignore","pipe","ignore"]});return(t.status===0?t.stdout.trim():"")||null}a(E,"resolveBranchWithGitSync");function v(r){return new Promise(t=>{B("git",["--no-optional-locks","symbolic-ref","--quiet","--short","HEAD"],{cwd:r,encoding:"utf8"},(e,s)=>{if(e){t(null);return}const i=s.trim();t(i||null)})})}a(v,"resolveBranchWithGitAsync");function D(){return process.platform==="linux"&&!!(process.env.WSL_DISTRO_NAME||process.env.WSL_INTEROP)}a(D,"isWslEnvironment");function R(r){return/^\/mnt\/[a-z](?:\/|$)/i.test(r)}a(R,"isWindowsMountedRepoPath");function L(r){return D()&&R(r)}a(L,"shouldPollGitHead");class y{static{a(this,"FooterDataProvider")}cwd;static WATCH_DEBOUNCE_MS=500;extensionStatuses=new Map;cachedBranch=void 0;gitPaths=void 0;headWatcher=null;headWatchFilePath=null;headWatchFileListener=null;reftableWatcher=null;reftableTablesListWatcher=null;reftableTablesListPath=null;branchChangeCallbacks=new Set;availableProviderCount=0;refreshTimer=null;gitWatcherRetryTimer=null;refreshInFlight=!1;refreshPending=!1;disposed=!1;constructor(t){this.cwd=t,this.gitPaths=T(t),this.setupGitWatcher()}getGitBranch(){return this.cachedBranch===void 0&&(this.cachedBranch=this.resolveGitBranchSync()),this.cachedBranch}getExtensionStatuses(){return this.extensionStatuses}onBranchChange(t){return this.branchChangeCallbacks.add(t),()=>this.branchChangeCallbacks.delete(t)}setExtensionStatus(t,e){e===void 0?this.extensionStatuses.delete(t):this.extensionStatuses.set(t,e)}clearExtensionStatuses(){this.extensionStatuses.clear()}getAvailableProviderCount(){return this.availableProviderCount}setAvailableProviderCount(t){this.availableProviderCount=t}setCwd(t){this.cwd!==t&&(this.cwd=t,this.refreshTimer&&(clearTimeout(this.refreshTimer),this.refreshTimer=null),this.clearGitWatchers(),this.cachedBranch=void 0,this.gitPaths=T(t),this.setupGitWatcher(),this.notifyBranchChange())}dispose(){this.disposed=!0,this.refreshTimer&&(clearTimeout(this.refreshTimer),this.refreshTimer=null),this.clearGitWatchers(),this.branchChangeCallbacks.clear()}notifyBranchChange(){for(const t of this.branchChangeCallbacks)t()}scheduleRefresh(){if(!(this.disposed||this.refreshTimer)){if(this.refreshInFlight){this.refreshPending=!0;return}this.refreshTimer=setTimeout(()=>{this.refreshTimer=null,this.refreshGitBranchAsync()},y.WATCH_DEBOUNCE_MS)}}async refreshGitBranchAsync(){if(!this.disposed){if(this.refreshInFlight){this.refreshPending=!0;return}this.refreshInFlight=!0;try{const t=await this.resolveGitBranchAsync();if(this.disposed)return;if(this.cachedBranch!==void 0&&this.cachedBranch!==t){this.cachedBranch=t,this.notifyBranchChange();return}this.cachedBranch=t}finally{this.refreshInFlight=!1,this.refreshPending&&!this.disposed&&(this.refreshPending=!1,this.scheduleRefresh())}}}resolveGitBranchSync(){try{if(!this.gitPaths)return null;const t=o(this.gitPaths.headPath,"utf8").trim();if(t.startsWith("ref: refs/heads/")){const e=t.slice(16);return e===".invalid"?E(this.gitPaths.repoDir)??"detached":e}return"detached"}catch{return null}}async resolveGitBranchAsync(){try{if(!this.gitPaths)return null;const t=o(this.gitPaths.headPath,"utf8").trim();if(t.startsWith("ref: refs/heads/")){const e=t.slice(16);return e===".invalid"?await v(this.gitPaths.repoDir)??"detached":e}return"detached"}catch{return null}}clearGitWatchers(){f(this.headWatcher),this.headWatcher=null,this.headWatchFilePath&&this.headWatchFileListener&&(W(this.headWatchFilePath,this.headWatchFileListener),this.headWatchFilePath=null,this.headWatchFileListener=null),f(this.reftableWatcher),this.reftableWatcher=null,f(this.reftableTablesListWatcher),this.reftableTablesListWatcher=null,this.reftableTablesListPath&&(W(this.reftableTablesListPath),this.reftableTablesListPath=null),this.gitWatcherRetryTimer&&(clearTimeout(this.gitWatcherRetryTimer),this.gitWatcherRetryTimer=null)}scheduleGitWatcherRetry(){this.disposed||this.gitWatcherRetryTimer||(this.gitWatcherRetryTimer=setTimeout(()=>{this.gitWatcherRetryTimer=null,this.setupGitWatcher()},S))}handleGitWatcherError(){this.clearGitWatchers(),this.scheduleGitWatcherRetry()}setupGitWatcher(){if(this.clearGitWatchers(),!this.gitPaths)return;const t=L(this.gitPaths.repoDir);if(this.headWatcher=u(b(this.gitPaths.headPath),(s,i)=>{(!i||i==="HEAD")&&this.scheduleRefresh()},()=>this.handleGitWatcherError()),t&&(this.headWatchFilePath=this.gitPaths.headPath,this.headWatchFileListener=(s,i)=>{(s.mtimeMs!==i.mtimeMs||s.ctimeMs!==i.ctimeMs||s.size!==i.size)&&this.scheduleRefresh()},g(this.headWatchFilePath,{interval:1e3},this.headWatchFileListener)),!this.headWatcher&&!t)return;const e=c(this.gitPaths.commonGitDir,"reftable");if(n(e)){if(this.reftableWatcher=u(e,()=>{this.scheduleRefresh()},()=>this.handleGitWatcherError()),!this.reftableWatcher)return;const s=c(e,"tables.list");if(n(s)){if(this.reftableTablesListPath=s,this.reftableTablesListWatcher=u(s,()=>{this.scheduleRefresh()},()=>this.handleGitWatcherError()),!this.reftableTablesListWatcher)return;g(s,{interval:250},(i,h)=>{(i.mtimeMs!==h.mtimeMs||i.ctimeMs!==h.ctimeMs||i.size!==h.size)&&this.scheduleRefresh()})}}}}export{y as FooterDataProvider};

package/dist/core/http-dispatcher.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 120000;
+export declare const HTTP_IDLE_TIMEOUT_CHOICES: readonly [{
+    readonly label: "30 sec";
+    readonly timeoutMs: 30000;
+}, {
+    readonly label: "1 min";
+    readonly timeoutMs: 60000;
+}, {
+    readonly label: "2 min";
+    readonly timeoutMs: 120000;
+}, {
+    readonly label: "5 min";
+    readonly timeoutMs: 300000;
+}, {
+    readonly label: "disabled";
+    readonly timeoutMs: 0;
+}];
+export declare function parseHttpIdleTimeoutMs(value: unknown): number | undefined;
+export declare function formatHttpIdleTimeoutMs(timeoutMs: number): string;
+export declare function configureHttpDispatcher(timeoutMs?: number): void;

package/dist/core/http-dispatcher.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var i=(t,e)=>s(t,"name",{value:e,configurable:!0});import*as n from"undici";const l=12e4,m=[{label:"30 sec",timeoutMs:3e4},{label:"1 min",timeoutMs:6e4},{label:"2 min",timeoutMs:12e4},{label:"5 min",timeoutMs:3e5},{label:"disabled",timeoutMs:0}];function r(t){if(typeof t=="string"){const e=t.trim();return e.toLowerCase()==="disabled"?0:e.length===0?void 0:r(Number(e))}if(!(typeof t!="number"||!Number.isFinite(t)||t<0))return Math.floor(t)}i(r,"parseHttpIdleTimeoutMs");function d(t){const e=m.find(o=>o.timeoutMs===t);return e?e.label:`${t/1e3} sec`}i(d,"formatHttpIdleTimeoutMs");function f(t=l){const e=r(t);if(e===void 0)throw new Error(`Invalid HTTP idle timeout: ${String(t)}`);n.setGlobalDispatcher(new n.EnvHttpProxyAgent({allowH2:!1,bodyTimeout:e,headersTimeout:e})),n.install?.()}i(f,"configureHttpDispatcher");export{l as DEFAULT_HTTP_IDLE_TIMEOUT_MS,m as HTTP_IDLE_TIMEOUT_CHOICES,f as configureHttpDispatcher,d as formatHttpIdleTimeoutMs,r as parseHttpIdleTimeoutMs};

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core modules shared between all run modes.
+ */
+export { AgentSession, type AgentSessionConfig, type AgentSessionEvent, type AgentSessionEventListener, type ModelCycleResult, type PromptOptions, type SessionStats, } from "./agent-session.ts";
+export { AgentSessionRuntime, type CreateAgentSessionRuntimeFactory, type CreateAgentSessionRuntimeResult, createAgentSessionRuntime, } from "./agent-session-runtime.ts";
+export { type AgentSessionRuntimeDiagnostic, type AgentSessionServices, type CreateAgentSessionFromServicesOptions, type CreateAgentSessionServicesOptions, createAgentSessionFromServices, createAgentSessionServices, } from "./agent-session-services.ts";
+export { type BashExecutorOptions, type BashResult, executeBashWithOperations } from "./bash-executor.ts";
+export type { CompactionResult } from "./compaction/index.ts";
+export { createEventBus, type EventBus, type EventBusController } from "./event-bus.ts";
+export { type AgentEndEvent, type AgentStartEvent, type AgentToolResult, type AgentToolUpdateCallback, type BeforeAgentStartEvent, type BeforeAgentStartEventResult, type BuildSystemPromptOptions, type ContextEvent, defineTool, discoverAndLoadExtensions, type ExecOptions, type ExecResult, type Extension, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ExtensionError, type ExtensionEvent, type ExtensionFactory, type ExtensionFlag, type ExtensionHandler, ExtensionRunner, type ExtensionShortcut, type ExtensionUIContext, type LoadExtensionsResult, type MessageRenderer, type RegisteredCommand, type SessionBeforeCompactEvent, type SessionBeforeForkEvent, type SessionBeforeSwitchEvent, type SessionBeforeTreeEvent, type SessionCompactEvent, type SessionShutdownEvent, type SessionStartEvent, type SessionTreeEvent, type ToolCallEvent, type ToolCallEventResult, type ToolDefinition, type ToolRenderResultOptions, type ToolResultEvent, type TurnEndEvent, type TurnStartEvent, type WorkingIndicatorOptions, } from "./extensions/index.ts";
+export { createSyntheticSourceInfo } from "./source-info.ts";

package/dist/core/index.js

@@ -0,0 +1 @@
+import{AgentSession as t}from"./agent-session.js";import{AgentSessionRuntime as n,createAgentSessionRuntime as s}from"./agent-session-runtime.js";import{createAgentSessionFromServices as c,createAgentSessionServices as m}from"./agent-session-services.js";import{executeBashWithOperations as f}from"./bash-executor.js";import{createEventBus as a}from"./event-bus.js";import{defineTool as u,discoverAndLoadExtensions as A,ExtensionRunner as g}from"./extensions/index.js";import{createSyntheticSourceInfo as v}from"./source-info.js";export{t as AgentSession,n as AgentSessionRuntime,g as ExtensionRunner,c as createAgentSessionFromServices,s as createAgentSessionRuntime,m as createAgentSessionServices,a as createEventBus,v as createSyntheticSourceInfo,u as defineTool,A as discoverAndLoadExtensions,f as executeBashWithOperations};

package/dist/core/keybindings.d.ts

@@ -0,0 +1,352 @@
+import { type Keybinding, type KeybindingsConfig, type KeyId, KeybindingsManager as TuiKeybindingsManager } from "@openadapter/koda-tui";
+export interface AppKeybindings {
+    "app.interrupt": true;
+    "app.clear": true;
+    "app.exit": true;
+    "app.suspend": true;
+    "app.thinking.cycle": true;
+    "app.model.cycleForward": true;
+    "app.model.cycleBackward": true;
+    "app.model.select": true;
+    "app.tools.expand": true;
+    "app.thinking.toggle": true;
+    "app.session.toggleNamedFilter": true;
+    "app.editor.external": true;
+    "app.message.followUp": true;
+    "app.message.dequeue": true;
+    "app.clipboard.pasteImage": true;
+    "app.session.new": true;
+    "app.session.tree": true;
+    "app.session.fork": true;
+    "app.session.resume": true;
+    "app.tree.foldOrUp": true;
+    "app.tree.unfoldOrDown": true;
+    "app.tree.editLabel": true;
+    "app.tree.toggleLabelTimestamp": true;
+    "app.session.togglePath": true;
+    "app.session.toggleSort": true;
+    "app.session.rename": true;
+    "app.session.delete": true;
+    "app.session.deleteNoninvasive": true;
+    "app.models.save": true;
+    "app.models.enableAll": true;
+    "app.models.clearAll": true;
+    "app.models.toggleProvider": true;
+    "app.models.reorderUp": true;
+    "app.models.reorderDown": true;
+    "app.tree.filter.default": true;
+    "app.tree.filter.noTools": true;
+    "app.tree.filter.userOnly": true;
+    "app.tree.filter.labeledOnly": true;
+    "app.tree.filter.all": true;
+    "app.tree.filter.cycleForward": true;
+    "app.tree.filter.cycleBackward": true;
+}
+export type AppKeybinding = keyof AppKeybindings;
+declare module "@openadapter/koda-tui" {
+    interface Keybindings extends AppKeybindings {
+    }
+}
+export declare const KEYBINDINGS: {
+    readonly "tui.editor.cursorUp": {
+        readonly defaultKeys: "up";
+        readonly description: "Move cursor up";
+    };
+    readonly "tui.editor.cursorDown": {
+        readonly defaultKeys: "down";
+        readonly description: "Move cursor down";
+    };
+    readonly "tui.editor.cursorLeft": {
+        readonly defaultKeys: ["left", "ctrl+b"];
+        readonly description: "Move cursor left";
+    };
+    readonly "tui.editor.cursorRight": {
+        readonly defaultKeys: ["right", "ctrl+f"];
+        readonly description: "Move cursor right";
+    };
+    readonly "tui.editor.cursorWordLeft": {
+        readonly defaultKeys: ["alt+left", "ctrl+left", "alt+b"];
+        readonly description: "Move cursor word left";
+    };
+    readonly "tui.editor.cursorWordRight": {
+        readonly defaultKeys: ["alt+right", "ctrl+right", "alt+f"];
+        readonly description: "Move cursor word right";
+    };
+    readonly "tui.editor.cursorLineStart": {
+        readonly defaultKeys: ["home", "ctrl+a"];
+        readonly description: "Move to line start";
+    };
+    readonly "tui.editor.cursorLineEnd": {
+        readonly defaultKeys: ["end", "ctrl+e"];
+        readonly description: "Move to line end";
+    };
+    readonly "tui.editor.jumpForward": {
+        readonly defaultKeys: "ctrl+]";
+        readonly description: "Jump forward to character";
+    };
+    readonly "tui.editor.jumpBackward": {
+        readonly defaultKeys: "ctrl+alt+]";
+        readonly description: "Jump backward to character";
+    };
+    readonly "tui.editor.pageUp": {
+        readonly defaultKeys: "pageUp";
+        readonly description: "Page up";
+    };
+    readonly "tui.editor.pageDown": {
+        readonly defaultKeys: "pageDown";
+        readonly description: "Page down";
+    };
+    readonly "tui.editor.deleteCharBackward": {
+        readonly defaultKeys: "backspace";
+        readonly description: "Delete character backward";
+    };
+    readonly "tui.editor.deleteCharForward": {
+        readonly defaultKeys: ["delete", "ctrl+d"];
+        readonly description: "Delete character forward";
+    };
+    readonly "tui.editor.deleteWordBackward": {
+        readonly defaultKeys: ["ctrl+w", "alt+backspace"];
+        readonly description: "Delete word backward";
+    };
+    readonly "tui.editor.deleteWordForward": {
+        readonly defaultKeys: ["alt+d", "alt+delete"];
+        readonly description: "Delete word forward";
+    };
+    readonly "tui.editor.deleteToLineStart": {
+        readonly defaultKeys: "ctrl+u";
+        readonly description: "Delete to line start";
+    };
+    readonly "tui.editor.deleteToLineEnd": {
+        readonly defaultKeys: "ctrl+k";
+        readonly description: "Delete to line end";
+    };
+    readonly "tui.editor.yank": {
+        readonly defaultKeys: "ctrl+y";
+        readonly description: "Yank";
+    };
+    readonly "tui.editor.yankPop": {
+        readonly defaultKeys: "alt+y";
+        readonly description: "Yank pop";
+    };
+    readonly "tui.editor.undo": {
+        readonly defaultKeys: "ctrl+-";
+        readonly description: "Undo";
+    };
+    readonly "tui.input.newLine": {
+        readonly defaultKeys: "shift+enter";
+        readonly description: "Insert newline";
+    };
+    readonly "tui.input.submit": {
+        readonly defaultKeys: "enter";
+        readonly description: "Submit input";
+    };
+    readonly "tui.input.tab": {
+        readonly defaultKeys: "tab";
+        readonly description: "Tab / autocomplete";
+    };
+    readonly "tui.input.copy": {
+        readonly defaultKeys: "ctrl+c";
+        readonly description: "Copy selection";
+    };
+    readonly "tui.select.up": {
+        readonly defaultKeys: "up";
+        readonly description: "Move selection up";
+    };
+    readonly "tui.select.down": {
+        readonly defaultKeys: "down";
+        readonly description: "Move selection down";
+    };
+    readonly "tui.select.pageUp": {
+        readonly defaultKeys: "pageUp";
+        readonly description: "Selection page up";
+    };
+    readonly "tui.select.pageDown": {
+        readonly defaultKeys: "pageDown";
+        readonly description: "Selection page down";
+    };
+    readonly "tui.select.confirm": {
+        readonly defaultKeys: "enter";
+        readonly description: "Confirm selection";
+    };
+    readonly "tui.select.cancel": {
+        readonly defaultKeys: ["escape", "ctrl+c"];
+        readonly description: "Cancel selection";
+    };
+    readonly "app.interrupt": {
+        readonly defaultKeys: "escape";
+        readonly description: "Cancel or abort";
+    };
+    readonly "app.clear": {
+        readonly defaultKeys: "ctrl+c";
+        readonly description: "Clear editor";
+    };
+    readonly "app.exit": {
+        readonly defaultKeys: "ctrl+d";
+        readonly description: "Exit when editor is empty";
+    };
+    readonly "app.suspend": {
+        readonly defaultKeys: "ctrl+z" | never[];
+        readonly description: "Suspend to background";
+    };
+    readonly "app.thinking.cycle": {
+        readonly defaultKeys: "shift+tab";
+        readonly description: "Cycle thinking level";
+    };
+    readonly "app.model.cycleForward": {
+        readonly defaultKeys: "ctrl+p";
+        readonly description: "Cycle to next model";
+    };
+    readonly "app.model.cycleBackward": {
+        readonly defaultKeys: "shift+ctrl+p";
+        readonly description: "Cycle to previous model";
+    };
+    readonly "app.model.select": {
+        readonly defaultKeys: "ctrl+l";
+        readonly description: "Open model selector";
+    };
+    readonly "app.tools.expand": {
+        readonly defaultKeys: "ctrl+o";
+        readonly description: "Toggle tool output";
+    };
+    readonly "app.thinking.toggle": {
+        readonly defaultKeys: "ctrl+t";
+        readonly description: "Toggle thinking blocks";
+    };
+    readonly "app.session.toggleNamedFilter": {
+        readonly defaultKeys: "ctrl+n";
+        readonly description: "Toggle named session filter";
+    };
+    readonly "app.editor.external": {
+        readonly defaultKeys: "ctrl+g";
+        readonly description: "Open external editor";
+    };
+    readonly "app.message.followUp": {
+        readonly defaultKeys: "alt+enter";
+        readonly description: "Queue follow-up message";
+    };
+    readonly "app.message.dequeue": {
+        readonly defaultKeys: "alt+up";
+        readonly description: "Restore queued messages";
+    };
+    readonly "app.clipboard.pasteImage": {
+        readonly defaultKeys: "alt+v" | "ctrl+v";
+        readonly description: "Paste image from clipboard";
+    };
+    readonly "app.session.new": {
+        readonly defaultKeys: [];
+        readonly description: "Start a new session";
+    };
+    readonly "app.session.tree": {
+        readonly defaultKeys: [];
+        readonly description: "Open session tree";
+    };
+    readonly "app.session.fork": {
+        readonly defaultKeys: [];
+        readonly description: "Fork current session";
+    };
+    readonly "app.session.resume": {
+        readonly defaultKeys: [];
+        readonly description: "Resume a session";
+    };
+    readonly "app.tree.foldOrUp": {
+        readonly defaultKeys: ["ctrl+left", "alt+left"];
+        readonly description: "Fold tree branch or move up";
+    };
+    readonly "app.tree.unfoldOrDown": {
+        readonly defaultKeys: ["ctrl+right", "alt+right"];
+        readonly description: "Unfold tree branch or move down";
+    };
+    readonly "app.tree.editLabel": {
+        readonly defaultKeys: "shift+l";
+        readonly description: "Edit tree label";
+    };
+    readonly "app.tree.toggleLabelTimestamp": {
+        readonly defaultKeys: "shift+t";
+        readonly description: "Toggle tree label timestamps";
+    };
+    readonly "app.session.togglePath": {
+        readonly defaultKeys: "ctrl+p";
+        readonly description: "Toggle session path display";
+    };
+    readonly "app.session.toggleSort": {
+        readonly defaultKeys: "ctrl+s";
+        readonly description: "Toggle session sort mode";
+    };
+    readonly "app.session.rename": {
+        readonly defaultKeys: "ctrl+r";
+        readonly description: "Rename session";
+    };
+    readonly "app.session.delete": {
+        readonly defaultKeys: "ctrl+d";
+        readonly description: "Delete session";
+    };
+    readonly "app.session.deleteNoninvasive": {
+        readonly defaultKeys: "ctrl+backspace";
+        readonly description: "Delete session when query is empty";
+    };
+    readonly "app.models.save": {
+        readonly defaultKeys: "ctrl+s";
+        readonly description: "Save model selection";
+    };
+    readonly "app.models.enableAll": {
+        readonly defaultKeys: "ctrl+a";
+        readonly description: "Enable all models";
+    };
+    readonly "app.models.clearAll": {
+        readonly defaultKeys: "ctrl+x";
+        readonly description: "Clear all models";
+    };
+    readonly "app.models.toggleProvider": {
+        readonly defaultKeys: "ctrl+p";
+        readonly description: "Toggle all models for provider";
+    };
+    readonly "app.models.reorderUp": {
+        readonly defaultKeys: "alt+up";
+        readonly description: "Move model up in order";
+    };
+    readonly "app.models.reorderDown": {
+        readonly defaultKeys: "alt+down";
+        readonly description: "Move model down in order";
+    };
+    readonly "app.tree.filter.default": {
+        readonly defaultKeys: "ctrl+d";
+        readonly description: "Tree filter: default view";
+    };
+    readonly "app.tree.filter.noTools": {
+        readonly defaultKeys: "ctrl+t";
+        readonly description: "Tree filter: hide tool results";
+    };
+    readonly "app.tree.filter.userOnly": {
+        readonly defaultKeys: "ctrl+u";
+        readonly description: "Tree filter: user messages only";
+    };
+    readonly "app.tree.filter.labeledOnly": {
+        readonly defaultKeys: "ctrl+l";
+        readonly description: "Tree filter: labeled entries only";
+    };
+    readonly "app.tree.filter.all": {
+        readonly defaultKeys: "ctrl+a";
+        readonly description: "Tree filter: show all entries";
+    };
+    readonly "app.tree.filter.cycleForward": {
+        readonly defaultKeys: "ctrl+o";
+        readonly description: "Tree filter: cycle forward";
+    };
+    readonly "app.tree.filter.cycleBackward": {
+        readonly defaultKeys: "shift+ctrl+o";
+        readonly description: "Tree filter: cycle backward";
+    };
+};
+export declare function migrateKeybindingsConfig(rawConfig: Record<string, unknown>): {
+    config: Record<string, unknown>;
+    migrated: boolean;
+};
+export declare class KeybindingsManager extends TuiKeybindingsManager {
+    private configPath;
+    constructor(userBindings?: KeybindingsConfig, configPath?: string);
+    static create(agentDir?: string): KeybindingsManager;
+    reload(): void;
+    getEffectiveConfig(): KeybindingsConfig;
+    private static loadFromFile;
+}
+export type { Keybinding, KeyId, KeybindingsConfig };

package/dist/core/keybindings.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var i=(r,e)=>c(r,"name",{value:e,configurable:!0});import{TUI_KEYBINDINGS as u,KeybindingsManager as f}from"@openadapter/koda-tui";import{existsSync as g,readFileSync as y}from"fs";import{join as m}from"path";import{getAgentDir as w}from"../config.js";const a={...u,"app.interrupt":{defaultKeys:"escape",description:"Cancel or abort"},"app.clear":{defaultKeys:"ctrl+c",description:"Clear editor"},"app.exit":{defaultKeys:"ctrl+d",description:"Exit when editor is empty"},"app.suspend":{defaultKeys:process.platform==="win32"?[]:"ctrl+z",description:"Suspend to background"},"app.thinking.cycle":{defaultKeys:"shift+tab",description:"Cycle thinking level"},"app.model.cycleForward":{defaultKeys:"ctrl+p",description:"Cycle to next model"},"app.model.cycleBackward":{defaultKeys:"shift+ctrl+p",description:"Cycle to previous model"},"app.model.select":{defaultKeys:"ctrl+l",description:"Open model selector"},"app.tools.expand":{defaultKeys:"ctrl+o",description:"Toggle tool output"},"app.thinking.toggle":{defaultKeys:"ctrl+t",description:"Toggle thinking blocks"},"app.session.toggleNamedFilter":{defaultKeys:"ctrl+n",description:"Toggle named session filter"},"app.editor.external":{defaultKeys:"ctrl+g",description:"Open external editor"},"app.message.followUp":{defaultKeys:"alt+enter",description:"Queue follow-up message"},"app.message.dequeue":{defaultKeys:"alt+up",description:"Restore queued messages"},"app.clipboard.pasteImage":{defaultKeys:process.platform==="win32"?"alt+v":"ctrl+v",description:"Paste image from clipboard"},"app.session.new":{defaultKeys:[],description:"Start a new session"},"app.session.tree":{defaultKeys:[],description:"Open session tree"},"app.session.fork":{defaultKeys:[],description:"Fork current session"},"app.session.resume":{defaultKeys:[],description:"Resume a session"},"app.tree.foldOrUp":{defaultKeys:["ctrl+left","alt+left"],description:"Fold tree branch or move up"},"app.tree.unfoldOrDown":{defaultKeys:["ctrl+right","alt+right"],description:"Unfold tree branch or move down"},"app.tree.editLabel":{defaultKeys:"shift+l",description:"Edit tree label"},"app.tree.toggleLabelTimestamp":{defaultKeys:"shift+t",description:"Toggle tree label timestamps"},"app.session.togglePath":{defaultKeys:"ctrl+p",description:"Toggle session path display"},"app.session.toggleSort":{defaultKeys:"ctrl+s",description:"Toggle session sort mode"},"app.session.rename":{defaultKeys:"ctrl+r",description:"Rename session"},"app.session.delete":{defaultKeys:"ctrl+d",description:"Delete session"},"app.session.deleteNoninvasive":{defaultKeys:"ctrl+backspace",description:"Delete session when query is empty"},"app.models.save":{defaultKeys:"ctrl+s",description:"Save model selection"},"app.models.enableAll":{defaultKeys:"ctrl+a",description:"Enable all models"},"app.models.clearAll":{defaultKeys:"ctrl+x",description:"Clear all models"},"app.models.toggleProvider":{defaultKeys:"ctrl+p",description:"Toggle all models for provider"},"app.models.reorderUp":{defaultKeys:"alt+up",description:"Move model up in order"},"app.models.reorderDown":{defaultKeys:"alt+down",description:"Move model down in order"},"app.tree.filter.default":{defaultKeys:"ctrl+d",description:"Tree filter: default view"},"app.tree.filter.noTools":{defaultKeys:"ctrl+t",description:"Tree filter: hide tool results"},"app.tree.filter.userOnly":{defaultKeys:"ctrl+u",description:"Tree filter: user messages only"},"app.tree.filter.labeledOnly":{defaultKeys:"ctrl+l",description:"Tree filter: labeled entries only"},"app.tree.filter.all":{defaultKeys:"ctrl+a",description:"Tree filter: show all entries"},"app.tree.filter.cycleForward":{defaultKeys:"ctrl+o",description:"Tree filter: cycle forward"},"app.tree.filter.cycleBackward":{defaultKeys:"shift+ctrl+o",description:"Tree filter: cycle backward"}},p={cursorUp:"tui.editor.cursorUp",cursorDown:"tui.editor.cursorDown",cursorLeft:"tui.editor.cursorLeft",cursorRight:"tui.editor.cursorRight",cursorWordLeft:"tui.editor.cursorWordLeft",cursorWordRight:"tui.editor.cursorWordRight",cursorLineStart:"tui.editor.cursorLineStart",cursorLineEnd:"tui.editor.cursorLineEnd",jumpForward:"tui.editor.jumpForward",jumpBackward:"tui.editor.jumpBackward",pageUp:"tui.editor.pageUp",pageDown:"tui.editor.pageDown",deleteCharBackward:"tui.editor.deleteCharBackward",deleteCharForward:"tui.editor.deleteCharForward",deleteWordBackward:"tui.editor.deleteWordBackward",deleteWordForward:"tui.editor.deleteWordForward",deleteToLineStart:"tui.editor.deleteToLineStart",deleteToLineEnd:"tui.editor.deleteToLineEnd",yank:"tui.editor.yank",yankPop:"tui.editor.yankPop",undo:"tui.editor.undo",newLine:"tui.input.newLine",submit:"tui.input.submit",tab:"tui.input.tab",copy:"tui.input.copy",selectUp:"tui.select.up",selectDown:"tui.select.down",selectPageUp:"tui.select.pageUp",selectPageDown:"tui.select.pageDown",selectConfirm:"tui.select.confirm",selectCancel:"tui.select.cancel",interrupt:"app.interrupt",clear:"app.clear",exit:"app.exit",suspend:"app.suspend",cycleThinkingLevel:"app.thinking.cycle",cycleModelForward:"app.model.cycleForward",cycleModelBackward:"app.model.cycleBackward",selectModel:"app.model.select",expandTools:"app.tools.expand",toggleThinking:"app.thinking.toggle",toggleSessionNamedFilter:"app.session.toggleNamedFilter",externalEditor:"app.editor.external",followUp:"app.message.followUp",dequeue:"app.message.dequeue",pasteImage:"app.clipboard.pasteImage",newSession:"app.session.new",tree:"app.session.tree",fork:"app.session.fork",resume:"app.session.resume",treeFoldOrUp:"app.tree.foldOrUp",treeUnfoldOrDown:"app.tree.unfoldOrDown",treeEditLabel:"app.tree.editLabel",treeToggleLabelTimestamp:"app.tree.toggleLabelTimestamp",toggleSessionPath:"app.session.togglePath",toggleSessionSort:"app.session.toggleSort",renameSession:"app.session.rename",deleteSession:"app.session.delete",deleteSessionNoninvasive:"app.session.deleteNoninvasive"};function d(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}i(d,"isRecord");function K(r){return r in p}i(K,"isLegacyKeybindingName");function h(r){if(!d(r))return{};const e={};for(const[o,t]of Object.entries(r)){if(typeof t=="string"){e[o]=t;continue}Array.isArray(t)&&t.every(l=>typeof l=="string")&&(e[o]=t)}return e}i(h,"toKeybindingsConfig");function b(r){const e={};let o=!1;for(const[t,l]of Object.entries(r)){const s=K(t)?p[t]:t;if(s!==t&&(o=!0),t!==s&&Object.hasOwn(r,s)){o=!0;continue}e[s]=l}return{config:k(e),migrated:o}}i(b,"migrateKeybindingsConfig");function k(r){const e={};for(const t of Object.keys(a))Object.hasOwn(r,t)&&(e[t]=r[t]);const o=Object.keys(r).filter(t=>!Object.hasOwn(e,t)).sort();for(const t of o)e[t]=r[t];return e}i(k,"orderKeybindingsConfig");function T(r){if(g(r))try{const e=JSON.parse(y(r,"utf-8"));return d(e)?e:void 0}catch{return}}i(T,"loadRawConfig");class n extends f{static{i(this,"KeybindingsManager")}configPath;constructor(e={},o){super(a,e),this.configPath=o}static create(e=w()){const o=m(e,"keybindings.json"),t=n.loadFromFile(o);return new n(t,o)}reload(){this.configPath&&this.setUserBindings(n.loadFromFile(this.configPath))}getEffectiveConfig(){return this.getResolvedBindings()}static loadFromFile(e){const o=T(e);return o?h(b(o).config):{}}}export{a as KEYBINDINGS,n as KeybindingsManager,b as migrateKeybindingsConfig};

package/dist/core/messages.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+import type { AgentMessage } from "@openadapter/koda-agent-core";
+import type { ImageContent, Message, TextContent } from "@openadapter/koda-ai";
+export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
+export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
+export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
+/**
+ * Message type for bash executions via the ! command.
+ */
+export interface BashExecutionMessage {
+    role: "bashExecution";
+    command: string;
+    output: string;
+    exitCode: number | undefined;
+    cancelled: boolean;
+    truncated: boolean;
+    fullOutputPath?: string;
+    timestamp: number;
+    /** If true, this message is excluded from LLM context (!! prefix) */
+    excludeFromContext?: boolean;
+}
+/**
+ * Message type for extension-injected messages via sendMessage().
+ * These are custom messages that extensions can inject into the conversation.
+ */
+export interface CustomMessage<T = unknown> {
+    role: "custom";
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+export interface BranchSummaryMessage {
+    role: "branchSummary";
+    summary: string;
+    fromId: string;
+    timestamp: number;
+}
+export interface CompactionSummaryMessage {
+    role: "compactionSummary";
+    summary: string;
+    tokensBefore: number;
+    timestamp: number;
+}
+declare module "@openadapter/koda-agent-core" {
+    interface CustomAgentMessages {
+        bashExecution: BashExecutionMessage;
+        custom: CustomMessage;
+        branchSummary: BranchSummaryMessage;
+        compactionSummary: CompactionSummaryMessage;
+    }
+}
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export declare function bashExecutionToText(msg: BashExecutionMessage): string;
+export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
+/** Convert CustomMessageEntry to AgentMessage format */
+export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export declare function convertToLlm(messages: AgentMessage[]): Message[];

package/dist/core/messages.js

@@ -0,0 +1,17 @@
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});const c=`The conversation history before this point was compacted into the following summary:
+
+<summary>
+`,s=`
+</summary>`,i=`The following is a summary of a branch that this conversation came back from:
+
+<summary>
+`,m="</summary>";function p(e){let t=`Ran \`${e.command}\`
+`;return e.output?t+=`\`\`\`
+${e.output}
+\`\`\``:t+="(no output)",e.cancelled?t+=`
+
+(command cancelled)`:e.exitCode!==null&&e.exitCode!==void 0&&e.exitCode!==0&&(t+=`
+
+Command exited with code ${e.exitCode}`),e.truncated&&e.fullOutputPath&&(t+=`
+
+[Output truncated. Full output: ${e.fullOutputPath}]`),t}o(p,"bashExecutionToText");function x(e,t,n){return{role:"branchSummary",summary:e,fromId:t,timestamp:new Date(n).getTime()}}o(x,"createBranchSummaryMessage");function d(e,t,n){return{role:"compactionSummary",summary:e,tokensBefore:t,timestamp:new Date(n).getTime()}}o(d,"createCompactionSummaryMessage");function f(e,t,n,r,a){return{role:"custom",customType:e,content:t,display:n,details:r,timestamp:new Date(a).getTime()}}o(f,"createCustomMessage");function y(e){return e.map(t=>{switch(t.role){case"bashExecution":return t.excludeFromContext?void 0:{role:"user",content:[{type:"text",text:p(t)}],timestamp:t.timestamp};case"custom":return{role:"user",content:typeof t.content=="string"?[{type:"text",text:t.content}]:t.content,timestamp:t.timestamp};case"branchSummary":return{role:"user",content:[{type:"text",text:i+t.summary+m}],timestamp:t.timestamp};case"compactionSummary":return{role:"user",content:[{type:"text",text:c+t.summary+s}],timestamp:t.timestamp};case"user":case"assistant":case"toolResult":return t;default:const n=t;return}}).filter(t=>t!==void 0)}o(y,"convertToLlm");export{i as BRANCH_SUMMARY_PREFIX,m as BRANCH_SUMMARY_SUFFIX,c as COMPACTION_SUMMARY_PREFIX,s as COMPACTION_SUMMARY_SUFFIX,p as bashExecutionToText,y as convertToLlm,x as createBranchSummaryMessage,d as createCompactionSummaryMessage,f as createCustomMessage};