@openlucaskaka/kagent 0.1.7

package/npm/lib/transcript.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTranscriptState = createTranscriptState;
+exports.transcriptReducer = transcriptReducer;
+exports.progressTranscriptAction = progressTranscriptAction;
+exports.selectTranscriptViewport = selectTranscriptViewport;
+exports.moveTranscriptViewport = moveTranscriptViewport;
+exports.clampTranscriptOffset = clampTranscriptOffset;
+const terminal_width_1 = require("./terminal-width");
+function createTranscriptState(maxEntries = 100) {
+    return {
+        entries: [],
+        activeAssistantId: null,
+        nextId: 1,
+        maxEntries: Math.max(1, maxEntries),
+    };
+}
+function transcriptReducer(state, action) {
+    if (action.type === "user_submitted") {
+        return appendEntry(state, "user", action.text, "complete");
+    }
+    if (action.type === "command_completed") {
+        const base = action.clear ? { ...state, entries: [], activeAssistantId: null } : state;
+        return appendEntry(base, "command", action.text, "complete", action.title);
+    }
+    if (action.type === "assistant_started") {
+        if (state.activeAssistantId) {
+            return state;
+        }
+        const next = appendEntry(state, "assistant", "", "streaming");
+        return { ...next, activeAssistantId: next.entries.at(-1)?.id || null };
+    }
+    if (action.type === "assistant_delta") {
+        const started = state.activeAssistantId
+            ? state
+            : transcriptReducer(state, { type: "assistant_started" });
+        return updateActiveAssistant(started, (entry) => ({
+            ...entry,
+            text: entry.text + action.text,
+            status: "streaming",
+        }));
+    }
+    if (action.type === "assistant_completed") {
+        const status = action.outcome === "cancelled" ? "cancelled" : "complete";
+        if (state.activeAssistantId) {
+            const completed = updateActiveAssistant(state, (entry) => ({
+                ...entry,
+                text: action.text || entry.text,
+                status,
+            }));
+            return { ...completed, activeAssistantId: null };
+        }
+        const last = state.entries.at(-1);
+        if (last?.role === "assistant" && last.text === action.text && last.status === status) {
+            return state;
+        }
+        return appendEntry(state, "assistant", action.text, status);
+    }
+    if (action.type === "result_completed") {
+        const entry = {
+            id: `m-${state.nextId}`,
+            role: "command",
+            status: "complete",
+            text: "",
+            title: action.title,
+            ...(action.detail ? { detail: action.detail } : {}),
+            ...(action.content ? { content: action.content, expanded: false } : {}),
+        };
+        return retain({
+            ...state,
+            entries: state.entries.concat(entry),
+            nextId: state.nextId + 1,
+        });
+    }
+    if (action.type === "toggle_latest_result") {
+        let index = -1;
+        for (let candidate = state.entries.length - 1; candidate >= 0; candidate -= 1) {
+            if (state.entries[candidate].content) {
+                index = candidate;
+                break;
+            }
+        }
+        if (index < 0) {
+            return state;
+        }
+        return {
+            ...state,
+            entries: state.entries.map((entry, entryIndex) => entryIndex === index ? { ...entry, expanded: !entry.expanded } : entry),
+        };
+    }
+    return appendEntry(state, "system", action.text, "error");
+}
+function progressTranscriptAction(event) {
+    const type = String(event.type || "");
+    if (type === "answer_started") {
+        return { type: "assistant_started" };
+    }
+    if (type === "answer_delta") {
+        return { type: "assistant_delta", text: String(event.delta ?? event.text ?? "") };
+    }
+    if (type === "answer_completed") {
+        return {
+            type: "assistant_completed",
+            text: String(event.answer ?? event.text ?? ""),
+            outcome: "complete",
+        };
+    }
+    if (type === "tool_completed") {
+        const presentation = event.presentation;
+        if (!presentation || typeof presentation !== "object") {
+            return null;
+        }
+        const payload = presentation;
+        const title = String(payload.title || "").trim();
+        if (!title) {
+            return null;
+        }
+        const detail = String(payload.detail || "").trim();
+        return {
+            type: "result_completed",
+            title,
+            detail: payload.truncated === true
+                ? [detail, "truncated"].filter(Boolean).join(" · ")
+                : detail,
+            content: String(payload.content || "").trim(),
+        };
+    }
+    return null;
+}
+function selectTranscriptViewport(entries, viewport, offset = 0) {
+    if (entries.length === 0) {
+        return [];
+    }
+    const availableRows = Math.max(1, viewport.rows - (viewport.reservedRows ?? 0));
+    const safeOffset = clampTranscriptOffset(entries, offset);
+    const end = entries.length - safeOffset;
+    let usedRows = 0;
+    let start = end - 1;
+    for (let index = end - 1; index >= 0; index -= 1) {
+        const rows = estimateEntryRows(entries[index], viewport.columns);
+        if (usedRows > 0 && usedRows + rows > availableRows) {
+            break;
+        }
+        usedRows += rows;
+        start = index;
+    }
+    return entries.slice(start, end);
+}
+function moveTranscriptViewport(entries, viewport, offset, direction) {
+    if (entries.length === 0) {
+        return 0;
+    }
+    const safeOffset = clampTranscriptOffset(entries, offset);
+    const pageOffsets = transcriptPageOffsets(entries, viewport);
+    if (direction === "older") {
+        return pageOffsets.find((pageOffset) => pageOffset > safeOffset)
+            ?? pageOffsets.at(-1)
+            ?? 0;
+    }
+    for (let index = pageOffsets.length - 1; index >= 0; index -= 1) {
+        if (pageOffsets[index] < safeOffset) {
+            return pageOffsets[index];
+        }
+    }
+    return 0;
+}
+function clampTranscriptOffset(entries, offset) {
+    if (entries.length === 0) {
+        return 0;
+    }
+    return Math.min(Math.max(Math.trunc(offset), 0), entries.length - 1);
+}
+function transcriptPageOffsets(entries, viewport) {
+    const offsets = [0];
+    while (offsets.at(-1) < entries.length - 1) {
+        const current = offsets.at(-1);
+        const visibleCount = Math.max(1, selectTranscriptViewport(entries, viewport, current).length);
+        const next = clampTranscriptOffset(entries, current + visibleCount);
+        if (next === current) {
+            break;
+        }
+        offsets.push(next);
+    }
+    return offsets;
+}
+function appendEntry(state, role, text, status, title) {
+    const entry = {
+        id: `m-${state.nextId}`,
+        role,
+        status,
+        text,
+        ...(title ? { title } : {}),
+    };
+    return retain({
+        ...state,
+        entries: state.entries.concat(entry),
+        nextId: state.nextId + 1,
+    });
+}
+function updateActiveAssistant(state, update) {
+    if (!state.activeAssistantId) {
+        return state;
+    }
+    return {
+        ...state,
+        entries: state.entries.map((entry) => entry.id === state.activeAssistantId ? update(entry) : entry),
+    };
+}
+function retain(state) {
+    if (state.entries.length <= state.maxEntries) {
+        return state;
+    }
+    const entries = state.entries.slice(-state.maxEntries);
+    const activeAssistantId = entries.some((entry) => entry.id === state.activeAssistantId)
+        ? state.activeAssistantId
+        : null;
+    return { ...state, entries, activeAssistantId };
+}
+function estimateEntryRows(entry, columns) {
+    const contentColumns = Math.max(4, columns - 4);
+    const titleRows = entry.title ? (0, terminal_width_1.estimateTextRows)(entry.title, contentColumns) : 0;
+    const detailRows = entry.detail ? (0, terminal_width_1.estimateTextRows)(entry.detail, contentColumns) : 0;
+    const contentRows = entry.expanded && entry.content
+        ? (0, terminal_width_1.estimateTextRows)(entry.content, contentColumns)
+        : 0;
+    return Math.max(1, titleRows + detailRows + contentRows + (0, terminal_width_1.estimateTextRows)(entry.text, contentColumns)) + 1;
+}

package/npm/lib/ui-components.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TERMINAL_SPINNER_FRAMES = void 0;
+exports.createTerminalLayout = createTerminalLayout;
+exports.NarrowTerminal = NarrowTerminal;
+exports.createPromptViewport = createPromptViewport;
+exports.Header = Header;
+exports.ProviderSetupPanel = ProviderSetupPanel;
+exports.MessageList = MessageList;
+exports.TranscriptPosition = TranscriptPosition;
+exports.ApprovalPanel = ApprovalPanel;
+exports.CommandPalette = CommandPalette;
+exports.StatusLine = StatusLine;
+exports.PromptLine = PromptLine;
+const editor_1 = require("./editor");
+const provider_setup_1 = require("./provider-setup");
+const terminal_text_1 = require("./terminal-text");
+const terminal_width_1 = require("./terminal-width");
+exports.TERMINAL_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+function createTerminalLayout(columns, rows, overlays) {
+    const safeColumns = Math.max(1, columns || 80);
+    const safeRows = Math.max(10, rows || 24);
+    const tooNarrow = safeColumns < 20;
+    const compact = safeColumns < 56;
+    const horizontalPadding = compact ? 0 : 1;
+    const defaultCommandLimit = compact ? 4 : 6;
+    const headerRows = compact ? 2 : 3;
+    const promptChromeRows = 1;
+    const fixedBaseRows = headerRows + promptChromeRows;
+    const approvalColumns = Math.max(4, safeColumns - horizontalPadding * 2 - (compact ? 0 : 2));
+    const approvalRows = estimateApprovalRows(overlays.approval, approvalColumns);
+    const commandColumns = Math.max(4, safeColumns - horizontalPadding * 2 - (compact ? 0 : 2));
+    const commandExtraRows = estimateCommandExtraRows(overlays.commandMenu, compact, commandColumns);
+    const commandCapacity = Math.max(1, safeRows - 1 - fixedBaseRows - 1 - commandExtraRows - approvalRows);
+    const commandLimit = overlays.commandMenu
+        ? Math.min(defaultCommandLimit, commandCapacity)
+        : defaultCommandLimit;
+    const promptColumns = Math.max(4, safeColumns - horizontalPadding * 2 - 2);
+    const visibleCommandRows = overlays.commandMenu && overlays.commandMenu !== true
+        ? Math.min(commandLimit, overlays.commandMenu.options.length)
+        : commandLimit;
+    const commandRows = overlays.commandMenu
+        ? visibleCommandRows + commandExtraRows
+        : 0;
+    const promptRowLimit = Math.max(1, Math.min(compact ? 4 : 6, safeRows - 1 - fixedBaseRows - approvalRows - commandRows));
+    const promptRows = overlays.prompt === undefined
+        ? 1
+        : (0, terminal_width_1.estimateTextRows)(createPromptViewport(overlays.prompt, overlays.promptCursor ?? (0, editor_1.splitGraphemes)(overlays.prompt).length, promptColumns, promptRowLimit).rendered, promptColumns);
+    const baseRows = fixedBaseRows + promptRows;
+    return {
+        columns: safeColumns,
+        rows: safeRows,
+        compact,
+        tooNarrow,
+        horizontalPadding,
+        commandLimit,
+        promptColumns,
+        promptRowLimit,
+        reservedRows: Math.min(safeRows - 1, baseRows + approvalRows + commandRows),
+    };
+}
+function NarrowTerminal({ React, Box, Text, }) {
+    return React.createElement(Box, { flexDirection: "column" }, React.createElement(Text, { bold: true, color: "cyan" }, "kagent"), React.createElement(Text, { color: "gray", wrap: "wrap" }, "widen terminal"));
+}
+function estimateApprovalRows(approval, columns) {
+    if (!approval) {
+        return 0;
+    }
+    if (approval === true) {
+        return 8;
+    }
+    const rows = (value) => value ? (0, terminal_width_1.estimateTextRows)(value, columns) : 0;
+    const detailRows = approval.showDetails
+        ? (approval.details ?? []).reduce((total, detail) => total + rows(`  ${detail}`), 0)
+        : 0;
+    const detailMarginRows = approval.showDetails && approval.details?.length ? 1 : 0;
+    const reasonRows = approval.showDetails ? rows(approval.reason) : 0;
+    return (5 +
+        rows(approval.title) +
+        rows(approval.target) +
+        rows("←→ select · enter confirm · d details") +
+        detailMarginRows +
+        detailRows +
+        reasonRows);
+}
+function estimateCommandExtraRows(menu, compact, columns) {
+    if (!menu) {
+        return 0;
+    }
+    if (menu === true) {
+        return compact ? 3 : 2;
+    }
+    const helpRows = (0, terminal_width_1.estimateTextRows)("↑↓ choose · tab complete · enter run", columns);
+    const selected = menu.options[menu.selectedIndex];
+    const descriptionRows = compact && selected
+        ? (0, terminal_width_1.estimateTextRows)(`  ${selected.description}`, columns)
+        : 0;
+    return 1 + helpRows + descriptionRows;
+}
+function createPromptViewport(input, cursor, columns, maxRows) {
+    const characters = (0, editor_1.splitGraphemes)(input);
+    const safeCursor = Math.min(Math.max(cursor, 0), characters.length);
+    const safeColumns = Math.max(4, columns);
+    const safeRows = Math.max(1, maxRows);
+    const preserveActiveNewline = safeRows > 1;
+    let start = safeCursor;
+    let end = Math.min(characters.length, safeCursor + 1);
+    while (start > 0 &&
+        promptViewportRows(characters, safeCursor, start - 1, end, safeColumns, preserveActiveNewline) <= safeRows) {
+        start -= 1;
+    }
+    while (end < characters.length &&
+        promptViewportRows(characters, safeCursor, start, end + 1, safeColumns, preserveActiveNewline) <= safeRows) {
+        end += 1;
+    }
+    return promptViewportParts(characters, safeCursor, start, end, preserveActiveNewline);
+}
+function promptViewportRows(characters, cursor, start, end, columns, preserveActiveNewline) {
+    return (0, terminal_width_1.estimateTextRows)(promptViewportParts(characters, cursor, start, end, preserveActiveNewline).rendered, columns);
+}
+function promptViewportParts(characters, cursor, start, end, preserveActiveNewline) {
+    const prefixClipped = start > 0;
+    const suffixClipped = end < characters.length;
+    const rawActive = characters[cursor] || " ";
+    const active = rawActive === "\n" ? (preserveActiveNewline ? " " : "↵") : rawActive;
+    const before = `${prefixClipped ? "…" : ""}${characters
+        .slice(start, cursor)
+        .join("")}`;
+    const after = `${rawActive === "\n" && preserveActiveNewline ? "\n" : ""}${characters.slice(cursor + 1, end).join("")}${suffixClipped ? "…" : ""}`;
+    return {
+        before,
+        active,
+        after,
+        rendered: `${before}${active}${after}`,
+        prefixClipped,
+        suffixClipped,
+    };
+}
+function Header({ React, Box, Text, compact, provider, setup, workspace, }) {
+    const providerLabel = provider?.configured
+        ? `${(0, terminal_text_1.terminalSafeText)(provider.display_name)}${provider.model ? ` · ${(0, terminal_text_1.terminalSafeText)(provider.model)}` : ""}`
+        : "";
+    const safeWorkspace = (0, terminal_text_1.terminalSafeText)(workspace);
+    if (compact) {
+        const compactContext = setup ? "  setup" : ` · ${providerLabel || "local"}`;
+        return React.createElement(Box, { flexDirection: "row", marginBottom: 1, flexShrink: 1 }, React.createElement(Text, { bold: true, color: "cyan" }, "◆ kagent"), React.createElement(Text, { color: "gray", wrap: "truncate" }, compactContext));
+    }
+    const sessionLabel = [safeWorkspace, providerLabel].filter(Boolean).join(" · ") || "local session";
+    return React.createElement(Box, { flexDirection: "column", marginBottom: 1 }, React.createElement(Box, { flexDirection: "row", flexShrink: 0 }, React.createElement(Text, { bold: true, color: "cyan" }, "◆ kagent"), React.createElement(Text, { color: "gray" }, setup ? "  setup" : "")), React.createElement(Text, { color: "gray", wrap: "truncate" }, sessionLabel));
+}
+function ProviderSetupPanel({ React, Box, Text, frame, setup, }) {
+    const option = (0, provider_setup_1.selectedProvider)(setup);
+    if (setup.stage === "provider") {
+        return React.createElement(Box, { flexDirection: "column" }, React.createElement(Text, { bold: true }, "Connect a model provider"), React.createElement(Box, { flexDirection: "column", marginTop: 1 }, ...setup.options.map((candidate, index) => React.createElement(Text, {
+            key: candidate.provider,
+            bold: index === setup.selectedIndex,
+            color: index === setup.selectedIndex ? "cyan" : undefined,
+        }, `${index === setup.selectedIndex ? "›" : " "} ${candidate.label}`))), React.createElement(Text, { color: "gray" }, "↑↓ choose  enter continue  esc quit"));
+    }
+    if (setup.stage === "saving") {
+        return React.createElement(Box, { flexDirection: "column" }, React.createElement(Text, { bold: true }, `Connect ${option.label}`), React.createElement(Text, { color: "cyan" }, `${exports.TERMINAL_SPINNER_FRAMES[frame]} Saving settings`));
+    }
+    const field = setupField(setup);
+    const displayValue = setup.stage === "api_key" ? (0, provider_setup_1.maskSecret)(setup.editor.value) : setup.editor.value;
+    return React.createElement(Box, { flexDirection: "column" }, React.createElement(Text, { bold: true }, `Connect ${option.label}`), React.createElement(Text, { color: "gray", bold: true }, field.label), React.createElement(PromptLine, {
+        React,
+        Box,
+        Text,
+        cursor: setup.editor.cursor,
+        input: displayValue,
+        disabled: false,
+        placeholder: field.placeholder,
+        compact: true,
+    }), setup.error ? React.createElement(Text, { color: "red", wrap: "wrap" }, setup.error) : null, React.createElement(Text, { color: "gray" }, "enter continue  esc back"));
+}
+function MessageList({ React, Box, Text, messages, }) {
+    return React.createElement(Box, { flexDirection: "column" }, ...messages.map((message) => {
+        const marker = message.role === "user" ? "›" : message.role === "assistant" ? "•" : message.role === "command" ? "·" : "!";
+        const color = message.role === "user" ? "cyan" : message.role === "system" ? "red" : message.role === "command" ? "gray" : undefined;
+        return React.createElement(Box, { key: message.id, flexDirection: "row", marginBottom: 1 }, React.createElement(Text, { color, bold: message.role === "user" }, `${marker} `), React.createElement(Box, { flexDirection: "column", flexGrow: 1, flexShrink: 1 }, message.title ? React.createElement(Text, { bold: true, color }, message.title) : null, message.detail
+            ? React.createElement(Text, { color: "gray", wrap: "wrap" }, message.detail)
+            : null, message.text
+            ? React.createElement(Text, { color, wrap: "wrap" }, message.text)
+            : null, message.expanded && message.content
+            ? React.createElement(Text, { color: "gray", wrap: "wrap" }, message.content)
+            : null));
+    }));
+}
+function TranscriptPosition({ React, Text, newerCount, }) {
+    if (newerCount <= 0) {
+        return null;
+    }
+    return React.createElement(Text, { color: "gray" }, `History · ${newerCount} newer`);
+}
+function ApprovalPanel({ React, Box, Text, approval, choice, compact, showDetails, }) {
+    return React.createElement(Box, { flexDirection: "column", marginY: 1, paddingLeft: compact ? 0 : 2 }, React.createElement(Text, { bold: true, color: "yellow" }, "Permission required"), React.createElement(Text, { wrap: "wrap" }, approval.title), approval.target ? React.createElement(Text, { color: "cyan", wrap: "wrap" }, approval.target) : null, showDetails && approval.details?.length
+        ? React.createElement(Box, { flexDirection: "column", marginTop: 1 }, ...approval.details.map((detail, index) => React.createElement(Text, { key: `${index}-${detail}`, color: "cyan", wrap: "wrap" }, `  ${detail}`)))
+        : null, showDetails && approval.reason
+        ? React.createElement(Text, { color: "gray", wrap: "wrap" }, approval.reason)
+        : null, React.createElement(Box, { flexDirection: "row", marginTop: 1 }, React.createElement(Text, { bold: choice === "allow", color: choice === "allow" ? "cyan" : "gray" }, `${choice === "allow" ? "›" : " "} Allow once`), React.createElement(Text, {
+        bold: choice === "deny",
+        color: choice === "deny" ? "yellow" : "gray",
+    }, `${compact ? "  " : "    "}${choice === "deny" ? "›" : " "} Deny`)), React.createElement(Text, { color: "gray" }, "←→ select · enter confirm · d details"));
+}
+function CommandPalette({ React, Box, Text, compact, limit, menu, }) {
+    const visibleStart = Math.min(Math.max(menu.selectedIndex - limit + 1, 0), Math.max(menu.options.length - limit, 0));
+    const visibleOptions = menu.options.slice(visibleStart, visibleStart + limit);
+    return React.createElement(Box, { flexDirection: "column", paddingLeft: compact ? 0 : 2, marginTop: 1 }, ...visibleOptions.map((option, index) => {
+        const selected = visibleStart + index === menu.selectedIndex;
+        return React.createElement(Box, { key: option.command, flexDirection: compact ? "column" : "row" }, React.createElement(Text, {
+            bold: selected,
+            color: selected ? "cyan" : "gray",
+            wrap: "truncate",
+        }, `${selected ? "›" : " "} ${option.command}`), compact
+            ? selected
+                ? React.createElement(Text, { color: "gray", wrap: "wrap" }, `  ${option.description}`)
+                : null
+            : React.createElement(Text, { color: "gray", wrap: "truncate" }, `  ${option.description}`));
+    }), React.createElement(Text, { color: "gray" }, "↑↓ choose · tab complete · enter run"));
+}
+function StatusLine({ React, Text, frame, elapsedSeconds, status, statusText, }) {
+    if (status !== "thinking" && status !== "cancelling" && status !== "starting") {
+        return null;
+    }
+    const label = status === "starting" ? "Starting runtime" : statusText;
+    const elapsed = elapsedSeconds > 0 ? ` · ${elapsedSeconds}s` : "";
+    return React.createElement(Text, { color: "cyan" }, `${exports.TERMINAL_SPINNER_FRAMES[frame]} ${label}${elapsed}`);
+}
+function PromptLine({ React, Box, Text, cursor, disabled, input, placeholder = "Ask kagent", compact = false, columns = 80, maxRows = 6, }) {
+    const viewport = createPromptViewport(input, cursor, columns, maxRows);
+    return React.createElement(Box, { flexDirection: "row", marginTop: compact ? 0 : 1, alignItems: "flex-start" }, React.createElement(Text, { color: disabled ? "gray" : "cyan" }, "› "), input
+        ? React.createElement(Text, { wrap: "wrap" }, viewport.before, React.createElement(Text, { inverse: !disabled }, viewport.active), viewport.after)
+        : React.createElement(Text, { color: "gray" }, disabled ? "" : placeholder));
+}
+function setupField(setup) {
+    if (setup.stage === "base_url") {
+        return { label: "Base URL", placeholder: "https://api.example.com/v1" };
+    }
+    if (setup.stage === "model") {
+        return { label: "Model", placeholder: "model-id" };
+    }
+    const required = (0, provider_setup_1.selectedProvider)(setup).api_key_required;
+    return {
+        label: required ? "API key" : "API key (optional)",
+        placeholder: required ? "Paste API key" : "Leave empty for local providers",
+    };
+}