praisonai 1.3.0 → 1.3.2

package/dist/agent/index.d.ts

@@ -4,10 +4,13 @@
  * The primary exports are:
  * - Agent: Single agent with instructions, tools, and optional persistence
  * - Agents: Multi-agent orchestration (alias for PraisonAIAgents)
+ * - Router: Simplified keyword/pattern-based routing
  * - Workflow: Step-based workflow execution (from workflows module)
  */
 export { Agent, PraisonAIAgents, Agents } from './simple';
 export type { SimpleAgentConfig, PraisonAIAgentsConfig } from './simple';
+export { Router, RouterAgent, createRouter, routeConditions } from './router';
+export type { RouterConfig, RouteConfig, RouteContext, SimpleRouterConfig, SimpleRouteConfig } from './router';
 export { Task } from './types';
 export type { TaskConfig, AgentConfig as TaskAgentConfig } from './types';
 /**

package/dist/agent/index.js

@@ -5,16 +5,23 @@
  * The primary exports are:
  * - Agent: Single agent with instructions, tools, and optional persistence
  * - Agents: Multi-agent orchestration (alias for PraisonAIAgents)
+ * - Router: Simplified keyword/pattern-based routing
  * - Workflow: Step-based workflow execution (from workflows module)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Task = exports.Agents = exports.PraisonAIAgents = exports.Agent = void 0;
+exports.Task = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.Router = exports.Agents = exports.PraisonAIAgents = exports.Agent = void 0;
 exports.setTaskMode = setTaskMode;
 // Core exports - the main API surface
 var simple_1 = require("./simple");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return simple_1.Agent; } });
 Object.defineProperty(exports, "PraisonAIAgents", { enumerable: true, get: function () { return simple_1.PraisonAIAgents; } });
 Object.defineProperty(exports, "Agents", { enumerable: true, get: function () { return simple_1.Agents; } });
+// Router exports
+var router_1 = require("./router");
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_1.Router; } });
+Object.defineProperty(exports, "RouterAgent", { enumerable: true, get: function () { return router_1.RouterAgent; } });
+Object.defineProperty(exports, "createRouter", { enumerable: true, get: function () { return router_1.createRouter; } });
+Object.defineProperty(exports, "routeConditions", { enumerable: true, get: function () { return router_1.routeConditions; } });
 // Task support (for advanced use cases)
 var types_1 = require("./types");
 Object.defineProperty(exports, "Task", { enumerable: true, get: function () { return types_1.Task; } });

package/dist/agent/router.d.ts

@@ -1,12 +1,32 @@
 /**
  * Router Agent - Route requests to specialized agents
+ *
+ * @example Simple usage (5 lines)
+ * ```typescript
+ * import { Agent, Router } from 'praisonai';
+ *
+ * const router = new Router({
+ *   math: { agent: new Agent({ instructions: 'Math expert' }), keywords: ['calculate', 'math'] },
+ *   code: { agent: new Agent({ instructions: 'Code expert' }), keywords: ['code', 'program'] }
+ * });
+ * await router.chat('Calculate 2+2');  // Routes to math agent
+ * ```
  */
 import type { EnhancedAgent } from './enhanced';
+import { Agent } from './simple';
+type AnyAgent = Agent | EnhancedAgent;
 export interface RouteConfig {
-    agent: EnhancedAgent;
+    agent: AnyAgent;
     condition: (input: string, context?: RouteContext) => boolean | Promise<boolean>;
     priority?: number;
 }
+/** Simplified route definition */
+export interface SimpleRouteConfig {
+    agent: AnyAgent;
+    keywords?: string[];
+    pattern?: RegExp;
+    priority?: number;
+}
 export interface RouteContext {
     history?: string[];
     metadata?: Record<string, any>;
@@ -14,9 +34,11 @@ export interface RouteContext {
 export interface RouterConfig {
     name?: string;
     routes: RouteConfig[];
-    defaultAgent?: EnhancedAgent;
+    defaultAgent?: AnyAgent;
     verbose?: boolean;
 }
+/** Simplified router config - just a map of route name to config */
+export type SimpleRouterConfig = Record<string, SimpleRouteConfig>;
 /**
  * Router Agent - Routes requests to the most appropriate agent
  */
@@ -30,9 +52,13 @@ export declare class RouterAgent {
      * Route a request to the appropriate agent
      */
     route(input: string, context?: RouteContext): Promise<{
-        agent: EnhancedAgent;
+        agent: AnyAgent;
         response: string;
     } | null>;
+    /**
+     * Simplified chat method - routes and returns just the response
+     */
+    chat(input: string, context?: RouteContext): Promise<string>;
     /**
      * Add a route
      */
@@ -72,6 +98,44 @@ export declare const routeConditions: {
     or: (...conditions: Array<(input: string, context?: RouteContext) => boolean>) => (input: string, context?: RouteContext) => boolean;
 };
 /**
- * Create a router agent
+ * Create a router agent (legacy API)
  */
 export declare function createRouter(config: RouterConfig): RouterAgent;
+/**
+ * Simplified Router class - uses keyword/pattern-based routing
+ *
+ * @example Simple usage (5 lines)
+ * ```typescript
+ * import { Agent, Router } from 'praisonai';
+ *
+ * const router = new Router({
+ *   math: { agent: new Agent({ instructions: 'Math expert' }), keywords: ['calculate', 'math'] },
+ *   code: { agent: new Agent({ instructions: 'Code expert' }), keywords: ['code', 'program'] }
+ * });
+ * await router.chat('Calculate 2+2');  // Routes to math agent
+ * ```
+ */
+export declare class Router {
+    private routerAgent;
+    private agentMap;
+    constructor(config: SimpleRouterConfig, options?: {
+        default?: string;
+        verbose?: boolean;
+    });
+    /**
+     * Route and get response
+     */
+    chat(input: string): Promise<string>;
+    /**
+     * Route and get full result with agent info
+     */
+    route(input: string): Promise<{
+        agent: AnyAgent;
+        response: string;
+    } | null>;
+    /**
+     * Get agent by name
+     */
+    getAgent(name: string): AnyAgent | undefined;
+}
+export {};

package/dist/agent/router.js

@@ -1,9 +1,20 @@
 "use strict";
 /**
  * Router Agent - Route requests to specialized agents
+ *
+ * @example Simple usage (5 lines)
+ * ```typescript
+ * import { Agent, Router } from 'praisonai';
+ *
+ * const router = new Router({
+ *   math: { agent: new Agent({ instructions: 'Math expert' }), keywords: ['calculate', 'math'] },
+ *   code: { agent: new Agent({ instructions: 'Code expert' }), keywords: ['code', 'program'] }
+ * });
+ * await router.chat('Calculate 2+2');  // Routes to math agent
+ * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.routeConditions = exports.RouterAgent = void 0;
+exports.Router = exports.routeConditions = exports.RouterAgent = void 0;
 exports.createRouter = createRouter;
 /**
  * Router Agent - Routes requests to the most appropriate agent
@@ -26,7 +37,9 @@ class RouterAgent {
                     console.log(`[Router] Routing to: ${route.agent.name}`);
                 }
                 const response = await route.agent.chat(input);
-                return { agent: route.agent, response: response.text };
+                // Handle both Agent (returns string) and EnhancedAgent (returns ChatResult)
+                const responseText = typeof response === 'string' ? response : response.text;
+                return { agent: route.agent, response: responseText };
             }
         }
         if (this.defaultAgent) {
@@ -34,10 +47,21 @@ class RouterAgent {
                 console.log(`[Router] Using default agent: ${this.defaultAgent.name}`);
             }
             const response = await this.defaultAgent.chat(input);
-            return { agent: this.defaultAgent, response: response.text };
+            const responseText = typeof response === 'string' ? response : response.text;
+            return { agent: this.defaultAgent, response: responseText };
         }
         return null;
     }
+    /**
+     * Simplified chat method - routes and returns just the response
+     */
+    async chat(input, context) {
+        const result = await this.route(input, context);
+        if (!result) {
+            throw new Error('No matching route found and no default agent configured');
+        }
+        return result.response;
+    }
     /**
      * Add a route
      */
@@ -106,8 +130,80 @@ exports.routeConditions = {
     }
 };
 /**
- * Create a router agent
+ * Create a router agent (legacy API)
  */
 function createRouter(config) {
     return new RouterAgent(config);
 }
+/**
+ * Simplified Router class - uses keyword/pattern-based routing
+ *
+ * @example Simple usage (5 lines)
+ * ```typescript
+ * import { Agent, Router } from 'praisonai';
+ *
+ * const router = new Router({
+ *   math: { agent: new Agent({ instructions: 'Math expert' }), keywords: ['calculate', 'math'] },
+ *   code: { agent: new Agent({ instructions: 'Code expert' }), keywords: ['code', 'program'] }
+ * });
+ * await router.chat('Calculate 2+2');  // Routes to math agent
+ * ```
+ */
+class Router {
+    constructor(config, options) {
+        this.agentMap = new Map();
+        const routes = [];
+        let defaultAgent;
+        for (const [name, routeConfig] of Object.entries(config)) {
+            this.agentMap.set(name, routeConfig.agent);
+            // Build condition from keywords or pattern
+            let condition;
+            if (routeConfig.keywords) {
+                condition = exports.routeConditions.keywords(routeConfig.keywords);
+            }
+            else if (routeConfig.pattern) {
+                condition = exports.routeConditions.pattern(routeConfig.pattern);
+            }
+            else {
+                condition = exports.routeConditions.always();
+            }
+            routes.push({
+                agent: routeConfig.agent,
+                condition,
+                priority: routeConfig.priority
+            });
+            // Set default agent
+            if (options?.default === name) {
+                defaultAgent = routeConfig.agent;
+            }
+        }
+        // If no default specified, use first agent
+        if (!defaultAgent && routes.length > 0) {
+            defaultAgent = routes[0].agent;
+        }
+        this.routerAgent = new RouterAgent({
+            routes,
+            defaultAgent,
+            verbose: options?.verbose
+        });
+    }
+    /**
+     * Route and get response
+     */
+    async chat(input) {
+        return this.routerAgent.chat(input);
+    }
+    /**
+     * Route and get full result with agent info
+     */
+    async route(input) {
+        return this.routerAgent.route(input);
+    }
+    /**
+     * Get agent by name
+     */
+    getAgent(name) {
+        return this.agentMap.get(name);
+    }
+}
+exports.Router = Router;

package/dist/agent/simple.d.ts

@@ -62,10 +62,22 @@ export interface SimpleAgentConfig {
     toolFunctions?: Record<string, Function>;
     /** Database adapter for persistence */
     db?: DbAdapter;
-    /** Session ID for conversation persistence */
+    /** Session ID for conversation persistence (auto-generated if not provided) */
     sessionId?: string;
     /** Run ID for tracing (auto-generated if not provided) */
     runId?: string;
+    /** Max messages to restore from history (default: 100) */
+    historyLimit?: number;
+    /** Auto-restore conversation history from db (default: true) */
+    autoRestore?: boolean;
+    /** Auto-persist messages to db (default: true) */
+    autoPersist?: boolean;
+    /** Enable caching of responses */
+    cache?: boolean;
+    /** Cache TTL in seconds (default: 3600) */
+    cacheTTL?: number;
+    /** Enable telemetry tracking (default: false, opt-in) */
+    telemetry?: boolean;
     /** Agent role (advanced mode) */
     role?: string;
     /** Agent goal (advanced mode) */
@@ -88,7 +100,31 @@ export declare class Agent {
     private sessionId;
     private runId;
     private messages;
+    private dbInitialized;
+    private historyLimit;
+    private autoRestore;
+    private autoPersist;
+    private cache;
+    private cacheTTL;
+    private responseCache;
+    private telemetryEnabled;
     constructor(config: SimpleAgentConfig);
+    /**
+     * Generate a session ID based on current hour and agent name (like Python SDK)
+     */
+    private generateSessionId;
+    /**
+     * Initialize DB session - restore history on first chat (lazy)
+     */
+    private initDbSession;
+    /**
+     * Get cached response if available and not expired
+     */
+    private getCachedResponse;
+    /**
+     * Cache a response
+     */
+    private cacheResponse;
     private createSystemPrompt;
     /**
      * Register a tool function that can be called by the model
@@ -131,6 +167,21 @@ export declare class Agent {
     getRunId(): string;
     getResult(): string | null;
     getInstructions(): string;
+    /**
+     * Get conversation history
+     */
+    getHistory(): Array<{
+        role: string;
+        content: string | null;
+    }>;
+    /**
+     * Clear conversation history (in memory and optionally in DB)
+     */
+    clearHistory(clearDb?: boolean): Promise<void>;
+    /**
+     * Clear response cache
+     */
+    clearCache(): void;
 }
 /**
  * Configuration for multi-agent orchestration

package/dist/agent/simple.js

@@ -8,6 +8,8 @@ class Agent {
     constructor(config) {
         this.toolFunctions = {};
         this.messages = [];
+        this.dbInitialized = false;
+        this.responseCache = new Map();
         // Build instructions from either simple or advanced mode
         if (config.instructions) {
             this.instructions = config.instructions;
@@ -34,8 +36,14 @@ class Agent {
         this.stream = config.stream ?? true;
         this.tools = config.tools;
         this.dbAdapter = config.db;
-        this.sessionId = config.sessionId || (0, crypto_1.randomUUID)();
+        this.sessionId = config.sessionId || this.generateSessionId();
         this.runId = config.runId || (0, crypto_1.randomUUID)();
+        this.historyLimit = config.historyLimit ?? 100;
+        this.autoRestore = config.autoRestore ?? true;
+        this.autoPersist = config.autoPersist ?? true;
+        this.cache = config.cache ?? false;
+        this.cacheTTL = config.cacheTTL ?? 3600;
+        this.telemetryEnabled = config.telemetry ?? false;
         this.llmService = new openai_1.OpenAIService(this.llm);
         // Configure logging
         logger_1.Logger.setVerbose(this.verbose);
@@ -85,6 +93,65 @@ class Agent {
             }
         }
     }
+    /**
+     * Generate a session ID based on current hour and agent name (like Python SDK)
+     */
+    generateSessionId() {
+        const now = new Date();
+        const hourStr = now.toISOString().slice(0, 13).replace(/[-T:]/g, '');
+        const hash = this.name ? this.name.slice(0, 6) : 'agent';
+        return `${hourStr}-${hash}`;
+    }
+    /**
+     * Initialize DB session - restore history on first chat (lazy)
+     */
+    async initDbSession() {
+        if (this.dbInitialized || !this.dbAdapter || !this.autoRestore)
+            return;
+        try {
+            // Restore previous messages from DB
+            const history = await this.dbAdapter.getMessages(this.sessionId, this.historyLimit);
+            if (history.length > 0) {
+                this.messages = history.map(m => ({
+                    role: m.role,
+                    content: m.content
+                }));
+                logger_1.Logger.debug(`Restored ${history.length} messages from session ${this.sessionId}`);
+            }
+        }
+        catch (error) {
+            logger_1.Logger.warn('Failed to initialize DB session:', error);
+        }
+        this.dbInitialized = true;
+    }
+    /**
+     * Get cached response if available and not expired
+     */
+    getCachedResponse(prompt) {
+        if (!this.cache)
+            return null;
+        const cacheKey = `${this.sessionId}:${prompt}`;
+        const cached = this.responseCache.get(cacheKey);
+        if (cached) {
+            const age = (Date.now() - cached.timestamp) / 1000;
+            if (age < this.cacheTTL) {
+                logger_1.Logger.debug('Cache hit for prompt');
+                return cached.response;
+            }
+            // Expired, remove it
+            this.responseCache.delete(cacheKey);
+        }
+        return null;
+    }
+    /**
+     * Cache a response
+     */
+    cacheResponse(prompt, response) {
+        if (!this.cache)
+            return;
+        const cacheKey = `${this.sessionId}:${prompt}`;
+        this.responseCache.set(cacheKey, { response, timestamp: Date.now() });
+    }
     createSystemPrompt() {
         let prompt = this.instructions;
         if (this.markdown) {
@@ -210,20 +277,24 @@ class Agent {
             if (previousResult) {
                 prompt = prompt.replace('{{previous}}', previousResult);
             }
-            // Initialize messages array
+            // Initialize messages array with system prompt and conversation history
             const messages = [
-                { role: 'system', content: this.createSystemPrompt() },
-                { role: 'user', content: prompt }
+                { role: 'system', content: this.createSystemPrompt() }
             ];
+            // Add conversation history (excluding the current prompt which will be added below)
+            for (const msg of this.messages) {
+                if (msg.role && msg.content) {
+                    messages.push({ role: msg.role, content: msg.content });
+                }
+            }
+            // Add current user prompt
+            messages.push({ role: 'user', content: prompt });
             let finalResponse = '';
             if (this.stream && !this.tools) {
-                // Use streaming without tools
-                let fullResponse = '';
-                await this.llmService.streamText(prompt, this.createSystemPrompt(), 0.7, (token) => {
+                // Use streaming with full conversation history
+                finalResponse = await this.llmService.streamChat(messages, 0.7, (token) => {
                     process.stdout.write(token);
-                    fullResponse += token;
                 });
-                finalResponse = fullResponse;
             }
             else if (this.tools) {
                 // Use tools (non-streaming for now to simplify implementation)
@@ -272,15 +343,28 @@ class Agent {
         }
     }
     async chat(prompt, previousResult) {
-        // Persist user message if db is configured
-        if (this.dbAdapter) {
+        // Lazy init: restore history on first chat (like Python SDK)
+        await this.initDbSession();
+        // Check cache first
+        const cached = this.getCachedResponse(prompt);
+        if (cached) {
+            return cached;
+        }
+        // Add user message to conversation history
+        this.messages.push({ role: 'user', content: prompt });
+        // Persist user message if db is configured and autoPersist is enabled
+        if (this.dbAdapter && this.autoPersist) {
             await this.persistMessage('user', prompt);
         }
         const response = await this.start(prompt, previousResult);
-        // Persist assistant response if db is configured
-        if (this.dbAdapter) {
+        // Add assistant response to history
+        this.messages.push({ role: 'assistant', content: response });
+        // Persist assistant response if db is configured and autoPersist is enabled
+        if (this.dbAdapter && this.autoPersist) {
             await this.persistMessage('assistant', response);
         }
+        // Cache the response
+        this.cacheResponse(prompt, response);
         return response;
     }
     async execute(previousResult) {
@@ -326,6 +410,33 @@ class Agent {
     getInstructions() {
         return this.instructions;
     }
+    /**
+     * Get conversation history
+     */
+    getHistory() {
+        return [...this.messages];
+    }
+    /**
+     * Clear conversation history (in memory and optionally in DB)
+     */
+    async clearHistory(clearDb = true) {
+        this.messages = [];
+        if (clearDb && this.dbAdapter) {
+            try {
+                await this.dbAdapter.deleteMessages(this.sessionId);
+                logger_1.Logger.debug(`Cleared history for session ${this.sessionId}`);
+            }
+            catch (error) {
+                logger_1.Logger.warn('Failed to clear DB history:', error);
+            }
+        }
+    }
+    /**
+     * Clear response cache
+     */
+    clearCache() {
+        this.responseCache.clear();
+    }
 }
 exports.Agent = Agent;
 /**

package/dist/index.d.ts

@@ -36,8 +36,8 @@
  * await agents.start();
  * ```
  */
-export { Agent, Agents, PraisonAIAgents } from './agent';
-export type { SimpleAgentConfig, PraisonAIAgentsConfig } from './agent';
+export { Agent, Agents, PraisonAIAgents, Router } from './agent';
+export type { SimpleAgentConfig, PraisonAIAgentsConfig, SimpleRouterConfig, SimpleRouteConfig } from './agent';
 export { Workflow, parallel, route, loop, repeat } from './workflows';
 export type { WorkflowStep, WorkflowContext, StepResult } from './workflows';
 export { db, createDbAdapter, getDefaultDbAdapter, setDefaultDbAdapter } from './db';
@@ -61,14 +61,14 @@ export { Memory, createMemory } from './memory/memory';
 export type { MemoryEntry, MemoryConfig } from './memory/memory';
 export { FileMemory, createFileMemory, type FileMemoryConfig, type FileMemoryEntry } from './memory/file-memory';
 export { AutoMemory, createAutoMemory, createLLMSummarizer, DEFAULT_POLICIES, type AutoMemoryConfig, type AutoMemoryPolicy, type AutoMemoryContext, type VectorStoreAdapter as AutoMemoryVectorStore, type KnowledgeBaseAdapter as AutoMemoryKnowledgeBase } from './memory/auto-memory';
-export { TelemetryCollector, getTelemetry, enableTelemetry, disableTelemetry, cleanupTelemetry, type TelemetryEvent, type TelemetryConfig } from './telemetry';
+export { TelemetryCollector, AgentTelemetry, getTelemetry, enableTelemetry, disableTelemetry, cleanupTelemetry, createAgentTelemetry, type TelemetryEvent, type TelemetryConfig, type AgentStats } from './telemetry';
 export { AutoAgents, createAutoAgents, type AgentConfig, type TaskConfig, type TeamStructure, type AutoAgentsConfig } from './auto';
 export { ImageAgent, createImageAgent, type ImageAgentConfig, type ImageGenerationConfig, type ImageAnalysisConfig } from './agent/image';
 export { DeepResearchAgent, createDeepResearchAgent, type DeepResearchConfig, type ResearchResponse, type Citation, type ReasoningStep } from './agent/research';
 export { QueryRewriterAgent, createQueryRewriterAgent, type QueryRewriterConfig, type RewriteResult, type RewriteStrategy } from './agent/query-rewriter';
 export { PromptExpanderAgent, createPromptExpanderAgent, type PromptExpanderConfig, type ExpandResult, type ExpandStrategy } from './agent/prompt-expander';
 export { LLMGuardrail, createLLMGuardrail, type LLMGuardrailConfig, type LLMGuardrailResult } from './guardrails/llm-guardrail';
-export { Plan, PlanStep, TodoList, TodoItem, PlanStorage, createPlan, createTodoList, createPlanStorage, type PlanConfig, type PlanStepConfig, type TodoItemConfig, type PlanStatus, type TodoStatus } from './planning';
+export { Plan, PlanStep, TodoList, TodoItem, PlanStorage, PlanningAgent, TaskAgent, createPlan, createTodoList, createPlanStorage, createPlanningAgent, createTaskAgent, type PlanConfig, type PlanStepConfig, type TodoItemConfig, type PlanStatus, type TodoStatus, type PlanningAgentConfig, type PlanResult } from './planning';
 export { BaseCache, MemoryCache, FileCache, createMemoryCache, createFileCache, type CacheConfig, type CacheEntry } from './cache';
 export { PubSub, EventEmitterPubSub, AgentEventBus, AgentEvents, createEventBus, createPubSub, type Event, type EventHandler } from './events';
 export { parseYAMLWorkflow, createWorkflowFromYAML, loadWorkflowFromFile, validateWorkflowDefinition, type YAMLWorkflowDefinition, type YAMLStepDefinition, type ParsedWorkflow } from './workflows/yaml-parser';

package/dist/index.js

@@ -52,11 +52,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAutoMemory = exports.AutoMemory = exports.createFileMemory = exports.FileMemory = exports.createMemory = exports.Memory = exports.CLI_SPEC_VERSION = exports.executeCommand = exports.parseArgs = exports.parseSkillFile = exports.createSkillManager = exports.SkillManager = exports.getObservabilityAdapter = exports.setObservabilityAdapter = exports.ConsoleObservabilityAdapter = exports.MemoryObservabilityAdapter = exports.EvalSuite = exports.reliabilityEval = exports.performanceEval = exports.accuracyEval = exports.createContextAgent = exports.ContextAgent = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.handoffFilters = exports.handoff = exports.Handoff = exports.getTool = exports.registerTool = exports.getRegistry = exports.ToolRegistry = exports.tool = exports.FunctionTool = exports.createTool = exports.validateTool = exports.ToolValidationError = exports.BaseTool = exports.setDefaultDbAdapter = exports.getDefaultDbAdapter = exports.createDbAdapter = exports.db = exports.repeat = exports.loop = exports.route = exports.parallel = exports.Workflow = exports.PraisonAIAgents = exports.Agents = exports.Agent = void 0;
-exports.MemoryPostgresAdapter = exports.NeonPostgresAdapter = exports.createMemoryRedis = exports.createUpstashRedis = exports.MemoryRedisAdapter = exports.UpstashRedisAdapter = exports.createSQLiteAdapter = exports.SQLiteAdapter = exports.validateWorkflowDefinition = exports.loadWorkflowFromFile = exports.createWorkflowFromYAML = exports.parseYAMLWorkflow = exports.createPubSub = exports.createEventBus = exports.AgentEvents = exports.AgentEventBus = exports.EventEmitterPubSub = exports.PubSub = exports.createFileCache = exports.createMemoryCache = exports.FileCache = exports.MemoryCache = exports.BaseCache = exports.createPlanStorage = exports.createTodoList = exports.createPlan = exports.PlanStorage = exports.TodoItem = exports.TodoList = exports.PlanStep = exports.Plan = exports.createLLMGuardrail = exports.LLMGuardrail = exports.createPromptExpanderAgent = exports.PromptExpanderAgent = exports.createQueryRewriterAgent = exports.QueryRewriterAgent = exports.createDeepResearchAgent = exports.DeepResearchAgent = exports.createImageAgent = exports.ImageAgent = exports.createAutoAgents = exports.AutoAgents = exports.cleanupTelemetry = exports.disableTelemetry = exports.enableTelemetry = exports.getTelemetry = exports.TelemetryCollector = exports.DEFAULT_POLICIES = exports.createLLMSummarizer = void 0;
-exports.parseSlashCommand = exports.registerCommand = exports.createSlashCommandHandler = exports.SlashCommandHandler = exports.BaseProvider = exports.GoogleProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.getAvailableProviders = exports.isProviderAvailable = exports.parseModelString = exports.getDefaultProvider = exports.createProvider = exports.createGraphRAG = exports.GraphRAG = exports.GraphStore = exports.createLLMReranker = exports.createCrossEncoderReranker = exports.createCohereReranker = exports.LLMReranker = exports.CrossEncoderReranker = exports.CohereReranker = exports.BaseReranker = exports.createElevenLabsVoice = exports.createOpenAIVoice = exports.ElevenLabsVoiceProvider = exports.OpenAIVoiceProvider = exports.BaseVoiceProvider = exports.createLangfuseObservability = exports.createMemoryObservability = exports.createConsoleObservability = exports.LangfuseObservabilityProvider = exports.MemoryObservabilityProvider = exports.ConsoleObservabilityProvider = exports.BaseObservabilityProvider = exports.createChromaStore = exports.ChromaVectorStore = exports.createQdrantStore = exports.QdrantVectorStore = exports.createWeaviateStore = exports.WeaviateVectorStore = exports.createPineconeStore = exports.PineconeVectorStore = exports.createMemoryVectorStore = exports.MemoryVectorStore = exports.BaseVectorStore = exports.createPostgresSessionStorage = exports.createMemoryPostgres = exports.createNeonPostgres = exports.PostgresSessionStorage = void 0;
-exports.GeminiCliAgent = exports.ClaudeCodeAgent = exports.BaseExternalAgent = exports.renderWorkflow = exports.createFlowDisplay = exports.FlowDisplay = exports.createFileCheckpointStorage = exports.FileCheckpointStorage = exports.MemoryCheckpointStorage = exports.createCheckpointManager = exports.CheckpointManager = exports.createFileJobStorage = exports.FileJobStorage = exports.MemoryJobStorage = exports.createJobQueue = exports.JobQueue = exports.cronExpressions = exports.createScheduler = exports.Scheduler = exports.MODE_POLICIES = exports.cliApprovalPrompt = exports.createAutonomyManager = exports.AutonomyManager = exports.DEFAULT_BLOCKED_PATHS = exports.DEFAULT_BLOCKED_COMMANDS = exports.CommandValidator = exports.sandboxExec = exports.createSandboxExecutor = exports.SandboxExecutor = exports.createDiffViewer = exports.DiffViewer = exports.createGitManager = exports.GitManager = exports.DEFAULT_IGNORE_PATTERNS = exports.getRepoTree = exports.createRepoMap = exports.RepoMap = exports.createHistoryManager = exports.HistoryManager = exports.createStatusDisplay = exports.StatusDisplay = exports.createInteractiveTUI = exports.InteractiveTUI = exports.MODEL_PRICING = exports.formatCost = exports.estimateTokens = exports.createCostTracker = exports.CostTracker = exports.isSlashCommand = exports.executeSlashCommand = void 0;
-exports.getQuickContext = exports.createFastContext = exports.FastContext = exports.triggerN8NWebhook = exports.createN8NIntegration = exports.N8NIntegration = exports.externalAgentAsTool = exports.createExternalAgent = exports.getExternalAgentRegistry = exports.GenericExternalAgent = exports.AiderAgent = exports.CodexCliAgent = void 0;
+exports.AutoMemory = exports.createFileMemory = exports.FileMemory = exports.createMemory = exports.Memory = exports.CLI_SPEC_VERSION = exports.executeCommand = exports.parseArgs = exports.parseSkillFile = exports.createSkillManager = exports.SkillManager = exports.getObservabilityAdapter = exports.setObservabilityAdapter = exports.ConsoleObservabilityAdapter = exports.MemoryObservabilityAdapter = exports.EvalSuite = exports.reliabilityEval = exports.performanceEval = exports.accuracyEval = exports.createContextAgent = exports.ContextAgent = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.handoffFilters = exports.handoff = exports.Handoff = exports.getTool = exports.registerTool = exports.getRegistry = exports.ToolRegistry = exports.tool = exports.FunctionTool = exports.createTool = exports.validateTool = exports.ToolValidationError = exports.BaseTool = exports.setDefaultDbAdapter = exports.getDefaultDbAdapter = exports.createDbAdapter = exports.db = exports.repeat = exports.loop = exports.route = exports.parallel = exports.Workflow = exports.Router = exports.PraisonAIAgents = exports.Agents = exports.Agent = void 0;
+exports.SQLiteAdapter = exports.validateWorkflowDefinition = exports.loadWorkflowFromFile = exports.createWorkflowFromYAML = exports.parseYAMLWorkflow = exports.createPubSub = exports.createEventBus = exports.AgentEvents = exports.AgentEventBus = exports.EventEmitterPubSub = exports.PubSub = exports.createFileCache = exports.createMemoryCache = exports.FileCache = exports.MemoryCache = exports.BaseCache = exports.createTaskAgent = exports.createPlanningAgent = exports.createPlanStorage = exports.createTodoList = exports.createPlan = exports.TaskAgent = exports.PlanningAgent = exports.PlanStorage = exports.TodoItem = exports.TodoList = exports.PlanStep = exports.Plan = exports.createLLMGuardrail = exports.LLMGuardrail = exports.createPromptExpanderAgent = exports.PromptExpanderAgent = exports.createQueryRewriterAgent = exports.QueryRewriterAgent = exports.createDeepResearchAgent = exports.DeepResearchAgent = exports.createImageAgent = exports.ImageAgent = exports.createAutoAgents = exports.AutoAgents = exports.createAgentTelemetry = exports.cleanupTelemetry = exports.disableTelemetry = exports.enableTelemetry = exports.getTelemetry = exports.AgentTelemetry = exports.TelemetryCollector = exports.DEFAULT_POLICIES = exports.createLLMSummarizer = exports.createAutoMemory = void 0;
+exports.OpenAIProvider = exports.getAvailableProviders = exports.isProviderAvailable = exports.parseModelString = exports.getDefaultProvider = exports.createProvider = exports.createGraphRAG = exports.GraphRAG = exports.GraphStore = exports.createLLMReranker = exports.createCrossEncoderReranker = exports.createCohereReranker = exports.LLMReranker = exports.CrossEncoderReranker = exports.CohereReranker = exports.BaseReranker = exports.createElevenLabsVoice = exports.createOpenAIVoice = exports.ElevenLabsVoiceProvider = exports.OpenAIVoiceProvider = exports.BaseVoiceProvider = exports.createLangfuseObservability = exports.createMemoryObservability = exports.createConsoleObservability = exports.LangfuseObservabilityProvider = exports.MemoryObservabilityProvider = exports.ConsoleObservabilityProvider = exports.BaseObservabilityProvider = exports.createChromaStore = exports.ChromaVectorStore = exports.createQdrantStore = exports.QdrantVectorStore = exports.createWeaviateStore = exports.WeaviateVectorStore = exports.createPineconeStore = exports.PineconeVectorStore = exports.createMemoryVectorStore = exports.MemoryVectorStore = exports.BaseVectorStore = exports.createPostgresSessionStorage = exports.createMemoryPostgres = exports.createNeonPostgres = exports.PostgresSessionStorage = exports.MemoryPostgresAdapter = exports.NeonPostgresAdapter = exports.createMemoryRedis = exports.createUpstashRedis = exports.MemoryRedisAdapter = exports.UpstashRedisAdapter = exports.createSQLiteAdapter = void 0;
+exports.FileCheckpointStorage = exports.MemoryCheckpointStorage = exports.createCheckpointManager = exports.CheckpointManager = exports.createFileJobStorage = exports.FileJobStorage = exports.MemoryJobStorage = exports.createJobQueue = exports.JobQueue = exports.cronExpressions = exports.createScheduler = exports.Scheduler = exports.MODE_POLICIES = exports.cliApprovalPrompt = exports.createAutonomyManager = exports.AutonomyManager = exports.DEFAULT_BLOCKED_PATHS = exports.DEFAULT_BLOCKED_COMMANDS = exports.CommandValidator = exports.sandboxExec = exports.createSandboxExecutor = exports.SandboxExecutor = exports.createDiffViewer = exports.DiffViewer = exports.createGitManager = exports.GitManager = exports.DEFAULT_IGNORE_PATTERNS = exports.getRepoTree = exports.createRepoMap = exports.RepoMap = exports.createHistoryManager = exports.HistoryManager = exports.createStatusDisplay = exports.StatusDisplay = exports.createInteractiveTUI = exports.InteractiveTUI = exports.MODEL_PRICING = exports.formatCost = exports.estimateTokens = exports.createCostTracker = exports.CostTracker = exports.isSlashCommand = exports.executeSlashCommand = exports.parseSlashCommand = exports.registerCommand = exports.createSlashCommandHandler = exports.SlashCommandHandler = exports.BaseProvider = exports.GoogleProvider = exports.AnthropicProvider = void 0;
+exports.getQuickContext = exports.createFastContext = exports.FastContext = exports.triggerN8NWebhook = exports.createN8NIntegration = exports.N8NIntegration = exports.externalAgentAsTool = exports.createExternalAgent = exports.getExternalAgentRegistry = exports.GenericExternalAgent = exports.AiderAgent = exports.CodexCliAgent = exports.GeminiCliAgent = exports.ClaudeCodeAgent = exports.BaseExternalAgent = exports.renderWorkflow = exports.createFlowDisplay = exports.FlowDisplay = exports.createFileCheckpointStorage = void 0;
 // ============================================================================
 // CORE API - The main classes users should use
 // ============================================================================
@@ -65,6 +65,7 @@ var agent_1 = require("./agent");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
 Object.defineProperty(exports, "Agents", { enumerable: true, get: function () { return agent_1.Agents; } });
 Object.defineProperty(exports, "PraisonAIAgents", { enumerable: true, get: function () { return agent_1.PraisonAIAgents; } });
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return agent_1.Router; } });
 // Workflow - Step-based workflow execution
 var workflows_1 = require("./workflows");
 Object.defineProperty(exports, "Workflow", { enumerable: true, get: function () { return workflows_1.Workflow; } });
@@ -162,13 +163,15 @@ Object.defineProperty(exports, "AutoMemory", { enumerable: true, get: function (
 Object.defineProperty(exports, "createAutoMemory", { enumerable: true, get: function () { return auto_memory_1.createAutoMemory; } });
 Object.defineProperty(exports, "createLLMSummarizer", { enumerable: true, get: function () { return auto_memory_1.createLLMSummarizer; } });
 Object.defineProperty(exports, "DEFAULT_POLICIES", { enumerable: true, get: function () { return auto_memory_1.DEFAULT_POLICIES; } });
-// Export Telemetry
+// Export Telemetry (Agent-focused)
 var telemetry_1 = require("./telemetry");
 Object.defineProperty(exports, "TelemetryCollector", { enumerable: true, get: function () { return telemetry_1.TelemetryCollector; } });
+Object.defineProperty(exports, "AgentTelemetry", { enumerable: true, get: function () { return telemetry_1.AgentTelemetry; } });
 Object.defineProperty(exports, "getTelemetry", { enumerable: true, get: function () { return telemetry_1.getTelemetry; } });
 Object.defineProperty(exports, "enableTelemetry", { enumerable: true, get: function () { return telemetry_1.enableTelemetry; } });
 Object.defineProperty(exports, "disableTelemetry", { enumerable: true, get: function () { return telemetry_1.disableTelemetry; } });
 Object.defineProperty(exports, "cleanupTelemetry", { enumerable: true, get: function () { return telemetry_1.cleanupTelemetry; } });
+Object.defineProperty(exports, "createAgentTelemetry", { enumerable: true, get: function () { return telemetry_1.createAgentTelemetry; } });
 // Export AutoAgents
 var auto_1 = require("./auto");
 Object.defineProperty(exports, "AutoAgents", { enumerable: true, get: function () { return auto_1.AutoAgents; } });
@@ -193,16 +196,20 @@ Object.defineProperty(exports, "createPromptExpanderAgent", { enumerable: true,
 var llm_guardrail_1 = require("./guardrails/llm-guardrail");
 Object.defineProperty(exports, "LLMGuardrail", { enumerable: true, get: function () { return llm_guardrail_1.LLMGuardrail; } });
 Object.defineProperty(exports, "createLLMGuardrail", { enumerable: true, get: function () { return llm_guardrail_1.createLLMGuardrail; } });
-// Export Planning
+// Export Planning (simplified API)
 var planning_1 = require("./planning");
 Object.defineProperty(exports, "Plan", { enumerable: true, get: function () { return planning_1.Plan; } });
 Object.defineProperty(exports, "PlanStep", { enumerable: true, get: function () { return planning_1.PlanStep; } });
 Object.defineProperty(exports, "TodoList", { enumerable: true, get: function () { return planning_1.TodoList; } });
 Object.defineProperty(exports, "TodoItem", { enumerable: true, get: function () { return planning_1.TodoItem; } });
 Object.defineProperty(exports, "PlanStorage", { enumerable: true, get: function () { return planning_1.PlanStorage; } });
+Object.defineProperty(exports, "PlanningAgent", { enumerable: true, get: function () { return planning_1.PlanningAgent; } });
+Object.defineProperty(exports, "TaskAgent", { enumerable: true, get: function () { return planning_1.TaskAgent; } });
 Object.defineProperty(exports, "createPlan", { enumerable: true, get: function () { return planning_1.createPlan; } });
 Object.defineProperty(exports, "createTodoList", { enumerable: true, get: function () { return planning_1.createTodoList; } });
 Object.defineProperty(exports, "createPlanStorage", { enumerable: true, get: function () { return planning_1.createPlanStorage; } });
+Object.defineProperty(exports, "createPlanningAgent", { enumerable: true, get: function () { return planning_1.createPlanningAgent; } });
+Object.defineProperty(exports, "createTaskAgent", { enumerable: true, get: function () { return planning_1.createTaskAgent; } });
 // Export Cache
 var cache_1 = require("./cache");
 Object.defineProperty(exports, "BaseCache", { enumerable: true, get: function () { return cache_1.BaseCache; } });

package/dist/llm/openai.d.ts

@@ -33,6 +33,7 @@ export declare class OpenAIService {
     generateText(prompt: string, systemPrompt?: string, temperature?: number, tools?: ChatCompletionTool[], tool_choice?: ChatCompletionToolChoiceOption): Promise<string>;
     generateChat(messages: ChatMessage[], temperature?: number, tools?: ChatCompletionTool[], tool_choice?: ChatCompletionToolChoiceOption): Promise<LLMResponse>;
     streamText(prompt: string, systemPrompt: string | undefined, temperature: number | undefined, onToken: (token: string) => void, tools?: ChatCompletionTool[], tool_choice?: ChatCompletionToolChoiceOption, onToolCall?: (toolCall: any) => void): Promise<void>;
+    streamChat(messages: ChatMessage[], temperature: number | undefined, onToken: (token: string) => void): Promise<string>;
     chatCompletion(messages: ChatMessage[], temperature?: number, tools?: ChatCompletionTool[], tool_choice?: ChatCompletionToolChoiceOption): Promise<LLMResponse>;
 }
 export {};

package/dist/llm/openai.js

@@ -230,6 +230,36 @@ class OpenAIService {
             throw error;
         }
     }
+    async streamChat(messages, temperature = 0.7, onToken) {
+        await logger_1.Logger.debug('Starting chat stream with messages...', {
+            model: this.model,
+            messageCount: messages.length
+        });
+        try {
+            const openAIMessages = messages.map(convertToOpenAIMessage);
+            const stream = await this.getClient().then(client => client.chat.completions.create({
+                model: this.model,
+                temperature,
+                messages: openAIMessages,
+                stream: true
+            }));
+            let fullResponse = '';
+            for await (const chunk of stream) {
+                const delta = chunk.choices[0]?.delta;
+                if (delta?.content) {
+                    const token = delta.content;
+                    fullResponse += token;
+                    onToken(token);
+                }
+            }
+            await logger_1.Logger.debug('Chat stream completed');
+            return fullResponse;
+        }
+        catch (error) {
+            await logger_1.Logger.error('Error in chat stream', error);
+            throw error;
+        }
+    }
     async chatCompletion(messages, temperature = 0.7, tools, tool_choice) {
         await logger_1.Logger.startSpinner('Chat completion with OpenAI...');
         try {

package/dist/planning/index.d.ts

@@ -131,3 +131,123 @@ export declare function createTodoList(name?: string): TodoList;
  * Create a PlanStorage
  */
 export declare function createPlanStorage(): PlanStorage;
+/**
+ * PlanningAgent - Agent with built-in planning capabilities
+ *
+ * @example Simple usage (4 lines)
+ * ```typescript
+ * import { PlanningAgent } from 'praisonai';
+ *
+ * const agent = new PlanningAgent({ instructions: 'You break down tasks into steps' });
+ * const result = await agent.planAndExecute('Build a web scraper');
+ * console.log(result.plan);  // The plan that was created
+ * console.log(result.results);  // Results from each step
+ * ```
+ */
+export interface PlanningAgentConfig {
+    instructions?: string;
+    name?: string;
+    llm?: string;
+    verbose?: boolean;
+    maxSteps?: number;
+}
+export interface PlanResult {
+    plan: Plan;
+    results: string[];
+    success: boolean;
+}
+export declare class PlanningAgent {
+    private config;
+    private agent;
+    private currentPlan;
+    constructor(config?: PlanningAgentConfig);
+    private getAgent;
+    /**
+     * Create a plan for a task
+     */
+    createPlan(task: string): Promise<Plan>;
+    /**
+     * Execute a single step
+     */
+    executeStep(step: PlanStep): Promise<string>;
+    /**
+     * Plan and execute a task in one call
+     */
+    planAndExecute(task: string): Promise<PlanResult>;
+    /**
+     * Get the current plan
+     */
+    getPlan(): Plan | null;
+    /**
+     * Simple chat (without planning)
+     */
+    chat(message: string): Promise<string>;
+}
+/**
+ * Create a planning agent
+ */
+export declare function createPlanningAgent(config?: PlanningAgentConfig): PlanningAgent;
+/**
+ * TaskAgent - Agent with built-in todo list management
+ *
+ * @example Simple usage (4 lines)
+ * ```typescript
+ * import { TaskAgent } from 'praisonai';
+ *
+ * const agent = new TaskAgent();
+ * await agent.addTask('Fix critical bug', 'high');
+ * await agent.addTask('Write docs', 'medium');
+ * console.log(agent.getPendingTasks());
+ * ```
+ */
+export declare class TaskAgent {
+    private todos;
+    private agent;
+    private config;
+    constructor(config?: {
+        name?: string;
+        llm?: string;
+        verbose?: boolean;
+    });
+    private getAgent;
+    /**
+     * Add a task
+     */
+    addTask(content: string, priority?: 'low' | 'medium' | 'high'): TodoItem;
+    /**
+     * Complete a task by content (partial match)
+     */
+    completeTask(contentMatch: string): boolean;
+    /**
+     * Get pending tasks
+     */
+    getPendingTasks(): TodoItem[];
+    /**
+     * Get all tasks
+     */
+    getAllTasks(): TodoItem[];
+    /**
+     * Get progress
+     */
+    getProgress(): {
+        completed: number;
+        total: number;
+        percentage: number;
+    };
+    /**
+     * Clear all tasks
+     */
+    clearTasks(): void;
+    /**
+     * Chat with AI about tasks
+     */
+    chat(message: string): Promise<string>;
+}
+/**
+ * Create a task agent
+ */
+export declare function createTaskAgent(config?: {
+    name?: string;
+    llm?: string;
+    verbose?: boolean;
+}): TaskAgent;

package/dist/planning/index.js

@@ -2,11 +2,46 @@
 /**
  * Planning System - Plans, Steps, and TodoLists
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlanStorage = exports.TodoList = exports.TodoItem = exports.Plan = exports.PlanStep = void 0;
+exports.TaskAgent = exports.PlanningAgent = exports.PlanStorage = exports.TodoList = exports.TodoItem = exports.Plan = exports.PlanStep = void 0;
 exports.createPlan = createPlan;
 exports.createTodoList = createTodoList;
 exports.createPlanStorage = createPlanStorage;
+exports.createPlanningAgent = createPlanningAgent;
+exports.createTaskAgent = createTaskAgent;
 /**
  * PlanStep - A single step in a plan
  */
@@ -226,3 +261,215 @@ function createTodoList(name) {
 function createPlanStorage() {
     return new PlanStorage();
 }
+// Import Agent dynamically to avoid circular dependency
+let AgentClass = null;
+async function getAgentClass() {
+    if (!AgentClass) {
+        const { Agent } = await Promise.resolve().then(() => __importStar(require('../agent/simple')));
+        AgentClass = Agent;
+    }
+    return AgentClass;
+}
+class PlanningAgent {
+    constructor(config = {}) {
+        this.agent = null;
+        this.currentPlan = null;
+        this.config = {
+            instructions: config.instructions || 'You are a planning agent that breaks down complex tasks into steps.',
+            name: config.name || 'PlanningAgent',
+            llm: config.llm,
+            verbose: config.verbose ?? true,
+            maxSteps: config.maxSteps ?? 10
+        };
+    }
+    async getAgent() {
+        if (!this.agent) {
+            const Agent = await getAgentClass();
+            this.agent = new Agent({
+                name: this.config.name,
+                instructions: this.config.instructions,
+                llm: this.config.llm,
+                verbose: this.config.verbose
+            });
+        }
+        return this.agent;
+    }
+    /**
+     * Create a plan for a task
+     */
+    async createPlan(task) {
+        const agent = await this.getAgent();
+        const planPrompt = `Create a step-by-step plan for: ${task}
+
+Return ONLY a numbered list of steps, one per line. Example:
+1. First step
+2. Second step
+3. Third step`;
+        const response = await agent.chat(planPrompt);
+        // Parse the response into steps
+        const plan = new Plan({ name: task });
+        const lines = response.split('\n').filter((l) => l.trim());
+        for (const line of lines) {
+            // Extract step description (remove numbering)
+            const match = line.match(/^\d+[\.\)]\s*(.+)/);
+            if (match) {
+                plan.addStep(new PlanStep({ description: match[1].trim() }));
+            }
+        }
+        this.currentPlan = plan;
+        return plan;
+    }
+    /**
+     * Execute a single step
+     */
+    async executeStep(step) {
+        const agent = await this.getAgent();
+        step.start();
+        try {
+            const response = await agent.chat(`Execute this step: ${step.description}`);
+            step.complete();
+            return response;
+        }
+        catch (error) {
+            step.fail();
+            throw error;
+        }
+    }
+    /**
+     * Plan and execute a task in one call
+     */
+    async planAndExecute(task) {
+        const plan = await this.createPlan(task);
+        const results = [];
+        let success = true;
+        plan.start();
+        for (const step of plan.steps.slice(0, this.config.maxSteps)) {
+            try {
+                if (this.config.verbose) {
+                    console.log(`[${plan.getProgress().percentage}%] Executing: ${step.description}`);
+                }
+                const result = await this.executeStep(step);
+                results.push(result);
+            }
+            catch (error) {
+                success = false;
+                results.push(`Error: ${error}`);
+                break;
+            }
+        }
+        if (success) {
+            plan.complete();
+        }
+        return { plan, results, success };
+    }
+    /**
+     * Get the current plan
+     */
+    getPlan() {
+        return this.currentPlan;
+    }
+    /**
+     * Simple chat (without planning)
+     */
+    async chat(message) {
+        const agent = await this.getAgent();
+        return agent.chat(message);
+    }
+}
+exports.PlanningAgent = PlanningAgent;
+/**
+ * Create a planning agent
+ */
+function createPlanningAgent(config) {
+    return new PlanningAgent(config);
+}
+/**
+ * TaskAgent - Agent with built-in todo list management
+ *
+ * @example Simple usage (4 lines)
+ * ```typescript
+ * import { TaskAgent } from 'praisonai';
+ *
+ * const agent = new TaskAgent();
+ * await agent.addTask('Fix critical bug', 'high');
+ * await agent.addTask('Write docs', 'medium');
+ * console.log(agent.getPendingTasks());
+ * ```
+ */
+class TaskAgent {
+    constructor(config) {
+        this.agent = null;
+        this.todos = new TodoList('Agent Tasks');
+        this.config = config || {};
+    }
+    async getAgent() {
+        if (!this.agent) {
+            const Agent = await getAgentClass();
+            this.agent = new Agent({
+                name: this.config.name || 'TaskAgent',
+                instructions: 'You are a task management assistant.',
+                llm: this.config.llm,
+                verbose: this.config.verbose ?? false
+            });
+        }
+        return this.agent;
+    }
+    /**
+     * Add a task
+     */
+    addTask(content, priority = 'medium') {
+        const item = new TodoItem({ content, priority });
+        this.todos.add(item);
+        return item;
+    }
+    /**
+     * Complete a task by content (partial match)
+     */
+    completeTask(contentMatch) {
+        const item = this.todos.items.find(t => t.content.toLowerCase().includes(contentMatch.toLowerCase()) && t.status !== 'completed');
+        if (item) {
+            item.complete();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get pending tasks
+     */
+    getPendingTasks() {
+        return this.todos.getPending();
+    }
+    /**
+     * Get all tasks
+     */
+    getAllTasks() {
+        return [...this.todos.items];
+    }
+    /**
+     * Get progress
+     */
+    getProgress() {
+        return this.todos.getProgress();
+    }
+    /**
+     * Clear all tasks
+     */
+    clearTasks() {
+        this.todos.clear();
+    }
+    /**
+     * Chat with AI about tasks
+     */
+    async chat(message) {
+        const agent = await this.getAgent();
+        const context = `Current tasks:\n${this.todos.items.map(t => `- [${t.status}] ${t.content} (${t.priority})`).join('\n') || 'No tasks'}`;
+        return agent.chat(`${context}\n\nUser: ${message}`);
+    }
+}
+exports.TaskAgent = TaskAgent;
+/**
+ * Create a task agent
+ */
+function createTaskAgent(config) {
+    return new TaskAgent(config);
+}

package/dist/telemetry/index.d.ts

@@ -100,3 +100,76 @@ export declare function disableTelemetry(): void;
  * Cleanup telemetry resources
  */
 export declare function cleanupTelemetry(): void;
+/**
+ * AgentTelemetry - Agent-focused telemetry wrapper
+ *
+ * @example Simple usage (3 lines)
+ * ```typescript
+ * import { Agent } from 'praisonai';
+ *
+ * // Enable telemetry on agent
+ * const agent = new Agent({
+ *   instructions: 'You are helpful',
+ *   telemetry: true  // Opt-in telemetry
+ * });
+ * await agent.chat('Hello!');  // Automatically tracked
+ * ```
+ *
+ * @example Manual tracking
+ * ```typescript
+ * import { AgentTelemetry } from 'praisonai';
+ *
+ * const telemetry = new AgentTelemetry('MyAgent');
+ * const result = await telemetry.trackChat(async () => {
+ *   return await agent.chat('Hello!');
+ * });
+ * console.log(telemetry.getStats());
+ * ```
+ */
+export interface AgentStats {
+    totalChats: number;
+    successfulChats: number;
+    failedChats: number;
+    totalDuration: number;
+    avgDuration: number;
+    totalTokens: number;
+    toolCalls: number;
+}
+export declare class AgentTelemetry {
+    private agentName;
+    private collector;
+    private stats;
+    constructor(agentName: string, config?: TelemetryConfig);
+    /**
+     * Track a chat execution
+     */
+    trackChat<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Track a tool call
+     */
+    trackToolCall(toolName: string, duration: number, success: boolean): void;
+    /**
+     * Track token usage
+     */
+    trackTokens(tokens: number): void;
+    /**
+     * Get agent statistics
+     */
+    getStats(): AgentStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Get success rate
+     */
+    getSuccessRate(): number;
+    /**
+     * Print summary
+     */
+    printSummary(): void;
+}
+/**
+ * Create agent telemetry
+ */
+export declare function createAgentTelemetry(agentName: string, config?: TelemetryConfig): AgentTelemetry;

package/dist/telemetry/index.js

@@ -3,11 +3,12 @@
  * Telemetry - Usage tracking and analytics
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TelemetryCollector = void 0;
+exports.AgentTelemetry = exports.TelemetryCollector = void 0;
 exports.getTelemetry = getTelemetry;
 exports.enableTelemetry = enableTelemetry;
 exports.disableTelemetry = disableTelemetry;
 exports.cleanupTelemetry = cleanupTelemetry;
+exports.createAgentTelemetry = createAgentTelemetry;
 /**
  * Telemetry collector for tracking usage
  */
@@ -185,3 +186,102 @@ function cleanupTelemetry() {
         globalTelemetry.cleanup();
     }
 }
+class AgentTelemetry {
+    constructor(agentName, config) {
+        this.stats = {
+            totalChats: 0,
+            successfulChats: 0,
+            failedChats: 0,
+            totalDuration: 0,
+            avgDuration: 0,
+            totalTokens: 0,
+            toolCalls: 0
+        };
+        this.agentName = agentName;
+        this.collector = config ? new TelemetryCollector(config) : getTelemetry();
+    }
+    /**
+     * Track a chat execution
+     */
+    async trackChat(fn) {
+        const startTime = Date.now();
+        this.stats.totalChats++;
+        try {
+            const result = await fn();
+            const duration = Date.now() - startTime;
+            this.stats.successfulChats++;
+            this.stats.totalDuration += duration;
+            this.stats.avgDuration = this.stats.totalDuration / this.stats.totalChats;
+            this.collector.trackAgentExecution(this.agentName, duration, true);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.stats.failedChats++;
+            this.stats.totalDuration += duration;
+            this.stats.avgDuration = this.stats.totalDuration / this.stats.totalChats;
+            this.collector.trackAgentExecution(this.agentName, duration, false);
+            this.collector.trackError(String(error), { agent: this.agentName });
+            throw error;
+        }
+    }
+    /**
+     * Track a tool call
+     */
+    trackToolCall(toolName, duration, success) {
+        this.stats.toolCalls++;
+        this.collector.trackToolCall(toolName, duration, success);
+    }
+    /**
+     * Track token usage
+     */
+    trackTokens(tokens) {
+        this.stats.totalTokens += tokens;
+    }
+    /**
+     * Get agent statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalChats: 0,
+            successfulChats: 0,
+            failedChats: 0,
+            totalDuration: 0,
+            avgDuration: 0,
+            totalTokens: 0,
+            toolCalls: 0
+        };
+    }
+    /**
+     * Get success rate
+     */
+    getSuccessRate() {
+        if (this.stats.totalChats === 0)
+            return 0;
+        return (this.stats.successfulChats / this.stats.totalChats) * 100;
+    }
+    /**
+     * Print summary
+     */
+    printSummary() {
+        console.log(`\n📊 Agent Telemetry: ${this.agentName}`);
+        console.log(`   Total chats: ${this.stats.totalChats}`);
+        console.log(`   Success rate: ${this.getSuccessRate().toFixed(1)}%`);
+        console.log(`   Avg duration: ${this.stats.avgDuration.toFixed(0)}ms`);
+        console.log(`   Tool calls: ${this.stats.toolCalls}`);
+        console.log(`   Total tokens: ${this.stats.totalTokens}`);
+    }
+}
+exports.AgentTelemetry = AgentTelemetry;
+/**
+ * Create agent telemetry
+ */
+function createAgentTelemetry(agentName, config) {
+    return new AgentTelemetry(agentName, config);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praisonai",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "PraisonAI TypeScript AI Agents Framework - Node.js, npm, and Javascript AI Agents Framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",