Skip to content

docs: two-layer Execute for embedders - #186

Open
abrichr wants to merge 1 commit into
mainfrom
docs/execute-two-layer-2026-08-30
Open

docs: two-layer Execute for embedders#186
abrichr wants to merge 1 commit into
mainfrom
docs/execute-two-layer-2026-08-30

Conversation

@abrichr

@abrichr abrichr commented Aug 30, 2026

Copy link
Copy Markdown
Member

Reader: an embedder wiring POST /v1/executions, and a reviewer checking the commercial Execute pages against openadapt.ai/pricing.

Execute is two layers. They share ExecuteRequestV1.

Hosted Execute is the easy path. https://app.openadapt.ai/api takes an org API key, runs on the customer runner by default, and returns an OpenAdapt-signed Seal. Price is $10 / 1,000 VERIFIED. Only VERIFIED bills.

The MIT reference is openadapt-flow serve-execute. One machine. Same schema. Receipts are self-signed, so they aren't an OpenAdapt production Seal. That command isn't on flow main yet; the page names it as the intended entry.

The JSON request, status, receipt, and webhook examples are unchanged.

Honesty: production still has EXECUTE_LANE_ENABLED=false. Cloud doesn't mint live keys. When the lane is on, the key comes from the Cloud dashboard. Hosted browser is Enterprise. This change does not put $15,000 or $500 Cloud on the Execute meter.

Please check:

  • docs/commercial/execute-api.md lead, auth, and the new Self-host section
  • docs/commercial/index.md and procurement-faq.md price rows
  • docs/commercial/oem-brief.md no longer reads as a private-pilot partner token

Opened by an agent session, not the founder.

Hosted Execute is the easy path: org API key, OpenAdapt-signed Seal,
customer runner, $10 / 1,000 VERIFIED. MIT reference is
openadapt-flow serve-execute (self-signed, not a production Seal).
Keep EXECUTE_LANE_ENABLED=false honesty until Cloud mints live keys.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant