merchant-stock-rescue.vercel.app

{
  "name": "inventory.search_network_stock",
  "kind": "answer",
  "impl": "imperative",
  "description": "Find nearby merchants with enough available inventory for a product and quantity. Returns deterministic candidates ranked by price, distance, pickup time, and reliability.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Product name, partial name, or exact product ID.",
        "minLength": 1,
        "maxLength": 100
      },
      "quantity": {
        "type": "integer",
        "description": "Number of units; must be a positive whole number.",
        "minimum": 1,
        "maximum": 10000
      }
    },
    "required": [
      "query",
      "quantity"
    ],
    "additionalProperties": false
  }
}

{
  "name": "inventory.get_source_details",
  "kind": "answer",
  "impl": "imperative",
  "description": "Inspect current stock, price, pickup time, distance, and reliability for one merchant-product source before preparing a transfer.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "merchantId": {
        "type": "string",
        "description": "Source merchant ID from a network stock result.",
        "minLength": 1,
        "maxLength": 128
      },
      "productId": {
        "type": "string",
        "description": "Product ID from a network stock result.",
        "minLength": 1,
        "maxLength": 128
      }
    },
    "required": [
      "merchantId",
      "productId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "inventory.prepare_transfer",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a pending transfer proposal for the visible merchant UI. This does not reserve or change inventory; a human must approve before commit.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sourceMerchantId": {
        "type": "string",
        "description": "Merchant supplying the inventory.",
        "minLength": 1,
        "maxLength": 128
      },
      "destinationMerchantId": {
        "type": "string",
        "description": "Merchant receiving the inventory.",
        "minLength": 1,
        "maxLength": 128
      },
      "productId": {
        "type": "string",
        "description": "Product to transfer.",
        "minLength": 1,
        "maxLength": 128
      },
      "quantity": {
        "type": "integer",
        "description": "Number of units; must be a positive whole number.",
        "minimum": 1,
        "maximum": 10000
      }
    },
    "required": [
      "sourceMerchantId",
      "destinationMerchantId",
      "productId",
      "quantity"
    ],
    "additionalProperties": false
  }
}

{
  "name": "inventory.commit_transfer",
  "kind": "act",
  "impl": "imperative",
  "description": "Commit a transfer only after its matching visible proposal was explicitly approved by a human. Decrements source stock once and returns an audit receipt.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "transferId": {
        "type": "string",
        "description": "Approved transfer ID returned by prepare_transfer.",
        "minLength": 1,
        "maxLength": 128
      }
    },
    "required": [
      "transferId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "inventory.get_transfer_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read a transfer's product, source, destination, quantity, approval flag, current state, and transaction ID when committed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "transferId": {
        "type": "string",
        "description": "Transfer ID to verify.",
        "minLength": 1,
        "maxLength": 128
      }
    },
    "required": [
      "transferId"
    ],
    "additionalProperties": false
  }
}