{ "ok": true, "manifest": { "meta": { "schema_version": "1.0.0", "generator": "Recio Sovereign Commerce Engine", "protocol": "Protocol 752 Compliant", "timestamp": "2026-11-02 12:09:07", "tenant": "default", "api_gateway": "https://recio.shop/api/anna.php", "context_manifest": "https://recio.shop/api/context.php", "auth_spec": "Pass Sovereign Agent Key via Authorization Bearer, X-Agent-Key header, X-Shop-Key header, or agent_key / shop_key JSON property." }, "store": { "name": "My Shop", "tagline": "Quality products, fast doorstep delivery.", "location": "", "phone": "", "email": "", "status": "OPEN", "delivery_fee": 0, "currency": "NGN", "currency_symbol": "₦", "order_method": "Direct WhatsApp Dispatch", "store_hours": "Monday – Saturday: 8:00 AM – 9:00 PM\nSunday: 10:00 AM – 6:00 PM", "bank_settlement": { "bank_name": "", "account_number": "", "account_name": "", "formatted": "", "accepted_methods": [ "Direct Bank Transfer" ], "deposit_reference": "Customer must enter exact full name as payment reference for automated reconciliation" }, "nipost_digital_anchor": { "code": "", "state": "", "lga": "", "district": "", "area": "", "building": "", "verification_portal": "https://postcode.gov.ng" }, "contact_and_social_channels": [], "policies": { "terms_of_service": "", "privacy_policy": "", "return_policy": "", "faq": "" } }, "catalog": { "total_products": 0, "in_stock_count": 0, "categories": [], "items": [] }, "banners": { "active_count": 0, "slides": [] }, "agent_protocol": { "tool_definitions": [ { "name": "create_order", "role": "customer", "auth_required": false, "description": "Creates a customer order, reserves catalog inventory, generates an authentic GM-xxxx Order Code and a TRK-xxxxxxxx Unique Tracking ID, and dispatches direct notification emails.", "parameters": { "type": "object", "required": [ "customer_name", "customer_phone", "items", "total_amount", "delivery_address" ], "properties": { "customer_name": { "type": "string", "description": "Full name of the customer placing the order." }, "customer_phone": { "type": "string", "description": "Valid phone number for delivery dispatch and verification." }, "customer_email": { "type": "string", "description": "Optional customer email address for order receipts." }, "items": { "type": "string", "description": "Items ordered with quantities, e.g. \"Classic Cotton Shirt x 1, Denim Jacket x 1\"." }, "total_amount": { "type": "integer", "description": "Total order sum in NGN (including products and delivery fee)." }, "delivery_address": { "type": "string", "description": "Physical drop-off address for rider delivery." }, "nipost_code": { "type": "string", "description": "Optional NIPOST digital postcode (e.g. \"101233\" or \"LA 04 B12 LK 08\")." }, "notes": { "type": "string", "description": "Special handling or gate access instructions." } } } }, { "name": "track_order", "role": "customer", "auth_required": false, "description": "Queries live order fulfillment state, delivery timeline, and chat thread by Unique Tracking ID (TRK-...) or Order Code (GM-...). Requires ONLY Tracking ID or Order Code — no customer name or personal details.", "parameters": { "type": "object", "required": [ "identifier" ], "properties": { "identifier": { "type": "string", "description": "The Unique Tracking ID (TRK-xxxxxxxx) or Order Code (GM-xxxx)." } } } }, { "name": "confirm_payment", "role": "customer_or_admin", "auth_required": false, "description": "Customer reporting a completed bank transfer deposit under their name, or Admin confirming received payment.", "parameters": { "type": "object", "required": [ "order_code" ], "properties": { "order_code": { "type": "string", "description": "The Order Code (e.g. \"GM-5201\")." } } } }, { "name": "inquire_catalog", "role": "customer_or_admin", "auth_required": false, "description": "Filters or searches the store catalog for specific products, categories, or price limits.", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Product title or keyword search." }, "category": { "type": "string", "description": "Category filter." }, "max_price": { "type": "integer", "description": "Maximum price in NGN." } } } }, { "name": "update_stock", "role": "admin", "auth_required": true, "description": "Store administrator reflex to restock inventory or set stock count for a specific SKU or Product ID.", "parameters": { "type": "object", "required": [ "product_id", "stock" ], "properties": { "product_id": { "type": "string", "description": "Product ID or SKU (e.g. \"gm-001\")." }, "stock": { "type": "integer", "description": "New total quantity in stock." } } } }, { "name": "update_store_settings", "role": "admin", "auth_required": true, "description": "Store administrator reflex to update delivery fee, opening status, phone, or location.", "parameters": { "type": "object", "properties": { "delivery_fee": { "type": "integer", "description": "Flat dispatch fee in NGN." }, "store_open": { "type": "integer", "description": "1 for open / taking orders, 0 for paused / closed." }, "phone": { "type": "string", "description": "Store contact phone number." }, "location": { "type": "string", "description": "Physical store anchor location." }, "tagline": { "type": "string", "description": "Storefront tagline." } } } } ], "reply_standards": { "protocol_version": "1.0", "zero_emojis_mandate": "Strict Protocol 752 compliance: AI agents MUST NEVER output emojis in order summaries, receipts, or customer dialogue.", "agent_profiles": { "customer_agent": { "type": "buyer", "auth_required": false, "description": "External shopper or autonomous purchasing agent buying products, inquiring on stock/price, or tracking deliveries.", "allowed_tools": [ "inquire_catalog", "create_order", "track_order", "confirm_payment" ], "tracking_inquiry_rule": "When inquiring or tracking an order, Anna and customer agents MUST solicit ONLY the Unique Tracking ID (TRK-xxxxxxxx) or Order Code (GM-xxxx). NEVER ask for user names, emails, or personal details.", "reply_style": "Sovereign retail concierge, polite, helpful, strictly 0 emojis (Protocol 752)." }, "admin_agent": { "type": "operator", "auth_required": true, "auth_method": "Pass Sovereign Agent Key via X-Agent-Key header, X-Shop-Key header, Authorization: Bearer, or agent_key parameter.", "description": "Personal agent, work agent, store operator, or autonomous automation authorized to restock, edit pricing, change store settings, or progress order fulfillment via HTTPS tool requests.", "allowed_tools": [ "update_stock", "update_store_settings", "update_product", "archive_product", "delete_product", "update_order_status", "mark_shipped", "mark_delivered", "cancel_order", "get_api_keys", "create_api_key", "revoke_api_key" ], "reply_style": "Crisp operational acknowledgment confirming state transitions (prior-vs-new values), strictly 0 emojis (Protocol 752)." } }, "order_creation_response": { "required_fields": { "order_code": "Format: GM-xxxx", "tracking_id": "Format: TRK-xxxxxxxx", "items_summary": "Itemized breakdown with line prices", "subtotal_and_total": "Amounts formatted in NGN with ₦ symbol", "bank_settlement": { "bank_name": "", "account_number": "", "account_name": "", "payment_instructions": "Important: When transferring, you MUST use the exact customer name used in creating this order ({customer_name}) as your transfer description or account reference for instant verification.", "reference_rule": "Customer must enter their exact full name as the transfer reference description" }, "receipt_link": "https://recio.shop/receipt.php?code={ORDER_CODE}", "live_chat_link": "https://recio.shop/shopfront.php?track={TRACKING_ID}" }, "template_example": "Order {ORDER_CODE} recorded for {CUSTOMER_NAME}.\nItems: {ITEMS}\nTotal Amount Due: ₦{TOTAL_AMOUNT}\n\nPayment Settlement Details:\nBank: \nAccount Number: \nAccount Name: \n\nImportant: Use '{CUSTOMER_NAME}' as your transfer reference description.\nTrack order: https://recio.shop/shopfront.php?track={TRACKING_ID}\nView receipt: https://recio.shop/receipt.php?code={ORDER_CODE}" }, "order_tracking_response": { "tracking_id_rule": "Anna requests ONLY the Tracking ID (TRK-...) or Order ID (e.g. ORD-...). Never customer name or email.", "required_fields": { "order_code": "Format: ORD-xxxx or Store Prefix", "tracking_id": "Format: TRK-xxxxxxxx", "status": "PAYMENT_PENDING | AWAITING_PAYMENT_CONFIRM | CONFIRMED | SHIPPED | DELIVERED | CANCELLED", "status_label": "Human readable lifecycle stage", "anna_update": "Latest message from Anna Concierge", "courier_state": "Courier transit notes if SHIPPED or DELIVERED" } }, "catalog_query_response": { "format": "Concise plain-text listing with Product Title, Unit Price in ₦, Stock Availability (In Stock / Out of Stock), and SKU." }, "admin_stock_update_response": { "required_fields": [ "action", "product_id", "sku", "previous_stock", "new_stock", "in_stock" ], "template_example": "Stock for {PRODUCT_TITLE} ({SKU}) updated from {OLD_STOCK} to {NEW_STOCK} units. Catalog status: {STATUS}." }, "admin_settings_update_response": { "required_fields": [ "action", "updated_fields", "store_status", "delivery_fee" ], "template_example": "Store settings updated successfully. Status: {STORE_STATUS}, Flat Delivery Fee: ₦{DELIVERY_FEE}." }, "admin_order_lifecycle_response": { "required_fields": [ "action", "order_code", "previous_status", "new_status", "customer_notified" ], "template_example": "Order {ORDER_CODE} transitioned from {OLD_STATUS} to {NEW_STATUS}. Customer thread notified." }, "admin_unauthorized_response": { "status_code": 401, "required_fields": [ "ok", "error", "role_required" ], "template_example": "{\"ok\": false, \"error\": \"Sovereign Shop Key required for administrative actions. Pass via X-Shop-Key header, Authorization Bearer, or shop_key parameter.\", \"role_required\": \"admin\"}" } } } } }