@ruska/cli 0.1.4 → 0.1.5

package/README.md

@@ -176,11 +176,34 @@ $ ruska chat "Hello" -a <assistant-id> | jq '.type'
 | `-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:**
 
 | Code | Meaning               |

package/dist/cli.js

@@ -33,6 +33,9 @@ const cli = meow(`
 	  -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)
@@ -50,7 +53,9 @@ 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"                           # Direct chat with default LLM
+	  $ 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
@@ -116,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) {
@@ -134,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');
@@ -153,7 +158,7 @@ async function main() {
                 cli.flags['a']?.toString();
             const threadId = cli.flags.thread ??
                 cli.flags['t']?.toString();
-            const message = args.join(' ') || cli.flags.message;
+            const message = arguments_.join(' ') || cli.flags.message;
             if (!message) {
                 console.error('Error: Message is required');
                 console.error('Usage: ruska chat "<message>" [-a <assistant-id>]');
@@ -163,6 +168,7 @@ async function main() {
                 json: cli.flags.json,
                 assistantId,
                 threadId,
+                tools: cli.flags.tools,
                 truncateOptions: cli.flags.fullOutput
                     ? undefined
                     : {

package/dist/commands/chat.d.ts

@@ -10,5 +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

@@ -14,6 +14,7 @@ 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
  */
@@ -83,7 +84,7 @@ function StatusIndicator({ status }) {
 /**
  * TUI mode chat command using React hook
  */
-function ChatCommandTui({ message, assistantId, threadId, truncateOptions, }) {
+function ChatCommandTui({ message, assistantId, threadId, tools, truncateOptions, }) {
     const { exit } = useApp();
     const [config, setConfig] = useState();
     const [authError, setAuthError] = useState(false);
@@ -106,12 +107,13 @@ function ChatCommandTui({ message, assistantId, threadId, truncateOptions, }) {
     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, events, error } = useStream(config, request);
@@ -174,7 +176,7 @@ function ChatCommandTui({ message, assistantId, threadId, truncateOptions, }) {
  * 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();
@@ -190,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 }),
@@ -244,22 +247,22 @@ async function runJsonMode(message, assistantId, threadId) {
 /**
  * Main chat command component - handles JSON mode branching
  */
-function ChatCommand({ message, isJsonMode, assistantId, threadId, truncateOptions, }) {
+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, truncateOptions: truncateOptions }));
+    return (React.createElement(ChatCommandTui, { message: message, assistantId: assistantId, threadId: threadId, tools: tools, truncateOptions: truncateOptions }));
 }
 /**
  * Run the chat command
@@ -267,6 +270,8 @@ function ChatCommand({ message, isJsonMode, assistantId, threadId, truncateOptio
 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, truncateOptions: options.truncateOptions }));
+    // 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/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/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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ruska/cli",
-	"version": "0.1.4",
+	"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"