catui-agent 1.0.0-beta.0

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

@@ -0,0 +1,9 @@
+/**
+ * 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,2 @@
+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,39 @@
+/**
+ * [WHO]: ToolHtmlRenderer, exportSessionToHtml()
+ * [FROM]: Depends on agent-core, node:fs, node:path, config, modes/theme, extensions, session
+ * [TO]: Consumed by core/runtime/agent-session.ts, extensions/optional/export-html/index.ts
+ * [HERE]: core/export-html/index.ts - HTML export functionality
+ */
+import type { AgentState } from "@catui/agent-core";
+import { SessionManager } from "../session/session-manager.js";
+/**
+ * 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(toolName: string, args: unknown): string | undefined;
+    /** Render a tool result to HTML. Returns undefined if tool has no custom renderer. */
+    renderResult(toolName: string, result: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>, details: unknown, isError: boolean): 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 j=Object.defineProperty;var i=(n,e)=>j(n,"name",{value:e,configurable:!0});import{existsSync as d,readFileSync as m,writeFileSync as h}from"fs";import{basename as B,join as f}from"path";import{APP_NAME as b,getExportTemplateDir as A}from"../../config.js";import{getResolvedThemeColors as y,getThemeExportColors as F}from"../../modes/interactive/theme/theme.js";import{SessionManager as H}from"../session/session-manager.js";function I(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)}}i(I,"parseColor");function L(n,e,t){const r=i(s=>{const o=s/255;return o<=.03928?o/12.92:((o+.055)/1.055)**2.4},"toLinear");return .2126*r(n)+.7152*r(e)+.0722*r(t)}i(L,"getLuminance");function p(n,e){const t=I(n);if(!t)return n;const r=i(s=>Math.min(255,Math.max(0,Math.round(s*e))),"adjust");return`rgb(${r(t.r)}, ${r(t.g)}, ${r(t.b)})`}i(p,"adjustBrightness");function $(n){const e=I(n);return e?L(e.r,e.g,e.b)>.5?{pageBg:p(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:p(n,.7),cardBg:p(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)"}}i($,"deriveExportColors");function w(n){const e=y(n),t=[];for(const[a,c]of Object.entries(e))t.push(`--${a}: ${c};`);const r=F(n),s=e.userMessageBg||"#343541",o=$(s);return t.push(`--exportPageBg: ${r.pageBg??o.pageBg};`),t.push(`--exportCardBg: ${r.cardBg??o.cardBg};`),t.push(`--exportInfoBg: ${r.infoBg??o.infoBg};`),t.join(`
+      `)}i(w,"generateThemeVars");function x(n,e){const t=A(),r=m(f(t,"template.html"),"utf-8"),s=m(f(t,"template.css"),"utf-8"),o=m(f(t,"template.js"),"utf-8"),a=m(f(t,"vendor","marked.min.js"),"utf-8"),c=m(f(t,"vendor","highlight.min.js"),"utf-8"),u=w(e),g=y(e),l=$(g.userMessageBg||"#343541"),M=l.pageBg,E=l.cardBg,N=l.infoBg,T=Buffer.from(JSON.stringify(n)).toString("base64"),C=s.replace("{{THEME_VARS}}",u).replace("{{BODY_BG}}",M).replace("{{CONTAINER_BG}}",E).replace("{{INFO_BG}}",N);return r.replace("{{CSS}}",C).replace("{{JS}}",o).replace("{{SESSION_DATA}}",T).replace("{{MARKED_JS}}",a).replace("{{HIGHLIGHT_JS}}",c)}i(x,"generateHtml");const S=new Set(["bash","read","write","edit","ls","find","grep"]);function O(n,e){const t={};for(const r of n){if(r.type!=="message")continue;const s=r.message;if(s.role==="assistant"&&Array.isArray(s.content)){for(const o of s.content)if(o.type==="toolCall"&&!S.has(o.name)){const a=e.renderCall(o.name,o.arguments);a&&(t[o.id]={callHtml:a})}}if(s.role==="toolResult"&&s.toolCallId){const o=s.toolName||"",a=t[s.toolCallId];if(a||!S.has(o)){const c=e.renderResult(o,s.content,s.details,s.isError||!1);c&&(t[s.toolCallId]={...a,resultHtml:c})}}}return t}i(O,"preRenderCustomTools");async function k(n,e,t){const r=typeof t=="string"?{outputPath:t}:t||{},s=n.getSessionFile();if(!s)throw new Error("Cannot export in-memory session to HTML");if(!d(s))throw new Error("Nothing to export yet - start a conversation first");const o=n.getEntries();let a;r.toolRenderer&&(a=O(o,r.toolRenderer),Object.keys(a).length===0&&(a=void 0));const c={header:n.getHeader(),entries:o,leafId:n.getLeafId(),systemPrompt:e?.systemPrompt,tools:e?.tools?.map(l=>({name:l.name,description:l.description,parameters:l.parameters})),renderedTools:a},u=x(c,r.themeName);let g=r.outputPath;if(!g){const l=B(s,".jsonl");g=`${b}-session-${l}.html`}return h(g,u,"utf8"),g}i(k,"exportSessionToHtml");async function G(n,e){const t=typeof e=="string"?{outputPath:e}:e||{};if(!d(n))throw new Error(`File not found: ${n}`);const r=H.open(n),s={header:r.getHeader(),entries:r.getEntries(),leafId:r.getLeafId(),systemPrompt:void 0,tools:void 0},o=x(s,t.themeName);let a=t.outputPath;if(!a){const c=B(n,".jsonl");a=`${b}-session-${c}.html`}return h(a,o,"utf8"),a}i(G,"exportFromFile");export{G as exportFromFile,k as exportSessionToHtml};