autonomous-agents 0.1.0 → 2.0.1

package/dist/actions.js

@@ -0,0 +1,303 @@
+/**
+ * Actions - Core action functions for autonomous agents
+ *
+ * These are standalone functions that can be used independently
+ * or as part of an agent's capabilities.
+ *
+ * @packageDocumentation
+ */
+import { generateObject } from 'ai-functions';
+/**
+ * Execute a task using AI
+ *
+ * @example
+ * ```ts
+ * import { do as doTask } from 'autonomous-agents'
+ *
+ * const result = await doTask('Analyze customer feedback and provide insights', {
+ *   feedback: ['Great product!', 'Needs improvement', 'Love the features'],
+ * })
+ * ```
+ */
+export async function doAction(task, context, options) {
+    const result = await generateObject({
+        model: options?.model || 'sonnet',
+        schema: options?.schema || { result: 'The result of the task' },
+        system: options?.system || 'You are a helpful AI assistant. Execute tasks accurately and thoroughly.',
+        prompt: `Task: ${task}\n\nContext: ${JSON.stringify(context || {})}`,
+        temperature: options?.temperature ?? 0.7,
+    });
+    return result.object.result || result.object;
+}
+/**
+ * Ask a question and get an answer
+ *
+ * @example
+ * ```ts
+ * import { ask } from 'autonomous-agents'
+ *
+ * const answer = await ask('What are the key benefits of our product?', {
+ *   product: 'AI Assistant',
+ *   features: ['smart automation', 'natural language', 'context awareness'],
+ * })
+ * ```
+ */
+export async function ask(question, context, options) {
+    const result = await generateObject({
+        model: options?.model || 'sonnet',
+        schema: options?.schema || {
+            answer: 'The answer to the question',
+            reasoning: 'Supporting reasoning',
+        },
+        system: options?.system || 'You are a knowledgeable AI assistant. Provide clear, accurate answers.',
+        prompt: `Question: ${question}\n\nContext: ${JSON.stringify(context || {})}`,
+        temperature: options?.temperature ?? 0.7,
+    });
+    const response = result.object;
+    return response.answer;
+}
+/**
+ * Make a decision between options
+ *
+ * @example
+ * ```ts
+ * import { decide } from 'autonomous-agents'
+ *
+ * const choice = await decide(
+ *   ['option A', 'option B', 'option C'],
+ *   'Which option has the highest ROI?'
+ * )
+ * ```
+ */
+export async function decide(options, context, settings) {
+    const result = await generateObject({
+        model: settings?.model || 'sonnet',
+        schema: {
+            decision: options.join(' | '),
+            reasoning: 'Reasoning for this decision',
+            confidence: 'Confidence level 0-100 (number)',
+        },
+        system: settings?.system || 'You are a strategic decision-maker. Evaluate options carefully and provide clear reasoning.',
+        prompt: `Make a decision between these options:\n${options.map((o, i) => `${i + 1}. ${o}`).join('\n')}\n\nContext: ${context || 'No additional context'}`,
+        temperature: settings?.temperature ?? 0.7,
+    });
+    const response = result.object;
+    return response.decision;
+}
+/**
+ * Request approval for an action or decision
+ *
+ * @example
+ * ```ts
+ * import { approve } from 'autonomous-agents'
+ *
+ * const approval = await approve({
+ *   title: 'Budget Request',
+ *   description: 'Request $50k for marketing campaign',
+ *   data: { amount: 50000, campaign: 'Q1 Launch' },
+ *   approver: 'manager@company.com',
+ *   priority: 'high',
+ * })
+ *
+ * if (approval.status === 'approved') {
+ *   // Proceed with the action
+ * }
+ * ```
+ */
+export async function approve(request) {
+    return executeApproval(request);
+}
+/**
+ * Execute approval request (internal implementation)
+ */
+export async function executeApproval(request) {
+    // Generate approval UI based on channel
+    const uiSchema = getApprovalUISchema(request.channel || 'web');
+    const result = await generateObject({
+        model: 'sonnet',
+        schema: uiSchema,
+        system: `Generate ${request.channel || 'web'} UI/content for an approval request.`,
+        prompt: `Approval Request: ${request.title}
+
+Description: ${request.description}
+
+Data to be approved:
+${JSON.stringify(request.data, null, 2)}
+
+Priority: ${request.priority || 'medium'}
+Approver: ${request.approver || 'any authorized approver'}
+
+${request.responseSchema ? `Expected response format:\n${JSON.stringify(request.responseSchema)}` : ''}
+
+Generate the appropriate UI/content to collect approval or rejection with optional notes.`,
+    });
+    // In a real implementation, this would:
+    // 1. Send the generated UI to the specified channel
+    // 2. Wait for human response (with timeout)
+    // 3. Return the validated response
+    // For now, return a pending approval with generated artifacts
+    return {
+        status: 'pending',
+        response: undefined,
+        timestamp: new Date(),
+    };
+}
+/**
+ * Get approval UI schema based on channel
+ */
+function getApprovalUISchema(channel) {
+    const schemas = {
+        slack: {
+            blocks: ['Slack BlockKit blocks as JSON array'],
+            text: 'Plain text fallback',
+        },
+        email: {
+            subject: 'Email subject line',
+            html: 'Email HTML body with approval buttons',
+            text: 'Plain text fallback',
+        },
+        web: {
+            component: 'React component code for approval form',
+            schema: 'JSON schema for the form fields',
+        },
+        sms: {
+            text: 'SMS message text (max 160 chars)',
+            responseFormat: 'Expected response format',
+        },
+        custom: {
+            data: 'Structured data for custom implementation',
+            instructions: 'Instructions for the approver',
+        },
+    };
+    return schemas[channel] || schemas.custom;
+}
+/**
+ * Generate content using AI
+ *
+ * @example
+ * ```ts
+ * import { generate } from 'autonomous-agents'
+ *
+ * const content = await generate({
+ *   model: 'sonnet',
+ *   schema: {
+ *     title: 'Blog post title',
+ *     content: 'Blog post content',
+ *     tags: ['List of tags'],
+ *   },
+ *   prompt: 'Write a blog post about AI automation',
+ * })
+ * ```
+ */
+export async function generate(options) {
+    const result = await generateObject({
+        model: options.model || 'sonnet',
+        schema: (options.schema || { result: 'Generated content' }),
+        system: options.system || 'You are a creative AI assistant. Generate high-quality content.',
+        prompt: options.prompt || '',
+        temperature: options.temperature ?? 0.8,
+    });
+    return result.object;
+}
+/**
+ * Type checking and validation
+ *
+ * @example
+ * ```ts
+ * import { is } from 'autonomous-agents'
+ *
+ * const isValid = await is(
+ *   { email: 'test@example.com' },
+ *   'valid email address'
+ * )
+ *
+ * const matchesSchema = await is(
+ *   { name: 'John', age: 30 },
+ *   { name: 'string', age: 'number' }
+ * )
+ * ```
+ */
+export async function is(value, type) {
+    const schema = typeof type === 'string'
+        ? { isValid: `Is this value a valid ${type}? (boolean)`, reason: 'Explanation' }
+        : { isValid: 'Does this value match the schema? (boolean)', reason: 'Explanation' };
+    const result = await generateObject({
+        model: 'sonnet',
+        schema,
+        system: 'You are a type validator. Determine if the value matches the expected type or schema.',
+        prompt: `Value: ${JSON.stringify(value)}\n\nExpected type: ${typeof type === 'string' ? type : JSON.stringify(type)}`,
+        temperature: 0,
+    });
+    return result.object.isValid;
+}
+/**
+ * Send a notification
+ *
+ * @example
+ * ```ts
+ * import { notify } from 'autonomous-agents'
+ *
+ * await notify({
+ *   message: 'Task completed successfully!',
+ *   channel: 'slack',
+ *   recipients: ['#general'],
+ *   priority: 'high',
+ *   data: { taskId: '123', duration: '5 minutes' },
+ * })
+ * ```
+ */
+export async function notify(options) {
+    const { message, channel = 'web', recipients = [], priority = 'medium', data = {}, } = options;
+    // Generate channel-specific notification format
+    const notificationSchema = getNotificationSchema(channel);
+    const result = await generateObject({
+        model: 'sonnet',
+        schema: notificationSchema,
+        system: `Generate ${channel} notification content.`,
+        prompt: `Notification message: ${message}
+
+Recipients: ${recipients.join(', ') || 'default recipients'}
+Priority: ${priority}
+
+Additional data:
+${JSON.stringify(data, null, 2)}
+
+Generate the appropriate ${channel} notification format.`,
+    });
+    // In a real implementation, this would send via the specified channel
+    console.log(`[Notification] [${channel}] ${message}`, result.object);
+}
+/**
+ * Get notification schema based on channel
+ */
+function getNotificationSchema(channel) {
+    const schemas = {
+        slack: {
+            blocks: ['Slack BlockKit blocks'],
+            text: 'Plain text fallback',
+        },
+        email: {
+            subject: 'Email subject',
+            html: 'Email HTML body',
+            text: 'Plain text version',
+        },
+        web: {
+            title: 'Notification title',
+            message: 'Notification message',
+            type: 'success | info | warning | error',
+        },
+        sms: {
+            text: 'SMS message (max 160 chars)',
+        },
+        custom: {
+            format: 'Custom notification format',
+            content: 'Notification content',
+        },
+    };
+    return schemas[channel] || schemas.custom;
+}
+/**
+ * Export the 'do' function with an alias to avoid keyword conflict
+ */
+export { doAction as do };
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/agent.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 type { Agent, AgentConfig } from './types.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 declare function Agent(config: AgentConfig): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EAMZ,MAAM,YAAY,CAAA;AAGnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA2YhD"}