initiative-plugin-sdk 10.0.1 → 10.1.0

package/schemas/plugin-api.json

@@ -2,10 +2,10 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Initiative plug-in API",
-    "version": "10.0.1",
+    "version": "10.1.0",
     "x-initiative-source": {
-      "version": "0.77.1",
-      "commit": "d862d0ebdc3360b92d6a6ceeafee1d945577cdfc"
+      "version": "0.78.0",
+      "commit": "402991395c489c54783b943ecd0003d22377072f"
     }
   },
   "servers": [
@@ -10311,7 +10311,7 @@
           "properties"
         ],
         "summary": "Set Properties",
-        "description": "Replace the custom property values on one tool or sub-tool, or with\n``merge`` write only the ones named and leave the rest, and change options\nof multi-select values against what each holds.\n\nRequires write on the tool that governs it: a tool itself, or the tool a\nsub-tool sits in (a task's project, an event's calendar). Each value's\ndefinition must belong to the same initiative, so a row that belongs to no\ninitiative carries none. Values are validated against each definition's\ntype and options. An installed plug-in names the person a person-valued\nproperty holds by its reference for them. An empty list clears them all.",
+        "description": "Replace the custom property values on one tool or sub-tool, or with\n``merge`` write only the ones named and leave the rest, change options of\nmulti-select values and step counters against what each holds.\n\nRequires write on the tool that governs it: a tool itself, or the tool a\nsub-tool sits in (a task's project, an event's calendar). Each value's\ndefinition must belong to the same initiative, so a row that belongs to no\ninitiative carries none. Values are validated against each definition's\ntype and options. An installed plug-in names the person a person-valued\nproperty holds by its reference for them. An empty list clears them all.",
         "operationId": "set_properties",
         "security": [
           {
@@ -10754,6 +10754,16 @@
   },
   "components": {
     "schemas": {
+      "ActorKind": {
+        "type": "string",
+        "enum": [
+          "member",
+          "plugin",
+          "system"
+        ],
+        "title": "ActorKind",
+        "description": "Who did something to a row: what its ``created_by`` (made it) or\n``deleted_by`` (put it in the trash) names."
+      },
       "ArchivableType": {
         "type": "string",
         "enum": [
@@ -11112,6 +11122,32 @@
       },
       "CalendarEventRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "title": {
             "type": "string",
             "maxLength": 255,
@@ -11228,18 +11264,6 @@
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "properties": {
             "items": {
               "$ref": "#/components/schemas/PropertySummary"
@@ -11300,6 +11324,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "title",
           "description",
           "location",
@@ -11315,7 +11342,6 @@
           "calendar_id",
           "initiative_id",
           "community_id",
-          "created_by",
           "properties",
           "tags",
           "can",
@@ -11569,26 +11595,22 @@
       },
       "CalendarRead": {
         "properties": {
-          "archived_at": {
+          "created_by": {
             "anyOf": [
               {
                 "type": "string",
-                "format": "date-time"
+                "x-identity": "person"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Archived At"
-          },
-          "can": {
-            "$ref": "#/components/schemas/ToolCan"
+            "title": "Created By"
           },
-          "id": {
-            "type": "integer",
-            "title": "Id"
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
           },
-          "initiative_id": {
+          "created_by_install": {
             "anyOf": [
               {
                 "type": "integer"
@@ -11597,24 +11619,31 @@
                 "type": "null"
               }
             ],
-            "title": "Initiative Id"
-          },
-          "community_id": {
-            "title": "Community Id",
-            "type": "string",
-            "x-identity": "community"
+            "title": "Created By Install"
           },
-          "created_by": {
+          "archived_at": {
             "anyOf": [
               {
                 "type": "string",
-                "x-identity": "person"
+                "format": "date-time"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Created By"
+            "title": "Archived At"
+          },
+          "can": {
+            "$ref": "#/components/schemas/ToolCan"
+          },
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "community_id": {
+            "title": "Community Id",
+            "type": "string",
+            "x-identity": "community"
           },
           "created_at": {
             "type": "string",
@@ -11676,16 +11705,28 @@
             "maxLength": 32,
             "title": "Color",
             "default": "#6366f1"
+          },
+          "initiative_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Initiative Id"
           }
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -11694,32 +11735,29 @@
           "grants",
           "name",
           "description",
-          "color"
+          "color",
+          "initiative_id"
         ],
         "title": "CalendarRead"
       },
       "CalendarSummary": {
         "properties": {
-          "archived_at": {
+          "created_by": {
             "anyOf": [
               {
                 "type": "string",
-                "format": "date-time"
+                "x-identity": "person"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Archived At"
-          },
-          "can": {
-            "$ref": "#/components/schemas/ToolCan"
+            "title": "Created By"
           },
-          "id": {
-            "type": "integer",
-            "title": "Id"
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
           },
-          "initiative_id": {
+          "created_by_install": {
             "anyOf": [
               {
                 "type": "integer"
@@ -11728,24 +11766,31 @@
                 "type": "null"
               }
             ],
-            "title": "Initiative Id"
-          },
-          "community_id": {
-            "title": "Community Id",
-            "type": "string",
-            "x-identity": "community"
+            "title": "Created By Install"
           },
-          "created_by": {
+          "archived_at": {
             "anyOf": [
               {
                 "type": "string",
-                "x-identity": "person"
+                "format": "date-time"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Created By"
+            "title": "Archived At"
+          },
+          "can": {
+            "$ref": "#/components/schemas/ToolCan"
+          },
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "community_id": {
+            "title": "Community Id",
+            "type": "string",
+            "x-identity": "community"
           },
           "created_at": {
             "type": "string",
@@ -11807,16 +11852,28 @@
             "maxLength": 32,
             "title": "Color",
             "default": "#6366f1"
+          },
+          "initiative_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Initiative Id"
           }
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -11825,7 +11882,8 @@
           "grants",
           "name",
           "description",
-          "color"
+          "color",
+          "initiative_id"
         ],
         "title": "CalendarSummary"
       },
@@ -12208,6 +12266,32 @@
       },
       "CollectionFileSummary": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -12227,27 +12311,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -12288,6 +12356,10 @@
             "type": "string",
             "title": "Name"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "featured_image_url": {
             "anyOf": [
               {
@@ -12457,12 +12529,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -12470,6 +12543,7 @@
           "properties",
           "grants",
           "name",
+          "initiative_id",
           "featured_image_url",
           "is_template",
           "initiative",
@@ -12536,6 +12610,32 @@
       },
       "CollectionRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "id": {
             "type": "integer",
             "title": "Id"
@@ -12595,18 +12695,6 @@
           "hidden_files": {
             "$ref": "#/components/schemas/HiddenFiles"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -12678,6 +12766,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "id",
           "initiative_id",
           "community_id",
@@ -12687,7 +12778,6 @@
           "cover",
           "file_count",
           "hidden_files",
-          "created_by",
           "created_at",
           "updated_at",
           "archived_at",
@@ -12801,7 +12891,8 @@
                 "enum": [
                   "number",
                   "stars",
-                  "bar"
+                  "bar",
+                  "clock"
                 ]
               },
               {
@@ -13158,6 +13249,32 @@
       },
       "CommentRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "content": {
             "type": "string",
             "title": "Content",
@@ -13289,19 +13406,7 @@
             "type": "integer",
             "title": "Id"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
-          "parent_comment_id": {
+          "parent_comment_id": {
             "anyOf": [
               {
                 "type": "integer"
@@ -13390,6 +13495,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "content",
           "task_id",
           "wiki_page_id",
@@ -13403,7 +13511,6 @@
           "wiki_id",
           "contact_id",
           "id",
-          "created_by",
           "parent_comment_id",
           "created_at",
           "updated_at",
@@ -13638,6 +13745,36 @@
         ],
         "title": "ContactListResponse"
       },
+      "ContactOrganization": {
+        "properties": {
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "name": {
+            "type": "string",
+            "title": "Name"
+          },
+          "initiative_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Initiative Id"
+          }
+        },
+        "type": "object",
+        "required": [
+          "id",
+          "name"
+        ],
+        "title": "ContactOrganization",
+        "description": "The organization a person is ``part_of``."
+      },
       "ContactPhone": {
         "properties": {
           "label": {
@@ -13661,26 +13798,22 @@
       },
       "ContactRead": {
         "properties": {
-          "archived_at": {
+          "created_by": {
             "anyOf": [
               {
                 "type": "string",
-                "format": "date-time"
+                "x-identity": "person"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Archived At"
-          },
-          "can": {
-            "$ref": "#/components/schemas/ToolCan"
+            "title": "Created By"
           },
-          "id": {
-            "type": "integer",
-            "title": "Id"
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
           },
-          "initiative_id": {
+          "created_by_install": {
             "anyOf": [
               {
                 "type": "integer"
@@ -13689,24 +13822,31 @@
                 "type": "null"
               }
             ],
-            "title": "Initiative Id"
-          },
-          "community_id": {
-            "title": "Community Id",
-            "type": "string",
-            "x-identity": "community"
+            "title": "Created By Install"
           },
-          "created_by": {
+          "archived_at": {
             "anyOf": [
               {
                 "type": "string",
-                "x-identity": "person"
+                "format": "date-time"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Created By"
+            "title": "Archived At"
+          },
+          "can": {
+            "$ref": "#/components/schemas/ToolCan"
+          },
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "community_id": {
+            "title": "Community Id",
+            "type": "string",
+            "x-identity": "community"
           },
           "created_at": {
             "type": "string",
@@ -13744,6 +13884,17 @@
             "type": "array",
             "title": "Grants"
           },
+          "initiative_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Initiative Id"
+          },
           "name": {
             "type": "string",
             "title": "Name"
@@ -13776,57 +13927,66 @@
           },
           "websites": {
             "items": {
-              "$ref": "#/components/schemas/ContactDetail"
+              "$ref": "#/components/schemas/ContactWebsite"
             },
             "type": "array",
             "title": "Websites"
+          },
+          "organization": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ContactOrganization"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
           "tags",
           "properties",
           "grants",
+          "initiative_id",
           "name",
           "is_organization",
           "emails",
           "phones",
           "addresses",
-          "websites"
+          "websites",
+          "organization"
         ],
         "title": "ContactRead"
       },
       "ContactSummary": {
         "properties": {
-          "archived_at": {
+          "created_by": {
             "anyOf": [
               {
                 "type": "string",
-                "format": "date-time"
+                "x-identity": "person"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Archived At"
+            "title": "Created By"
           },
-          "can": {
-            "$ref": "#/components/schemas/ToolCan"
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
           },
-          "id": {
-            "type": "integer",
-            "title": "Id"
-          },
-          "initiative_id": {
+          "created_by_install": {
             "anyOf": [
               {
                 "type": "integer"
@@ -13835,24 +13995,31 @@
                 "type": "null"
               }
             ],
-            "title": "Initiative Id"
+            "title": "Created By Install"
           },
-          "community_id": {
-            "title": "Community Id",
-            "type": "string",
-            "x-identity": "community"
-          },
-          "created_by": {
+          "archived_at": {
             "anyOf": [
               {
                 "type": "string",
-                "x-identity": "person"
+                "format": "date-time"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Created By"
+            "title": "Archived At"
+          },
+          "can": {
+            "$ref": "#/components/schemas/ToolCan"
+          },
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "community_id": {
+            "title": "Community Id",
+            "type": "string",
+            "x-identity": "community"
           },
           "created_at": {
             "type": "string",
@@ -13890,6 +14057,17 @@
             "type": "array",
             "title": "Grants"
           },
+          "initiative_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Initiative Id"
+          },
           "name": {
             "type": "string",
             "title": "Name"
@@ -13922,32 +14100,45 @@
           },
           "websites": {
             "items": {
-              "$ref": "#/components/schemas/ContactDetail"
+              "$ref": "#/components/schemas/ContactWebsite"
             },
             "type": "array",
             "title": "Websites"
+          },
+          "organization": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ContactOrganization"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
           "tags",
           "properties",
           "grants",
+          "initiative_id",
           "name",
           "is_organization",
           "emails",
           "phones",
           "addresses",
-          "websites"
+          "websites",
+          "organization"
         ],
         "title": "ContactSummary"
       },
@@ -14287,6 +14478,32 @@
       },
       "CounterGroupRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -14306,27 +14523,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -14382,6 +14583,10 @@
             ],
             "title": "Description"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "preview": {
             "anyOf": [
               {
@@ -14406,12 +14611,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -14420,6 +14626,7 @@
           "grants",
           "name",
           "description",
+          "initiative_id",
           "preview",
           "counters"
         ],
@@ -14427,6 +14634,32 @@
       },
       "CounterGroupSummary": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -14446,27 +14679,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -14522,6 +14739,10 @@
             ],
             "title": "Description"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "preview": {
             "anyOf": [
               {
@@ -14539,12 +14760,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -14553,6 +14775,7 @@
           "grants",
           "name",
           "description",
+          "initiative_id",
           "preview"
         ],
         "title": "CounterGroupSummary",
@@ -14757,6 +14980,92 @@
         ],
         "title": "CounterSetCountRequest"
       },
+      "CounterSettings-Input": {
+        "properties": {
+          "step": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "title": "Step",
+            "default": 1
+          },
+          "min": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Min"
+          },
+          "max": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Max"
+          },
+          "initial": {
+            "type": "number",
+            "title": "Initial",
+            "default": 0
+          }
+        },
+        "type": "object",
+        "title": "CounterSettings",
+        "description": "How a counter field moves: by ``step`` a tap, never past ``min`` or\n``max``, and back to ``initial`` on a reset. A counter with no value\nholds ``initial``."
+      },
+      "CounterSettings-Output": {
+        "properties": {
+          "step": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "title": "Step",
+            "default": 1
+          },
+          "min": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Min"
+          },
+          "max": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Max"
+          },
+          "initial": {
+            "type": "number",
+            "title": "Initial",
+            "default": 0
+          }
+        },
+        "type": "object",
+        "required": [
+          "step",
+          "min",
+          "max",
+          "initial"
+        ],
+        "title": "CounterSettings",
+        "description": "How a counter field moves: by ``step`` a tap, never past ``min`` or\n``max``, and back to ``initial`` on a reset. A counter with no value\nholds ``initial``."
+      },
       "CounterSortDirection": {
         "type": "string",
         "enum": [
@@ -15263,6 +15572,32 @@
       },
       "FileRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -15282,27 +15617,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -15343,6 +15662,10 @@
             "type": "string",
             "title": "Name"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "featured_image_url": {
             "anyOf": [
               {
@@ -15537,12 +15860,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -15550,6 +15874,7 @@
           "properties",
           "grants",
           "name",
+          "initiative_id",
           "featured_image_url",
           "is_template",
           "initiative",
@@ -15575,6 +15900,32 @@
       },
       "FileSummary": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -15594,27 +15945,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -15655,6 +15990,10 @@
             "type": "string",
             "title": "Name"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "featured_image_url": {
             "anyOf": [
               {
@@ -15812,12 +16151,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -15825,6 +16165,7 @@
           "properties",
           "grants",
           "name",
+          "initiative_id",
           "featured_image_url",
           "is_template",
           "initiative",
@@ -16014,6 +16355,32 @@
       },
       "FileVersionRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "id": {
             "type": "integer",
             "title": "Id"
@@ -16055,17 +16422,6 @@
             ],
             "title": "Original Filename"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -16079,12 +16435,14 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "id",
           "version_number",
           "file_content_type",
           "file_size",
           "original_filename",
-          "created_by",
           "created_at",
           "is_current"
         ],
@@ -16580,6 +16938,9 @@
           "user_reference",
           "currency",
           "scale",
+          "counter",
+          "file",
+          "signature",
           "link",
           "badge",
           "json"
@@ -17055,6 +17416,32 @@
       },
       "PostRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -17074,27 +17461,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -17137,6 +17508,10 @@
             "minLength": 1,
             "title": "Name"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "author": {
             "anyOf": [
               {
@@ -17283,12 +17658,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -17296,6 +17672,7 @@
           "properties",
           "grants",
           "name",
+          "initiative_id",
           "author",
           "excerpt",
           "pinned_at",
@@ -17557,6 +17934,32 @@
       },
       "ProjectRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -17576,27 +17979,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -17686,6 +18073,10 @@
             ],
             "title": "End Date"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "owner_id": {
             "anyOf": [
               {
@@ -17764,12 +18155,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -17781,6 +18173,7 @@
           "icon",
           "start_date",
           "end_date",
+          "initiative_id",
           "owner_id",
           "is_template",
           "pinned_at",
@@ -17977,6 +18370,16 @@
               }
             ]
           },
+          "counter": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/CounterSettings-Input"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "initiative_id": {
             "type": "integer",
             "title": "Initiative Id"
@@ -18162,6 +18565,16 @@
               }
             ]
           },
+          "counter": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/CounterSettings-Output"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "id": {
             "type": "integer",
             "title": "Id"
@@ -18211,6 +18624,7 @@
           "color",
           "options",
           "currency",
+          "counter",
           "id",
           "initiative_id",
           "project_id",
@@ -18281,6 +18695,16 @@
                 "type": "null"
               }
             ]
+          },
+          "counter": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/CounterSettings-Input"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "type": "object",
@@ -18367,10 +18791,29 @@
         },
         "type": "object",
         "required": [
-          "property_id"
+          "property_id"
+        ],
+        "title": "PropertyOptionsChange",
+        "description": "Options put on and taken off one multi-select value, against the value\nas it stands when the change is written rather than a list that replaces\nit, so two people changing different options of it both stand."
+      },
+      "PropertyStep": {
+        "properties": {
+          "property_id": {
+            "type": "integer",
+            "title": "Property Id"
+          },
+          "up": {
+            "type": "boolean",
+            "title": "Up"
+          }
+        },
+        "type": "object",
+        "required": [
+          "property_id",
+          "up"
         ],
-        "title": "PropertyOptionsChange",
-        "description": "Options put on and taken off one multi-select value, against the value\nas it stands when the change is written rather than a list that replaces\nit, so two people changing different options of it both stand."
+        "title": "PropertyStep",
+        "description": "One step of a counter, up or down, from the value it holds when the\nstep is written, so two people stepping it at once both count."
       },
       "PropertySummary": {
         "properties": {
@@ -18453,9 +18896,19 @@
               }
             ]
           },
+          "counter": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/CounterSettings-Output"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "value": {
             "title": "Value",
-            "description": "Shaped by the definition's type. For user_reference, a person: id, username, discriminator, display_name and avatar_url, or an PluginPerson when the reader is an installed plug-in. A plug-in's value is as the plug-in wrote it: a list field's an array of its elements, newest first, each with its ref, and a value with a state the state beside it."
+            "description": "Shaped by the definition's type. For user_reference, a person: id, username, discriminator, display_name and avatar_url, or an PluginPerson when the reader is an installed plug-in. For file, a file: id, name, file_type and smart_link_url, or its id alone where the reader cannot open it. For signature, the signer as user (a person, shaped as user_reference's), the name they typed and when they signed: user, name and signed_at. A plug-in's value is as the plug-in wrote it: a list field's an array of its elements, newest first, each with its ref, and a value with a state the state beside it."
           }
         },
         "type": "object",
@@ -18469,6 +18922,7 @@
           "key",
           "options",
           "currency",
+          "counter",
           "value"
         ],
         "title": "PropertySummary",
@@ -18540,6 +18994,14 @@
             "type": "array",
             "maxItems": 100,
             "title": "Options"
+          },
+          "steps": {
+            "items": {
+              "$ref": "#/components/schemas/PropertyStep"
+            },
+            "type": "array",
+            "maxItems": 100,
+            "title": "Steps"
           }
         },
         "type": "object",
@@ -19122,6 +19584,32 @@
       },
       "TaskListRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "title": {
             "type": "string",
             "title": "Title"
@@ -19260,18 +19748,6 @@
             ],
             "title": "Archived At"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "assignees": {
             "items": {
               "$ref": "#/components/schemas/PluginPerson"
@@ -19446,6 +19922,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "title",
           "priority",
           "start_date",
@@ -19466,7 +19945,6 @@
           "completed_at",
           "position",
           "archived_at",
-          "created_by",
           "assignees",
           "recurrence_occurrence_count",
           "recurrence_shift",
@@ -19676,6 +20154,32 @@
       },
       "TaskRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "title": {
             "type": "string",
             "title": "Title"
@@ -19809,18 +20313,6 @@
             ],
             "title": "Archived At"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "creator": {
             "anyOf": [
               {
@@ -19972,6 +20464,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "title",
           "priority",
           "start_date",
@@ -19991,7 +20486,6 @@
           "completed_at",
           "position",
           "archived_at",
-          "created_by",
           "creator",
           "assignees",
           "recurrence_occurrence_count",
@@ -21193,6 +21687,32 @@
       },
       "WikiPageRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "id": {
             "type": "integer",
             "title": "Id"
@@ -21239,18 +21759,6 @@
             "type": "string",
             "title": "Slug"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -21359,6 +21867,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "id",
           "wiki_id",
           "community_id",
@@ -21368,7 +21879,6 @@
           "is_draft",
           "title",
           "slug",
-          "created_by",
           "created_at",
           "updated_at",
           "headings",
@@ -21387,6 +21897,32 @@
       },
       "WikiPageSummary": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "id": {
             "type": "integer",
             "title": "Id"
@@ -21433,18 +21969,6 @@
             "type": "string",
             "title": "Slug"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -21523,6 +22047,9 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "id",
           "wiki_id",
           "community_id",
@@ -21532,7 +22059,6 @@
           "is_draft",
           "title",
           "slug",
-          "created_by",
           "created_at",
           "updated_at",
           "headings",
@@ -21649,6 +22175,32 @@
       },
       "WikiRead": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -21668,27 +22220,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -21745,6 +22281,10 @@
             ],
             "title": "Description"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "home_page_id": {
             "anyOf": [
               {
@@ -21812,12 +22352,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -21826,6 +22367,7 @@
           "grants",
           "name",
           "description",
+          "initiative_id",
           "home_page_id",
           "page_order",
           "contents_depth",
@@ -21851,6 +22393,32 @@
       },
       "WikiSummary": {
         "properties": {
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
+          "created_by_kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "created_by_install": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By Install"
+          },
           "archived_at": {
             "anyOf": [
               {
@@ -21870,27 +22438,11 @@
             "type": "integer",
             "title": "Id"
           },
-          "initiative_id": {
-            "type": "integer",
-            "title": "Initiative Id"
-          },
           "community_id": {
             "title": "Community Id",
             "type": "string",
             "x-identity": "community"
           },
-          "created_by": {
-            "anyOf": [
-              {
-                "type": "string",
-                "x-identity": "person"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Created By"
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -21947,6 +22499,10 @@
             ],
             "title": "Description"
           },
+          "initiative_id": {
+            "type": "integer",
+            "title": "Initiative Id"
+          },
           "home_page_id": {
             "anyOf": [
               {
@@ -22011,12 +22567,13 @@
         },
         "type": "object",
         "required": [
+          "created_by",
+          "created_by_kind",
+          "created_by_install",
           "archived_at",
           "can",
           "id",
-          "initiative_id",
           "community_id",
-          "created_by",
           "created_at",
           "updated_at",
           "comments_enabled",
@@ -22025,6 +22582,7 @@
           "grants",
           "name",
           "description",
+          "initiative_id",
           "home_page_id",
           "page_order",
           "contents_depth",