catui-agent 1.0.0-beta.0

package/dist/modes/interactive/theme/light.json

@@ -0,0 +1,84 @@
+{
+	"$schema": "https://raw.githubusercontent.com/O-Catui/Catui/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "light",
+	"vars": {
+		"teal": "#5a8080",
+		"blue": "#547da7",
+		"green": "#588458",
+		"red": "#aa5555",
+		"yellow": "#9a7326",
+		"mediumGray": "#6c6c6c",
+		"dimGray": "#767676",
+		"lightGray": "#b0b0b0",
+		"selectedBg": "#d0d0e0",
+		"userMsgBg": "#e8e8e8",
+		"toolPendingBg": "#e8e8f0",
+		"toolSuccessBg": "#e8f0e8",
+		"toolErrorBg": "#f0e8e8",
+		"customMsgBg": "#ede7f6"
+	},
+	"colors": {
+		"accent": "teal",
+		"border": "blue",
+		"borderAccent": "teal",
+		"borderMuted": "lightGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "mediumGray",
+		"dim": "dimGray",
+		"text": "",
+		"thinkingText": "mediumGray",
+
+		"selectedBg": "selectedBg",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "",
+		"customMessageLabel": "#7e57c2",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "",
+		"toolOutput": "mediumGray",
+
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "teal",
+		"mdCodeBlock": "green",
+		"mdCodeBlockBorder": "mediumGray",
+		"mdQuote": "mediumGray",
+		"mdQuoteBorder": "mediumGray",
+		"mdHr": "mediumGray",
+		"mdListBullet": "green",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "mediumGray",
+
+		"syntaxComment": "#008000",
+		"syntaxKeyword": "#0000FF",
+		"syntaxFunction": "#795E26",
+		"syntaxVariable": "#001080",
+		"syntaxString": "#A31515",
+		"syntaxNumber": "#098658",
+		"syntaxType": "#267F99",
+		"syntaxOperator": "#000000",
+		"syntaxPunctuation": "#000000",
+
+		"thinkingOff": "lightGray",
+		"thinkingMinimal": "#767676",
+		"thinkingLow": "blue",
+		"thinkingMedium": "teal",
+		"thinkingHigh": "#875f87",
+		"thinkingXhigh": "#8b008b",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#f8f8f8",
+		"cardBg": "#ffffff",
+		"infoBg": "#fffae6"
+	}
+}

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

@@ -0,0 +1,335 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "Catui Theme",
+	"description": "Theme schema for Catui",
+	"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,81 @@
+/**
+ * [WHO]: ThemeContract, getAvailableThemes, ThemeInfo, getAvailableThemesWithPaths, loadThemeFromPath
+ * [FROM]: Depends on node:fs, node:path, @sinclair/typebox, @sinclair/typebox/compiler, chalk
+ * [TO]: Consumed by main.ts, core/extensions-host/runner.ts, core/extensions-host/types.ts, core/runtime/agent-session.ts, core/export-html/index.ts, core/export-html/tool-renderer.ts, modes/interactive/components/*, extensions/optional/export-html/index.ts, extensions/optional/simplify/index.ts
+ * [HERE]: modes/interactive/theme/theme.ts - theme loader and definitions
+ */
+import type { EditorTheme, MarkdownTheme, SelectListTheme } from "@catui/tui";
+import type { ColorMode, Theme as ThemeContract, ThemeBg, ThemeColor } from "../../../core/theme-contract.js";
+export type { ThemeColor, ThemeBg, ColorMode, Theme } from "../../../core/theme-contract.js";
+export declare class ThemeImpl implements ThemeContract {
+    readonly name?: string;
+    readonly sourcePath?: string;
+    private fgColors;
+    private bgColors;
+    private mode;
+    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, options?: {
+        name?: string;
+        sourcePath?: string;
+    });
+    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): ThemeContract;
+export declare function getThemeByName(name: string): ThemeContract | undefined;
+export declare const theme: ThemeContract;
+export declare function setRegisteredThemes(themes: ThemeContract[]): 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: ThemeContract): 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(): import("@catui/tui").SettingsListTheme;

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

@@ -0,0 +1,16 @@
+var re=Object.defineProperty;var n=(e,t)=>re(e,"name",{value:t,configurable:!0});import*as h from"node:fs";import*as b from"node:path";import{createRequire as ne}from"node:module";import{Type as g}from"@sinclair/typebox";import{TypeCompiler as oe}from"@sinclair/typebox/compiler";import k from"chalk";import{getCustomThemesDir as S,getThemesDir as F}from"../../../config.js";const se=ne(import.meta.url);let $;function H(){return $||($=se("cli-highlight")),$}n(H,"getHl");const s=g.Union([g.String(),g.Integer({minimum:0,maximum:255})]),ie=g.Object({$schema:g.Optional(g.String()),name:g.String(),vars:g.Optional(g.Record(g.String(),s)),colors:g.Object({accent:s,border:s,borderAccent:s,borderMuted:s,success:s,error:s,warning:s,muted:s,dim:s,text:s,thinkingText:s,selectedBg:s,userMessageBg:s,userMessageText:s,customMessageBg:s,customMessageText:s,customMessageLabel:s,toolPendingBg:s,toolSuccessBg:s,toolErrorBg:s,toolTitle:s,toolOutput:s,mdHeading:s,mdLink:s,mdLinkUrl:s,mdCode:s,mdCodeBlock:s,mdCodeBlockBorder:s,mdQuote:s,mdQuoteBorder:s,mdHr:s,mdListBullet:s,toolDiffAdded:s,toolDiffRemoved:s,toolDiffContext:s,syntaxComment:s,syntaxKeyword:s,syntaxFunction:s,syntaxVariable:s,syntaxString:s,syntaxNumber:s,syntaxType:s,syntaxOperator:s,syntaxPunctuation:s,thinkingOff:s,thinkingMinimal:s,thinkingLow:s,thinkingMedium:s,thinkingHigh:s,thinkingXhigh:s,bashMode:s}),export:g.Optional(g.Object({pageBg:g.Optional(s),cardBg:g.Optional(s),infoBg:g.Optional(s)}))}),A=oe.Compile(ie);function ce(){const e=process.env.COLORTERM;if(e==="truecolor"||e==="24bit"||process.env.WT_SESSION)return"truecolor";const t=process.env.TERM||"";return t==="dumb"||t===""||t==="linux"||process.env.TERM_PROGRAM==="Apple_Terminal"?"256color":"truecolor"}n(ce,"detectColorMode");function j(e){const t=e.replace("#","");if(t.length!==6)throw new Error(`Invalid hex color: ${e}`);const r=parseInt(t.substring(0,2),16),o=parseInt(t.substring(2,4),16),i=parseInt(t.substring(4,6),16);if(Number.isNaN(r)||Number.isNaN(o)||Number.isNaN(i))throw new Error(`Invalid hex color: ${e}`);return{r,g:o,b:i}}n(j,"hexToRgb");const C=[0,95,135,175,215,255],M=Array.from({length:24},(e,t)=>8+t*10);function v(e){let t=1/0,r=0;for(let o=0;o<C.length;o++){const i=Math.abs(e-C[o]);i<t&&(t=i,r=o)}return r}n(v,"findClosestCubeIndex");function ae(e){let t=1/0,r=0;for(let o=0;o<M.length;o++){const i=Math.abs(e-M[o]);i<t&&(t=i,r=o)}return r}n(ae,"findClosestGrayIndex");function _(e,t,r,o,i,c){const a=e-o,l=t-i,u=r-c;return a*a*.299+l*l*.587+u*u*.114}n(_,"colorDistance");function fe(e,t,r){const o=v(e),i=v(t),c=v(r),a=C[o],l=C[i],u=C[c],x=16+36*o+6*i+c,z=_(e,t,r,a,l,u),X=Math.round(.299*e+.587*t+.114*r),D=ae(X),B=M[D],Y=232+D,Z=_(e,t,r,B,B,B),ee=Math.max(e,t,r),te=Math.min(e,t,r);return ee-te<10&&Z<z?Y:x}n(fe,"rgbTo256");function J(e){const{r:t,g:r,b:o}=j(e);return fe(t,r,o)}n(J,"hexTo256");function le(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,g:o,b:i}=j(e);return`\x1B[38;2;${r};${o};${i}m`}else return`\x1B[38;5;${J(e)}m`;throw new Error(`Invalid color value: ${e}`)}n(le,"fgAnsi");function ue(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,g:o,b:i}=j(e);return`\x1B[48;2;${r};${o};${i}m`}else return`\x1B[48;5;${J(e)}m`;throw new Error(`Invalid color value: ${e}`)}n(ue,"bgAnsi");function U(e,t,r=new Set){if(typeof e=="number"||e===""||e.startsWith("#"))return e;if(r.has(e))throw new Error(`Circular variable reference detected: ${e}`);if(!(e in t))throw new Error(`Variable reference not found: ${e}`);return r.add(e),U(t[e],t,r)}n(U,"resolveVarRefs");function W(e,t={}){const r={};for(const[o,i]of Object.entries(e))r[o]=U(i,t);return r}n(W,"resolveThemeColors");class he{static{n(this,"ThemeImpl")}name;sourcePath;fgColors;bgColors;mode;constructor(t,r,o,i={}){this.name=i.name,this.sourcePath=i.sourcePath,this.mode=o,this.fgColors=new Map;for(const[c,a]of Object.entries(t))this.fgColors.set(c,le(a,o));this.bgColors=new Map;for(const[c,a]of Object.entries(r))this.bgColors.set(c,ue(a,o))}fg(t,r){const o=this.fgColors.get(t);if(!o)throw new Error(`Unknown theme color: ${t}`);return`${o}${r}\x1B[39m`}bg(t,r){const o=this.bgColors.get(t);if(!o)throw new Error(`Unknown theme background color: ${t}`);return`${o}${r}\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 r=this.fgColors.get(t);if(!r)throw new Error(`Unknown theme color: ${t}`);return r}getBgAnsi(t){const r=this.bgColors.get(t);if(!r)throw new Error(`Unknown theme background color: ${t}`);return r}getColorMode(){return this.mode}getThinkingBorderColor(t){switch(t){case"off":return r=>this.fg("thinkingOff",r);case"minimal":return r=>this.fg("thinkingMinimal",r);case"low":return r=>this.fg("thinkingLow",r);case"medium":return r=>this.fg("thinkingMedium",r);case"high":return r=>this.fg("thinkingHigh",r);case"xhigh":return r=>this.fg("thinkingXhigh",r);default:return r=>this.fg("thinkingOff",r)}}getBashModeBorderColor(){return t=>this.fg("bashMode",t)}}let E;function O(){if(!E){const e=F(),t=b.join(e,"dark.json"),r=b.join(e,"light.json"),o=b.join(e,"warm.json");E={dark:JSON.parse(h.readFileSync(t,"utf-8")),light:JSON.parse(h.readFileSync(r,"utf-8")),warm:h.existsSync(o)?JSON.parse(h.readFileSync(o,"utf-8")):JSON.parse(h.readFileSync(t,"utf-8"))}}return E}n(O,"getBuiltinThemes");function Be(){const e=new Set(Object.keys(O())),t=S();if(h.existsSync(t)){const r=h.readdirSync(t);for(const o of r)o.endsWith(".json")&&e.add(o.slice(0,-5))}for(const r of w.keys())e.add(r);return Array.from(e).sort()}n(Be,"getAvailableThemes");function $e(){const e=F(),t=S(),r=[];for(const o of Object.keys(O()))r.push({name:o,path:b.join(e,`${o}.json`)});if(h.existsSync(t)){for(const o of h.readdirSync(t))if(o.endsWith(".json")){const i=o.slice(0,-5);r.some(c=>c.name===i)||r.push({name:i,path:b.join(t,o)})}}for(const[o,i]of w.entries())r.some(c=>c.name===o)||r.push({name:o,path:i.sourcePath});return r.sort((o,i)=>o.name.localeCompare(i.name))}n($e,"getAvailableThemesWithPaths");function ge(e,t){if(!A.Check(t)){const r=Array.from(A.Errors(t)),o=[],i=[];for(const a of r){const l=a.path.match(/^\/colors\/(\w+)$/);l&&a.message.includes("Required")?o.push(l[1]):i.push(`  - ${a.path}: ${a.message}`)}let c=`Invalid theme "${e}":
+`;throw o.length>0&&(c+=`
+Missing required color tokens:
+`,c+=o.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.`),i.length>0&&(c+=`
+
+Other errors:
+${i.join(`
+`)}`),new Error(c)}return t}n(ge,"parseThemeJson");function I(e,t){let r;try{r=JSON.parse(t)}catch(o){throw new Error(`Failed to parse theme ${e}: ${o}`)}return ge(e,r)}n(I,"parseThemeJsonContent");function L(e){const t=O();if(e in t)return t[e];const r=w.get(e);if(r?.sourcePath){const a=h.readFileSync(r.sourcePath,"utf-8");return I(r.sourcePath,a)}if(r)throw new Error(`Theme "${e}" does not have a source path for export`);const o=S(),i=b.join(o,`${e}.json`);if(!h.existsSync(i))throw new Error(`Theme not found: ${e}`);const c=h.readFileSync(i,"utf-8");return I(e,c)}n(L,"loadThemeJson");function q(e,t,r){const o=t??ce(),i=W(e.colors,e.vars),c={},a={},l=new Set(["selectedBg","userMessageBg","customMessageBg","toolPendingBg","toolSuccessBg","toolErrorBg"]);for(const[u,x]of Object.entries(i))l.has(u)?a[u]=x:c[u]=x;return new he(c,a,o,{name:e.name,sourcePath:r})}n(q,"createTheme");function je(e,t){const r=h.readFileSync(e,"utf-8"),o=I(e,r);return q(o,t,e)}n(je,"loadThemeFromPath");function y(e,t){const r=w.get(e);if(r)return r;const o=L(e);return q(o,t)}n(y,"loadTheme");function Me(e){try{return y(e)}catch{return}}n(Me,"getThemeByName");function me(){const e=process.env.COLORFGBG||"";if(e){const t=e.split(";");if(t.length>=2){const r=parseInt(t[1],10);if(!Number.isNaN(r))return r<8?"dark":"light"}}return"dark"}n(me,"detectTerminalBackground");function N(){return me()}n(N,"getDefaultTheme");const V=Symbol.for("@catui/agent:theme"),f=new Proxy({},{get(e,t){const r=globalThis[V];if(!r)throw new Error("Theme not initialized. Call initTheme() first.");return r[t]}});function T(e){globalThis[V]=e}n(T,"setGlobalTheme");let m,d,p;const w=new Map;function ve(e){w.clear();for(const t of e)t.name&&w.set(t.name,t)}n(ve,"setRegisteredThemes");function Ee(e,t=!1){const r=e??N();m=r;try{T(y(r)),t&&G()}catch{m="dark",T(y("dark"))}}n(Ee,"initTheme");function Oe(e,t=!1){m=e;try{return T(y(e)),t&&G(),p&&p(),{success:!0}}catch(r){return m="dark",T(y("dark")),{success:!1,error:r instanceof Error?r.message:String(r)}}}n(Oe,"setTheme");function Ie(e){T(e),m="<in-memory>",de(),p&&p()}n(Ie,"setThemeInstance");function Le(e){p=e}n(Le,"onThemeChange");function G(){if(d&&(d.close(),d=void 0),!m||m==="dark"||m==="light"||m==="warm")return;const e=S(),t=b.join(e,`${m}.json`);if(h.existsSync(t))try{d=h.watch(t,r=>{r==="change"?setTimeout(()=>{try{T(y(m)),p&&p()}catch{}},100):r==="rename"&&setTimeout(()=>{h.existsSync(t)||(m="dark",T(y("dark")),d&&(d.close(),d=void 0),p&&p())},100)})}catch{}}n(G,"startThemeWatcher");function de(){d&&(d.close(),d=void 0)}n(de,"stopThemeWatcher");function P(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 i=e-16,c=Math.floor(i/36),a=Math.floor(i%36/6),l=i%6,u=n(x=>(x===0?0:55+x*40).toString(16).padStart(2,"0"),"toHex");return`#${u(c)}${u(a)}${u(l)}`}const o=(8+(e-232)*10).toString(16).padStart(2,"0");return`#${o}${o}${o}`}n(P,"ansi256ToHex");function Ne(e){const t=e??m??N(),r=t==="light",o=L(t),i=W(o.colors,o.vars),c=r?"#000000":"#e5e5e7",a={};for(const[l,u]of Object.entries(i))typeof u=="number"?a[l]=P(u):u===""?a[l]=c:a[l]=u;return a}n(Ne,"getResolvedThemeColors");function Pe(e){return e==="light"}n(Pe,"isLightTheme");function Re(e){const t=e??m??N();try{const r=L(t),o=r.export;if(!o)return{};const i=r.vars??{},c=n(a=>{if(a!==void 0){if(typeof a=="number")return P(a);if(a.startsWith("$")){const l=i[a];return l===void 0?void 0:typeof l=="number"?P(l):l}return a}},"resolve");return{pageBg:c(o.pageBg),cardBg:c(o.cardBg),infoBg:c(o.infoBg)}}catch{return{}}}n(Re,"getThemeExportColors");let K,R;function pe(e){return{keyword:n(t=>e.fg("syntaxKeyword",t),"keyword"),built_in:n(t=>e.fg("syntaxType",t),"built_in"),literal:n(t=>e.fg("syntaxNumber",t),"literal"),number:n(t=>e.fg("syntaxNumber",t),"number"),string:n(t=>e.fg("syntaxString",t),"string"),comment:n(t=>e.fg("syntaxComment",t),"comment"),function:n(t=>e.fg("syntaxFunction",t),"function"),title:n(t=>e.fg("syntaxFunction",t),"title"),class:n(t=>e.fg("syntaxType",t),"class"),type:n(t=>e.fg("syntaxType",t),"type"),attr:n(t=>e.fg("syntaxVariable",t),"attr"),variable:n(t=>e.fg("syntaxVariable",t),"variable"),params:n(t=>e.fg("syntaxVariable",t),"params"),operator:n(t=>e.fg("syntaxOperator",t),"operator"),punctuation:n(t=>e.fg("syntaxPunctuation",t),"punctuation")}}n(pe,"buildCliHighlightTheme");function Q(e){return(K!==e||!R)&&(K=e,R=pe(e)),R}n(Q,"getCliHighlightTheme");function De(e,t){const r=H(),i={language:t&&r.supportsLanguage(t)?t:void 0,ignoreIllegals:!0,theme:Q(f)};try{return r.highlight(e,i).split(`
+`)}catch{return e.split(`
+`)}}n(De,"highlightCode");function Fe(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}n(Fe,"getLanguageFromPath");function He(){return{heading:n(e=>f.fg("mdHeading",e),"heading"),link:n(e=>f.fg("mdLink",e),"link"),linkUrl:n(e=>f.fg("mdLinkUrl",e),"linkUrl"),code:n(e=>f.fg("mdCode",e),"code"),codeBlock:n(e=>f.fg("mdCodeBlock",e),"codeBlock"),codeBlockBorder:n(e=>f.fg("mdCodeBlockBorder",e),"codeBlockBorder"),quote:n(e=>f.fg("mdQuote",e),"quote"),quoteBorder:n(e=>f.fg("mdQuoteBorder",e),"quoteBorder"),hr:n(e=>f.fg("mdHr",e),"hr"),listBullet:n(e=>f.fg("mdListBullet",e),"listBullet"),bold:n(e=>f.bold(e),"bold"),italic:n(e=>f.italic(e),"italic"),underline:n(e=>f.underline(e),"underline"),strikethrough:n(e=>k.strikethrough(e),"strikethrough"),highlightCode:n((e,t)=>{const r=H(),i={language:t&&r.supportsLanguage(t)?t:void 0,ignoreIllegals:!0,theme:Q(f)};try{return r.highlight(e,i).split(`
+`)}catch{return e.split(`
+`).map(c=>f.fg("mdCodeBlock",c))}},"highlightCode")}}n(He,"getMarkdownTheme");function xe(){return{selectedPrefix:n(e=>f.fg("accent",e),"selectedPrefix"),selectedText:n(e=>f.fg("accent",e),"selectedText"),description:n(e=>f.fg("muted",e),"description"),scrollInfo:n(e=>f.fg("muted",e),"scrollInfo"),noMatch:n(e=>f.fg("muted",e),"noMatch")}}n(xe,"getSelectListTheme");function Ae(){return{borderColor:n(e=>f.fg("borderMuted",e),"borderColor"),selectList:xe()}}n(Ae,"getEditorTheme");function _e(){return{label:n((e,t)=>t?f.fg("accent",e):e,"label"),value:n((e,t)=>t?f.fg("accent",e):f.fg("muted",e),"value"),description:n(e=>f.fg("dim",e),"description"),cursor:f.fg("accent","\u2192 "),hint:n(e=>f.fg("dim",e),"hint")}}n(_e,"getSettingsListTheme");export{he as ThemeImpl,Be as getAvailableThemes,$e as getAvailableThemesWithPaths,Ae as getEditorTheme,Fe as getLanguageFromPath,He as getMarkdownTheme,Ne as getResolvedThemeColors,xe as getSelectListTheme,_e as getSettingsListTheme,Me as getThemeByName,Re as getThemeExportColors,De as highlightCode,Ee as initTheme,Pe as isLightTheme,je as loadThemeFromPath,Le as onThemeChange,ve as setRegisteredThemes,Oe as setTheme,Ie as setThemeInstance,de as stopThemeWatcher,f as theme};

package/dist/modes/interactive/theme/warm.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://raw.githubusercontent.com/O-Catui/Catui/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "warm",
+  "vars": {
+    "warmBrown": "#c4a574",
+    "warmLight": "#d4a574",
+    "warmBorder": "#a08060",
+    "blue": "#5f87ff",
+    "green": "#b5bd68",
+    "red": "#cc6666",
+    "yellow": "#d4a84b",
+    "gray": "#808080",
+    "dimGray": "#666666",
+    "darkGray": "#505050",
+    "accent": "warmBrown",
+    "selectedBg": "#3d362a",
+    "userMsgBg": "#2e2a24",
+    "toolPendingBg": "#2a2820",
+    "toolSuccessBg": "#2a3024",
+    "toolErrorBg": "#3c2828",
+    "customMsgBg": "#2d2838"
+  },
+  "colors": {
+    "accent": "accent",
+    "border": "warmBorder",
+    "borderAccent": "warmLight",
+    "borderMuted": "darkGray",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "gray",
+    "dim": "dimGray",
+    "text": "",
+    "thinkingText": "gray",
+    "selectedBg": "selectedBg",
+    "userMessageBg": "userMsgBg",
+    "userMessageText": "warmLight",
+    "customMessageBg": "customMsgBg",
+    "customMessageText": "",
+    "customMessageLabel": "#b8956b",
+    "toolPendingBg": "toolPendingBg",
+    "toolSuccessBg": "toolSuccessBg",
+    "toolErrorBg": "toolErrorBg",
+    "toolTitle": "",
+    "toolOutput": "gray",
+    "mdHeading": "warmLight",
+    "mdLink": "#81a2be",
+    "mdLinkUrl": "dimGray",
+    "mdCode": "accent",
+    "mdCodeBlock": "green",
+    "mdCodeBlockBorder": "gray",
+    "mdQuote": "gray",
+    "mdQuoteBorder": "gray",
+    "mdHr": "gray",
+    "mdListBullet": "accent",
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "gray",
+    "syntaxComment": "#6A9955",
+    "syntaxKeyword": "#569CD6",
+    "syntaxFunction": "#DCDCAA",
+    "syntaxVariable": "#9CDCFE",
+    "syntaxString": "#CE9178",
+    "syntaxNumber": "#B5CEA8",
+    "syntaxType": "#4EC9B0",
+    "syntaxOperator": "#D4D4D4",
+    "syntaxPunctuation": "#D4D4D4",
+    "thinkingOff": "darkGray",
+    "thinkingMinimal": "#6e6e6e",
+    "thinkingLow": "#5f87af",
+    "thinkingMedium": "warmBrown",
+    "thinkingHigh": "#b294bb",
+    "thinkingXhigh": "#d183e8",
+    "bashMode": "green"
+  },
+  "export": {
+    "pageBg": "#1a1814",
+    "cardBg": "#242018",
+    "infoBg": "#3c3728"
+  }
+}

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

@@ -0,0 +1,38 @@
+/**
+ * [WHO]: PrintModeOptions, PrintModeResult, formatPrintLoopResult(), collectPrintAssistantText(), runPrintMode()
+ * [FROM]: Depends on ai, agent-core, core/runtime/agent-session
+ * [TO]: Consumed by modes/index.ts, main.ts, print mode tests
+ * [HERE]: modes/print-mode.ts - non-interactive batch processing mode
+ */
+import type { AgentRunResult } from "@catui/agent-core";
+import type { ImageContent, Message } from "@catui/ai/types";
+import type { AgentSession } from "../core/runtime/agent-session.js";
+/**
+ * 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[];
+    /** In text mode, emit the final agent loop result as one JSON line on stderr */
+    printLoopResult?: boolean;
+    /** Exit non-zero when the final agent loop result is an error. */
+    failOnAgentError?: boolean;
+    /** Exit non-zero when the final agent loop result includes tool permission denials. */
+    failOnToolDenial?: boolean;
+}
+export interface PrintModeResult {
+    exitCode: number;
+}
+export declare function formatPrintLoopResult(result: AgentRunResult | undefined): string | undefined;
+export declare function collectPrintAssistantText(messages: Message[], result?: AgentRunResult): string[];
+/**
+ * Run in print (single-shot) mode.
+ * Sends prompts to the agent and outputs the result.
+ */
+export declare function runPrintMode(session: AgentSession, options: PrintModeOptions): Promise<PrintModeResult>;