Scope catalog

Scopes gate ctx.tools.call(...) access. Declare every scope your app needs in manifest.required_scopes; the tenant must grant them on install. The platform enforces scope at every call site — your code only runs against tenants where the grant exists.

Mail

Scope	Tools	Description
mail.read	email_search, email_get, email_list	Read tenant emails
mail.send	email_send, email_reply	Send mail as the tenant
mail.draft	email_create_draft	Compose drafts without sending

Calendar

Scope	Tools	Description
calendar.read	calendar_list_events, calendar_get_event	Read calendar
calendar.write	calendar_create_event, calendar_update_event	Manage events

Files

Scope	Tools	Description
files.read	file_get, file_search, attachment_get	Read files + attachments
files.write	file_create, file_update	Create/update files in tenant storage

ERP (Odoo)

Scope	Tools	Description
odoo.read	odoo_search_read, odoo_read	Read records
odoo.write	odoo_create, odoo_update, odoo_unlink	Mutate records

Reports

Scope	Tools	Description
reports.generate	report_pdf_render, report_excel_render	Build PDF + Excel artifacts

Messaging

Scope	Tools	Description
whatsapp.send	whatsapp_send_text, whatsapp_send_template	Send WhatsApp messages

AI

Scope	Tools	Description
ai.image	ai_image_generate	Generate images
ai.video	kling_video_generate	Generate short video clips

Triage

Scope	Tools	Description
mail.triage	email_triage_classify, email_triage_digest	LLM-backed inbox classification

Pattern: scope-deny graceful handling

A tenant might install your app without granting every scope. Code defensively:

import { ToolCallError } from '@linkworld/sdk'

try {
  await ctx.tools.call('odoo_create', { model, values })
} catch (err) {
  if (err instanceof ToolCallError && err.decision === 'scope_denied') {
    // Optional path — tenant didn't grant odoo.write
    console.log('[my-app] odoo.write not granted; skipping ERP write')
    return
  }
  throw err
}

from linkworld_sdk import ToolCallError

try:
    await ctx.tools.call("odoo_create", model=model, values=values)
except ToolCallError as exc:
    if exc.decision == "scope_denied":
        return
    raise

Adding a new scope

Need a tool we haven’t surfaced? Open an issue at github.com/linkworld/linkworld or post in the dev community. Scopes ship with the platform; partners don’t define them.