@stigmer/ink 0.0.88

package/components/ToolCallGroup.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { ToolCallStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ToolCallItem } from "./ToolCallItem.js";
+function deriveAggregateStatus(toolCalls) {
+    let hasRunning = false;
+    let hasFailed = false;
+    for (const tc of toolCalls) {
+        if (tc.status === ToolCallStatus.TOOL_CALL_RUNNING)
+            hasRunning = true;
+        if (tc.status === ToolCallStatus.TOOL_CALL_FAILED)
+            hasFailed = true;
+    }
+    if (hasRunning)
+        return "running";
+    if (hasFailed)
+        return "failed";
+    const allDone = toolCalls.every((tc) => tc.status === ToolCallStatus.TOOL_CALL_COMPLETED ||
+        tc.status === ToolCallStatus.TOOL_CALL_FAILED);
+    return allDone ? "completed" : "pending";
+}
+const STATUS_STYLE = {
+    running: { symbol: "⠋", color: "yellow" },
+    completed: { symbol: "✓", color: "green" },
+    failed: { symbol: "✗", color: "red" },
+    pending: { symbol: "○" },
+};
+/**
+ * Renders a collapsible group of tool calls with an aggregate status.
+ *
+ * When collapsed, shows a summary line with tool count and status.
+ * When expanded, renders each tool call via {@link ToolCallItem}.
+ *
+ * Press Enter or Space to toggle expansion when `isFocused` is true.
+ */
+export function ToolCallGroup({ toolCalls, isFocused = false, defaultExpanded = false, }) {
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const status = deriveAggregateStatus(toolCalls);
+    const style = STATUS_STYLE[status];
+    useInput((_input, key) => {
+        if (key.return || _input === " ") {
+            setExpanded((prev) => !prev);
+        }
+    }, { isActive: isFocused });
+    const summary = toolCalls.length === 1
+        ? toolCalls[0].name
+        : `${toolCalls.length} tool calls`;
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: style.color, children: style.symbol }), _jsx(Text, { dimColor: true, children: expanded ? "▼" : "▶" }), _jsx(Text, { children: summary })] }), expanded && (_jsx(Box, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: toolCalls.map((tc) => (_jsx(ToolCallItem, { toolCall: tc, expanded: true }, tc.id))) }))] }));
+}
+//# sourceMappingURL=ToolCallGroup.js.map

package/components/ToolCallGroup.js.map

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

package/components/ToolCallItem.d.ts

@@ -0,0 +1,14 @@
+import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+/** Props for {@link ToolCallItem}. */
+export interface ToolCallItemProps {
+    /** The tool call to render. */
+    readonly toolCall: ToolCall;
+    /** Whether to show the full args/result (expanded view). */
+    readonly expanded?: boolean;
+}
+/**
+ * Renders a single tool call with a status indicator, name, and
+ * optional expanded args/result preview.
+ */
+export declare function ToolCallItem({ toolCall, expanded }: ToolCallItemProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ToolCallItem.d.ts.map

package/components/ToolCallItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallItem.d.ts","sourceRoot":"","sources":["../../src/components/ToolCallItem.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAGhG,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAQD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,EAAE,iBAAiB,2CA4C7E"}

package/components/ToolCallItem.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { ToolCallStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+const STATUS_INDICATOR = {
+    [ToolCallStatus.TOOL_CALL_RUNNING]: { symbol: "⠋", color: "yellow" },
+    [ToolCallStatus.TOOL_CALL_COMPLETED]: { symbol: "✓", color: "green" },
+    [ToolCallStatus.TOOL_CALL_FAILED]: { symbol: "✗", color: "red" },
+};
+/**
+ * Renders a single tool call with a status indicator, name, and
+ * optional expanded args/result preview.
+ */
+export function ToolCallItem({ toolCall, expanded = false }) {
+    const indicator = STATUS_INDICATOR[toolCall.status] ?? {
+        symbol: "○",
+    };
+    const serverSlug = toolCall.mcpServerSlug;
+    const label = serverSlug
+        ? `${serverSlug}/${toolCall.name}`
+        : toolCall.name;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: indicator.color, children: indicator.symbol }), _jsx(Text, { children: label }), toolCall.status === ToolCallStatus.TOOL_CALL_RUNNING && (_jsx(Text, { dimColor: true, children: "running" }))] }), expanded && toolCall.argsPreview && (_jsx(Box, { paddingLeft: 3, children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: toolCall.argsPreview }) })), expanded &&
+                toolCall.status === ToolCallStatus.TOOL_CALL_COMPLETED &&
+                toolCall.result && (_jsx(Box, { paddingLeft: 3, children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: truncateResult(toolCall.result) }) })), expanded &&
+                toolCall.status === ToolCallStatus.TOOL_CALL_FAILED &&
+                toolCall.error && (_jsx(Box, { paddingLeft: 3, children: _jsx(Text, { color: "red", children: toolCall.error }) }))] }));
+}
+function truncateResult(result, maxLines = 5) {
+    const lines = result.split("\n");
+    if (lines.length <= maxLines)
+        return result;
+    return lines.slice(0, maxLines).join("\n") + `\n... (${lines.length - maxLines} more lines)`;
+}
+//# sourceMappingURL=ToolCallItem.js.map

package/components/ToolCallItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallItem.js","sourceRoot":"","sources":["../../src/components/ToolCallItem.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAU9F,MAAM,gBAAgB,GAAuD;IAC3E,CAAC,cAAc,CAAC,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;IACpE,CAAC,cAAc,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE;IACrE,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE;CACjE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAqB;IAC5E,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;QACrD,MAAM,EAAE,GAAG;KACZ,CAAC;IAEF,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC;IAC1C,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,GAAG,UAAU,IAAI,QAAQ,CAAC,IAAI,EAAE;QAClC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAElB,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,MAAC,GAAG,IAAC,GAAG,EAAE,CAAC,aACT,KAAC,IAAI,IAAC,KAAK,EAAE,SAAS,CAAC,KAAK,YAAG,SAAS,CAAC,MAAM,GAAQ,EACvD,KAAC,IAAI,cAAE,KAAK,GAAQ,EACnB,QAAQ,CAAC,MAAM,KAAK,cAAc,CAAC,iBAAiB,IAAI,CACvD,KAAC,IAAI,IAAC,QAAQ,8BAAe,CAC9B,IACG,EACL,QAAQ,IAAI,QAAQ,CAAC,WAAW,IAAI,CACnC,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,YACjB,KAAC,IAAI,IAAC,QAAQ,QAAC,IAAI,EAAC,cAAc,YAC/B,QAAQ,CAAC,WAAW,GAChB,GACH,CACP,EACA,QAAQ;gBACP,QAAQ,CAAC,MAAM,KAAK,cAAc,CAAC,mBAAmB;gBACtD,QAAQ,CAAC,MAAM,IAAI,CACjB,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,YACjB,KAAC,IAAI,IAAC,QAAQ,QAAC,IAAI,EAAC,cAAc,YAC/B,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,GAC3B,GACH,CACP,EACF,QAAQ;gBACP,QAAQ,CAAC,MAAM,KAAK,cAAc,CAAC,gBAAgB;gBACnD,QAAQ,CAAC,KAAK,IAAI,CAChB,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,YACjB,KAAC,IAAI,IAAC,KAAK,EAAC,KAAK,YAAE,QAAQ,CAAC,KAAK,GAAQ,GACrC,CACP,IACC,CACP,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,QAAQ,GAAG,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC5C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,KAAK,CAAC,MAAM,GAAG,QAAQ,cAAc,CAAC;AAC/F,CAAC"}

package/components/UsageWidget.d.ts

@@ -0,0 +1,16 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+/** Props for {@link UsageWidget}. */
+export interface UsageWidgetProps {
+    /** All executions for the current session (completed + active). */
+    readonly executions: readonly AgentExecution[];
+}
+/**
+ * Compact terminal widget showing session-level token usage and cost.
+ *
+ * Aggregates per-message `LlmCallMetrics` across all executions
+ * in the session. Renders nothing when no usage data is available.
+ *
+ * Uses the headless {@link useSessionUsage} hook from `@stigmer/react`.
+ */
+export declare function UsageWidget({ executions }: UsageWidgetProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=UsageWidget.d.ts.map

package/components/UsageWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageWidget.d.ts","sourceRoot":"","sources":["../../src/components/UsageWidget.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAGlG,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,gBAAgB,kDAe3D"}

package/components/UsageWidget.js

@@ -0,0 +1,18 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { useSessionUsage, formatCost, formatTokenCount } from "@stigmer/react";
+/**
+ * Compact terminal widget showing session-level token usage and cost.
+ *
+ * Aggregates per-message `LlmCallMetrics` across all executions
+ * in the session. Renders nothing when no usage data is available.
+ *
+ * Uses the headless {@link useSessionUsage} hook from `@stigmer/react`.
+ */
+export function UsageWidget({ executions }) {
+    const usage = useSessionUsage(executions);
+    if (!usage.hasUsage)
+        return null;
+    return (_jsx(Box, { paddingLeft: 1, gap: 1, children: _jsxs(Text, { dimColor: true, children: [formatCost(usage.totalCostUsd), " \u00B7 ", formatTokenCount(usage.totalTokens), " ", "tokens \u00B7 ", usage.llmCallCount, " ", usage.llmCallCount === 1 ? "call" : "calls", usage.primaryModel ? ` · ${usage.primaryModel}` : ""] }) }));
+}
+//# sourceMappingURL=UsageWidget.js.map

package/components/UsageWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageWidget.js","sourceRoot":"","sources":["../../src/components/UsageWidget.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQ/E;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,UAAU,EAAoB;IAC1D,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE1C,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,CACL,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,YACzB,MAAC,IAAI,IAAC,QAAQ,mBACX,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,cAAK,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,oBAClE,KAAK,CAAC,YAAY,EAAE,GAAG,EAChC,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAC3C,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAChD,GACH,CACP,CAAC;AACJ,CAAC"}

package/index.d.ts

@@ -0,0 +1,16 @@
+export { InkStigmerProvider, type InkStigmerProviderProps } from "./provider.js";
+export { createNodeClient, createNodeTransport, type NodeClientConfig, } from "@stigmer/sdk/node";
+export { renderMarkdown } from "./markdown.js";
+export { MessageEntry, type MessageEntryProps } from "./components/MessageEntry.js";
+export { MessageThread, type MessageThreadProps } from "./components/MessageThread.js";
+export { ToolCallItem, type ToolCallItemProps } from "./components/ToolCallItem.js";
+export { ToolCallGroup, type ToolCallGroupProps } from "./components/ToolCallGroup.js";
+export { SubAgentBlock, type SubAgentBlockProps } from "./components/SubAgentBlock.js";
+export { TodoList, type TodoListProps } from "./components/TodoList.js";
+export { ApprovalPrompt, type ApprovalPromptProps } from "./components/ApprovalPrompt.js";
+export { ExecutionProgress, type ExecutionProgressProps } from "./components/ExecutionProgress.js";
+export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInput.js";
+export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";
+export { SessionView, type SessionViewProps } from "./app/SessionView.js";
+export { SessionApp, type SessionAppProps } from "./app/SessionApp.js";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/index.js

@@ -0,0 +1,21 @@
+// Provider
+export { InkStigmerProvider } from "./provider.js";
+// Transport (re-exported from @stigmer/sdk/node)
+export { createNodeClient, createNodeTransport, } from "@stigmer/sdk/node";
+// Markdown
+export { renderMarkdown } from "./markdown.js";
+// Components
+export { MessageEntry } from "./components/MessageEntry.js";
+export { MessageThread } from "./components/MessageThread.js";
+export { ToolCallItem } from "./components/ToolCallItem.js";
+export { ToolCallGroup } from "./components/ToolCallGroup.js";
+export { SubAgentBlock } from "./components/SubAgentBlock.js";
+export { TodoList } from "./components/TodoList.js";
+export { ApprovalPrompt } from "./components/ApprovalPrompt.js";
+export { ExecutionProgress } from "./components/ExecutionProgress.js";
+export { FollowUpInput } from "./components/FollowUpInput.js";
+export { UsageWidget } from "./components/UsageWidget.js";
+// Composed views
+export { SessionView } from "./app/SessionView.js";
+export { SessionApp } from "./app/SessionApp.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AAEjF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAyB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}

package/markdown.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Render a markdown string to ANSI-styled terminal output.
+ *
+ * Uses `marked` with `marked-terminal` to produce styled text suitable
+ * for display in a terminal. Supports headings, code blocks (with syntax
+ * highlighting), lists, bold/italic, links, tables, and blockquotes.
+ *
+ * @param content - Raw markdown string.
+ * @param width - Terminal width for text wrapping. Defaults to `process.stdout.columns` or 80.
+ * @returns ANSI-styled string ready for terminal output.
+ *
+ * @example
+ * ```ts
+ * import { renderMarkdown } from "@stigmer/ink";
+ *
+ * const ansi = renderMarkdown("**Hello** from the agent!");
+ * process.stdout.write(ansi);
+ * ```
+ */
+export declare function renderMarkdown(content: string, width?: number): string;
+//# sourceMappingURL=markdown.d.ts.map

package/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtE"}

package/markdown.js

@@ -0,0 +1,44 @@
+import { Marked } from "marked";
+import { markedTerminal } from "marked-terminal";
+let _marked = null;
+function getMarked(width) {
+    if (_marked && !width)
+        return _marked;
+    const instance = new Marked();
+    instance.use(markedTerminal({
+        width: width ?? process.stdout.columns ?? 80,
+        reflowText: true,
+        showSectionPrefix: false,
+    }));
+    if (!width)
+        _marked = instance;
+    return instance;
+}
+/**
+ * Render a markdown string to ANSI-styled terminal output.
+ *
+ * Uses `marked` with `marked-terminal` to produce styled text suitable
+ * for display in a terminal. Supports headings, code blocks (with syntax
+ * highlighting), lists, bold/italic, links, tables, and blockquotes.
+ *
+ * @param content - Raw markdown string.
+ * @param width - Terminal width for text wrapping. Defaults to `process.stdout.columns` or 80.
+ * @returns ANSI-styled string ready for terminal output.
+ *
+ * @example
+ * ```ts
+ * import { renderMarkdown } from "@stigmer/ink";
+ *
+ * const ansi = renderMarkdown("**Hello** from the agent!");
+ * process.stdout.write(ansi);
+ * ```
+ */
+export function renderMarkdown(content, width) {
+    const marked = getMarked(width);
+    const result = marked.parse(content);
+    if (typeof result !== "string") {
+        return content;
+    }
+    return result.trimEnd();
+}
+//# sourceMappingURL=markdown.js.map

package/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAEtC,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,GAAG,CACV,cAAc,CAAC;QACb,KAAK,EAAE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;QAC5C,UAAU,EAAE,IAAI;QAChB,iBAAiB,EAAE,KAAK;KACzB,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAAc;IAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@stigmer/ink",
+  "version": "0.0.88",
+  "description": "Ink (React for terminals) components for rendering Stigmer agent sessions in the terminal",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stigmer/stigmer.git",
+    "directory": "sdk/ink"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "stigmer",
+    "ink",
+    "terminal",
+    "cli",
+    "react",
+    "ai-agents",
+    "tui"
+  ],
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@connectrpc/connect-node": "^2.1.1",
+    "@stigmer/react": "0.0.88",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^15.0.7",
+    "marked-terminal": "^7.3.0"
+  },
+  "peerDependencies": {
+    "@bufbuild/protobuf": "^2.0.0",
+    "@stigmer/protos": "0.0.88",
+    "@stigmer/sdk": "0.0.88",
+    "ink": "^7.0.0",
+    "react": ">=19.0.0"
+  }
+}

package/provider.d.ts

@@ -0,0 +1,46 @@
+import { type ReactNode } from "react";
+import type { Stigmer, DeploymentMode } from "@stigmer/sdk";
+/**
+ * Props for {@link InkStigmerProvider}.
+ */
+export interface InkStigmerProviderProps {
+    /** Pre-configured Stigmer client (use {@link createNodeClient} to create one). */
+    client: Stigmer;
+    /** Child components to render. */
+    children: ReactNode;
+    /**
+     * Deployment mode for feature gating.
+     * - `"cloud"`: All features available (default).
+     * - `"local"`: OSS feature subset only.
+     */
+    deploymentMode?: DeploymentMode;
+}
+/**
+ * Stigmer provider for Ink (terminal) environments.
+ *
+ * Provides the same React contexts as `StigmerProvider` from
+ * `@stigmer/react`, but without the DOM `<div>` wrapper used for
+ * CSS scoping (which is not applicable in a terminal).
+ *
+ * All hooks from `@stigmer/react` (`useStigmer`, `useSessionConversation`,
+ * `useExecutionStream`, etc.) work identically under this provider.
+ *
+ * @example
+ * ```tsx
+ * import { render } from "ink";
+ * import { InkStigmerProvider, createNodeClient } from "@stigmer/ink";
+ *
+ * const client = createNodeClient({
+ *   baseUrl: "https://api.stigmer.ai",
+ *   apiKey: process.env.STIGMER_API_KEY,
+ * });
+ *
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <MyTerminalApp />
+ *   </InkStigmerProvider>
+ * );
+ * ```
+ */
+export declare function InkStigmerProvider({ client, children, deploymentMode, }: InkStigmerProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=provider.d.ts.map

package/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,MAAM,EAAE,OAAO,CAAC;IAEhB,kCAAkC;IAClC,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,QAAQ,EACR,cAAwB,GACzB,EAAE,uBAAuB,2CAQzB"}

package/provider.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { StigmerContext, DeploymentModeContext } from "@stigmer/react";
+/**
+ * Stigmer provider for Ink (terminal) environments.
+ *
+ * Provides the same React contexts as `StigmerProvider` from
+ * `@stigmer/react`, but without the DOM `<div>` wrapper used for
+ * CSS scoping (which is not applicable in a terminal).
+ *
+ * All hooks from `@stigmer/react` (`useStigmer`, `useSessionConversation`,
+ * `useExecutionStream`, etc.) work identically under this provider.
+ *
+ * @example
+ * ```tsx
+ * import { render } from "ink";
+ * import { InkStigmerProvider, createNodeClient } from "@stigmer/ink";
+ *
+ * const client = createNodeClient({
+ *   baseUrl: "https://api.stigmer.ai",
+ *   apiKey: process.env.STIGMER_API_KEY,
+ * });
+ *
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <MyTerminalApp />
+ *   </InkStigmerProvider>
+ * );
+ * ```
+ */
+export function InkStigmerProvider({ client, children, deploymentMode = "cloud", }) {
+    return (_jsx(StigmerContext.Provider, { value: client, children: _jsx(DeploymentModeContext.Provider, { value: deploymentMode, children: children }) }));
+}
+//# sourceMappingURL=provider.js.map

package/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAqBvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,QAAQ,EACR,cAAc,GAAG,OAAO,GACA;IACxB,OAAO,CACL,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YACpC,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,cAAc,YAClD,QAAQ,GACsB,GACT,CAC3B,CAAC;AACJ,CAAC"}

package/src/__tests__/components.test.tsx

@@ -0,0 +1,162 @@
+import React from "react";
+import { describe, it, expect } from "vitest";
+import { render } from "ink-testing-library";
+import { Text, Box } from "ink";
+import { create } from "@bufbuild/protobuf";
+import { AgentMessageSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { MessageType, ExecutionPhase, ToolCallStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ToolCallSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { MessageEntry } from "../components/MessageEntry.js";
+import { ExecutionProgress } from "../components/ExecutionProgress.js";
+import { ToolCallItem } from "../components/ToolCallItem.js";
+
+describe("MessageEntry", () => {
+  it("renders a human message with 'You' prefix", () => {
+    const msg = create(AgentMessageSchema);
+    msg.type = MessageType.MESSAGE_HUMAN;
+    msg.content = "Hello agent";
+
+    const { lastFrame } = render(<MessageEntry message={msg} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("You");
+    expect(output).toContain("Hello agent");
+  });
+
+  it("renders an AI message with 'Agent' prefix", () => {
+    const msg = create(AgentMessageSchema);
+    msg.type = MessageType.MESSAGE_AI;
+    msg.content = "Here is the answer";
+    msg.isStreaming = false;
+
+    const { lastFrame } = render(<MessageEntry message={msg} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Agent");
+    expect(output).toContain("answer");
+  });
+
+  it("renders a system message in dim style", () => {
+    const msg = create(AgentMessageSchema);
+    msg.type = MessageType.MESSAGE_SYSTEM;
+    msg.content = "System notice";
+
+    const { lastFrame } = render(<MessageEntry message={msg} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("System notice");
+  });
+
+  it("renders nothing for tool messages", () => {
+    const msg = create(AgentMessageSchema);
+    msg.type = MessageType.MESSAGE_TOOL;
+    msg.content = "tool result";
+
+    const { lastFrame } = render(<MessageEntry message={msg} />);
+    expect(lastFrame()).toBe("");
+  });
+
+  it("shows 'Thinking...' for streaming AI with no content", () => {
+    const msg = create(AgentMessageSchema);
+    msg.type = MessageType.MESSAGE_AI;
+    msg.content = "";
+    msg.isStreaming = true;
+
+    const { lastFrame } = render(<MessageEntry message={msg} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Thinking...");
+  });
+});
+
+describe("ExecutionProgress", () => {
+  it("shows 'Running' for in-progress phase", () => {
+    const { lastFrame } = render(
+      <ExecutionProgress phase={ExecutionPhase.EXECUTION_IN_PROGRESS} />,
+    );
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Running");
+  });
+
+  it("shows 'Completed' with check for completed phase", () => {
+    const { lastFrame } = render(
+      <ExecutionProgress phase={ExecutionPhase.EXECUTION_COMPLETED} />,
+    );
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Completed");
+    expect(output).toContain("✓");
+  });
+
+  it("shows 'Failed' for failed phase", () => {
+    const { lastFrame } = render(
+      <ExecutionProgress phase={ExecutionPhase.EXECUTION_FAILED} />,
+    );
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Failed");
+  });
+
+  it("shows 'Waiting for approval' for approval phase", () => {
+    const { lastFrame } = render(
+      <ExecutionProgress
+        phase={ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL}
+      />,
+    );
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Waiting for approval");
+  });
+
+  it("renders nothing for unspecified phase", () => {
+    const { lastFrame } = render(
+      <ExecutionProgress
+        phase={ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED}
+      />,
+    );
+    expect(lastFrame()).toBe("");
+  });
+});
+
+describe("ToolCallItem", () => {
+  it("renders tool name with status indicator", () => {
+    const tc = create(ToolCallSchema);
+    tc.id = "tc-1";
+    tc.name = "read_file";
+    tc.status = ToolCallStatus.TOOL_CALL_COMPLETED;
+
+    const { lastFrame } = render(<ToolCallItem toolCall={tc} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("read_file");
+    expect(output).toContain("✓");
+  });
+
+  it("shows running indicator for running tools", () => {
+    const tc = create(ToolCallSchema);
+    tc.id = "tc-2";
+    tc.name = "write_file";
+    tc.status = ToolCallStatus.TOOL_CALL_RUNNING;
+
+    const { lastFrame } = render(<ToolCallItem toolCall={tc} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("write_file");
+    expect(output).toContain("running");
+  });
+
+  it("shows error for failed tools when expanded", () => {
+    const tc = create(ToolCallSchema);
+    tc.id = "tc-3";
+    tc.name = "execute_command";
+    tc.status = ToolCallStatus.TOOL_CALL_FAILED;
+    tc.error = "Permission denied";
+
+    const { lastFrame } = render(<ToolCallItem toolCall={tc} expanded />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("Permission denied");
+  });
+
+  it("shows MCP server slug prefix", () => {
+    const tc = create(ToolCallSchema);
+    tc.id = "tc-4";
+    tc.name = "list_resources";
+    tc.mcpServerSlug = "github";
+    tc.status = ToolCallStatus.TOOL_CALL_COMPLETED;
+
+    const { lastFrame } = render(<ToolCallItem toolCall={tc} />);
+    const output = lastFrame() ?? "";
+    expect(output).toContain("github/list_resources");
+  });
+});

package/src/__tests__/markdown.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from "vitest";
+import { renderMarkdown } from "../markdown.js";
+
+describe("renderMarkdown", () => {
+  it("renders plain text without modification", () => {
+    const result = renderMarkdown("Hello world");
+    expect(result).toContain("Hello world");
+  });
+
+  it("renders bold text with ANSI styling", () => {
+    const result = renderMarkdown("This is **bold** text");
+    expect(result).toContain("bold");
+    expect(result).not.toBe("This is **bold** text");
+  });
+
+  it("renders code blocks", () => {
+    const result = renderMarkdown("```\nconst x = 1;\n```");
+    expect(result).toContain("const x = 1");
+  });
+
+  it("renders headings", () => {
+    const result = renderMarkdown("# Title");
+    expect(result).toContain("Title");
+  });
+
+  it("renders lists", () => {
+    const result = renderMarkdown("- item one\n- item two");
+    expect(result).toContain("item one");
+    expect(result).toContain("item two");
+  });
+
+  it("handles empty content", () => {
+    const result = renderMarkdown("");
+    expect(result).toBe("");
+  });
+
+  it("trims trailing whitespace", () => {
+    const result = renderMarkdown("Hello");
+    expect(result).toBe(result.trimEnd());
+  });
+
+  it("accepts custom width", () => {
+    const result = renderMarkdown("A very long sentence that might wrap", 40);
+    expect(result).toContain("A very long sentence");
+  });
+});