FoyerDevelopers

Generated · Live registry

agents tools

6 tools in this domain, generated from the running registry.

All tool domains

agents.configure

writes

Upsert per-tenant agent configuration. Owner-only. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
agentIdstringyes
enabledbooleanno
schedulestring · nullableno
requiresApprovalbooleanno
guardrailsobjectno

Output fields

FieldTypeRequiredNotes
idstringno

agents.list

read-only

List all registered agents with their per-tenant config (enabled, schedule, guardrails) and last run status.

Input parameters

Returns object.

Output fields

Returns array of object. Fields of each element:

FieldTypeRequiredNotes
agentIdstringyes
namestringyes
descriptionstringyes
categorystringyes
enabledbooleanyes
requiresApprovalbooleanyes
lastRunStatusstring · nullableyes
lastRunAtstring · nullableyes

agents.proposals.list

read-only

List agent proposals awaiting human review. Defaults to pending proposals only.

Input parameters

FieldTypeRequiredNotes
agentIdstringno
statusarray of enumnoDefault: ["pending"]
limitintegernoDefault: 50

Output fields

Returns array of object. Fields of each element:

FieldTypeRequiredNotes
idstringyes
agentIdstringyes
proposalTypestringyes
payloadobjectyes
statusstringyes
expiresAtstring · nullableyes
createdAtstringyes

agents.proposals.review

writesconfirm

Approve or reject an agent proposal. Approved proposals are logged; execution is handled by the application layer.

Input parameters

FieldTypeRequiredNotes
idstringyes
decisionenumyesOne of: approved, rejected
notestringno

Output fields

FieldTypeRequiredNotes
idstringyes
statusstringyes

agents.runs.list

read-only

Lists the runs of the property's AI agents (a log of every agent run), newest first, paginated (page, pageSize up to 100), optionally filtered to one agent (agentId). Requires the ai_agents module. Read-only.

Input parameters

FieldTypeRequiredNotes
agentIdstringno
pageintegernoDefault: 1
pageSizeintegernoDefault: 25

Output fields

FieldTypeRequiredNotes
rowsarray of objectyes
rows.idstringyes
rows.tenantIdstringyes
rows.agentIdstringyes
rows.triggeredByenumyesOne of: schedule, manual, event, orchestrator
rows.statusenumyesOne of: running, completed, failed, skipped
rows.inputHashstring · nullableyes
rows.outputSummarystring · nullableyes
rows.durationMsinteger · nullableyes
rows.tokensUsedinteger · nullableyes
rows.errorstring · nullableyes
rows.createdAtstringyes
rows.completedAtstring · nullableyes
pageintegeryes
hasMorebooleanyes

agents.trigger

writesconfirm

Manually trigger an agent run. The agent will run asynchronously; check agents.runs.list for status.

Input parameters

FieldTypeRequiredNotes
agentIdenumyesOne of: morning-routine, email-triage, email-processor, email-draft, booking-inquiry, arrival-time-check, concierge, pre-arrival-outreach, dynamic-pricing, room-upgrade, agent-notification, cleaning-schedule, fb-shopping-list, finance-filing, villa-analytics, marketing-report, crm-pipeline

Output fields

FieldTypeRequiredNotes
jobIdstringyes