@openlucaskaka/kagent 0.1.7 → 0.1.9

package/npm/lib/App.js

@@ -144,6 +144,7 @@ function KagentInkApp({ React, Ink, runtimeSessionFactory = runtime_client_1.cre
             const pagingLayout = (0, ui_components_1.createTerminalLayout)(terminalSize.columns, terminalSize.rows, {
                 approval: approval !== null,
                 commandMenu: status === "idle" && commandMenu ? commandMenu : false,
+                introVisible: transcript.entries.length === 0,
                 prompt: editor.value,
                 promptCursor: editor.cursor,
             });
@@ -255,6 +256,7 @@ function KagentInkApp({ React, Ink, runtimeSessionFactory = runtime_client_1.cre
         const promptLayout = (0, ui_components_1.createTerminalLayout)(terminalSize.columns, terminalSize.rows, {
             approval: approval !== null,
             commandMenu: false,
+            introVisible: transcript.entries.length === 0,
             prompt: editor.value,
             promptCursor: editor.cursor,
         });
@@ -448,6 +450,7 @@ function KagentInkApp({ React, Ink, runtimeSessionFactory = runtime_client_1.cre
             ? { ...approval, showDetails: showApprovalDetails }
             : false,
         commandMenu: status === "idle" && commandMenu ? commandMenu : false,
+        introVisible: transcript.entries.length === 0,
         prompt: editor.value,
         promptCursor: editor.cursor,
     });
@@ -459,15 +462,25 @@ function KagentInkApp({ React, Ink, runtimeSessionFactory = runtime_client_1.cre
         rows: layout.rows,
         reservedRows: layout.reservedRows + (transcriptOffset > 0 ? 1 : 0),
     }, transcriptOffset);
-    return React.createElement(Box, { flexDirection: "column", paddingX: layout.horizontalPadding }, React.createElement(ui_components_1.Header, {
-        React,
-        Box,
-        Text,
-        compact: layout.compact,
-        provider,
-        setup: false,
-        workspace: process.cwd(),
-    }), React.createElement(ui_components_1.TranscriptPosition, {
+    const promptDisabled = status === "cancelling" || status === "approval";
+    const promptCursorControl = (0, ui_components_1.createPromptTerminalCursorControl)({
+        input: editor.value,
+        cursor: editor.cursor,
+        columns: layout.promptColumns,
+        maxRows: layout.promptRowLimit,
+        horizontalPadding: layout.horizontalPadding,
+    });
+    return React.createElement(Box, { flexDirection: "column", paddingX: layout.horizontalPadding }, transcript.entries.length === 0
+        ? React.createElement(ui_components_1.Header, {
+            React,
+            Box,
+            Text,
+            compact: layout.compact,
+            provider,
+            setup: false,
+            workspace: process.cwd(),
+        })
+        : null, React.createElement(ui_components_1.TranscriptPosition, {
         React,
         Text,
         newerCount: transcriptOffset,
@@ -499,16 +512,31 @@ function KagentInkApp({ React, Ink, runtimeSessionFactory = runtime_client_1.cre
         })
         : null, status === "starting"
         ? null
-        : React.createElement(ui_components_1.PromptLine, {
+        : React.createElement(React.Fragment, null, React.createElement(ui_components_1.PromptLine, {
             React,
             Box,
             Text,
             cursor: editor.cursor,
             input: editor.value,
-            disabled: status === "cancelling" || status === "approval",
+            disabled: promptDisabled,
             columns: layout.promptColumns,
             maxRows: layout.promptRowLimit,
-        }));
+        }), React.createElement(TerminalCursorSync, {
+            React,
+            control: promptDisabled ? null : promptCursorControl,
+        })));
+}
+function TerminalCursorSync({ React, control, }) {
+    React.useLayoutEffect(() => {
+        if (!control || !process.stdout.isTTY) {
+            return undefined;
+        }
+        process.stdout.write(control.position);
+        return () => {
+            process.stdout.write(control.restore);
+        };
+    });
+    return null;
 }
 function currentTerminalSize() {
     return {

package/npm/lib/transcript.js

@@ -144,6 +144,7 @@ function selectTranscriptViewport(entries, viewport, offset = 0) {
         usedRows += rows;
         start = index;
     }
+    start = avoidOrphanedLeadingAssistant(entries, start, end, usedRows, availableRows, viewport.columns);
     return entries.slice(start, end);
 }
 function moveTranscriptViewport(entries, viewport, offset, direction) {
@@ -216,6 +217,22 @@ function retain(state) {
         : null;
     return { ...state, entries, activeAssistantId };
 }
+function avoidOrphanedLeadingAssistant(entries, start, end, usedRows, availableRows, columns) {
+    let nextStart = start;
+    let nextUsedRows = usedRows;
+    while (nextStart > 0 &&
+        nextStart < end - 1 &&
+        entries[nextStart].role === "assistant" &&
+        entries[nextStart - 1].role === "user") {
+        const userRows = estimateEntryRows(entries[nextStart - 1], columns);
+        if (nextUsedRows + userRows <= availableRows) {
+            return nextStart - 1;
+        }
+        nextUsedRows -= estimateEntryRows(entries[nextStart], columns);
+        nextStart += 1;
+    }
+    return nextStart;
+}
 function estimateEntryRows(entry, columns) {
     const contentColumns = Math.max(4, columns - 4);
     const titleRows = entry.title ? (0, terminal_width_1.estimateTextRows)(entry.title, contentColumns) : 0;

package/npm/lib/ui-components.js

@@ -4,6 +4,7 @@ exports.TERMINAL_SPINNER_FRAMES = void 0;
 exports.createTerminalLayout = createTerminalLayout;
 exports.NarrowTerminal = NarrowTerminal;
 exports.createPromptViewport = createPromptViewport;
+exports.createPromptTerminalCursorControl = createPromptTerminalCursorControl;
 exports.Header = Header;
 exports.ProviderSetupPanel = ProviderSetupPanel;
 exports.MessageList = MessageList;
@@ -24,7 +25,7 @@ function createTerminalLayout(columns, rows, overlays) {
     const compact = safeColumns < 56;
     const horizontalPadding = compact ? 0 : 1;
     const defaultCommandLimit = compact ? 4 : 6;
-    const headerRows = compact ? 2 : 3;
+    const headerRows = overlays.introVisible === false ? 0 : compact ? 2 : 3;
     const promptChromeRows = 1;
     const fixedBaseRows = headerRows + promptChromeRows;
     const approvalColumns = Math.max(4, safeColumns - horizontalPadding * 2 - (compact ? 0 : 2));
@@ -115,6 +116,18 @@ function createPromptViewport(input, cursor, columns, maxRows) {
     }
     return promptViewportParts(characters, safeCursor, start, end, preserveActiveNewline);
 }
+function createPromptTerminalCursorControl({ input, cursor, columns, maxRows, horizontalPadding, }) {
+    const viewport = createPromptViewport(input, cursor, columns, maxRows);
+    const safeColumns = Math.max(4, columns);
+    const cursorPosition = textEndPosition(viewport.before, safeColumns);
+    const promptRows = (0, terminal_width_1.estimateTextRows)(viewport.rendered, safeColumns);
+    const up = Math.max(1, promptRows - cursorPosition.row);
+    const right = Math.max(0, horizontalPadding + 2 + cursorPosition.column);
+    return {
+        position: `${showTerminalCursor()}${moveCursorUp(up)}${moveCursorRight(right)}`,
+        restore: `\r${moveCursorDown(up)}`,
+    };
+}
 function promptViewportRows(characters, cursor, start, end, columns, preserveActiveNewline) {
     return (0, terminal_width_1.estimateTextRows)(promptViewportParts(characters, cursor, start, end, preserveActiveNewline).rendered, columns);
 }
@@ -136,6 +149,38 @@ function promptViewportParts(characters, cursor, start, end, preserveActiveNewli
         suffixClipped,
     };
 }
+function textEndPosition(text, columns) {
+    let row = 0;
+    let column = 0;
+    for (const grapheme of (0, editor_1.splitGraphemes)(text)) {
+        if (grapheme === "\n") {
+            row += 1;
+            column = 0;
+            continue;
+        }
+        const width = Math.max(0, (0, terminal_text_1.terminalGraphemeWidth)(grapheme));
+        if (column + width >= columns) {
+            row += 1;
+            column = 0;
+        }
+        else {
+            column += width;
+        }
+    }
+    return { row, column };
+}
+function showTerminalCursor() {
+    return "\u001b[?25h";
+}
+function moveCursorUp(rows) {
+    return rows > 0 ? `\u001b[${rows}A` : "";
+}
+function moveCursorDown(rows) {
+    return rows > 0 ? `\u001b[${rows}B` : "";
+}
+function moveCursorRight(columns) {
+    return columns > 0 ? `\u001b[${columns}C` : "";
+}
 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)}` : ""}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlucaskaka/kagent",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Codex-style LangGraph agent runtime for internal non-coding workflows.",
   "license": "UNLICENSED",
   "bin": {

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kagent"
-version = "0.1.7"
+version = "0.1.9"
 description = "A bounded kagent built with LangGraph."
 readme = "README.md"
 requires-python = ">=3.9"

package/src/kagent/__init__.py

@@ -22,7 +22,7 @@ def _source_tree_version() -> str:
 try:
     __version__ = _source_tree_version() or version("kagent")
 except PackageNotFoundError:
-    __version__ = "0.1.7"
+    __version__ = "0.1.9"
 
 __all__ = [
     "AgentConfig",

package/src/kagent/runtime/tools.py

@@ -128,6 +128,10 @@ _EMBEDDING_RETRY_BACKOFF_ENV_VAR = "KAGENT_EMBEDDING_RETRY_BACKOFF_SECONDS"
 _EXTERNAL_BACKEND_TIMEOUT_ENV_VAR = "KAGENT_EXTERNAL_BACKEND_TIMEOUT_SECONDS"
 _APP_NAME_MAX_LENGTH = 120
 _APP_NAME_ALLOWED_PATTERN = re.compile(r"^[\w .+()#&-]+$", re.UNICODE)
+_APP_NAME_ALIASES = {
+    "飞书": "Feishu",
+    "feishu": "Feishu",
+}
 _OPEN_COMMAND_TIMEOUT_SECONDS = 10.0
 
 
@@ -3005,24 +3009,47 @@ def _open_app(input_payload: Dict[str, Any]) -> Dict[str, Any]:
     if not isinstance(application, str) or not application.strip():
         raise ValueError("application must be a non-empty string")
     normalized_application = " ".join(application.strip().split())
+    normalized_application = _APP_NAME_ALIASES.get(
+        normalized_application.casefold(),
+        normalized_application,
+    )
     _validate_open_app_name(normalized_application)
-    try:
-        subprocess.run(
-            ["open", "-a", normalized_application],
-            check=True,
-            capture_output=True,
-            text=True,
-            timeout=_OPEN_COMMAND_TIMEOUT_SECONDS,
-        )
-    except subprocess.TimeoutExpired as exc:
-        raise TimeoutError("open app command timed out") from exc
-    except (OSError, subprocess.CalledProcessError) as exc:
-        raise ValueError("open app failed") from exc
-    return {
-        "application": normalized_application,
-        "opened": True,
-        "command": "open -a",
-    }
+    attempts = [
+        (
+            ["osascript", "-e", _app_frontmost_script(normalized_application)],
+            "osascript frontmost",
+        ),
+        (["open", "-a", normalized_application], "open -a"),
+    ]
+    last_error: BaseException | None = None
+    for command_args, command_label in attempts:
+        try:
+            subprocess.run(
+                command_args,
+                check=True,
+                capture_output=True,
+                text=True,
+                timeout=_OPEN_COMMAND_TIMEOUT_SECONDS,
+            )
+            return {
+                "application": normalized_application,
+                "opened": True,
+                "command": command_label,
+            }
+        except subprocess.TimeoutExpired as exc:
+            raise TimeoutError("open app command timed out") from exc
+        except (OSError, subprocess.CalledProcessError) as exc:
+            last_error = exc
+            continue
+    raise ValueError("open app failed") from last_error
+
+
+def _app_frontmost_script(application: str) -> str:
+    escaped = application.replace("\\", "\\\\").replace('"', '\\"')
+    return (
+        'tell application "System Events" to set frontmost of '
+        f'first application process whose name is "{escaped}" to true'
+    )
 
 
 def _validate_open_app_name(application: str) -> None:

package/src/kagent/service/contract.py

@@ -42,7 +42,7 @@ def service_openapi() -> Dict[str, Any]:
         "openapi": "3.1.0",
         "info": {
             "title": "kagent API",
-            "version": "0.1.7",
+            "version": "0.1.9",
         },
         "components": {
             "securitySchemes": {