API Reference
Complete reference for all METAOS tools and capabilities.
Core Concepts
Intent
User goal or action request (e.g., "schedule meeting", "send message")
Context
Current state including time, location, and recent activity
Tool
OS capability callable by agents (calendar, messages, etc.)
Capability
Permission to call a specific tool, granted by user
Approval
User confirmation required for sensitive operations
Card
UI payload returned by agent to display results
Available Tools
Messages
messages.*List, send, and manage messages
messages.list()messages.send()
Calendar
calendar.*Read and create calendar events
calendar.listEvents()calendar.createEvent()
Contacts
contacts.*Search and access contact information
contacts.search()
Storage
storage.*Read and write files/notes in user's storage
storage.read()storage.write()
Approval
approval.*Request user confirmation for sensitive actions
approval.request()approval.result()
📅 Coming Soon
Additional tools in development:
- audio.* - Voice transcription and text-to-speech
- vision.* - Document scanning and image analysis
- location.* - Geolocation services
- device.* - Hardware integration (camera, sensors)
Error Handling
All tool calls may throw standard errors. Always handle these in your agent:
try {
await tools.messages.send({ to: "user@example.com", subject: "Hello" });
} catch (error) {
if (error.code === "CAPABILITY_DENIED") {
return { type: "error", title: "Permission denied" };
}
if (error.code === "APPROVAL_REQUIRED") {
return { type: "error", title: "Please approve this action first" };
}
}