@syrin/cli 1.3.0

package/dist/runtime/dev/formatter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Output formatter for Dev Mode.
+ * Formats all output for developer-friendly display.
+ */
+import type { DevSessionState } from './types.js';
+import type { ToolCall } from '../../runtime/llm/types.js';
+import type { TransportType } from '../../config/types.js';
+import type { MCPURL, Command } from '../../types/ids.js';
+/**
+ * Formatter options.
+ */
+export interface FormatterOptions {
+    /** Whether to use colors */
+    useColors?: boolean;
+    /** Whether to truncate long outputs */
+    truncateLongOutputs?: boolean;
+    /** Maximum length before truncation */
+    maxOutputLength?: number;
+}
+/**
+ * Dev Mode output formatter.
+ */
+export declare class DevFormatter {
+    private readonly options;
+    constructor(options?: FormatterOptions);
+    /**
+     * Format and display the dev mode header.
+     */
+    displayHeader(version: string, transport: TransportType, mcpUrl: MCPURL | string | undefined, command: Command | string | undefined, llmProvider: string, toolCount: number): void;
+    /**
+     * Format and display user input.
+     */
+    displayUserInput(input: string): void;
+    /**
+     * Format and display detected tool calls.
+     */
+    displayToolDetection(toolCalls: ToolCall[]): void;
+    /**
+     * Format and display tool execution start.
+     */
+    displayToolExecutionStart(toolName: string): void;
+    /**
+     * Format and display tool execution end.
+     */
+    displayToolExecutionEnd(toolName: string, duration: number): void;
+    /**
+     * Format and display tool execution result.
+     */
+    displayToolResult(toolName: string, result: unknown): void;
+    /**
+     * Format and display tool execution error.
+     */
+    displayToolError(toolName: string, error: string): void;
+    /**
+     * Format and display LLM response.
+     */
+    displayLLMResponse(llmProvider: string, response: string): void;
+    /**
+     * Format and display session summary.
+     */
+    displaySessionSummary(state: DevSessionState): void;
+    /**
+     * Format and display available tools list.
+     */
+    displayToolsList(tools: Array<{
+        name: string;
+        description?: string;
+    }>): void;
+    /**
+     * Format and display welcome message.
+     */
+    displayWelcomeMessage(): void;
+    /**
+     * Format and display server log message.
+     */
+    displayServerLog(type: 'stdout' | 'stderr', message: string): void;
+    /**
+     * Format and display error message.
+     */
+    displayError(message: string): void;
+    /**
+     * Format and display info message.
+     */
+    displayInfo(message: string): void;
+    /**
+     * Format JSON for display.
+     */
+    formatJSON(obj: unknown): string;
+    /**
+     * Truncate text if it's too long.
+     */
+    truncate(text: string, maxLength?: number): string;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/runtime/dev/formatter.js

@@ -0,0 +1,236 @@
+/**
+ * Output formatter for Dev Mode.
+ * Formats all output for developer-friendly display.
+ */
+import { Icons, Labels } from '../../constants/index.js';
+import { log } from '../../utils/logger.js';
+/**
+ * Dev Mode output formatter.
+ */
+export class DevFormatter {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        this.options.useColors = options.useColors ?? true;
+        this.options.truncateLongOutputs = options.truncateLongOutputs ?? true;
+        this.options.maxOutputLength = options.maxOutputLength ?? 500;
+    }
+    /**
+     * Format and display the dev mode header.
+     */
+    displayHeader(version, transport, mcpUrl, command, llmProvider, toolCount) {
+        log.blank();
+        log.success(`${Icons.SUCCESS} Syrin Version: ${version}`);
+        log.blank();
+        log.plain(`${Labels.TRANSPORT_LAYER}: ${transport}`);
+        if (transport === 'http' && mcpUrl) {
+            log.plain(`${Labels.MCP_URL}: ${mcpUrl} ${Icons.CHECK} (working)`);
+        }
+        else if (transport === 'stdio' && command) {
+            log.plain(`${Labels.COMMAND}: ${command} ${Icons.CHECK} (working)`);
+        }
+        log.plain(`LLM: ${llmProvider}`);
+        log.blank();
+        log.plain(`Total Tools: ${toolCount}`);
+        log.blank();
+    }
+    /**
+     * Format and display user input.
+     */
+    displayUserInput(input) {
+        log.blank();
+        log.success(`${Icons.SUCCESS} User > ${input}`);
+        log.blank();
+    }
+    /**
+     * Format and display detected tool calls.
+     */
+    displayToolDetection(toolCalls) {
+        if (toolCalls.length === 0) {
+            return;
+        }
+        for (const toolCall of toolCalls) {
+            log.plain(`Detected Tool: ${toolCall.name}`);
+            log.plain('Detected Arguments:');
+            log.plain(JSON.stringify(toolCall.arguments, null, 2));
+            log.blank();
+        }
+    }
+    /**
+     * Format and display tool execution start.
+     */
+    displayToolExecutionStart(toolName) {
+        const timestamp = new Date().toLocaleString('en-GB', {
+            day: '2-digit',
+            month: '2-digit',
+            year: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        });
+        log.plain(`Calling Tool (${toolName})`);
+        log.blank();
+        log.plain(`Tool Logs (${toolName}):`);
+        log.plain(`[${timestamp} > ${toolName}] Tool calling started!`);
+    }
+    /**
+     * Format and display tool execution end.
+     */
+    displayToolExecutionEnd(toolName, duration) {
+        const timestamp = new Date().toLocaleString('en-GB', {
+            day: '2-digit',
+            month: '2-digit',
+            year: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        });
+        log.plain(`[${timestamp} > ${toolName}] Tool calling ended! (${duration}ms)`);
+    }
+    /**
+     * Format and display tool execution result.
+     */
+    displayToolResult(toolName, result) {
+        log.blank();
+        log.plain(`Returned Tool Response (${toolName}):`);
+        let resultText;
+        if (typeof result === 'string') {
+            resultText = result;
+        }
+        else if (result && typeof result === 'object') {
+            // Check if it's a preview result
+            if ('preview' in result && result.preview) {
+                resultText = JSON.stringify(result, null, 2);
+            }
+            else {
+                resultText = JSON.stringify(result, null, 2);
+            }
+        }
+        else {
+            resultText = String(result);
+        }
+        // Truncate if needed
+        if (this.options.truncateLongOutputs &&
+            resultText.length > this.options.maxOutputLength) {
+            resultText =
+                resultText.substring(0, this.options.maxOutputLength) +
+                    '\n... (truncated)';
+        }
+        log.plain(resultText);
+        log.blank();
+    }
+    /**
+     * Format and display tool execution error.
+     */
+    displayToolError(toolName, error) {
+        log.blank();
+        log.error(`Tool Execution Error (${toolName}):`);
+        log.plain(error);
+        log.blank();
+    }
+    /**
+     * Format and display LLM response.
+     */
+    displayLLMResponse(llmProvider, response) {
+        log.blank();
+        log.success(`${Icons.SUCCESS} LLM Response (${llmProvider}):`);
+        // Split response into lines for better readability
+        const lines = response.split('\n');
+        for (const line of lines) {
+            log.plain(line);
+        }
+        log.blank();
+    }
+    /**
+     * Format and display session summary.
+     */
+    displaySessionSummary(state) {
+        const duration = Date.now() - state.startTime.getTime();
+        const durationSeconds = (duration / 1000).toFixed(2);
+        log.blank();
+        log.plain('─'.repeat(60));
+        log.plain('Session Summary:');
+        log.plain(`  Duration: ${durationSeconds}s`);
+        log.plain(`  Total Tool Calls: ${state.totalToolCalls}`);
+        log.plain(`  Total LLM Calls: ${state.totalLLMCalls}`);
+        log.plain('─'.repeat(60));
+        log.blank();
+    }
+    /**
+     * Format and display available tools list.
+     */
+    displayToolsList(tools) {
+        log.blank();
+        log.plain('Available Tools:');
+        log.plain('─'.repeat(60));
+        if (tools.length === 0) {
+            log.warning(`  ${Icons.WARNING} No tools available`);
+            return;
+        }
+        for (const tool of tools) {
+            log.plain(`  ${Icons.CHECK} ${tool.name}`);
+            if (tool.description) {
+                log.plain(`    ${tool.description}`);
+            }
+        }
+        log.blank();
+    }
+    /**
+     * Format and display welcome message.
+     */
+    displayWelcomeMessage() {
+        log.blank();
+        log.success(`${Icons.SUCCESS} Syrin's Dev Mode Entered. Talk to the LLM Now!`);
+        log.blank();
+    }
+    /**
+     * Format and display server log message.
+     */
+    displayServerLog(type, message) {
+        const label = type === 'stderr' ? '[Server Error]' : '[Server]';
+        if (type === 'stderr') {
+            log.error(`${label} ${message}`);
+        }
+        else {
+            log.info(`${label} ${message}`);
+        }
+    }
+    /**
+     * Format and display error message.
+     */
+    displayError(message) {
+        log.blank();
+        log.error(message);
+        log.blank();
+    }
+    /**
+     * Format and display info message.
+     */
+    displayInfo(message) {
+        log.blank();
+        log.info(message);
+        log.blank();
+    }
+    /**
+     * Format JSON for display.
+     */
+    formatJSON(obj) {
+        try {
+            return JSON.stringify(obj, null, 2);
+        }
+        catch {
+            return String(obj);
+        }
+    }
+    /**
+     * Truncate text if it's too long.
+     */
+    truncate(text, maxLength) {
+        const length = maxLength || this.options.maxOutputLength || 500;
+        if (text.length <= length) {
+            return text;
+        }
+        return text.substring(0, length) + '\n... (truncated)';
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/runtime/dev/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dev Mode runtime exports.
+ */
+export * from './repl.js';
+export * from './types.js';
+export * from './session.js';
+export * from './formatter.js';
+export * from './stack-trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/dev/index.js

@@ -0,0 +1,9 @@
+/**
+ * Dev Mode runtime exports.
+ */
+export * from './repl.js';
+export * from './types.js';
+export * from './session.js';
+export * from './formatter.js';
+export * from './stack-trace.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/dev/repl.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Interactive REPL (Read-Eval-Print Loop) for Dev Mode.
+ * Provides command-line interface with history, autocomplete, and navigation.
+ */
+import type { EventEmitter } from '../../events/emitter.js';
+/**
+ * REPL options.
+ */
+export interface REPLOptions {
+    /** Prompt prefix (e.g., "User > ") */
+    prompt?: string;
+    /** Whether to save history to file */
+    saveHistory?: boolean;
+    /** History file path */
+    historyFile?: string;
+    /** Maximum history size */
+    maxHistorySize?: number;
+}
+/**
+ * REPL special commands.
+ */
+export declare enum REPLCommand {
+    EXIT = "/exit",
+    QUIT = "/quit",
+    CLEAR = "/clear",
+    HELP = "/help",
+    HISTORY = "/history",
+    TOOLS = "/tools"
+}
+/**
+ * Interactive REPL implementation.
+ */
+export declare class InteractiveREPL {
+    private readonly options;
+    private readonly eventEmitter?;
+    private rl;
+    private history;
+    private historyIndex;
+    private currentInput;
+    private readonly maxHistorySize;
+    constructor(options?: REPLOptions, eventEmitter?: EventEmitter | undefined);
+    /**
+     * Start the REPL.
+     * @param onInput - Callback for user input
+     * @param onClose - Callback for REPL close (can be async)
+     */
+    start(onInput: (input: string) => Promise<void> | void, onClose?: () => void | Promise<void>): void;
+    /**
+     * Load history into readline for arrow key navigation.
+     */
+    private loadHistoryIntoReadline;
+    /**
+     * Stop the REPL.
+     */
+    stop(): void;
+    /**
+     * Set a new prompt.
+     */
+    setPrompt(prompt: string): void;
+    /**
+     * Write output to the console.
+     */
+    write(message: string): void;
+    /**
+     * Write a line to the console.
+     */
+    writeLine(message: string): void;
+    /**
+     * Clear the current line.
+     */
+    clearLine(): void;
+    /**
+     * Get history.
+     */
+    getHistory(): string[];
+    /**
+     * Clear history.
+     */
+    clearHistory(): void;
+    /**
+     * Setup event handlers for history navigation.
+     * Note: readline handles arrow keys automatically, but we can enhance it.
+     */
+    private setupEventHandlers;
+    /**
+     * Handle special REPL commands.
+     */
+    private handleSpecialCommand;
+    /**
+     * Show help message.
+     */
+    private showHelp;
+    /**
+     * Show command history.
+     */
+    private showHistory;
+    /**
+     * Add input to history.
+     */
+    private addToHistory;
+    /**
+     * Load history from file.
+     */
+    private loadHistory;
+    /**
+     * Save history to file.
+     */
+    private saveHistory;
+    /**
+     * Completer function for tab completion.
+     */
+    private completer;
+}
+//# sourceMappingURL=repl.d.ts.map