create_automation
ChatGPTAttaches an on-device Apple source to a Glance feed so the iPhone widget can read Weather, Calendar, Reminders, or Motion locally. Not Glance-pull: no Google, GitHub, Jira, or cron. No connection_id. No schedule_cron. BEFORE calling: tell the user to open Glance → Settings → Integrations and tap Connect on that source (each has its own button). Wait until they confirm. You cannot grant iOS permissions from this chat. Layout bindings: current_temp / reminder_1_ / event_1_ for lists, or {{events}} on a v2 calendar node (eventkit_calendar, field_mapping {}). Reminders stay lists. After success: ingest placeholders for every binding (device automations do not write feed_state), then tell them to open Glance once and pin.
create_custom_connection
ChatGPTSaves a URL Glance can fetch for a widget. RSS or JSON. No secret argument. Never put a key in the URL or in chat. If capabilities.custom_connections is false, do not call this. When status is needs_key, send the user appLink and wait. Do not design the widget yet.
create_dynamic_widget
ChatGPTCreates a dynamic widget config + coupled feed. Returns config.id, feed.id, ingest URL, and write_key once. The write key is for Shortcuts/Make/curl only — ChatGPT/Claude must call ingest with OAuth and must not store the key. Ask list_widgets before creating. Size must match the template widget_size.
create_template
ChatGPTCreates a new Glance widget template and saves it to the database. Server-side structural validation is the save gate (unknown types, bindings, depth, ids). Design issues (padding, overflow, style keys) are warnings only and do not block create. If structural validation fails, fix the tree and retry create_template — validate_template is optional. Pro+ families (chart, grid, table, views/action) 403 PREMIUM_FAMILY_REQUIRED — call get_plan first. Returns the created template with its ID.
delete_widget
ChatGPTPermanently deletes a widget config and its feed. Always confirm with the user before calling. Cannot be undone.
get_custom_connection
ChatGPTReads a custom connection. Returns needs_key or ready. Does not fetch the URL and never returns the key. Call this after the user says they pasted the key.
get_plan
ChatGPTReturns this Glance account's live plan, quotas, usage, and capability flags. Call before promising Pro-only features (UI on Demand) or extra layouts, feeds, or automations. Do not assume ChatGPT Plus, Claude Pro, or any host plan equals Glance Pro. agent_messages_per_day applies only to in-app Glance Chat, not ChatGPT/Claude. If capabilities.ui_on_demand is true, ingest may use inline_ui (XOR with template_id) to change chrome per update. If false, always create_template + template_id. Never send both arms. family_views, family_charts, family_grid, and family_table are Pro+ layout language families. If a flag is false, do not emit that family (named views / set_view, toggle_flag + visibleFlag, chart, grid, or table).
get_template
ChatGPTReturns the full template tree, derived schema, and binding names for one template_id. Use when validation fails or you need to patch an existing layout. list_templates stays a catalog — do not dump every tree.
get_widget_status
ChatGPTReturns a widget's last ingest time, automations, ingest URL, and live layout. When uiMode is on_demand, includes inline_ui.tree (what is on the Home Screen). Never returns a write key. widget_config_id and feed_id come from create_dynamic_widget or list_widgets.
ingest
ChatGPTPushes live content to a Glance feed you own. This is how ChatGPT/Claude update a widget. Uses the OAuth access token — do not HTTP POST and do not send a write key. content keys must match binding names (the names inside {{ }}), not provider field IDs. XOR: template_id or inline_ui (or top-level tree), never both. inline_ui is Pro+ (call get_plan). Allowed on public widgets; subscribers see the last push. Glance-pull automations always use template_id. On-device widgets: after create_automation, ingest placeholders for every binding so the layout attaches; live Apple data overwrites on the phone. Do not tell the user you saved a layout when you used inline_ui.
list_connected_integrations
ChatGPTReturns OAuth accounts this user has connected in Glance: id, providerId, and status. The token is not included. Match providerId from list_integrations. One Google account covers Calendar, Tasks, and Sheets. Device permissions and custom URLs are not in this list. If the provider is missing, tell the user to open Glance → Settings → Connected Services, tap Connect, and come back. Do not ask for a token.
list_golden_examples
ChatGPTReturns curated golden widget templates — the quality bar for layout composition. Call before designing a new tree to pick the closest pattern (S1 KPI, M2 multi-source, L2 OOTD, or v2-* language nodes). v2-vocab-flip is in-place reveal (toggle_flag + visibleFlag, no views). v2-mission-control is named views (set_view). Pass example_id to fetch one full tree + optional views + sample content. Adapt patterns to the user data — do not copy wholesale.
list_integration_assets
ChatGPTLists choices for a catalog integration whose configOptions include selectable: true (calendars, pages, ad accounts, sheet tabs). Pass the returned asset id into create_automation sources[].config under that group's config_key. For google_sheets, pass spreadsheet_id from the user's spreadsheet URL to get sheet tab names in hints.
list_integrations
ChatGPTReturns the Glance catalog: device sources and cloud connectors, with field catalogs and config options. Copy integration_id and providerId from this list. Custom URLs are not included — those use the custom connection tools. Defaults to sources Glance can attach now. A later partner appears here when its status is available. Do not invent an id that is absent.
list_templates
ChatGPTReturns the user's existing widget templates (id, name, widgetSize, bindingCount). Always call this before update_template so you have the real template ID. Never guess or invent a template ID.
list_widgets
ChatGPTReturns the user's existing widgets (id, name, size, feedIds). Call this first. If any exist, ask whether to update one of them or create a new one. Never silently reuse a widget. Never silently create a duplicate.
preview_custom_connection
ChatGPTFetches a ready custom connection once and returns the fields to map. RSS returns slot ids. JSON returns dot paths. Does not return the key. Do not call this while status is needs_key. Do not call create_automation for a keyed connection before this succeeds.
update_template
ChatGPTUpdates an existing template tree. Server-side structural validation is the save gate; design issues are warnings only and do not block update. validate_template is optional for early feedback. Pro+ families 403 PREMIUM_FAMILY_REQUIRED — call get_plan first. Returns the updated template.
validate_template
ChatGPTValidates a Glance dynamic widget template tree against the SDK schema rules. Optional early feedback before save — call at most twice per design iteration. valid is true when the tree is structurally sound; design issues are warnings only and never flip valid to false. create_template / update_template use the same structural gate server-side. Returns structural errors, design warnings (layout fit, style keys, safe zone), and families_used. families_used is informational — this tool never 403s on Pro+ families. Check get_plan before create_template.