From b8a20d7ce7f8a7f73ab110e4f2aaef8b6aabac3b Mon Sep 17 00:00:00 2001
From: tela <tela.andrews@localstack.cloud>
Date: Thu, 12 Nov 2026 08:52:05 -0800
Subject: [PATCH] docs(acme): declare vendor emulators in emulators.lock

Lists Stripe, Plaid and Xero as emulated, with the emulator build
each is pinned to. API versions are unknown: the demo calls the
vendors over plain HTTP and sets none. AGENTS.md tells agents to use
the declared emulator instead of mocking.
---
 AGENTS.md      |  7 +++++++
 emulators.lock | 38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 emulators.lock

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..49f555c
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# AGENTS.md
+
+## Application emulators
+
+This repo declares application emulators in `emulators.lock`. Before mocking
+any dependency listed there with `emulated = true`, use the declared emulator
+instead. Each entry's `capabilities_ref` says what that emulator covers.
diff --git a/emulators.lock b/emulators.lock
new file mode 100644
index 0000000..7850d99
--- /dev/null
+++ b/emulators.lock
@@ -0,0 +1,38 @@
+[[dependencies]]
+name = "stripe"
+ecosystem = "none"
+manifest = "none"
+detected_in = "demos/acme-commerce-lenders/world/seed.go"
+emulated = true
+
+[dependencies.emulator]
+vendor = "stripe"
+api_version = "unknown"
+capabilities_ref = "https://wondertwin.dev/stripe"
+emulator_build = "d151d8831bc6"
+
+[[dependencies]]
+name = "plaid"
+ecosystem = "none"
+manifest = "none"
+detected_in = "demos/acme-commerce-lenders/world/seed.go"
+emulated = true
+
+[dependencies.emulator]
+vendor = "plaid"
+api_version = "unknown"
+capabilities_ref = "https://wondertwin.dev/plaid"
+emulator_build = "ca9fea68d873"
+
+[[dependencies]]
+name = "xero"
+ecosystem = "none"
+manifest = "none"
+detected_in = "demos/acme-commerce-lenders/world/seed.go"
+emulated = true
+
+[dependencies.emulator]
+vendor = "xero"
+api_version = "unknown"
+capabilities_ref = "https://wondertwin.dev/xero"
+emulator_build = "b24aeed25cff"