LightRay

Use this when someone asks about a company or wants one checked. Give the company's name and, if known, its city or country. If a recent report on the company is stored, it comes back at once; otherwise a new report starts and the answer says when it will be ready. A new report uses one of the reader's reports; asking again for the same company does not. When several companies match the name, the answer lists them: ask the reader which one they mean, then call this again with that company's choice token. LightRay checks companies, not people.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The company's name, as it is registered if known: its legal name with its legal form, such as Limited or LLC.",
      "maxLength": 160
    },
    "place": {
      "type": "string",
      "description": "The company's city or country, if known. It helps find the right company.",
      "maxLength": 80
    },
    "choice": {
      "type": "string",
      "description": "The choice token of one company from the list this tool returned when several matched. Give it with the same name.",
      "maxLength": 40
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "ready",
        "building",
        "choose",
        "several",
        "no_company",
        "declined",
        "limit",
        "paused",
        "failed",
        "stopped",
        "expired",
        "not_found",
        "error"
      ]
    }
  },
  "required": [
    "status"
  ]
}

Use this to see how far a report has got and what has been found so far, or to read a ready report: its date, the main point, any questions to ask, what was found, the next steps, the companies worth a look next and its link. LightRay writes each report: the main point, questions, findings and next steps are LightRay's. Give the report_id that check_company or list_reports returned, or the report's link. Reading a report uses none of the reader's reports.

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string",
      "description": "The report_id that check_company or list_reports returned, or the report's link.",
      "maxLength": 300
    }
  },
  "required": [
    "report_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "ready",
        "building",
        "choose",
        "no_company",
        "paused",
        "failed",
        "stopped",
        "expired",
        "not_found",
        "error"
      ]
    }
  },
  "required": [
    "status"
  ]
}

Use this to see the reader's recent reports from here, newest first, each with whether it is ready and its link. It uses none of the reader's reports.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "How many reports to list, newest first: 1 to 20. 10 if not given.",
      "minimum": 1,
      "maximum": 20
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "listed"
      ]
    },
    "reports": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "status",
    "reports"
  ]
}