@ruska/cli 0.1.3 → 0.1.5

package/README.md

@@ -35,18 +35,23 @@ $ ruska --help
     auth              Configure API authentication
     assistants        List your assistants
     assistant <id>    Get assistant by ID
-    chat <message>    Chat with an assistant or continue a thread
+    chat <message>    Chat with the LLM (optionally with an assistant)
     create            Create a new assistant
     models            List available models
+    version           Show CLI and API version
+    health            Check API health status
 
   Options
     --ui              Launch interactive TUI mode
 
   Chat Options
-    -a, --assistant   Assistant ID for new conversations
+    -a, --assistant   Assistant ID (optional, uses default chat if omitted)
     -t, --thread      Thread ID to continue a conversation
     -m, --message     Message (alternative to positional arg)
     --json            Output as newline-delimited JSON (auto-enabled when piped)
+    --truncate <n>    Max characters for tool output (default: 500)
+    --truncate-lines  Max lines for tool output (default: 10)
+    --full-output     Disable truncation (show full output)
 
   Create Options
     --name            Assistant name (required)
@@ -59,8 +64,9 @@ $ ruska --help
   Examples
     $ ruska auth                                    # Configure API key and host
     $ ruska assistants                              # List your assistants
-    $ ruska assistant eed8d8b3-3dcd-4396-afba-...   # Get assistant details
-    $ ruska chat "Hello" -a <assistant-id>         # New conversation with assistant
+    $ ruska assistant abc-123                       # Get assistant details
+    $ ruska chat "Hello"                           # Direct chat with default LLM
+    $ ruska chat "Hello" -a <assistant-id>         # Chat with specific assistant
     $ ruska chat "Follow up" -t <thread-id>        # Continue existing thread
     $ ruska chat "Hello" -a <id> --json            # Output as NDJSON
     $ ruska chat "Query" -a <id> | jq '.type'      # Pipe to jq
@@ -128,7 +134,13 @@ Tools: get_exchange_rate, convert_currency
 
 ### `ruska chat <message>`
 
-Chat with an assistant or continue a thread using streaming. Requires authentication.
+Chat with the LLM (optionally with an assistant) using streaming. Requires authentication.
+
+**Direct chat with default LLM:**
+
+```bash
+$ ruska chat "Hello, how are you?"
+```
 
 **Start a new conversation with an assistant:**
 
@@ -159,12 +171,38 @@ $ ruska chat "Hello" -a <assistant-id> | jq '.type'
 
 **Options:**
 
-| Option            | Description                                     |
-| ----------------- | ----------------------------------------------- |
-| `-a, --assistant` | Assistant ID for new conversations              |
-| `-t, --thread`    | Thread ID to continue an existing conversation  |
-| `-m, --message`   | Message to send (alternative to positional arg) |
-| `--json`          | Output as newline-delimited JSON (NDJSON)       |
+| Option             | Description                                           |
+| ------------------ | ----------------------------------------------------- |
+| `-a, --assistant`  | Assistant ID (optional, uses default chat if omitted) |
+| `-t, --thread`     | Thread ID to continue an existing conversation        |
+| `-m, --message`    | Message to send (alternative to positional arg)       |
+| `--tools`          | Tools for the chat session (see below for modes)      |
+| `--json`           | Output as newline-delimited JSON (NDJSON)             |
+| `--truncate <n>`   | Max characters for tool output (default: 500)         |
+| `--truncate-lines` | Max lines for tool output (default: 10)               |
+| `--full-output`    | Disable truncation (show full output)                 |
+
+**Tool options:**
+
+| Value                 | Behavior                                                                                |
+| --------------------- | --------------------------------------------------------------------------------------- |
+| (not provided)        | Uses default tools: web_search, web_scrape, math_calculator, think_tool, python_sandbox |
+| `--tools=disabled`    | Disables all tools                                                                      |
+| `--tools=tool1,tool2` | Uses only the specified tools                                                           |
+
+**Examples with tools:**
+
+```bash
+# Chat with default tools (web search, scrape, calculator, think, python)
+$ ruska chat "What's the weather in Dallas?"
+
+# Chat without any tools
+$ ruska chat "Tell me a joke" --tools=disabled
+
+# Chat with specific tools only
+$ ruska chat "Calculate 2+2" --tools=math_calculator
+$ ruska chat "Search and analyze" --tools=web_search,think_tool
+```
 
 **Exit codes:**
 
@@ -228,6 +266,28 @@ All Models (15):
  ...
 ```
 
+### `ruska version`
+
+Show CLI and API version information.
+
+```bash
+$ ruska version
+
+Ruska CLI v0.1.3
+API: https://chat.ruska.ai
+```
+
+### `ruska health`
+
+Check API health status.
+
+```bash
+$ ruska health
+
+API Health Check
+Status: healthy
+```
+
 ### `ruska --ui`
 
 Launch the interactive TUI (Terminal User Interface) mode with a full-screen interface.

package/dist/cli.js

@@ -10,6 +10,8 @@ import { runAssistantCommand } from './commands/assistant.js';
 import { runModelsCommand } from './commands/models.js';
 import { runCreateAssistantCommand } from './commands/create-assistant.js';
 import { runChatCommand } from './commands/chat.js';
+import { runVersionCommand } from './commands/version.js';
+import { runHealthCommand } from './commands/health.js';
 const cli = meow(`
 	Usage
 	  $ ruska <command> [options]
@@ -18,18 +20,26 @@ const cli = meow(`
 	  auth              Configure API authentication
 	  assistants        List your assistants
 	  assistant <id>    Get assistant by ID
-	  chat <message>    Chat with an assistant or continue a thread
+	  chat <message>    Chat with the LLM (optionally with an assistant)
 	  create            Create a new assistant
 	  models            List available models
+	  version           Show CLI and API version
+	  health            Check API health status
 
 	Options
 	  --ui              Launch interactive TUI mode
 
 	Chat Options
-	  -a, --assistant   Assistant ID for new conversations
+	  -a, --assistant   Assistant ID (optional, uses default chat if omitted)
 	  -t, --thread      Thread ID to continue a conversation
 	  -m, --message     Message (alternative to positional arg)
+	  --tools           Tools to enable (default: web_search,web_scrape,math_calculator,think_tool,python_sandbox)
+	                    Use --tools=disabled to disable all tools
+	                    Use --tools=tool1,tool2 for specific tools
 	  --json            Output as newline-delimited JSON (auto-enabled when piped)
+	  --truncate <n>    Max characters for tool output (default: 500)
+	  --truncate-lines  Max lines for tool output (default: 10)
+	  --full-output     Disable truncation (show full output)
 
 	Create Options
 	  --name            Assistant name (required)
@@ -43,7 +53,10 @@ const cli = meow(`
 	  $ ruska auth                                    # Configure API key and host
 	  $ ruska assistants                              # List your assistants
 	  $ ruska assistant abc-123                       # Get assistant details
-	  $ ruska chat "Hello" -a <assistant-id>         # New conversation with assistant
+	  $ ruska chat "Hello"                           # Chat with default tools enabled
+	  $ ruska chat "Hello" --tools=disabled          # Chat without any tools
+	  $ ruska chat "Search X" --tools=web_search     # Chat with specific tools
+	  $ ruska chat "Hello" -a <assistant-id>         # Chat with specific assistant
 	  $ ruska chat "Follow up" -t <thread-id>        # Continue existing thread
 	  $ ruska chat "Hello" -a <id> --json            # Output as NDJSON
 	  $ ruska chat "Query" -a <id> | jq '.type'      # Pipe to jq
@@ -74,6 +87,18 @@ const cli = meow(`
             type: 'string',
             shortFlag: 't',
         },
+        truncate: {
+            type: 'number',
+            default: 500,
+        },
+        truncateLines: {
+            type: 'number',
+            default: 10,
+        },
+        fullOutput: {
+            type: 'boolean',
+            default: false,
+        },
         interactive: {
             type: 'boolean',
             shortFlag: 'i',
@@ -96,7 +121,7 @@ const cli = meow(`
         },
     },
 });
-const [command, ...args] = cli.input;
+const [command, ...arguments_] = cli.input;
 // Route to appropriate command
 async function main() {
     if (cli.flags.ui) {
@@ -114,7 +139,7 @@ async function main() {
             break;
         }
         case 'assistant': {
-            const assistantId = args[0];
+            const assistantId = arguments_[0];
             if (!assistantId) {
                 console.error('Usage: ruska assistant <id>');
                 console.log('Run `ruska assistants` to list available assistants');
@@ -133,30 +158,23 @@ async function main() {
                 cli.flags['a']?.toString();
             const threadId = cli.flags.thread ??
                 cli.flags['t']?.toString();
-            const message = args.join(' ') || cli.flags.message;
-            // Require either assistant or thread
-            if (!assistantId && !threadId) {
-                console.error('Usage: ruska chat "<message>" -a <assistant-id>');
-                console.error('       ruska chat "<message>" -t <thread-id>');
-                console.log('');
-                console.log('Options:');
-                console.log('  -a, --assistant   Assistant ID for new conversations');
-                console.log('  -t, --thread      Thread ID to continue a conversation');
-                console.log('');
-                console.log('Examples:');
-                console.log('  ruska chat "Hello" -a abc-123');
-                console.log('  ruska chat "Follow up" -t thread-456');
-                process.exit(1);
-            }
+            const message = arguments_.join(' ') || cli.flags.message;
             if (!message) {
                 console.error('Error: Message is required');
-                console.error('Usage: ruska chat "<message>" -a <assistant-id>');
+                console.error('Usage: ruska chat "<message>" [-a <assistant-id>]');
                 process.exit(1);
             }
             await runChatCommand(message, {
                 json: cli.flags.json,
                 assistantId,
                 threadId,
+                tools: cli.flags.tools,
+                truncateOptions: cli.flags.fullOutput
+                    ? undefined
+                    : {
+                        maxLength: cli.flags.truncate,
+                        maxLines: cli.flags.truncateLines,
+                    },
             });
             break;
         }
@@ -174,6 +192,14 @@ async function main() {
             });
             break;
         }
+        case 'version': {
+            await runVersionCommand();
+            break;
+        }
+        case 'health': {
+            await runHealthCommand();
+            break;
+        }
         case 'help':
         case undefined: {
             cli.showHelp();

package/dist/commands/chat.d.ts

@@ -2,6 +2,7 @@
  * Chat command for streaming LLM responses
  * Implements Golden Path: Beta architecture + Gamma output + Alpha timeout
  */
+import { type TruncateOptions } from '../lib/output/truncate.js';
 /**
  * Run the chat command
  */
@@ -9,4 +10,6 @@ export declare function runChatCommand(message: string, options?: {
     json?: boolean;
     assistantId?: string;
     threadId?: string;
+    tools?: string;
+    truncateOptions?: TruncateOptions;
 }): Promise<void>;

package/dist/commands/chat.js

@@ -13,6 +13,8 @@ import { OutputFormatter } from '../lib/output/formatter.js';
 import { classifyError, exitCodes } from '../lib/output/error-handler.js';
 import { writeJson, checkIsTty } from '../lib/output/writers.js';
 import { StreamService, StreamConnectionError, } from '../lib/services/stream-service.js';
+import { truncate } from '../lib/output/truncate.js';
+import { parseToolsFlag } from '../lib/tools.js';
 /**
  * Group messages into blocks by type + name boundaries
  */
@@ -42,6 +44,21 @@ function groupMessagesIntoBlocks(messages) {
     }
     return blocks;
 }
+/**
+ * Extract model name from stream events
+ */
+function extractModelFromEvents(events) {
+    for (let i = events.length - 1; i >= 0; i--) {
+        const event = events[i];
+        if (event?.type === 'messages') {
+            const message = event.payload[0];
+            const modelName = message?.response_metadata?.['model_name'];
+            if (modelName)
+                return String(modelName);
+        }
+    }
+    return undefined;
+}
 /**
  * Status indicator component for TUI mode
  */
@@ -67,7 +84,7 @@ function StatusIndicator({ status }) {
 /**
  * TUI mode chat command using React hook
  */
-function ChatCommandTui({ message, assistantId, threadId, }) {
+function ChatCommandTui({ message, assistantId, threadId, tools, truncateOptions, }) {
     const { exit } = useApp();
     const [config, setConfig] = useState();
     const [authError, setAuthError] = useState(false);
@@ -90,15 +107,16 @@ function ChatCommandTui({ message, assistantId, threadId, }) {
     const request = useMemo(() => config
         ? {
             input: { messages: [{ role: 'user', content: message }] },
+            tools,
             metadata: {
                 ...(assistantId && { assistant_id: assistantId }),
                 ...(threadId && { thread_id: threadId }),
             },
         }
-        : undefined, [config, assistantId, message, threadId]);
+        : undefined, [config, assistantId, message, threadId, tools]);
     /* eslint-enable @typescript-eslint/naming-convention */
     // Stream
-    const { status, messages, error } = useStream(config, request);
+    const { status, messages, events, error } = useStream(config, request);
     // Group messages into blocks by type + name boundaries
     const messageBlocks = useMemo(() => groupMessagesIntoBlocks(messages), [messages]);
     // Exit on completion
@@ -132,16 +150,33 @@ function ChatCommandTui({ message, assistantId, threadId, }) {
             React.createElement(Text, { dimColor: true, color: "cyan" },
                 "Tool Output",
                 block.name ? `: ${block.name}` : ''),
-            React.createElement(Box, { marginLeft: 2 },
-                React.createElement(Text, { dimColor: true }, block.content)))) : (React.createElement(Text, null, block.content))))),
-        status === 'done' && (React.createElement(Box, { marginTop: 1 },
-            React.createElement(Text, { color: "green" }, "Done")))));
+            React.createElement(Box, { marginLeft: 2, flexDirection: "column" }, (() => {
+                if (!truncateOptions) {
+                    return React.createElement(Text, { dimColor: true }, block.content);
+                }
+                const result = truncate(block.content, truncateOptions);
+                return (React.createElement(React.Fragment, null,
+                    React.createElement(Text, { dimColor: true }, result.text),
+                    result.wasTruncated && (React.createElement(Text, { dimColor: true, color: "yellow" }, "(use --full-output for full output)"))));
+            })()))) : (React.createElement(Text, null, block.content))))),
+        status === 'done' && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { color: "green" }, "Done"),
+            request?.metadata?.thread_id && (React.createElement(Text, { dimColor: true },
+                "Thread: ",
+                request.metadata.thread_id)),
+            extractModelFromEvents(events) && (React.createElement(Text, { dimColor: true },
+                "Model: ",
+                extractModelFromEvents(events))),
+            request?.metadata?.thread_id && (React.createElement(Text, { dimColor: true },
+                "Continue: ruska chat \"message\" -t",
+                ' ',
+                request.metadata.thread_id))))));
 }
 /**
  * JSON mode chat command - direct streaming without React hooks
  * Outputs NDJSON for downstream consumption
  */
-async function runJsonMode(message, assistantId, threadId) {
+async function runJsonMode(message, assistantId, threadId, tools) {
     const config = await loadConfig();
     if (!config) {
         const formatter = new OutputFormatter();
@@ -157,6 +192,7 @@ async function runJsonMode(message, assistantId, threadId) {
         /* eslint-disable @typescript-eslint/naming-convention */
         const request = {
             input: { messages: [{ role: 'user', content: message }] },
+            tools,
             metadata: {
                 ...(assistantId && { assistant_id: assistantId }),
                 ...(threadId && { thread_id: threadId }),
@@ -211,22 +247,22 @@ async function runJsonMode(message, assistantId, threadId) {
 /**
  * Main chat command component - handles JSON mode branching
  */
-function ChatCommand({ message, isJsonMode, assistantId, threadId, }) {
+function ChatCommand({ message, isJsonMode, assistantId, threadId, tools, truncateOptions, }) {
     const { exit } = useApp();
     useEffect(() => {
         if (isJsonMode) {
             // JSON mode runs outside React, just exit immediately
-            void runJsonMode(message, assistantId, threadId).finally(() => {
+            void runJsonMode(message, assistantId, threadId, tools).finally(() => {
                 exit();
             });
         }
-    }, [message, isJsonMode, assistantId, threadId, exit]);
+    }, [message, isJsonMode, assistantId, threadId, tools, exit]);
     // JSON mode: no UI (handled in useEffect)
     if (isJsonMode) {
         return null;
     }
     // TUI mode
-    return (React.createElement(ChatCommandTui, { message: message, assistantId: assistantId, threadId: threadId }));
+    return (React.createElement(ChatCommandTui, { message: message, assistantId: assistantId, threadId: threadId, tools: tools, truncateOptions: truncateOptions }));
 }
 /**
  * Run the chat command
@@ -234,6 +270,8 @@ function ChatCommand({ message, isJsonMode, assistantId, threadId, }) {
 export async function runChatCommand(message, options = {}) {
     // Auto-detect: use JSON mode if not TTY (piped) or explicitly requested
     const isJsonMode = options.json ?? !checkIsTty();
-    const { waitUntilExit } = render(React.createElement(ChatCommand, { message: message, isJsonMode: isJsonMode, assistantId: options.assistantId, threadId: options.threadId }));
+    // Parse tools flag (undefined = defaults, 'disabled' = [], 'a,b' = ['a', 'b'])
+    const parsedTools = parseToolsFlag(options.tools);
+    const { waitUntilExit } = render(React.createElement(ChatCommand, { message: message, isJsonMode: isJsonMode, assistantId: options.assistantId, threadId: options.threadId, tools: parsedTools, truncateOptions: options.truncateOptions }));
     await waitUntilExit();
 }

package/dist/commands/health.d.ts

@@ -0,0 +1 @@
+export declare function runHealthCommand(): Promise<void>;

package/dist/commands/health.js

@@ -0,0 +1,78 @@
+import React, { useState, useEffect } from 'react';
+import { render, Text, Box, useApp } from 'ink';
+import Spinner from 'ink-spinner';
+import { hostPresets } from '../types/index.js';
+import { loadConfig } from '../lib/config.js';
+import { fetchHealth } from '../lib/api.js';
+function HealthCommand() {
+    const { exit } = useApp();
+    const [status, setStatus] = useState('loading');
+    const [health, setHealth] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [host, setHost] = useState('');
+    useEffect(() => {
+        const checkHealth = async () => {
+            // Try to load config for host, fall back to production
+            const config = await loadConfig();
+            const targetHost = config?.host ?? hostPresets.production;
+            setHost(targetHost);
+            // Fetch health status
+            const result = await fetchHealth(targetHost);
+            if (result.success && result.data) {
+                setHealth(result.data);
+                setStatus('success');
+            }
+            else {
+                setError(result.error ?? 'Failed to fetch health status');
+                setStatus('error');
+            }
+            setTimeout(() => {
+                exit();
+            }, 100);
+        };
+        void checkHealth();
+    }, [exit]);
+    if (status === 'loading') {
+        return (React.createElement(Box, null,
+            React.createElement(Text, { color: "cyan" },
+                React.createElement(Spinner, { type: "dots" })),
+            React.createElement(Text, null, " Checking health...")));
+    }
+    if (status === 'error') {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Box, { marginBottom: 1 },
+                React.createElement(Text, { bold: true, color: "cyan" }, "Health Check"),
+                React.createElement(Text, { dimColor: true },
+                    " (",
+                    host,
+                    ")")),
+            React.createElement(Text, null,
+                React.createElement(Text, { dimColor: true }, "Status: "),
+                React.createElement(Text, { bold: true, color: "red" }, "unhealthy")),
+            React.createElement(Text, null,
+                React.createElement(Text, { dimColor: true }, "Error: "),
+                React.createElement(Text, { color: "red" }, error))));
+    }
+    // Success - display health info
+    const statusColor = health?.status === 'healthy' ? 'green' : 'yellow';
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Box, { marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: "cyan" }, "Health Check"),
+            React.createElement(Text, { dimColor: true },
+                " (",
+                host,
+                ")")),
+        React.createElement(Text, null,
+            React.createElement(Text, { dimColor: true }, "Status: "),
+            React.createElement(Text, { bold: true, color: statusColor }, health?.status)),
+        React.createElement(Text, null,
+            React.createElement(Text, { dimColor: true }, "Message: "),
+            React.createElement(Text, null, health?.message)),
+        React.createElement(Text, null,
+            React.createElement(Text, { dimColor: true }, "Version: "),
+            React.createElement(Text, null, health?.version))));
+}
+export async function runHealthCommand() {
+    const { waitUntilExit } = render(React.createElement(HealthCommand, null));
+    await waitUntilExit();
+}

package/dist/commands/version.d.ts

@@ -0,0 +1 @@
+export declare function runVersionCommand(): Promise<void>;

package/dist/commands/version.js

@@ -0,0 +1,68 @@
+import React, { useState, useEffect } from 'react';
+import { render, Text, Box, useApp } from 'ink';
+import Spinner from 'ink-spinner';
+import { hostPresets } from '../types/index.js';
+import { loadConfig } from '../lib/config.js';
+import { fetchHealth } from '../lib/api.js';
+const cliVersion = '0.1.3';
+function VersionCommand() {
+    const { exit } = useApp();
+    const [status, setStatus] = useState('loading');
+    const [health, setHealth] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [host, setHost] = useState('');
+    useEffect(() => {
+        const getVersion = async () => {
+            // Try to load config for host, fall back to production
+            const config = await loadConfig();
+            const targetHost = config?.host ?? hostPresets.production;
+            setHost(targetHost);
+            // Fetch health to get API version
+            const result = await fetchHealth(targetHost);
+            if (result.success && result.data) {
+                setHealth(result.data);
+                setStatus('success');
+            }
+            else {
+                setError(result.error ?? 'Failed to fetch API version');
+                setStatus('error');
+            }
+            setTimeout(() => {
+                exit();
+            }, 100);
+        };
+        void getVersion();
+    }, [exit]);
+    if (status === 'loading') {
+        return (React.createElement(Box, null,
+            React.createElement(Text, { color: "cyan" },
+                React.createElement(Spinner, { type: "dots" })),
+            React.createElement(Text, null, " Loading version info...")));
+    }
+    // Always show CLI version
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, null,
+            React.createElement(Text, { bold: true, color: "cyan" }, "@ruska/cli"),
+            React.createElement(Text, null,
+                " v",
+                cliVersion)),
+        status === 'error' ? (React.createElement(Text, null,
+            React.createElement(Text, { bold: true }, "API:"),
+            React.createElement(Text, { color: "red" }, " unavailable"),
+            React.createElement(Text, { dimColor: true },
+                " (",
+                error,
+                ")"))) : (React.createElement(Text, null,
+            React.createElement(Text, { bold: true }, "API:"),
+            React.createElement(Text, { color: "green" },
+                " v",
+                health?.version),
+            React.createElement(Text, { dimColor: true },
+                " (",
+                host,
+                ")")))));
+}
+export async function runVersionCommand() {
+    const { waitUntilExit } = render(React.createElement(VersionCommand, null));
+    await waitUntilExit();
+}

package/dist/components/model-select.d.ts

@@ -1,10 +1,10 @@
 import React from 'react';
-type ModelSelectProps = {
+type ModelSelectProperties = {
     readonly models: string[];
     readonly value: string;
     readonly onChange: (value: string) => void;
     readonly onSubmit: (value: string) => void;
     readonly onEscape?: () => void;
 };
-export declare function ModelSelect({ models, value, onChange, onSubmit, onEscape, }: ModelSelectProps): React.JSX.Element;
+export declare function ModelSelect({ models, value, onChange, onSubmit, onEscape, }: ModelSelectProperties): React.JSX.Element;
 export {};

package/dist/components/model-select.js

@@ -61,8 +61,8 @@ export function ModelSelect({ models, value, onChange, onSubmit, onEscape, }) {
                 " \u2191 ",
                 startIndex,
                 " more"),
-            visibleModels.map((model, idx) => {
-                const actualIndex = startIndex + idx;
+            visibleModels.map((model, index) => {
+                const actualIndex = startIndex + index;
                 const isSelected = actualIndex === selectedIndex;
                 return (React.createElement(Box, { key: model },
                     React.createElement(Text, { color: isSelected ? 'cyan' : undefined }, isSelected ? '❯ ' : '  '),

package/dist/hooks/use-stream.js

@@ -15,9 +15,9 @@ export function useStream(config, request) {
     const [finalResponse, setFinalResponse] = useState();
     const [error, setError] = useState();
     const [errorCode, setErrorCode] = useState();
-    const handleRef = useRef();
+    const handleReference = useRef();
     const abort = useCallback(() => {
-        handleRef.current?.abort();
+        handleReference.current?.abort();
     }, []);
     useEffect(() => {
         if (!config || !request)
@@ -33,7 +33,7 @@ export function useStream(config, request) {
             setErrorCode(undefined);
             try {
                 const handle = await service.connect(request);
-                handleRef.current = handle;
+                handleReference.current = handle;
                 if (cancelled) {
                     handle.abort();
                     return;
@@ -90,7 +90,7 @@ export function useStream(config, request) {
         void run();
         return () => {
             cancelled = true;
-            handleRef.current?.abort();
+            handleReference.current?.abort();
         };
     }, [config, request]);
     return {

package/dist/lib/api.d.ts

@@ -1,4 +1,4 @@
-import { type Config, type ApiResponse, type UserInfo, type AssistantsSearchResponse, type ModelsResponse, type CreateAssistantRequest, type CreateAssistantResponse } from '../types/index.js';
+import { type Config, type ApiResponse, type UserInfo, type AssistantsSearchResponse, type ModelsResponse, type HealthResponse, type CreateAssistantRequest, type CreateAssistantResponse } from '../types/index.js';
 /**
  * API client for making authenticated requests to the Orchestra backend
  */
@@ -39,3 +39,7 @@ export declare function validateApiKey(host: string, apiKey: string): Promise<Ap
  * Fetch available models (no auth required)
  */
 export declare function fetchModels(host: string, apiKey?: string): Promise<ApiResponse<ModelsResponse>>;
+/**
+ * Fetch health status (no auth required)
+ */
+export declare function fetchHealth(host: string): Promise<ApiResponse<HealthResponse>>;

package/dist/lib/api.js

@@ -149,3 +149,42 @@ export async function fetchModels(host, apiKey) {
         };
     }
 }
+/**
+ * Fetch health status (no auth required)
+ */
+export async function fetchHealth(host) {
+    const url = `${host.replace(/\/$/, '')}/api/info/health`;
+    try {
+        const response = await fetch(url, {
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            let errorMessage;
+            try {
+                const errorJson = JSON.parse(errorText);
+                errorMessage = errorJson.detail ?? `HTTP ${response.status}`;
+            }
+            catch {
+                errorMessage = errorText || `HTTP ${response.status}`;
+            }
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+        const data = (await response.json());
+        return {
+            success: true,
+            data,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error occurred',
+        };
+    }
+}

package/dist/lib/output/truncate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Truncation utilities for CLI output
+ */
+export type TruncateOptions = {
+    maxLength?: number;
+    maxLines?: number;
+    indicator?: string;
+};
+/**
+ * Truncate text by both line count and character count
+ * Applies line truncation first, then character truncation
+ */
+export declare function truncate(input: string, options?: TruncateOptions): {
+    text: string;
+    wasTruncated: boolean;
+};

package/dist/lib/output/truncate.js

@@ -0,0 +1,53 @@
+/**
+ * Truncation utilities for CLI output
+ */
+const defaults = {
+    maxLength: 500,
+    maxLines: 10,
+    indicator: '... [truncated]',
+};
+/**
+ * Truncate text by line count
+ */
+function truncateByLines(input, maxLines, indicator) {
+    const lines = input.split('\n');
+    if (lines.length <= maxLines) {
+        return { text: input, wasTruncated: false };
+    }
+    const truncated = lines.slice(0, maxLines).join('\n') + '\n' + indicator;
+    return { text: truncated, wasTruncated: true };
+}
+/**
+ * Truncate text by character count
+ */
+function truncateByLength(input, maxLength, indicator) {
+    if (input.length <= maxLength) {
+        return { text: input, wasTruncated: false };
+    }
+    const allowedLength = maxLength - indicator.length;
+    if (allowedLength <= 0) {
+        return { text: indicator, wasTruncated: true };
+    }
+    const truncated = input.slice(0, allowedLength) + indicator;
+    return { text: truncated, wasTruncated: true };
+}
+/**
+ * Truncate text by both line count and character count
+ * Applies line truncation first, then character truncation
+ */
+export function truncate(input, options = {}) {
+    const maxLength = options.maxLength ?? defaults.maxLength;
+    const maxLines = options.maxLines ?? defaults.maxLines;
+    const indicator = options.indicator ?? defaults.indicator;
+    // Apply line truncation first
+    const result = truncateByLines(input, maxLines, indicator);
+    // Then apply character truncation
+    if (result.text.length > maxLength) {
+        const charResult = truncateByLength(result.text, maxLength, indicator);
+        return {
+            text: charResult.text,
+            wasTruncated: result.wasTruncated || charResult.wasTruncated,
+        };
+    }
+    return result;
+}

package/dist/lib/tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Default tools and parsing for chat command
+ * @see frontend/src/components/menus/BaseToolMenu.tsx for frontend equivalent
+ */
+/**
+ * Default tools enabled for chat command
+ * Mirrors frontend DEFAULT_AGENT_TOOLS in BaseToolMenu.tsx
+ */
+export declare const defaultAgentTools: readonly ["web_search", "web_scrape", "math_calculator", "think_tool", "python_sandbox"];
+export type DefaultAgentTool = (typeof defaultAgentTools)[number];
+/**
+ * Parse --tools flag value into array of tool names
+ *
+ * @param value - Raw flag value (undefined, 'disabled', or comma-separated)
+ * @returns Array of tool names to send to API
+ *
+ * @example
+ * parseToolsFlag(undefined)             // returns DEFAULT_AGENT_TOOLS
+ * parseToolsFlag('')                    // returns DEFAULT_AGENT_TOOLS
+ * parseToolsFlag('disabled')            // returns []
+ * parseToolsFlag('web_search,think_tool') // returns ['web_search', 'think_tool']
+ */
+export declare function parseToolsFlag(value: string | undefined): string[];

package/dist/lib/tools.js

@@ -0,0 +1,42 @@
+/**
+ * Default tools and parsing for chat command
+ * @see frontend/src/components/menus/BaseToolMenu.tsx for frontend equivalent
+ */
+/**
+ * Default tools enabled for chat command
+ * Mirrors frontend DEFAULT_AGENT_TOOLS in BaseToolMenu.tsx
+ */
+export const defaultAgentTools = [
+    'web_search',
+    'web_scrape',
+    'math_calculator',
+    'think_tool',
+    'python_sandbox',
+];
+/**
+ * Parse --tools flag value into array of tool names
+ *
+ * @param value - Raw flag value (undefined, 'disabled', or comma-separated)
+ * @returns Array of tool names to send to API
+ *
+ * @example
+ * parseToolsFlag(undefined)             // returns DEFAULT_AGENT_TOOLS
+ * parseToolsFlag('')                    // returns DEFAULT_AGENT_TOOLS
+ * parseToolsFlag('disabled')            // returns []
+ * parseToolsFlag('web_search,think_tool') // returns ['web_search', 'think_tool']
+ */
+export function parseToolsFlag(value) {
+    // No flag or empty string: use defaults
+    if (value === undefined || value.trim() === '') {
+        return [...defaultAgentTools];
+    }
+    // Explicit disable
+    if (value.toLowerCase() === 'disabled') {
+        return [];
+    }
+    // Parse comma-separated list
+    return value
+        .split(',')
+        .map(t => t.trim())
+        .filter(Boolean);
+}

package/dist/types/index.d.ts

@@ -79,6 +79,14 @@ export type ModelsResponse = {
     free: string[];
     models: string[];
 };
+/**
+ * Response from GET /api/health
+ */
+export type HealthResponse = {
+    status: string;
+    message: string;
+    version: string;
+};
 /**
  * Host presets for environment selection
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ruska/cli",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"description": "CLI for Orchestra - AI Agent Orchestration Platform",
 	"license": "Apache-2.0",
 	"author": "RUSKA <reggleston@ruska.ai>",
@@ -47,7 +47,7 @@
 		"dev": "tsc --watch",
 		"build": "tsc",
 		"build:clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && npm run build",
-		"format": "prettier --write \"**/*.{ts,tsx,json,md}\" && xo --fix",
+		"format": "xo --fix && prettier --write \"**/*.{ts,tsx,json,md}\"",
 		"format:check": "prettier --check .",
 		"lint": "xo",
 		"test": "npm run lint && npm run build && ava",
@@ -87,7 +87,7 @@
 		"ts-node": "^10.9.1",
 		"tsx": "^4.21.0",
 		"typescript": "^5.0.3",
-		"xo": "^0.53.1"
+		"xo": "^0.60.0"
 	},
 	"ava": {
 		"files": [
@@ -103,7 +103,16 @@
 		"rules": {
 			"react/prop-types": "off",
 			"unicorn/expiring-todo-comments": "off",
-			"ava/no-ignored-test-files": "off"
+			"ava/no-ignored-test-files": "off",
+			"unicorn/prevent-abbreviations": "off",
+			"@typescript-eslint/switch-exhaustiveness-check": "off",
+			"@typescript-eslint/no-unsafe-assignment": "off",
+			"@typescript-eslint/no-unsafe-call": "off",
+			"@typescript-eslint/restrict-plus-operands": "off",
+			"promise/prefer-await-to-then": "off",
+			"complexity": "off",
+			"unicorn/prefer-at": "off",
+			"prettier/prettier": "off"
 		}
 	},
 	"prettier": "@vdemedes/prettier-config"