@iqai/adk-cli 0.2.8 → 0.2.9

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @iqai/adk-cli
 
+## 0.2.9
+
+### Patch Changes
+
+- Updated dependencies [c890576]
+- Updated dependencies [b0fdba9]
+- Updated dependencies [3561208]
+  - @iqai/adk@0.3.0
+
 ## 0.2.8
 
 ### Patch Changes

package/README.md

@@ -86,6 +86,7 @@ adk new my-agent --template simple-agent
 - `discord-bot` - Agent integrated with Discord bot framework
 - `telegram-bot` - Agent integrated with Telegram bot API  
 - `hono-server` - Web server with RESTful agent endpoints
+- `shade-agent` – Agent with Near Shade Agents
 - `mcp-starter` - Model Context Protocol server integration
 
 ### `adk run`

package/dist/index.js

@@ -25,13 +25,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_chalk5 = __toESM(require("chalk"));
+var import_chalk6 = __toESM(require("chalk"));
 var import_commander = require("commander");
 
 // package.json
 var package_default = {
   name: "@iqai/adk-cli",
-  version: "0.2.8",
+  version: "0.2.9",
   description: "CLI tool for creating, running, and testing ADK agents",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -311,20 +311,55 @@ async function createProject(projectName, options) {
 // src/commands/run.ts
 var p = __toESM(require("@clack/prompts"));
 var import_prompts2 = require("@clack/prompts");
-var import_chalk3 = __toESM(require("chalk"));
+var import_chalk4 = __toESM(require("chalk"));
 var import_marked = require("marked");
 var import_marked_terminal = require("marked-terminal");
 
 // src/commands/serve.ts
 var import_node_fs3 = require("fs");
 var import_node_path3 = require("path");
-var import_chalk2 = __toESM(require("chalk"));
+var import_chalk3 = __toESM(require("chalk"));
 
 // src/server/index.ts
 var import_node_server = require("@hono/node-server");
 var import_adk2 = require("@iqai/adk");
 var import_hono = require("hono");
 
+// src/server/logger.ts
+var import_chalk2 = __toESM(require("chalk"));
+var Logger = class {
+  name;
+  quiet;
+  debugEnabled;
+  constructor({ name, quiet = false }) {
+    this.name = name;
+    this.quiet = quiet;
+    this.debugEnabled = process.env.NODE_ENV === "development" || process.env.ADK_DEBUG === "true";
+  }
+  time() {
+    return (/* @__PURE__ */ new Date()).toLocaleTimeString();
+  }
+  prefix(icon, message) {
+    return `${this.time()} ${icon} [${this.name}] ${message}`;
+  }
+  debug(message, ...args) {
+    if (!this.debugEnabled || this.quiet) return;
+    console.debug(import_chalk2.default.blue(this.prefix("\u{1F41B}", message)), ...args);
+  }
+  info(message, ...args) {
+    if (this.quiet) return;
+    console.info(import_chalk2.default.cyan(this.prefix("\u2139\uFE0F", message)), ...args);
+  }
+  warn(message, ...args) {
+    if (this.quiet) return;
+    console.warn(import_chalk2.default.yellow(this.prefix("\u{1F6A7}", message)), ...args);
+  }
+  error(message, ...args) {
+    if (this.quiet) return;
+    console.error(import_chalk2.default.red(this.prefix("\u274C", message)), ...args);
+  }
+};
+
 // src/server/routes.ts
 var import_cors = require("hono/cors");
 function setupRoutes(app, agentManager, sessionManager, agentsDir) {
@@ -384,6 +419,10 @@ var import_adk = require("@iqai/adk");
 var AgentScanner = class {
   constructor(quiet = false) {
     this.quiet = quiet;
+    this.logger = new Logger({ name: "session-manager", quiet: this.quiet });
+  }
+  logger;
+  async getSessionMessages(loadedAgent) {
   }
   scanAgents(agentsDir, loadedAgents) {
     const agents = /* @__PURE__ */ new Map();
@@ -403,7 +442,6 @@ var AgentScanner = class {
       return skipDirs.includes(dirName);
     };
     const scanDirectory = (dir) => {
-      if (!(0, import_node_fs2.existsSync)(dir)) return;
       const items = (0, import_node_fs2.readdirSync)(dir);
       for (const item of items) {
         const fullPath = (0, import_node_path2.join)(dir, item);
@@ -435,9 +473,7 @@ var AgentScanner = class {
       }
     };
     scanDirectory(scanDir);
-    if (!this.quiet) {
-      console.log(`\u2705 Agent scan complete. Found ${agents.size} agents.`);
-    }
+    this.logger.info(`Agent scan complete. Found ${agents.size} agents. \u2728`);
     return agents;
   }
   extractAgentNameFromFile(filePath) {
@@ -456,7 +492,9 @@ var AgentScanner = class {
 var AgentLoader = class {
   constructor(quiet = false) {
     this.quiet = quiet;
+    this.logger = new Logger({ name: "agent-loader", quiet: this.quiet });
   }
+  logger;
   /**
    * Import a TypeScript file by compiling it on-demand
    */
@@ -517,15 +555,11 @@ var AgentLoader = class {
       if (agentExport) {
         const isPrimitive = (v) => v == null || ["string", "number", "boolean"].includes(typeof v);
         if (isPrimitive(agentExport)) {
-          if (!this.quiet) {
-            console.log(
-              `\u2139\uFE0F Ignoring primitive 'agent' export in ${filePath}; scanning module for factory...`
-            );
-          }
+          this.logger.info(
+            `Ignoring primitive 'agent' export in ${filePath}; scanning module for factory...`
+          );
         } else {
-          if (!this.quiet) {
-            console.log(`\u2705 TS agent imported via esbuild: ${filePath}`);
-          }
+          this.logger.info(`TS agent imported via esbuild: ${filePath} \u2705`);
           return { agent: agentExport };
         }
       }
@@ -571,8 +605,8 @@ var AgentLoader = class {
             }
           }
         } catch (error) {
-          console.warn(
-            `\u26A0\uFE0F Warning: Could not load ${envFile} file: ${error instanceof Error ? error.message : String(error)}`
+          this.logger.warn(
+            `Warning: Could not load ${envFile} file: ${error instanceof Error ? error.message : String(error)}`
           );
         }
       }
@@ -653,11 +687,13 @@ var AgentManager = class {
     this.quiet = quiet;
     this.scanner = new AgentScanner(quiet);
     this.loader = new AgentLoader(quiet);
+    this.logger = new Logger({ name: "agent-manager", quiet: this.quiet });
   }
   agents = /* @__PURE__ */ new Map();
   loadedAgents = /* @__PURE__ */ new Map();
   scanner;
   loader;
+  logger;
   getAgents() {
     return this.agents;
   }
@@ -711,7 +747,10 @@ var AgentManager = class {
       agent.instance = exportedAgent;
       agent.name = exportedAgent.name;
     } catch (error) {
-      console.error(`\u274C Failed to load agent "${agent.name}":`, error);
+      const agentName = agent?.name ?? agentPath;
+      this.logger.error(
+        `Failed to load agent "${agentName}": ${error instanceof Error ? error.message : String(error)}`
+      );
       throw new Error(
         `Failed to load agent: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -752,9 +791,8 @@ var AgentManager = class {
       return response;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error(
-        `Error sending message to agent ${agentPath}:`,
-        errorMessage
+      this.logger.error(
+        `Error sending message to agent ${agentPath}: ${errorMessage}`
       );
       throw new Error(`Failed to send message to agent: ${errorMessage}`);
     }
@@ -766,9 +804,12 @@ var AgentManager = class {
   }
 };
 var SessionManager = class {
-  constructor(sessionService) {
+  constructor(sessionService, quiet = false) {
     this.sessionService = sessionService;
+    this.quiet = quiet;
+    this.logger = new Logger({ name: "session-manager", quiet: this.quiet });
   }
+  logger;
   async getSessionMessages(loadedAgent) {
     try {
       const session = await this.sessionService.getSession(
@@ -789,7 +830,10 @@ var SessionManager = class {
       }));
       return messages;
     } catch (error) {
-      console.error("Error fetching messages:", error);
+      this.logger.error(
+        "Error fetching messages:",
+        error instanceof Error ? error.message : String(error)
+      );
       return [];
     }
   }
@@ -803,13 +847,16 @@ var ADKServer = class {
   app;
   server;
   config;
+  logger;
   constructor(agentsDir, port = 8042, host = "localhost", quiet = false) {
     this.config = { agentsDir, port, host, quiet };
+    this.logger = new Logger({ name: "adk-server", quiet });
     this.sessionService = new import_adk2.InMemorySessionService();
     this.agentManager = new AgentManager(this.sessionService, quiet);
-    this.sessionManager = new SessionManager(this.sessionService);
+    this.sessionManager = new SessionManager(this.sessionService, quiet);
     this.app = new import_hono.Hono();
     setupRoutes(this.app, this.agentManager, this.sessionManager, agentsDir);
+    this.logger.info(`Starting agent scan in ${agentsDir} \u2728`);
     this.agentManager.scanAgents(agentsDir);
   }
   async start() {
@@ -820,16 +867,21 @@ var ADKServer = class {
         hostname: this.config.host
       });
       setTimeout(() => {
+        this.logger.info(
+          `Server listening on http://${this.config.host}:${this.config.port} \u{1F680}`
+        );
         resolve2();
       }, 100);
     });
   }
   async stop() {
     return new Promise((resolve2) => {
+      this.logger.info("Stopping server and all agents... \u{1F6D1}");
       this.agentManager.stopAllAgents();
       if (this.server) {
         this.server.close();
       }
+      this.logger.info("Server stopped");
       resolve2();
     });
   }
@@ -844,21 +896,21 @@ async function serveCommand(options = {}) {
   const host = options.host || "localhost";
   const agentsDir = (0, import_node_path3.resolve)(options.dir || ".");
   if (!(0, import_node_fs3.existsSync)(agentsDir)) {
-    console.error(import_chalk2.default.red(`\u274C Directory not found: ${agentsDir}`));
+    console.error(import_chalk3.default.red(`\u274C Directory not found: ${agentsDir}`));
     process.exit(1);
   }
   if (!options.quiet) {
-    console.log(import_chalk2.default.blue(`\u{1F680} ADK Server starting on http://${host}:${port}`));
+    console.log(import_chalk3.default.blue(`\u{1F680} ADK Server starting on http://${host}:${port}`));
   }
   const server = new ADKServer(agentsDir, port, host, options.quiet);
   try {
     await server.start();
     if (!options.quiet) {
-      console.log(import_chalk2.default.green("\u2705 Server ready"));
+      console.log(import_chalk3.default.green("\u2705 Server ready"));
     }
     const cleanup = async () => {
       if (!options.quiet) {
-        console.log(import_chalk2.default.yellow("\n\u{1F6D1} Stopping server..."));
+        console.log(import_chalk3.default.yellow("\n\u{1F6D1} Stopping server..."));
       }
       await server.stop();
       process.exit(0);
@@ -867,7 +919,7 @@ async function serveCommand(options = {}) {
     process.on("SIGTERM", cleanup);
     return server;
   } catch (error) {
-    console.error(import_chalk2.default.red("\u274C Failed to start ADK server:"), error);
+    console.error(import_chalk3.default.red("\u274C Failed to start ADK server:"), error);
     process.exit(1);
   }
 }
@@ -990,7 +1042,7 @@ var AgentChatClient = class {
           await this.sendMessage(message.trim());
         }
       } catch (error) {
-        console.error(import_chalk3.default.red("Error in chat:"), error);
+        console.error(import_chalk4.default.red("Error in chat:"), error);
         break;
       }
     }
@@ -1007,7 +1059,7 @@ async function runAgent(agentPath, options = {}) {
   if (options.server) {
     const apiPort = 8042;
     const host = options.host || "localhost";
-    console.log(import_chalk3.default.blue("\u{1F680} Starting ADK Server..."));
+    console.log(import_chalk4.default.blue("\u{1F680} Starting ADK Server..."));
     const serveOptions = {
       port: apiPort,
       dir: process.cwd(),
@@ -1016,16 +1068,16 @@ async function runAgent(agentPath, options = {}) {
     };
     try {
       const server = await serveCommand(serveOptions);
-      console.log(import_chalk3.default.cyan("Press Ctrl+C to stop the server"));
+      console.log(import_chalk4.default.cyan("Press Ctrl+C to stop the server"));
       process.on("SIGINT", async () => {
-        console.log(import_chalk3.default.yellow("\n\u{1F6D1} Stopping server..."));
+        console.log(import_chalk4.default.yellow("\n\u{1F6D1} Stopping server..."));
         await server.stop();
         process.exit(0);
       });
       return new Promise(() => {
       });
     } catch (error) {
-      console.error(import_chalk3.default.red("\u274C Failed to start server"));
+      console.error(import_chalk4.default.red("\u274C Failed to start server"));
       process.exit(1);
     }
   }
@@ -1089,14 +1141,14 @@ async function runAgent(agentPath, options = {}) {
 }
 
 // src/commands/web.ts
-var import_chalk4 = __toESM(require("chalk"));
+var import_chalk5 = __toESM(require("chalk"));
 async function webCommand(options = {}) {
   const apiPort = options.port || 8042;
   const webPort = options.webPort || 3e3;
   const host = options.host || "localhost";
   const useLocal = options.local || false;
   const webUrl = options.webUrl || "https://adk-web.iqai.com";
-  console.log(import_chalk4.default.blue("\u{1F310} Starting ADK Web Interface..."));
+  console.log(import_chalk5.default.blue("\u{1F310} Starting ADK Web Interface..."));
   const serveOptions = {
     port: apiPort,
     dir: options.dir,
@@ -1118,9 +1170,9 @@ async function webCommand(options = {}) {
       webAppUrl = `${webUrl}?port=${apiPort}`;
     }
   }
-  console.log(import_chalk4.default.cyan(`\u{1F517} Open this URL in your browser: ${webAppUrl}`));
-  console.log(import_chalk4.default.gray(`   API Server: http://${host}:${apiPort}`));
-  console.log(import_chalk4.default.cyan("Press Ctrl+C to stop the API server"));
+  console.log(import_chalk5.default.cyan(`\u{1F517} Open this URL in your browser: ${webAppUrl}`));
+  console.log(import_chalk5.default.gray(`   API Server: http://${host}:${apiPort}`));
+  console.log(import_chalk5.default.cyan("Press Ctrl+C to stop the API server"));
 }
 
 // src/index.ts
@@ -1132,7 +1184,7 @@ import_commander.program.command("new").description("Create a new ADK project").
   try {
     await createProject(projectName, options);
   } catch (error) {
-    console.error(import_chalk5.default.red("Error creating project:"), error);
+    console.error(import_chalk6.default.red("Error creating project:"), error);
     process.exit(1);
   }
 });
@@ -1147,7 +1199,7 @@ import_commander.program.command("run").description("Start an interactive chat w
   try {
     await runAgent(agentPath, options);
   } catch (error) {
-    console.error(import_chalk5.default.red("Error running agent:"), error);
+    console.error(import_chalk6.default.red("Error running agent:"), error);
     process.exit(1);
   }
 });
@@ -1167,7 +1219,7 @@ import_commander.program.command("web").description("Start a web interface for t
   try {
     await webCommand(options);
   } catch (error) {
-    console.error(import_chalk5.default.red("Error starting web UI:"), error);
+    console.error(import_chalk6.default.red("Error starting web UI:"), error);
     process.exit(1);
   }
 });
@@ -1179,7 +1231,7 @@ import_commander.program.command("serve").description("Start an API server for a
   try {
     await serveCommand(options);
   } catch (error) {
-    console.error(import_chalk5.default.red("Error starting server:"), error);
+    console.error(import_chalk6.default.red("Error starting server:"), error);
     process.exit(1);
   }
 });