Mobile Autonomy Runbook

Date: 2026-02-20
Scope: Operate SCBE agents from phone app and execute goal-driven workflows

Goal

Enable a phone app to submit goals (for example, online store operations), monitor progress, approve high-risk actions, and receive completion/audit updates.

Implemented Control Plane (MVP)

API file: src/api/main.py

Endpoints:

• GET /mobile/connectors/templates
  • Get built-in connector setup profiles
• POST /mobile/connectors
  • Register connector endpoint (n8n, Zapier, Shopify, Slack, Notion, Airtable, GitHub Actions, Linear, Discord, generic webhook)
• GET /mobile/connectors
  • List registered connectors
• POST /mobile/goals/{goal_id}/bind-connector
  • Bind connector to existing goal and switch execution mode
• POST /mobile/goals
  • Submit a goal with channel profile (store_ops, web_research, content_ops, custom)
• GET /mobile/goals
  • List recent goals for authenticated user
• GET /mobile/goals/{goal_id}
  • Get current state, step progress, and event log
• POST /mobile/goals/{goal_id}/advance
  • Execute next step in the plan
• POST /mobile/goals/{goal_id}/approve
  • Approve high-risk steps from phone

Safety Model

• High-risk steps are blocked when require_human_for_high_risk=true.
• Explicit approval is required to continue.
• Every step writes deterministic events for auditability.

Phone App Flow

1. User submits goal from mobile app:
   • “Run storefront operations for today and process pending messages.”
   • Optional: pass execution_mode=connector + connector_id.
2. App polls GET /mobile/goals/{id} for status.
3. When status becomes review_required, app prompts user to approve.
4. App calls POST /mobile/goals/{id}/approve.
5. App resumes execution via POST /mobile/goals/{id}/advance.
6. Goal reaches completed; app displays summary.

E-commerce Channel Pattern (store_ops)

Generated step plan:

1. collect_store_state (low risk)
2. prioritize_orders_and_messages (medium risk)
3. execute_catalog_or_fulfillment_changes (high risk)
4. publish_daily_report (low risk)

Next Integration Steps (to reach full automation)

1. Register real connectors per account:
   • Shopify workflow endpoint (or n8n flow containing Shopify nodes)
   • Zapier webhook for cross-service automations
   • n8n endpoint for AetherBrowse + store task orchestration
   • Slack/Discord notification hooks for approvals and exceptions
   • Notion/Airtable sync endpoints for ops memory/state
2. Replace simulated step execution with specialized worker adapters:
   • Shopify admin adapter (orders/catalog/fulfillment)
   • Email/helpdesk adapter
   • Ad platform adapter
3. Add OAuth + scoped capability tokens per store/account.
4. Add approval policies by action type and spend threshold.
5. Add webhook push to phone app for real-time status events.
6. Add immutable audit sink (S3 + signed event hash chain).

Local Test

python -m pytest -q tests/test_mobile_goal_api.py

Terminal Control

For terminal-first operations (research, article flows, product/store operations), use:

• scripts/scbe_terminal_ops.py
• docs/TERMINAL_OPS_QUICKSTART.md

Example API Key Header

x-api-key: demo_key_12345