{"id":"a0f340d2-0e4d-4206-a286-b0a46ca41276","entityType":"agent","slug":"hanzoskill-agent-commerce-engine","name":"standard-agentic-commerce-engine","canonicalUrl":"https://www.xpersona.co/agent/hanzoskill-agent-commerce-engine","canonicalPath":"/agent/hanzoskill-agent-commerce-engine","generatedAt":"2026-10-09T04:12:59.661Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management. --- name: standard-agentic-commerce-engine version: 1.2.3 description: A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management. tags: [ecommerce, shopping-agent, commerce-engine, standard-protoco","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/hanzoskill/agent-commerce-engine.git","sourceUrl":"https://github.com/hanzoskill/agent-commerce-engine","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/hanzoskill/agent-commerce-engine","kind":"source"}],"safetyScore":94,"overallRank":29.7,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend throug"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"incrementing","status":"self-declared"},{"label":"data","status":"self-declared"},{"label":"channels","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":4,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"incrementing","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"data","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"channels","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:incrementing|supported|profile capability:data|supported|profile capability:channels|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-04-15T02:13:01.393Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-04-15T02:13:01.393Z","lastIndexedAt":null,"nextCrawlAt":"2026-04-16T02:13:01.393Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"git clone https://github.com/hanzoskill/agent-commerce-engine.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T04:12:59.661Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/hanzoskill-agent-commerce-engine/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: standard-agentic-commerce-engine\nversion: 1.2.3\ndescription: A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management.\ntags: [ecommerce, shopping-agent, commerce-engine, standard-protocol, headless-commerce, agentic-web]\n---\n\n# Standard Agentic Commerce Engine\n\nThe **Standard Agentic Commerce Engine** is a production-ready bridge connecting autonomous agents with modern e-commerce backends. By providing a unified, high-precision interface, it allows any digital storefront to become \"Agent-Native\" instantly.\n\nGitHub Repository: https://github.com/NowLoadY/agent-commerce-engine\n\n## Reference Case: Lafeitu\n\nFor a production-grade implementation example using this engine, see the [Lafeitu Gourmet Skill](https://skills.com/NowLoadY/agentic-spicy-food). It demonstrates the engine specialized for a real-world artisanal food brand.\n\n---\n\n## 🛠 Tool Priority & Fallback Strategy\n\nTo provide the most accurate and efficient experience, follow this priority sequence:\n\n1.  **API First (Primary)**: Always attempt to use the `commerce.py` script first. It provides structured, high-precision data. Configure it via environment variables (`COMMERCE_URL`).\n2.  **Stateless Headers**: Rely on the engine's built-in header management (`x-user-account`, `x-visitor-id`) to maintain session integrity without cookies.\n3.  **Self-Correction**: If the API returns a 404 for a specific slug discovered via browser, prioritize the API's `search` results as the source of truth for the backend.\n\n---\n\n## 🧠 Agent Operational Logic\n\nFollow these logical flows to ensure a high-quality user experience:\n\n### 1. Product Discovery & Validation\n**Goal**: Ensure the item exists and find the correct specifications before taking action.\n- **Action**: Always run `search` or `list` before adding to cart.\n- **Logic**: Use the API to discover the correct `slug` and valid `gram`/variant values. \n- **Refinement**: If multiple results are found, ask the user to specify based on the returned attributes.\n\n### 2. Authentication & Profile Flow\n**Goal**: Manage user privacy and session data.\n- **Logic**: The API is stateless. Actions requiring identity will return `401 Unauthorized` if credentials aren't saved.\n- **Commands**:\n    1. View profile: `python3 scripts/commerce.py get-profile`\n    2. Update details: `python3 scripts/commerce.py update-profile --name \"Name\" --address \"...\"`\n- **Required Data**: Respect the schema of the specific brand's backend.\n\n### 3. Registration Flow\n**Goal**: Handle new users.\n- **Trigger**: When an action returns \"User Not Found\".\n- **Instruction**: Guide the user to the store's registration URL (often found in brand metadata).\n\n### 4. Shopping Cart Management\n**Goal**: Precise modification of the user's shopping session.\n- **Logic**: The engine supports incrementing quantities or setting absolute values.\n- **Commands**:\n    - **Add**: `python3 scripts/commerce.py add-cart <slug> --gram <G> --quantity <Q>`\n    - **Update**: `python3 scripts/commerce.py update-cart <slug> --gram <G> --quantity <Q>`\n    - **Remove**: `python3 scripts/commerce.py remove-cart <slug> --gram <G>`\n- **Validation**: Gram/variant values must be strictly chosen from the product's available options list.\n\n### 5. Brand Information & Storytelling\n**Goal**: Access brand identity and support data.\n- **Logic**: Use the `brand-info` interface to retrieve narrative content.\n- **Tooling**:\n    - `python3 scripts/commerce.py brand-story`: Get the narrative/mission.\n    - `python3 scripts/commerce.py company-info`: Get formal details.\n    - `python3 scripts/commerce.py contact-info`: Get customer support channels.\n\n---\n\n## 🚀 Capabilities Summary\n\n- **`search` / `list`**: Product discovery and inventory scan.\n- **`get`**: Deep dive into product specifications, variants, and pricing.\n- **`promotions`**: Current business rules, shipping thresholds, and active offers.\n- **`cart`**: Complete session summary including VIP discounts and tax/shipping estimates.\n- **`add-cart` / `update-cart` / `remove-cart`**: Atomic cart control.\n- **`get-profile` / `update-profile`**: Personalization and fulfillment data.\n- **`brand-story` / `company-info` / `contact-info`**: Brand context and support.\n- **`orders`**: Real-time tracking and purchase history.\n\n---\n\n## 💻 CLI Configuration & Examples\n\n```bash\n# Setup\nexport COMMERCE_URL=\"https://api.yourbrand.com/v1\"\nexport COMMERCE_BRAND_ID=\"brand_slug\"\n\n# Actions\npython3 scripts/commerce.py list\npython3 scripts/commerce.py search \"item\"\npython3 scripts/commerce.py get <slug>\npython3 scripts/commerce.py add-cart <slug> --gram <variant>\n```\n\n---\n\n## 🤖 Troubleshooting & Debugging\n\n- **Status Code 401**: Credentials missing or expired. Recommend `login`.\n- **Status Code 404**: Resource not found. Verify `slug` via `search`.\n- **Connection Error**: Verify `COMMERCE_URL` environment variable is correct and the endpoint is reachable.\n","readmeExcerpt":"--- name: standard-agentic-commerce-engine version: 1.2.3 description: A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management. tags: [ecommerce, shopping-agent, commerce-engine, standard-protoco","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Setup\nexport COMMERCE_URL=\"https://api.yourbrand.com/v1\"\nexport COMMERCE_BRAND_ID=\"brand_slug\"\n\n# Actions\npython3 scripts/commerce.py list\npython3 scripts/commerce.py search \"item\"\npython3 scripts/commerce.py get <slug>\npython3 scripts/commerce.py add-cart <slug> --gram <variant>"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management. --- name: standard-agentic-commerce-engine version: 1.2.3 description: A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management. tags: [ecommerce, shopping-agent, commerce-engine, standard-protoco","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":416,"uniquenessScore":58,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T04:12:59.661Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}