autonomous-agents 0.1.0 → 2.0.1

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for autonomous-agents
+ *
+ * Primitives for building and orchestrating autonomous AI agents that operate
+ * within a company boundary using the digital-workers interface.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,43 +1,34 @@
 {
   "name": "autonomous-agents",
-  "version": "0.1.0",
-  "description": "Function-based Agent API for inherently autonomous agents",
+  "version": "2.0.1",
+  "description": "Primitives for building and orchestrating autonomous AI agents",
+  "type": "module",
   "main": "dist/index.js",
-  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "ai-functions": "workspace:*",
+    "digital-workers": "workspace:*",
+    "rpc.do": "^0.1.0"
+  },
   "keywords": [
-    "agent",
+    "ai",
+    "agents",
     "autonomous",
-    "ai"
+    "primitives"
   ],
-  "author": "Drivly",
-  "license": "MIT",
-  "devDependencies": {
-    "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^3.1.3"
-  },
-  "tsup": {
-    "entry": [
-      "src/index.ts"
-    ],
-    "format": [
-      "cjs",
-      "esm"
-    ],
-    "dts": true,
-    "splitting": false,
-    "sourcemap": true,
-    "clean": true
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src/**/*.ts",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  }
-}
+  "license": "MIT"
+}

package/src/actions.ts

@@ -0,0 +1,366 @@
+/**
+ * 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, type AIGenerateOptions, type SimpleSchema } from 'ai-functions'
+import type {
+  ApprovalRequest,
+  ApprovalResult,
+  ApprovalStatus,
+  NotificationOptions,
+} from './types.js'
+
+/**
+ * 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<TResult = unknown>(
+  task: string,
+  context?: unknown,
+  options?: AIGenerateOptions
+): Promise<TResult> {
+  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 as { result: TResult }).result || result.object as TResult
+}
+
+/**
+ * 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<TResult = unknown>(
+  question: string,
+  context?: unknown,
+  options?: AIGenerateOptions
+): Promise<TResult> {
+  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 as { answer: TResult; reasoning: string }
+  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<T extends string>(
+  options: T[],
+  context?: string,
+  settings?: AIGenerateOptions
+): Promise<T> {
+  const result = await generateObject({
+    model: settings?.model || 'sonnet',
+    schema: {
+      decision: options.join(' | '),
+      reasoning: 'Reasoning for this decision',
+      confidence: 'Confidence level 0-100 (number)',
+    } as SimpleSchema,
+    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 as unknown as {
+    decision: T
+    reasoning: string
+    confidence: number
+  }
+
+  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<TResult = unknown>(
+  request: ApprovalRequest
+): Promise<ApprovalResult<TResult>> {
+  return executeApproval(request)
+}
+
+/**
+ * Execute approval request (internal implementation)
+ */
+export async function executeApproval<TResult = unknown>(
+  request: ApprovalRequest
+): Promise<ApprovalResult<TResult>> {
+  // 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' as ApprovalStatus,
+    response: undefined,
+    timestamp: new Date(),
+  } as ApprovalResult<TResult>
+}
+
+/**
+ * Get approval UI schema based on channel
+ */
+function getApprovalUISchema(channel: string): SimpleSchema {
+  const schemas: Record<string, SimpleSchema> = {
+    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<TResult = unknown>(
+  options: AIGenerateOptions
+): Promise<TResult> {
+  const result = await generateObject({
+    model: options.model || 'sonnet',
+    schema: (options.schema || { result: 'Generated content' }) as SimpleSchema,
+    system: options.system || 'You are a creative AI assistant. Generate high-quality content.',
+    prompt: options.prompt || '',
+    temperature: options.temperature ?? 0.8,
+  })
+
+  return result.object as TResult
+}
+
+/**
+ * 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: unknown,
+  type: string | SimpleSchema
+): Promise<boolean> {
+  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 as unknown as { isValid: boolean; reason: string }).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: NotificationOptions): Promise<void> {
+  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: string): SimpleSchema {
+  const schemas: Record<string, SimpleSchema> = {
+    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 }