{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "list_result_collections",
        "list_fillout_links",
        "create_fillout_link",
        "revoke_fillout_link",
        "submit_fillout_link",
        "list_fillout_results",
        "create_adaptive_transition",
        "list_adaptive_transitions",
        "claim_adaptive_transition",
        "complete_adaptive_transition",
        "fail_adaptive_transition",
        "get",
        "validate_contract",
        "validate_answers",
        "create_submission",
        "save_draft",
        "submit",
        "list_submissions",
        "get_submission",
        "export_submission",
        "list_embedded_answers",
        "destinations",
        "writeback_status",
        "git_result_sync_status",
        "preview_result_writeback",
        "writeback_form",
        "writeback_submission",
        "list_git_results",
        "import_git_results"
      ],
      "description": "Operation to perform. Choose one advertised value; the remaining parameters are interpreted for that action."
    },
    "formId": {
      "type": "string",
      "description": "Stable Commentary Form identifier."
    },
    "linkId": {
      "type": "string",
      "description": "Stable link identifier used by the selected Commentary Forms action."
    },
    "filloutLinkId": {
      "type": "string",
      "description": "Stable fillout link identifier used by the selected Commentary Forms action."
    },
    "token": {
      "type": "string",
      "description": "Opaque response-link token. Treat it as a secret and send it only to Commentary."
    },
    "shareToken": {
      "type": "string",
      "description": "Opaque share token. Treat it as a secret and send it only to Commentary."
    },
    "submissionId": {
      "type": "string",
      "description": "Stable Form submission identifier."
    },
    "transitionRecordId": {
      "type": "string",
      "description": "Stable transition record identifier used by the selected Commentary Forms action."
    },
    "adaptiveTransitionId": {
      "type": "string",
      "description": "Stable adaptive transition identifier used by the selected Commentary Forms action."
    },
    "transitionId": {
      "type": "string",
      "description": "Stable transition identifier used by the selected Commentary Forms action."
    },
    "configTransitionId": {
      "type": "string",
      "description": "Stable config transition identifier used by the selected Commentary Forms action."
    },
    "transitionKey": {
      "type": "string",
      "description": "Transition key used by the selected Commentary Forms action."
    },
    "sectionId": {
      "type": "string",
      "description": "Stable section identifier used by the selected Commentary Forms action."
    },
    "state": {
      "type": "string",
      "enum": [
        "pending",
        "claimed",
        "completed",
        "failed",
        "timeout",
        "fallback",
        "all"
      ],
      "description": "State filter supported by the selected action."
    },
    "resultAction": {
      "type": "string",
      "enum": [
        "show_section",
        "complete",
        "fallback"
      ],
      "description": "Allowed result action value for the selected Commentary Forms action."
    },
    "completionAction": {
      "type": "string",
      "enum": [
        "show_section",
        "complete",
        "fallback"
      ],
      "description": "Allowed completion action value for the selected Commentary Forms action."
    },
    "adaptiveAction": {
      "type": "string",
      "enum": [
        "show_section",
        "complete",
        "fallback"
      ],
      "description": "Allowed adaptive action value for the selected Commentary Forms action."
    },
    "section": {
      "type": "object",
      "description": "Section object used by the selected Commentary Forms action."
    },
    "generatedSection": {
      "type": "object",
      "description": "Generated section object used by the selected Commentary Forms action."
    },
    "submissionIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Form submission identifiers to process together; at most 50 are accepted."
    },
    "referenceId": {
      "type": "string",
      "description": "Stable reference identifier used by the selected Commentary Forms action."
    },
    "title": {
      "type": "string",
      "description": "Human-readable title for the created or updated artifact."
    },
    "description": {
      "type": "string",
      "description": "Human-readable description for the created or updated artifact."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "private",
        "shared",
        "public_placeholder"
      ],
      "description": "Allowed visibility value for the selected Commentary Forms action."
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "commentary",
        "github",
        "embedded",
        "custom"
      ],
      "description": "Origin classification for the created or resolved source artifact."
    },
    "contract": {
      "type": "object",
      "description": "Parsed Commentary Form Contract object to validate or use."
    },
    "contractSource": {
      "type": "string",
      "description": "Literal JSON or YAML Form Contract source to parse and validate."
    },
    "sourceFormat": {
      "type": "string",
      "enum": [
        "json",
        "yaml",
        "auto"
      ],
      "description": "Serialization format of the supplied source contract."
    },
    "sourceMetadata": {
      "type": "object",
      "description": "Source metadata object used by the selected Commentary Forms action."
    },
    "destinationConfig": {
      "type": "object",
      "description": "Destination config object used by the selected Commentary Forms action."
    },
    "target": {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Repository owner or organization login."
        },
        "repo": {
          "type": "string",
          "description": "Repository name without the owner prefix."
        },
        "branch": {
          "type": "string",
          "description": "Branch used by the selected Commentary Forms action."
        },
        "ref": {
          "type": "string",
          "description": "Ref used by the selected Commentary Forms action."
        },
        "path": {
          "type": "string",
          "description": "Source-relative file path used by the selected action."
        },
        "sourcePath": {
          "type": "string",
          "description": "Source path used by the selected Commentary Forms action."
        },
        "baseBranch": {
          "type": "string",
          "description": "Base branch used by the selected Commentary Forms action."
        },
        "createBranch": {
          "type": "boolean",
          "description": "Whether to enable create branch for the selected Commentary Forms action."
        }
      },
      "additionalProperties": true,
      "description": "Explicit source or repository destination used by the selected action."
    },
    "format": {
      "type": "string",
      "enum": [
        "json",
        "yaml",
        "csv"
      ],
      "description": "Allowed format value for the selected Commentary Forms action."
    },
    "commitMessage": {
      "type": "string",
      "description": "Commit message for an explicit Git writeback operation."
    },
    "openPullRequest": {
      "type": "boolean",
      "description": "Whether an eligible Git writeback action should also open a pull request."
    },
    "pullRequestTitle": {
      "type": "string",
      "description": "Title for the pull request opened by an explicit writeback operation."
    },
    "pullRequestBody": {
      "type": "string",
      "description": "Markdown body for the pull request opened by an explicit writeback operation."
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Source-relative paths used by the selected action."
    },
    "values": {
      "type": "object",
      "description": "Question-id to answer-value object for Form validation or submission."
    },
    "sourceContext": {
      "type": "object",
      "description": "Source identity returned by Commentary and passed back unchanged to scope embedded Form operations."
    },
    "sourceReviewHref": {
      "type": "string",
      "description": "Canonical Commentary review URL associated with the source artifact."
    },
    "renderer": {
      "type": "object",
      "properties": {
        "mode": {
          "type": "string",
          "enum": [
            "default",
            "review_file"
          ],
          "description": "Allowed mode value for the selected Commentary Forms action."
        },
        "path": {
          "type": "string",
          "description": "Source-relative file path used by the selected action."
        },
        "kind": {
          "type": "string",
          "enum": [
            "markdown",
            "html"
          ],
          "description": "Allowed kind value for the selected Commentary Forms action."
        }
      },
      "additionalProperties": true,
      "description": "Renderer object used by the selected Commentary Forms action."
    },
    "shareMode": {
      "type": "string",
      "enum": [
        "specific_user",
        "authenticated",
        "anonymous"
      ],
      "description": "Allowed share mode value for the selected Commentary Forms action."
    },
    "replyMode": {
      "type": "string",
      "enum": [
        "identified",
        "anonymous"
      ],
      "description": "Allowed reply mode value for the selected Commentary Forms action."
    },
    "repeatSubmissions": {
      "type": "boolean",
      "description": "Whether to enable repeat submissions for the selected Commentary Forms action."
    },
    "recipient": {
      "type": "object",
      "description": "User identity or recipient descriptor used by an explicitly selected sharing action."
    },
    "submissionOrigin": {
      "type": "string",
      "enum": [
        "api",
        "mcp",
        "cli",
        "agent_api"
      ],
      "description": "Allowed submission origin value for the selected Commentary Forms action."
    },
    "agentAlias": {
      "type": "string",
      "description": "Stable agent identifier for agent-authored activity. Agents should always provide this on state-changing calls; clientName is not a substitute."
    },
    "clientName": {
      "type": "string",
      "description": "Optional calling-client label for diagnostics. It does not attribute agent-authored activity; use agentAlias for that."
    }
  },
  "required": [
    "action"
  ]
}