commerce://catalog/categories     # Product categories
commerce://store/info             # Store information
file:///path/to/config.json       # Local file
https://api.example.com/data      # Remote data

{
  "uriTemplate": "commerce://products/{sku}",
  "name": "Product Details",
  "description": "Get detailed information for a specific product by SKU",
  "mimeType": "application/json"
}

commerce://products/{sku}              # Single product
commerce://orders/{orderId}/items      # Order line items
commerce://categories/{categoryId}     # Category details
commerce://inventory/{sku}/{warehouse} # Inventory for a specific warehouse

{
  "method": "resources/read",
  "params": {
    "uri": "commerce://products/SHOE-001"
  }
}

{
  "uri": "commerce://catalog/categories",
  "name": "Product Categories",
  "description": "Complete product category hierarchy",
  "mimeType": "application/json",
  "annotations": {
    "audience": ["user", "assistant"],
    "priority": 0.8,
    "lastModified": "2026-04-10T08:00:00Z"
  }
}

// Client -> Server: subscribe to resource
{
  "method": "resources/subscribe",
  "params": { "uri": "commerce://inventory/SHOE-001" }
}

// Server -> Client: resource content change notification
{
  "method": "notifications/resources/updated",
  "params": { "uri": "commerce://inventory/SHOE-001" }
}

{
  "method": "resources/unsubscribe",
  "params": { "uri": "commerce://inventory/SHOE-001" }
}

{ "method": "notifications/resources/list_changed" }

// Static resource
server.resource(
  "commerce://catalog/categories",
  "Product Categories",
  "application/json",
  async () => {
    const categories = await db.categories.getAll();
    return JSON.stringify(categories, null, 2);
  }
);

// Dynamic resource (URI template)
server.resource(
  "commerce://products/{sku}",
  "Product Details",
  "application/json",
  async (uri) => {
    const sku = uri.pathname.split("/").pop();
    const product = await db.products.findBySku(sku);
    if (!product) throw new Error(`Product ${sku} not found`);
    return JSON.stringify(product, null, 2);
  }
);

{
  "name": "product_comparison",
  "description": "Compare the pros and cons of two products",
  "arguments": [
    { "name": "product1", "description": "First product SKU", "required": true },
    { "name": "product2", "description": "Second product SKU", "required": true },
    { "name": "focus", "description": "Focus dimension (price/performance/reviews)", "required": false }
  ]
}

// Client -> Server
{
  "method": "prompts/get",
  "params": {
    "name": "product_comparison",
    "arguments": {
      "product1": "SHOE-001",
      "product2": "SHOE-002",
      "focus": "value for money"
    }
  }
}

// Server -> Client
{
  "result": {
    "messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "Please compare the following products from a value-for-money perspective:\n\nProduct 1: Nike Air Max (SHOE-001) - $89.90\nProduct 2: Adidas Ultra Boost (SHOE-002) - $129.90\n\nAnalyze the pros and cons of each and provide a purchase recommendation."
        }
      }
    ]
  }
}

// Product comparison
server.prompt(
  "product_comparison",
  "Compare the pros and cons of two products",
  [
    { name: "product1", description: "First product SKU", required: true },
    { name: "product2", description: "Second product SKU", required: true }
  ],
  async ({ product1, product2 }) => {
    const p1 = await db.products.findBySku(product1);
    const p2 = await db.products.findBySku(product2);
    return {
      messages: [{
        role: "user",
        content: {
          type: "text",
          text: `Please compare the following two products:\n\nProduct 1: ${JSON.stringify(p1)}\n\nProduct 2: ${JSON.stringify(p2)}\n\nAnalyze from three dimensions: price, features, and reviews.`
        }
      }]
    };
  }
);

// Order summary
server.prompt(
  "order_summary",
  "Generate a summary report of a user's orders",
  [
    { name: "userId", description: "User ID", required: true },
    { name: "period", description: "Time range (e.g. last_month)", required: false }
  ],
  async ({ userId, period = "last_month" }) => {
    const orders = await db.orders.getByUser(userId, period);
    return {
      messages: [{
        role: "user",
        content: {
          type: "text",
          text: `Here is the user's recent order data:\n\n${JSON.stringify(orders, null, 2)}\n\nPlease generate a concise spending summary including total spending, frequently purchased categories, and spending trends.`
        }
      }]
    };
  }
);

server.prompt(
  "customer_service",
  "Activate customer service assistant mode",
  [],
  async () => {
    const policies = await db.policies.getAll();
    return {
      messages: [
        {
          role: "assistant",
          content: {
            type: "text",
            text: `You are a professional customer service assistant. Here are the store policies:\n\n${JSON.stringify(policies)}\n\nAlways answer user questions based on these policies.`
          }
        }
      ]
    };
  }
);

server.prompt(
  "analyze_catalog",
  "Analyze the product catalog structure",
  [],
  async () => {
    return {
      messages: [{
        role: "user",
        content: {
          type: "resource",
          resource: {
            uri: "commerce://catalog/categories",
            mimeType: "application/json",
            text: await db.categories.getJsonString()
          }
        }
      }]
    };
  }
);