Skip to main content

Resource reference

Resources are keyed records under manifest.resources.

CollectionBuilderNotes
dataWorkspacesresources.workspace()Top-level data product
dataWorkspaceBasesresources.base()Belongs to a Data Workspace
dataWorkspaceTablesresources.table()Columns, views, and optional seed rows
workflowDefinitionsresources.workflow()Durable executable definition
workflowInstancesplain objectInstalled workflow configuration
agentDefinitionsplain objectApp-owned AI Agent definition, policies, tools, and memory binding
frontendPagesresources.frontendPage()Hosted static files and bindings
documentFoldersplain objectFolder provisioned at install
documentsplain objectDocument provisioned at install
formsplain objectForm resource
triggersplain objectDurable event matcher; see the trigger reference

Agent definitions​

An agentDefinitions entry can declare name, slug, description, status, model, instructions, toolPolicy, memory, approvalPolicy, sourcePolicy, isolation, and metadata. Reference it from both a chat preset and an agent surface:

agentDefinitions: {
receptionist: {
name: 'AI Receptionist Agent',
status: 'active',
instructions: 'Answer from app knowledge and offer a human handoff when uncertain.',
toolPolicy: { allow: ['app.knowledge.search'], deny: [] },
memory: { knowledgeContainerKey: 'business-knowledge' },
sourcePolicy: { allowSourceTypes: ['ai-chat', 'workflow'] },
},
}

app.knowledge.search never accepts a caller-selected container. The host derives the container from the installed definition and app installation.

Table columns​

Supported column types include:

single_line_text long_text number auto_number
decimal currency percent duration
rating single_select multi_select checkbox
date year time date_time
linked_record lookup rollup formula
qr_code barcode button workflow
created_time last_modified_time created_by last_modified_by
url email phone color
uuid collaborator attachment internal_resource
json ai_agent

Column definitions may include name, required, nullable, unique, defaultValue, position, and meta.

Views​

Tables can declare named views with type grid, kanban, calendar, or gallery, plus filters and sort rules. A dataWorkspaceView surface can select one by its manifest key with viewKey.