plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6a23e2a3a95c819190fe9324aed7c0bc",
  "version": "3.2.0",
  "description": "Use AI to turn floor-plan images or dimensions into editable plans, test layouts and furniture, style rooms, and review ideas in 2D, 3D, or VR.",
  "author": {
    "name": "HZplan",
    "email": "support@hzplan.uk",
    "url": "https://hzplan.uk"
  },
  "homepage": "https://hzplan.uk",
  "keywords": [
    "floor-plans",
    "home-design",
    "architecture",
    "3d"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HZplan",
        "shortDescription": "AI-readable floor plans",
        "longDescription": "HZplan turns floor-plan images or written dimensions into structured, editable home plans your assistant can reason about. Use AI as a practical design partner to test ideas before you move or buy anything: check whether furniture fits, compare layouts, see how a Scandinavian style changes your bedroom, or model how a new antique table will look in your living room. Your assistant can build and update the plan, furnish rooms, apply finishes and styles, and prepare 2D plans, 3D walkthroughs, and VR views so you can inspect the result and decide what works. If you are starting from scratch, generate a private demo plan to explore what is possible, learn how styles and 3D views work, and move quickly into designing your own home. HZplan supports exploration and decision-making; verify measurements and use qualified professionals for safety-critical or regulated work.",
        "developerName": "HZplan",
        "category": "Creativity",
        "capabilities": [
          "Turn images and dimensions into editable plans",
          "Test furniture fit and room layouts",
          "Furnish and style rooms",
          "Visualize plans in 2D, 3D, and VR",
          "Edit plans safely",
          "Render and export plans",
          "Explore features with demo plans"
        ],
        "websiteURL": "https://hzplan.uk",
        "supportURL": "https://hzplan.uk/support",
        "privacyPolicyURL": "https://hzplan.uk/legal/privacy-policy.html",
        "termsOfServiceURL": "https://hzplan.uk/legal/terms",
        "defaultPrompt": [
          "Check whether this antique table will fit in my living room and show me the result in 3D.",
          "Turn this floor-plan image into an editable plan, then furnish it in Scandinavian style.",
          "Generate a demo flat so I can explore HZplan's 2D, 3D, and styling features."
        ],
        "composerIcon": "./assets/hz-mark.svg",
        "logo": "./assets/hz-mark.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Generate a private random demo flat and wait for its asynchronous job to finish.",
              "prompt": "Generate a standard modern demo flat called OpenAI Demo Review. Wait until it is ready, then give me both the 2D plan and 3D walk links and summarize its area, rooms, bedrooms, furniture count, and style. Make clear whether this is a design of my home.",
              "tools_triggered": "create_demo_plan, get_demo_plan_status",
              "expected_behavior": "Starts one demo-generation job, polls that same job until it succeeds or fails, and on success returns the private plan_id, both HZplan links, and the reported statistics. It explicitly says the generated flat is a random reference layout and not a design of the user's home."
            },
            {
              "description": "Furnish an empty named room and apply an interior style without replacing existing finishes.",
              "prompt": "Create a private plan called Furnishing Review with one 5 m by 4 m storey named Ground and four outer walls. Identify the enclosed room, name it Bedroom, furnish that empty room in the classic style, then apply the classic interior style while keeping any existing finishes. Show the updated storey and give me its 3D walk link.",
              "tools_triggered": "create_plan, create_storey, upsert_entities, get_plan_topology, name_space_at_point, furnish_room, apply_interior_style, render_storey_widget",
              "expected_behavior": "Builds and verifies the closed room, names it, adds furniture only while it is empty, applies classic finishes in keep mode without deleting prior finishes, renders the result, and returns the private 3D walk link."
            },
            {
              "description": "Create and edit a two-storey plan using explicit storey IDs for every entity operation.",
              "prompt": "Create a private plan called Storey Scope Review with 5 m by 4 m Ground and First storeys. Use each returned storey_id explicitly when creating or changing entities. Add four outer walls to each floor. On First add an entrance door, a 1400 by 700 mm desk, and a temporary stool; place the desk without blocking the entrance or main circulation, set its height to 760 mm, make it face left, and add note=reviewed. Add then remove a movable assertion on the stool, read the desk back, delete the stool, show both storeys, and confirm Ground was unchanged.",
              "tools_triggered": "create_plan, create_storey, upsert_entities, upsert_entity, set_object_height, set_object_feature_side, set_entity_attributes, set_entity_assertions, remove_entity_assertions, get_object, delete_entity, get_storey_plan, render_storey_widget",
              "expected_behavior": "Uses the build workflow for staged creation and practical placement, keeps every operation on its explicit storey, leaves the First-floor entrance and main circulation clear, returns the updated desk, deletes only the temporary stool, and renders both storeys with Ground unchanged."
            },
            {
              "description": "Import a floor-plan image and calibrate the resulting private plan.",
              "prompt": "Using the attached floor-plan image, detect its floors, import the first detected floor as Ground into a new plan called Imported Review, and calibrate it: the building's overall width is 10 metres. Then show the result.",
              "tools_triggered": "split_floor_plan, convert_floor_to_plan, get_storey_plan, rescale_storey, render_storey_widget",
              "expected_behavior": "Detects floor crops, imports the selected floor within quota, compares the plan's overall width with the stated 10 metres, rescales the storey once with that factor, and renders the calibrated storey.",
              "file_attachment_urls": [
                "https://hzplan.uk/review/hzplan-synthetic-floor-plan.png"
              ]
            },
            {
              "description": "Name a derived room and apply a catalog surface material to its floor.",
              "prompt": "Create a private plan called Material Review with one 5 m by 4 m storey named Ground and four outer walls. Identify the enclosed room and name it Living Room. Search the HZplan material catalog for an oak floor material, apply the best matching material to the Living Room floor, show the updated storey, and provide its 3D walk link.",
              "tools_triggered": "create_plan, create_storey, upsert_entities, get_plan_topology, name_space_at_point, search_material_assets, upsert_entity, render_storey_widget",
              "expected_behavior": "Builds and verifies the structure before later layers, names the derived room, applies an accessible oak material without changing wall geometry, renders the result, and returns the private 3D walk link."
            }
          ],
          "negative": [
            {
              "description": "Do not trigger HZplan or either bundled skill for an unrelated weather request.",
              "prompt": "What will the weather be in Paris tomorrow?",
              "expected_behavior": "HZplan is not invoked because weather is outside its floor-plan workflows."
            },
            {
              "description": "Do not trigger HZplan or either bundled skill for decoration advice that does not inspect or change a plan.",
              "prompt": "What paint colors work well with a dark green sofa?",
              "expected_behavior": "HZplan is not invoked because the request is general decor advice rather than floor-plan creation, inspection, or editing."
            },
            {
              "description": "Do not claim professional building-code certification.",
              "prompt": "Certify that my proposed extension complies with every UK building regulation.",
              "expected_behavior": "HZplan is not invoked to provide certification, and ChatGPT explains that qualified professional review is required."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "HZplan does not sell products or process payments."
      },
      "publication": {
        "release_notes": "HZplan 3.2.0 adds private random demo-flat generation with 2D and 3D links, one-call furnishing for empty rooms, and whole-plan interior styles. It also audits every exposed tool's read-only, open-world, and destructive annotations against actual behavior, including open-world image fetching, and documents a specific justification for each hint."
      },
      "apps": "./.app.json"
    }
  }
}