How harshdubey23/sellable works
SELLABLE lets a user authorize a bounded shopping mission, then lets an AI agent propose products without specifying price or payee. The server prices proposals from its catalog and the deterministic gateway rejects or approves them; approval is bound to the exact cart before durable payment execution. The README documents recovery and audit guarantees. The map also retains discovery, negotiation, growth, and web-facing capabilities represented in the source tree. Some subsystem internals were not sampled, so uncertain connections are omitted.
Main entry points: engine.py Policy Gateway · chain.py Audit Chain · products.py Product Catalog · execution.py Execution Machine
Components 22
Shopping Experience
- Buyer Agent
apps/api/agent/buyer.py - Market Discovery
apps/api/discovery/pipeline.py - Product Catalog
apps/api/products.py - Negotiation Engine
apps/api/negotiation/engine.py
Safety Control
- Signed Mission
apps/api/missions.py - Policy Gateway
apps/api/gateway/engine.py - Approval Binding
apps/api/approval.py - User Mandates
apps/api/mandates/mandates.py - Audit Chain
apps/api/audit/chain.py - Application Store
apps/api/store/db.py - Chaos Evaluator
apps/api/chaos/engine.py
Payment Lifecycle
- Execution Machine
apps/api/execution.py - Payment Provider
apps/api/execution_provider.py - Razorpay
apps/api/razorpay_client.py - Payment Recovery
apps/api/recovery/engine.py - Webhook Receiver
apps/api/webhook/receiver.py
Commerce Intelligence
- Growth Engine
apps/api/growth/engine.py - Growth Intelligence
apps/api/growth/intelligence.py
Interfaces
- MCP Server
mcp_server/server.py - MCP State
mcp_server/store.py - Commerce Web UI
apps/api/web/product_page.py
Other components
- User
Connections 25
- User → MCP Server: submits shopping request
- User → Signed Mission: signs budget
- MCP Server → Product Catalog: searches products
mcp_server/server.py - MCP Server → Policy Gateway: evaluates proposal
mcp_server/server.py - MCP Server → MCP State: reads and records state
mcp_server/server.py - MCP State → Policy Gateway: verifies mission
mcp_server/store.py - Buyer Agent → Policy Gateway: proposes SKU and quantity
- Market Discovery → Buyer Agent: provides market evidence
- Market Discovery → Product Catalog: uses catalog data
apps/api/discovery/pipeline.py - Policy Gateway → Product Catalog: checks server prices
apps/api/gateway/engine.py - Policy Gateway → Approval Binding: approves exact proposal
- Approval Binding → Execution Machine: authorizes execution
- User Mandates → Approval Binding: co-signs cart
- Execution Machine → Payment Provider: dispatches payment
- Payment Provider → Razorpay: creates provider order
- Execution Machine → Payment Recovery: reconciles uncertain result
apps/api/recovery/engine.py - Razorpay → Webhook Receiver: sends signed event
- Policy Gateway → Audit Chain: records verdict
- Execution Machine → Audit Chain: records execution
- Audit Chain → Application Store: persists chain entries
apps/api/audit/chain.py - Commerce Web UI → Product Catalog: displays products
- Negotiation Engine → Audit Chain: chains offers
apps/api/negotiation/engine.py - Growth Engine → Growth Intelligence: uses growth analysis
apps/api/growth/engine.py - Growth Engine → Product Catalog: uses product data
apps/api/growth/engine.py - Chaos Evaluator → Audit Chain: checks recorded events
apps/api/chaos/engine.py