initiative-plugin-sdk 9.0.0 → 10.0.0

package/dist/plugin-api.generated.d.ts

@@ -1,6 +1,6 @@
 /**
  * Generated by scripts/generate-plugin-api.mjs from schemas/plugin-api.json, the plug-in API
- * taken from Initiative 0.77.1 (commit 1a62d88cd). Do not edit: regenerate.
+ * taken from Initiative 0.77.1 (commit d862d0ebd). Do not edit: regenerate.
  */
 import type { Scope } from "./contract.js";
 /**
@@ -31,7 +31,7 @@ export interface PluginApiSchemas {
     /**
      * Things that can be archived.
      */
-    ArchivableType: "project" | "file" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "task" | "initiative" | "collection";
+    ArchivableType: "project" | "file" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "contact" | "task" | "initiative" | "collection";
     /**
      * What archiving or unarchiving answers with.
      */
@@ -106,7 +106,6 @@ export interface PluginApiSchemas {
         overridden_fields: string[];
         skipped_starts: string[];
         extra_starts: string[];
-        plugin_values: PluginApiSchemas["PluginValueSummary"][];
     };
     CalendarEventUpdate: {
         properties?: PluginApiSchemas["PropertyValueInput"][] | null;
@@ -241,9 +240,9 @@ export interface PluginApiSchemas {
     };
     /**
      * A new collection, made with the files it starts with: a collection is never
-     * empty. It starts blank (its grid and table, and no fields of its own), as a
-     * ready-made `shape`, or with the fields and lists of another collection in
-     * the initiative (`shape_from`), none of its values.
+     * empty. It starts blank (its grid and table, and no metadata of its own), as
+     * a ready-made `shape`, or with the metadata and lists of another collection
+     * in the initiative (`shape_from`), none of its values.
      */
     CollectionCreate: {
         properties?: PluginApiSchemas["PropertyValueInput"][];
@@ -265,7 +264,7 @@ export interface PluginApiSchemas {
     };
     /**
      * A file as its collection lists it: with when it was added there, and its
-     * values of the collection's own fields.
+     * values of the collection's metadata.
      */
     CollectionFileSummary: {
         archived_at: string | null;
@@ -309,17 +308,19 @@ export interface PluginApiSchemas {
         height: number | null;
         smart_link_url: string | null;
         added_at: string;
-        fields: PluginApiSchemas["PropertySummary"][];
+        metadata: PluginApiSchemas["PropertySummary"][];
         /**
          * How the file is shown, which follows from its type.
          */
         kind: PluginApiSchemas["FileKind"];
     };
     /**
-     * Files to put in a collection or take out of it.
+     * Files to put in a collection, and the values of the collection's metadata
+     * each one it takes starts with: what its file page requires.
      */
-    CollectionFiles: {
+    CollectionFilesAdd: {
         file_ids: number[];
+        metadata?: PluginApiSchemas["PropertyValueInput"][];
     };
     CollectionListResponse: {
         items: PluginApiSchemas["CollectionRead"][];
@@ -347,7 +348,7 @@ export interface PluginApiSchemas {
         comment_count: number;
         tags: PluginApiSchemas["TagSummary"][];
         properties: PluginApiSchemas["PropertySummary"][];
-        fields: PluginApiSchemas["PropertyDefinitionRead"][];
+        metadata: PluginApiSchemas["PropertyDefinitionRead"][];
         can: PluginApiSchemas["CollectionCan"];
     };
     CollectionShapeEntry: {
@@ -355,16 +356,7 @@ export interface PluginApiSchemas {
         name: string;
         hint: string;
         lists: Array<"table" | "board" | "gantt" | "calendar" | "masonry" | "grid" | "timeline">;
-        fields: PluginApiSchemas["CollectionShapeField"][];
-    };
-    /**
-     * A field a ready-made shape brings, in the reader's language.
-     */
-    CollectionShapeField: {
-        name: string;
-        type: PluginApiSchemas["PropertyType"];
-        display: "number" | "stars" | "bar" | null;
-        currency: PluginApiSchemas["CurrencyCode"] | null;
+        metadata: PluginApiSchemas["CollectionShapeMetadata"][];
     };
     CollectionShapeGroup: {
         key: string;
@@ -375,6 +367,15 @@ export interface PluginApiSchemas {
      * A ready-made shape a collection can start as.
      */
     CollectionShapeKey: "gallery" | "catalog" | "log";
+    /**
+     * Metadata a ready-made shape brings, in the reader's language.
+     */
+    CollectionShapeMetadata: {
+        name: string;
+        type: PluginApiSchemas["MetadataType"];
+        display: "number" | "stars" | "bar" | null;
+        currency: PluginApiSchemas["CurrencyCode"] | null;
+    };
     CollectionUpdate: {
         properties?: PluginApiSchemas["PropertyValueInput"][] | null;
         name?: string | null;
@@ -410,12 +411,12 @@ export interface PluginApiSchemas {
         collection_id?: number | null;
         project_id?: number | null;
         file_id?: number | null;
-        queue_id?: number | null;
         counter_group_id?: number | null;
         calendar_id?: number | null;
         dashboard_id?: number | null;
         post_id?: number | null;
         wiki_id?: number | null;
+        contact_id?: number | null;
         parent_comment_id?: number | null;
         audience?: PluginApiSchemas["CommentAudience"];
     };
@@ -446,12 +447,12 @@ export interface PluginApiSchemas {
         collection_id: number | null;
         project_id: number | null;
         file_id: number | null;
-        queue_id: number | null;
         counter_group_id: number | null;
         calendar_id: number | null;
         dashboard_id: number | null;
         post_id: number | null;
         wiki_id: number | null;
+        contact_id: number | null;
         id: number;
         created_by: string | null;
         parent_comment_id: number | null;
@@ -473,6 +474,106 @@ export interface PluginApiSchemas {
         by: PluginApiSchemas["RemovedBy"];
         reason: PluginApiSchemas["RemovalReason"] | null;
     };
+    /**
+     * An address, as one block of text written as it is on an envelope, so any
+     * country's form fits.
+     */
+    ContactAddress: {
+        label?: string;
+        value: string;
+    };
+    ContactCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        is_organization?: boolean;
+        emails?: PluginApiSchemas["ContactEmail"][];
+        phones?: PluginApiSchemas["ContactPhone"][];
+        addresses?: PluginApiSchemas["ContactAddress"][];
+        websites?: PluginApiSchemas["ContactWebsite"][];
+        initiative_id?: number | null;
+        tag_ids?: number[] | null;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    /**
+     * One of a contact's details: its value, and a short label saying which one
+     * it is.
+     */
+    ContactDetail: {
+        label?: string;
+        value: string;
+    };
+    ContactEmail: {
+        label?: string;
+        value: string;
+    };
+    ContactListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["ContactSummary"][];
+    };
+    ContactPhone: {
+        label?: string;
+        value: string;
+    };
+    ContactRead: {
+        archived_at: string | null;
+        can: PluginApiSchemas["ToolCan"];
+        id: number;
+        initiative_id: number | null;
+        community_id: string;
+        created_by: string | null;
+        created_at: string;
+        updated_at: string;
+        comments_enabled: boolean;
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+        grants: PluginApiSchemas["ResourceGrantSchema"][];
+        name: string;
+        is_organization: boolean;
+        emails: PluginApiSchemas["ContactDetail"][];
+        phones: PluginApiSchemas["ContactDetail"][];
+        addresses: PluginApiSchemas["ContactDetail"][];
+        websites: PluginApiSchemas["ContactDetail"][];
+    };
+    ContactSummary: {
+        archived_at: string | null;
+        can: PluginApiSchemas["ToolCan"];
+        id: number;
+        initiative_id: number | null;
+        community_id: string;
+        created_by: string | null;
+        created_at: string;
+        updated_at: string;
+        comments_enabled: boolean;
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+        grants: PluginApiSchemas["ResourceGrantSchema"][];
+        name: string;
+        is_organization: boolean;
+        emails: PluginApiSchemas["ContactDetail"][];
+        phones: PluginApiSchemas["ContactDetail"][];
+        addresses: PluginApiSchemas["ContactDetail"][];
+        websites: PluginApiSchemas["ContactDetail"][];
+    };
+    /**
+     * A change to a contact. Only what is sent is written; a list sent replaces
+     * the one there.
+     */
+    ContactUpdate: {
+        name?: string | null;
+        is_organization?: boolean | null;
+        emails?: PluginApiSchemas["ContactEmail"][] | null;
+        phones?: PluginApiSchemas["ContactPhone"][] | null;
+        addresses?: PluginApiSchemas["ContactAddress"][] | null;
+        websites?: PluginApiSchemas["ContactWebsite"][] | null;
+    };
+    ContactWebsite: {
+        label?: string;
+        value: string;
+    };
     /**
      * What the caller may do to a piece of content, as the server answers it.
      */
@@ -576,7 +677,6 @@ export interface PluginApiSchemas {
         view_mode: PluginApiSchemas["CounterViewMode"];
         position: string;
         properties: PluginApiSchemas["PropertySummary"][];
-        plugin_values: PluginApiSchemas["PluginValueSummary"][];
         created_at: string;
         updated_at: string;
     };
@@ -838,12 +938,12 @@ export interface PluginApiSchemas {
     InitiativeRead: {
         projects_enabled: boolean;
         files_enabled: boolean;
-        queues_enabled: boolean;
         counter_groups_enabled: boolean;
         calendars_enabled: boolean;
         dashboards_enabled: boolean;
         posts_enabled: boolean;
         wikis_enabled: boolean;
+        contacts_enabled: boolean;
         name: string;
         description: string | null;
         color: string | null;
@@ -878,6 +978,15 @@ export interface PluginApiSchemas {
         project_count: number;
         projects_total: number;
     };
+    /**
+     * Who owns a definition people define: the initiative (its metadata), or a
+     * project or a collection (its properties).
+     */
+    MetadataOwnerKind: "initiative" | "project" | "collection";
+    /**
+     * What a metadata definition's values are.
+     */
+    MetadataType: "text" | "number" | "checkbox" | "date" | "datetime" | "url" | "select" | "multi_select" | "user_reference" | "currency" | "scale" | "link" | "badge" | "json";
     OccurrenceRequest: {
         start: string;
     };
@@ -905,16 +1014,6 @@ export interface PluginApiSchemas {
          */
         avatar_url?: string | null;
     };
-    /**
-     * One value an installed plug-in shows on an item: a key its pinned version
-     * declares as a field there. A list field's value is an array of its
-     * elements, newest first, each with its `ref`.
-     */
-    PluginValueSummary: {
-        plugin_id: number;
-        key: string;
-        value: unknown;
-    };
     PollOptionRead: {
         id: number;
         text: string;
@@ -1031,7 +1130,6 @@ export interface PluginApiSchemas {
          */
         body: Record<string, unknown>;
         poll: PluginApiSchemas["PollRead"] | null;
-        plugin_values: PluginApiSchemas["PluginValueSummary"][];
     };
     PostUpdate: {
         name?: string | null;
@@ -1108,25 +1206,60 @@ export interface PluginApiSchemas {
         start_date?: string | null;
         end_date?: string | null;
     };
+    /**
+     * Definitions of one initiative to delete together, or none of them.
+     */
+    PropertyDefinitionBulkDelete: {
+        initiative_id: number;
+        ids: number[];
+    };
     PropertyDefinitionCreate: {
         name: string;
-        type: PluginApiSchemas["PropertyType"];
+        type: PluginApiSchemas["MetadataType"];
         position?: number;
         color?: string | null;
         options?: PluginApiSchemas["PropertyOption"][] | null;
         currency?: PluginApiSchemas["CurrencyCode"] | null;
         initiative_id: number;
+        project_id?: number | null;
         collection_id?: number | null;
     };
+    /**
+     * One owner's definitions, as the initiative's settings list them.
+     */
+    PropertyDefinitionGroup: {
+        owner: PluginApiSchemas["MetadataOwnerKind"];
+        owner_id: number | null;
+        name: string | null;
+        can_edit: boolean;
+        definitions: PluginApiSchemas["PropertyDefinitionRead"][];
+    };
+    /**
+     * An initiative's metadata, then the properties of each project and each
+     * collection in it the reader may edit, each under its owner.
+     */
+    PropertyDefinitionGroups: {
+        groups: PluginApiSchemas["PropertyDefinitionGroup"][];
+    };
+    /**
+     * Properties of one type, from the initiative's projects and collections,
+     * merged into one of its metadata, named `name`.
+     */
+    PropertyDefinitionPromote: {
+        initiative_id: number;
+        ids: number[];
+        name: string;
+    };
     PropertyDefinitionRead: {
         name: string;
-        type: PluginApiSchemas["PropertyType"];
+        type: PluginApiSchemas["MetadataType"];
         position: number;
         color: string | null;
         options: PluginApiSchemas["PropertyOption"][] | null;
         currency: PluginApiSchemas["CurrencyCode"] | null;
         id: number;
         initiative_id: number;
+        project_id: number | null;
         collection_id: number | null;
         created_at: string;
         updated_at: string;
@@ -1172,24 +1305,26 @@ export interface PluginApiSchemas {
     PropertySummary: {
         property_id: number;
         name: string;
-        type: PluginApiSchemas["PropertyType"];
+        type: PluginApiSchemas["MetadataType"];
+        project_id: number | null;
+        collection_id: number | null;
+        install_id: number | null;
+        key: string | null;
         options: PluginApiSchemas["PropertyOption"][] | null;
         currency: PluginApiSchemas["CurrencyCode"] | null;
         /**
-         * Shaped by the property's type. For user_reference, a person: id,
+         * 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.
+         * 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.
          */
         value: unknown;
     };
     /**
      * What can carry custom property values: every tool and sub-tool.
      */
-    PropertyTarget: "project" | "file" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "task" | "queue_item" | "calendar_event" | "counter" | "wiki_page" | "collection";
-    /**
-     * Supported value types for a property definition.
-     */
-    PropertyType: "text" | "number" | "checkbox" | "date" | "datetime" | "url" | "select" | "multi_select" | "user_reference" | "currency" | "rating";
+    PropertyTarget: "project" | "file" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "contact" | "task" | "calendar_event" | "counter" | "wiki_page" | "collection";
     /**
      * A single (property_id, value) pair submitted by the client.
      */
@@ -1207,121 +1342,6 @@ export interface PluginApiSchemas {
         removed?: number[];
         options?: PluginApiSchemas["PropertyOptionsChange"][];
     };
-    QueueCreate: {
-        properties?: PluginApiSchemas["PropertyValueInput"][];
-        name: string;
-        description?: string | null;
-        initiative_id: number;
-        grants?: PluginApiSchemas["ResourceGrantSchema"][];
-    };
-    QueueItemCreate: {
-        properties?: PluginApiSchemas["PropertyValueInput"][];
-        label: string;
-        position?: number;
-        color?: string | null;
-        notes?: string | null;
-        is_visible?: boolean;
-        user_id?: string | null;
-        tag_ids?: number[] | null;
-        task_ids?: number[] | null;
-    };
-    QueueItemRead: {
-        label: string;
-        position: number;
-        color: string | null;
-        notes: string | null;
-        is_visible: boolean;
-        id: number;
-        queue_id: number;
-        user_id: string | null;
-        user: PluginApiSchemas["PluginPerson"] | null;
-        tags: PluginApiSchemas["TagSummary"][];
-        properties: PluginApiSchemas["PropertySummary"][];
-        attachment_count: number;
-        held_at_round: number | null;
-        created_by: string | null;
-        created_at: string;
-        plugin_values: PluginApiSchemas["PluginValueSummary"][];
-    };
-    QueueItemUpdate: {
-        properties?: PluginApiSchemas["PropertyValueInput"][] | null;
-        label?: string | null;
-        position?: number | null;
-        user_id?: string | null;
-        color?: string | null;
-        notes?: string | null;
-        is_visible?: boolean | null;
-        tag_ids?: number[] | null;
-        notes_base?: string | null;
-    };
-    QueueListResponse: {
-        total_count: number;
-        page: number;
-        page_size: number;
-        has_next: boolean;
-        has_prev: boolean;
-        items: PluginApiSchemas["QueueSummary"][];
-    };
-    QueueRead: {
-        archived_at: string | null;
-        can: PluginApiSchemas["ToolCan"];
-        id: number;
-        initiative_id: number;
-        community_id: string;
-        created_by: string | null;
-        created_at: string;
-        updated_at: string;
-        comments_enabled: boolean;
-        tags: PluginApiSchemas["TagSummary"][];
-        properties: PluginApiSchemas["PropertySummary"][];
-        grants: PluginApiSchemas["ResourceGrantSchema"][];
-        name: string;
-        description: string | null;
-        current_round: number;
-        is_active: boolean;
-        preview: PluginApiSchemas["QueueTurnPreview"][] | null;
-        items: PluginApiSchemas["QueueItemRead"][];
-        current_item_id: number | null;
-    };
-    /**
-     * Options for releasing a held queue item back into the rotation.
-     */
-    QueueReleaseRequest: {
-        reposition?: boolean;
-    };
-    QueueSummary: {
-        archived_at: string | null;
-        can: PluginApiSchemas["ToolCan"];
-        id: number;
-        initiative_id: number;
-        community_id: string;
-        created_by: string | null;
-        created_at: string;
-        updated_at: string;
-        comments_enabled: boolean;
-        tags: PluginApiSchemas["TagSummary"][];
-        properties: PluginApiSchemas["PropertySummary"][];
-        grants: PluginApiSchemas["ResourceGrantSchema"][];
-        name: string;
-        description: string | null;
-        current_round: number;
-        is_active: boolean;
-        preview: PluginApiSchemas["QueueTurnPreview"][] | null;
-    };
-    /**
-     * One turn as a list's card draws it: who, in what colour, and whether it is
-     * theirs now.
-     */
-    QueueTurnPreview: {
-        id: number;
-        label: string;
-        color: string | null;
-        current: boolean;
-    };
-    QueueUpdate: {
-        name?: string | null;
-        description?: string | null;
-    };
     RSVPStatus: "pending" | "accepted" | "declined" | "tentative";
     /**
      * One emoji on one target, and who chose it.
@@ -1359,7 +1379,7 @@ export interface PluginApiSchemas {
         all_initiative_members?: boolean;
         plugin_install_id?: number | null;
     };
-    SearchEntityType: "calendar" | "calendar_event" | "collection" | "comment" | "counter" | "counter_group" | "dashboard" | "file" | "post" | "project" | "queue" | "queue_item" | "tag" | "task" | "wiki" | "wiki_page";
+    SearchEntityType: "calendar" | "calendar_event" | "collection" | "comment" | "contact" | "counter" | "counter_group" | "dashboard" | "file" | "post" | "project" | "tag" | "task" | "wiki" | "wiki_page";
     /**
      * A jump-to target for the command palette: enough to render and route.
      */
@@ -1416,7 +1436,7 @@ export interface PluginApiSchemas {
     /**
      * Entity types a bulk tag edit can address.
      */
-    TagTarget: "project" | "file" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "task" | "queue_item" | "calendar_event" | "wiki_page" | "collection";
+    TagTarget: "project" | "file" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "contact" | "task" | "calendar_event" | "wiki_page" | "collection";
     TaskCreate: {
         properties?: PluginApiSchemas["PropertyValueInput"][];
         title: string;
@@ -1480,7 +1500,6 @@ export interface PluginApiSchemas {
         subtask_progress: PluginApiSchemas["ChecklistProgress"] | null;
         tags: PluginApiSchemas["TagSummary"][];
         properties: PluginApiSchemas["PropertySummary"][];
-        plugin_values: PluginApiSchemas["PluginValueSummary"][];
     };
     TaskListResponse: {
         total_count: number;
@@ -1493,6 +1512,7 @@ export interface PluginApiSchemas {
     };
     TaskMoveRequest: {
         target_project_id: number;
+        changes?: PluginApiSchemas["TaskUpdate"] | null;
     };
     /**
      * The task a task is part of: the target of its `part_of` edge.
@@ -1550,7 +1570,6 @@ export interface PluginApiSchemas {
         subtask_progress: PluginApiSchemas["ChecklistProgress"] | null;
         tags: PluginApiSchemas["TagSummary"][];
         properties: PluginApiSchemas["PropertySummary"][];
-        plugin_values: PluginApiSchemas["PluginValueSummary"][];
     };
     TaskStatusCategory: "backlog" | "todo" | "in_progress" | "done";
     TaskStatusRead: {
@@ -1630,6 +1649,7 @@ export interface PluginApiSchemas {
         tz?: string | null;
         recurrence_strategy?: PluginApiSchemas["RecurrenceStrategy"] | null;
         recurrence_limit?: number | null;
+        merge_properties?: boolean;
         tag_ids?: number[] | null;
         checklist?: PluginApiSchemas["ChecklistItemInput"][] | null;
         parent_task_id?: number | null;
@@ -1647,7 +1667,7 @@ export interface PluginApiSchemas {
     TimelineResponse: {
         buckets: PluginApiSchemas["TimelineBucket"][];
     };
-    Tool: "project" | "file" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki";
+    Tool: "project" | "file" | "counter_group" | "calendar" | "dashboard" | "post" | "wiki" | "contact";
     /**
      * What the caller may do to one of a tool's rows
      * (`permissions.client_access`).
@@ -2038,56 +2058,6 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["FileCreate"];
         answer: PluginApiSchemas["FileRead"];
     };
-    list_queues: {
-        query: {
-            initiative_id?: number | null;
-            /**
-             * Full-text match over the row — its name and its description. Reads the
-             * same index the search page does, so a list's filter box and a search
-             * agree about what matches.
-             */
-            search?: string | null;
-            /**
-             * Order by one of: name, initiative, updated_at. Omit for this tool's own
-             * default order.
-             */
-            sort_by?: string | null;
-            /**
-             * asc (default) or desc.
-             */
-            sort_dir?: string | null;
-            /**
-             * Only queues carrying any of these tags.
-             */
-            tag_ids?: number[] | null;
-            /**
-             * JSON-encoded list of property-value filters, e.g. `[{"property_id": 12,
-             * "op": "eq", "value": "live"}]`. Maximum 5 conditions per request.
-             */
-            property_filters?: string | null;
-            /**
-             * true lists what has been archived instead of what is live. Omit for the
-             * live list, which is what every other view shows.
-             */
-            archived?: boolean | null;
-            /**
-             * Only running queues, or only stopped ones.
-             */
-            is_active?: boolean | null;
-            /**
-             * Also send what each row's card shows of what is inside it, read for the
-             * whole page at once.
-             */
-            include_preview?: boolean;
-            page?: number;
-            page_size?: number;
-        };
-        answer: PluginApiSchemas["QueueListResponse"];
-    };
-    create_queue: {
-        body: PluginApiSchemas["QueueCreate"];
-        answer: PluginApiSchemas["QueueRead"];
-    };
     list_counter_groups: {
         query: {
             initiative_id?: number | null;
@@ -2272,6 +2242,50 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["WikiCreate"];
         answer: PluginApiSchemas["WikiRead"];
     };
+    list_contacts: {
+        query: {
+            initiative_id?: number | null;
+            scope?: "community" | null;
+            /**
+             * Full-text match over the contact's name, through the same index the
+             * search page reads.
+             */
+            search?: string | null;
+            /**
+             * Order by one of: name, initiative, updated_at. Omit for by name.
+             */
+            sort_by?: string | null;
+            /**
+             * asc (default) or desc.
+             */
+            sort_dir?: string | null;
+            /**
+             * Only contacts carrying any of these tags.
+             */
+            tag_ids?: number[] | null;
+            /**
+             * JSON-encoded list of property-value filters, e.g. `[{"property_id": 12,
+             * "op": "eq", "value": "live"}]`. Maximum 5 conditions per request.
+             */
+            property_filters?: string | null;
+            /**
+             * true lists what has been archived instead of what is live. Omit for the
+             * live list, which is what every other view shows.
+             */
+            archived?: boolean | null;
+            /**
+             * Only organizations (true) or only people (false).
+             */
+            is_organization?: boolean | null;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["ContactListResponse"];
+    };
+    create_contact: {
+        body: PluginApiSchemas["ContactCreate"];
+        answer: PluginApiSchemas["ContactRead"];
+    };
     list_collection_files: {
         path: {
             collection_id: number;
@@ -2337,7 +2351,7 @@ export interface PluginApiOperations {
         path: {
             collection_id: number;
         };
-        body: PluginApiSchemas["CollectionFiles"];
+        body: PluginApiSchemas["CollectionFilesAdd"];
         answer: PluginApiSchemas["CollectionRead"];
     };
     remove_collection_files: {
@@ -2558,12 +2572,12 @@ export interface PluginApiOperations {
             collection_id?: number | null;
             project_id?: number | null;
             file_id?: number | null;
-            queue_id?: number | null;
             counter_group_id?: number | null;
             calendar_id?: number | null;
             dashboard_id?: number | null;
             post_id?: number | null;
             wiki_id?: number | null;
+            contact_id?: number | null;
         };
         answer: PluginApiSchemas["CommentListResponse"];
     };
@@ -2681,14 +2695,14 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["CollectionUpdate"];
         answer: PluginApiSchemas["CollectionRead"];
     };
-    get_collection_file_fields: {
+    get_collection_file_metadata: {
         path: {
             collection_id: number;
             file_id: number;
         };
         answer: PluginApiSchemas["PropertySummary"][];
     };
-    set_collection_file_fields: {
+    set_collection_file_metadata: {
         path: {
             collection_id: number;
             file_id: number;
@@ -2696,112 +2710,6 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["PropertyValuesSetRequest"];
         answer: PluginApiSchemas["PropertySummary"][];
     };
-    read_queue: {
-        path: {
-            queue_id: number;
-        };
-        query: {
-            /**
-             * Also return the resource if it is in the trash. For reading a resource
-             * back after a deleted event — the row still exists until retention
-             * purges it, and access is checked exactly as for a live one.
-             */
-            include_deleted?: boolean;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    update_queue: {
-        path: {
-            queue_id: number;
-        };
-        body: PluginApiSchemas["QueueUpdate"];
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    add_queue_item: {
-        path: {
-            queue_id: number;
-        };
-        body: PluginApiSchemas["QueueItemCreate"];
-        answer: PluginApiSchemas["QueueItemRead"];
-    };
-    start_queue: {
-        path: {
-            queue_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    stop_queue: {
-        path: {
-            queue_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    advance_turn: {
-        path: {
-            queue_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    previous_turn: {
-        path: {
-            queue_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    set_active_item: {
-        path: {
-            queue_id: number;
-            item_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    reset_queue: {
-        path: {
-            queue_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    hold_current_turn: {
-        path: {
-            queue_id: number;
-        };
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    release_held_item: {
-        path: {
-            queue_id: number;
-            item_id: number;
-        };
-        body: PluginApiSchemas["QueueReleaseRequest"];
-        answer: PluginApiSchemas["QueueRead"];
-    };
-    read_queue_item: {
-        path: {
-            item_id: number;
-        };
-        query: {
-            /**
-             * Also return the resource if it is in the trash. For reading a resource
-             * back after a deleted event — the row still exists until retention
-             * purges it, and access is checked exactly as for a live one.
-             */
-            include_deleted?: boolean;
-        };
-        answer: PluginApiSchemas["QueueItemRead"];
-    };
-    update_queue_item: {
-        path: {
-            item_id: number;
-        };
-        body: PluginApiSchemas["QueueItemUpdate"];
-        answer: PluginApiSchemas["QueueItemRead"];
-    };
-    duplicate_queue_item: {
-        path: {
-            item_id: number;
-        };
-        answer: PluginApiSchemas["QueueItemRead"];
-    };
     read_counter_group: {
         path: {
             group_id: number;
@@ -2991,6 +2899,19 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["WikiPageMove"];
         answer: PluginApiSchemas["WikiPageRead"];
     };
+    read_contact: {
+        path: {
+            contact_id: number;
+        };
+        answer: PluginApiSchemas["ContactRead"];
+    };
+    update_contact: {
+        path: {
+            contact_id: number;
+        };
+        body: PluginApiSchemas["ContactUpdate"];
+        answer: PluginApiSchemas["ContactRead"];
+    };
     read_calendar_event: {
         path: {
             event_id: number;
@@ -3092,13 +3013,6 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["ResourceGrantSchema"][];
         answer: PluginApiSchemas["FileRead"];
     };
-    set_queue_grants: {
-        path: {
-            queue_id: number;
-        };
-        body: PluginApiSchemas["ResourceGrantSchema"][];
-        answer: PluginApiSchemas["QueueRead"];
-    };
     set_counter_group_grants: {
         path: {
             group_id: number;
@@ -3127,6 +3041,13 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["ResourceGrantSchema"][];
         answer: PluginApiSchemas["WikiRead"];
     };
+    set_contact_grants: {
+        path: {
+            contact_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["ContactRead"];
+    };
     duplicate_project: {
         path: {
             project_id: number;
@@ -3141,13 +3062,6 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["ToolDuplicateRequest"] | null;
         answer: PluginApiSchemas["FileRead"];
     };
-    duplicate_queue: {
-        path: {
-            queue_id: number;
-        };
-        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
-        answer: PluginApiSchemas["QueueRead"];
-    };
     duplicate_counter_group: {
         path: {
             group_id: number;
@@ -3176,6 +3090,13 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["ToolDuplicateRequest"] | null;
         answer: PluginApiSchemas["WikiRead"];
     };
+    duplicate_contact: {
+        path: {
+            contact_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["ContactRead"];
+    };
     suggest_community: {
         query: {
             /**
@@ -3184,9 +3105,9 @@ export interface PluginApiOperations {
             search: string;
             /**
              * Restrict to these entity types. Omit for the default scope (calendar,
-             * calendar_event, collection, counter, counter_group, dashboard, file,
-             * post, project, queue, queue_item, tag, task, wiki, wiki_page); naming a
-             * type reaches it explicitly.
+             * calendar_event, collection, contact, counter, counter_group, dashboard,
+             * file, post, project, tag, task, wiki, wiki_page); naming a type reaches
+             * it explicitly.
              */
             types?: PluginApiSchemas["SearchEntityType"][] | null;
             /**
@@ -3212,7 +3133,11 @@ export interface PluginApiOperations {
         query: {
             initiative_id?: number | null;
             /**
-             * List this collection's own fields instead of properties.
+             * List this project's metadata instead of properties.
+             */
+            project_id?: number | null;
+            /**
+             * List this collection's metadata instead of properties.
              */
             collection_id?: number | null;
         };
@@ -3222,6 +3147,20 @@ export interface PluginApiOperations {
         body: PluginApiSchemas["PropertyDefinitionCreate"];
         answer: PluginApiSchemas["PropertyDefinitionRead"];
     };
+    list_property_definitions_by_owner: {
+        query: {
+            initiative_id: number;
+        };
+        answer: PluginApiSchemas["PropertyDefinitionGroups"];
+    };
+    delete_property_definitions: {
+        body: PluginApiSchemas["PropertyDefinitionBulkDelete"];
+        answer: void;
+    };
+    promote_property_definitions: {
+        body: PluginApiSchemas["PropertyDefinitionPromote"];
+        answer: PluginApiSchemas["PropertyDefinitionRead"];
+    };
     delete_property_definition: {
         path: {
             definition_id: number;
@@ -3301,7 +3240,7 @@ export declare const pluginApiOperations: {
         readonly path: "/webhooks/subscriptions";
         readonly scope: {
             readonly per: "event_type";
-            readonly any_of: readonly ["calendars:read", "comments:read", "counter_groups:read", "dashboards:read", "files:read", "initiatives:read", "posts:read", "projects:read", "queues:read", "tags:read", "wikis:read"];
+            readonly any_of: readonly ["calendars:read", "comments:read", "contacts:read", "counter_groups:read", "dashboards:read", "files:read", "initiatives:read", "posts:read", "projects:read", "tags:read", "wikis:read"];
         };
     };
     readonly delete_subscription: {
@@ -3309,7 +3248,7 @@ export declare const pluginApiOperations: {
         readonly path: "/webhooks/subscriptions/{subscription_id}";
         readonly scope: {
             readonly per: "event_type";
-            readonly any_of: readonly ["calendars:read", "comments:read", "counter_groups:read", "dashboards:read", "files:read", "initiatives:read", "posts:read", "projects:read", "queues:read", "tags:read", "wikis:read"];
+            readonly any_of: readonly ["calendars:read", "comments:read", "contacts:read", "counter_groups:read", "dashboards:read", "files:read", "initiatives:read", "posts:read", "projects:read", "tags:read", "wikis:read"];
         };
     };
     readonly list_projects: {
@@ -3332,16 +3271,6 @@ export declare const pluginApiOperations: {
         readonly path: "/files/";
         readonly scope: "files:write";
     };
-    readonly list_queues: {
-        readonly method: "GET";
-        readonly path: "/queues/";
-        readonly scope: "queues:read";
-    };
-    readonly create_queue: {
-        readonly method: "POST";
-        readonly path: "/queues/";
-        readonly scope: "queues:write";
-    };
     readonly list_counter_groups: {
         readonly method: "GET";
         readonly path: "/counter-groups/";
@@ -3382,6 +3311,16 @@ export declare const pluginApiOperations: {
         readonly path: "/wikis/";
         readonly scope: "wikis:write";
     };
+    readonly list_contacts: {
+        readonly method: "GET";
+        readonly path: "/contacts/";
+        readonly scope: "contacts:read";
+    };
+    readonly create_contact: {
+        readonly method: "POST";
+        readonly path: "/contacts/";
+        readonly scope: "contacts:write";
+    };
     readonly list_collection_files: {
         readonly method: "GET";
         readonly path: "/collections/{collection_id}/files";
@@ -3564,86 +3503,16 @@ export declare const pluginApiOperations: {
         readonly path: "/collections/{collection_id}";
         readonly scope: "files:write";
     };
-    readonly get_collection_file_fields: {
+    readonly get_collection_file_metadata: {
         readonly method: "GET";
-        readonly path: "/collections/{collection_id}/files/{file_id}/fields";
+        readonly path: "/collections/{collection_id}/files/{file_id}/metadata";
         readonly scope: "files:read";
     };
-    readonly set_collection_file_fields: {
+    readonly set_collection_file_metadata: {
         readonly method: "PUT";
-        readonly path: "/collections/{collection_id}/files/{file_id}/fields";
+        readonly path: "/collections/{collection_id}/files/{file_id}/metadata";
         readonly scope: "files:write";
     };
-    readonly read_queue: {
-        readonly method: "GET";
-        readonly path: "/queues/{queue_id}";
-        readonly scope: "queues:read";
-    };
-    readonly update_queue: {
-        readonly method: "PATCH";
-        readonly path: "/queues/{queue_id}";
-        readonly scope: "queues:write";
-    };
-    readonly add_queue_item: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/items";
-        readonly scope: "queues:write";
-    };
-    readonly start_queue: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/start";
-        readonly scope: "queues:write";
-    };
-    readonly stop_queue: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/stop";
-        readonly scope: "queues:write";
-    };
-    readonly advance_turn: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/next";
-        readonly scope: "queues:write";
-    };
-    readonly previous_turn: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/previous";
-        readonly scope: "queues:write";
-    };
-    readonly set_active_item: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/set-active/{item_id}";
-        readonly scope: "queues:write";
-    };
-    readonly reset_queue: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/reset";
-        readonly scope: "queues:write";
-    };
-    readonly hold_current_turn: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/hold";
-        readonly scope: "queues:write";
-    };
-    readonly release_held_item: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/release/{item_id}";
-        readonly scope: "queues:write";
-    };
-    readonly read_queue_item: {
-        readonly method: "GET";
-        readonly path: "/queue-items/{item_id}";
-        readonly scope: "queues:read";
-    };
-    readonly update_queue_item: {
-        readonly method: "PATCH";
-        readonly path: "/queue-items/{item_id}";
-        readonly scope: "queues:write";
-    };
-    readonly duplicate_queue_item: {
-        readonly method: "POST";
-        readonly path: "/queue-items/{item_id}/duplicate";
-        readonly scope: "queues:write";
-    };
     readonly read_counter_group: {
         readonly method: "GET";
         readonly path: "/counter-groups/{group_id}";
@@ -3764,6 +3633,16 @@ export declare const pluginApiOperations: {
         readonly path: "/wiki-pages/{page_id}/move";
         readonly scope: "wikis:write";
     };
+    readonly read_contact: {
+        readonly method: "GET";
+        readonly path: "/contacts/{contact_id}";
+        readonly scope: "contacts:read";
+    };
+    readonly update_contact: {
+        readonly method: "PATCH";
+        readonly path: "/contacts/{contact_id}";
+        readonly scope: "contacts:write";
+    };
     readonly read_calendar_event: {
         readonly method: "GET";
         readonly path: "/calendar-events/{event_id}";
@@ -3829,11 +3708,6 @@ export declare const pluginApiOperations: {
         readonly path: "/files/{file_id}/grants";
         readonly scope: "sharing:write";
     };
-    readonly set_queue_grants: {
-        readonly method: "PUT";
-        readonly path: "/queues/{queue_id}/grants";
-        readonly scope: "sharing:write";
-    };
     readonly set_counter_group_grants: {
         readonly method: "PUT";
         readonly path: "/counter-groups/{group_id}/grants";
@@ -3854,6 +3728,11 @@ export declare const pluginApiOperations: {
         readonly path: "/wikis/{wiki_id}/grants";
         readonly scope: "sharing:write";
     };
+    readonly set_contact_grants: {
+        readonly method: "PUT";
+        readonly path: "/contacts/{contact_id}/grants";
+        readonly scope: "sharing:write";
+    };
     readonly duplicate_project: {
         readonly method: "POST";
         readonly path: "/projects/{project_id}/duplicate";
@@ -3864,11 +3743,6 @@ export declare const pluginApiOperations: {
         readonly path: "/files/{file_id}/duplicate";
         readonly scope: "files:write";
     };
-    readonly duplicate_queue: {
-        readonly method: "POST";
-        readonly path: "/queues/{queue_id}/duplicate";
-        readonly scope: "queues:write";
-    };
     readonly duplicate_counter_group: {
         readonly method: "POST";
         readonly path: "/counter-groups/{group_id}/duplicate";
@@ -3889,12 +3763,17 @@ export declare const pluginApiOperations: {
         readonly path: "/wikis/{wiki_id}/duplicate";
         readonly scope: "wikis:write";
     };
+    readonly duplicate_contact: {
+        readonly method: "POST";
+        readonly path: "/contacts/{contact_id}/duplicate";
+        readonly scope: "contacts:write";
+    };
     readonly suggest_community: {
         readonly method: "GET";
         readonly path: "/search/suggest";
         readonly scope: {
             readonly per: "entity_type";
-            readonly any_of: readonly ["calendars:read", "comments:read", "counter_groups:read", "dashboards:read", "files:read", "posts:read", "projects:read", "queues:read", "tags:read", "wikis:read"];
+            readonly any_of: readonly ["calendars:read", "comments:read", "contacts:read", "counter_groups:read", "dashboards:read", "files:read", "posts:read", "projects:read", "tags:read", "wikis:read"];
         };
     };
     readonly list_property_definitions: {
@@ -3902,31 +3781,55 @@ export declare const pluginApiOperations: {
         readonly path: "/property-definitions/";
         readonly scope: {
             readonly per: "tool";
-            readonly any_of: readonly ["calendars:read", "counter_groups:read", "dashboards:read", "files:read", "posts:read", "projects:read", "properties:read", "queues:read", "wikis:read"];
+            readonly any_of: readonly ["calendars:read", "contacts:read", "counter_groups:read", "dashboards:read", "files:read", "posts:read", "projects:read", "properties:read", "wikis:read"];
         };
     };
     readonly create_property_definition: {
         readonly method: "POST";
         readonly path: "/property-definitions/";
         readonly scope: {
-            readonly per: "property_scope";
-            readonly any_of: readonly ["files:write", "properties:write"];
+            readonly per: "owner's_scope";
+            readonly any_of: readonly ["files:write", "projects:write", "properties:write"];
+        };
+    };
+    readonly list_property_definitions_by_owner: {
+        readonly method: "GET";
+        readonly path: "/property-definitions/by-owner";
+        readonly scope: {
+            readonly per: "tool";
+            readonly any_of: readonly ["calendars:read", "contacts:read", "counter_groups:read", "dashboards:read", "files:read", "posts:read", "projects:read", "properties:read", "wikis:read"];
+        };
+    };
+    readonly delete_property_definitions: {
+        readonly method: "POST";
+        readonly path: "/property-definitions/bulk-delete";
+        readonly scope: {
+            readonly per: "owner's_scope";
+            readonly any_of: readonly ["files:write", "projects:write", "properties:write"];
+        };
+    };
+    readonly promote_property_definitions: {
+        readonly method: "POST";
+        readonly path: "/property-definitions/promote";
+        readonly scope: {
+            readonly per: "owner's_scope";
+            readonly any_of: readonly ["files:write", "projects:write", "properties:write"];
         };
     };
     readonly delete_property_definition: {
         readonly method: "DELETE";
         readonly path: "/property-definitions/{definition_id}";
         readonly scope: {
-            readonly per: "property_scope";
-            readonly any_of: readonly ["files:write", "properties:write"];
+            readonly per: "owner's_scope";
+            readonly any_of: readonly ["files:write", "projects:write", "properties:write"];
         };
     };
     readonly update_property_definition: {
         readonly method: "PATCH";
         readonly path: "/property-definitions/{definition_id}";
         readonly scope: {
-            readonly per: "property_scope";
-            readonly any_of: readonly ["files:write", "properties:write"];
+            readonly per: "owner's_scope";
+            readonly any_of: readonly ["files:write", "projects:write", "properties:write"];
         };
     };
     readonly set_properties: {
@@ -3938,14 +3841,13 @@ export declare const pluginApiOperations: {
                 readonly calendar: "calendars:write";
                 readonly calendar_event: "calendars:write";
                 readonly collection: "files:write";
+                readonly contact: "contacts:write";
                 readonly counter: "counter_groups:write";
                 readonly counter_group: "counter_groups:write";
                 readonly dashboard: "dashboards:write";
                 readonly file: "files:write";
                 readonly post: "posts:write";
                 readonly project: "projects:write";
-                readonly queue: "queues:write";
-                readonly queue_item: "queues:write";
                 readonly task: "projects:write";
                 readonly wiki: "wikis:write";
                 readonly wiki_page: "wikis:write";
@@ -3960,12 +3862,12 @@ export declare const pluginApiOperations: {
             readonly scopes: {
                 readonly calendar: "calendars:write";
                 readonly collection: "files:write";
+                readonly contact: "contacts:write";
                 readonly counter_group: "counter_groups:write";
                 readonly dashboard: "dashboards:write";
                 readonly file: "files:write";
                 readonly post: "posts:write";
                 readonly project: "projects:write";
-                readonly queue: "queues:write";
                 readonly task: "projects:write";
                 readonly wiki: "wikis:write";
             };
@@ -3990,7 +3892,7 @@ export declare class PluginApi {
     /**
      * Register a new webhook subscription.
      *
-     * `POST /webhooks/subscriptions`, needs one of `calendars:read`, `comments:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `initiatives:read`, `posts:read`, `projects:read`, `queues:read`, `tags:read`, `wikis:read`.
+     * `POST /webhooks/subscriptions`, needs one of `calendars:read`, `comments:read`, `contacts:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `initiatives:read`, `posts:read`, `projects:read`, `tags:read`, `wikis:read`.
      */
     createSubscription(args: {
         body: PluginApiOperations["create_subscription"]["body"];
@@ -4001,7 +3903,7 @@ export declare class PluginApi {
      * installed plug-in reaches only the subscriptions it registered, and any
      * other is a 404.
      *
-     * `DELETE /webhooks/subscriptions/{subscription_id}`, needs one of `calendars:read`, `comments:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `initiatives:read`, `posts:read`, `projects:read`, `queues:read`, `tags:read`, `wikis:read`.
+     * `DELETE /webhooks/subscriptions/{subscription_id}`, needs one of `calendars:read`, `comments:read`, `contacts:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `initiatives:read`, `posts:read`, `projects:read`, `tags:read`, `wikis:read`.
      */
     deleteSubscription(args: {
         path: PluginApiOperations["delete_subscription"]["path"];
@@ -4038,22 +3940,6 @@ export declare class PluginApi {
     createFile(args: {
         body: PluginApiOperations["create_file"]["body"];
     }): Promise<PluginApiOperations["create_file"]["answer"]>;
-    /**
-     * List queues visible to the current user (guild admins see all).
-     *
-     * `GET /queues/`, needs `queues:read`.
-     */
-    listQueues(args?: {
-        query?: PluginApiOperations["list_queues"]["query"];
-    }): Promise<PluginApiOperations["list_queues"]["answer"]>;
-    /**
-     * Create a new queue in an initiative.
-     *
-     * `POST /queues/`, needs `queues:write`.
-     */
-    createQueue(args: {
-        body: PluginApiOperations["create_queue"]["body"];
-    }): Promise<PluginApiOperations["create_queue"]["answer"]>;
     /**
      * List Counter Groups
      *
@@ -4120,6 +4006,22 @@ export declare class PluginApi {
     createWiki(args: {
         body: PluginApiOperations["create_wiki"]["body"];
     }): Promise<PluginApiOperations["create_wiki"]["answer"]>;
+    /**
+     * List contacts visible to the current user (guild admins see all).
+     *
+     * `GET /contacts/`, needs `contacts:read`.
+     */
+    listContacts(args?: {
+        query?: PluginApiOperations["list_contacts"]["query"];
+    }): Promise<PluginApiOperations["list_contacts"]["answer"]>;
+    /**
+     * Create a contact.
+     *
+     * `POST /contacts/`, needs `contacts:write`.
+     */
+    createContact(args: {
+        body: PluginApiOperations["create_contact"]["body"];
+    }): Promise<PluginApiOperations["create_contact"]["answer"]>;
     /**
      * The files in one collection the reader can open: the Files list, with its
      * parameters, narrowed to the collection, each with when it was added to it.
@@ -4133,7 +4035,9 @@ export declare class PluginApi {
     }): Promise<PluginApiOperations["list_collection_files"]["answer"]>;
     /**
      * Put files in a collection: each a file of its initiative the reader can
-     * open. One already in it stays as it is.
+     * open, starting with `metadata`'s values of the collection's metadata. One
+     * already in it stays as it is. A person gives each value the collection's
+     * file page requires.
      *
      * `POST /collections/{collection_id}/files`, needs `files:write`.
      */
@@ -4339,7 +4243,8 @@ export declare class PluginApi {
     }): Promise<PluginApiOperations["read_comment"]["answer"]>;
     /**
      * The initiatives the caller belongs to, or — for a guild admin asking for
-     * `scope=community` — every initiative in the guild.
+     * `scope=community` — every initiative in the guild, which the admin rung's
+     * reach into all content already reads.
      *
      * `GET /initiatives/`, needs `initiatives:read`.
      */
@@ -4394,7 +4299,7 @@ export declare class PluginApi {
     }): Promise<PluginApiOperations["update_file"]["answer"]>;
     /**
      * The ready-made shapes a new collection can start as, grouped, in the
-     * reader's language: the lists each shows and opens on, and its fields.
+     * reader's language: the lists each shows and opens on, and its metadata.
      *
      * `GET /collections/shapes`, needs `files:read`.
      */
@@ -4413,7 +4318,7 @@ export declare class PluginApi {
      * Make a collection of files. It starts with the files named, each one a file
      * of the initiative the reader can open. Takes the initiative role's right to
      * create files. It starts blank, as a ready-made `shape` with its words in
-     * the maker's language, or with the fields and lists of `shape_from`, a
+     * the maker's language, or with the metadata and lists of `shape_from`, a
      * collection of the same initiative the maker sees.
      *
      * `POST /collections/`, needs `files:write`.
@@ -4448,146 +4353,27 @@ export declare class PluginApi {
         body: PluginApiOperations["update_collection"]["body"];
     }): Promise<PluginApiOperations["update_collection"]["answer"]>;
     /**
-     * One file's values of the collection's own fields, for a file in the
+     * One file's values of the collection's metadata, for a file in the
      * collection the reader can open.
      *
-     * `GET /collections/{collection_id}/files/{file_id}/fields`, needs `files:read`.
+     * `GET /collections/{collection_id}/files/{file_id}/metadata`, needs `files:read`.
      */
-    getCollectionFileFields(args: {
-        path: PluginApiOperations["get_collection_file_fields"]["path"];
-    }): Promise<PluginApiOperations["get_collection_file_fields"]["answer"]>;
+    getCollectionFileMetadata(args: {
+        path: PluginApiOperations["get_collection_file_metadata"]["path"];
+    }): Promise<PluginApiOperations["get_collection_file_metadata"]["answer"]>;
     /**
-     * Replace one file's values of the collection's own fields, or with `merge`
+     * Replace one file's values of the collection's metadata, or with `merge`
      * write only the ones named, as `PUT /properties` does for a property. The
      * file is one in the collection the reader can open, and the values are the
      * collection's: they take the right to change the collection, not to edit the
      * file. An empty list clears them all.
      *
-     * `PUT /collections/{collection_id}/files/{file_id}/fields`, needs `files:write`.
-     */
-    setCollectionFileFields(args: {
-        path: PluginApiOperations["set_collection_file_fields"]["path"];
-        body: PluginApiOperations["set_collection_file_fields"]["body"];
-    }): Promise<PluginApiOperations["set_collection_file_fields"]["answer"]>;
-    /**
-     * Read Queue
-     *
-     * `GET /queues/{queue_id}`, needs `queues:read`.
-     */
-    readQueue(args: {
-        path: PluginApiOperations["read_queue"]["path"];
-        query?: PluginApiOperations["read_queue"]["query"];
-    }): Promise<PluginApiOperations["read_queue"]["answer"]>;
-    /**
-     * Update queue name/description. Requires write access.
-     *
-     * `PATCH /queues/{queue_id}`, needs `queues:write`.
-     */
-    updateQueue(args: {
-        path: PluginApiOperations["update_queue"]["path"];
-        body: PluginApiOperations["update_queue"]["body"];
-    }): Promise<PluginApiOperations["update_queue"]["answer"]>;
-    /**
-     * Add an item to a queue. Requires write access.
-     *
-     * `POST /queues/{queue_id}/items`, needs `queues:write`.
-     */
-    addQueueItem(args: {
-        path: PluginApiOperations["add_queue_item"]["path"];
-        body: PluginApiOperations["add_queue_item"]["body"];
-    }): Promise<PluginApiOperations["add_queue_item"]["answer"]>;
-    /**
-     * Start the queue: set active, reset to first item, round 1.
-     *
-     * `POST /queues/{queue_id}/start`, needs `queues:write`.
-     */
-    startQueue(args: {
-        path: PluginApiOperations["start_queue"]["path"];
-    }): Promise<PluginApiOperations["start_queue"]["answer"]>;
-    /**
-     * Stop the queue: set inactive but keep current position.
-     *
-     * `POST /queues/{queue_id}/stop`, needs `queues:write`.
-     */
-    stopQueue(args: {
-        path: PluginApiOperations["stop_queue"]["path"];
-    }): Promise<PluginApiOperations["stop_queue"]["answer"]>;
-    /**
-     * Advance to the next visible item. Wraps around and increments round.
-     *
-     * `POST /queues/{queue_id}/next`, needs `queues:write`.
-     */
-    advanceTurn(args: {
-        path: PluginApiOperations["advance_turn"]["path"];
-    }): Promise<PluginApiOperations["advance_turn"]["answer"]>;
-    /**
-     * Move to the previous visible item. Wraps around and decrements round.
-     *
-     * `POST /queues/{queue_id}/previous`, needs `queues:write`.
+     * `PUT /collections/{collection_id}/files/{file_id}/metadata`, needs `files:write`.
      */
-    previousTurn(args: {
-        path: PluginApiOperations["previous_turn"]["path"];
-    }): Promise<PluginApiOperations["previous_turn"]["answer"]>;
-    /**
-     * Jump to a specific item in the queue.
-     *
-     * `POST /queues/{queue_id}/set-active/{item_id}`, needs `queues:write`.
-     */
-    setActiveItem(args: {
-        path: PluginApiOperations["set_active_item"]["path"];
-    }): Promise<PluginApiOperations["set_active_item"]["answer"]>;
-    /**
-     * Reset the queue to round 1, first visible item.
-     *
-     * `POST /queues/{queue_id}/reset`, needs `queues:write`.
-     */
-    resetQueue(args: {
-        path: PluginApiOperations["reset_queue"]["path"];
-    }): Promise<PluginApiOperations["reset_queue"]["answer"]>;
-    /**
-     * Hold the current turn — the item leaves the rotation until it acts.
-     *
-     * `POST /queues/{queue_id}/hold`, needs `queues:write`.
-     */
-    holdCurrentTurn(args: {
-        path: PluginApiOperations["hold_current_turn"]["path"];
-    }): Promise<PluginApiOperations["hold_current_turn"]["answer"]>;
-    /**
-     * Release a held item back into the rotation.
-     *
-     * `POST /queues/{queue_id}/release/{item_id}`, needs `queues:write`.
-     */
-    releaseHeldItem(args: {
-        path: PluginApiOperations["release_held_item"]["path"];
-        body?: PluginApiOperations["release_held_item"]["body"];
-    }): Promise<PluginApiOperations["release_held_item"]["answer"]>;
-    /**
-     * One queue item by id — the read-back for a `queue_items.*` event.
-     *
-     * `GET /queue-items/{item_id}`, needs `queues:read`.
-     */
-    readQueueItem(args: {
-        path: PluginApiOperations["read_queue_item"]["path"];
-        query?: PluginApiOperations["read_queue_item"]["query"];
-    }): Promise<PluginApiOperations["read_queue_item"]["answer"]>;
-    /**
-     * Update a queue item. Requires write access on the queue.
-     *
-     * `PATCH /queue-items/{item_id}`, needs `queues:write`.
-     */
-    updateQueueItem(args: {
-        path: PluginApiOperations["update_queue_item"]["path"];
-        body: PluginApiOperations["update_queue_item"]["body"];
-    }): Promise<PluginApiOperations["update_queue_item"]["answer"]>;
-    /**
-     * Copy the item beside itself, at the same place in the turn order, as
-     * "<label> (Copy)", with its person, tags, links and properties.
-     *
-     * `POST /queue-items/{item_id}/duplicate`, needs `queues:write`.
-     */
-    duplicateQueueItem(args: {
-        path: PluginApiOperations["duplicate_queue_item"]["path"];
-    }): Promise<PluginApiOperations["duplicate_queue_item"]["answer"]>;
+    setCollectionFileMetadata(args: {
+        path: PluginApiOperations["set_collection_file_metadata"]["path"];
+        body: PluginApiOperations["set_collection_file_metadata"]["body"];
+    }): Promise<PluginApiOperations["set_collection_file_metadata"]["answer"]>;
     /**
      * Read Counter Group
      *
@@ -4805,6 +4591,23 @@ export declare class PluginApi {
         path: PluginApiOperations["move_wiki_page"]["path"];
         body: PluginApiOperations["move_wiki_page"]["body"];
     }): Promise<PluginApiOperations["move_wiki_page"]["answer"]>;
+    /**
+     * Read Contact
+     *
+     * `GET /contacts/{contact_id}`, needs `contacts:read`.
+     */
+    readContact(args: {
+        path: PluginApiOperations["read_contact"]["path"];
+    }): Promise<PluginApiOperations["read_contact"]["answer"]>;
+    /**
+     * Change a contact. A list sent replaces the one there.
+     *
+     * `PATCH /contacts/{contact_id}`, needs `contacts:write`.
+     */
+    updateContact(args: {
+        path: PluginApiOperations["update_contact"]["path"];
+        body: PluginApiOperations["update_contact"]["body"];
+    }): Promise<PluginApiOperations["update_contact"]["answer"]>;
     /**
      * Read Calendar Event
      *
@@ -4930,17 +4733,6 @@ export declare class PluginApi {
         path: PluginApiOperations["set_file_grants"]["path"];
         body: PluginApiOperations["set_file_grants"]["body"];
     }): Promise<PluginApiOperations["set_file_grants"]["answer"]>;
-    /**
-     * Replace the queue's entire sharing state in one call — the body is the full
-     * list of grants (all-initiative-members / per-user / per-role). Every
-     * non-owner grant is rebuilt from it; the owner is always preserved.
-     *
-     * `PUT /queues/{queue_id}/grants`, needs `sharing:write`.
-     */
-    setQueueGrants(args: {
-        path: PluginApiOperations["set_queue_grants"]["path"];
-        body: PluginApiOperations["set_queue_grants"]["body"];
-    }): Promise<PluginApiOperations["set_queue_grants"]["answer"]>;
     /**
      * Replace the counter group's entire sharing state in one call — the body is
      * the full list of grants (all-initiative-members / per-user / per-role).
@@ -4985,6 +4777,17 @@ export declare class PluginApi {
         path: PluginApiOperations["set_wiki_grants"]["path"];
         body: PluginApiOperations["set_wiki_grants"]["body"];
     }): Promise<PluginApiOperations["set_wiki_grants"]["answer"]>;
+    /**
+     * Replace the contact's entire sharing state in one call — the body is the
+     * full list of grants (all-initiative-members / per-user / per-role). Every
+     * non-owner grant is rebuilt from it; the owner is always preserved.
+     *
+     * `PUT /contacts/{contact_id}/grants`, needs `sharing:write`.
+     */
+    setContactGrants(args: {
+        path: PluginApiOperations["set_contact_grants"]["path"];
+        body: PluginApiOperations["set_contact_grants"]["body"];
+    }): Promise<PluginApiOperations["set_contact_grants"]["answer"]>;
     /**
      * Copy it, with everything inside it, into an initiative: its own unless the
      * body names another. Read is enough to copy a template; anything else needs
@@ -5011,19 +4814,6 @@ export declare class PluginApi {
         path: PluginApiOperations["duplicate_file"]["path"];
         body?: PluginApiOperations["duplicate_file"]["body"];
     }): Promise<PluginApiOperations["duplicate_file"]["answer"]>;
-    /**
-     * Copy it, with everything inside it, into an initiative: its own unless the
-     * body names another. Read is enough to copy a template; anything else needs
-     * write. The copy is shared as its source is while it stays in the same
-     * initiative, and carries the tags its maker may set: an installed plug-in's
-     * copy carries them only when it holds the scope to tag.
-     *
-     * `POST /queues/{queue_id}/duplicate`, needs `queues:write`.
-     */
-    duplicateQueue(args: {
-        path: PluginApiOperations["duplicate_queue"]["path"];
-        body?: PluginApiOperations["duplicate_queue"]["body"];
-    }): Promise<PluginApiOperations["duplicate_queue"]["answer"]>;
     /**
      * Copy it, with everything inside it, into an initiative: its own unless the
      * body names another. Read is enough to copy a template; anything else needs
@@ -5076,36 +4866,77 @@ export declare class PluginApi {
         path: PluginApiOperations["duplicate_wiki"]["path"];
         body?: PluginApiOperations["duplicate_wiki"]["body"];
     }): Promise<PluginApiOperations["duplicate_wiki"]["answer"]>;
+    /**
+     * Copy it, with everything inside it, into an initiative: its own unless the
+     * body names another. Read is enough to copy a template; anything else needs
+     * write. The copy is shared as its source is while it stays in the same
+     * initiative, and carries the tags its maker may set: an installed plug-in's
+     * copy carries them only when it holds the scope to tag.
+     *
+     * `POST /contacts/{contact_id}/duplicate`, needs `contacts:write`.
+     */
+    duplicateContact(args: {
+        path: PluginApiOperations["duplicate_contact"]["path"];
+        body?: PluginApiOperations["duplicate_contact"]["body"];
+    }): Promise<PluginApiOperations["duplicate_contact"]["answer"]>;
     /**
      * Titles for the command palette — a way to reach one thing quickly.
      *
-     * `GET /search/suggest`, needs one of `calendars:read`, `comments:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `posts:read`, `projects:read`, `queues:read`, `tags:read`, `wikis:read`.
+     * `GET /search/suggest`, needs one of `calendars:read`, `comments:read`, `contacts:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `posts:read`, `projects:read`, `tags:read`, `wikis:read`.
      */
     suggestCommunity(args: {
         query: PluginApiOperations["suggest_community"]["query"];
     }): Promise<PluginApiOperations["suggest_community"]["answer"]>;
     /**
-     * List property definitions.
+     * List property definitions, or a project's or a collection's metadata.
      *
-     * `GET /property-definitions/`, needs one of `calendars:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `posts:read`, `projects:read`, `properties:read`, `queues:read`, `wikis:read`.
+     * `GET /property-definitions/`, needs one of `calendars:read`, `contacts:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `posts:read`, `projects:read`, `properties:read`, `wikis:read`.
      */
     listPropertyDefinitions(args?: {
         query?: PluginApiOperations["list_property_definitions"]["query"];
     }): Promise<PluginApiOperations["list_property_definitions"]["answer"]>;
     /**
-     * Create a new property definition on an initiative, or with `collection_id`
-     * a field of that collection's own.
+     * Create a new property definition on an initiative, or with `project_id` or
+     * `collection_id` that project's or collection's metadata.
      *
-     * `POST /property-definitions/`, needs one of `files:write`, `properties:write`.
+     * `POST /property-definitions/`, needs one of `files:write`, `projects:write`, `properties:write`.
      */
     createPropertyDefinition(args: {
         body: PluginApiOperations["create_property_definition"]["body"];
     }): Promise<PluginApiOperations["create_property_definition"]["answer"]>;
+    /**
+     * The initiative's metadata, then the properties of each of its projects and
+     * each of its collections, under the owner's name.
+     *
+     * `GET /property-definitions/by-owner`, needs one of `calendars:read`, `contacts:read`, `counter_groups:read`, `dashboards:read`, `files:read`, `posts:read`, `projects:read`, `properties:read`, `wikis:read`.
+     */
+    listPropertyDefinitionsByOwner(args: {
+        query: PluginApiOperations["list_property_definitions_by_owner"]["query"];
+    }): Promise<PluginApiOperations["list_property_definitions_by_owner"]["answer"]>;
+    /**
+     * Delete several of the initiative's definitions at once, with every value of
+     * each: all of them, or, when any may not be removed as deleting it alone
+     * asks, none.
+     *
+     * `POST /property-definitions/bulk-delete`, needs one of `files:write`, `projects:write`, `properties:write`.
+     */
+    deletePropertyDefinitions(args: {
+        body: PluginApiOperations["delete_property_definitions"]["body"];
+    }): Promise<PluginApiOperations["delete_property_definitions"]["answer"]>;
+    /**
+     * Merge properties of one type, from the initiative's projects and
+     * collections, into one of its metadata named `name`, answering it.
+     *
+     * `POST /property-definitions/promote`, needs one of `files:write`, `projects:write`, `properties:write`.
+     */
+    promotePropertyDefinitions(args: {
+        body: PluginApiOperations["promote_property_definitions"]["body"];
+    }): Promise<PluginApiOperations["promote_property_definitions"]["answer"]>;
     /**
      * Delete a property definition. Cascades to remove all attached values. A
-     * collection's field is removed by whoever may change the collection.
+     * project's or a collection's metadata is removed by whoever may define it.
      *
-     * `DELETE /property-definitions/{definition_id}`, needs one of `files:write`, `properties:write`.
+     * `DELETE /property-definitions/{definition_id}`, needs one of `files:write`, `projects:write`, `properties:write`.
      */
     deletePropertyDefinition(args: {
         path: PluginApiOperations["delete_property_definition"]["path"];
@@ -5113,7 +4944,7 @@ export declare class PluginApi {
     /**
      * Update a property definition.
      *
-     * `PATCH /property-definitions/{definition_id}`, needs one of `files:write`, `properties:write`.
+     * `PATCH /property-definitions/{definition_id}`, needs one of `files:write`, `projects:write`, `properties:write`.
      */
     updatePropertyDefinition(args: {
         path: PluginApiOperations["update_property_definition"]["path"];