@openadapter/koda 1.0.0-beta.3

package/dist/modes/interactive/theme/theme-schema.json

@@ -0,0 +1,335 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "Pi Coding Agent Theme",
+	"description": "Theme schema for Pi coding agent",
+	"type": "object",
+	"required": ["name", "colors"],
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "JSON schema reference"
+		},
+		"name": {
+			"type": "string",
+			"description": "Theme name"
+		},
+		"vars": {
+			"type": "object",
+			"description": "Reusable color variables",
+			"additionalProperties": {
+				"oneOf": [
+					{
+						"type": "string",
+						"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+					},
+					{
+						"type": "integer",
+						"minimum": 0,
+						"maximum": 255,
+						"description": "256-color palette index (0-255)"
+					}
+				]
+			}
+		},
+		"colors": {
+			"type": "object",
+			"description": "Theme color definitions (all required)",
+			"required": [
+				"accent",
+				"border",
+				"borderAccent",
+				"borderMuted",
+				"success",
+				"error",
+				"warning",
+				"muted",
+				"dim",
+				"text",
+				"thinkingText",
+				"selectedBg",
+				"userMessageBg",
+				"userMessageText",
+				"customMessageBg",
+				"customMessageText",
+				"customMessageLabel",
+				"toolPendingBg",
+				"toolSuccessBg",
+				"toolErrorBg",
+				"toolTitle",
+				"toolOutput",
+				"mdHeading",
+				"mdLink",
+				"mdLinkUrl",
+				"mdCode",
+				"mdCodeBlock",
+				"mdCodeBlockBorder",
+				"mdQuote",
+				"mdQuoteBorder",
+				"mdHr",
+				"mdListBullet",
+				"toolDiffAdded",
+				"toolDiffRemoved",
+				"toolDiffContext",
+				"syntaxComment",
+				"syntaxKeyword",
+				"syntaxFunction",
+				"syntaxVariable",
+				"syntaxString",
+				"syntaxNumber",
+				"syntaxType",
+				"syntaxOperator",
+				"syntaxPunctuation",
+				"thinkingOff",
+				"thinkingMinimal",
+				"thinkingLow",
+				"thinkingMedium",
+				"thinkingHigh",
+				"thinkingXhigh",
+				"bashMode"
+			],
+			"properties": {
+				"accent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Primary accent color (logo, selected items, cursor)"
+				},
+				"border": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Normal borders"
+				},
+				"borderAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Highlighted borders"
+				},
+				"borderMuted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Subtle borders"
+				},
+				"success": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Success states"
+				},
+				"error": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Error states"
+				},
+				"warning": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Warning states"
+				},
+				"muted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Secondary/dimmed text"
+				},
+				"dim": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Very dimmed text (more subtle than muted)"
+				},
+				"text": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Default text color (usually empty string)"
+				},
+				"thinkingText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking block text color"
+				},
+				"selectedBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Selected item background"
+				},
+				"userMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message background"
+				},
+				"userMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message text color"
+				},
+				"customMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message background (hook-injected messages)"
+				},
+				"customMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message text color"
+				},
+				"customMessageLabel": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message type label color"
+				},
+				"toolPendingBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (pending state)"
+				},
+				"toolSuccessBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (success state)"
+				},
+				"toolErrorBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (error state)"
+				},
+				"toolTitle": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box title color"
+				},
+				"toolOutput": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box output text color"
+				},
+				"mdHeading": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown heading text"
+				},
+				"mdLink": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link text"
+				},
+				"mdLinkUrl": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link URL"
+				},
+				"mdCode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown inline code"
+				},
+				"mdCodeBlock": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block content"
+				},
+				"mdCodeBlockBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block fences"
+				},
+				"mdQuote": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote text"
+				},
+				"mdQuoteBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote border"
+				},
+				"mdHr": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown horizontal rule"
+				},
+				"mdListBullet": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown list bullets/numbers"
+				},
+				"toolDiffAdded": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Added lines in tool diffs"
+				},
+				"toolDiffRemoved": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Removed lines in tool diffs"
+				},
+				"toolDiffContext": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Context lines in tool diffs"
+				},
+				"syntaxComment": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: comments"
+				},
+				"syntaxKeyword": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: keywords"
+				},
+				"syntaxFunction": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: function names"
+				},
+				"syntaxVariable": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: variable names"
+				},
+				"syntaxString": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: string literals"
+				},
+				"syntaxNumber": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: number literals"
+				},
+				"syntaxType": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: type names"
+				},
+				"syntaxOperator": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: operators"
+				},
+				"syntaxPunctuation": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: punctuation"
+				},
+				"thinkingOff": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: off"
+				},
+				"thinkingMinimal": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: minimal"
+				},
+				"thinkingLow": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: low"
+				},
+				"thinkingMedium": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: medium"
+				},
+				"thinkingHigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: high"
+				},
+				"thinkingXhigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: xhigh (OpenAI codex-max only)"
+				},
+				"bashMode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Editor border color in bash mode"
+				}
+			},
+			"additionalProperties": false
+		},
+		"export": {
+			"type": "object",
+			"description": "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
+			"properties": {
+				"pageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Page background color"
+				},
+				"cardBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Card/container background color"
+				},
+				"infoBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Info sections background (system prompt, notices)"
+				}
+			},
+			"additionalProperties": false
+		}
+	},
+	"additionalProperties": false,
+	"$defs": {
+		"colorValue": {
+			"oneOf": [
+				{
+					"type": "string",
+					"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+				},
+				{
+					"type": "integer",
+					"minimum": 0,
+					"maximum": 255,
+					"description": "256-color palette index (0-255)"
+				}
+			]
+		}
+	}
+}

package/dist/modes/interactive/theme/theme.d.ts

@@ -0,0 +1,101 @@
+import { type EditorTheme, type MarkdownTheme, type SelectListTheme, type SettingsListTheme } from "@openadapter/koda-tui";
+import type { SourceInfo } from "../../../core/source-info.ts";
+export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode";
+export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg";
+type ColorMode = "truecolor" | "256color";
+export declare class Theme {
+    readonly name?: string;
+    readonly sourcePath?: string;
+    sourceInfo?: SourceInfo;
+    private fgColors;
+    private bgColors;
+    private mode;
+    private zenitsuAnsi;
+    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, options?: {
+        name?: string;
+        sourcePath?: string;
+        sourceInfo?: SourceInfo;
+    });
+    private accentAnsi;
+    fg(color: ThemeColor, text: string): string;
+    bg(color: ThemeBg, text: string): string;
+    bold(text: string): string;
+    italic(text: string): string;
+    underline(text: string): string;
+    inverse(text: string): string;
+    strikethrough(text: string): string;
+    getFgAnsi(color: ThemeColor): string;
+    getBgAnsi(color: ThemeBg): string;
+    getColorMode(): ColorMode;
+    getThinkingBorderColor(level: "off" | "minimal" | "low" | "medium" | "high" | "xhigh"): (str: string) => string;
+    getBashModeBorderColor(): (str: string) => string;
+}
+export declare function getAvailableThemes(): string[];
+export interface ThemeInfo {
+    name: string;
+    path: string | undefined;
+}
+export declare function getAvailableThemesWithPaths(): ThemeInfo[];
+export declare function loadThemeFromPath(themePath: string, mode?: ColorMode): Theme;
+export declare function getThemeByName(name: string): Theme | undefined;
+export type TerminalTheme = "dark" | "light";
+export interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface TerminalThemeDetection {
+    theme: TerminalTheme;
+    source: "terminal background" | "COLORFGBG" | "fallback";
+    detail: string;
+    confidence: "high" | "low";
+}
+export interface TerminalThemeDetectionOptions {
+    env?: NodeJS.ProcessEnv;
+}
+export declare function getThemeForRgbColor(rgb: RgbColor): TerminalTheme;
+export declare function parseOsc11BackgroundColor(data: string): RgbColor | undefined;
+export declare function detectTerminalBackground(options?: TerminalThemeDetectionOptions): TerminalThemeDetection;
+export declare function getDefaultTheme(): string;
+export declare const theme: Theme;
+export declare function setRegisteredThemes(themes: Theme[]): void;
+export declare function initTheme(themeName?: string, enableWatcher?: boolean): void;
+export declare function setTheme(name: string, enableWatcher?: boolean): {
+    success: boolean;
+    error?: string;
+};
+export declare function setThemeInstance(themeInstance: Theme): void;
+export declare function onThemeChange(callback: () => void): void;
+export declare function stopThemeWatcher(): void;
+/**
+ * Get resolved theme colors as CSS-compatible hex strings.
+ * Used by HTML export to generate CSS custom properties.
+ */
+export declare function getResolvedThemeColors(themeName?: string): Record<string, string>;
+/**
+ * Check if a theme is a "light" theme (for CSS that needs light/dark variants).
+ */
+export declare function isLightTheme(themeName?: string): boolean;
+/**
+ * Get explicit export colors from theme JSON, if specified.
+ * Returns undefined for each color that isn't explicitly set.
+ */
+export declare function getThemeExportColors(themeName?: string): {
+    pageBg?: string;
+    cardBg?: string;
+    infoBg?: string;
+};
+/**
+ * Highlight code with syntax coloring based on file extension or language.
+ * Returns array of highlighted lines.
+ */
+export declare function highlightCode(code: string, lang?: string): string[];
+/**
+ * Get language identifier from file path extension.
+ */
+export declare function getLanguageFromPath(filePath: string): string | undefined;
+export declare function getMarkdownTheme(): MarkdownTheme;
+export declare function getSelectListTheme(): SelectListTheme;
+export declare function getEditorTheme(): EditorTheme;
+export declare function getSettingsListTheme(): SettingsListTheme;
+export {};

package/dist/modes/interactive/theme/theme.js

@@ -0,0 +1,18 @@
+var fe=Object.defineProperty;var r=(e,t)=>fe(e,"name",{value:t,configurable:!0});import*as m from"node:fs";import*as T from"node:path";import{getCapabilities as ue}from"@openadapter/koda-tui";import k from"chalk";import{Type as h}from"typebox";import{Compile as le}from"typebox/compile";import{getCustomThemesDir as M,getThemesDir as U}from"../../../config.js";import{closeWatcher as _,watchWithErrorHandler as he}from"../../../utils/fs-watch.js";import{highlight as q,supportsLanguage as V}from"../../../utils/syntax-highlight.js";const i=h.Union([h.String(),h.Integer({minimum:0,maximum:255})]),de=h.Object({$schema:h.Optional(h.String()),name:h.String(),vars:h.Optional(h.Record(h.String(),i)),colors:h.Object({accent:i,border:i,borderAccent:i,borderMuted:i,success:i,error:i,warning:i,muted:i,dim:i,text:i,thinkingText:i,selectedBg:i,userMessageBg:i,userMessageText:i,customMessageBg:i,customMessageText:i,customMessageLabel:i,toolPendingBg:i,toolSuccessBg:i,toolErrorBg:i,toolTitle:i,toolOutput:i,mdHeading:i,mdLink:i,mdLinkUrl:i,mdCode:i,mdCodeBlock:i,mdCodeBlockBorder:i,mdQuote:i,mdQuoteBorder:i,mdHr:i,mdListBullet:i,toolDiffAdded:i,toolDiffRemoved:i,toolDiffContext:i,syntaxComment:i,syntaxKeyword:i,syntaxFunction:i,syntaxVariable:i,syntaxString:i,syntaxNumber:i,syntaxType:i,syntaxOperator:i,syntaxPunctuation:i,thinkingOff:i,thinkingMinimal:i,thinkingLow:i,thinkingMedium:i,thinkingHigh:i,thinkingXhigh:i,bashMode:i}),export:h.Optional(h.Object({pageBg:h.Optional(i),cardBg:h.Optional(i),infoBg:h.Optional(i)}))}),W=le(de);function S(e){const t=e.replace("#","");if(t.length!==6)throw new Error(`Invalid hex color: ${e}`);const n=parseInt(t.substring(0,2),16),o=parseInt(t.substring(2,4),16),s=parseInt(t.substring(4,6),16);if(Number.isNaN(n)||Number.isNaN(o)||Number.isNaN(s))throw new Error(`Invalid hex color: ${e}`);return{r:n,g:o,b:s}}r(S,"hexToRgb");const v=[0,95,135,175,215,255],O=Array.from({length:24},(e,t)=>8+t*10);function L(e){let t=1/0,n=0;for(let o=0;o<v.length;o++){const s=Math.abs(e-v[o]);s<t&&(t=s,n=o)}return n}r(L,"findClosestCubeIndex");function ge(e){let t=1/0,n=0;for(let o=0;o<O.length;o++){const s=Math.abs(e-O[o]);s<t&&(t=s,n=o)}return n}r(ge,"findClosestGrayIndex");function J(e,t,n,o,s,c){const a=e-o,u=t-s,l=n-c;return a*a*.299+u*u*.587+l*l*.114}r(J,"colorDistance");function me(e,t,n){const o=L(e),s=L(t),c=L(n),a=v[o],u=v[s],l=v[c],g=16+36*o+6*s+c,p=J(e,t,n,a,u,l),E=Math.round(.299*e+.587*t+.114*n),$=ge(E),y=O[$],se=232+$,ie=J(e,t,n,y,y,y),ce=Math.max(e,t,n),ae=Math.min(e,t,n);return ce-ae<10&&ie<p?se:g}r(me,"rgbTo256");function G(e){const{r:t,g:n,b:o}=S(e);return me(t,n,o)}r(G,"hexTo256");function z(e,t){if(e==="")return"\x1B[39m";if(typeof e=="number")return`\x1B[38;5;${e}m`;if(e.startsWith("#"))if(t==="truecolor"){const{r:n,g:o,b:s}=S(e);return`\x1B[38;2;${n};${o};${s}m`}else return`\x1B[38;5;${G(e)}m`;throw new Error(`Invalid color value: ${e}`)}r(z,"fgAnsi");function pe(e,t){if(e==="")return"\x1B[49m";if(typeof e=="number")return`\x1B[48;5;${e}m`;if(e.startsWith("#"))if(t==="truecolor"){const{r:n,g:o,b:s}=S(e);return`\x1B[48;2;${n};${o};${s}m`}else return`\x1B[48;5;${G(e)}m`;throw new Error(`Invalid color value: ${e}`)}r(pe,"bgAnsi");function P(e,t,n=new Set){if(typeof e=="number"||e===""||e.startsWith("#"))return e;if(n.has(e))throw new Error(`Circular variable reference detected: ${e}`);if(!(e in t))throw new Error(`Variable reference not found: ${e}`);return n.add(e),P(t[e],t,n)}r(P,"resolveVarRefs");function K(e,t={}){const n={};for(const[o,s]of Object.entries(e))n[o]=P(s,t);return n}r(K,"resolveThemeColors");class xe{static{r(this,"Theme")}name;sourcePath;sourceInfo;fgColors;bgColors;mode;zenitsuAnsi;constructor(t,n,o,s={}){this.name=s.name,this.sourcePath=s.sourcePath,this.sourceInfo=s.sourceInfo,this.mode=o,this.fgColors=new Map;for(const[c,a]of Object.entries(t))this.fgColors.set(c,z(a,o));this.bgColors=new Map;for(const[c,a]of Object.entries(n))this.bgColors.set(c,pe(a,o));this.zenitsuAnsi=z("#fbbf24",o)}accentAnsi(t,n){return(t==="accent"||t==="borderAccent")&&process.env.KODA_ZENITSU==="1"?this.zenitsuAnsi:n}fg(t,n){const o=this.fgColors.get(t);if(!o)throw new Error(`Unknown theme color: ${t}`);return`${this.accentAnsi(t,o)}${n}\x1B[39m`}bg(t,n){const o=this.bgColors.get(t);if(!o)throw new Error(`Unknown theme background color: ${t}`);return`${o}${n}\x1B[49m`}bold(t){return k.bold(t)}italic(t){return k.italic(t)}underline(t){return k.underline(t)}inverse(t){return k.inverse(t)}strikethrough(t){return k.strikethrough(t)}getFgAnsi(t){const n=this.fgColors.get(t);if(!n)throw new Error(`Unknown theme color: ${t}`);return this.accentAnsi(t,n)}getBgAnsi(t){const n=this.bgColors.get(t);if(!n)throw new Error(`Unknown theme background color: ${t}`);return n}getColorMode(){return this.mode}getThinkingBorderColor(t){switch(t){case"off":return n=>this.fg("thinkingOff",n);case"minimal":return n=>this.fg("thinkingMinimal",n);case"low":return n=>this.fg("thinkingLow",n);case"medium":return n=>this.fg("thinkingMedium",n);case"high":return n=>this.fg("thinkingHigh",n);case"xhigh":return n=>this.fg("thinkingXhigh",n);default:return n=>this.fg("thinkingOff",n)}}getBashModeBorderColor(){return t=>this.fg("bashMode",t)}}let A;function Q(){if(!A){const e=U(),t=T.join(e,"dark.json"),n=T.join(e,"light.json");A={dark:JSON.parse(m.readFileSync(t,"utf-8")),light:JSON.parse(m.readFileSync(n,"utf-8"))}}return A}r(Q,"getBuiltinThemes");function Ne(){return be().map(({name:e})=>e)}r(Ne,"getAvailableThemes");function be(){const e=U(),t=[],n=new Set,o=r(s=>{n.has(s.name)||(n.add(s.name),t.push(s))},"addTheme");for(const s of Object.keys(Q()))o({name:s,path:T.join(e,`${s}.json`)});for(const s of ye())o(s);for(const[s,c]of B.entries())o({name:s,path:c.sourcePath});return t.sort((s,c)=>s.name.localeCompare(c.name))}r(be,"getAvailableThemesWithPaths");function ye(){const e=M(),t=[];if(!m.existsSync(e))return t;for(const n of m.readdirSync(e)){if(!n.endsWith(".json"))continue;const o=T.join(e,n);try{const s=X(o);s.name&&t.push({name:s.name,path:o})}catch{}}return t}r(ye,"getCustomThemeInfos");function Te(e,t){if(!W.Check(t)){const n=Array.from(W.Errors(t)),o=new Set,s=[];for(const a of n){if(a.keyword==="required"&&a.instancePath==="/colors"){const l=a.params.requiredProperties;for(const g of l??[])o.add(g);continue}const u=a.instancePath||"/";s.push(`  - ${u}: ${a.message}`)}let c=`Invalid theme "${e}":
+`;throw o.size>0&&(c+=`
+Missing required color tokens:
+`,c+=Array.from(o).sort().map(a=>`  - ${a}`).join(`
+`),c+=`
+
+Please add these colors to your theme's "colors" object.`,c+=`
+See the built-in themes (dark.json, light.json) for reference values.`),s.length>0&&(c+=`
+
+Other errors:
+${s.join(`
+`)}`),new Error(c)}return t}r(Te,"parseThemeJson");function N(e,t){let n;try{n=JSON.parse(t)}catch(o){throw new Error(`Failed to parse theme ${e}: ${o}`)}return Te(e,n)}r(N,"parseThemeJsonContent");function D(e){const t=Q();if(e in t)return t[e];const n=B.get(e);if(n?.sourcePath){const a=m.readFileSync(n.sourcePath,"utf-8");return N(n.sourcePath,a)}if(n)throw new Error(`Theme "${e}" does not have a source path for export`);const o=M(),s=T.join(o,`${e}.json`);if(!m.existsSync(s))throw new Error(`Theme not found: ${e}`);const c=m.readFileSync(s,"utf-8");return N(e,c)}r(D,"loadThemeJson");function Y(e,t,n){const o=t??(ue().trueColor?"truecolor":"256color"),s=K(e.colors,e.vars),c={},a={},u=new Set(["selectedBg","userMessageBg","customMessageBg","toolPendingBg","toolSuccessBg","toolErrorBg"]);for(const[l,g]of Object.entries(s))u.has(l)?a[l]=g:c[l]=g;return new xe(c,a,o,{name:e.name,sourcePath:n})}r(Y,"createTheme");function X(e,t){const n=m.readFileSync(e,"utf-8"),o=N(e,n);return Y(o,t,e)}r(X,"loadThemeFromPath");function j(e,t){const n=B.get(e);if(n)return n;const o=D(e);return Y(o,t)}r(j,"loadTheme");function De(e){try{return j(e)}catch{return}}r(De,"getThemeByName");function ke(e){const t=e.split(";");for(let n=t.length-1;n>=0;n--){const o=parseInt(t[n].trim(),10);if(Number.isInteger(o)&&o>=0&&o<=255)return o}}r(ke,"getColorFgBgBackgroundIndex");function Z({r:e,g:t,b:n}){const o=r(s=>{const c=s/255;return c<=.03928?c/12.92:((c+.055)/1.055)**2.4},"toLinear");return .2126*o(e)+.7152*o(t)+.0722*o(n)}r(Z,"getRgbColorLuminance");function Ce(e){return Z(S(H(e)))}r(Ce,"getAnsiColorLuminance");function Fe(e){return Z(e)>=.5?"light":"dark"}r(Fe,"getThemeForRgbColor");function C(e){if(!/^[0-9a-f]+$/i.test(e))return;const t=16**e.length-1;if(!(t<=0))return Math.round(parseInt(e,16)/t*255)}r(C,"parseOscHexChannel");function He(e){const t=e.match(/^\x1b\]11;([^\x07\x1b]*)(?:\x07|\x1b\\)$/i);if(!t)return;const n=t[1].trim();if(n.startsWith("#")){const p=n.slice(1);if(/^[0-9a-f]{6}$/i.test(p))return S(n);if(/^[0-9a-f]{12}$/i.test(p)){const E=C(p.slice(0,4)),$=C(p.slice(4,8)),y=C(p.slice(8,12));return E!==void 0&&$!==void 0&&y!==void 0?{r:E,g:$,b:y}:void 0}return}const o=n.replace(/^rgba?:/i,""),[s,c,a]=o.split("/");if(s===void 0||c===void 0||a===void 0)return;const u=C(s),l=C(c),g=C(a);return u!==void 0&&l!==void 0&&g!==void 0?{r:u,g:l,b:g}:void 0}r(He,"parseOsc11BackgroundColor");function we(e={}){const n=(e.env??process.env).COLORFGBG||"",o=ke(n);return o!==void 0?{theme:Ce(o)>=.5?"light":"dark",source:"COLORFGBG",detail:`background color index ${o}`,confidence:"high"}:{theme:"dark",source:"fallback",detail:"no terminal background hint found",confidence:"low"}}r(we,"detectTerminalBackground");function F(){return we().theme}r(F,"getDefaultTheme");const ee=Symbol.for("@openadapter/koda:theme"),Be=Symbol.for("@mariozechner/pi-coding-agent:theme"),f=new Proxy({},{get(e,t){const n=globalThis[ee];if(!n)throw new Error("Theme not initialized. Call initTheme() first.");return n[t]}});function w(e){globalThis[ee]=e,globalThis[Be]=e}r(w,"setGlobalTheme");let d,I,x,b;const B=new Map;function Re(e){B.clear();for(const t of e)t.name&&B.set(t.name,t)}r(Re,"setRegisteredThemes");function Ue(e,t=!1){const n=e??F();d=n;try{w(j(n)),t&&te()}catch{d="dark",w(j("dark"))}}r(Ue,"initTheme");function _e(e,t=!1){d=e;try{return w(j(e)),t&&te(),b&&b(),{success:!0}}catch(n){return d="dark",w(j("dark")),{success:!1,error:n instanceof Error?n.message:String(n)}}}r(_e,"setTheme");function qe(e){w(e),d="<in-memory>",ne(),b&&b()}r(qe,"setThemeInstance");function Ve(e){b=e}r(Ve,"onThemeChange");function te(){if(ne(),!d||d==="dark"||d==="light")return;const e=M(),t=d,n=`${t}.json`,o=T.join(e,n);if(!m.existsSync(o))return;const s=r(()=>{x&&clearTimeout(x),x=setTimeout(()=>{if(x=void 0,d===t&&m.existsSync(o))try{const c=X(o);B.set(t,c),w(c),b&&b()}catch{}},100)},"scheduleReload");I=he(e,(c,a)=>{if(d===t){if(!a){s();return}a===n&&s()}},()=>{_(I),I=void 0})??void 0}r(te,"startThemeWatcher");function ne(){x&&(clearTimeout(x),x=void 0),_(I),I=void 0}r(ne,"stopThemeWatcher");function H(e){const t=["#000000","#800000","#008000","#808000","#000080","#800080","#008080","#c0c0c0","#808080","#ff0000","#00ff00","#ffff00","#0000ff","#ff00ff","#00ffff","#ffffff"];if(e<16)return t[e];if(e<232){const s=e-16,c=Math.floor(s/36),a=Math.floor(s%36/6),u=s%6,l=r(g=>(g===0?0:55+g*40).toString(16).padStart(2,"0"),"toHex");return`#${l(c)}${l(a)}${l(u)}`}const o=(8+(e-232)*10).toString(16).padStart(2,"0");return`#${o}${o}${o}`}r(H,"ansi256ToHex");function We(e){const t=e??d??F(),n=t==="light",o=D(t),s=K(o.colors,o.vars),c=n?"#000000":"#e5e5e7",a={};for(const[u,l]of Object.entries(s))typeof l=="number"?a[u]=H(l):l===""?a[u]=c:a[u]=l;return a}r(We,"getResolvedThemeColors");function Je(e){return e==="light"}r(Je,"isLightTheme");function Ge(e){const t=e??d??F();try{const n=D(t),o=n.export;if(!o)return{};const s=n.vars??{},c=r(a=>{if(a===void 0)return;const u=P(a,s);if(typeof u=="number")return H(u);if(u!=="")return u},"resolve");return{pageBg:c(o.pageBg),cardBg:c(o.cardBg),infoBg:c(o.infoBg)}}catch{return{}}}r(Ge,"getThemeExportColors");let re,R;function $e(e){return{keyword:r(t=>e.fg("syntaxKeyword",t),"keyword"),built_in:r(t=>e.fg("syntaxType",t),"built_in"),literal:r(t=>e.fg("syntaxNumber",t),"literal"),number:r(t=>e.fg("syntaxNumber",t),"number"),regexp:r(t=>e.fg("syntaxString",t),"regexp"),string:r(t=>e.fg("syntaxString",t),"string"),comment:r(t=>e.fg("syntaxComment",t),"comment"),doctag:r(t=>e.fg("syntaxComment",t),"doctag"),meta:r(t=>e.fg("muted",t),"meta"),function:r(t=>e.fg("syntaxFunction",t),"function"),title:r(t=>e.fg("syntaxFunction",t),"title"),class:r(t=>e.fg("syntaxType",t),"class"),type:r(t=>e.fg("syntaxType",t),"type"),tag:r(t=>e.fg("syntaxPunctuation",t),"tag"),name:r(t=>e.fg("syntaxKeyword",t),"name"),attr:r(t=>e.fg("syntaxVariable",t),"attr"),variable:r(t=>e.fg("syntaxVariable",t),"variable"),params:r(t=>e.fg("syntaxVariable",t),"params"),operator:r(t=>e.fg("syntaxOperator",t),"operator"),punctuation:r(t=>e.fg("syntaxPunctuation",t),"punctuation"),emphasis:r(t=>e.italic(t),"emphasis"),strong:r(t=>e.bold(t),"strong"),link:r(t=>e.underline(t),"link"),addition:r(t=>e.fg("toolDiffAdded",t),"addition"),deletion:r(t=>e.fg("toolDiffRemoved",t),"deletion")}}r($e,"buildCliHighlightTheme");function oe(e){return(re!==e||!R)&&(re=e,R=$e(e)),R}r(oe,"getCliHighlightTheme");function ze(e,t){const n=t&&V(t)?t:void 0;if(!n)return e.split(`
+`).map(s=>f.fg("mdCodeBlock",s));const o={language:n,ignoreIllegals:!0,theme:oe(f)};try{return q(e,o).split(`
+`)}catch{return e.split(`
+`)}}r(ze,"highlightCode");function Ke(e){const t=e.split(".").pop()?.toLowerCase();return t?{ts:"typescript",tsx:"typescript",js:"javascript",jsx:"javascript",mjs:"javascript",cjs:"javascript",py:"python",rb:"ruby",rs:"rust",go:"go",java:"java",kt:"kotlin",swift:"swift",c:"c",h:"c",cpp:"cpp",cc:"cpp",cxx:"cpp",hpp:"cpp",cs:"csharp",php:"php",sh:"bash",bash:"bash",zsh:"bash",fish:"fish",ps1:"powershell",sql:"sql",html:"html",htm:"html",css:"css",scss:"scss",sass:"sass",less:"less",json:"json",yaml:"yaml",yml:"yaml",toml:"toml",xml:"xml",md:"markdown",markdown:"markdown",dockerfile:"dockerfile",makefile:"makefile",cmake:"cmake",lua:"lua",perl:"perl",r:"r",scala:"scala",clj:"clojure",ex:"elixir",exs:"elixir",erl:"erlang",hs:"haskell",ml:"ocaml",vim:"vim",graphql:"graphql",proto:"protobuf",tf:"hcl",hcl:"hcl"}[t]:void 0}r(Ke,"getLanguageFromPath");function Qe(){return{heading:r(e=>f.fg("mdHeading",e),"heading"),link:r(e=>f.fg("mdLink",e),"link"),linkUrl:r(e=>f.fg("mdLinkUrl",e),"linkUrl"),code:r(e=>f.fg("mdCode",e),"code"),codeBlock:r(e=>f.fg("mdCodeBlock",e),"codeBlock"),codeBlockBorder:r(e=>f.fg("mdCodeBlockBorder",e),"codeBlockBorder"),quote:r(e=>f.fg("mdQuote",e),"quote"),quoteBorder:r(e=>f.fg("mdQuoteBorder",e),"quoteBorder"),hr:r(e=>f.fg("mdHr",e),"hr"),listBullet:r(e=>f.fg("mdListBullet",e),"listBullet"),bold:r(e=>f.bold(e),"bold"),italic:r(e=>f.italic(e),"italic"),underline:r(e=>f.underline(e),"underline"),strikethrough:r(e=>k.strikethrough(e),"strikethrough"),highlightCode:r((e,t)=>{const n=t&&V(t)?t:void 0;if(!n)return e.split(`
+`).map(s=>f.fg("mdCodeBlock",s));const o={language:n,ignoreIllegals:!0,theme:oe(f)};try{return q(e,o).split(`
+`)}catch{return e.split(`
+`).map(s=>f.fg("mdCodeBlock",s))}},"highlightCode")}}r(Qe,"getMarkdownTheme");function Se(){return{selectedPrefix:r(e=>f.fg("accent",e),"selectedPrefix"),selectedText:r(e=>f.fg("accent",e),"selectedText"),description:r(e=>f.fg("muted",e),"description"),scrollInfo:r(e=>f.fg("muted",e),"scrollInfo"),noMatch:r(e=>f.fg("muted",e),"noMatch")}}r(Se,"getSelectListTheme");function Ye(){return{borderColor:r(e=>f.fg("accent",e),"borderColor"),selectList:Se()}}r(Ye,"getEditorTheme");function Xe(){return{label:r((e,t)=>t?f.fg("accent",e):e,"label"),value:r((e,t)=>t?f.fg("accent",e):f.fg("muted",e),"value"),description:r(e=>f.fg("dim",e),"description"),cursor:f.fg("accent","\u2192 "),hint:r(e=>f.fg("dim",e),"hint")}}r(Xe,"getSettingsListTheme");export{xe as Theme,we as detectTerminalBackground,Ne as getAvailableThemes,be as getAvailableThemesWithPaths,F as getDefaultTheme,Ye as getEditorTheme,Ke as getLanguageFromPath,Qe as getMarkdownTheme,We as getResolvedThemeColors,Se as getSelectListTheme,Xe as getSettingsListTheme,De as getThemeByName,Ge as getThemeExportColors,Fe as getThemeForRgbColor,ze as highlightCode,Ue as initTheme,Je as isLightTheme,X as loadThemeFromPath,Ve as onThemeChange,He as parseOsc11BackgroundColor,Re as setRegisteredThemes,_e as setTheme,qe as setThemeInstance,ne as stopThemeWatcher,f as theme};

package/dist/modes/print-mode.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Print mode (single-shot): Send prompts, output result, exit.
+ *
+ * Used for:
+ * - `pi -p "prompt"` - text output
+ * - `pi --mode json "prompt"` - JSON event stream
+ */
+import type { ImageContent } from "@openadapter/koda-ai";
+import type { AgentSessionRuntime } from "../core/agent-session-runtime.ts";
+/**
+ * Options for print mode.
+ */
+export interface PrintModeOptions {
+    /** Output mode: "text" for final response only, "json" for all events */
+    mode: "text" | "json";
+    /** Array of additional prompts to send after initialMessage */
+    messages?: string[];
+    /** First message to send (may contain @file content) */
+    initialMessage?: string;
+    /** Images to attach to the initial message */
+    initialImages?: ImageContent[];
+}
+/**
+ * Run in print (single-shot) mode.
+ * Sends prompts to the agent and outputs the result.
+ */
+export declare function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number>;

package/dist/modes/print-mode.js

@@ -0,0 +1,4 @@
+var h=Object.defineProperty;var n=(r,i)=>h(r,"name",{value:i,configurable:!0});import{flushRawStdout as b,writeRawStdout as l}from"../core/output-guard.js";import{killTrackedDetachedChildren as x}from"../utils/shell.js";async function E(r,i){const{mode:a,messages:S=[],initialMessage:d,initialImages:y}=i;let f=0,t=r.session,c,u=!1;const g=[],p=n(async()=>{u||(u=!0,c?.(),await r.dispose())},"disposeRuntime");n(()=>{const s=["SIGTERM"];process.platform!=="win32"&&s.push("SIGHUP");for(const e of s){const o=n(()=>{x(),p().finally(()=>{process.exit(e==="SIGHUP"?129:143)})},"handler");process.on(e,o),g.push(()=>process.off(e,o))}},"registerSignalHandlers")(),r.setRebindSession(async()=>{await w()});const w=n(async()=>{t=r.session,await t.bindExtensions({mode:a==="json"?"json":"print",commandContextActions:{waitForIdle:n(()=>t.agent.waitForIdle(),"waitForIdle"),newSession:n(async s=>r.newSession(s),"newSession"),fork:n(async(s,e)=>({cancelled:(await r.fork(s,e)).cancelled}),"fork"),navigateTree:n(async(s,e)=>({cancelled:(await t.navigateTree(s,{summarize:e?.summarize,customInstructions:e?.customInstructions,replaceInstructions:e?.replaceInstructions,label:e?.label})).cancelled}),"navigateTree"),switchSession:n(async(s,e)=>r.switchSession(s,e),"switchSession"),reload:n(async()=>{await t.reload()},"reload")},onError:n(s=>{console.error(`Extension error (${s.extensionPath}): ${s.error}`)},"onError")}),c?.(),c=t.subscribe(s=>{a==="json"&&l(`${JSON.stringify(s)}
+`)})},"rebindSession");try{if(a==="json"){const s=t.sessionManager.getHeader();s&&l(`${JSON.stringify(s)}
+`)}await w(),d&&await t.prompt(d,{images:y});for(const s of S)await t.prompt(s);if(a==="text"){const s=t.state,e=s.messages[s.messages.length-1];if(e?.role==="assistant"){const o=e;if(o.stopReason==="error"||o.stopReason==="aborted")console.error(o.errorMessage||`Request ${o.stopReason}`),f=1;else for(const m of o.content)m.type==="text"&&l(`${m.text}
+`)}}return f}catch(s){return console.error(s instanceof Error?s.message:String(s)),1}finally{for(const s of g)s();await p(),await b()}}n(E,"runPrintMode");export{E as runPrintMode};

package/dist/modes/rpc/jsonl.d.ts

@@ -0,0 +1,16 @@
+import type { Readable } from "node:stream";
+/**
+ * Serialize a single strict JSONL record.
+ *
+ * Framing is LF-only. Payload strings may contain other Unicode separators such as
+ * U+2028 and U+2029. Clients must split records on `\n` only.
+ */
+export declare function serializeJsonLine(value: unknown): string;
+/**
+ * Attach an LF-only JSONL reader to a stream.
+ *
+ * This intentionally does not use Node readline. Readline splits on additional
+ * Unicode separators that are valid inside JSON strings and therefore does not
+ * implement strict JSONL framing.
+ */
+export declare function attachJsonlLineReader(stream: Readable, onLine: (line: string) => void): () => void;

package/dist/modes/rpc/jsonl.js

@@ -0,0 +1,3 @@
+var a=Object.defineProperty;var o=(e,i)=>a(e,"name",{value:i,configurable:!0});import{StringDecoder as l}from"node:string_decoder";function p(e){return`${JSON.stringify(e)}
+`}o(p,"serializeJsonLine");function w(e,i){const f=new l("utf8");let n="";const d=o(t=>{i(t.endsWith("\r")?t.slice(0,-1):t)},"emitLine"),c=o(t=>{for(n+=typeof t=="string"?t:f.write(t);;){const r=n.indexOf(`
+`);if(r===-1)return;d(n.slice(0,r)),n=n.slice(r+1)}},"onData"),s=o(()=>{n+=f.end(),n.length>0&&(d(n),n="")},"onEnd");return e.on("data",c),e.on("end",s),()=>{e.off("data",c),e.off("end",s)}}o(w,"attachJsonlLineReader");export{w as attachJsonlLineReader,p as serializeJsonLine};