catalog-health-copilot.mamandallc.workers.dev

{
  "name": "scan_catalog",
  "kind": "act",
  "impl": "imperative",
  "description": "Fetch and audit the full product catalog for search and AI-agent readiness. Updates the visible issue queue and health score; does not write product data.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_health_score",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the current cached health, search-ready, agent-ready, and category scores. Does not run a new scan or change the UI.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "list_issues",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the currently ranked catalog issues using optional narrow filters. Does not change product data.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "severity": {
        "type": "string",
        "enum": [
          "critical",
          "warning",
          "info"
        ]
      },
      "category": {
        "type": "string",
        "enum": [
          "identifiers",
          "content",
          "media",
          "seo",
          "commercial",
          "agent_readiness"
        ]
      },
      "product_id": {
        "type": "string"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "default": 20
      }
    }
  }
}

{
  "name": "show_issue",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate the visible workspace to one issue and return its full audit payload. Does not write product data.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "issue_id": {
        "type": "string"
      }
    },
    "required": [
      "issue_id"
    ]
  }
}

{
  "name": "generate_fix",
  "kind": "act",
  "impl": "imperative",
  "description": "Generate and visibly queue a proposed field change for merchant review. This creates a draft only and never writes to Shopify.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "issue_id": {
        "type": "string"
      },
      "tone": {
        "type": "string",
        "enum": [
          "literal",
          "brand"
        ],
        "default": "literal"
      }
    },
    "required": [
      "issue_id"
    ]
  }
}

{
  "name": "apply_fix",
  "kind": "act",
  "impl": "imperative",
  "description": "Writes the reviewed changes to the Shopify product via the Admin API, marks the issue resolved in the visible UI, and verifies the live values. Requires an existing generated draft.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "issue_id": {
        "type": "string"
      },
      "overrides": {
        "type": "array",
        "maxItems": 10,
        "items": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "field": {
              "type": "string"
            },
            "value": {
              "type": "string"
            }
          },
          "required": [
            "field",
            "value"
          ]
        }
      }
    },
    "required": [
      "issue_id"
    ]
  }
}

{
  "name": "apply_approved",
  "kind": "act",
  "impl": "imperative",
  "description": "Writes up to 10 already-generated drafts sequentially to Shopify, verifies each result, and updates the visible queue. Skips issues without drafts.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "issue_ids": {
        "type": "array",
        "minItems": 1,
        "maxItems": 10,
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "issue_ids"
    ]
  }
}

{
  "name": "dismiss_issue",
  "kind": "act",
  "impl": "imperative",
  "description": "Removes an issue from the visible queue for this browser session and preserves the merchant's judgment. Never writes to Shopify.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "issue_id": {
        "type": "string"
      },
      "reason": {
        "type": "string",
        "maxLength": 240
      }
    },
    "required": [
      "issue_id"
    ]
  }
}

{
  "name": "verify_fix",
  "kind": "answer",
  "impl": "imperative",
  "description": "Re-fetches specified product fields from Shopify and compares them with the last applied change. Returns live values and pass/fail evidence; does not write data.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "product_id": {
        "type": "string"
      },
      "fields": {
        "type": "array",
        "minItems": 1,
        "maxItems": 10,
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "product_id",
      "fields"
    ]
  }
}

{
  "name": "preview_agent_view",
  "kind": "answer",
  "impl": "imperative",
  "description": "Render and return how a shopping agent reads one product before and after pending drafts, including taxonomy, attributes, variant grouping, and identifier completeness. Does not write data.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "product_id": {
        "type": "string"
      }
    },
    "required": [
      "product_id"
    ]
  }
}