autonomous-agents 0.1.0 → 2.0.1

package/dist/agent.js

@@ -0,0 +1,452 @@
+/**
+ * Agent - Create an autonomous agent
+ *
+ * Agents are autonomous AI workers that can execute tasks, make decisions,
+ * and collaborate with other agents and humans.
+ *
+ * @packageDocumentation
+ */
+import { generateObject } from 'ai-functions';
+import { executeApproval } from './actions.js';
+/**
+ * Create an autonomous agent
+ *
+ * @example
+ * ```ts
+ * import { Agent, Role } from 'autonomous-agents'
+ *
+ * const agent = Agent({
+ *   name: 'ProductAgent',
+ *   role: Role({
+ *     name: 'Product Manager',
+ *     description: 'Manages product strategy and roadmap',
+ *     skills: ['product strategy', 'user research', 'roadmap planning'],
+ *   }),
+ *   mode: 'autonomous',
+ *   goals: [
+ *     { id: 'g1', description: 'Define Q1 product roadmap', target: '100%' }
+ *   ],
+ * })
+ *
+ * // Execute a task
+ * const result = await agent.do('Create a product brief for new feature X')
+ *
+ * // Ask a question
+ * const answer = await agent.ask('What are the top 3 customer pain points?')
+ *
+ * // Make a decision
+ * const decision = await agent.decide(['feature A', 'feature B', 'feature C'], 'Which should we prioritize?')
+ *
+ * // Request approval
+ * const approval = await agent.approve({
+ *   title: 'Budget Request',
+ *   description: 'Request $50k budget for user research',
+ *   data: { amount: 50000, purpose: 'User research study' },
+ *   approver: 'manager@company.com',
+ * })
+ * ```
+ */
+export function Agent(config) {
+    // Initialize agent state
+    const state = config.context || {};
+    let status = 'idle';
+    const history = [];
+    // Default model and parameters
+    const model = config.model || 'sonnet';
+    const temperature = config.temperature ?? 0.7;
+    const maxIterations = config.maxIterations || 10;
+    /**
+     * Record action in history
+     */
+    function recordHistory(entry) {
+        history.push({
+            ...entry,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Execute a task
+     */
+    async function doTask(task, context) {
+        const startTime = Date.now();
+        status = 'thinking';
+        try {
+            // Build system prompt with role and goals
+            const systemPrompt = buildSystemPrompt(config);
+            // For autonomous mode, use agentic loop
+            if (config.mode === 'autonomous') {
+                const result = await executeAgenticTask(task, context, systemPrompt, config.tools || [], maxIterations);
+                recordHistory({
+                    type: 'task',
+                    action: task,
+                    input: context,
+                    output: result,
+                    duration: Date.now() - startTime,
+                });
+                status = 'completed';
+                return result;
+            }
+            // For supervised/manual mode, generate response with optional approval
+            const result = await generateObject({
+                model,
+                schema: {
+                    result: 'The result of the task',
+                    reasoning: 'Step-by-step reasoning',
+                    needsApproval: 'Whether this needs approval (boolean)',
+                },
+                system: systemPrompt,
+                prompt: `Task: ${task}\n\nContext: ${JSON.stringify(context || {})}`,
+                temperature,
+            });
+            const response = result.object;
+            // Request approval if needed and agent requires approval
+            if (config.requiresApproval || response.needsApproval) {
+                const approval = await executeApproval({
+                    title: `Task: ${task}`,
+                    description: response.reasoning,
+                    data: response.result,
+                    approver: config.supervisor,
+                    channel: 'web',
+                });
+                if (approval.status !== 'approved') {
+                    throw new Error(`Task approval ${approval.status}: ${approval.notes || ''}`);
+                }
+            }
+            recordHistory({
+                type: 'task',
+                action: task,
+                input: context,
+                output: response.result,
+                duration: Date.now() - startTime,
+            });
+            status = 'completed';
+            return response.result;
+        }
+        catch (error) {
+            status = 'error';
+            recordHistory({
+                type: 'error',
+                action: task,
+                input: context,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+            });
+            throw error;
+        }
+        finally {
+            if (status !== 'error') {
+                status = 'idle';
+            }
+        }
+    }
+    /**
+     * Ask a question
+     */
+    async function ask(question, context) {
+        const startTime = Date.now();
+        status = 'thinking';
+        try {
+            const systemPrompt = buildSystemPrompt(config);
+            const result = await generateObject({
+                model,
+                schema: {
+                    answer: 'The answer to the question',
+                    reasoning: 'Supporting reasoning and evidence',
+                },
+                system: systemPrompt,
+                prompt: `Question: ${question}\n\nContext: ${JSON.stringify(context || {})}`,
+                temperature,
+            });
+            const response = result.object;
+            recordHistory({
+                type: 'question',
+                action: question,
+                input: context,
+                output: response.answer,
+                duration: Date.now() - startTime,
+            });
+            status = 'idle';
+            return response.answer;
+        }
+        catch (error) {
+            status = 'error';
+            recordHistory({
+                type: 'error',
+                action: question,
+                input: context,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Make a decision
+     */
+    async function decide(options, context) {
+        const startTime = Date.now();
+        status = 'thinking';
+        try {
+            const systemPrompt = buildSystemPrompt(config);
+            const result = await generateObject({
+                model,
+                schema: {
+                    decision: options.join(' | '),
+                    reasoning: 'Reasoning for this decision',
+                    confidence: 'Confidence level 0-100 (number)',
+                },
+                system: systemPrompt,
+                prompt: `Make a decision between these options:\n${options.map((o, i) => `${i + 1}. ${o}`).join('\n')}\n\nContext: ${context || 'No additional context'}`,
+                temperature,
+            });
+            const response = result.object;
+            recordHistory({
+                type: 'decision',
+                action: `Choose from: ${options.join(', ')}`,
+                input: context,
+                output: response,
+                duration: Date.now() - startTime,
+            });
+            status = 'idle';
+            return response.decision;
+        }
+        catch (error) {
+            status = 'error';
+            recordHistory({
+                type: 'error',
+                action: 'decision',
+                input: { options, context },
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Request approval
+     */
+    async function approve(request) {
+        const startTime = Date.now();
+        status = 'waiting';
+        try {
+            const result = await executeApproval(request);
+            recordHistory({
+                type: 'approval',
+                action: request.title,
+                input: request,
+                output: result,
+                duration: Date.now() - startTime,
+            });
+            status = 'idle';
+            return result;
+        }
+        catch (error) {
+            status = 'error';
+            recordHistory({
+                type: 'error',
+                action: request.title,
+                input: request,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Generate content
+     */
+    async function generate(options) {
+        const startTime = Date.now();
+        status = 'acting';
+        try {
+            const systemPrompt = buildSystemPrompt(config);
+            const result = await generateObject({
+                model: options.model || model,
+                schema: options.schema || { result: 'Generated content' },
+                system: options.system || systemPrompt,
+                prompt: options.prompt || '',
+                temperature: options.temperature ?? temperature,
+            });
+            recordHistory({
+                type: 'task',
+                action: 'generate',
+                input: options,
+                output: result.object,
+                duration: Date.now() - startTime,
+            });
+            status = 'idle';
+            return result.object;
+        }
+        catch (error) {
+            status = 'error';
+            recordHistory({
+                type: 'error',
+                action: 'generate',
+                input: options,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Type checking/validation
+     */
+    async function is(value, type) {
+        try {
+            const schema = typeof type === 'string'
+                ? { isValid: `Is this value a valid ${type}? (boolean)` }
+                : { isValid: 'Does this value match the schema? (boolean)' };
+            const result = await generateObject({
+                model,
+                schema,
+                system: 'You are a type validator. Determine if the value matches the expected type.',
+                prompt: `Value: ${JSON.stringify(value)}\n\nExpected type: ${typeof type === 'string' ? type : JSON.stringify(type)}`,
+                temperature: 0,
+            });
+            return result.object.isValid;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Send notification
+     */
+    async function notify(message, channel) {
+        const startTime = Date.now();
+        try {
+            // In a real implementation, this would send via the specified channel
+            recordHistory({
+                type: 'notification',
+                action: 'notify',
+                input: { message, channel },
+                duration: Date.now() - startTime,
+            });
+            // For now, just log
+            console.log(`[${config.name}] ${message}`);
+        }
+        catch (error) {
+            recordHistory({
+                type: 'error',
+                action: 'notify',
+                input: { message, channel },
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Update agent state
+     */
+    function setState(key, value) {
+        state[key] = value;
+    }
+    /**
+     * Get agent state
+     */
+    function getState(key) {
+        return state[key];
+    }
+    /**
+     * Get agent history
+     */
+    function getHistory() {
+        return [...history];
+    }
+    /**
+     * Reset agent state
+     */
+    function reset() {
+        Object.keys(state).forEach(key => delete state[key]);
+        history.length = 0;
+        status = 'idle';
+    }
+    return {
+        config,
+        status,
+        state,
+        do: doTask,
+        ask,
+        decide,
+        approve,
+        generate,
+        is,
+        notify,
+        setState,
+        getState,
+        getHistory,
+        reset,
+    };
+}
+/**
+ * Build system prompt from agent configuration
+ */
+function buildSystemPrompt(config) {
+    const parts = [];
+    parts.push(`You are ${config.name}, an autonomous AI agent.`);
+    if (config.description) {
+        parts.push(config.description);
+    }
+    if (config.role) {
+        parts.push(`\nRole: ${config.role.name}`);
+        parts.push(config.role.description);
+        if (config.role.skills.length > 0) {
+            parts.push(`\nSkills: ${config.role.skills.join(', ')}`);
+        }
+    }
+    if (config.goals && config.goals.length > 0) {
+        parts.push('\nGoals:');
+        config.goals.forEach((goal, i) => {
+            parts.push(`${i + 1}. ${goal.description}`);
+        });
+    }
+    if (config.system) {
+        parts.push(`\n${config.system}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Execute an agentic task with tool use
+ */
+async function executeAgenticTask(task, context, systemPrompt, tools, maxIterations) {
+    let iteration = 0;
+    const toolResults = [];
+    while (iteration < maxIterations) {
+        iteration++;
+        const result = await generateObject({
+            model: 'sonnet',
+            schema: {
+                thinking: 'Your step-by-step reasoning',
+                action: {
+                    type: 'tool | done',
+                    toolName: 'Name of tool to use (if action is tool)',
+                    arguments: 'Arguments for the tool as JSON string',
+                },
+                result: 'The final result if done',
+            },
+            system: systemPrompt,
+            prompt: `Task: ${task}\n\nContext: ${JSON.stringify(context)}\n\nPrevious actions:\n${toolResults.map((r, i) => `${i + 1}. ${JSON.stringify(r)}`).join('\n') || 'None yet'}\n\nWhat should you do next?`,
+        });
+        const response = result.object;
+        // Check if done
+        if (response.action.type === 'done' || response.result) {
+            return response.result;
+        }
+        // Execute tool
+        if (response.action.type === 'tool' && response.action.toolName) {
+            const tool = tools.find(t => t.name === response.action.toolName);
+            if (tool) {
+                const args = JSON.parse(response.action.arguments || '{}');
+                const toolResult = await tool.handler(args);
+                toolResults.push({ tool: response.action.toolName, result: toolResult });
+            }
+            else {
+                toolResults.push({ error: `Tool not found: ${response.action.toolName}` });
+            }
+        }
+    }
+    throw new Error(`Agent exceeded maximum iterations (${maxIterations})`);
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/goals.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Goals - Define and track goals for agents and teams
+ *
+ * Goals provide direction and measurable outcomes for autonomous agents
+ * and teams to work towards.
+ *
+ * @packageDocumentation
+ */
+import type { Goal, GoalsConfig, Priority } from './types.js';
+/**
+ * Create a goals configuration
+ *
+ * @example
+ * ```ts
+ * import { Goals } from 'autonomous-agents'
+ *
+ * const goals = Goals({
+ *   goals: [
+ *     {
+ *       id: 'revenue-q1',
+ *       description: 'Increase Q1 revenue by 20%',
+ *       target: 120000,
+ *       progress: 45000,
+ *       priority: 'high',
+ *       deadline: new Date('2024-03-31'),
+ *       status: 'active',
+ *     },
+ *     {
+ *       id: 'feature-launch',
+ *       description: 'Launch new AI features',
+ *       target: '100%',
+ *       progress: '60%',
+ *       priority: 'high',
+ *       deadline: new Date('2024-02-15'),
+ *       status: 'active',
+ *       subgoals: [
+ *         {
+ *           id: 'feature-design',
+ *           description: 'Complete feature designs',
+ *           target: '100%',
+ *           progress: '100%',
+ *           status: 'completed',
+ *         },
+ *         {
+ *           id: 'feature-dev',
+ *           description: 'Implement features',
+ *           target: '100%',
+ *           progress: '80%',
+ *           status: 'active',
+ *         },
+ *       ],
+ *     },
+ *   ],
+ *   strategy: 'Focus on high-impact features that drive revenue growth',
+ *   timeHorizon: 'Q1 2024',
+ * })
+ * ```
+ */
+export declare function Goals(config: GoalsConfig): GoalsInstance;
+/**
+ * Goals instance with methods
+ */
+export interface GoalsInstance extends GoalsConfig {
+    /** Add a new goal */
+    addGoal(goal: Goal): void;
+    /** Remove a goal */
+    removeGoal(goalId: string): boolean;
+    /** Get a specific goal */
+    getGoal(goalId: string): Goal | undefined;
+    /** Get all goals */
+    getGoals(): Goal[];
+    /** Get active goals */
+    getActiveGoals(): Goal[];
+    /** Get completed goals */
+    getCompletedGoals(): Goal[];
+    /** Get blocked goals */
+    getBlockedGoals(): Goal[];
+    /** Get goals by priority */
+    getGoalsByPriority(priority: Priority): Goal[];
+    /** Update a goal */
+    updateGoal(goalId: string, updates: Partial<Omit<Goal, 'id'>>): void;
+    /** Update goal progress */
+    updateProgress(goalId: string, progress: string | number): void;
+    /** Mark goal as completed */
+    markCompleted(goalId: string): void;
+    /** Mark goal as blocked */
+    markBlocked(goalId: string, reason?: string): void;
+    /** Get progress for a specific goal */
+    getProgress(goalId: string): number;
+    /** Get overall progress across all goals */
+    getOverallProgress(): number;
+}
+/**
+ * Create a simple goal
+ */
+export declare function createGoal(config: {
+    id: string;
+    description: string;
+    target: string | number;
+    priority?: Priority;
+    deadline?: Date;
+}): Goal;
+/**
+ * Create a goal with subgoals
+ */
+export declare function createGoalWithSubgoals(config: {
+    id: string;
+    description: string;
+    target: string | number;
+    subgoals: Goal[];
+    priority?: Priority;
+    deadline?: Date;
+}): Goal;
+/**
+ * Check if a goal is overdue
+ */
+export declare function isGoalOverdue(goal: Goal): boolean;
+/**
+ * Get goals that are overdue
+ */
+export declare function getOverdueGoals(goals: Goal[]): Goal[];
+/**
+ * Get goals due soon (within specified days)
+ */
+export declare function getGoalsDueSoon(goals: Goal[], days?: number): Goal[];
+/**
+ * Get goals by status
+ */
+export declare function getGoalsByStatus(goals: Goal[], status: 'active' | 'completed' | 'blocked' | 'cancelled'): Goal[];
+/**
+ * Calculate time remaining until deadline
+ */
+export declare function getTimeRemaining(goal: Goal): {
+    days: number;
+    hours: number;
+    minutes: number;
+} | null;
+//# sourceMappingURL=goals.d.ts.map

package/dist/goals.d.ts.map

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