Developer reference · v1

MMS Edge API and SDK

A server-authoritative interface for Persistent Tasks and policy-delegated execution. Authentication comes from the current MMS account session; SDK callers never provide an account ID or embed provider secrets.

Download SDK source contractBack to overview

Canonical contract

Platform
MMS Edge Agent Platform (MEP)
API
MMS Edge API
Base path
/v1/edge/
Persistent resource
/v1/edge/persistask
Wire protocol
mms-edge-sdk/v1
Policy contract
MEP Policy-Delegated Execution

Security requirements

  • HTTPS only; redirects rejected.
  • Short-lived MMS account session supplied by the host.
  • X-MMS-Consumer bound to AI Life, AI Business or Persistask Windows.
  • All mutations require an idempotency key.
  • User input is never treated as permission to execute.
  • Secrets, account IDs and full private page content are excluded from public projections.
SDK start

Create an authenticated client

import { createPersistaskClient } from '@mms/edge-sdk';

const persistask = createPersistaskClient({
  baseUrl: 'https://<approved-mep-host>',
  consumer: 'ai_life',
  getAccessToken: () => currentMmsSession(),
});

const tasks = await persistask.listTasks();

Do not place OpenAI, Browserless, payment, hotel, airline or broker credentials in a client app. Provider custody belongs to the approved server environment.

Resources

Persistask endpoints

MethodPathPurpose
GET/tasksList current-account task projections
GET/tasks/:idRead one versioned task
POST/tasksCreate a task through server policy
GET/policiesList delegated policies
POST/policiesIssue a bounded policy
POST/policies/:id/renewRenew with fresh user authority
POST/policies/:id/revokeStop future execution
GET/devicesList enrolled execution devices
POST/devices/enrollEnroll after passkey verification
GET/actionsReview external-action outcomes
GET/eventsRead bounded audit events
GET/notificationsRead milestones and required decisions
Availability

Release status is evidence-based

The API above is the reviewed canonical contract, not an anonymous public endpoint. The current live MEP pilot exposes only its approved owner-scoped Nova Persistent Task surface. General Persistask API activation, Windows/macOS bridge execution, AI Stay effects and Nova Tickets purchase effects remain independently gated.

Machine-readable release status →