Dotsy

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "ifMatch",
    "adapters",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "force": {
      "type": "string",
      "const": "discard-undo",
      "description": "An undo record from a prior apply exists (409 adapt_undo_exists): defer-discard it — the prior record is dropped only when this apply SUCCEEDS; a partial-failure rollback reinstates it. Prefer adapt revert first."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Full computation, would-write set + previews, ZERO writes, no undo."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "ifMatch": {
      "type": "string",
      "minLength": 1,
      "description": "The proposal etag from analyze (or GET …/adapt/proposal / status)."
    },
    "adapters": {
      "type": "array",
      "items": {
        "enum": [
          "nav",
          "collection"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Which analyzed adapters to apply."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "atomic": {
      "type": "boolean",
      "description": "All or nothing: every writes[].ifMatch and deletes[].ifMatch is checked before anything is written. One stale key writes nothing and the call fails with 409 changeset_conflict listing `conflicts`. Default: a stale write is skipped and listed, the rest apply."
    },
    "writes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key"
        ],
        "properties": {
          "key": {
            "type": "string",
            "minLength": 1
          },
          "body": {
            "type": "string"
          },
          "route": {
            "type": "object",
            "required": [
              "path",
              "input"
            ],
            "properties": {
              "path": {
                "type": "string",
                "minLength": 1
              },
              "input": {
                "type": "object",
                "properties": {
                  "nav": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "menu"
                          ],
                          "properties": {
                            "menu": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Menu this page joins — matches a <dotsy-nav menu=\"…\"> in the layout/fragment (e.g. \"primary\", \"footer\")."
                            },
                            "order": {
                              "type": "integer",
                              "description": "Sort position among siblings in this menu, ascending. Use gaps (10, 20, 30) to leave room for inserts."
                            },
                            "parent": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Parent route path within this menu for a nested/dropdown item (e.g. \"/services\"). Omit for top level."
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "DEPRECATED — use put_menu_item / menu API. Menu memberships on the route row. Still accepted during transition and synced to menu items. See get_skill('nav')."
                  },
                  "vars": {
                    "anyOf": [
                      {
                        "type": "object",
                        "additionalProperties": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "layout": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Layout NAME, bare: \"default\" for layouts/default.html — not the file key. It must already exist as layouts/<name>.html (400 layout_not_found otherwise). null removes the layout."
                  },
                  "noindex": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Exclude from sitemap/RSS; inject noindex meta (0.69)."
                  },
                  "purpose": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "navLabel": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "DEPRECATED — use put_menu_item / menu API. Menu link text for <dotsy-nav> (separate from title). Still accepted during transition and synced to menu items."
                  },
                  "contentKey": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Explicit content key (defaults to a path-derived key when omitted). null clears an explicit key back to that path default — same as omitting it, but usable on a PATCH to undo a prior set."
                  },
                  "experiment": {
                    "anyOf": [
                      {
                        "type": "object",
                        "required": [
                          "id",
                          "name",
                          "status",
                          "variants"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^[a-z0-9-]+$",
                            "description": "Stable experiment slug — cookie namespace; unique per site forever."
                          },
                          "name": {
                            "type": "string",
                            "maxLength": 80,
                            "minLength": 1
                          },
                          "goalId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Optional Dotsy conversion goal; omit when tracking in external analytics."
                          },
                          "status": {
                            "enum": [
                              "draft",
                              "running",
                              "ended"
                            ],
                            "type": "string"
                          },
                          "endedAt": {
                            "type": "string"
                          },
                          "handsOff": {
                            "type": "boolean",
                            "description": "Hands-off mode (0.56e M4): the daily sweep may auto-promote a ≥95% winner or auto-end keep-A after 30 days. Prefer setting this via start_test; kept here so route PATCH round-trips (weights/settings updates) don't strip the flag."
                          },
                          "variants": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "weight",
                                "contentKey"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "pattern": "^[a-z0-9-]+$",
                                  "description": "Variant arm id — default \"a\" / \"b\" on create."
                                },
                                "label": {
                                  "type": "string",
                                  "maxLength": 80
                                },
                                "weight": {
                                  "type": "integer",
                                  "maximum": 100,
                                  "minimum": 0
                                },
                                "contentKey": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "Published body key (may be routeless)."
                                }
                              },
                              "additionalProperties": false
                            },
                            "maxItems": 3,
                            "minItems": 2
                          },
                          "startedAt": {
                            "type": "string"
                          },
                          "changeNote": {
                            "type": "string",
                            "maxLength": 120,
                            "description": "One line on what the variant changes (0.56e M2). Kept here so route PATCH round-trips (weights/settings updates) don't strip it."
                          },
                          "hypothesis": {
                            "type": "string",
                            "maxLength": 200
                          }
                        },
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "redirectTo": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Redirect target, a root-relative path (/…). Required when purpose is \"redirect\". null clears it — only valid once purpose stops being \"redirect\" (a redirect route always needs a target)."
                  },
                  "preserveQuery": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Append the visitor's original query string to the redirect target (default true on a redirect). null clears an explicit override."
                  },
                  "redirectStatus": {
                    "anyOf": [
                      {
                        "enum": [
                          301,
                          302,
                          308
                        ],
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "301 permanent / 302 or 308 temporary (default 301 on a redirect). null clears an explicit override."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "ifMatch": {
            "type": "string"
          },
          "menuItems": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "sort",
                "parent",
                "label",
                "kind",
                "ref",
                "menu"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1
                },
                "ref": {
                  "type": "string"
                },
                "data": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "html": {
                  "type": "string"
                },
                "kind": {
                  "enum": [
                    "page",
                    "url",
                    "anchor",
                    "mailto",
                    "group"
                  ],
                  "type": "string"
                },
                "menu": {
                  "type": "string",
                  "minLength": 1
                },
                "sort": {
                  "type": "integer"
                },
                "attrs": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "newTab": {
                  "type": "boolean",
                  "default": false
                },
                "parent": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "childShell": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "childTemplate": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "bodyStaging": {
            "type": "string",
            "pattern": "^stg_[a-zA-Z0-9_-]+$"
          },
          "contentType": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "default": [],
      "maxItems": 10
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "deletes": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "object",
            "required": [
              "key",
              "ifMatch"
            ],
            "properties": {
              "key": {
                "type": "string",
                "minLength": 1
              },
              "ifMatch": {
                "type": "string",
                "minLength": 1
              }
            },
            "additionalProperties": false
          }
        ]
      },
      "default": [],
      "maxItems": 50,
      "description": "Keys to delete: a key, or { key, ifMatch } (the hash you read) so a page changed since is not deleted (listed in conflicts)."
    },
    "message": {
      "type": "string",
      "maxLength": 2000
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug",
    "context"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "purpose": {
      "type": "string",
      "maxLength": 280,
      "minLength": 5
    },
    "workspace": {
      "type": [
        "string",
        "null"
      ],
      "description": "Workspace org id or slug (see get_account_context memberships). Only for multi-workspace users; omit otherwise. Ignored for pga_ keys (fixed workspace)."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "editingMode": {
      "enum": [
        "live",
        "staged"
      ],
      "type": "string",
      "description": "How the editor's Save behaves. 'live' (default) publishes each save immediately; 'staged' keeps saves as drafts until publish_site. Prefer 'staged' when an agent will hand the editor to a person (see start_edit_session → draftEditorUrl) so keystrokes don't go straight to the public site. API writes always stage regardless of this setting."
    },
    "onSlugTaken": {
      "enum": [
        "fail",
        "auto-suffix",
        "merge"
      ],
      "type": "string",
      "default": "auto-suffix"
    },
    "keyConvention": {
      "enum": [
        "flat",
        "directory"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "full": {
      "type": "boolean",
      "description": "Return the full manifest incl. per-page HTML samples (default: compacted — etag/action/counts kept, samples truncated — to fit the token budget)."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "scope": {
      "enum": [
        "flat-only",
        "all"
      ],
      "type": "string",
      "description": "Default flat-only; analyze clusters flat keys only."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "persist": {
      "type": "boolean",
      "description": "First call: false (preview only). true only after user confirms editable/CMS mode."
    },
    "profileId": {
      "enum": [
        "webflow",
        "wordpress",
        "generic",
        "framer"
      ],
      "type": "string"
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "sampleLimit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "refreshManifest": {
      "type": "boolean",
      "description": "Replace persisted manifest when true."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "name",
    "pageKey",
    "context"
  ],
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "Section name. Its file is fragments/<name>.html, placed with <dotsy-fragment name=\"<name>\">."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "dryRun": {
      "type": "boolean",
      "default": true,
      "description": "Default true: report what would change and write nothing. false: stage the change as a draft (publish_site makes it live)."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "ifMatch": {
      "type": "string",
      "minLength": 1,
      "description": "The page's content hash. If the page changed since, nothing is written."
    },
    "pageKey": {
      "type": "string",
      "minLength": 1,
      "description": "Content key of the page that gets its own copy, e.g. 'pricing.html'."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug",
    "context"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Event id — returns diff for this change instead of the list."
    },
    "key": {
      "type": "string",
      "description": "Content key when id is set (default first key in the event)."
    },
    "who": {
      "enum": [
        "all",
        "people",
        "agents"
      ],
      "type": "string",
      "description": "Default all."
    },
    "slug": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "actor": {
      "type": "string",
      "minLength": 1,
      "description": "Actor id or me."
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Page size (default 20)."
    },
    "since": {
      "type": "string",
      "description": "ISO date (default 7 days, plan retention floor)."
    },
    "state": {
      "enum": [
        "needs_review",
        "reverted"
      ],
      "type": "string",
      "description": "needs_review = agent drafts awaiting a person's publish."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "force": {
      "type": "boolean",
      "description": "Proceed past the incomplete-KV-snapshot 409 only — not the unsupported-backend or strictDrafts blocks, which force does nothing for. Read the blocked response's `reason` + `audit` first; the flip is one-way, so rows outside the snapshot are unreachable afterwards. Default false."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "strictDrafts": {
      "type": "boolean",
      "description": "Block on unpublished drafts or unrecovered KV content rows (default true — publish/discard first, or pass false to proceed anyway)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "sourceUrl",
    "context"
  ],
  "properties": {
    "mode": {
      "enum": [
        "auto",
        "mirror",
        "render"
      ],
      "type": "string",
      "description": "Default auto — per-page mirror with silent render escalation"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "pages": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "key"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "auto",
              "mirror",
              "render"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "description": "Explicit page list; omit to import sourceUrl as index.html"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "segments": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "pathPrefix"
        ],
        "properties": {
          "mode": {
            "enum": [
              "auto",
              "mirror",
              "render"
            ],
            "type": "string"
          },
          "sitemap": {
            "type": "string",
            "description": "Sitemap path relative to sourceUrl, e.g. /designs/sitemap.xml. Omit only to import this segment's single hub page — expansion does NOT happen without it, and a segment_hub_only warning is returned as a reminder."
          },
          "maxPages": {
            "type": "integer",
            "maximum": 5000,
            "minimum": 1
          },
          "pathPrefix": {
            "type": "string",
            "description": "e.g. / or /designs"
          }
        },
        "additionalProperties": false
      },
      "description": "Split-origin segments — each expands into pages by fetching its own `sitemap`. A segment without `sitemap` imports only its pathPrefix hub page (with a warning), not the whole prefix."
    },
    "sourceUrl": {
      "type": "string",
      "format": "uri"
    },
    "workspace": {
      "type": [
        "string",
        "null"
      ],
      "description": "Workspace org id or slug (see get_account_context memberships). Only for multi-workspace users; omit otherwise. Ignored for pga_ keys (fixed workspace)."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "onSlugTaken": {
      "enum": [
        "fail",
        "auto-suffix",
        "merge"
      ],
      "type": "string",
      "default": "auto-suffix"
    },
    "keyConvention": {
      "enum": [
        "flat",
        "directory"
      ],
      "type": "string",
      "description": "Content key shape: directory = Astro dist (about/index.html); default flat"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "prefix",
    "context"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Case-insensitive title search within items[]."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Items per page (default 50, max 200)."
    },
    "cursor": {
      "type": "string",
      "description": "Resume from a prior response's nextCursor."
    },
    "prefix": {
      "type": "string",
      "description": "Collection id or prefix, e.g. \"posts\" or \"blog/\" — use the key exactly as list_collections returned it."
    },
    "status": {
      "enum": [
        "all",
        "published",
        "scheduled",
        "draft"
      ],
      "type": "string",
      "description": "Filter items[] by status (see the tool description for what each means). Providing this (or q/cursor/limit) is what makes the response include items[]."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Keys per page (default 50, max 1000)."
    },
    "cursor": {
      "type": "string",
      "description": "Resume from a prior response's nextCursor."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "withSize": {
      "type": "boolean",
      "description": "Force size/missing measurement on a page bigger than 100 rows (costs one storage read per returned row). Default false — rows in a ≤100-row page are measured either way."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "form",
    "context"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Search reply-to email (indexed)"
    },
    "form": {
      "type": "string",
      "minLength": 1,
      "description": "Form id from dotsy-config, e.g. contact"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "toMs": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "fromMs": {
      "type": "integer"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Only with view:'pages'. Case-insensitive substring match on path or title."
    },
    "site": {
      "type": "string",
      "description": "Site slug."
    },
    "view": {
      "enum": [
        "pages"
      ],
      "type": "string",
      "description": "pages: group by layout — enables layout/noLayout/q below, adds page-structure fields and indexing progress. Omit for the default per-route listing."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Pages per page (server default applies when omitted)."
    },
    "cursor": {
      "type": "string",
      "description": "Resume from a prior response's nextCursor."
    },
    "layout": {
      "type": "string",
      "description": "Only with view:'pages'. Layout file key (e.g. layouts/store.html, or bare 'store') — only pages using it. Exclusive with noLayout."
    },
    "noLayout": {
      "type": "boolean",
      "description": "Only with view:'pages'. Only pages with no layout (routeless keys included). Exclusive with layout."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "path",
    "context"
  ],
  "properties": {
    "nav": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "menu"
            ],
            "properties": {
              "menu": {
                "type": "string",
                "minLength": 1,
                "description": "Menu this page joins — matches a <dotsy-nav menu=\"…\"> in the layout/fragment (e.g. \"primary\", \"footer\")."
              },
              "order": {
                "type": "integer",
                "description": "Sort position among siblings in this menu, ascending. Use gaps (10, 20, 30) to leave room for inserts."
              },
              "parent": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Parent route path within this menu for a nested/dropdown item (e.g. \"/services\"). Omit for top level."
              }
            },
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "DEPRECATED — use put_menu_item / menu API. Menu memberships on the route row. Still accepted during transition and synced to menu items. See get_skill('nav')."
    },
    "path": {
      "type": "string"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "vars": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "layout": {
      "type": [
        "string",
        "null"
      ],
      "description": "Layout NAME, bare: \"default\" for layouts/default.html — not the file key. It must already exist as layouts/<name>.html (400 layout_not_found otherwise). null removes the layout."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "noindex": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Exclude from sitemap/RSS; inject noindex meta (0.69)."
    },
    "purpose": {
      "type": [
        "string",
        "null"
      ]
    },
    "navLabel": {
      "type": [
        "string",
        "null"
      ],
      "description": "DEPRECATED — use put_menu_item / menu API. Menu link text for <dotsy-nav> (separate from title). Still accepted during transition and synced to menu items."
    },
    "contentKey": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Explicit content key (defaults to a path-derived key when omitted). null clears an explicit key back to that path default — same as omitting it, but usable on a PATCH to undo a prior set."
    },
    "experiment": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "id",
            "name",
            "status",
            "variants"
          ],
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[a-z0-9-]+$",
              "description": "Stable experiment slug — cookie namespace; unique per site forever."
            },
            "name": {
              "type": "string",
              "maxLength": 80,
              "minLength": 1
            },
            "goalId": {
              "type": "string",
              "minLength": 1,
              "description": "Optional Dotsy conversion goal; omit when tracking in external analytics."
            },
            "status": {
              "enum": [
                "draft",
                "running",
                "ended"
              ],
              "type": "string"
            },
            "endedAt": {
              "type": "string"
            },
            "handsOff": {
              "type": "boolean",
              "description": "Hands-off mode (0.56e M4): the daily sweep may auto-promote a ≥95% winner or auto-end keep-A after 30 days. Prefer setting this via start_test; kept here so route PATCH round-trips (weights/settings updates) don't strip the flag."
            },
            "variants": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "id",
                  "weight",
                  "contentKey"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9-]+$",
                    "description": "Variant arm id — default \"a\" / \"b\" on create."
                  },
                  "label": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "weight": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "contentKey": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Published body key (may be routeless)."
                  }
                },
                "additionalProperties": false
              },
              "maxItems": 3,
              "minItems": 2
            },
            "startedAt": {
              "type": "string"
            },
            "changeNote": {
              "type": "string",
              "maxLength": 120,
              "description": "One line on what the variant changes (0.56e M2). Kept here so route PATCH round-trips (weights/settings updates) don't strip it."
            },
            "hypothesis": {
              "type": "string",
              "maxLength": 200
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "redirectTo": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Redirect target, a root-relative path (/…). Required when purpose is \"redirect\". null clears it — only valid once purpose stops being \"redirect\" (a redirect route always needs a target)."
    },
    "preserveQuery": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Append the visitor's original query string to the redirect target (default true on a redirect). null clears an explicit override."
    },
    "redirectStatus": {
      "anyOf": [
        {
          "enum": [
            301,
            302,
            308
          ],
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "301 permanent / 302 or 308 temporary (default 301 on a redirect). null clears an explicit override."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "path": {
      "type": "string"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "variant": {
      "type": "string",
      "description": "A/B variant arm to compose (e.g. \"b\") — same as ?dotsy-variant= on the public URL."
    },
    "contains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Assert substrings present in composed HTML."
    },
    "selector": {
      "type": "string",
      "description": "Return matched elements only (tag/attrs/text)."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "notContains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Assert absent — e.g. `<dotsy-` for unresolved template tags."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "feedback",
    "handoff",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "pages": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 50,
      "description": "Publish only these pages — use when a publish returns rules_not_fully_checked; publish the rest in further batches (≤50 route paths, e.g. /pricing)."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "handoff": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: decisions, preferences, or open threads for the next session (appended to the brief)."
    },
    "feedback": {
      "type": "object",
      "required": [
        "category",
        "impactPercent",
        "title"
      ],
      "properties": {
        "title": {
          "type": "string"
        },
        "category": {
          "enum": [
            "missing_tool",
            "blocking_error",
            "extra_round_trips",
            "confusing_response",
            "workaround",
            "other"
          ],
          "type": "string",
          "description": "missing_tool | blocking_error | extra_round_trips | confusing_response | workaround | other"
        },
        "findings": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "category",
              "impactPercent",
              "title"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "category": {
                "$ref": "#/properties/feedback/properties/category"
              },
              "description": {
                "type": "string"
              },
              "operationId": {
                "type": "string"
              },
              "impactPercent": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1
              },
              "suggestedImprovement": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "maxItems": 20
        },
        "description": {
          "type": "string"
        },
        "impactPercent": {
          "type": "integer",
          "maximum": 100,
          "minimum": 1
        },
        "suggestedImprovement": {
          "type": "string"
        }
      },
      "description": "Required. Canonical dummy OK on friction-free sessions; tool intents attached automatically.",
      "additionalProperties": false
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "acknowledgeSeoWarnings": {
      "type": "boolean",
      "description": "Required when brief.priorities.seo is must and verify_page reported SEO errors (not warnings). User must have explicitly chosen to publish despite errors."
    },
    "confirmedDraftFingerprint": {
      "type": "string",
      "description": "Required when get_draft_status returned requiredDecision (publish_confirm). Must match the current draft fingerprint from get_draft_status."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "schema",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "schema": {
      "type": "object",
      "description": "Whole schema file: { \"v\": 1, \"collections\": { \"<key>\": { \"fields\": [...], \"settings\"?: {...} } } }.",
      "additionalProperties": {}
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "ifMatch": {
      "type": [
        "string",
        "null"
      ],
      "description": "hash from get_collection_schema (stale → 409 conflict). null = the schema must not exist yet. Omit to write unconditionally."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "menu",
    "id",
    "sort",
    "parent",
    "label",
    "kind",
    "ref",
    "context"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "ref": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "html": {
      "type": "string"
    },
    "kind": {
      "enum": [
        "page",
        "url",
        "anchor",
        "mailto",
        "group"
      ],
      "type": "string"
    },
    "menu": {
      "type": "string",
      "minLength": 1
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "sort": {
      "type": "integer"
    },
    "attrs": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "label": {
      "type": "string",
      "minLength": 1
    },
    "newTab": {
      "type": "boolean",
      "default": false
    },
    "parent": {
      "type": [
        "string",
        "null"
      ]
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "childShell": {
      "type": [
        "string",
        "null"
      ]
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "childTemplate": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "path",
    "context"
  ],
  "properties": {
    "nav": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "menu"
            ],
            "properties": {
              "menu": {
                "type": "string",
                "minLength": 1,
                "description": "Menu this page joins — matches a <dotsy-nav menu=\"…\"> in the layout/fragment (e.g. \"primary\", \"footer\")."
              },
              "order": {
                "type": "integer",
                "description": "Sort position among siblings in this menu, ascending. Use gaps (10, 20, 30) to leave room for inserts."
              },
              "parent": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Parent route path within this menu for a nested/dropdown item (e.g. \"/services\"). Omit for top level."
              }
            },
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "DEPRECATED — use put_menu_item / menu API. Menu memberships on the route row. Still accepted during transition and synced to menu items. See get_skill('nav')."
    },
    "path": {
      "type": "string"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "vars": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "layout": {
      "type": [
        "string",
        "null"
      ],
      "description": "Layout NAME, bare: \"default\" for layouts/default.html — not the file key. It must already exist as layouts/<name>.html (400 layout_not_found otherwise). null removes the layout."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "noindex": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Exclude from sitemap/RSS; inject noindex meta (0.69)."
    },
    "purpose": {
      "type": [
        "string",
        "null"
      ]
    },
    "navLabel": {
      "type": [
        "string",
        "null"
      ],
      "description": "DEPRECATED — use put_menu_item / menu API. Menu link text for <dotsy-nav> (separate from title). Still accepted during transition and synced to menu items."
    },
    "contentKey": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Explicit content key (defaults to a path-derived key when omitted). null clears an explicit key back to that path default — same as omitting it, but usable on a PATCH to undo a prior set."
    },
    "experiment": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "id",
            "name",
            "status",
            "variants"
          ],
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[a-z0-9-]+$",
              "description": "Stable experiment slug — cookie namespace; unique per site forever."
            },
            "name": {
              "type": "string",
              "maxLength": 80,
              "minLength": 1
            },
            "goalId": {
              "type": "string",
              "minLength": 1,
              "description": "Optional Dotsy conversion goal; omit when tracking in external analytics."
            },
            "status": {
              "enum": [
                "draft",
                "running",
                "ended"
              ],
              "type": "string"
            },
            "endedAt": {
              "type": "string"
            },
            "handsOff": {
              "type": "boolean",
              "description": "Hands-off mode (0.56e M4): the daily sweep may auto-promote a ≥95% winner or auto-end keep-A after 30 days. Prefer setting this via start_test; kept here so route PATCH round-trips (weights/settings updates) don't strip the flag."
            },
            "variants": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "id",
                  "weight",
                  "contentKey"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9-]+$",
                    "description": "Variant arm id — default \"a\" / \"b\" on create."
                  },
                  "label": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "weight": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "contentKey": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Published body key (may be routeless)."
                  }
                },
                "additionalProperties": false
              },
              "maxItems": 3,
              "minItems": 2
            },
            "startedAt": {
              "type": "string"
            },
            "changeNote": {
              "type": "string",
              "maxLength": 120,
              "description": "One line on what the variant changes (0.56e M2). Kept here so route PATCH round-trips (weights/settings updates) don't strip it."
            },
            "hypothesis": {
              "type": "string",
              "maxLength": 200
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "redirectTo": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Redirect target, a root-relative path (/…). Required when purpose is \"redirect\". null clears it — only valid once purpose stops being \"redirect\" (a redirect route always needs a target)."
    },
    "preserveQuery": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Append the visitor's original query string to the redirect target (default true on a redirect). null clears an explicit override."
    },
    "redirectStatus": {
      "anyOf": [
        {
          "enum": [
            301,
            302,
            308
          ],
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "301 permanent / 302 or 308 temporary (default 301 on a redirect). null clears an explicit override."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "key",
    "newSlug",
    "context"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Current content key, e.g. dashboard.html"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "newSlug": {
      "type": "string",
      "minLength": 1,
      "description": "New filename stem; directory prefix preserved (blog/foo → blog/bar)"
    },
    "movePath": {
      "type": "boolean",
      "description": "false (default): delete routes bound to old key. true: move static route path to match slug."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "leaveRedirect": {
      "type": "boolean",
      "description": "With movePath:true on an already-published page, leave a 301 at the old path (default true). false removes the old path outright — old links break. No effect when movePath is false, or on a page that was never published."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "from",
    "to",
    "context"
  ],
  "properties": {
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "New route path, e.g. /new-page"
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Current route path, e.g. /old-page"
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "leaveRedirect": {
      "type": "boolean",
      "description": "Leave a 301 from the old path to the new one (default true). false removes the old path outright — old links break."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "version",
    "context"
  ],
  "properties": {
    "keys": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 150,
      "minItems": 1,
      "description": "Restore only these content keys (single-page restore: CORE workspaces). Default: the whole version."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "dryRun": {
      "type": "boolean",
      "description": "Only list what would change; writes nothing."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "publish": {
      "type": "boolean",
      "description": "Publish exactly the restored pages at once (live-mode sites). Default false: they stay unpublished changes."
    },
    "version": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "const": "previous"
        }
      ],
      "description": "A version from list_versions, or \"previous\" (the one before live)."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "removeAdded": {
      "type": "boolean",
      "description": "Remove pages added since the version. Default true."
    },
    "replaceDrafts": {
      "type": "boolean",
      "description": "Replace unpublished changes on the pages the restore touches. Without it such a restore answers 409 drafts_pending."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "provider",
    "context"
  ],
  "properties": {
    "host": {
      "type": "string",
      "description": "Umami only: https origin of the Umami instance, e.g. https://umami.example.com."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "domain": {
      "type": "string",
      "description": "Plausible only: the site domain registered in Plausible, e.g. example.com."
    },
    "siteId": {
      "type": "string",
      "description": "Fathom only: site ID (uppercase letters/digits)."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "provider": {
      "enum": [
        "ga4",
        "plausible",
        "fathom",
        "umami",
        "none"
      ],
      "type": "string"
    },
    "websiteId": {
      "type": "string",
      "description": "Umami only: website ID (UUID)."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "measurementId": {
      "type": "string",
      "description": "GA4 only: measurement ID, e.g. G-ABC123XYZ."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "hide": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 1000,
      "description": "every_page: pages that should not show it (they keep their own copy). Send them with the first move, never later."
    },
    "keys": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 1000,
      "description": "Pages with an exact copy to share it on (analyze's matches.keys). Omit for every exact copy. The source page is always included."
    },
    "name": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "With sourceKey + selector: the new section's name (default: proposed). Alone: the existing section to re-place."
    },
    "show": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 1000,
      "description": "Pages that should show it again (removes their marker)."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "scope": {
      "enum": [
        "where_found",
        "every_page"
      ],
      "type": "string",
      "description": "where_found: each page that has it gets a reference. every_page: one slot in the layout, at the top or bottom of the page content; pages listed in `hide` don't show it."
    },
    "dryRun": {
      "type": "boolean",
      "default": true,
      "description": "Default true: report what would change and write nothing. false: stage the change as a draft (publish_site makes it live)."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "ifMatch": {
      "type": "string",
      "minLength": 1,
      "description": "The page's content hash (analyze's sourceEtag). If the page changed since, nothing is written."
    },
    "similar": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 200,
      "description": "Pages with a similar copy (analyze's similar.keys) that take the shared version, losing their own wording. Default none."
    },
    "wrapTag": {
      "enum": [
        "div",
        "section",
        "footer",
        "header",
        "article",
        "aside"
      ],
      "type": "string",
      "description": "With selectors: the wrapper. Default footer when the run ends the page content, else section."
    },
    "selector": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "CSS selector of the element in the page's stored HTML (the editor's selector, or one checked with get_content?selector=). It must match exactly one element."
    },
    "selectors": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Instead of selector: a run of elements next to each other in one parent, in page order (each matches one element). Shared as one section inside a wrapper, on the pages with the same run."
    },
    "sourceKey": {
      "type": "string",
      "minLength": 1,
      "description": "Content key of the page the element is on, e.g. 'about.html'."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "keepLayout": {
      "type": "boolean",
      "description": "With selectors: wrapper gets style=\"display:contents\" so a flex/grid parent lays the run out as before. Default true."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "path",
    "goalId",
    "source",
    "context"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 80
    },
    "path": {
      "type": "string",
      "minLength": 1
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "goalId": {
      "type": "string",
      "minLength": 1
    },
    "source": {
      "enum": [
        "draft",
        "live"
      ],
      "type": "string"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "weights": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 100,
        "minimum": 0
      }
    },
    "handsOff": {
      "type": "boolean",
      "description": "Hands-off mode (0.56e M4): Dotsy finishes the test WITHOUT further user instruction — the LIVE SITE may change later on its own (a ≥95% winner is auto-promoted, old page kept as a draft; or after 30 days with no clear winner the test auto-ends keeping the control). Only set when the user explicitly asked for hands-off / auto-finish."
    },
    "changeNote": {
      "type": "string",
      "maxLength": 120,
      "description": "One line on what the variant changes, shown on the test card (≤120 chars)."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "hypothesis": {
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "full": {
      "type": "boolean",
      "description": "Return the full manifest incl. per-page HTML samples (default: compacted — etag/action/counts kept, samples truncated — to fit the token budget)."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "scope": {
      "enum": [
        "flat-only",
        "all"
      ],
      "type": "string",
      "description": "Default flat-only; analyze clusters flat keys only."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "persist": {
      "type": "boolean",
      "description": "First call: false (preview only). true only after user confirms editable/CMS mode."
    },
    "profileId": {
      "enum": [
        "webflow",
        "wordpress",
        "generic",
        "framer"
      ],
      "type": "string"
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "sampleLimit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "refreshManifest": {
      "type": "boolean",
      "description": "Replace persisted manifest when true."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "ifMatch",
    "context"
  ],
  "properties": {
    "keys": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Required when scope is keys."
    },
    "mode": {
      "enum": [
        "apply",
        "review-only"
      ],
      "type": "string",
      "description": "Default apply. Neither value is a dry run — review-only persists the same content/layout write as apply. Only pass review-only after a review_required error (low analyze confidence); it labels the result outcome \"review\" and defers primary-nav auto-wiring to a later apply call."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "scope": {
      "enum": [
        "flat-only",
        "all",
        "keys",
        "new-since-last"
      ],
      "type": "string"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "ifMatch": {
      "type": "string",
      "minLength": 1,
      "description": "Manifest etag from structure_site_analyze or get_structure_status."
    },
    "overrides": {
      "type": "object",
      "properties": {
        "forceSkipKeys": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "restructure": {
      "type": "boolean",
      "description": "Required true when scope all and site has structured pages."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "category",
    "impactPercent",
    "title",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "title": {
      "type": "string"
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "category": {
      "enum": [
        "missing_tool",
        "blocking_error",
        "extra_round_trips",
        "confusing_response",
        "workaround",
        "other"
      ],
      "type": "string",
      "description": "missing_tool | blocking_error | extra_round_trips | confusing_response | workaround | other"
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "category",
          "impactPercent",
          "title"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "category": {
            "$ref": "#/properties/category"
          },
          "description": {
            "type": "string"
          },
          "operationId": {
            "type": "string"
          },
          "impactPercent": {
            "type": "integer",
            "maximum": 100,
            "minimum": 1
          },
          "suggestedImprovement": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "description": {
      "type": "string"
    },
    "impactPercent": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "suggestedImprovement": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "body": {
      "type": "string",
      "maxLength": 50000,
      "description": "Replace narrative body (site ≤50k chars; page ≤10k)."
    },
    "goal": {
      "type": "string",
      "maxLength": 4000,
      "description": "Current goal (site ≤4k chars; page ≤2k)."
    },
    "head": {
      "description": "Head fields to merge. Site: purpose, audience, kind (exploration|production), priorities ({seo,analytics,design,mobile}: must|nice|skip), editingModel (ai|simple-editor|creator), sections, design (strict): palette string[] max 8, type string[] max 6, layout string max 80 chars — no other keys. Page: purpose, design.{direction,hero}."
    },
    "page": {
      "type": "string",
      "description": "Content key — targets that page's brief (`_intent/pages/<key>.md`). Omit for the site brief."
    },
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "notes": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 4000
        },
        {
          "type": "object",
          "properties": {
            "seo": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 4000
                },
                {
                  "type": "null"
                }
              ]
            },
            "design": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 4000
                },
                {
                  "type": "null"
                }
              ]
            },
            "content": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 4000
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": false
        }
      ],
      "description": "Site: free-form ## Notes string (≤4k) OR per-section notes object for Design system / Content & CMS / SEO (null clears one). Page brief: string only (≤2k)."
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "card",
          "text"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z0-9-]{2,40}$"
          },
          "card": {
            "enum": [
              "intent",
              "design",
              "content",
              "seo"
            ],
            "type": "string"
          },
          "text": {
            "type": "string",
            "maxLength": 160,
            "minLength": 1
          },
          "check": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "max"
                    ],
                    "properties": {
                      "max": {
                        "type": "integer",
                        "maximum": 300,
                        "minimum": 10
                      },
                      "type": {
                        "type": "string",
                        "const": "title-max"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "suffix"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "title-suffix"
                      },
                      "suffix": {
                        "type": "string",
                        "maxLength": 60,
                        "minLength": 1
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "min",
                      "max"
                    ],
                    "properties": {
                      "max": {
                        "type": "integer",
                        "maximum": 1000,
                        "minimum": 1
                      },
                      "min": {
                        "type": "integer",
                        "maximum": 1000,
                        "minimum": 0
                      },
                      "type": {
                        "type": "string",
                        "const": "description-length"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "one-h1"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "words"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "banned-words"
                      },
                      "words": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 40,
                          "minLength": 1
                        },
                        "maxItems": 50,
                        "minItems": 1
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "image-alt"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "colors"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "allowed-colors"
                      },
                      "colors": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$"
                        },
                        "maxItems": 24,
                        "minItems": 1
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "fonts"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "allowed-fonts"
                      },
                      "fonts": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 60,
                          "minLength": 1
                        },
                        "maxItems": 12,
                        "minItems": 1
                      }
                    },
                    "additionalProperties": false
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "level": {
            "enum": [
              "block",
              "warn"
            ],
            "type": "string"
          },
          "locked": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 30,
      "description": "Rules & guidelines lines to add or change (upsert by id — send only fields you change; omitted fields keep their stored value; check: null turns a Rule into a Guideline). A supported check (title-max, title-suffix, description-length, one-h1, banned-words, image-alt, allowed-colors, allowed-fonts) makes a Rule — use level block for hard musts (banned words, title suffix), warn for softer checks. locked can only be set by a person; locked: false unlocks."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "removeRules": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 30,
      "description": "Ids of rules or guidelines to remove (site brief only)."
    },
    "appendHandoff": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Append a hand-off log line — site brief only; ignored when page is set."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "signature": {
      "type": "object",
      "properties": {
        "mark": {
          "enum": [
            "logo",
            "dot"
          ],
          "type": "string",
          "description": "Resting look: 'dot' (senna dot, default) or 'logo' (Dotsy logo)."
        },
        "reveal": {
          "enum": [
            "pill",
            "seal"
          ],
          "type": "string",
          "description": "On hover: 'seal' (rotating stamp, default) or 'pill' (\"Made with Dotsy\")."
        },
        "enabled": {
          "type": "boolean",
          "description": "Show the badge in the bottom-right corner of every published page."
        }
      },
      "description": "\"Made with Dotsy\" signature badge. Takes effect on the live site immediately, no publish needed.",
      "additionalProperties": false
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    },
    "editingMode": {
      "enum": [
        "live",
        "staged"
      ],
      "type": "string",
      "description": "How the editor's Save behaves. 'live' (default) publishes each save immediately; 'staged' keeps saves as drafts until publish_site. Prefer 'staged' when an agent will hand the editor to a person (see start_edit_session → draftEditorUrl) so keystrokes don't go straight to the public site. API writes always stage regardless of this setting."
    },
    "ownSeoFiles": {
      "type": "boolean",
      "description": "Use the site's own robots.txt and sitemap.xml even when they can hurt search: a robots.txt that blocks the whole site (Disallow: /), and a static sitemap.xml, which replaces the generated one (collection pages included). Off by default; a robots.txt without Disallow: / is always used. Takes effect at the next publish."
    },
    "keyConvention": {
      "enum": [
        "flat",
        "directory"
      ],
      "type": "string"
    },
    "trailingSlash": {
      "enum": [
        "ignore",
        "never",
        "always"
      ],
      "type": "string",
      "description": "Page URL form. 'ignore' (default): /blog and /blog/ both serve the page. 'never': /blog/ 301s to /blog. 'always': /blog 301s to /blog/. The canonical tag and sitemap use the same form. Live immediately, no publish needed."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "context"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "Site slug, e.g. acme-studio"
    },
    "codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only these health codes, e.g. perf_image_heavy."
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Routes to check; omit to verify every route on the site."
    },
    "detail": {
      "enum": [
        "summary",
        "full"
      ],
      "type": "string",
      "description": "summary (default): grouped by code, clean pages counted. full: per-page lists."
    },
    "groups": {
      "type": "array",
      "items": {
        "enum": [
          "seo",
          "speed",
          "a11y",
          "links"
        ],
        "type": "string"
      },
      "description": "Only these groups: speed = perf_*, a11y = a11y_*, links = link_* + content_*. Omit for all."
    },
    "context": {
      "type": "string",
      "minLength": 1,
      "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
    },
    "guestToken": {
      "type": "string",
      "minLength": 20,
      "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
    }
  },
  "additionalProperties": false
}