autonomous-agents 0.1.0 → 2.0.1

package/dist/team.js

@@ -0,0 +1,347 @@
+/**
+ * Team - Define and coordinate a team of agents and humans
+ *
+ * Teams enable collaboration and coordination between multiple agents
+ * and human workers working toward shared goals.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create a team
+ *
+ * @example
+ * ```ts
+ * import { Team, Agent, Role } from 'autonomous-agents'
+ *
+ * const productTeam = Team({
+ *   name: 'Product Development',
+ *   description: 'Cross-functional team building product features',
+ *   members: [
+ *     {
+ *       id: 'pm-1',
+ *       name: 'Sarah',
+ *       type: 'human',
+ *       role: Roles.ProductManager,
+ *       status: 'active',
+ *       availability: 'available',
+ *     },
+ *     {
+ *       id: 'dev-agent-1',
+ *       name: 'DevAgent',
+ *       type: 'agent',
+ *       role: Roles.SoftwareEngineer,
+ *       status: 'active',
+ *       availability: 'available',
+ *     },
+ *   ],
+ *   goals: [
+ *     {
+ *       id: 'q1-goal',
+ *       description: 'Launch new feature X',
+ *       target: '100%',
+ *       deadline: new Date('2024-03-31'),
+ *       priority: 'high',
+ *     },
+ *   ],
+ *   channels: [
+ *     { id: 'team-slack', type: 'slack', config: { channel: '#product-dev' } },
+ *   ],
+ * })
+ *
+ * // Add a new member
+ * team.addMember({
+ *   id: 'designer-1',
+ *   name: 'Alex',
+ *   type: 'human',
+ *   role: Roles.Designer,
+ * })
+ *
+ * // Broadcast to team
+ * await team.broadcast('Starting sprint planning!')
+ *
+ * // Get available members
+ * const available = team.getAvailableMembers()
+ * ```
+ */
+export function Team(config) {
+    const team = {
+        id: generateTeamId(config.name),
+        name: config.name,
+        description: config.description,
+        members: config.members || [],
+        goals: config.goals,
+        context: config.context,
+        channels: config.channels,
+    };
+    return {
+        ...team,
+        addMember,
+        removeMember,
+        getMember,
+        getMembers,
+        getAvailableMembers,
+        getMembersByRole,
+        getMembersByType,
+        updateMember,
+        addGoal,
+        updateGoal,
+        removeGoal,
+        getGoals,
+        addChannel,
+        removeChannel,
+        broadcast,
+        sendTo,
+        updateContext,
+        getContext,
+    };
+    /**
+     * Add a member to the team
+     */
+    function addMember(member) {
+        const existing = team.members.find(m => m.id === member.id);
+        if (existing) {
+            throw new Error(`Member with id ${member.id} already exists`);
+        }
+        team.members.push(member);
+    }
+    /**
+     * Remove a member from the team
+     */
+    function removeMember(memberId) {
+        const index = team.members.findIndex(m => m.id === memberId);
+        if (index === -1)
+            return false;
+        team.members.splice(index, 1);
+        return true;
+    }
+    /**
+     * Get a specific member
+     */
+    function getMember(memberId) {
+        return team.members.find(m => m.id === memberId);
+    }
+    /**
+     * Get all members
+     */
+    function getMembers() {
+        return [...team.members];
+    }
+    /**
+     * Get available members
+     */
+    function getAvailableMembers() {
+        return team.members.filter(m => m.status === 'active' && m.availability === 'available');
+    }
+    /**
+     * Get members by role
+     */
+    function getMembersByRole(roleId) {
+        return team.members.filter(m => m.role.id === roleId);
+    }
+    /**
+     * Get members by type
+     */
+    function getMembersByType(type) {
+        return team.members.filter(m => m.type === type);
+    }
+    /**
+     * Update a member
+     */
+    function updateMember(memberId, updates) {
+        const member = team.members.find(m => m.id === memberId);
+        if (!member) {
+            throw new Error(`Member with id ${memberId} not found`);
+        }
+        Object.assign(member, updates);
+    }
+    /**
+     * Add a goal
+     */
+    function addGoal(goal) {
+        if (!team.goals) {
+            team.goals = [];
+        }
+        team.goals.push(goal);
+    }
+    /**
+     * Update a goal
+     */
+    function updateGoal(goalId, updates) {
+        const goal = team.goals?.find(g => g.id === goalId);
+        if (!goal) {
+            throw new Error(`Goal with id ${goalId} not found`);
+        }
+        Object.assign(goal, updates);
+    }
+    /**
+     * Remove a goal
+     */
+    function removeGoal(goalId) {
+        if (!team.goals)
+            return false;
+        const index = team.goals.findIndex(g => g.id === goalId);
+        if (index === -1)
+            return false;
+        team.goals.splice(index, 1);
+        return true;
+    }
+    /**
+     * Get all goals
+     */
+    function getGoals() {
+        return team.goals ? [...team.goals] : [];
+    }
+    /**
+     * Add a communication channel
+     */
+    function addChannel(channel) {
+        if (!team.channels) {
+            team.channels = [];
+        }
+        team.channels.push(channel);
+    }
+    /**
+     * Remove a communication channel
+     */
+    function removeChannel(channelId) {
+        if (!team.channels)
+            return false;
+        const index = team.channels.findIndex(c => c.id === channelId);
+        if (index === -1)
+            return false;
+        team.channels.splice(index, 1);
+        return true;
+    }
+    /**
+     * Broadcast message to all team members
+     */
+    async function broadcast(message, channelType) {
+        const channels = channelType
+            ? team.channels?.filter(c => c.type === channelType)
+            : team.channels;
+        if (!channels || channels.length === 0) {
+            console.log(`[Team: ${team.name}] Broadcast: ${message}`);
+            return;
+        }
+        // In a real implementation, this would send via the specified channels
+        for (const channel of channels) {
+            console.log(`[Team: ${team.name}] [${channel.type}:${channel.id}] ${message}`);
+        }
+    }
+    /**
+     * Send message to specific team members
+     */
+    async function sendTo(memberIds, message, channelType) {
+        const members = team.members.filter(m => memberIds.includes(m.id));
+        if (members.length === 0) {
+            throw new Error('No valid members found');
+        }
+        // In a real implementation, this would send via appropriate channels
+        for (const member of members) {
+            console.log(`[Team: ${team.name}] To ${member.name}: ${message}`);
+        }
+    }
+    /**
+     * Update team context
+     */
+    function updateContext(key, value) {
+        if (!team.context) {
+            team.context = {};
+        }
+        team.context[key] = value;
+    }
+    /**
+     * Get team context
+     */
+    function getContext(key) {
+        if (!team.context)
+            return (key ? undefined : {});
+        if (key)
+            return team.context[key];
+        return { ...team.context };
+    }
+}
+/**
+ * Generate a team ID from name
+ */
+function generateTeamId(name) {
+    return `team-${name.toLowerCase().replace(/\s+/g, '-')}`;
+}
+/**
+ * Create a team member entry
+ */
+export function createTeamMember(config) {
+    return {
+        id: config.id,
+        name: config.name,
+        type: config.type,
+        role: config.role,
+        status: config.status || 'active',
+        availability: config.availability || 'available',
+    };
+}
+/**
+ * Create a team member from an agent
+ */
+export function teamMemberFromAgent(agent) {
+    return {
+        id: agent.config.name,
+        name: agent.config.name,
+        type: 'agent',
+        role: agent.config.role,
+        status: agent.status === 'idle' || agent.status === 'completed' ? 'active' : 'active',
+        availability: agent.status === 'idle' ? 'available' : 'busy',
+    };
+}
+/**
+ * Calculate team capacity based on available members
+ */
+export function calculateTeamCapacity(team) {
+    const members = team.getMembers();
+    const available = members.filter(m => m.availability === 'available').length;
+    const busy = members.filter(m => m.availability === 'busy').length;
+    const offline = members.filter(m => m.availability === 'offline').length;
+    return {
+        total: members.length,
+        available,
+        busy,
+        offline,
+    };
+}
+/**
+ * Get team skills - aggregated from all members
+ */
+export function getTeamSkills(team) {
+    const skills = new Set();
+    team.getMembers().forEach(member => {
+        member.role.skills.forEach(skill => skills.add(skill));
+    });
+    return Array.from(skills);
+}
+/**
+ * Check if team has a specific skill
+ */
+export function teamHasSkill(team, skill) {
+    return team.getMembers().some(member => member.role.skills.some(s => s.toLowerCase() === skill.toLowerCase() ||
+        s.toLowerCase().includes(skill.toLowerCase())));
+}
+/**
+ * Find best member for a task based on role skills
+ */
+export function findBestMemberForTask(team, requiredSkills) {
+    const availableMembers = team.getAvailableMembers();
+    if (availableMembers.length === 0)
+        return null;
+    // Score each member based on skill matches
+    const scored = availableMembers.map(member => {
+        const matchingSkills = requiredSkills.filter(skill => member.role.skills.some(s => s.toLowerCase().includes(skill.toLowerCase())));
+        return {
+            member,
+            score: matchingSkills.length,
+        };
+    });
+    // Sort by score descending
+    scored.sort((a, b) => b.score - a.score);
+    return scored.length > 0 && scored[0].score > 0 ? scored[0].member : null;
+}
+//# sourceMappingURL=team.js.map

package/dist/team.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,327 @@
+/**
+ * Types for autonomous-agents
+ *
+ * Primitives for building and orchestrating autonomous AI agents that operate
+ * within a company boundary using the digital-workers interface.
+ */
+import type { AIFunctionDefinition, AIGenerateOptions, SimpleSchema } from 'ai-functions';
+export type { AIFunctionDefinition };
+/**
+ * Agent execution mode determines how the agent processes tasks
+ */
+export type AgentMode = 'autonomous' | 'supervised' | 'manual';
+/**
+ * Agent status during execution
+ */
+export type AgentStatus = 'idle' | 'thinking' | 'acting' | 'waiting' | 'completed' | 'error';
+/**
+ * Priority levels for tasks and decisions
+ */
+export type Priority = 'low' | 'medium' | 'high' | 'urgent';
+/**
+ * Decision approval status
+ */
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'expired';
+/**
+ * Role definition for an agent or human worker
+ */
+export interface Role {
+    /** Unique role identifier */
+    id: string;
+    /** Role name (e.g., "Product Manager", "Software Engineer") */
+    name: string;
+    /** Role description and responsibilities */
+    description: string;
+    /** Skills and capabilities required for this role */
+    skills: string[];
+    /** Permissions and access levels */
+    permissions?: string[];
+    /** Tools available to this role */
+    tools?: AIFunctionDefinition[];
+    /** Expected outputs from this role */
+    outputs?: string[];
+}
+/**
+ * Team composition and coordination
+ */
+export interface Team {
+    /** Unique team identifier */
+    id: string;
+    /** Team name */
+    name: string;
+    /** Team description and purpose */
+    description?: string;
+    /** Team members (agents and humans) */
+    members: TeamMember[];
+    /** Team goals */
+    goals?: Goal[];
+    /** Shared context for the team */
+    context?: Record<string, unknown>;
+    /** Communication channels */
+    channels?: CommunicationChannel[];
+}
+/**
+ * Team member representation
+ */
+export interface TeamMember {
+    /** Member ID (agent or human) */
+    id: string;
+    /** Member name */
+    name: string;
+    /** Member role on the team */
+    role: Role;
+    /** Member type */
+    type: 'agent' | 'human';
+    /** Member status */
+    status?: 'active' | 'inactive' | 'away';
+    /** Member availability */
+    availability?: 'available' | 'busy' | 'offline';
+}
+/**
+ * Communication channel for team collaboration
+ */
+export interface CommunicationChannel {
+    /** Channel identifier */
+    id: string;
+    /** Channel type */
+    type: 'slack' | 'email' | 'web' | 'sms' | 'custom';
+    /** Channel configuration */
+    config: Record<string, unknown>;
+}
+/**
+ * Goal definition with measurable outcomes
+ */
+export interface Goal {
+    /** Unique goal identifier */
+    id: string;
+    /** Goal description */
+    description: string;
+    /** Target outcome or metric */
+    target: string | number;
+    /** Current progress */
+    progress?: string | number;
+    /** Goal deadline */
+    deadline?: Date;
+    /** Goal priority */
+    priority?: Priority;
+    /** Goal status */
+    status?: 'active' | 'completed' | 'blocked' | 'cancelled';
+    /** Sub-goals */
+    subgoals?: Goal[];
+    /** Success criteria */
+    successCriteria?: string[];
+}
+/**
+ * Agent configuration and behavior
+ */
+export interface AgentConfig {
+    /** Agent name */
+    name: string;
+    /** Agent description and purpose */
+    description?: string;
+    /** Agent role */
+    role: Role;
+    /** Agent execution mode */
+    mode?: AgentMode;
+    /** Agent goals */
+    goals?: Goal[];
+    /** Agent tools (functions) */
+    tools?: AIFunctionDefinition[];
+    /** Agent memory/context */
+    context?: Record<string, unknown>;
+    /** Model to use for agent reasoning */
+    model?: string;
+    /** System prompt for the agent */
+    system?: string;
+    /** Maximum iterations per task */
+    maxIterations?: number;
+    /** Temperature for AI generation */
+    temperature?: number;
+    /** Team the agent belongs to */
+    team?: Team;
+    /** Approval requirements */
+    requiresApproval?: boolean;
+    /** Human supervisor (for supervised mode) */
+    supervisor?: string;
+}
+/**
+ * Agent instance with methods and state
+ */
+export interface Agent {
+    /** Agent configuration */
+    config: AgentConfig;
+    /** Agent current status */
+    status: AgentStatus;
+    /** Agent state/memory */
+    state: Record<string, unknown>;
+    /** Execute a task */
+    do: <TResult = unknown>(task: string, context?: unknown) => Promise<TResult>;
+    /** Ask a question */
+    ask: <TResult = unknown>(question: string, context?: unknown) => Promise<TResult>;
+    /** Make a decision */
+    decide: <T extends string>(options: T[], context?: string) => Promise<T>;
+    /** Request approval */
+    approve: <TResult = unknown>(request: ApprovalRequest) => Promise<ApprovalResult<TResult>>;
+    /** Generate content */
+    generate: (options: AIGenerateOptions) => Promise<unknown>;
+    /** Type checking/validation */
+    is: (value: unknown, type: string | SimpleSchema) => Promise<boolean>;
+    /** Send notification */
+    notify: (message: string, channel?: string) => Promise<void>;
+    /** Update agent state */
+    setState: (key: string, value: unknown) => void;
+    /** Get agent state */
+    getState: <T = unknown>(key: string) => T | undefined;
+    /** Get agent history */
+    getHistory: () => AgentHistoryEntry[];
+    /** Reset agent state */
+    reset: () => void;
+}
+/**
+ * Approval request structure
+ */
+export interface ApprovalRequest {
+    /** Request title/summary */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Data to be approved */
+    data: unknown;
+    /** Priority level */
+    priority?: Priority;
+    /** Approver (user ID, email, or role) */
+    approver?: string;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Channel for approval request */
+    channel?: 'slack' | 'email' | 'web' | 'sms' | 'custom';
+    /** Expected response schema */
+    responseSchema?: SimpleSchema;
+}
+/**
+ * Approval result
+ */
+export interface ApprovalResult<T = unknown> {
+    /** Approval status */
+    status: ApprovalStatus;
+    /** Response data */
+    response?: T;
+    /** Who approved/rejected */
+    approver?: string;
+    /** When the decision was made */
+    timestamp?: Date;
+    /** Optional notes */
+    notes?: string;
+}
+/**
+ * Agent history entry
+ */
+export interface AgentHistoryEntry {
+    /** Timestamp */
+    timestamp: Date;
+    /** Action type */
+    type: 'task' | 'question' | 'decision' | 'approval' | 'notification' | 'error';
+    /** Action description */
+    action: string;
+    /** Input data */
+    input?: unknown;
+    /** Output result */
+    output?: unknown;
+    /** Error if any */
+    error?: string;
+    /** Duration in milliseconds */
+    duration?: number;
+}
+/**
+ * Key Performance Indicator
+ */
+export interface KPI {
+    /** KPI identifier */
+    id: string;
+    /** KPI name */
+    name: string;
+    /** KPI description */
+    description?: string;
+    /** Current value */
+    value: number | string;
+    /** Target value */
+    target?: number | string;
+    /** Unit of measurement */
+    unit?: string;
+    /** Measurement frequency */
+    frequency?: 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+    /** Trend direction */
+    trend?: 'up' | 'down' | 'stable';
+    /** Historical data */
+    history?: Array<{
+        timestamp: Date;
+        value: number | string;
+    }>;
+}
+/**
+ * Objectives and Key Results
+ */
+export interface OKR {
+    /** OKR identifier */
+    id: string;
+    /** Objective statement */
+    objective: string;
+    /** Objective description */
+    description?: string;
+    /** Key results */
+    keyResults: KeyResult[];
+    /** Time period */
+    period?: string;
+    /** Owner (agent, team, or person) */
+    owner?: string;
+    /** Status */
+    status?: 'active' | 'completed' | 'at-risk' | 'cancelled';
+    /** Overall progress (0-100) */
+    progress?: number;
+}
+/**
+ * Key Result within an OKR
+ */
+export interface KeyResult {
+    /** Key result identifier */
+    id: string;
+    /** Key result description */
+    description: string;
+    /** Current value */
+    current: number | string;
+    /** Target value */
+    target: number | string;
+    /** Unit of measurement */
+    unit?: string;
+    /** Progress (0-100) */
+    progress?: number;
+    /** Status */
+    status?: 'on-track' | 'at-risk' | 'off-track' | 'completed';
+}
+/**
+ * Goals configuration
+ */
+export interface GoalsConfig {
+    /** Goals list */
+    goals: Goal[];
+    /** Strategy or context */
+    strategy?: string;
+    /** Time horizon */
+    timeHorizon?: string;
+}
+/**
+ * Notification options
+ */
+export interface NotificationOptions {
+    /** Message to send */
+    message: string;
+    /** Notification channel */
+    channel?: 'slack' | 'email' | 'web' | 'sms' | 'custom';
+    /** Recipients */
+    recipients?: string[];
+    /** Priority */
+    priority?: Priority;
+    /** Additional data */
+    data?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map