@arizeai/phoenix-cli 1.5.3 → 1.6.0

package/build/pxi/App.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+import type { PxiChatClient, PxiMessage, PxiRuntimeOptions } from "./types.js";
+export type PxiAppProps = {
+    options: PxiRuntimeOptions;
+    client?: PxiChatClient;
+    initialMessages?: PxiMessage[];
+};
+/** Animated "PXI is thinking…" indicator shown while a reply is streaming. */
+export declare function ThinkingIndicator(): React.JSX.Element;
+/**
+ * Root component for the PXI chat.
+ *
+ * Holds the conversation, draft input, streaming status, and any error, and
+ * wires keyboard handling: Enter submits, Shift+Enter inserts a newline, Esc
+ * interrupts an in-flight request, and Ctrl+C / Ctrl+D exit. On submit it appends the
+ * user message, streams the assistant reply into the transcript as it arrives,
+ * and ignores errors caused by the user aborting. The `client` and
+ * `initialMessages` props exist mainly so tests can drive the UI with a fake
+ * client and seeded history.
+ */
+export declare function PxiApp({ options, client, initialMessages }: PxiAppProps): React.JSX.Element;
+//# sourceMappingURL=App.d.ts.map

package/build/pxi/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/pxi/App.tsx"],"names":[],"mappings":"AACA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAKpE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAoC5E,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;CAChC,CAAC;AAmNF,8EAA8E;AAC9E,wBAAgB,iBAAiB,sBAWhC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,eAAoB,EAAE,EAAE,WAAW,qBA2I5E"}

package/build/pxi/App.js

@@ -0,0 +1,268 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useApp, useInput } from "ink";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { createPxiChatClient, createUserMessage } from "./client.js";
+import { Markdown } from "./inkMarkdown.js";
+import { getToolProgressFromPart } from "./toolProgress.js";
+const PXI_BANNER = String.raw `
+__/\\\\\\\\\\\\\____/\\\_______/\\\__/\\\\\\\\\\\_
+ _\/\\\/////////\\\_\///\\\___/\\\/__\/////\\\///__
+  _\/\\\_______\/\\\___\///\\\\\\/________\/\\\_____
+   _\/\\\\\\\\\\\\\/______\//\\\\__________\/\\\_____
+    _\/\\\/////////_________\/\\\\__________\/\\\_____
+     _\/\\\__________________/\\\\\\_________\/\\\_____
+      _\/\\\________________/\\\////\\\_______\/\\\_____
+       _\/\\\______________/\\\/___\///\\\__/\\\\\\\\\\\_
+        _\///______________\///_______\///__\///////////__
+`;
+const THINKING_FRAMES = [
+    "PXI is thinking   ",
+    "PXI is thinking.  ",
+    "PXI is thinking.. ",
+    "PXI is thinking...",
+];
+const KEYBOARD_PROTOCOL_RESPONSE_PATTERN = /^\[\?\d+u$/;
+const INTERRUPTED_MESSAGE_TEXT = "\n\n[Interrupted by user before completion.]";
+// The 3D banner is drawn with two kinds of strokes: the `\` runs form the
+// raised faces of the letters, while `/` and `_` are the recessed shading.
+// Group each line into runs so the raised strokes can be colored distinctly.
+function getBannerSegments(line) {
+    const segments = [];
+    for (const char of line) {
+        const raised = char === "\\";
+        const last = segments[segments.length - 1];
+        if (last && last.raised === raised) {
+            last.text += char;
+        }
+        else {
+            segments.push({ text: char, raised });
+        }
+    }
+    return segments;
+}
+/** The PXI wordmark, colored so the raised letter faces stand out. */
+function PxiBanner() {
+    const lines = PXI_BANNER.replace(/^\n|\n$/g, "").split("\n");
+    return (_jsx(Box, { flexDirection: "column", marginY: 1, children: lines.map((line, lineIndex) => (_jsx(Text, { children: getBannerSegments(line).map((segment, index) => (_jsx(Text, { 
+                // `blueBright` + bold reads clearly on both dark and light
+                // terminal backgrounds, where plain `blue` washes out.
+                color: segment.raised ? "blueBright" : "gray", bold: segment.raised, children: segment.text }, index))) }, lineIndex))) }));
+}
+/** Format the active model for the status line (e.g. `ANTHROPIC/claude-opus-4-8`). */
+function getModelLabel(options) {
+    if (options.modelSelection.providerType === "custom") {
+        return `custom:${options.modelSelection.providerId}/${options.modelSelection.modelName}`;
+    }
+    return `${options.modelSelection.provider}/${options.modelSelection.modelName}`;
+}
+/** Render a single tool call inline in the transcript, coloring errors red. */
+function InlineToolProgress({ tool }) {
+    const statusColor = tool.state === "output-error" ? "red" : "yellow";
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, paddingLeft: 2, children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "[tool]" }), " ", _jsx(Text, { color: statusColor, children: tool.toolName }), " ", _jsx(Text, { color: statusColor, children: tool.statusText })] }), tool.errorText ? _jsx(Text, { color: "red", children: tool.errorText }) : null] }));
+}
+/**
+ * Render the ordered parts of one message: text parts as markdown, tool parts
+ * as inline progress, skipping anything unrecognized.
+ */
+function MessageParts({ message, phoenixBaseUrl, }) {
+    return (_jsx(Box, { flexDirection: "column", children: message.parts.map((part, index) => {
+            if (part.type === "text") {
+                return (_jsx(Markdown, { phoenixBaseUrl: phoenixBaseUrl, children: part.text }, `${message.id}-text-${index}`));
+            }
+            const tool = getToolProgressFromPart({ part });
+            if (tool) {
+                return _jsx(InlineToolProgress, { tool: tool }, tool.toolCallId);
+            }
+            return null;
+        }) }));
+}
+/**
+ * Render the whole conversation as labeled, color-coded turns ("You" vs "PXI"),
+ * or a placeholder when the conversation hasn't started.
+ */
+function Transcript({ messages, phoenixBaseUrl, }) {
+    if (messages.length === 0) {
+        return _jsx(Text, { dimColor: true, children: "Phoenix Intelligence." });
+    }
+    return (_jsx(Box, { flexDirection: "column", children: messages.map((message) => {
+            const label = message.role === "user" ? "You" : "PXI";
+            const color = message.role === "user" ? "cyan" : "green";
+            return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { color: color, bold: true, children: label }), _jsx(MessageParts, { message: message, phoenixBaseUrl: phoenixBaseUrl })] }, message.id));
+        }) }));
+}
+/** Render the prompt row with helper text below it. */
+function InputPrompt({ draft, status }) {
+    const cursor = status === "streaming" ? "" : "█";
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, gap: 1, children: [_jsx(Box, { borderStyle: "single", borderLeft: false, borderRight: false, borderTop: true, borderBottom: true, borderColor: "gray", children: _jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: "> " }), draft, cursor] }) }), _jsx(Text, { dimColor: true, children: "Enter sends. Shift+Enter inserts a newline. Esc interrupts a reply. Ctrl+D or Ctrl+C exits." })] }));
+}
+function isKeyboardProtocolResponseInput({ input }) {
+    return KEYBOARD_PROTOCOL_RESPONSE_PATTERN.test(input);
+}
+function getCompletedInterruptedPart({ part, }) {
+    if (part.type === "text" || part.type === "reasoning") {
+        return { ...part, state: "done" };
+    }
+    if (part.type === "dynamic-tool") {
+        return part.state === "output-available" ||
+            part.state === "output-error" ||
+            part.state === "output-denied"
+            ? part
+            : null;
+    }
+    if ("state" in part &&
+        typeof part.type === "string" &&
+        part.type.startsWith("tool-")) {
+        return part.state === "output-available" ||
+            part.state === "output-error" ||
+            part.state === "output-denied"
+            ? part
+            : null;
+    }
+    return part;
+}
+function markMessageInterrupted({ message, }) {
+    return {
+        ...message,
+        parts: [
+            ...message.parts.flatMap((part) => {
+                const completedPart = getCompletedInterruptedPart({ part });
+                return completedPart ? [completedPart] : [];
+            }),
+            { type: "text", text: INTERRUPTED_MESSAGE_TEXT, state: "done" },
+        ],
+    };
+}
+/** Animated "PXI is thinking…" indicator shown while a reply is streaming. */
+export function ThinkingIndicator() {
+    const [frameIndex, setFrameIndex] = useState(0);
+    useEffect(() => {
+        const interval = setInterval(() => {
+            setFrameIndex((value) => (value + 1) % THINKING_FRAMES.length);
+        }, 250);
+        return () => clearInterval(interval);
+    }, []);
+    return _jsx(Text, { color: "yellow", children: THINKING_FRAMES[frameIndex] });
+}
+/**
+ * Root component for the PXI chat.
+ *
+ * Holds the conversation, draft input, streaming status, and any error, and
+ * wires keyboard handling: Enter submits, Shift+Enter inserts a newline, Esc
+ * interrupts an in-flight request, and Ctrl+C / Ctrl+D exit. On submit it appends the
+ * user message, streams the assistant reply into the transcript as it arrives,
+ * and ignores errors caused by the user aborting. The `client` and
+ * `initialMessages` props exist mainly so tests can drive the UI with a fake
+ * client and seeded history.
+ */
+export function PxiApp({ options, client, initialMessages = [] }) {
+    const { exit } = useApp();
+    const [messages, setMessages] = useState(initialMessages);
+    const [draft, setDraft] = useState("");
+    const [status, setStatus] = useState("idle");
+    const [error, setError] = useState(null);
+    const abortControllerRef = useRef(null);
+    const streamingAssistantMessageRef = useRef(null);
+    const chatClient = useMemo(() => client ?? createPxiChatClient({ options }), [client, options]);
+    const handleExit = () => {
+        abortControllerRef.current?.abort();
+        exit();
+    };
+    const interruptStream = () => {
+        if (status !== "streaming") {
+            return;
+        }
+        abortControllerRef.current?.abort();
+        const assistantMessage = streamingAssistantMessageRef.current;
+        if (assistantMessage) {
+            const interruptedMessage = markMessageInterrupted({
+                message: assistantMessage,
+            });
+            streamingAssistantMessageRef.current = interruptedMessage;
+            setMessages((currentMessages) => {
+                const lastMessage = currentMessages.at(-1);
+                if (lastMessage?.id === assistantMessage.id) {
+                    return [...currentMessages.slice(0, -1), interruptedMessage];
+                }
+                return [...currentMessages, interruptedMessage];
+            });
+        }
+        setStatus("idle");
+    };
+    const submitDraft = () => {
+        const text = draft.trim();
+        if (!text || status === "streaming") {
+            return;
+        }
+        const userMessage = createUserMessage({ text });
+        const nextMessages = [...messages, userMessage];
+        const abortController = new AbortController();
+        abortControllerRef.current = abortController;
+        streamingAssistantMessageRef.current = null;
+        setDraft("");
+        setError(null);
+        setStatus("streaming");
+        setMessages(nextMessages);
+        void chatClient
+            .sendMessage({
+            messages: nextMessages,
+            abortSignal: abortController.signal,
+            onAssistantMessage: (assistantMessage) => {
+                streamingAssistantMessageRef.current = assistantMessage;
+                setMessages([...nextMessages, assistantMessage]);
+            },
+        })
+            .then((assistantMessage) => {
+            if (abortController.signal.aborted) {
+                return;
+            }
+            if (assistantMessage) {
+                setMessages([...nextMessages, assistantMessage]);
+            }
+        })
+            .catch((err) => {
+            if (abortController.signal.aborted) {
+                return;
+            }
+            setError(err instanceof Error ? err.message : String(err));
+        })
+            .finally(() => {
+            if (abortControllerRef.current === abortController) {
+                abortControllerRef.current = null;
+            }
+            setStatus("idle");
+        });
+    };
+    useInput((input, key) => {
+        if (key.escape) {
+            interruptStream();
+            return;
+        }
+        if ((key.ctrl && input === "c") || (key.ctrl && input === "d")) {
+            handleExit();
+            return;
+        }
+        if (status === "streaming") {
+            return;
+        }
+        if (isKeyboardProtocolResponseInput({ input })) {
+            return;
+        }
+        if (key.return && key.shift) {
+            setDraft((value) => `${value}\n`);
+            return;
+        }
+        if (key.return) {
+            submitDraft();
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setDraft((value) => value.slice(0, -1));
+            return;
+        }
+        if (input) {
+            setDraft((value) => `${value}${input}`);
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(PxiBanner, {}), _jsxs(Text, { dimColor: true, children: ["endpoint: ", options.config.endpoint, " | model: ", getModelLabel(options), " | session: ", options.sessionId] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Transcript, { messages: messages, phoenixBaseUrl: options.config.endpoint }) }), error ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) })) : null, status === "streaming" ? _jsx(ThinkingIndicator, {}) : null, _jsx(InputPrompt, { draft: draft, status: status })] }));
+}
+//# sourceMappingURL=App.js.map

package/build/pxi/App.js.map

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

package/build/pxi/client.d.ts

@@ -0,0 +1,77 @@
+import { type UIMessageChunk } from "ai";
+import type { PhoenixConfig } from "../config.js";
+import type { PxiChatClient, PxiChatRequest, PxiContext, PxiMessage, PxiRuntimeOptions, PxiTransport } from "./types.js";
+/**
+ * Build the chat URL for a session, tolerating a trailing slash on the
+ * configured endpoint and URL-encoding the session id.
+ */
+export declare function buildServerAgentChatUrl({ endpoint, sessionId, }: {
+    endpoint: string;
+    sessionId: string;
+}): string;
+/**
+ * Assemble request headers from the config: any custom headers first, then a
+ * bearer `Authorization` header when an API key is set (so the key takes
+ * precedence over a manually supplied auth header).
+ */
+export declare function buildPxiHeaders({ config, }: {
+    config: PhoenixConfig;
+}): Record<string, string>;
+/**
+ * Build the {@link PxiContext} list sent with every request, telling the server
+ * agent the current local time and zone and which capabilities (GraphQL
+ * mutations, web access, subagents) are enabled for the run. `now` and
+ * `timeZone` default to the live clock/zone but are injectable for testing.
+ */
+export declare function buildPxiContexts({ enableWebAccess, enableSubagents, enableGraphqlMutations, now, timeZone, }: {
+    enableWebAccess: boolean;
+    enableSubagents: boolean;
+    enableGraphqlMutations: boolean;
+    now?: Date;
+    timeZone?: string;
+}): PxiContext[];
+/**
+ * Assemble the full chat request body from the conversation so far and the
+ * resolved runtime options — session id, trace settings, edit permission,
+ * capability contexts, and model selection.
+ */
+export declare function buildPxiChatRequest({ messages, options, }: {
+    messages: PxiMessage[];
+    options: PxiRuntimeOptions;
+}): PxiChatRequest;
+/**
+ * Create the AI SDK transport pointed at the configured Phoenix server-agent
+ * endpoint. Each outgoing turn is rebuilt through {@link buildPxiChatRequest},
+ * so per-request context (like the current time) stays fresh. Throws if no
+ * endpoint is configured. `fetch` is injectable for testing.
+ */
+export declare function createServerAgentTransport({ options, fetch, }: {
+    options: PxiRuntimeOptions;
+    fetch?: typeof globalThis.fetch;
+}): PxiTransport;
+/**
+ * Consume a UI-message chunk stream, invoking `onAssistantMessage` with each
+ * progressively-accumulated snapshot so the UI can render the reply as it
+ * arrives. Resolves with the final, complete message (or `null` if the stream
+ * produced nothing).
+ */
+export declare function streamAssistantMessage({ stream, onAssistantMessage, }: {
+    stream: ReadableStream<UIMessageChunk>;
+    onAssistantMessage: (message: PxiMessage) => void;
+}): Promise<PxiMessage | null>;
+/**
+ * Create the {@link PxiChatClient} the UI talks to. It sends the conversation
+ * over the transport, streams the assistant reply back, and on failure wraps
+ * the error via {@link formatPxiRuntimeError} so the user sees an actionable
+ * message (e.g. how to fix missing credentials). The transport defaults to a
+ * real server-agent transport but is injectable for testing.
+ */
+export declare function createPxiChatClient({ options, transport, }: {
+    options: PxiRuntimeOptions;
+    transport?: PxiTransport;
+}): PxiChatClient;
+/** Wrap raw user input in a {@link PxiMessage} with a fresh id. */
+export declare function createUserMessage({ text }: {
+    text: string;
+}): PxiMessage;
+//# sourceMappingURL=client.d.ts.map

package/build/pxi/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/pxi/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,IAAI,CAAC;AAEZ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACb,MAAM,SAAS,CAAC;AAsCjB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAIT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,GAAgB,EAChB,QAA2D,GAC5D,EAAE;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,EAAE,CAoBf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG,cAAc,CAgBjB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,GAAG,YAAY,CAgBf;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,kBAAkB,GACnB,EAAE;IACD,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CACnD,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO7B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,SAAmD,GACpD,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B,GAAG,aAAa,CAoBhB;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAMxE"}

package/build/pxi/client.js

@@ -0,0 +1,170 @@
+import { DefaultChatTransport, readUIMessageStream, } from "ai";
+import { formatPxiRuntimeError } from "./preflight.js";
+/**
+ * Chat client for the Phoenix server-agent endpoint.
+ *
+ * This wires the Vercel AI SDK's {@link DefaultChatTransport} to Phoenix's
+ * `/agents/server/sessions/{id}/chat` route: it builds the request URL, auth
+ * headers, and request body, then streams the assistant reply back as a series
+ * of {@link PxiMessage} snapshots.
+ */
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+/**
+ * Format a date as a local ISO-8601 timestamp with an explicit UTC offset
+ * (e.g. `2026-06-25T13:45:00.000+02:00`). Unlike `Date#toISOString`, which
+ * always emits UTC, this preserves the caller's wall-clock time and zone so the
+ * agent reasons about "now" the way the user experiences it.
+ */
+function toLocalISOWithOffset(date) {
+    const offsetMinutes = -date.getTimezoneOffset();
+    const sign = offsetMinutes >= 0 ? "+" : "-";
+    const absoluteOffsetMinutes = Math.abs(offsetMinutes);
+    const offsetHours = String(Math.floor(absoluteOffsetMinutes / 60)).padStart(2, "0");
+    const offsetRemainderMinutes = String(absoluteOffsetMinutes % 60).padStart(2, "0");
+    const localDate = new Date(date.getTime() - date.getTimezoneOffset() * 60000);
+    const localIso = localDate.toISOString().slice(0, -1);
+    return `${localIso}${sign}${offsetHours}:${offsetRemainderMinutes}`;
+}
+/**
+ * Build the chat URL for a session, tolerating a trailing slash on the
+ * configured endpoint and URL-encoding the session id.
+ */
+export function buildServerAgentChatUrl({ endpoint, sessionId, }) {
+    return `${trimTrailingSlash(endpoint)}/agents/server/sessions/${encodeURIComponent(sessionId)}/chat`;
+}
+/**
+ * Assemble request headers from the config: any custom headers first, then a
+ * bearer `Authorization` header when an API key is set (so the key takes
+ * precedence over a manually supplied auth header).
+ */
+export function buildPxiHeaders({ config, }) {
+    return {
+        ...(config.headers ?? {}),
+        ...(config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}),
+    };
+}
+/**
+ * Build the {@link PxiContext} list sent with every request, telling the server
+ * agent the current local time and zone and which capabilities (GraphQL
+ * mutations, web access, subagents) are enabled for the run. `now` and
+ * `timeZone` default to the live clock/zone but are injectable for testing.
+ */
+export function buildPxiContexts({ enableWebAccess, enableSubagents, enableGraphqlMutations, now = new Date(), timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone, }) {
+    return [
+        {
+            type: "app",
+            currentDateTime: toLocalISOWithOffset(now),
+            timeZone,
+        },
+        {
+            type: "graphql",
+            mutationsEnabled: enableGraphqlMutations,
+        },
+        {
+            type: "web_access",
+            enabled: enableWebAccess,
+        },
+        {
+            type: "subagents",
+            enabled: enableSubagents,
+        },
+    ];
+}
+/**
+ * Assemble the full chat request body from the conversation so far and the
+ * resolved runtime options — session id, trace settings, edit permission,
+ * capability contexts, and model selection.
+ */
+export function buildPxiChatRequest({ messages, options, }) {
+    return {
+        id: options.sessionId,
+        messages,
+        trigger: "submit-message",
+        ingestTraces: options.ingestTraces,
+        exportRemoteTraces: options.exportRemoteTraces,
+        attachUserId: options.attachUserId,
+        editPermission: options.editPermission,
+        contexts: buildPxiContexts({
+            enableWebAccess: options.enableWebAccess,
+            enableSubagents: options.enableSubagents,
+            enableGraphqlMutations: options.enableGraphqlMutations,
+        }),
+        model: options.modelSelection,
+    };
+}
+/**
+ * Create the AI SDK transport pointed at the configured Phoenix server-agent
+ * endpoint. Each outgoing turn is rebuilt through {@link buildPxiChatRequest},
+ * so per-request context (like the current time) stays fresh. Throws if no
+ * endpoint is configured. `fetch` is injectable for testing.
+ */
+export function createServerAgentTransport({ options, fetch, }) {
+    if (!options.config.endpoint) {
+        throw new Error("Phoenix endpoint not configured.");
+    }
+    return new DefaultChatTransport({
+        api: buildServerAgentChatUrl({
+            endpoint: options.config.endpoint,
+            sessionId: options.sessionId,
+        }),
+        headers: buildPxiHeaders({ config: options.config }),
+        fetch,
+        prepareSendMessagesRequest: ({ messages }) => ({
+            body: buildPxiChatRequest({ messages, options }),
+        }),
+    });
+}
+/**
+ * Consume a UI-message chunk stream, invoking `onAssistantMessage` with each
+ * progressively-accumulated snapshot so the UI can render the reply as it
+ * arrives. Resolves with the final, complete message (or `null` if the stream
+ * produced nothing).
+ */
+export async function streamAssistantMessage({ stream, onAssistantMessage, }) {
+    let finalMessage = null;
+    for await (const message of readUIMessageStream({ stream })) {
+        finalMessage = message;
+        onAssistantMessage(message);
+    }
+    return finalMessage;
+}
+/**
+ * Create the {@link PxiChatClient} the UI talks to. It sends the conversation
+ * over the transport, streams the assistant reply back, and on failure wraps
+ * the error via {@link formatPxiRuntimeError} so the user sees an actionable
+ * message (e.g. how to fix missing credentials). The transport defaults to a
+ * real server-agent transport but is injectable for testing.
+ */
+export function createPxiChatClient({ options, transport = createServerAgentTransport({ options }), }) {
+    return {
+        async sendMessage({ messages, abortSignal, onAssistantMessage }) {
+            try {
+                const stream = await transport.sendMessages({
+                    trigger: "submit-message",
+                    chatId: options.sessionId,
+                    messageId: undefined,
+                    messages,
+                    abortSignal,
+                });
+                return await streamAssistantMessage({ stream, onAssistantMessage });
+            }
+            catch (error) {
+                throw formatPxiRuntimeError({
+                    error,
+                    modelSelection: options.modelSelection,
+                });
+            }
+        },
+    };
+}
+/** Wrap raw user input in a {@link PxiMessage} with a fresh id. */
+export function createUserMessage({ text }) {
+    return {
+        id: crypto.randomUUID(),
+        role: "user",
+        parts: [{ type: "text", text }],
+    };
+}
+//# sourceMappingURL=client.js.map

package/build/pxi/client.js.map

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

package/build/pxi/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the `pxi` command.
+ *
+ * Parses CLI flags into runtime options, runs the model preflight (verifying
+ * the chosen provider/model is available and credentialed on the Phoenix
+ * server) before anything is drawn, then mounts the Ink chat UI and blocks
+ * until the user exits. Preflight runs first so configuration problems surface
+ * as a clean error instead of a half-rendered terminal.
+ */
+export declare function main({ argv, }?: {
+    argv?: string[];
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/build/pxi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pxi/index.tsx"],"names":[],"mappings":";AAWA;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,EACzB,IAAmB,GACpB,GAAE;IACD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrB"}

package/build/pxi/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import { getExitCodeForError } from "../exitCodes.js";
+import { writeError } from "../io.js";
+import { PxiApp } from "./App.js";
+import { parsePxiRuntimeOptions } from "./options.js";
+import { runPxiModelPreflight } from "./preflight.js";
+/**
+ * Entry point for the `pxi` command.
+ *
+ * Parses CLI flags into runtime options, runs the model preflight (verifying
+ * the chosen provider/model is available and credentialed on the Phoenix
+ * server) before anything is drawn, then mounts the Ink chat UI and blocks
+ * until the user exits. Preflight runs first so configuration problems surface
+ * as a clean error instead of a half-rendered terminal.
+ */
+export async function main({ argv = process.argv, } = {}) {
+    const options = await parsePxiRuntimeOptions({ argv });
+    await runPxiModelPreflight({ options });
+    const instance = render(_jsx(PxiApp, { options: options }), {
+        exitOnCtrlC: false,
+        kittyKeyboard: {
+            mode: "auto",
+            flags: ["disambiguateEscapeCodes"],
+        },
+    });
+    await instance.waitUntilExit();
+}
+void main().catch((error) => {
+    writeError({
+        message: `Error: ${error instanceof Error ? error.message : String(error)}`,
+    });
+    process.exit(getExitCodeForError(error));
+});
+//# sourceMappingURL=index.js.map

package/build/pxi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pxi/index.tsx"],"names":[],"mappings":";;AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EACzB,IAAI,GAAG,OAAO,CAAC,IAAI,MAGjB,EAAE;IACJ,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAC,MAAM,IAAC,OAAO,EAAE,OAAO,GAAI,EAAE;QACpD,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE;YACb,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,yBAAyB,CAAC;SACnC;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;AACjC,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1B,UAAU,CAAC;QACT,OAAO,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KAC5E,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/build/pxi/inkMarkdown.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+/**
+ * Renders markdown text as styled terminal output inside an Ink `<Text>`.
+ *
+ * Modeled on the `ink-markdown` component
+ * (https://github.com/cameronhunter/ink-markdown, MIT). That package is
+ * published as CommonJS and `require()`s Ink internally, which is incompatible
+ * with Ink 6 (pure ESM with top-level await — `require()` throws
+ * `ERR_REQUIRE_ASYNC_MODULE`). We keep its API — `<Markdown>{text}</Markdown>` —
+ * but render through {@link formatMarkdownForTerminal}, which uses the current
+ * `marked` + `marked-terminal` API and preserves our width-aware table layout.
+ */
+export declare function Markdown({ children, phoenixBaseUrl, }: {
+    children: string;
+    phoenixBaseUrl?: string;
+}): React.JSX.Element;
+//# sourceMappingURL=inkMarkdown.d.ts.map