autonomous-agents 0.1.0 → 2.0.1

package/dist/role.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Role - Define an agent or worker role
+ *
+ * Roles define the responsibilities, skills, permissions, and capabilities
+ * for agents or human workers within a digital workforce.
+ *
+ * @packageDocumentation
+ */
+import type { Role as RoleType, AIFunctionDefinition } from './types.js';
+/**
+ * Create a role definition
+ *
+ * @example
+ * ```ts
+ * import { Role } from 'autonomous-agents'
+ *
+ * const productManager = Role({
+ *   name: 'Product Manager',
+ *   description: 'Responsible for product strategy, roadmap, and feature prioritization',
+ *   skills: [
+ *     'product strategy',
+ *     'user research',
+ *     'roadmap planning',
+ *     'stakeholder management',
+ *     'data analysis',
+ *   ],
+ *   permissions: ['create:feature', 'update:roadmap', 'approve:requirements'],
+ *   outputs: ['product briefs', 'roadmaps', 'user stories', 'requirements'],
+ * })
+ *
+ * const engineer = Role({
+ *   name: 'Software Engineer',
+ *   description: 'Designs, develops, and maintains software systems',
+ *   skills: [
+ *     'software design',
+ *     'coding',
+ *     'testing',
+ *     'debugging',
+ *     'code review',
+ *   ],
+ *   permissions: ['read:code', 'write:code', 'deploy:staging'],
+ *   tools: [
+ *     { name: 'runTests', description: 'Run test suite', parameters: {}, handler: async () => {} },
+ *     { name: 'deploy', description: 'Deploy to environment', parameters: {}, handler: async () => {} },
+ *   ],
+ * })
+ * ```
+ */
+export declare function Role(config: {
+    name: string;
+    description: string;
+    skills: string[];
+    permissions?: string[];
+    tools?: AIFunctionDefinition[];
+    outputs?: string[];
+}): RoleType;
+/**
+ * Predefined common roles
+ */
+export declare const Roles: {
+    /**
+     * Product Manager role
+     */
+    ProductManager: RoleType;
+    /**
+     * Software Engineer role
+     */
+    SoftwareEngineer: RoleType;
+    /**
+     * Designer role
+     */
+    Designer: RoleType;
+    /**
+     * Data Analyst role
+     */
+    DataAnalyst: RoleType;
+    /**
+     * Content Writer role
+     */
+    ContentWriter: RoleType;
+    /**
+     * Customer Support role
+     */
+    CustomerSupport: RoleType;
+    /**
+     * Project Manager role
+     */
+    ProjectManager: RoleType;
+    /**
+     * QA Engineer role
+     */
+    QAEngineer: RoleType;
+    /**
+     * Marketing Manager role
+     */
+    MarketingManager: RoleType;
+    /**
+     * DevOps Engineer role
+     */
+    DevOpsEngineer: RoleType;
+};
+/**
+ * Check if a role has a specific permission
+ */
+export declare function hasPermission(role: RoleType, permission: string): boolean;
+/**
+ * Check if a role has a specific skill
+ */
+export declare function hasSkill(role: RoleType, skill: string): boolean;
+/**
+ * Get all permissions for a role
+ */
+export declare function getPermissions(role: RoleType): string[];
+/**
+ * Get all skills for a role
+ */
+export declare function getSkills(role: RoleType): string[];
+/**
+ * Merge multiple roles into a compound role
+ */
+export declare function mergeRoles(name: string, ...roles: RoleType[]): RoleType;
+//# sourceMappingURL=role.d.ts.map

package/dist/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../src/role.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB,GAAG,QAAQ,CAaX;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;OAEG;;IA4BH;;OAEG;;IA4BH;;OAEG;;IA2BH;;OAEG;;IA0BH;;OAEG;;IA0BH;;OAEG;;IAyBH;;OAEG;;IA2BH;;OAEG;;IA0BH;;OAEG;;IA2BH;;OAEG;;CA0BJ,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAEvD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAuBvE"}

package/dist/role.js

@@ -0,0 +1,393 @@
+/**
+ * Role - Define an agent or worker role
+ *
+ * Roles define the responsibilities, skills, permissions, and capabilities
+ * for agents or human workers within a digital workforce.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create a role definition
+ *
+ * @example
+ * ```ts
+ * import { Role } from 'autonomous-agents'
+ *
+ * const productManager = Role({
+ *   name: 'Product Manager',
+ *   description: 'Responsible for product strategy, roadmap, and feature prioritization',
+ *   skills: [
+ *     'product strategy',
+ *     'user research',
+ *     'roadmap planning',
+ *     'stakeholder management',
+ *     'data analysis',
+ *   ],
+ *   permissions: ['create:feature', 'update:roadmap', 'approve:requirements'],
+ *   outputs: ['product briefs', 'roadmaps', 'user stories', 'requirements'],
+ * })
+ *
+ * const engineer = Role({
+ *   name: 'Software Engineer',
+ *   description: 'Designs, develops, and maintains software systems',
+ *   skills: [
+ *     'software design',
+ *     'coding',
+ *     'testing',
+ *     'debugging',
+ *     'code review',
+ *   ],
+ *   permissions: ['read:code', 'write:code', 'deploy:staging'],
+ *   tools: [
+ *     { name: 'runTests', description: 'Run test suite', parameters: {}, handler: async () => {} },
+ *     { name: 'deploy', description: 'Deploy to environment', parameters: {}, handler: async () => {} },
+ *   ],
+ * })
+ * ```
+ */
+export function Role(config) {
+    // Generate a unique ID based on the role name
+    const id = config.name.toLowerCase().replace(/\s+/g, '-');
+    return {
+        id,
+        name: config.name,
+        description: config.description,
+        skills: config.skills,
+        permissions: config.permissions,
+        tools: config.tools,
+        outputs: config.outputs,
+    };
+}
+/**
+ * Predefined common roles
+ */
+export const Roles = {
+    /**
+     * Product Manager role
+     */
+    ProductManager: Role({
+        name: 'Product Manager',
+        description: 'Owns product vision, strategy, and roadmap. Prioritizes features based on user needs and business goals.',
+        skills: [
+            'product strategy',
+            'user research',
+            'roadmap planning',
+            'feature prioritization',
+            'stakeholder management',
+            'data analysis',
+            'market research',
+        ],
+        permissions: [
+            'create:feature',
+            'update:roadmap',
+            'approve:requirements',
+            'view:analytics',
+        ],
+        outputs: [
+            'product briefs',
+            'roadmaps',
+            'user stories',
+            'requirements documents',
+            'prioritization frameworks',
+        ],
+    }),
+    /**
+     * Software Engineer role
+     */
+    SoftwareEngineer: Role({
+        name: 'Software Engineer',
+        description: 'Designs, develops, tests, and maintains software systems following best practices.',
+        skills: [
+            'software design',
+            'programming',
+            'testing',
+            'debugging',
+            'code review',
+            'system architecture',
+            'version control',
+        ],
+        permissions: [
+            'read:code',
+            'write:code',
+            'review:pr',
+            'deploy:staging',
+        ],
+        outputs: [
+            'code',
+            'tests',
+            'documentation',
+            'technical designs',
+            'pull requests',
+        ],
+    }),
+    /**
+     * Designer role
+     */
+    Designer: Role({
+        name: 'Designer',
+        description: 'Creates user interfaces, experiences, and visual designs that are intuitive and engaging.',
+        skills: [
+            'UI design',
+            'UX design',
+            'visual design',
+            'prototyping',
+            'user research',
+            'accessibility',
+            'design systems',
+        ],
+        permissions: [
+            'create:design',
+            'update:design-system',
+            'approve:mockups',
+        ],
+        outputs: [
+            'mockups',
+            'prototypes',
+            'design systems',
+            'style guides',
+            'user flows',
+        ],
+    }),
+    /**
+     * Data Analyst role
+     */
+    DataAnalyst: Role({
+        name: 'Data Analyst',
+        description: 'Analyzes data to uncover insights, trends, and actionable recommendations.',
+        skills: [
+            'data analysis',
+            'statistics',
+            'SQL',
+            'data visualization',
+            'A/B testing',
+            'reporting',
+        ],
+        permissions: [
+            'read:analytics',
+            'query:database',
+            'create:report',
+        ],
+        outputs: [
+            'reports',
+            'dashboards',
+            'insights',
+            'recommendations',
+            'metrics',
+        ],
+    }),
+    /**
+     * Content Writer role
+     */
+    ContentWriter: Role({
+        name: 'Content Writer',
+        description: 'Creates compelling written content for various channels and audiences.',
+        skills: [
+            'writing',
+            'editing',
+            'SEO',
+            'content strategy',
+            'storytelling',
+            'brand voice',
+        ],
+        permissions: [
+            'create:content',
+            'publish:blog',
+            'update:docs',
+        ],
+        outputs: [
+            'blog posts',
+            'documentation',
+            'marketing copy',
+            'social media content',
+            'emails',
+        ],
+    }),
+    /**
+     * Customer Support role
+     */
+    CustomerSupport: Role({
+        name: 'Customer Support',
+        description: 'Provides help and assistance to customers, resolving issues and answering questions.',
+        skills: [
+            'customer service',
+            'problem solving',
+            'communication',
+            'empathy',
+            'product knowledge',
+            'troubleshooting',
+        ],
+        permissions: [
+            'read:tickets',
+            'update:ticket',
+            'access:customer-data',
+        ],
+        outputs: [
+            'ticket responses',
+            'knowledge base articles',
+            'customer feedback',
+            'issue reports',
+        ],
+    }),
+    /**
+     * Project Manager role
+     */
+    ProjectManager: Role({
+        name: 'Project Manager',
+        description: 'Plans, executes, and delivers projects on time and within budget.',
+        skills: [
+            'project planning',
+            'task management',
+            'risk management',
+            'stakeholder communication',
+            'resource allocation',
+            'agile methodologies',
+        ],
+        permissions: [
+            'create:project',
+            'assign:task',
+            'update:timeline',
+            'view:resources',
+        ],
+        outputs: [
+            'project plans',
+            'status reports',
+            'timelines',
+            'risk assessments',
+            'retrospectives',
+        ],
+    }),
+    /**
+     * QA Engineer role
+     */
+    QAEngineer: Role({
+        name: 'QA Engineer',
+        description: 'Ensures software quality through testing, automation, and quality assurance processes.',
+        skills: [
+            'manual testing',
+            'test automation',
+            'bug reporting',
+            'test planning',
+            'quality assurance',
+            'regression testing',
+        ],
+        permissions: [
+            'run:tests',
+            'create:bug-report',
+            'approve:release',
+        ],
+        outputs: [
+            'test plans',
+            'test cases',
+            'bug reports',
+            'automation scripts',
+            'quality reports',
+        ],
+    }),
+    /**
+     * Marketing Manager role
+     */
+    MarketingManager: Role({
+        name: 'Marketing Manager',
+        description: 'Develops and executes marketing strategies to drive growth and brand awareness.',
+        skills: [
+            'marketing strategy',
+            'campaign management',
+            'digital marketing',
+            'analytics',
+            'brand management',
+            'content marketing',
+        ],
+        permissions: [
+            'create:campaign',
+            'approve:content',
+            'view:analytics',
+            'manage:budget',
+        ],
+        outputs: [
+            'marketing plans',
+            'campaigns',
+            'content calendars',
+            'performance reports',
+            'brand guidelines',
+        ],
+    }),
+    /**
+     * DevOps Engineer role
+     */
+    DevOpsEngineer: Role({
+        name: 'DevOps Engineer',
+        description: 'Manages infrastructure, deployment pipelines, and ensures system reliability.',
+        skills: [
+            'infrastructure management',
+            'CI/CD',
+            'monitoring',
+            'automation',
+            'cloud platforms',
+            'security',
+        ],
+        permissions: [
+            'deploy:production',
+            'manage:infrastructure',
+            'access:logs',
+            'configure:monitoring',
+        ],
+        outputs: [
+            'deployment scripts',
+            'infrastructure code',
+            'monitoring dashboards',
+            'incident reports',
+            'runbooks',
+        ],
+    }),
+};
+/**
+ * Check if a role has a specific permission
+ */
+export function hasPermission(role, permission) {
+    return role.permissions?.includes(permission) || false;
+}
+/**
+ * Check if a role has a specific skill
+ */
+export function hasSkill(role, skill) {
+    return role.skills.some(s => s.toLowerCase() === skill.toLowerCase() ||
+        s.toLowerCase().includes(skill.toLowerCase()));
+}
+/**
+ * Get all permissions for a role
+ */
+export function getPermissions(role) {
+    return role.permissions || [];
+}
+/**
+ * Get all skills for a role
+ */
+export function getSkills(role) {
+    return role.skills;
+}
+/**
+ * Merge multiple roles into a compound role
+ */
+export function mergeRoles(name, ...roles) {
+    const allSkills = new Set();
+    const allPermissions = new Set();
+    const allTools = [];
+    const allOutputs = new Set();
+    const descriptions = [];
+    roles.forEach(role => {
+        role.skills.forEach(skill => allSkills.add(skill));
+        role.permissions?.forEach(permission => allPermissions.add(permission));
+        role.tools?.forEach(tool => allTools.push(tool));
+        role.outputs?.forEach(output => allOutputs.add(output));
+        descriptions.push(role.description);
+    });
+    return Role({
+        name,
+        description: descriptions.join(' '),
+        skills: Array.from(allSkills),
+        permissions: Array.from(allPermissions),
+        tools: allTools,
+        outputs: Array.from(allOutputs),
+    });
+}
+//# sourceMappingURL=role.js.map

package/dist/role.js.map

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

package/dist/team.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 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
+ */
+import type { Team as TeamType, TeamMember, Agent, Role as RoleType, Goal, CommunicationChannel } from './types.js';
+/**
+ * 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 declare function Team(config: {
+    name: string;
+    description?: string;
+    members?: TeamMember[];
+    goals?: Goal[];
+    context?: Record<string, unknown>;
+    channels?: CommunicationChannel[];
+}): TeamInstance;
+/**
+ * Team instance with methods
+ */
+export interface TeamInstance extends TeamType {
+    /** Add a member to the team */
+    addMember(member: TeamMember): void;
+    /** Remove a member from the team */
+    removeMember(memberId: string): boolean;
+    /** Get a specific member */
+    getMember(memberId: string): TeamMember | undefined;
+    /** Get all members */
+    getMembers(): TeamMember[];
+    /** Get available members */
+    getAvailableMembers(): TeamMember[];
+    /** Get members by role */
+    getMembersByRole(roleId: string): TeamMember[];
+    /** Get members by type */
+    getMembersByType(type: 'agent' | 'human'): TeamMember[];
+    /** Update a member */
+    updateMember(memberId: string, updates: Partial<Omit<TeamMember, 'id'>>): void;
+    /** Add a goal */
+    addGoal(goal: Goal): void;
+    /** Update a goal */
+    updateGoal(goalId: string, updates: Partial<Omit<Goal, 'id'>>): void;
+    /** Remove a goal */
+    removeGoal(goalId: string): boolean;
+    /** Get all goals */
+    getGoals(): Goal[];
+    /** Add a communication channel */
+    addChannel(channel: CommunicationChannel): void;
+    /** Remove a communication channel */
+    removeChannel(channelId: string): boolean;
+    /** Broadcast message to all team members */
+    broadcast(message: string, channelType?: string): Promise<void>;
+    /** Send message to specific members */
+    sendTo(memberIds: string[], message: string, channelType?: string): Promise<void>;
+    /** Update team context */
+    updateContext(key: string, value: unknown): void;
+    /** Get team context */
+    getContext<T = unknown>(key?: string): T | Record<string, unknown>;
+}
+/**
+ * Create a team member entry
+ */
+export declare function createTeamMember(config: {
+    id: string;
+    name: string;
+    type: 'agent' | 'human';
+    role: RoleType;
+    status?: 'active' | 'inactive' | 'away';
+    availability?: 'available' | 'busy' | 'offline';
+}): TeamMember;
+/**
+ * Create a team member from an agent
+ */
+export declare function teamMemberFromAgent(agent: Agent): TeamMember;
+/**
+ * Calculate team capacity based on available members
+ */
+export declare function calculateTeamCapacity(team: TeamInstance): {
+    total: number;
+    available: number;
+    busy: number;
+    offline: number;
+};
+/**
+ * Get team skills - aggregated from all members
+ */
+export declare function getTeamSkills(team: TeamInstance): string[];
+/**
+ * Check if team has a specific skill
+ */
+export declare function teamHasSkill(team: TeamInstance, skill: string): boolean;
+/**
+ * Find best member for a task based on role skills
+ */
+export declare function findBestMemberForTask(team: TeamInstance, requiredSkills: string[]): TeamMember | null;
+//# sourceMappingURL=team.d.ts.map

package/dist/team.d.ts.map

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