plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "polytweaks",
  "version": "0.3.3",
  "description": "Bring your 3D models into the real world in seconds. From Astra creations to existing models, share your work, gather team feedback and experience it in augmented reality with Polytweaks.",
  "author": {
    "name": "Polytweaks"
  },
  "keywords": [
    "3d",
    "models",
    "review",
    "feedback",
    "blender"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Polytweaks",
        "shortDescription": "From 3D to AR in seconds",
        "longDescription": "Bring your 3D models into the real world - in seconds. Whether you create with Astra or bring an existing model, Polytweaks makes it fast to experience your work in augmented reality and share it with others. Send a link for team review, gather feedback directly on the model, and keep every revision together as your ideas evolve. From a first concept to a client presentation, move quickly from creating to showing, discussing, and deciding. Requires a connected Polytweaks account. Web viewing supports GLB; iOS AR requires an authored USDZ companion. Model creation and editing depend on the authoring tools available in your chat.",
        "developerName": "Polytweaks",
        "category": "Productivity",
        "capabilities": [
          "Create and edit with available authoring tools",
          "Preview 3D drafts before saving",
          "Browse model and version history",
          "Retrieve model source files",
          "Save models and versions",
          "Share models and request reviews",
          "Create AR links",
          "Read and add comments"
        ],
        "websiteURL": "https://www.polytweaks.com/",
        "supportURL": "https://www.polytweaks.com/public/faq/",
        "privacyPolicyURL": "https://www.polytweaks.com/privacy/",
        "termsOfServiceURL": "https://www.polytweaks.com/terms-and-conditions/",
        "defaultPrompt": [
          "Save this 3D creation to Polytweaks with its available source files and exports.",
          "Revise this Polytweaks model using its review comments and available authoring tools, then preview the draft.",
          "Save this revision as the next version, then give me a review link and an AR QR code."
        ],
        "brandColor": "#57BE87",
        "composerIcon": "./assets/polytweaks-icon.png",
        "logo": "./assets/polytweaks-logo.png"
      },
      "onboardingSkill": "./skills/setup/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Preview a supplied draft, then save it privately with its real viewer link",
              "prompt": "Preview the attached review-cube-v1.glb, then save it to Polytweaks as Marketplace Review Cube. Keep it private and give me the viewer link.",
              "tools_triggered": "preview_model, save_model",
              "file_attachment_urls": [
                "https://www.polytweaks.com/review-fixtures/review-cube-v1.glb"
              ],
              "expected_behavior": "Show the actual GLB draft, then store one asset and its first version using the supplied file input. The prompt already authorizes saving after preview. Return the exact viewerUrl and version identity, and create no feedback or AR link. Do not invent a .blend or USDZ source. If transfer or preview is unavailable, report it without claiming a successful preview; do not claim a save without confirmation."
            },
            {
              "description": "Find a model, inspect version history and retrieve available source files",
              "prompt": "Find Marketplace Review Cube in my Polytweaks library. Show its versions, open the latest one and retrieve the files available for editing it.",
              "tools_triggered": "list_models, list_model_versions, get_model, get_model_files",
              "expected_behavior": "Open the embedded library using the existing connected account without a second web login. Find the correct model, present the requested version history, and retrieve the selected version's actual GLB and any available source companions. Let the embedded viewer show the selected model; do not narrate that it opened, repeat its visible metadata or append a read-only/no-changes report. Return viewerUrl only if requested or needed as a fallback. Report missing source files and use returned expiring downloads; do not invent a Blender source, generate a conversion, save a version, or create a share link."
            },
            {
              "description": "Distinguish public read-only, review and 24-hour AR links",
              "prompt": "Give me a public read-only share link to Marketplace Review Cube. Also create a separate review link so my team can comment, and an AR link lasting 24 hours. Do not send these links to anyone.",
              "tools_triggered": "list_models, get_model, create_share_link, create_feedback_link, create_ar_link",
              "expected_behavior": "Create exactly the three requested links for the selected version. Return the actual shareUrl, feedbackUrl and arUrl as briefly labeled links with their expirations, without a permissions checklist. The first opens the model anonymously and allows AR without exposing comments; the second additionally enables comments and editing only one's own comments. Both disable downloads by default and never allow model editing; neither requires email or an account. On desktop, the AR destination shows a QR; on a supported phone it offers direct AR. Do not confuse these links with the private viewerUrl. Report the AR tool's authored-USDZ/iOS warning when present. Do not send messages or claim a file conversion."
            },
            {
              "description": "Post and retrieve model feedback",
              "prompt": "Add this comment to Marketplace Review Cube: Make the next version taller. Then show me the comments for this version.",
              "tools_triggered": "list_models, get_model, add_comment, list_comments",
              "expected_behavior": "Post the requested comment to the selected model version, retrieve its comments, and return an accurate concise summary. Include viewerUrl when needed to act on the feedback. Do not invent a 3D annotation position."
            },
            {
              "description": "Save explicitly requested v2 and v3 while preserving v1",
              "prompt": "Save review-cube-v2.glb, then review-cube-v3.glb, as the next two versions of Marketplace Review Cube. Keep v1 and give me the viewer links for v2 and v3.",
              "tools_triggered": "list_models, get_model, save_model, list_model_versions",
              "file_attachment_urls": [
                "https://www.polytweaks.com/review-fixtures/review-cube-v2.glb",
                "https://www.polytweaks.com/review-fixtures/review-cube-v3.glb"
              ],
              "expected_behavior": "Call save_model twice in order with the same existing assetId and a distinct operationKey for each requested version. Verify the version history retains v1, v2 and v3; return each confirmed viewerUrl and version identity, and create no share links. Keep the same key and inputs for any retry. The user's save request already authorizes persistence."
            }
          ],
          "negative": [
            {
              "description": "A general 3D question needs no account access",
              "prompt": "What is the difference between GLB and USDZ?",
              "expected_behavior": "Answer without invoking Polytweaks tools or reading account data."
            },
            {
              "description": "Writing an example script needs no plugin action",
              "prompt": "Write a Blender Python example that creates a cube twice as tall. Return the code only; do not run it, access my Polytweaks library, preview a model, save files, or create share links.",
              "expected_behavior": "Provide example code as text without invoking Polytweaks tools or reading account data. The request is for code only, not execution or a model artifact. Do not execute the script, preview or save a model, create a share link, or claim that any file or model was created."
            },
            {
              "description": "Drafting comment wording does not authorize account access or posting",
              "prompt": "Rewrite this review comment to sound clearer and more constructive: 'Make the next version taller.' Return the wording only; do not open a model, read my saved comments, or post anything to Polytweaks.",
              "expected_behavior": "Return revised comment wording as text without invoking Polytweaks tools or reading account data. All needed content is already in the prompt. Do not look up a model, retrieve or post comments, create a link, or claim that the draft was posted."
            }
          ]
        },
        "demo_recording_url": "https://www.polytweaks.com/review-fixtures/polytweaks-walkthrough-20261017.html",
        "commerce": false,
        "commerce_description": "Polytweaks offers free and paid accounts on its website. Payments for optional paid plans are handled there by Lemon Squeezy. This plugin uses the connected account's existing access and does not sell products, initiate subscriptions or process payments."
      },
      "publication": {
        "release_notes": "0.3.3 explains model, version and storage allowance errors using verified account limits, links only to informational account limits, and preserves the same save key for a retry when capacity is available."
      },
      "apps": "./.app.json"
    }
  }
}