paqly.netlify.app

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 60,
      "items": {
        "type": "object",
        "properties": {
          "item": {
            "type": "string",
            "minLength": 1,
            "description": "Existing item id or exact/current name."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Specific real object name, such as T-shirt, running shoes, or Steam Deck."
          },
          "width_cm": {
            "type": "number",
            "minimum": 2,
            "maximum": 95,
            "description": "Natural packed width in cm. Required for an item not in the Paqly catalogue."
          },
          "height_cm": {
            "type": "number",
            "minimum": 0.5,
            "maximum": 80,
            "description": "Natural packed thickness/height in cm. Required for an item not in the Paqly catalogue."
          },
          "depth_cm": {
            "type": "number",
            "minimum": 2,
            "maximum": 95,
            "description": "Natural packed depth in cm. Required for an item not in the Paqly catalogue."
          },
          "material_profile": {
            "type": "string",
            "enum": [
              "rigid",
              "semi_rigid",
              "denim",
              "soft_cotton",
              "elastic_smalls",
              "knit",
              "lofted",
              "padded_tech"
            ],
            "description": "Physical material class. Required for an item not in the Paqly catalogue."
          },
          "softness": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "0 is rigid and 1 is very soft."
          },
          "max_compression_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 40,
            "description": "Physical compression ceiling. Never exceed 40."
          },
          "mass_kg": {
            "type": "number",
            "minimum": 0.02,
            "maximum": 25,
            "description": "Plausible packed mass in kilograms."
          },
          "fragile": {
            "type": "boolean",
            "description": "Whether this item should avoid carrying load."
          },
          "access_priority": {
            "type": "string",
            "enum": [
              "deep",
              "normal",
              "easy"
            ],
            "description": "Easy items are biased toward the top/front."
          },
          "best_orientation": {
            "type": "string",
            "enum": [
              "flat",
              "upright",
              "side",
              "any"
            ],
            "description": "Preferred safe packing orientation."
          },
          "dimension_source": {
            "type": "string",
            "enum": [
              "catalogue",
              "agent_estimate",
              "user"
            ],
            "description": "Use agent_estimate when you infer dimensions for an unknown item."
          }
        },
        "required": [
          "item"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}