Build against the protocol.

GET https://api.coyl.ai/v1/oauth/authorize
  ?response_type=code
  &client_id=<your_client_id>
  &redirect_uri=<your_redirect_uri>
  &scope=context:read+interrupt:trigger+outcome:subscribe
  &code_challenge=<pkce_challenge>
  &code_challenge_method=S256
  &state=<csrf_token>

→ 302 → <your_redirect_uri>?code=<auth_code>&state=<csrf_token>

// @coyl/pap-sdk — Propose a proactive intervention (Node.js)
import { COYL } from '@coyl/pap-sdk'

const coyl = new COYL({
  apiKey: process.env.COYL_API_KEY!,
  llmId: 'anthropic-claude-sonnet-3.7',
})

const proposal = await coyl.proposal.create({
  userId: 'u_xyz',
  scopeRequested: ['proactive_food'],
  action: {
    kind: 'interrupt',
    mode: 'high_arousal',
    headline: 'Stop. Hand on the counter. 4 breaths.',
    subhead: '9:47 PM. You said no food after 9.',
  },
  context: {
    trigger: 'danger_window_active:late_night_kitchen',
    confidence: 0.84,
    reasoning: 'HRV dropped 22pts in 90min + sedentary 105min + geofence:kitchen + active commitment:no_food_after_9',
  },
})

if (proposal.decision === 'allowed') {
  // PAP coordinator will fire via the user's preferred modality.
  // Subscribe to the outcome webhook to learn whether the user
  // caught themselves, deferred, or ignored.
}

// @coyl/eap-sdk — Request a single action on a specific device
import { COYL } from '@coyl/eap-sdk'

const coyl = new COYL({
  apiKey: process.env.COYL_API_KEY!,
  llmId: 'anthropic-claude-sonnet-3.7',
})

const action = await coyl.action.request({
  userId: 'u_xyz',
  deviceId: 'watch-series-9-def',
  actuator: 'haptic',
  params: { pattern: 'double-tap' },
  scopeRequested: 'edge:watch:haptic',
  reasoning: 'HRV spike + active danger window',
  confidence: 0.83,
})

if (action.decision === 'allowed') {
  // The user's Watch coordinator will fire the haptic.
  // Outcome arrives via your subscribed webhook.
}

// Multi-device orchestration — one user-facing moment, three devices
const orchestration = await coyl.orchestration.create({
  userId: 'u_xyz',
  atomicity: 'all_or_none',
  steps: [
    {
      deviceId: 'watch-series-9-def',
      actuator: 'haptic',
      params: { pattern: 'double-tap' },
      atOffsetMs: 0,
    },
    {
      deviceId: 'iphone-15-pro-abc',
      actuator: 'voice_tts',
      params: { text: 'Stop. Hand on the counter. 4 breaths.' },
      atOffsetMs: 200,
    },
    {
      deviceId: 'macbook-pro-ghi',
      actuator: 'system_dim_screen',
      params: { brightnessPct: 30, durationSec: 60 },
      atOffsetMs: 200,
    },
  ],
})
// atomicity: 'all_or_none' — composite is denied if any step is denied.
// Use 'best_effort' for independent step evaluation.

# Issue a standing grant under UAP v0.1
curl -X POST https://coyl.ai/api/uap/v1/grant \
  -H "Authorization: Bearer coyl_uap_<partner_id>_<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "u_2sj8xks0a",
    "scopes": ["calendar.write", "messaging.routine"],
    "expires_at": "2026-05-29T17:00:00Z",
    "rules": [
      { "kind": "spending_cap", "max_per_action_usd": 50 },
      { "kind": "quiet_hours", "from": "00:00", "to": "07:00", "tz": "America/Los_Angeles" }
    ],
    "consent_artifact": {
      "version": "0.1",
      "shown_to_user_at": "2026-05-22T16:58:00Z",
      "user_response": "explicit_grant",
      "ui_surface": "settings.standing_authority"
    }
  }'

# Reference coordinators — open-source, per-platform
git clone https://github.com/coyl/eap-coordinator-reference

# Each platform ships its own implementation:
#   ios/        — Native app extension + App Intents
#   macos/      — Menu bar app + AppleScript + Shortcuts
#   watchos/    — Watch app + WatchConnectivity
#   android/    — Tasker + custom Service
#   wearos/     — Watch app
#   chrome/     — WebExtension (also Edge, Firefox)
#   safari/     — Safari Extension

# Fork + extend for your hardware. Reach out and we'll
# RFC the manifest schema for your device class.