VEYNDO
Handbook
extensions/apps/assistant-examples/README.mdView source ↗

English source · 2 min

Guided app contracts

These are installable Manifest examples generated by App Studio's shared assistant model. They contain no secrets. Import through Developers, save a version and install it into a private sandbox. See guide and security contracts.

File Purpose
frontend.json Public product-detail cards with an owned product reference and private editing tab.
admin.json New product editor tab with revision-bound fields.
combined.json Private product tab plus explicit public product-detail data.
product_general.json Additional section inside product general settings.
customer.json Private customer-bound fields and translated choice list.
order.json Private order-bound fields and choice list.
payment.json Native settings and external initiate/capture/refund contracts.
shipping.json Native settings and durable carrier-label job contract with explicit order/document/PII consent; version 0.1.1.
integration.json ERP-style synchronize service action and order events.
event.json External event consumer plus a Flow-enabled service action.
webhook.json Signed incoming webhook emits a typed event for rules/flows.
scheduled.json UTC scheduled emit task; requires no separate app timer process.
mcp-app.json Product Guide with separately admitted interactive customer and merchant chat views.

Payment/shipping/integration/event examples require an operator-deployed service configured through APP_SERVICES. They do not implement the provider. Webhooks require APP_WEBHOOK_KEYS. Cron and external ingress are disabled for private sandboxes; real behavior is verified in disposable live test shops by scripts/app_assistants.py. New examples default to MCP off, with explicit action team rights. Public customer/order references are forbidden.

Product Guide MCP App shows a public card view and a private merchant table in the corresponding conversation. Both use installed app data and explicit MCP read tools. Version 0.1.1 adds an indexed selection field for filtering inside the chat while retaining the original product criteria. Follow the Product Guide tutorial to install the package, prepare the two views and call them from a JavaScript host.