@agentick/cli 0.0.1

package/dist/ui/renderer.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Renderer - Terminal output rendering
+ */
+export interface RendererOptions {
+    /** Enable markdown rendering */
+    markdown?: boolean;
+    /** Enable debug output */
+    debug?: boolean;
+    /** Enable colors (default: true) */
+    colors?: boolean;
+}
+/**
+ * Terminal renderer with markdown support
+ */
+export declare class Renderer {
+    private options;
+    private marked;
+    private _isStreaming;
+    private streamBuffer;
+    private _isDebug;
+    constructor(options?: RendererOptions);
+    get isDebug(): boolean;
+    toggleDebug(): void;
+    /**
+     * Render markdown text
+     */
+    markdown(text: string): string;
+    /**
+     * Print an info message
+     */
+    info(message: string): void;
+    /**
+     * Print an error message
+     */
+    error(message: string): void;
+    /**
+     * Print a debug message
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Start streaming output
+     */
+    streamStart(): void;
+    /**
+     * Add delta to stream
+     */
+    streamDelta(text: string): void;
+    /**
+     * End streaming and render final output
+     */
+    streamEnd(): void;
+    /**
+     * Show tool execution start
+     */
+    toolStart(name: string, args: Record<string, unknown>): void;
+    /**
+     * Show tool execution end
+     */
+    toolEnd(name: string, _result: unknown): void;
+    /**
+     * Render a complete response (non-streaming)
+     */
+    response(text: string): void;
+    /**
+     * Render user input echo
+     */
+    userInput(text: string): void;
+    /**
+     * Print a separator line
+     */
+    separator(): void;
+    /**
+     * Clear the screen
+     */
+    clear(): void;
+    /**
+     * Print JSON output
+     */
+    json(data: unknown): void;
+    /**
+     * Print plain text
+     */
+    plain(text: string): void;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/ui/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/ui/renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,GAAE,eAAoB;IA4BzC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW9B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAS5C;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,SAAS,IAAI,IAAI;IAUjB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5D;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/ui/renderer.js

@@ -0,0 +1,163 @@
+/**
+ * Renderer - Terminal output rendering
+ */
+import chalk from "chalk";
+import { Marked } from "marked";
+import { markedTerminal } from "marked-terminal";
+/**
+ * Terminal renderer with markdown support
+ */
+export class Renderer {
+    options;
+    marked;
+    _isStreaming = false;
+    streamBuffer = "";
+    _isDebug;
+    constructor(options = {}) {
+        this.options = options;
+        this._isDebug = options.debug ?? false;
+        // Set up marked with terminal renderer
+        this.marked = new Marked();
+        this.marked.use(markedTerminal({
+            // Customize terminal rendering
+            code: chalk.cyan,
+            blockquote: chalk.gray.italic,
+            html: chalk.gray,
+            heading: chalk.bold,
+            firstHeading: chalk.bold.underline,
+            hr: chalk.gray,
+            listitem: chalk.reset,
+            table: chalk.reset,
+            paragraph: chalk.reset,
+            strong: chalk.bold,
+            em: chalk.italic,
+            codespan: chalk.cyan,
+            del: chalk.strikethrough,
+            link: chalk.blue.underline,
+            href: chalk.blue.underline,
+        }));
+    }
+    get isDebug() {
+        return this._isDebug;
+    }
+    toggleDebug() {
+        this._isDebug = !this._isDebug;
+    }
+    /**
+     * Render markdown text
+     */
+    markdown(text) {
+        if (!this.options.markdown) {
+            return text;
+        }
+        try {
+            return this.marked.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    /**
+     * Print an info message
+     */
+    info(message) {
+        console.log(chalk.gray(message));
+    }
+    /**
+     * Print an error message
+     */
+    error(message) {
+        console.error(chalk.red(`Error: ${message}`));
+    }
+    /**
+     * Print a debug message
+     */
+    debug(message, data) {
+        if (!this._isDebug)
+            return;
+        if (data !== undefined) {
+            console.log(chalk.dim(`[DEBUG] ${message}`), data);
+        }
+        else {
+            console.log(chalk.dim(`[DEBUG] ${message}`));
+        }
+    }
+    /**
+     * Start streaming output
+     */
+    streamStart() {
+        this._isStreaming = true;
+        this.streamBuffer = "";
+        process.stdout.write(chalk.green("\nAgent: "));
+    }
+    /**
+     * Add delta to stream
+     */
+    streamDelta(text) {
+        if (!this._isStreaming)
+            return;
+        this.streamBuffer += text;
+        process.stdout.write(text);
+    }
+    /**
+     * End streaming and render final output
+     */
+    streamEnd() {
+        if (!this._isStreaming)
+            return;
+        this._isStreaming = false;
+        // Move to new line after stream
+        console.log("\n");
+        this.streamBuffer = "";
+    }
+    /**
+     * Show tool execution start
+     */
+    toolStart(name, args) {
+        const argsStr = Object.keys(args).length > 0 ? ` ${chalk.dim(JSON.stringify(args).slice(0, 50))}...` : "";
+        console.log(chalk.yellow(`\n[tool: ${name}]${argsStr}`));
+    }
+    /**
+     * Show tool execution end
+     */
+    toolEnd(name, _result) {
+        this.debug(`Tool ${name} completed`);
+    }
+    /**
+     * Render a complete response (non-streaming)
+     */
+    response(text) {
+        console.log(chalk.green("\nAgent: ") + this.markdown(text) + "\n");
+    }
+    /**
+     * Render user input echo
+     */
+    userInput(text) {
+        console.log(chalk.blue("You: ") + text);
+    }
+    /**
+     * Print a separator line
+     */
+    separator() {
+        console.log(chalk.dim("─".repeat(50)));
+    }
+    /**
+     * Clear the screen
+     */
+    clear() {
+        console.clear();
+    }
+    /**
+     * Print JSON output
+     */
+    json(data) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    /**
+     * Print plain text
+     */
+    plain(text) {
+        console.log(text);
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/ui/renderer.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@agentick/cli",
+  "version": "0.0.1",
+  "description": "Terminal client for Agentick agents",
+  "bin": {
+    "agentick": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "eventsource": "^2.0.2",
+    "marked": "^15.0.4",
+    "marked-terminal": "^7.2.1",
+    "@agentick/client": "0.0.1",
+    "@agentick/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/eventsource": "^1.1.15",
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "tsx src/bin.ts",
+    "cli": "tsx src/bin.ts"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Agentick CLI - Entry point
+ */
+
+import { program } from "commander";
+import { chatCommand } from "./commands/chat.js";
+import { sendCommand } from "./commands/send.js";
+import { statusCommand } from "./commands/status.js";
+
+program.name("agentick").description("Terminal client for Agentick agents").version("0.0.1");
+
+// Chat command (interactive)
+program
+  .command("chat")
+  .description("Interactive chat with a Agentick agent")
+  .option("-u, --url <url>", "Server URL (e.g., http://localhost:3000/api/agent)")
+  .option("-s, --session <id>", "Session ID")
+  .option("-t, --token <token>", "Authentication token")
+  .option("--no-stream", "Disable streaming (wait for complete response)")
+  .option("--debug", "Enable debug mode")
+  .action(chatCommand);
+
+// Send command (non-interactive)
+program
+  .command("send <message>")
+  .description("Send a single message and print the response")
+  .option("-u, --url <url>", "Server URL")
+  .option("-s, --session <id>", "Session ID")
+  .option("-t, --token <token>", "Authentication token")
+  .option("--stdin", "Read additional context from stdin")
+  .option("-f, --format <format>", "Output format: plain, json, markdown", "plain")
+  .option("--no-stream", "Disable streaming")
+  .action(sendCommand);
+
+// Status command
+program
+  .command("status")
+  .description("Show server and session status")
+  .option("-u, --url <url>", "Server URL")
+  .option("-s, --session <id>", "Session ID")
+  .option("-t, --token <token>", "Authentication token")
+  .action(statusCommand);
+
+// Default to chat if no command specified
+program.action(() => {
+  program.help();
+});
+
+program.parse();

package/src/chat-session.ts

@@ -0,0 +1,244 @@
+/**
+ * ChatSession - Interactive chat session
+ */
+
+import * as readline from "readline";
+import { CLI, type CLIConfig } from "./cli.js";
+import { Renderer } from "./ui/renderer.js";
+
+export interface ChatSessionOptions extends CLIConfig {
+  /** Custom prompt (default: "You: ") */
+  prompt?: string;
+
+  /** Enable markdown rendering (default: true) */
+  markdown?: boolean;
+}
+
+interface SlashCommand {
+  name: string;
+  aliases?: string[];
+  description: string;
+  handler: (args: string[]) => Promise<boolean> | boolean; // Return true to continue, false to exit
+}
+
+/**
+ * Interactive chat session
+ */
+export class ChatSession {
+  private cli: CLI;
+  private renderer: Renderer;
+  private options: ChatSessionOptions;
+  private rl?: readline.Interface;
+  private isRunning = false;
+  private commands: Map<string, SlashCommand> = new Map();
+
+  constructor(options: ChatSessionOptions) {
+    this.options = options;
+    this.cli = new CLI(options);
+    this.renderer = new Renderer({
+      markdown: options.markdown ?? true,
+      debug: options.debug,
+    });
+
+    this.setupCommands();
+    this.setupEventHandlers();
+  }
+
+  private setupCommands(): void {
+    const commands: SlashCommand[] = [
+      {
+        name: "help",
+        aliases: ["h", "?"],
+        description: "Show available commands",
+        handler: () => {
+          this.showHelp();
+          return true;
+        },
+      },
+      {
+        name: "quit",
+        aliases: ["exit", "q"],
+        description: "Exit the chat",
+        handler: () => false,
+      },
+      {
+        name: "status",
+        description: "Show session status",
+        handler: () => {
+          this.showStatus();
+          return true;
+        },
+      },
+      {
+        name: "clear",
+        aliases: ["cls"],
+        description: "Clear the screen",
+        handler: () => {
+          console.clear();
+          return true;
+        },
+      },
+      {
+        name: "debug",
+        description: "Toggle debug mode",
+        handler: () => {
+          this.renderer.toggleDebug();
+          this.renderer.info(`Debug mode: ${this.renderer.isDebug ? "on" : "off"}`);
+          return true;
+        },
+      },
+    ];
+
+    for (const cmd of commands) {
+      this.commands.set(cmd.name, cmd);
+      if (cmd.aliases) {
+        for (const alias of cmd.aliases) {
+          this.commands.set(alias, cmd);
+        }
+      }
+    }
+  }
+
+  private setupEventHandlers(): void {
+    this.cli.on("stream:delta", ({ text }) => {
+      this.renderer.streamDelta(text);
+    });
+
+    this.cli.on("stream:start", () => {
+      this.renderer.streamStart();
+    });
+
+    this.cli.on("stream:end", () => {
+      this.renderer.streamEnd();
+    });
+
+    this.cli.on("tool:start", ({ name, args }) => {
+      this.renderer.toolStart(name, args);
+    });
+
+    this.cli.on("tool:end", ({ name, result }) => {
+      this.renderer.toolEnd(name, result);
+    });
+
+    this.cli.on("error", (error) => {
+      this.renderer.error(error.message);
+    });
+  }
+
+  private showHelp(): void {
+    const uniqueCommands = new Map<string, SlashCommand>();
+    for (const [name, cmd] of this.commands) {
+      if (!uniqueCommands.has(cmd.name)) {
+        uniqueCommands.set(cmd.name, cmd);
+      }
+    }
+
+    this.renderer.info("\nAvailable commands:");
+    for (const [name, cmd] of uniqueCommands) {
+      const aliases = cmd.aliases?.length ? ` (${cmd.aliases.join(", ")})` : "";
+      this.renderer.info(`  /${name}${aliases} - ${cmd.description}`);
+    }
+    console.log();
+  }
+
+  private showStatus(): void {
+    const sessionId = this.cli.sessionId ?? "not connected";
+    const connected = this.cli.isConnected ? "yes" : "no";
+
+    this.renderer.info("\nSession Status:");
+    this.renderer.info(`  Session ID: ${sessionId}`);
+    this.renderer.info(`  Connected: ${connected}`);
+    this.renderer.info(`  URL: ${this.options.url}`);
+    console.log();
+  }
+
+  private async handleCommand(input: string): Promise<boolean> {
+    const [cmdName, ...args] = input.slice(1).split(/\s+/);
+    const cmd = this.commands.get(cmdName.toLowerCase());
+
+    if (!cmd) {
+      this.renderer.error(`Unknown command: /${cmdName}. Type /help for available commands.`);
+      return true;
+    }
+
+    return cmd.handler(args);
+  }
+
+  private async handleMessage(message: string): Promise<void> {
+    try {
+      await this.cli.send(message);
+    } catch (error) {
+      this.renderer.error(error instanceof Error ? error.message : String(error));
+    }
+  }
+
+  /**
+   * Start the interactive session
+   */
+  async start(): Promise<void> {
+    if (this.isRunning) return;
+    this.isRunning = true;
+
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    // Print welcome message
+    this.renderer.info(`Connected to ${this.options.url}`);
+    if (this.cli.sessionId) {
+      this.renderer.info(`Session: ${this.cli.sessionId}`);
+    }
+    this.renderer.info("Type /help for commands, /quit to exit\n");
+
+    const prompt = this.options.prompt ?? "You: ";
+
+    const promptForInput = (): void => {
+      if (!this.isRunning) return;
+
+      this.rl!.question(prompt, async (input) => {
+        const trimmed = input.trim();
+
+        if (!trimmed) {
+          promptForInput();
+          return;
+        }
+
+        // Handle commands
+        if (trimmed.startsWith("/")) {
+          const shouldContinue = await this.handleCommand(trimmed);
+          if (!shouldContinue) {
+            this.stop();
+            return;
+          }
+          promptForInput();
+          return;
+        }
+
+        // Handle regular message
+        await this.handleMessage(trimmed);
+        promptForInput();
+      });
+    };
+
+    // Handle Ctrl+C
+    this.rl.on("close", () => {
+      this.stop();
+    });
+
+    promptForInput();
+  }
+
+  /**
+   * Stop the session
+   */
+  stop(): void {
+    if (!this.isRunning) return;
+    this.isRunning = false;
+
+    this.renderer.info("\nGoodbye!");
+    this.rl?.close();
+    this.cli.destroy();
+    process.exit(0);
+  }
+}