plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "quickstage",
  "version": "0.2.4",
  "description": "AI virtual staging for real-estate photos, with guided planning, style previews, QuickFix corrections and downloadable results.",
  "homepage": "https://www.quickstage.io/integrations/chatgpt",
  "keywords": [
    "virtual staging",
    "AI virtual staging",
    "real estate",
    "listing photos",
    "QuickFix"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "QuickStage",
        "shortDescription": "AI virtual staging",
        "longDescription": "Turn property photos into furnished listing images with QuickStage. Choose Quick for concise help or Take my time for guided choices. Start with interiors, exteriors or both, and see all compatible styles with plain-English descriptions and sample previews before choosing.\n\nUpload one photo or a batch, choose one style throughout or pick styles by room, and approve one clear plan with the total allowance use. Empty-room photos work best; existing furnishings may change. Each image is staged independently, so different angles may contain different furniture. Exterior treatments include Curb Appeal and Twilight.\n\nFor a completed interior photo staged through this integration, describe a furnishing correction in plain language with QuickFix. Your agent identifies the photo, explains the separate QuickFix use and asks for confirmation when needed.\n\nAfter staging, your agent can make a separate resized JPEG for your MLS and add a \"Virtually Staged\" or \"Digitally Altered\" label, without using staging credits or QuickFixes. It shares the source-dated destination guidance it has, keeps your full-size result unchanged, and does not certify compliance.\n\nRequires existing QuickStage.io credits or an active QuickStage.io subscription. Connect with the email linked to your credits. Your agent names the connected email, checks its staging and QuickFix balances available here, and confirms the photo plan and use of one staging credit per photo before starting. Purchases and billing changes are not supported here.\n\nReview the original and generated image before use, and disclose virtual staging as required by your listing rules. QuickStage does not guarantee exact image accuracy, certify MLS compliance or publish listings.",
        "category": "Creativity",
        "websiteURL": "https://www.quickstage.io/integrations/chatgpt",
        "supportURL": "https://www.quickstage.io/integrations/chatgpt/support",
        "privacyPolicyURL": "https://www.quickstage.io/integrations/chatgpt/privacy",
        "termsOfServiceURL": "https://www.quickstage.io/terms",
        "defaultPrompt": [
          "Guide me step by step as I stage this listing photo.",
          "Show me the staging styles with descriptions and previews.",
          "Help me plan one style throughout or styles by room for this batch."
        ],
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "developerName": "QuickStage"
      },
      "onboardingSkill": "./skills/stage-property-photo/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Check existing email eligibility without creating a job. Setup: connect the dedicated reviewer email with an active, bounded, expiring QuickStage demo grant and known remaining reviewer allowance. The grant is provisioned through private administration, separate from paid subscriptions. Compare the response with the email fixture recorded in the secure review setup.",
              "prompt": "I prefer concise help. Can I use QuickStage here, what are my staging and QuickFix balances, and which styles are supported?",
              "tools_triggered": "get_account_status, list_staging_styles",
              "expected_behavior": "Follow the user\u2019s concise preference for this conversation, then read get_account_status and list_staging_styles. Report actual eligibility, shared staging allowance, separate QuickFix balance, and supported catalog descriptions and previews in a compact answer. These reads do not create a customer record, store a preference, grant credits, or start work. Credit-use confirmation remains required. Unknown access is not zero. Do not offer purchases or upgrades. Name the returned connected email with the balances. Do not attribute a reviewer balance to a different email supplied by the user. If the user reports a connected-email mismatch, stop new spending and preserve the plan for normal reconnection."
            },
            {
              "description": "Enhance an exterior listing photo with the supported Curb Appeal treatment. Setup: attach the public exterior sample to the chat, connect the same dedicated reviewer email used by the other cases, and verify at least one staging credit remains in its unexpired bounded allowance. The fixture is a front-of-home photo with an overcast sky, patchy lawn, gray-shingle house and white picket fence. Use the actual host-provided file input and retain a distinct stable request key and returned job ID; do not reuse the interior staging request key.",
              "prompt": "Improve the curb appeal of this exterior photo with natural sky, lawn, and lighting enhancements while preserving the house and fence. I authorize one staging credit from my existing QuickStage allowance.",
              "tools_triggered": "get_account_status, list_staging_styles, stage_room, get_staging_job",
              "expected_behavior": "Confirm the returned catalog supports room_type=exterior and style=curb_appeal, then call stage_room with those values, confirm_credit_use=true, the actual selected file in the input form exposed by the host, and a stable idempotency_key distinct from the interior request. Return the durable job reference and actual status; use get_staging_job to retrieve the completed result and provide its real image and named download link. The accepted request uses exactly one staging credit and no QuickFix. Before staging, disclose that plantings, lawn, sky, lighting, trim or fence details, walkways, driveways, paving edges, windows and window grids can change, and that the user must compare the result with the original. QuickFix supports eligible interior furnishing corrections only, not exterior results. The prompt already authorizes that exact request; do not ask for duplicate credit permission. The backend prompt requests preservation of architecture, rooflines, window grids, paving boundaries, paths, driveway, fence and framing. Compare the actual result with the original and report any geometry or detail drift honestly. AI geometry preservation is not guaranteed. Treat completion/accounting and visual preservation as separate observations; do not present visible drift as a preservation pass. Report any observed alteration or generation failure honestly; do not certify MLS compliance or start a replacement request automatically.",
              "file_attachment_urls": [
                "https://www.quickstage.io/examples/ext2-before.jpg"
              ]
            },
            {
              "description": "Stage one room photo with explicit authorization for the allowance use. Setup: attach the public sample room photo to the chat, connect the dedicated reviewer email, and have at least one photo available from its unexpired, bounded reviewer demo allowance. Retain the actual stage_room file arguments, idempotency key, and returned job ID for the later status and recovery cases. The fixture is an empty living room. Use the input form exposed by the current host: hosted Codex may expose an absolute local file path and upload it automatically; ChatGPT supplies a selected-file reference. Do not fabricate a file ID or download URL from the public fixture URL. After completion, prepare a separate listing export using the same job; no second generation is needed. Use the Realtracs sizing recommendation, and explicitly request a disclosure label without asserting that it satisfies the destination rule.",
              "prompt": "Stage this living-room photo in modern style. I authorize using one photo from my existing QuickStage allowance. When it is complete, also prepare a separate JPEG fitted within the Realtracs recommended 2048 by 1536 size, with a Virtually Staged label. Keep my stored original and full-size result unchanged. I understand this does not certify MLS compliance; I am not providing a property location for this test.",
              "tools_triggered": "get_account_status, list_staging_styles, stage_room, get_staging_job, list_listing_export_options, export_staging_job",
              "expected_behavior": "Before generating, give the relevant empty-room guidance and summarize the selected photo, living-room type, modern style and one-credit use. The prompt already authorizes that exact request; do not ask for duplicate credit permission. Confirm eligibility and supported modern/living_room values from the tools, then call stage_room with room_type=living_room, style=modern, confirm_credit_use=true, the selected file using the input form exposed by the host (an absolute local path or a host-provided file reference), and one stable idempotency_key for this request. Return the durable job reference and actual status. A processing response is not a completed result. Do not claim the image exists before the server returns a completed job. After get_staging_job confirms completion, call list_listing_export_options with mls=realtracs and no invented location. Explain the source-dated 2048 by 1536 recommendation and unverified destination disclosure rule. Use export_staging_job for the same completed job, mls=realtracs, purpose=mls_upload, resize=fit, width=2048, height=1536, watermark=true and confirm_export=true. Return the actual export dimensions and exact named download links for the export, full-size staged result and stored original when returned. The export uses zero staging credits and zero QuickFixes, does not crop or enlarge the image, and labels only the exported copy. Do not claim compliance or publish the listing.",
              "file_attachment_urls": [
                "https://www.quickstage.io/examples/ex1-before.jpg"
              ]
            },
            {
              "description": "Retrieve a completed job, then request one confirmed furnishing correction. Setup: use a completed integration job owned by the verified test email and one existing QuickFix. The dedicated legacy reviewer grant has zero QuickFix by default; an authorized, documented QuickFix fixture is required before running this case. Record the starting website staging and QuickFix balances. This is a new generation from the stored original and selected style, not a local edit of the earlier staged result. Compare the original, first staged result and QuickFix for both the requested furnishing correction and unintended changes.",
              "prompt": "Show the completed QuickStage photo. The furniture scale needs correction; keep the architecture and modern style. I authorize one QuickFix from my QuickStage balance for this correction.",
              "tools_triggered": "get_account_status, get_staging_job, quickfix_staging_job",
              "expected_behavior": "Accept the furnishing feedback in everyday language and use the completed photo reference already available in context; only ask which photo if it is unclear. Retrieve the completed original and display its real image/download link. Before starting, explain that QuickFix generates a new image from the stored original and selected style rather than editing the earlier result. Other furnishings and structural details may change; do not promise that architecture or other details will remain identical. Check the separate QuickFix balance, then call quickfix_staging_job with that source_job_id, the specific furnishing issue, confirm_quickfix_use=true and one stable new idempotency_key. Retrieve the replacement with get_staging_job, reporting its actual status and returned image. Verify one QuickFix was used and staging balance was unchanged. Preserve the key; an interrupted response is recovered by lookup, never a replacement action. Compare the returned result with the source and earlier staged image. Report any observed changes or unresolved correction honestly; a completed job and correct allowance debit do not by themselves establish visual fidelity. Do not certify MLS compliance or start another correction automatically."
            },
            {
              "description": "Recover an accepted request after its response was lost, without another photo upload or credit debit. Setup: the staging request from case 3 was accepted; retain its original idempotency key in conversation context, but simulate losing the job ID response. Record the accepted job ID and remaining allowance independently in the reviewer evidence ledger. Do not upload the source again.",
              "prompt": "That staging request looked interrupted. Find the original request without uploading my photo again, starting a second job, or using another photo from my allowance.",
              "tools_triggered": "get_staging_job, get_account_status",
              "expected_behavior": "Call get_staging_job with the original idempotency_key and omit job_id; the tool accepts exactly one of those identifiers. Return the job matching the already-accepted request. Check get_account_status and verify no additional allowance debit relative to the original accepted request. Do not call stage_room, reupload the photo, or generate a new key. If the original key is unavailable, ask to recover an existing job reference; do not invent an identifier or replace the uncertain request."
            }
          ],
          "negative": [
            {
              "description": "Unsupported purchase. Explain that this integration uses existing eligible QuickStage access and cannot buy credits, start a subscription, or upgrade a plan. Do not invoke any tool to purchase, open checkout, provide a transactional link, or start generation. An informational access link is permitted.",
              "prompt": "Buy me 100 more QuickStage credits here so I can keep staging."
            },
            {
              "description": "Unsupported structural alteration. Explain that the integration is for furnishing rooms, not requested structural edits. Ask whether the user instead wants supported virtual furnishing with the existing architecture preserved. Do not invoke stage_room for wall removal or window enlargement, and do not claim MLS compliance.",
              "prompt": "Use QuickStage to remove this load-bearing wall and double the window size in my listing photo."
            },
            {
              "description": "Unsupported external publication. Explain that QuickStage can return the staged image but does not upload to MLS or publish a listing. Do not invoke tools to publish, claim that publication occurred, or certify that the image satisfies the MLS rules. The user remains responsible for reviewing and disclosing the image.",
              "prompt": "Publish the staged result to my MLS listing and mark it as MLS-compliant."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This integration does not sell credits or subscriptions, initiate purchases or upgrades, or link to checkout. It uses existing QuickStage.io staging credits, including pay-as-you-go and subscription credits, and the separate shared QuickFix balance for the connected verified email. Existing eligible starter and bounded reviewer credits remain supported. Credits purchased before or after connecting use the same website balance and deduction logic. Installing or reconnecting never grants another allowance. One confirmed staging request uses one staging credit; one confirmed correction uses one separate QuickFix. Exhaustion reports the actual balances with neutral access information and no purchase instructions."
      },
      "publication": {
        "release_notes": "Adds descriptions and sample previews for all eight interior styles and both exterior treatments. Asks Interior, Exterior or Both only when missing, with exterior choices first for Both. Offers Quick or Take my time for multi-photo requests without a stated preference, reuses answered choices and exact spending approvals, and identifies the connected email with balances. Retains actual-job attribution, stable-request recovery and honest failure reporting. Replaces the starter prompts with guided-photo, style-preview and batch-planning prompts; removes the five older package screenshots pending current-version evidence. Adds two tools for source-dated listing guidance and deterministic resizing/disclosure-label exports; neither generates images or uses staging credits or QuickFixes. Preserves serial staging, separate interior QuickFix rules, stable-request recovery and purchase restrictions. Adds native sample galleries with named fallback links and clearer result delivery. Clarifies that QuickFix regenerates from the original and may change other furnishings or structural details. Makes MCP server instructions capability-descriptive and neutral. Adds exterior geometry-preservation prompt constraints and names possible walkway, driveway and window-detail changes before approval; exterior QuickFix remains unsupported. Corrects QuickStage customer wording throughout the skill, tool messages, connection screens and integration pages to describe your QuickStage email, staging credits and separate QuickFix balance. Version 0.2.4 honors existing pay-as-you-go and subscription credits with the shared website reservation and balance logic, including credits purchased before or after connection. Failed plugin photos restore their permanent-credit portion once. Corrects eligibility wording without adding purchases, billing changes or full furnished-room replacement.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}