Tools

Tools let agents do work outside plain text. Alumia includes built-in tools for search, files, browser sessions, terminal sessions, memories, datasets, canvas edits (data_block, show, compose_canvas, recompose_canvas, search_blocks, update_block, …), email, telephony, domains, discovery sets, apps, and peer-agent coordination (spawn_agent, message_agent, list_agents, …).

Tool access

Tool availability is scoped by organization, project, agent settings, and provider configuration. Give an agent only the tools it needs for the job. Sensitive tools should be paired with clear prompts, audit logs, and human review where the workflow requires it.

Connector-backed tools

Connectors extend tools into external systems such as Gmail, Slack, GitHub, Notion, QuickBooks, Stripe, Shopify, Vercel, Cloudflare, Supabase, Sentry, and other supported services. Connector credentials stay encrypted and are invoked through the platform rather than exposed to agents as raw secrets.

OAuth connect buttons open the provider in a normal new tab (never a sized popup). When consent completes, the originating page refreshes via BroadcastChannel / localStorage / status polling and the blocked chat session resumes automatically.

Discovery sets

Discovery sets are async research tables backed by discovery_set_create, discovery_set_get, discovery_set_list_items, discovery_set_add_search, discovery_set_add_field, and discovery_set_cancel. Agents should render a loading table on the canvas first, then schedule a one-time refresh to update the same block instead of creating duplicates. The full built-in tool catalog also covers canvas, files, browser, email, telephony, domains, datasets, apps, and peer-agent coordination tools.

Schedules and skills

Schedule tools (schedules_list, schedules_create, …) manage cron runs when enabled on the agent. Platform expansion skills gate bundled tool sets — disabling a skill removes its exclusive tools from the runtime filter.