Example Agents

{
  "id": "com.example.meeting-scheduler",
  "name": "Meeting Scheduler",
  "version": "1.0.0",
  "description": "Schedule meetings with automatic availability detection",
  
  "capabilities": [
    "calendar.read",
    "calendar.write",
    "contacts.read",
    "messages.send"
  ]
}

export async function handleIntent({ intent, context, tools }) {
  if (intent.action === "schedule_meeting") {
    const { title, attendees, duration } = intent.parameters;

    // Step 1: Search for contacts
    const contacts = await Promise.all(
      attendees.map(name => tools.contacts.search({ query: name }))
    );
    const emails = contacts.map(c => c[0]?.emails[0]).filter(Boolean);

    // Step 2: Find available time
    const now = new Date();
    const weekFromNow = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
    
    const events = await tools.calendar.listEvents({
      start: now.toISOString(),
      end: weekFromNow.toISOString()
    });

    // Find first available 1-hour slot
    let availableSlot = findAvailableSlot(events, duration || 60);

    // Step 3: Request approval
    const approval = await tools.approval.request({
      action: "create_calendar_event",
      title: `Schedule "${title}"`,
      description: `Create meeting for ${formatDate(availableSlot.start)}`,
      details: {
        title: title,
        start: availableSlot.start,
        end: availableSlot.end,
        attendees: emails
      }
    });

    if (!approval.approved) {
      return {
        type: "error",
        title: "Meeting not scheduled",
        description: "You declined the approval."
      };
    }

    // Step 4: Create event
    const event = await tools.calendar.createEvent({
      title: title,
      start: availableSlot.start,
      end: availableSlot.end,
      attendees: emails
    });

    // Step 5: Send notification
    await tools.messages.send({
      to: emails,
      subject: `Meeting Scheduled: ${title}`,
      body: `You've been invited to "${title}" on ${formatDate(availableSlot.start)}`
    });

    return {
      type: "result",
      title: "✅ Meeting scheduled",
      description: `Created "${title}" for ${formatDate(availableSlot.start)}`,
      action: {
        label: "View Event",
        url: `metaos://calendar/event/${event.id}`
      }
    };
  }
}

function findAvailableSlot(events, durationMinutes) {
  // Simple algorithm: find first gap >= duration
  const now = new Date();
  now.setHours(9, 0, 0, 0); // Start at 9 AM
  
  for (let day = 0; day < 7; day++) {
    for (let hour = 9; hour < 17; hour++) {
      const start = new Date(now);
      start.setDate(start.getDate() + day);
      start.setHours(hour, 0, 0, 0);
      
      const end = new Date(start);
      end.setMinutes(end.getMinutes() + durationMinutes);
      
      const hasConflict = events.some(event => 
        (new Date(event.start) < end && new Date(event.end) > start)
      );
      
      if (!hasConflict) {
        return {
          start: start.toISOString(),
          end: end.toISOString()
        };
      }
    }
  }
  
  throw new Error("No available slots found");
}

function formatDate(isoString) {
  const date = new Date(isoString);
  return date.toLocaleDateString('en-US', {
    weekday: 'long',
    month: 'long',
    day: 'numeric',
    hour: 'numeric',
    minute: '2-digit'
  });
}