@agentick/tui 0.2.1

package/README.md

@@ -0,0 +1,167 @@
+# @agentick/tui
+
+Terminal UI for Agentick agents. Uses [Ink](https://github.com/vadimdemedes/ink) (React for CLIs) with `@agentick/react` hooks — same hooks, same streaming, different renderer.
+
+## Installation
+
+```sh
+pnpm add @agentick/tui
+```
+
+## Quick Start
+
+### Local Agent
+
+```typescript
+import { createApp, Model, Timeline, Section } from "@agentick/core";
+import { openai } from "@agentick/openai";
+import { createTUI } from "@agentick/tui";
+
+function MyAgent() {
+  return (
+    <>
+      <Model model={openai({ model: "gpt-4o-mini" })} />
+      <Section id="system" audience="model">
+        You are a helpful assistant.
+      </Section>
+      <Timeline />
+    </>
+  );
+}
+
+const app = createApp(MyAgent);
+createTUI({ app }).start();
+```
+
+### Remote Agent
+
+Connect to an Agentick gateway over HTTP/SSE:
+
+```typescript
+import { createTUI } from "@agentick/tui";
+
+createTUI({ url: "https://my-agent.fly.dev/api" }).start();
+```
+
+### Custom UI
+
+Replace the default chat interface with your own Ink component:
+
+```typescript
+import { createTUI } from "@agentick/tui";
+import { MyDashboard } from "./dashboard.js";
+
+createTUI({ app, ui: MyDashboard }).start();
+```
+
+## CLI
+
+The `agentick-tui` binary launches a TUI from the command line.
+
+```sh
+# Local app (file exporting an App instance)
+agentick-tui --app ./my-app.ts
+
+# Remote gateway
+agentick-tui --url https://my-agent.fly.dev/api
+
+# With session ID
+agentick-tui --url https://my-agent.fly.dev/api --session my-session
+
+# Custom terminal UI
+agentick-tui --app ./my-app.ts --ui ./dashboard.tsx
+agentick-tui --app ./my-app.ts --ui ./dashboard.tsx --ui-export MonitorDashboard
+```
+
+**Dev (from repo root):**
+
+```sh
+pnpm tui -- --url http://localhost:3000/api --session default
+```
+
+### CLI Options
+
+| Flag                 | Description                                              |
+| -------------------- | -------------------------------------------------------- |
+| `--app <path>`       | Path to a file exporting an `App` instance               |
+| `--export <name>`    | Named export to use (default: auto-detect)               |
+| `--url <url>`        | Remote gateway URL (include the mount path, e.g. `/api`) |
+| `--session <id>`     | Session ID (default: `"main"`)                           |
+| `--ui <name\|path>`  | Built-in UI name or path to custom UI file               |
+| `--ui-export <name>` | Named export from custom UI file                         |
+
+### Built-in UIs
+
+| Name   | Description                                |
+| ------ | ------------------------------------------ |
+| `chat` | Default conversational interface (default) |
+
+## API
+
+### createTUI(options)
+
+Returns `{ start(): Promise<void> }`.
+
+**Local options:**
+
+| Option      | Type           | Description                           |
+| ----------- | -------------- | ------------------------------------- |
+| `app`       | `App`          | Agentick App instance                 |
+| `sessionId` | `string`       | Session ID (default: `"main"`)        |
+| `ui`        | `TUIComponent` | Custom UI component (default: `Chat`) |
+
+**Remote options:**
+
+| Option      | Type           | Description                           |
+| ----------- | -------------- | ------------------------------------- |
+| `url`       | `string`       | Gateway URL                           |
+| `token`     | `string`       | Auth token                            |
+| `sessionId` | `string`       | Session ID (default: `"main"`)        |
+| `ui`        | `TUIComponent` | Custom UI component (default: `Chat`) |
+
+### TUIComponent
+
+Any React component that accepts `{ sessionId: string }`:
+
+```typescript
+import type { TUIComponent } from "@agentick/tui";
+
+const MyUI: TUIComponent = ({ sessionId }) => {
+  const { messages, status } = useSession(sessionId);
+  // ... Ink components
+};
+```
+
+## Components
+
+All components are exported for building custom UIs.
+
+| Component                | Purpose                                           |
+| ------------------------ | ------------------------------------------------- |
+| `Chat`                   | Default chat UI (built-in)                        |
+| `MessageList`            | Completed messages (Ink `<Static>`)               |
+| `StreamingMessage`       | Live streaming response with cursor               |
+| `ToolCallIndicator`      | Spinner during tool execution                     |
+| `ToolConfirmationPrompt` | Y/N/A prompt for tools with `requireConfirmation` |
+| `ErrorDisplay`           | Error box with optional dismiss                   |
+| `InputBar`               | Text input, disabled while streaming              |
+
+## Architecture
+
+The TUI reuses `@agentick/react` hooks unchanged. Ink is React for terminals, so the same `useSession`, `useStreamingText`, and `useEvents` hooks work in both browser and terminal.
+
+For local agents, `createLocalTransport` (from `@agentick/core`) bridges the in-process `App` to the `ClientTransport` interface. The TUI components don't know or care about local vs remote.
+
+```
+createTUI({ app })
+  → createLocalTransport(app) → ClientTransport
+  → createClient({ transport })
+  → AgentickProvider + Ink components
+  → useSession, useStreamingText, useEvents (same as web)
+```
+
+For remote agents, the client uses HTTP/SSE to connect to the gateway. An `eventsource` polyfill is included for Node.js environments where `globalThis.EventSource` is not available.
+
+### Ink + React 19
+
+Ink 5 bundles `react-reconciler@0.29`, which is incompatible with React 19. The monorepo applies a patch (`patches/ink@5.2.1.patch`) and overrides the reconciler to `0.31.0`. See `patches/README.md` for details.

package/dist/bin.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI binary for launching the Agentick TUI.
+ *
+ * Usage:
+ *   agentick-tui --app path/to/app.ts
+ *   agentick-tui --app path/to/app.ts --export myApp
+ *   agentick-tui --app path/to/app.ts --ui ./dashboard.tsx --ui-export MonitorDashboard
+ *   agentick-tui --url https://my-app.fly.dev/api --session my-session
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/bin.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+/**
+ * CLI binary for launching the Agentick TUI.
+ *
+ * Usage:
+ *   agentick-tui --app path/to/app.ts
+ *   agentick-tui --app path/to/app.ts --export myApp
+ *   agentick-tui --app path/to/app.ts --ui ./dashboard.tsx --ui-export MonitorDashboard
+ *   agentick-tui --url https://my-app.fly.dev/api --session my-session
+ */
+import * as path from "node:path";
+import { createTUI } from "./create-tui.js";
+import { builtinUIs } from "./ui/index.js";
+function parseArgs(argv) {
+    const args = {};
+    const positional = argv.slice(2);
+    for (let i = 0; i < positional.length; i++) {
+        const arg = positional[i];
+        const next = positional[i + 1];
+        switch (arg) {
+            case "--app":
+                args.app = next;
+                i++;
+                break;
+            case "--export":
+                args.export = next;
+                i++;
+                break;
+            case "--url":
+                args.url = next;
+                i++;
+                break;
+            case "--session":
+                args.session = next;
+                i++;
+                break;
+            case "--ui":
+                args.ui = next;
+                i++;
+                break;
+            case "--ui-export":
+                args.uiExport = next;
+                i++;
+                break;
+            case "--help":
+            case "-h":
+                args.help = true;
+                break;
+        }
+    }
+    return args;
+}
+function printUsage() {
+    console.log(`
+agentick-tui — Launch an Agentick app in the terminal
+
+Usage:
+  agentick-tui --app <path>     Load app from a local file
+  agentick-tui --url <url>      Connect to a remote app
+
+Options:
+  --app <path>        Path to a file exporting an App instance
+  --export <name>     Named export to use (default: auto-detect)
+  --url <url>         Remote gateway URL
+  --session <id>      Session ID (default: "main")
+  --ui <name|path>    Built-in UI name or path to custom UI file (default: "chat")
+  --ui-export <name>  Named export from custom UI file (default: auto-detect)
+  --help, -h          Show this help
+
+Built-in UIs:
+  chat                Default conversational interface
+  `.trim());
+}
+// ============================================================================
+// Type guards
+// ============================================================================
+function isApp(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "send" in value &&
+        typeof value.send === "function");
+}
+function isComponent(value) {
+    return typeof value === "function";
+}
+// ============================================================================
+// Module helpers
+// ============================================================================
+/** Load a module by file path, exit on failure. */
+async function loadModule(filePath) {
+    const resolved = path.resolve(process.cwd(), filePath);
+    try {
+        return await import(resolved);
+    }
+    catch (err) {
+        console.error(`Error loading module from ${resolved}:`);
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+}
+/**
+ * Scan a module for an export matching a predicate.
+ * Tries well-known names first, then scans all exports.
+ */
+function findExport(mod, check, wellKnownNames) {
+    for (const name of wellKnownNames) {
+        const exported = mod[name];
+        if (check(exported))
+            return exported;
+    }
+    for (const value of Object.values(mod)) {
+        if (check(value))
+            return value;
+    }
+    return undefined;
+}
+// ============================================================================
+// App resolution
+// ============================================================================
+/** Find an App instance in a module. */
+function findApp(mod, exportName) {
+    if (exportName) {
+        const exported = mod[exportName];
+        if (exported === undefined) {
+            throw new Error(`Export "${exportName}" not found in module`);
+        }
+        if (!isApp(exported)) {
+            throw new Error(`Export "${exportName}" does not appear to be an App (no .send method)`);
+        }
+        return exported;
+    }
+    const app = findExport(mod, isApp, ["app", "default"]);
+    if (app)
+        return app;
+    throw new Error("No App export found. Ensure your module exports an object with a .send() method, or use --export <name>.");
+}
+// ============================================================================
+// UI resolution
+// ============================================================================
+/** Find a TUI component in a module. */
+function findUIComponent(mod, exportName) {
+    if (exportName) {
+        const exported = mod[exportName];
+        if (exported === undefined) {
+            throw new Error(`Export "${exportName}" not found in UI module`);
+        }
+        if (!isComponent(exported)) {
+            throw new Error(`Export "${exportName}" is not a function component`);
+        }
+        return exported;
+    }
+    const component = findExport(mod, isComponent, ["default", "TUI", "UI"]);
+    if (component)
+        return component;
+    throw new Error("No component export found. Export a React component, or use --ui-export <name>.");
+}
+/** Resolve --ui flag: built-in name, file path, or undefined (use default). */
+async function resolveUI(uiArg, uiExport) {
+    if (!uiArg)
+        return undefined;
+    if (uiArg in builtinUIs) {
+        return builtinUIs[uiArg];
+    }
+    const mod = await loadModule(uiArg);
+    return findUIComponent(mod, uiExport);
+}
+// ============================================================================
+// Main
+// ============================================================================
+async function main() {
+    const args = parseArgs(process.argv);
+    if (args.help) {
+        printUsage();
+        process.exit(0);
+    }
+    if (!args.app && !args.url) {
+        console.error("Error: Provide --app <path> or --url <url>\n");
+        printUsage();
+        process.exit(1);
+    }
+    if (args.app && args.url) {
+        console.error("Error: --app and --url are mutually exclusive\n");
+        printUsage();
+        process.exit(1);
+    }
+    const ui = await resolveUI(args.ui, args.uiExport);
+    if (args.url) {
+        await createTUI({ url: args.url, sessionId: args.session, ui }).start();
+        return;
+    }
+    const mod = await loadModule(args.app);
+    const app = findApp(mod, args.export);
+    await createTUI({ app: app, sessionId: args.session, ui }).start();
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}

package/dist/components/ErrorDisplay.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ErrorDisplay — shows errors that occur during execution.
+ *
+ * Red bordered box with error message. Optional dismiss handler.
+ */
+interface ErrorDisplayProps {
+    error: Error | string | null;
+    onDismiss?: () => void;
+}
+export declare function ErrorDisplay({ error, onDismiss }: ErrorDisplayProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=ErrorDisplay.d.ts.map

package/dist/components/ErrorDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorDisplay.d.ts","sourceRoot":"","sources":["../../src/components/ErrorDisplay.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,UAAU,iBAAiB;IACzB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,iBAAiB,kDAiCnE"}

package/dist/components/ErrorDisplay.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ErrorDisplay — shows errors that occur during execution.
+ *
+ * Red bordered box with error message. Optional dismiss handler.
+ */
+import { Box, Text, useInput } from "ink";
+export function ErrorDisplay({ error, onDismiss }) {
+    useInput(() => {
+        onDismiss?.();
+    }, { isActive: !!onDismiss && !!error });
+    if (!error)
+        return null;
+    const message = error instanceof Error ? error.message : error;
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "red", bold: true, children: "Error" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: message }) }), onDismiss && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Press any key to dismiss" }) }))] }));
+}
+//# sourceMappingURL=ErrorDisplay.js.map

package/dist/components/ErrorDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorDisplay.js","sourceRoot":"","sources":["../../src/components/ErrorDisplay.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAO1C,MAAM,UAAU,YAAY,CAAC,EAAE,KAAK,EAAE,SAAS,EAAqB;IAClE,QAAQ,CACN,GAAG,EAAE;QACH,SAAS,EAAE,EAAE,CAAC;IAChB,CAAC,EACD,EAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,CACrC,CAAC;IAEF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAE/D,OAAO,CACL,MAAC,GAAG,IACF,aAAa,EAAC,QAAQ,EACtB,WAAW,EAAC,OAAO,EACnB,WAAW,EAAC,KAAK,EACjB,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,CAAC,aAEZ,KAAC,IAAI,IAAC,KAAK,EAAC,KAAK,EAAC,IAAI,4BAEf,EACP,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,cAAE,OAAO,GAAQ,GAClB,EACL,SAAS,IAAI,CACZ,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,yCAAgC,GAC9C,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/components/InputBar.d.ts

@@ -0,0 +1,13 @@
+/**
+ * InputBar — user text input for the TUI.
+ *
+ * Uses ink-text-input. Enter submits, disabled while streaming.
+ */
+interface InputBarProps {
+    onSubmit: (text: string) => void;
+    isDisabled?: boolean;
+    placeholder?: string;
+}
+export declare function InputBar({ onSubmit, isDisabled, placeholder }: InputBarProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=InputBar.d.ts.map

package/dist/components/InputBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputBar.d.ts","sourceRoot":"","sources":["../../src/components/InputBar.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,UAAU,aAAa;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,UAAkB,EAAE,WAAW,EAAE,EAAE,aAAa,2CA0BpF"}

package/dist/components/InputBar.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * InputBar — user text input for the TUI.
+ *
+ * Uses ink-text-input. Enter submits, disabled while streaming.
+ */
+import { useState, useCallback } from "react";
+import { Box, Text } from "ink";
+import TextInput from "ink-text-input";
+export function InputBar({ onSubmit, isDisabled = false, placeholder }) {
+    const [value, setValue] = useState("");
+    const handleSubmit = useCallback((text) => {
+        if (!text.trim() || isDisabled)
+            return;
+        onSubmit(text.trim());
+        setValue("");
+    }, [onSubmit, isDisabled]);
+    return (_jsxs(Box, { borderStyle: "single", borderColor: isDisabled ? "gray" : "cyan", paddingLeft: 1, children: [_jsx(Text, { color: isDisabled ? "gray" : "green", bold: true, children: "› " }), _jsx(TextInput, { value: value, onChange: setValue, onSubmit: handleSubmit, focus: !isDisabled, placeholder: placeholder ?? (isDisabled ? "Waiting for response..." : "Type a message...") })] }));
+}
+//# sourceMappingURL=InputBar.js.map

package/dist/components/InputBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputBar.js","sourceRoot":"","sources":["../../src/components/InputBar.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAQvC,MAAM,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,KAAK,EAAE,WAAW,EAAiB;IACnF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEvC,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,EAAE;QACf,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,UAAU;YAAE,OAAO;QACvC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtB,QAAQ,CAAC,EAAE,CAAC,CAAC;IACf,CAAC,EACD,CAAC,QAAQ,EAAE,UAAU,CAAC,CACvB,CAAC;IAEF,OAAO,CACL,MAAC,GAAG,IAAC,WAAW,EAAC,QAAQ,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,aACjF,KAAC,IAAI,IAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,kBAC7C,IAAI,GACA,EACP,KAAC,SAAS,IACR,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,CAAC,UAAU,EAClB,WAAW,EAAE,WAAW,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAC1F,IACE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/MessageList.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MessageList — displays completed conversation messages.
+ *
+ * Uses Ink's <Static> for messages that won't re-render (performance critical).
+ * Listens for execution_end events which contain `output.timeline` with all entries.
+ */
+interface MessageListProps {
+    sessionId?: string;
+}
+export declare function MessageList({ sessionId }: MessageListProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=MessageList.d.ts.map

package/dist/components/MessageList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,gBAAgB,kDAwD1D"}

package/dist/components/MessageList.js

@@ -0,0 +1,81 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * MessageList — displays completed conversation messages.
+ *
+ * Uses Ink's <Static> for messages that won't re-render (performance critical).
+ * Listens for execution_end events which contain `output.timeline` with all entries.
+ */
+import { useState, useEffect, useCallback } from "react";
+import { Static, Box, Text } from "ink";
+import { useEvents } from "@agentick/react";
+function renderContent(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .map((block) => {
+        if (block.type === "text")
+            return block.text;
+        if (block.type === "tool_use")
+            return `[tool: ${block.name}]`;
+        if (block.type === "tool_result") {
+            const resultContent = Array.isArray(block.content)
+                ? block.content.map((c) => (c.type === "text" ? c.text : `[${c.type}]`)).join("")
+                : String(block.content ?? "");
+            return `[result: ${resultContent.slice(0, 100)}${resultContent.length > 100 ? "…" : ""}]`;
+        }
+        return `[${block.type}]`;
+    })
+        .join("");
+}
+function roleColor(role) {
+    switch (role) {
+        case "user":
+            return "blue";
+        case "assistant":
+            return "magenta";
+        case "system":
+            return "gray";
+        case "tool_result":
+            return "yellow";
+        default:
+            return "white";
+    }
+}
+export function MessageList({ sessionId }) {
+    const [messages, setMessages] = useState([]);
+    const { event } = useEvents({
+        sessionId,
+        filter: ["execution_end"],
+    });
+    useEffect(() => {
+        if (!event || event.type !== "execution_end")
+            return;
+        // execution_end.output is the COMInput which has a timeline array
+        // Each entry has { kind: "message", message: Message } structure
+        const execEnd = event;
+        const timeline = execEnd.output?.timeline;
+        if (!Array.isArray(timeline))
+            return;
+        const newMessages = timeline
+            .filter((entry) => entry.kind === "message" && entry.message)
+            .map((entry, i) => {
+            const msg = entry.message;
+            return {
+                id: msg.id ?? `msg-${i}-${Date.now()}`,
+                role: msg.role,
+                text: renderContent(msg.content),
+            };
+        });
+        setMessages(newMessages);
+    }, [event]);
+    const renderMessage = useCallback((msg) => {
+        // Skip tool_result entries in the message list for cleaner output
+        if (msg.role === "tool_result")
+            return null;
+        return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { color: roleColor(msg.role), bold: true, children: [msg.role, ":"] }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { wrap: "wrap", children: msg.text }) })] }, msg.id));
+    }, []);
+    if (messages.length === 0)
+        return null;
+    return (_jsx(Static, { items: messages, children: renderMessage }));
+}
+//# sourceMappingURL=MessageList.js.map

package/dist/components/MessageList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageList.js","sourceRoot":"","sources":["../../src/components/MessageList.tsx"],"names":[],"mappings":"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"}

package/dist/components/StreamingMessage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * StreamingMessage — shows the live model response while streaming.
+ *
+ * Uses useStreamingText() from @agentick/react.
+ */
+export declare function StreamingMessage(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=StreamingMessage.d.ts.map

package/dist/components/StreamingMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingMessage.d.ts","sourceRoot":"","sources":["../../src/components/StreamingMessage.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAgB,gBAAgB,mDAkB/B"}

package/dist/components/StreamingMessage.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * StreamingMessage — shows the live model response while streaming.
+ *
+ * Uses useStreamingText() from @agentick/react.
+ */
+import { Box, Text } from "ink";
+import { useStreamingText } from "@agentick/react";
+export function StreamingMessage() {
+    const { text, isStreaming } = useStreamingText();
+    if (!isStreaming && !text)
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "magenta", bold: true, children: "assistant:" }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { children: [text, isStreaming ? _jsx(Text, { color: "cyan", children: "\u258A" }) : null] }) })] }));
+}
+//# sourceMappingURL=StreamingMessage.js.map

package/dist/components/StreamingMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingMessage.js","sourceRoot":"","sources":["../../src/components/StreamingMessage.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAEjD,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvC,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,SAAS,EAAE,CAAC,aACtC,KAAC,IAAI,IAAC,KAAK,EAAC,SAAS,EAAC,IAAI,iCAEnB,EACP,KAAC,GAAG,IAAC,UAAU,EAAE,CAAC,YAChB,MAAC,IAAI,eACF,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,uBAAS,CAAC,CAAC,CAAC,IAAI,IAC5C,GACH,IACF,CACP,CAAC;AACJ,CAAC"}

package/dist/components/TUIApp.d.ts

@@ -0,0 +1,18 @@
+/**
+ * TUIApp — top-level TUI layout.
+ *
+ * Orchestrates the conversation: message history, streaming response,
+ * tool call indicators, tool confirmation prompts, error display, and user input.
+ *
+ * State machine: idle → streaming → (confirming_tool → streaming) → idle
+ * Ctrl+C behavior depends on state:
+ *   - idle: exit the process
+ *   - streaming: abort current execution
+ *   - confirming_tool: reject tool, return to streaming
+ */
+interface TUIAppProps {
+    sessionId: string;
+}
+export declare function TUIApp({ sessionId }: TUIAppProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TUIApp.d.ts.map

package/dist/components/TUIApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TUIApp.d.ts","sourceRoot":"","sources":["../../src/components/TUIApp.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,WAAW,2CAkHhD"}