app.suggestibility.ai

{
  "name": "list_review_options",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the review board sizes available for purchase, with prices. Call this before recommending a board size so the recommendation is grounded in what the customer can actually buy.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "recommend_board_size",
  "kind": "act",
  "impl": "imperative",
  "description": "Analyse an artifact and recommend how many independent reviewers (3, 5, or 7) it warrants, with reasoning. ADVISORY ONLY — this does not purchase or change the delivered panel. Present the trade-off and let the human choose what to pay for.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "content": {
        "type": "string",
        "description": "The full artifact text to assess."
      },
      "stakes": {
        "type": "string",
        "enum": [
          "low",
          "medium",
          "high"
        ],
        "description": "How consequential or hard to reverse this decision is, if the user has said."
      }
    },
    "required": [
      "content"
    ]
  }
}

{
  "name": "submit_artifact_for_review",
  "kind": "transact",
  "impl": "imperative",
  "description": "Submit a technical artifact to the Suggestibility expert review board. Returns a review_id. The number of reviewers convened is determined by the purchased plan, not by this call. Reviews are asynchronous — poll get_review_status.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string",
        "description": "Short title for the artifact."
      },
      "content": {
        "type": "string",
        "description": "The full artifact text (minimum 200 characters)."
      },
      "type": {
        "type": "string",
        "description": "Optional artifact type hint, e.g. 'architecture decision', 'policy', 'design doc'."
      }
    },
    "required": [
      "content"
    ]
  }
}

{
  "name": "get_review_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Check whether a submitted review has finished. Returns status and, once complete, the panel that was convened.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "review_id": {
        "type": "string"
      }
    },
    "required": [
      "review_id"
    ]
  }
}

{
  "name": "get_review_package",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch the completed review package: the consensus position, the preserved dissent, prioritised recommendations, and which model produced each finding.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "review_id": {
        "type": "string"
      }
    },
    "required": [
      "review_id"
    ]
  }
}

{
  "name": "list_sample_artifacts",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the sample artifacts bundled with this page, spanning different domains and board sizes. These are documents to review, not pre-computed results — submit one to see what the board produces.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "load_sample_artifact",
  "kind": "act",
  "impl": "imperative",
  "description": "Load a sample artifact by id, plus any review already run against it in this session. Renders it into the page so the human reads what you are holding.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sample_id": {
        "type": "string",
        "description": "id from list_sample_artifacts"
      }
    },
    "required": [
      "sample_id"
    ]
  }
}

{
  "name": "explore_dissent",
  "kind": "answer",
  "impl": "imperative",
  "description": "Extract only the minority positions from a review package — the findings the board did NOT agree on. This is the part most review tools smooth away; use it when the human asks what the reviewers disagreed about.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "review_id": {
        "type": "string"
      }
    },
    "required": [
      "review_id"
    ]
  }
}