@agentskit/ink 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emerson Braun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,131 @@
+'use strict';
+
+var core = require('@agentskit/core');
+var react = require('react');
+var ink = require('ink');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/index.ts
+function useChat(config) {
+  const controllerRef = react.useRef(null);
+  if (!controllerRef.current) {
+    controllerRef.current = core.createChatController(config);
+  }
+  react.useEffect(() => {
+    controllerRef.current?.updateConfig(config);
+  }, [config]);
+  const state = react.useSyncExternalStore(
+    controllerRef.current.subscribe,
+    controllerRef.current.getState,
+    controllerRef.current.getState
+  );
+  return {
+    ...state,
+    send: controllerRef.current.send,
+    stop: controllerRef.current.stop,
+    retry: controllerRef.current.retry,
+    setInput: controllerRef.current.setInput,
+    clear: controllerRef.current.clear
+  };
+}
+function ChatContainer({ children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { flexDirection: "column", gap: 1, children });
+}
+function roleColor(role) {
+  switch (role) {
+    case "assistant":
+      return "cyan";
+    case "user":
+      return "green";
+    case "system":
+      return "yellow";
+    case "tool":
+      return "magenta";
+    default:
+      return "white";
+  }
+}
+function Message({ message }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, color: roleColor(message.role), children: message.role.toUpperCase() }),
+    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { children: message.content || (message.status === "streaming" ? "..." : "") })
+  ] });
+}
+function InputBar({ chat, placeholder = "Type a message...", disabled = false }) {
+  ink.useInput((input, key) => {
+    if (disabled || chat.status === "streaming") return;
+    if (key.return) {
+      if (chat.input.trim()) {
+        void chat.send(chat.input);
+      }
+      return;
+    }
+    if (key.backspace || key.delete) {
+      chat.setInput(chat.input.slice(0, -1));
+      return;
+    }
+    if (input && !key.ctrl && !key.meta) {
+      chat.setInput(`${chat.input}${input}`);
+    }
+  });
+  return /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: placeholder }),
+    /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { color: disabled ? "gray" : "white", children: [
+      "> ",
+      chat.input
+    ] })
+  ] });
+}
+function ToolCallView({ toolCall, expanded = false }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", borderStyle: "round", paddingX: 1, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { color: "magenta", children: [
+      "Tool: ",
+      toolCall.name,
+      " [",
+      toolCall.status,
+      "]"
+    ] }),
+    expanded ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: JSON.stringify(toolCall.args) }),
+      toolCall.result ? /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { children: toolCall.result }) : null,
+      toolCall.error ? /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: "red", children: toolCall.error }) : null
+    ] }) : null
+  ] });
+}
+function ThinkingIndicator({ visible, label = "Thinking..." }) {
+  if (!visible) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: "yellow", children: label });
+}
+
+Object.defineProperty(exports, "createChatController", {
+  enumerable: true,
+  get: function () { return core.createChatController; }
+});
+Object.defineProperty(exports, "createFileMemory", {
+  enumerable: true,
+  get: function () { return core.createFileMemory; }
+});
+Object.defineProperty(exports, "createInMemoryMemory", {
+  enumerable: true,
+  get: function () { return core.createInMemoryMemory; }
+});
+Object.defineProperty(exports, "createLocalStorageMemory", {
+  enumerable: true,
+  get: function () { return core.createLocalStorageMemory; }
+});
+Object.defineProperty(exports, "createStaticRetriever", {
+  enumerable: true,
+  get: function () { return core.createStaticRetriever; }
+});
+Object.defineProperty(exports, "formatRetrievedDocuments", {
+  enumerable: true,
+  get: function () { return core.formatRetrievedDocuments; }
+});
+exports.ChatContainer = ChatContainer;
+exports.InputBar = InputBar;
+exports.Message = Message;
+exports.ThinkingIndicator = ThinkingIndicator;
+exports.ToolCallView = ToolCallView;
+exports.useChat = useChat;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useChat.ts","../src/components/ChatContainer.tsx","../src/components/Message.tsx","../src/components/InputBar.tsx","../src/components/ToolCallView.tsx","../src/components/ThinkingIndicator.tsx"],"names":["useRef","createChatController","useEffect","useSyncExternalStore","Box","jsxs","jsx","Text","useInput","Fragment"],"mappings":"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","file":"index.cjs","sourcesContent":["// NOTE: This hook is identical in @agentskit/react and @agentskit/ink.\n// Changes here must be mirrored in packages/react/src/useChat.ts.\nimport { useEffect, useRef, useSyncExternalStore } from 'react'\nimport { createChatController } from '@agentskit/core'\nimport type { ChatConfig, ChatController, ChatReturn } from '@agentskit/core'\n\nexport function useChat(config: ChatConfig): ChatReturn {\n  const controllerRef = useRef<ChatController | null>(null)\n\n  if (!controllerRef.current) {\n    controllerRef.current = createChatController(config)\n  }\n\n  useEffect(() => {\n    controllerRef.current?.updateConfig(config)\n  }, [config])\n\n  const state = useSyncExternalStore(\n    controllerRef.current.subscribe,\n    controllerRef.current.getState,\n    controllerRef.current.getState\n  )\n\n  return {\n    ...state,\n    send: controllerRef.current.send,\n    stop: controllerRef.current.stop,\n    retry: controllerRef.current.retry,\n    setInput: controllerRef.current.setInput,\n    clear: controllerRef.current.clear,\n  }\n}\n","import React, { type ReactNode } from 'react'\nimport { Box } from 'ink'\n\nexport interface ChatContainerProps {\n  children: ReactNode\n}\n\nexport function ChatContainer({ children }: ChatContainerProps) {\n  return (\n    <Box flexDirection=\"column\" gap={1}>\n      {children}\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Box, Text } from 'ink'\nimport type { Message as MessageType } from '@agentskit/core'\n\nexport interface MessageProps {\n  message: MessageType\n}\n\nfunction roleColor(role: MessageType['role']) {\n  switch (role) {\n    case 'assistant':\n      return 'cyan'\n    case 'user':\n      return 'green'\n    case 'system':\n      return 'yellow'\n    case 'tool':\n      return 'magenta'\n    default:\n      return 'white'\n  }\n}\n\nexport function Message({ message }: MessageProps) {\n  return (\n    <Box flexDirection=\"column\">\n      <Text bold color={roleColor(message.role)}>\n        {message.role.toUpperCase()}\n      </Text>\n      <Text>{message.content || (message.status === 'streaming' ? '...' : '')}</Text>\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Box, Text, useInput } from 'ink'\nimport type { ChatReturn } from '@agentskit/core'\n\nexport interface InputBarProps {\n  chat: ChatReturn\n  placeholder?: string\n  disabled?: boolean\n}\n\nexport function InputBar({ chat, placeholder = 'Type a message...', disabled = false }: InputBarProps) {\n  useInput((input, key) => {\n    if (disabled || chat.status === 'streaming') return\n\n    if (key.return) {\n      if (chat.input.trim()) {\n        void chat.send(chat.input)\n      }\n      return\n    }\n\n    if (key.backspace || key.delete) {\n      chat.setInput(chat.input.slice(0, -1))\n      return\n    }\n\n    if (input && !key.ctrl && !key.meta) {\n      chat.setInput(`${chat.input}${input}`)\n    }\n  })\n\n  return (\n    <Box flexDirection=\"column\">\n      <Text dimColor>{placeholder}</Text>\n      <Text color={disabled ? 'gray' : 'white'}>\n        &gt; {chat.input}\n      </Text>\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Box, Text } from 'ink'\nimport type { ToolCall } from '@agentskit/core'\n\nexport interface ToolCallViewProps {\n  toolCall: ToolCall\n  expanded?: boolean\n}\n\nexport function ToolCallView({ toolCall, expanded = false }: ToolCallViewProps) {\n  return (\n    <Box flexDirection=\"column\" borderStyle=\"round\" paddingX={1}>\n      <Text color=\"magenta\">\n        Tool: {toolCall.name} [{toolCall.status}]\n      </Text>\n      {expanded ? (\n        <>\n          <Text dimColor>{JSON.stringify(toolCall.args)}</Text>\n          {toolCall.result ? <Text>{toolCall.result}</Text> : null}\n          {toolCall.error ? <Text color=\"red\">{toolCall.error}</Text> : null}\n        </>\n      ) : null}\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Text } from 'ink'\n\nexport interface ThinkingIndicatorProps {\n  visible: boolean\n  label?: string\n}\n\nexport function ThinkingIndicator({ visible, label = 'Thinking...' }: ThinkingIndicatorProps) {\n  if (!visible) return null\n  return <Text color=\"yellow\">{label}</Text>\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+import { ChatConfig, ChatReturn, Message as Message$1, ToolCall } from '@agentskit/core';
+export { AdapterContext, AdapterFactory, AdapterRequest, ChatConfig, ChatController, ChatMemory, ChatReturn, ChatState, MaybePromise, MemoryRecord, MessageRole, MessageStatus, Message as MessageType, RetrievedDocument, Retriever, RetrieverRequest, StreamChunk, StreamSource, StreamStatus, StreamToolCallPayload, ToolCall, ToolCallHandlerContext, ToolCallStatus, ToolDefinition, ToolExecutionContext, UseStreamOptions, UseStreamReturn, createChatController, createFileMemory, createInMemoryMemory, createLocalStorageMemory, createStaticRetriever, formatRetrievedDocuments } from '@agentskit/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+declare function useChat(config: ChatConfig): ChatReturn;
+
+interface ChatContainerProps {
+    children: ReactNode;
+}
+declare function ChatContainer({ children }: ChatContainerProps): react_jsx_runtime.JSX.Element;
+
+interface MessageProps {
+    message: Message$1;
+}
+declare function Message({ message }: MessageProps): react_jsx_runtime.JSX.Element;
+
+interface InputBarProps {
+    chat: ChatReturn;
+    placeholder?: string;
+    disabled?: boolean;
+}
+declare function InputBar({ chat, placeholder, disabled }: InputBarProps): react_jsx_runtime.JSX.Element;
+
+interface ToolCallViewProps {
+    toolCall: ToolCall;
+    expanded?: boolean;
+}
+declare function ToolCallView({ toolCall, expanded }: ToolCallViewProps): react_jsx_runtime.JSX.Element;
+
+interface ThinkingIndicatorProps {
+    visible: boolean;
+    label?: string;
+}
+declare function ThinkingIndicator({ visible, label }: ThinkingIndicatorProps): react_jsx_runtime.JSX.Element | null;
+
+export { ChatContainer, type ChatContainerProps, InputBar, type InputBarProps, Message, type MessageProps, ThinkingIndicator, type ThinkingIndicatorProps, ToolCallView, type ToolCallViewProps, useChat };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { ChatConfig, ChatReturn, Message as Message$1, ToolCall } from '@agentskit/core';
+export { AdapterContext, AdapterFactory, AdapterRequest, ChatConfig, ChatController, ChatMemory, ChatReturn, ChatState, MaybePromise, MemoryRecord, MessageRole, MessageStatus, Message as MessageType, RetrievedDocument, Retriever, RetrieverRequest, StreamChunk, StreamSource, StreamStatus, StreamToolCallPayload, ToolCall, ToolCallHandlerContext, ToolCallStatus, ToolDefinition, ToolExecutionContext, UseStreamOptions, UseStreamReturn, createChatController, createFileMemory, createInMemoryMemory, createLocalStorageMemory, createStaticRetriever, formatRetrievedDocuments } from '@agentskit/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+declare function useChat(config: ChatConfig): ChatReturn;
+
+interface ChatContainerProps {
+    children: ReactNode;
+}
+declare function ChatContainer({ children }: ChatContainerProps): react_jsx_runtime.JSX.Element;
+
+interface MessageProps {
+    message: Message$1;
+}
+declare function Message({ message }: MessageProps): react_jsx_runtime.JSX.Element;
+
+interface InputBarProps {
+    chat: ChatReturn;
+    placeholder?: string;
+    disabled?: boolean;
+}
+declare function InputBar({ chat, placeholder, disabled }: InputBarProps): react_jsx_runtime.JSX.Element;
+
+interface ToolCallViewProps {
+    toolCall: ToolCall;
+    expanded?: boolean;
+}
+declare function ToolCallView({ toolCall, expanded }: ToolCallViewProps): react_jsx_runtime.JSX.Element;
+
+interface ThinkingIndicatorProps {
+    visible: boolean;
+    label?: string;
+}
+declare function ThinkingIndicator({ visible, label }: ThinkingIndicatorProps): react_jsx_runtime.JSX.Element | null;
+
+export { ChatContainer, type ChatContainerProps, InputBar, type InputBarProps, Message, type MessageProps, ThinkingIndicator, type ThinkingIndicatorProps, ToolCallView, type ToolCallViewProps, useChat };

package/dist/index.js

@@ -0,0 +1,101 @@
+import { createChatController } from '@agentskit/core';
+export { createChatController, createFileMemory, createInMemoryMemory, createLocalStorageMemory, createStaticRetriever, formatRetrievedDocuments } from '@agentskit/core';
+import { useRef, useEffect, useSyncExternalStore } from 'react';
+import { Box, Text, useInput } from 'ink';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+// src/index.ts
+function useChat(config) {
+  const controllerRef = useRef(null);
+  if (!controllerRef.current) {
+    controllerRef.current = createChatController(config);
+  }
+  useEffect(() => {
+    controllerRef.current?.updateConfig(config);
+  }, [config]);
+  const state = useSyncExternalStore(
+    controllerRef.current.subscribe,
+    controllerRef.current.getState,
+    controllerRef.current.getState
+  );
+  return {
+    ...state,
+    send: controllerRef.current.send,
+    stop: controllerRef.current.stop,
+    retry: controllerRef.current.retry,
+    setInput: controllerRef.current.setInput,
+    clear: controllerRef.current.clear
+  };
+}
+function ChatContainer({ children }) {
+  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", gap: 1, children });
+}
+function roleColor(role) {
+  switch (role) {
+    case "assistant":
+      return "cyan";
+    case "user":
+      return "green";
+    case "system":
+      return "yellow";
+    case "tool":
+      return "magenta";
+    default:
+      return "white";
+  }
+}
+function Message({ message }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, color: roleColor(message.role), children: message.role.toUpperCase() }),
+    /* @__PURE__ */ jsx(Text, { children: message.content || (message.status === "streaming" ? "..." : "") })
+  ] });
+}
+function InputBar({ chat, placeholder = "Type a message...", disabled = false }) {
+  useInput((input, key) => {
+    if (disabled || chat.status === "streaming") return;
+    if (key.return) {
+      if (chat.input.trim()) {
+        void chat.send(chat.input);
+      }
+      return;
+    }
+    if (key.backspace || key.delete) {
+      chat.setInput(chat.input.slice(0, -1));
+      return;
+    }
+    if (input && !key.ctrl && !key.meta) {
+      chat.setInput(`${chat.input}${input}`);
+    }
+  });
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: placeholder }),
+    /* @__PURE__ */ jsxs(Text, { color: disabled ? "gray" : "white", children: [
+      "> ",
+      chat.input
+    ] })
+  ] });
+}
+function ToolCallView({ toolCall, expanded = false }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", borderStyle: "round", paddingX: 1, children: [
+    /* @__PURE__ */ jsxs(Text, { color: "magenta", children: [
+      "Tool: ",
+      toolCall.name,
+      " [",
+      toolCall.status,
+      "]"
+    ] }),
+    expanded ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: JSON.stringify(toolCall.args) }),
+      toolCall.result ? /* @__PURE__ */ jsx(Text, { children: toolCall.result }) : null,
+      toolCall.error ? /* @__PURE__ */ jsx(Text, { color: "red", children: toolCall.error }) : null
+    ] }) : null
+  ] });
+}
+function ThinkingIndicator({ visible, label = "Thinking..." }) {
+  if (!visible) return null;
+  return /* @__PURE__ */ jsx(Text, { color: "yellow", children: label });
+}
+
+export { ChatContainer, InputBar, Message, ThinkingIndicator, ToolCallView, useChat };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useChat.ts","../src/components/ChatContainer.tsx","../src/components/Message.tsx","../src/components/InputBar.tsx","../src/components/ToolCallView.tsx","../src/components/ThinkingIndicator.tsx"],"names":["Box","jsx","jsxs","Text"],"mappings":"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","file":"index.js","sourcesContent":["// NOTE: This hook is identical in @agentskit/react and @agentskit/ink.\n// Changes here must be mirrored in packages/react/src/useChat.ts.\nimport { useEffect, useRef, useSyncExternalStore } from 'react'\nimport { createChatController } from '@agentskit/core'\nimport type { ChatConfig, ChatController, ChatReturn } from '@agentskit/core'\n\nexport function useChat(config: ChatConfig): ChatReturn {\n  const controllerRef = useRef<ChatController | null>(null)\n\n  if (!controllerRef.current) {\n    controllerRef.current = createChatController(config)\n  }\n\n  useEffect(() => {\n    controllerRef.current?.updateConfig(config)\n  }, [config])\n\n  const state = useSyncExternalStore(\n    controllerRef.current.subscribe,\n    controllerRef.current.getState,\n    controllerRef.current.getState\n  )\n\n  return {\n    ...state,\n    send: controllerRef.current.send,\n    stop: controllerRef.current.stop,\n    retry: controllerRef.current.retry,\n    setInput: controllerRef.current.setInput,\n    clear: controllerRef.current.clear,\n  }\n}\n","import React, { type ReactNode } from 'react'\nimport { Box } from 'ink'\n\nexport interface ChatContainerProps {\n  children: ReactNode\n}\n\nexport function ChatContainer({ children }: ChatContainerProps) {\n  return (\n    <Box flexDirection=\"column\" gap={1}>\n      {children}\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Box, Text } from 'ink'\nimport type { Message as MessageType } from '@agentskit/core'\n\nexport interface MessageProps {\n  message: MessageType\n}\n\nfunction roleColor(role: MessageType['role']) {\n  switch (role) {\n    case 'assistant':\n      return 'cyan'\n    case 'user':\n      return 'green'\n    case 'system':\n      return 'yellow'\n    case 'tool':\n      return 'magenta'\n    default:\n      return 'white'\n  }\n}\n\nexport function Message({ message }: MessageProps) {\n  return (\n    <Box flexDirection=\"column\">\n      <Text bold color={roleColor(message.role)}>\n        {message.role.toUpperCase()}\n      </Text>\n      <Text>{message.content || (message.status === 'streaming' ? '...' : '')}</Text>\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Box, Text, useInput } from 'ink'\nimport type { ChatReturn } from '@agentskit/core'\n\nexport interface InputBarProps {\n  chat: ChatReturn\n  placeholder?: string\n  disabled?: boolean\n}\n\nexport function InputBar({ chat, placeholder = 'Type a message...', disabled = false }: InputBarProps) {\n  useInput((input, key) => {\n    if (disabled || chat.status === 'streaming') return\n\n    if (key.return) {\n      if (chat.input.trim()) {\n        void chat.send(chat.input)\n      }\n      return\n    }\n\n    if (key.backspace || key.delete) {\n      chat.setInput(chat.input.slice(0, -1))\n      return\n    }\n\n    if (input && !key.ctrl && !key.meta) {\n      chat.setInput(`${chat.input}${input}`)\n    }\n  })\n\n  return (\n    <Box flexDirection=\"column\">\n      <Text dimColor>{placeholder}</Text>\n      <Text color={disabled ? 'gray' : 'white'}>\n        &gt; {chat.input}\n      </Text>\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Box, Text } from 'ink'\nimport type { ToolCall } from '@agentskit/core'\n\nexport interface ToolCallViewProps {\n  toolCall: ToolCall\n  expanded?: boolean\n}\n\nexport function ToolCallView({ toolCall, expanded = false }: ToolCallViewProps) {\n  return (\n    <Box flexDirection=\"column\" borderStyle=\"round\" paddingX={1}>\n      <Text color=\"magenta\">\n        Tool: {toolCall.name} [{toolCall.status}]\n      </Text>\n      {expanded ? (\n        <>\n          <Text dimColor>{JSON.stringify(toolCall.args)}</Text>\n          {toolCall.result ? <Text>{toolCall.result}</Text> : null}\n          {toolCall.error ? <Text color=\"red\">{toolCall.error}</Text> : null}\n        </>\n      ) : null}\n    </Box>\n  )\n}\n","import React from 'react'\nimport { Text } from 'ink'\n\nexport interface ThinkingIndicatorProps {\n  visible: boolean\n  label?: string\n}\n\nexport function ThinkingIndicator({ visible, label = 'Thinking...' }: ThinkingIndicatorProps) {\n  if (!visible) return null\n  return <Text color=\"yellow\">{label}</Text>\n}\n"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@agentskit/ink",
+  "version": "0.4.0",
+  "description": "Ink terminal components and hooks for AgentsKit.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ink": "^5.1.1",
+    "@agentskit/core": "0.4.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/react": "^18.3.0",
+    "ink-testing-library": "^4.0.0",
+    "react": "^18.3.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "dev": "tsup --watch"
+  }
+}