@openadapter/koda 1.0.0-beta.3

package/dist/core/compaction/compaction.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Context compaction for long sessions.
+ *
+ * Pure functions for compaction logic. The session manager handles I/O,
+ * and after compaction the session is reloaded.
+ */
+import type { AgentMessage, StreamFn, ThinkingLevel } from "@openadapter/koda-agent-core";
+import type { Model, Usage } from "@openadapter/koda-ai";
+import { type SessionEntry } from "../session-manager.ts";
+import { type FileOperations } from "./utils.ts";
+/** Details stored in CompactionEntry.details for file tracking */
+export interface CompactionDetails {
+    readFiles: string[];
+    modifiedFiles: string[];
+}
+/** Result from compact() - SessionManager adds uuid/parentUuid when saving */
+export interface CompactionResult<T = unknown> {
+    summary: string;
+    firstKeptEntryId: string;
+    tokensBefore: number;
+    /** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */
+    details?: T;
+}
+export interface CompactionSettings {
+    enabled: boolean;
+    reserveTokens: number;
+    keepRecentTokens: number;
+}
+export declare const DEFAULT_COMPACTION_SETTINGS: CompactionSettings;
+/**
+ * Calculate total context tokens from usage.
+ * Uses the native totalTokens field when available, falls back to computing from components.
+ */
+export declare function calculateContextTokens(usage: Usage): number;
+/**
+ * Find the last non-aborted assistant message usage from session entries.
+ */
+export declare function getLastAssistantUsage(entries: SessionEntry[]): Usage | undefined;
+export interface ContextUsageEstimate {
+    tokens: number;
+    usageTokens: number;
+    trailingTokens: number;
+    lastUsageIndex: number | null;
+}
+/**
+ * Estimate context tokens from messages, using the last assistant usage when available.
+ * If there are messages after the last usage, estimate their tokens with estimateTokens.
+ */
+export declare function estimateContextTokens(messages: AgentMessage[]): ContextUsageEstimate;
+/**
+ * Check if compaction should trigger based on context usage.
+ */
+export declare function shouldCompact(contextTokens: number, contextWindow: number, settings: CompactionSettings): boolean;
+/**
+ * Estimate token count for a message using chars/4 heuristic.
+ * This is conservative (overestimates tokens).
+ */
+export declare function estimateTokens(message: AgentMessage): number;
+/**
+ * Find the user message (or bashExecution) that starts the turn containing the given entry index.
+ * Returns -1 if no turn start found before the index.
+ * BashExecutionMessage is treated like a user message for turn boundaries.
+ */
+export declare function findTurnStartIndex(entries: SessionEntry[], entryIndex: number, startIndex: number): number;
+export interface CutPointResult {
+    /** Index of first entry to keep */
+    firstKeptEntryIndex: number;
+    /** Index of user message that starts the turn being split, or -1 if not splitting */
+    turnStartIndex: number;
+    /** Whether this cut splits a turn (cut point is not a user message) */
+    isSplitTurn: boolean;
+}
+/**
+ * Find the cut point in session entries that keeps approximately `keepRecentTokens`.
+ *
+ * Algorithm: Walk backwards from newest, accumulating estimated message sizes.
+ * Stop when we've accumulated >= keepRecentTokens. Cut at that point.
+ *
+ * Can cut at user OR assistant messages (never tool results). When cutting at an
+ * assistant message with tool calls, its tool results come after and will be kept.
+ *
+ * Returns CutPointResult with:
+ * - firstKeptEntryIndex: the entry index to start keeping from
+ * - turnStartIndex: if cutting mid-turn, the user message that started that turn
+ * - isSplitTurn: whether we're cutting in the middle of a turn
+ *
+ * Only considers entries between `startIndex` and `endIndex` (exclusive).
+ */
+export declare function findCutPoint(entries: SessionEntry[], startIndex: number, endIndex: number, keepRecentTokens: number): CutPointResult;
+/**
+ * Generate a summary of the conversation using the LLM.
+ * If previousSummary is provided, uses the update prompt to merge.
+ */
+export declare function generateSummary(currentMessages: AgentMessage[], model: Model<any>, reserveTokens: number, apiKey: string | undefined, headers?: Record<string, string>, signal?: AbortSignal, customInstructions?: string, previousSummary?: string, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn): Promise<string>;
+export interface CompactionPreparation {
+    /** UUID of first entry to keep */
+    firstKeptEntryId: string;
+    /** Messages that will be summarized and discarded */
+    messagesToSummarize: AgentMessage[];
+    /** Messages that will be turned into turn prefix summary (if splitting) */
+    turnPrefixMessages: AgentMessage[];
+    /** Whether this is a split turn (cut point in middle of turn) */
+    isSplitTurn: boolean;
+    tokensBefore: number;
+    /** Summary from previous compaction, for iterative update */
+    previousSummary?: string;
+    /** File operations extracted from messagesToSummarize */
+    fileOps: FileOperations;
+    /** Compaction settions from settings.jsonl	*/
+    settings: CompactionSettings;
+}
+export declare function prepareCompaction(pathEntries: SessionEntry[], settings: CompactionSettings): CompactionPreparation | undefined;
+/**
+ * Generate summaries for compaction using prepared data.
+ * Returns CompactionResult - SessionManager adds uuid/parentUuid when saving.
+ *
+ * @param preparation - Pre-calculated preparation from prepareCompaction()
+ * @param customInstructions - Optional custom focus for the summary
+ */
+export declare function compact(preparation: CompactionPreparation, model: Model<any>, apiKey: string | undefined, headers?: Record<string, string>, customInstructions?: string, signal?: AbortSignal, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn): Promise<CompactionResult>;

package/dist/core/compaction/compaction.js

@@ -0,0 +1,104 @@
+var _=Object.defineProperty;var u=(e,t)=>_(e,"name",{value:t,configurable:!0});import{completeSimple as U}from"@openadapter/koda-ai";import{convertToLlm as I,createBranchSummaryMessage as F,createCompactionSummaryMessage as N,createCustomMessage as D}from"../messages.js";import{buildSessionContext as K}from"../session-manager.js";import{computeFileLists as z,createFileOps as $,extractFileOpsFromMessage as P,formatFileOperations as B,SUMMARIZATION_SYSTEM_PROMPT as v,serializeConversation as w}from"./utils.js";function V(e,t,n){const s=$();if(n>=0){const o=t[n];if(!o.fromHook&&o.details){const r=o.details;if(Array.isArray(r.readFiles))for(const a of r.readFiles)s.read.add(a);if(Array.isArray(r.modifiedFiles))for(const a of r.modifiedFiles)s.edited.add(a)}}for(const o of e)P(o,s);return s}u(V,"extractFileOperations");function X(e){if(e.type==="message")return e.message;if(e.type==="custom_message")return D(e.customType,e.content,e.display,e.details,e.timestamp);if(e.type==="branch_summary")return F(e.summary,e.fromId,e.timestamp);if(e.type==="compaction")return N(e.summary,e.tokensBefore,e.timestamp)}u(X,"getMessageFromEntry");function M(e){if(e.type!=="compaction")return X(e)}u(M,"getMessageFromEntryForCompaction");const ie={enabled:!0,reserveTokens:16384,keepRecentTokens:2e4};function G(e){return e.totalTokens||e.input+e.output+e.cacheRead+e.cacheWrite}u(G,"calculateContextTokens");function b(e){if(e.role==="assistant"&&"usage"in e){const t=e;if(t.stopReason!=="aborted"&&t.stopReason!=="error"&&t.usage)return t.usage}}u(b,"getAssistantUsage");function ae(e){for(let t=e.length-1;t>=0;t--){const n=e[t];if(n.type==="message"){const s=b(n.message);if(s)return s}}}u(ae,"getLastAssistantUsage");function L(e){for(let t=e.length-1;t>=0;t--){const n=b(e[t]);if(n)return{usage:n,index:t}}}u(L,"getLastAssistantUsageInfo");function W(e){const t=L(e);if(!t){let o=0;for(const r of e)o+=S(r);return{tokens:o,usageTokens:0,trailingTokens:o,lastUsageIndex:null}}const n=G(t.usage);let s=0;for(let o=t.index+1;o<e.length;o++)s+=S(e[o]);return{tokens:n+s,usageTokens:n,trailingTokens:s,lastUsageIndex:t.index}}u(W,"estimateContextTokens");function ce(e,t,n){return n.enabled?e>t-n.reserveTokens:!1}u(ce,"shouldCompact");const Z=4800;function C(e){if(typeof e=="string")return e.length;let t=0;for(const n of e)n.type==="text"&&n.text?t+=n.text.length:n.type==="image"&&(t+=Z);return t}u(C,"estimateTextAndImageContentChars");function S(e){let t=0;switch(e.role){case"user":return t=C(e.content),Math.ceil(t/4);case"assistant":{const n=e;for(const s of n.content)s.type==="text"?t+=s.text.length:s.type==="thinking"?t+=s.thinking.length:s.type==="toolCall"&&(t+=s.name.length+JSON.stringify(s.arguments).length);return Math.ceil(t/4)}case"custom":case"toolResult":return t=C(e.content),Math.ceil(t/4);case"bashExecution":return t=e.command.length+e.output.length,Math.ceil(t/4);case"branchSummary":case"compactionSummary":return t=e.summary.length,Math.ceil(t/4)}return 0}u(S,"estimateTokens");function Y(e,t,n){const s=[];for(let o=t;o<n;o++){const r=e[o];switch(r.type){case"message":{switch(r.message.role){case"bashExecution":case"custom":case"branchSummary":case"compactionSummary":case"user":case"assistant":s.push(o);break;case"toolResult":break}break}case"thinking_level_change":case"model_change":case"compaction":case"branch_summary":case"custom":case"custom_message":case"label":case"session_info":break}(r.type==="branch_summary"||r.type==="custom_message")&&s.push(o)}return s}u(Y,"findValidCutPoints");function j(e,t,n){for(let s=t;s>=n;s--){const o=e[s];if(o.type==="branch_summary"||o.type==="custom_message")return s;if(o.type==="message"){const r=o.message.role;if(r==="user"||r==="bashExecution")return s}}return-1}u(j,"findTurnStartIndex");function q(e,t,n,s){const o=Y(e,t,n);if(o.length===0)return{firstKeptEntryIndex:t,turnStartIndex:-1,isSplitTurn:!1};let r=0,a=o[0];for(let m=n-1;m>=t;m--){const p=e[m];if(p.type!=="message")continue;const x=S(p.message);if(r+=x,r>=s){for(let f=0;f<o.length;f++)if(o[f]>=m){a=o[f];break}break}}for(;a>t;){const m=e[a-1];if(m.type==="compaction"||m.type==="message")break;a--}const c=e[a],d=c.type==="message"&&c.message.role==="user",g=d?-1:j(e,a,t);return{firstKeptEntryIndex:a,turnStartIndex:g,isSplitTurn:!d&&g!==-1}}u(q,"findCutPoint");const H=`The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.
+
+Use this EXACT format:
+
+## Goal
+[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]
+
+## Constraints & Preferences
+- [Any constraints, preferences, or requirements mentioned by user]
+- [Or "(none)" if none were mentioned]
+
+## Progress
+### Done
+- [x] [Completed tasks/changes]
+
+### In Progress
+- [ ] [Current work]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [Ordered list of what should happen next]
+
+## Critical Context
+- [Any data, examples, or references needed to continue]
+- [Or "(none)" if not applicable]
+
+Keep each section concise. Preserve exact file paths, function names, and error messages.`,J=`The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+Update the existing structured summary with new information. RULES:
+- PRESERVE all existing information from the previous summary
+- ADD new progress, decisions, and context from the new messages
+- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
+- UPDATE "Next Steps" based on what was accomplished
+- PRESERVE exact file paths, function names, and error messages
+- If something is no longer relevant, you may remove it
+
+Use this EXACT format:
+
+## Goal
+[Preserve existing goals, add new ones if the task expanded]
+
+## Constraints & Preferences
+- [Preserve existing, add new ones discovered]
+
+## Progress
+### Done
+- [x] [Include previously done items AND newly completed items]
+
+### In Progress
+- [ ] [Current work - update based on progress]
+
+### Blocked
+- [Current blockers - remove if resolved]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale] (preserve all previous, add new)
+
+## Next Steps
+1. [Update based on current state]
+
+## Critical Context
+- [Preserve important context, add new if needed]
+
+Keep each section concise. Preserve exact file paths, function names, and error messages.`;function E(e,t,n,s,o,r){const a={maxTokens:t,signal:o,apiKey:n,headers:s};return e.reasoning&&r&&r!=="off"&&(a.reasoning=r),a}u(E,"createSummarizationOptions");async function A(e,t,n,s){return s?(await s(e,t,n)).result():U(e,t,n)}u(A,"completeSummarization");async function R(e,t,n,s,o,r,a,c,d,g){const m=Math.min(Math.floor(.8*n),t.maxTokens>0?t.maxTokens:Number.POSITIVE_INFINITY);let p=c?J:H;a&&(p=`${p}
+
+Additional focus: ${a}`);const x=I(e);let i=`<conversation>
+${w(x)}
+</conversation>
+
+`;c&&(i+=`<previous-summary>
+${c}
+</previous-summary>
+
+`),i+=p;const l=[{role:"user",content:[{type:"text",text:i}],timestamp:Date.now()}],h=E(t,m,s,o,r,d),y=await A(t,{systemPrompt:v,messages:l},h,g);if(y.stopReason==="error")throw new Error(`Summarization failed: ${y.errorMessage||"Unknown error"}`);return y.content.filter(T=>T.type==="text").map(T=>T.text).join(`
+`)}u(R,"generateSummary");function ue(e,t){if(e.length>0&&e[e.length-1].type==="compaction")return;let n=-1;for(let i=e.length-1;i>=0;i--)if(e[i].type==="compaction"){n=i;break}let s,o=0;if(n>=0){const i=e[n];s=i.summary;const l=e.findIndex(h=>h.id===i.firstKeptEntryId);o=l>=0?l:n+1}const r=e.length,a=W(K(e).messages).tokens,c=q(e,o,r,t.keepRecentTokens),d=e[c.firstKeptEntryIndex];if(!d?.id)return;const g=d.id,m=c.isSplitTurn?c.turnStartIndex:c.firstKeptEntryIndex,p=[];for(let i=o;i<m;i++){const l=M(e[i]);l&&p.push(l)}const x=[];if(c.isSplitTurn)for(let i=c.turnStartIndex;i<c.firstKeptEntryIndex;i++){const l=M(e[i]);l&&x.push(l)}const f=V(p,e,n);if(c.isSplitTurn)for(const i of x)P(i,f);return{firstKeptEntryId:g,messagesToSummarize:p,turnPrefixMessages:x,isSplitTurn:c.isSplitTurn,tokensBefore:a,previousSummary:s,fileOps:f,settings:t}}u(ue,"prepareCompaction");const Q=`This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
+
+Summarize the prefix to provide context for the retained suffix:
+
+## Original Request
+[What did the user ask for in this turn?]
+
+## Early Progress
+- [Key decisions and work done in the prefix]
+
+## Context for Suffix
+- [Information needed to understand the retained recent work]
+
+Be concise. Focus on what's needed to understand the kept suffix.`;async function me(e,t,n,s,o,r,a,c){const{firstKeptEntryId:d,messagesToSummarize:g,turnPrefixMessages:m,isSplitTurn:p,tokensBefore:x,previousSummary:f,fileOps:i,settings:l}=e;let h;if(p&&m.length>0){const[T,O]=await Promise.all([g.length>0?R(g,t,l.reserveTokens,n,s,r,o,f,a,c):Promise.resolve("No prior history."),ee(m,t,l.reserveTokens,n,s,r,a,c)]);h=`${T}
+
+---
+
+**Turn Context (split turn):**
+
+${O}`}else h=await R(g,t,l.reserveTokens,n,s,r,o,f,a,c);const{readFiles:y,modifiedFiles:k}=z(i);if(h+=B(y,k),!d)throw new Error("First kept entry has no UUID - session may need migration");return{summary:h,firstKeptEntryId:d,tokensBefore:x,details:{readFiles:y,modifiedFiles:k}}}u(me,"compact");async function ee(e,t,n,s,o,r,a,c){const d=Math.min(Math.floor(.5*n),t.maxTokens>0?t.maxTokens:Number.POSITIVE_INFINITY),g=I(e),x=[{role:"user",content:[{type:"text",text:`<conversation>
+${w(g)}
+</conversation>
+
+${Q}`}],timestamp:Date.now()}],f=await A(t,{systemPrompt:v,messages:x},E(t,d,s,o,r,a),c);if(f.stopReason==="error")throw new Error(`Turn prefix summarization failed: ${f.errorMessage||"Unknown error"}`);return f.content.filter(i=>i.type==="text").map(i=>i.text).join(`
+`)}u(ee,"generateTurnPrefixSummary");export{ie as DEFAULT_COMPACTION_SETTINGS,G as calculateContextTokens,me as compact,W as estimateContextTokens,S as estimateTokens,q as findCutPoint,j as findTurnStartIndex,R as generateSummary,ae as getLastAssistantUsage,ue as prepareCompaction,ce as shouldCompact};

package/dist/core/compaction/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compaction and summarization utilities.
+ */
+export * from "./branch-summarization.ts";
+export * from "./compaction.ts";
+export * from "./utils.ts";

package/dist/core/compaction/index.js

@@ -0,0 +1 @@
+export*from"./branch-summarization.js";export*from"./compaction.js";export*from"./utils.js";

package/dist/core/compaction/utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared utilities for compaction and branch summarization.
+ */
+import type { AgentMessage } from "@openadapter/koda-agent-core";
+import type { Message } from "@openadapter/koda-ai";
+export interface FileOperations {
+    read: Set<string>;
+    written: Set<string>;
+    edited: Set<string>;
+}
+export declare function createFileOps(): FileOperations;
+/**
+ * Extract file operations from tool calls in an assistant message.
+ */
+export declare function extractFileOpsFromMessage(message: AgentMessage, fileOps: FileOperations): void;
+/**
+ * Compute final file lists from file operations.
+ * Returns readFiles (files only read, not modified) and modifiedFiles.
+ */
+export declare function computeFileLists(fileOps: FileOperations): {
+    readFiles: string[];
+    modifiedFiles: string[];
+};
+/**
+ * Format file operations as XML tags for summary.
+ */
+export declare function formatFileOperations(readFiles: string[], modifiedFiles: string[]): string;
+/**
+ * Serialize LLM messages to text for summarization.
+ * This prevents the model from treating it as a conversation to continue.
+ * Call convertToLlm() first to handle custom message types.
+ *
+ * Tool results are truncated to keep the summarization request within
+ * reasonable token budgets. Full content is not needed for summarization.
+ */
+export declare function serializeConversation(messages: Message[]): string;
+export declare const SUMMARIZATION_SYSTEM_PROMPT = "You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.\n\nDo NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.";

package/dist/core/compaction/utils.js

@@ -0,0 +1,19 @@
+var d=Object.defineProperty;var r=(e,n)=>d(e,"name",{value:n,configurable:!0});function m(){return{read:new Set,written:new Set,edited:new Set}}r(m,"createFileOps");function y(e,n){if(e.role==="assistant"&&!(!("content"in e)||!Array.isArray(e.content)))for(const t of e.content){if(typeof t!="object"||t===null||!("type"in t)||t.type!=="toolCall"||!("arguments"in t)||!("name"in t))continue;const i=t.arguments;if(!i)continue;const o=typeof i.path=="string"?i.path:void 0;if(o)switch(t.name){case"read":n.read.add(o);break;case"write":n.written.add(o);break;case"edit":n.edited.add(o);break}}}r(y,"extractFileOpsFromMessage");function $(e){const n=new Set([...e.edited,...e.written]),t=[...e.read].filter(o=>!n.has(o)).sort(),i=[...n].sort();return{readFiles:t,modifiedFiles:i}}r($,"computeFileLists");function j(e,n){const t=[];return e.length>0&&t.push(`<read-files>
+${e.join(`
+`)}
+</read-files>`),n.length>0&&t.push(`<modified-files>
+${n.join(`
+`)}
+</modified-files>`),t.length===0?"":`
+
+${t.join(`
+
+`)}`}r(j,"formatFileOperations");const p=2e3;function h(e,n){if(e.length<=n)return e;const t=e.length-n;return`${e.slice(0,n)}
+
+[... ${t} more characters truncated]`}r(h,"truncateForSummary");function S(e){const n=[];for(const t of e)if(t.role==="user"){const i=typeof t.content=="string"?t.content:t.content.filter(o=>o.type==="text").map(o=>o.text).join("");i&&n.push(`[User]: ${i}`)}else if(t.role==="assistant"){const i=[],o=[],a=[];for(const s of t.content)if(s.type==="text")i.push(s.text);else if(s.type==="thinking")o.push(s.thinking);else if(s.type==="toolCall"){const c=s.arguments,u=Object.entries(c).map(([f,l])=>`${f}=${JSON.stringify(l)}`).join(", ");a.push(`${s.name}(${u})`)}o.length>0&&n.push(`[Assistant thinking]: ${o.join(`
+`)}`),i.length>0&&n.push(`[Assistant]: ${i.join(`
+`)}`),a.length>0&&n.push(`[Assistant tool calls]: ${a.join("; ")}`)}else if(t.role==="toolResult"){const i=t.content.filter(o=>o.type==="text").map(o=>o.text).join("");i&&n.push(`[Tool result]: ${h(i,p)}`)}return n.join(`
+
+`)}r(S,"serializeConversation");const w=`You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.
+
+Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.`;export{w as SUMMARIZATION_SYSTEM_PROMPT,$ as computeFileLists,m as createFileOps,y as extractFileOpsFromMessage,j as formatFileOperations,S as serializeConversation};

package/dist/core/defaults.d.ts

@@ -0,0 +1,2 @@
+import type { ThinkingLevel } from "@openadapter/koda-agent-core";
+export declare const DEFAULT_THINKING_LEVEL: ThinkingLevel;

package/dist/core/defaults.js

@@ -0,0 +1 @@
+const E="medium";export{E as DEFAULT_THINKING_LEVEL};

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,14 @@
+export interface ResourceCollision {
+    resourceType: "extension" | "skill" | "prompt" | "theme";
+    name: string;
+    winnerPath: string;
+    loserPath: string;
+    winnerSource?: string;
+    loserSource?: string;
+}
+export interface ResourceDiagnostic {
+    type: "warning" | "error" | "collision";
+    message: string;
+    path?: string;
+    collision?: ResourceCollision;
+}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,8 @@
+export interface EventBus {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: (data: unknown) => void): () => void;
+}
+export interface EventBusController extends EventBus {
+    clear(): void;
+}
+export declare function createEventBus(): EventBusController;

package/dist/core/event-bus.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(r,e)=>a(r,"name",{value:e,configurable:!0});import{EventEmitter as c}from"node:events";function l(){const r=new c;return{emit:t((e,o)=>{r.emit(e,o)},"emit"),on:t((e,o)=>{const n=t(async i=>{try{await o(i)}catch(s){console.error(`Event handler error (${e}):`,s)}},"safeHandler");return r.on(e,n),()=>r.off(e,n)},"on"),clear:t(()=>{r.removeAllListeners()},"clear")}}t(l,"createEventBus");export{l as createEventBus};

package/dist/core/exec.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared command execution utilities for extensions and custom tools.
+ */
+/**
+ * Options for executing shell commands.
+ */
+export interface ExecOptions {
+    /** AbortSignal to cancel the command */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Result of executing a shell command.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+}
+/**
+ * Execute a shell command and return stdout/stderr/code.
+ * Supports timeout and abort signal.
+ */
+export declare function execCommand(command: string, args: string[], cwd: string, options?: ExecOptions): Promise<ExecResult>;

package/dist/core/exec.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var m=(n,o)=>u(n,"name",{value:o,configurable:!0});import{spawn as g}from"node:child_process";import{waitForChildProcess as k}from"../utils/child-process.js";async function h(n,o,f,e){return new Promise(c=>{const t=g(n,o,{cwd:f,shell:!1,stdio:["ignore","pipe","pipe"]});let s="",d="",a=!1,r;const l=m(()=>{a||(a=!0,t.kill("SIGTERM"),setTimeout(()=>{t.killed||t.kill("SIGKILL")},5e3))},"killProcess");e?.signal&&(e.signal.aborted?l():e.signal.addEventListener("abort",l,{once:!0})),e?.timeout&&e.timeout>0&&(r=setTimeout(()=>{l()},e.timeout)),t.stdout?.on("data",i=>{s+=i.toString()}),t.stderr?.on("data",i=>{d+=i.toString()}),k(t).then(i=>{r&&clearTimeout(r),e?.signal&&e.signal.removeEventListener("abort",l),c({stdout:s,stderr:d,code:i??0,killed:a})}).catch(i=>{r&&clearTimeout(r),e?.signal&&e.signal.removeEventListener("abort",l),c({stdout:s,stderr:d,code:1,killed:a})})})}m(h,"execCommand");export{h as execCommand};

package/dist/core/export-html/ansi-to-html.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ANSI escape code to HTML converter.
+ *
+ * Converts terminal ANSI color/style codes to HTML with inline styles.
+ * Supports:
+ * - Standard foreground colors (30-37) and bright variants (90-97)
+ * - Standard background colors (40-47) and bright variants (100-107)
+ * - 256-color palette (38;5;N and 48;5;N)
+ * - RGB true color (38;2;R;G;B and 48;2;R;G;B)
+ * - Text styles: bold (1), dim (2), italic (3), underline (4)
+ * - Reset (0)
+ */
+/**
+ * Convert ANSI-escaped text to HTML with inline styles.
+ */
+export declare function ansiToHtml(text: string): string;
+/**
+ * Convert array of ANSI-escaped lines to HTML.
+ * Each line is wrapped in a div element.
+ */
+export declare function ansiLinesToHtml(lines: string[]): string;

package/dist/core/export-html/ansi-to-html.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var o=(n,e)=>p(n,"name",{value:e,configurable:!0});const g=["#000000","#800000","#008000","#808000","#000080","#800080","#008080","#c0c0c0","#808080","#ff0000","#00ff00","#ffff00","#0000ff","#ff00ff","#00ffff","#ffffff"];function a(n){if(n<16)return g[n];if(n<232){const i=n-16,t=Math.floor(i/36),l=Math.floor(i%36/6),c=i%6,s=o(u=>u===0?0:55+u*40,"toComponent"),r=o(u=>s(u).toString(16).padStart(2,"0"),"toHex");return`#${r(t)}${r(l)}${r(c)}`}const f=(8+(n-232)*10).toString(16).padStart(2,"0");return`#${f}${f}${f}`}o(a,"color256ToHex");function b(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}o(b,"escapeHtml");function $(){return{fg:null,bg:null,bold:!1,dim:!1,italic:!1,underline:!1}}o($,"createEmptyStyle");function S(n){const e=[];return n.fg&&e.push(`color:${n.fg}`),n.bg&&e.push(`background-color:${n.bg}`),n.bold&&e.push("font-weight:bold"),n.dim&&e.push("opacity:0.6"),n.italic&&e.push("font-style:italic"),n.underline&&e.push("text-decoration:underline"),e.join(";")}o(S,"styleToInlineCSS");function x(n){return n.fg!==null||n.bg!==null||n.bold||n.dim||n.italic||n.underline}o(x,"hasStyle");function I(n,e){let f=0;for(;f<n.length;){const i=n[f];if(i===0)e.fg=null,e.bg=null,e.bold=!1,e.dim=!1,e.italic=!1,e.underline=!1;else if(i===1)e.bold=!0;else if(i===2)e.dim=!0;else if(i===3)e.italic=!0;else if(i===4)e.underline=!0;else if(i===22)e.bold=!1,e.dim=!1;else if(i===23)e.italic=!1;else if(i===24)e.underline=!1;else if(i>=30&&i<=37)e.fg=g[i-30];else if(i===38){if(n[f+1]===5&&n.length>f+2)e.fg=a(n[f+2]),f+=2;else if(n[f+1]===2&&n.length>f+4){const t=n[f+2],l=n[f+3],c=n[f+4];e.fg=`rgb(${t},${l},${c})`,f+=4}}else if(i===39)e.fg=null;else if(i>=40&&i<=47)e.bg=g[i-40];else if(i===48){if(n[f+1]===5&&n.length>f+2)e.bg=a(n[f+2]),f+=2;else if(n[f+1]===2&&n.length>f+4){const t=n[f+2],l=n[f+3],c=n[f+4];e.bg=`rgb(${t},${l},${c})`,f+=4}}else i===49?e.bg=null:i>=90&&i<=97?e.fg=g[i-90+8]:i>=100&&i<=107&&(e.bg=g[i-100+8]);f++}}o(I,"applySgrCode");const d=/\x1b\[([\d;]*)m/g;function H(n){const e=$();let f="",i=0,t=!1;d.lastIndex=0;let l=d.exec(n);for(;l!==null;){const s=n.slice(i,l.index);s&&(f+=b(s));const r=l[1],u=r?r.split(";").map(h=>parseInt(h,10)||0):[0];t&&(f+="</span>",t=!1),I(u,e),x(e)&&(f+=`<span style="${S(e)}">`,t=!0),i=l.index+l[0].length,l=d.exec(n)}const c=n.slice(i);return c&&(f+=b(c)),t&&(f+="</span>"),f}o(H,"ansiToHtml");function C(n){return n.map(e=>`<div class="ansi-line">${H(e)||"&nbsp;"}</div>`).join("")}o(C,"ansiLinesToHtml");export{C as ansiLinesToHtml,H as ansiToHtml};

package/dist/core/export-html/index.d.ts

@@ -0,0 +1,36 @@
+import type { AgentState } from "@openadapter/koda-agent-core";
+import { SessionManager } from "../session-manager.ts";
+/**
+ * Interface for rendering custom tools to HTML.
+ * Used by agent-session to pre-render extension tool output.
+ */
+export interface ToolHtmlRenderer {
+    /** Render a tool call to HTML. Returns undefined if tool has no custom renderer. */
+    renderCall(toolCallId: string, toolName: string, args: unknown): string | undefined;
+    /** Render a tool result to HTML. Returns collapsed/expanded or undefined if tool has no custom renderer. */
+    renderResult(toolCallId: string, toolName: string, result: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>, details: unknown, isError: boolean): {
+        collapsed?: string;
+        expanded?: string;
+    } | undefined;
+}
+export interface ExportOptions {
+    outputPath?: string;
+    themeName?: string;
+    /** Optional tool renderer for custom tools */
+    toolRenderer?: ToolHtmlRenderer;
+}
+/**
+ * Export session to HTML using SessionManager and AgentState.
+ * Used by TUI's /export command.
+ */
+export declare function exportSessionToHtml(sm: SessionManager, state?: AgentState, options?: ExportOptions | string): Promise<string>;
+/**
+ * Export session file to HTML (standalone, without AgentState).
+ * Used by CLI for exporting arbitrary session files.
+ */
+export declare function exportFromFile(inputPath: string, options?: ExportOptions | string): Promise<string>;

package/dist/core/export-html/index.js

@@ -0,0 +1,2 @@
+var H=Object.defineProperty;var c=(n,e)=>H(n,"name",{value:e,configurable:!0});import{existsSync as h,readFileSync as u,writeFileSync as B}from"fs";import{basename as E,join as m}from"path";import{APP_NAME as b,getExportTemplateDir as F}from"../../config.js";import{getResolvedThemeColors as x,getThemeExportColors as y}from"../../modes/interactive/theme/theme.js";import{normalizePath as I,resolvePath as v}from"../../utils/paths.js";import{SessionManager as D}from"../session-manager.js";function $(n){const e=n.match(/^#([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/);if(e)return{r:Number.parseInt(e[1],16),g:Number.parseInt(e[2],16),b:Number.parseInt(e[3],16)};const t=n.match(/^rgb\s*\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/);if(t)return{r:Number.parseInt(t[1],10),g:Number.parseInt(t[2],10),b:Number.parseInt(t[3],10)}}c($,"parseColor");function L(n,e,t){const r=c(o=>{const s=o/255;return s<=.03928?s/12.92:((s+.055)/1.055)**2.4},"toLinear");return .2126*r(n)+.7152*r(e)+.0722*r(t)}c(L,"getLuminance");function d(n,e){const t=$(n);if(!t)return n;const r=c(o=>Math.min(255,Math.max(0,Math.round(o*e))),"adjust");return`rgb(${r(t.r)}, ${r(t.g)}, ${r(t.b)})`}c(d,"adjustBrightness");function M(n){const e=$(n);return e?L(e.r,e.g,e.b)>.5?{pageBg:d(n,.96),cardBg:n,infoBg:`rgb(${Math.min(255,e.r+10)}, ${Math.min(255,e.g+5)}, ${Math.max(0,e.b-20)})`}:{pageBg:d(n,.7),cardBg:d(n,.85),infoBg:`rgb(${Math.min(255,e.r+20)}, ${Math.min(255,e.g+15)}, ${e.b})`}:{pageBg:"rgb(24, 24, 30)",cardBg:"rgb(30, 30, 36)",infoBg:"rgb(60, 55, 40)"}}c(M,"deriveExportColors");function R(n){const e=x(n),t=[];for(const[a,i]of Object.entries(e))t.push(`--${a}: ${i};`);const r=y(n),o=e.userMessageBg||"#343541",s=M(o);return t.push(`--exportPageBg: ${r.pageBg??s.pageBg};`),t.push(`--exportCardBg: ${r.cardBg??s.cardBg};`),t.push(`--exportInfoBg: ${r.infoBg??s.infoBg};`),t.join(`
+      `)}c(R,"generateThemeVars");function S(n,e){const t=F(),r=u(m(t,"template.html"),"utf-8"),o=u(m(t,"template.css"),"utf-8"),s=u(m(t,"template.js"),"utf-8"),a=u(m(t,"vendor","marked.min.js"),"utf-8"),i=u(m(t,"vendor","highlight.min.js"),"utf-8"),p=R(e),g=x(e),l=y(e),f=M(g.userMessageBg||"#343541"),T=l.pageBg??f.pageBg,C=l.cardBg??f.cardBg,N=l.infoBg??f.infoBg,A=Buffer.from(JSON.stringify(n)).toString("base64"),j=o.replace("{{THEME_VARS}}",p).replace("{{BODY_BG}}",T).replace("{{CONTAINER_BG}}",C).replace("{{INFO_BG}}",N);return r.replace("{{CSS}}",j).replace("{{JS}}",s).replace("{{SESSION_DATA}}",A).replace("{{MARKED_JS}}",a).replace("{{HIGHLIGHT_JS}}",i)}c(S,"generateHtml");const P=new Set(["bash","read","write","edit","ls"]);function _(n,e){const t={};for(const r of n){if(r.type!=="message")continue;const o=r.message;if(o.role==="assistant"&&Array.isArray(o.content)){for(const s of o.content)if(s.type==="toolCall"&&!P.has(s.name)){const a=e.renderCall(s.id,s.name,s.arguments);a&&(t[s.id]={callHtml:a})}}if(o.role==="toolResult"&&o.toolCallId){const s=o.toolName||"",a=t[o.toolCallId];if(a||!P.has(s)){const i=e.renderResult(o.toolCallId,s,o.content,o.details,o.isError||!1);i&&(t[o.toolCallId]={...a,resultHtmlCollapsed:i.collapsed,resultHtmlExpanded:i.expanded})}}}return t}c(_,"preRenderCustomTools");async function K(n,e,t){const r=typeof t=="string"?{outputPath:t}:t||{},o=n.getSessionFile();if(!o)throw new Error("Cannot export in-memory session to HTML");if(!h(o))throw new Error("Nothing to export yet - start a conversation first");const s=n.getEntries();let a;r.toolRenderer&&(a=_(s,r.toolRenderer),Object.keys(a).length===0&&(a=void 0));const i={header:n.getHeader(),entries:s,leafId:n.getLeafId(),systemPrompt:e?.systemPrompt,tools:e?.tools?.map(l=>({name:l.name,description:l.description,parameters:l.parameters})),renderedTools:a},p=S(i,r.themeName);let g=r.outputPath?I(r.outputPath):void 0;if(!g){const l=E(o,".jsonl");g=`${b}-session-${l}.html`}return B(g,p,"utf8"),g}c(K,"exportSessionToHtml");async function Y(n,e){const t=typeof e=="string"?{outputPath:e}:e||{},r=v(n);if(!h(r))throw new Error(`File not found: ${r}`);const o=D.open(r),s={header:o.getHeader(),entries:o.getEntries(),leafId:o.getLeafId(),systemPrompt:void 0,tools:void 0},a=S(s,t.themeName);let i=t.outputPath?I(t.outputPath):void 0;if(!i){const p=E(r,".jsonl");i=`${b}-session-${p}.html`}return B(i,a,"utf8"),i}c(Y,"exportFromFile");export{Y as exportFromFile,K as exportSessionToHtml};