initiative-plugin-sdk 2.0.0

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

@@ -0,0 +1,4263 @@
+/**
+ * Generated by scripts/generate-plugin-api.mjs from Initiative 0.74.0's plug-in API
+ * (a checkout at 3b06e3609). Do not edit: regenerate.
+ */
+import type { Scope } from "./contract.js";
+/**
+ * The scope an operation needs: one scope; the scope an argument picks
+ * (`by`); or any one of several, when Initiative checks each item (`per`).
+ */
+export type PluginApiScope = Scope | {
+    by: string;
+    scopes: Readonly<Record<string, Scope>>;
+} | {
+    per: string;
+    any_of: readonly Scope[];
+};
+export interface PluginApiOperation {
+    method: "GET" | "PUT" | "POST" | "DELETE" | "PATCH";
+    path: string;
+    scope: PluginApiScope;
+    /** The query parameters sent as one JSON string each. */
+    json?: readonly string[];
+}
+export interface PluginApiArgs {
+    path?: Record<string, string | number>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+}
+/** Initiative's schemas, by name: `PluginApiSchemas["TaskRead"]`. */
+export interface PluginApiSchemas {
+    /**
+     * Things that can be archived.
+     */
+    ArchivableType: "project" | "document" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "gallery" | "wiki" | "task" | "initiative";
+    /**
+     * What archiving or unarchiving answers with.
+     */
+    ArchiveResponse: {
+        entity_type: PluginApiSchemas["ArchivableType"];
+        entity_id: number;
+        archived_at?: string | null;
+    };
+    CalendarCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        description?: string | null;
+        color?: string;
+        initiative_id?: number | null;
+        tag_ids?: number[] | null;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    CalendarEventAttendeeRead: {
+        user_id: string;
+        user: PluginApiSchemas["PluginPerson"] | null;
+        rsvp_status: PluginApiSchemas["RSVPStatus"];
+        created_at: string;
+    };
+    CalendarEventCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        title: string;
+        description?: string | null;
+        location?: string | null;
+        start_at: string;
+        end_at: string;
+        all_day?: boolean;
+        recurrence?: string | null;
+        calendar_id: number;
+        tz?: string | null;
+        attendee_ids?: string[] | null;
+        tag_ids?: number[] | null;
+        document_ids?: number[] | null;
+    };
+    CalendarEventDocumentRead: {
+        document_id: number;
+        name?: string;
+        attached_at: string;
+    };
+    CalendarEventRead: {
+        title: string;
+        description: string | null;
+        location: string | null;
+        start_at: string;
+        end_at: string;
+        all_day: boolean;
+        recurrence: string | null;
+        id: number;
+        recurrence_shift: number;
+        original_start: string | null;
+        series_id: number | null;
+        calendar_id: number;
+        initiative_id: number | null;
+        community_id: string;
+        created_by: string | null;
+        attendee_count: number;
+        attendee_names: string[];
+        attendee_previews: PluginApiSchemas["PluginPerson"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+        tags: PluginApiSchemas["TagSummary"][];
+        can: PluginApiSchemas["ContentCan"];
+        created_at: string;
+        updated_at: string;
+        attendees: PluginApiSchemas["CalendarEventAttendeeRead"][];
+        documents: PluginApiSchemas["CalendarEventDocumentRead"][];
+        overridden_fields: string[];
+        skipped_starts: string[];
+        extra_starts: string[];
+    };
+    CalendarEventUpdate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][] | null;
+        title?: string | null;
+        description?: string | null;
+        location?: string | null;
+        start_at?: string | null;
+        end_at?: string | null;
+        all_day?: boolean | null;
+        recurrence?: string | null;
+        tz?: string | null;
+        calendar_id?: number | null;
+        tag_ids?: number[] | null;
+        scope?: "this" | "following" | "all" | null;
+        occurrence?: string | null;
+    };
+    CalendarListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["CalendarSummary"][];
+    };
+    CalendarRead: {
+        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;
+        description: string | null;
+        color: string;
+    };
+    CalendarSummary: {
+        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;
+        description: string | null;
+        color: string;
+    };
+    CalendarUpdate: {
+        name?: string | null;
+        description?: string | null;
+        color?: string | null;
+    };
+    /**
+     * One checklist line as stored and read back.
+     */
+    ChecklistItem: {
+        id: string;
+        /**
+         * A person is mentioned as `@[](<reference>)`, by your reference for them,
+         * with no name: read who they are from the members search (`members:read`).
+         * Write a mention the same way. A stored file comes without its path:
+         * `![alt]()`, `[name]()`.
+         */
+        text: string;
+        done: boolean;
+    };
+    /**
+     * One checklist line as written. `id` is optional: an item that arrives
+     * without one is given a fresh id.
+     */
+    ChecklistItemInput: {
+        id?: string | null;
+        /**
+         * A person is mentioned as `@[](<reference>)`, by your reference for them,
+         * with no name: read who they are from the members search (`members:read`).
+         * Write a mention the same way. A stored file comes without its path:
+         * `![alt]()`, `[name]()`.
+         */
+        text: string;
+        done?: boolean;
+    };
+    /**
+     * The one field a tick changes.
+     */
+    ChecklistItemToggle: {
+        done: boolean;
+    };
+    ChecklistProgress: {
+        completed: number;
+        total: number;
+    };
+    /**
+     * Who a comment is said to.
+     */
+    CommentAudience: "members" | "filer";
+    CommentCreate: {
+        /**
+         * A person is mentioned as `@[](<reference>)`, by your reference for them,
+         * with no name: read who they are from the members search (`members:read`).
+         * Write a mention the same way. A stored file comes without its path:
+         * `![alt]()`, `[name]()`.
+         */
+        content: string;
+        task_id?: number | null;
+        wiki_page_id?: number | null;
+        document_id?: number | null;
+        project_id?: number | null;
+        queue_id?: number | null;
+        counter_group_id?: number | null;
+        calendar_id?: number | null;
+        dashboard_id?: number | null;
+        post_id?: number | null;
+        gallery_id?: number | null;
+        wiki_id?: number | null;
+        parent_comment_id?: number | null;
+        audience?: PluginApiSchemas["CommentAudience"];
+    };
+    /**
+     * One page of a thread: `limit` conversations, newest first, each with every
+     * reply under it.
+     */
+    CommentListResponse: {
+        comments: PluginApiSchemas["CommentRead"][];
+        next_cursor: string | null;
+    };
+    CommentRead: {
+        /**
+         * A person is mentioned as `@[](<reference>)`, by your reference for them,
+         * with no name: read who they are from the members search (`members:read`).
+         * Write a mention the same way. A stored file comes without its path:
+         * `![alt]()`, `[name]()`.
+         */
+        content: string;
+        id: number;
+        created_by: string | null;
+        task_id: number | null;
+        wiki_page_id: number | null;
+        document_id: number | null;
+        queue_id: number | null;
+        counter_group_id: number | null;
+        calendar_id: number | null;
+        dashboard_id: number | null;
+        post_id: number | null;
+        gallery_id: number | null;
+        wiki_id: number | null;
+        parent_comment_id: number | null;
+        created_at: string;
+        updated_at: string | null;
+        author: PluginApiSchemas["PluginPerson"] | null;
+        imported_author_name: string | null;
+        project_id: number | null;
+        reactions: PluginApiSchemas["ReactionGroup"][];
+        can_remove: boolean;
+        audience: PluginApiSchemas["CommentAudience"];
+        system_kind: string | null;
+    };
+    /**
+     * What the caller may do to a piece of content, as the server answers it.
+     */
+    ContentCan: {
+        edit: boolean;
+    };
+    CounterGroupCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        description?: string | null;
+        initiative_id: number;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    CounterGroupListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["CounterGroupSummary"][];
+    };
+    CounterGroupRead: {
+        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;
+        preview: PluginApiSchemas["CounterPreview"][] | null;
+        counters: PluginApiSchemas["CounterRead"][];
+    };
+    /**
+     * A counter group in a list: the group alone, without its counters — unless
+     * the list was asked for previews, when its first few come along.
+     */
+    CounterGroupSummary: {
+        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;
+        preview: PluginApiSchemas["CounterPreview"][] | null;
+    };
+    CounterGroupUpdate: {
+        name?: string | null;
+        description?: string | null;
+    };
+    /**
+     * One counter as a list's card draws it: its name, colour and count.
+     */
+    CounterPreview: {
+        id: number;
+        name: string;
+        color: string | null;
+        count: string;
+    };
+    /**
+     * Serialized counter. Numeric fields are returned as plain decimal strings
+     * (e.g. "0", "12.5") rather than `Decimal` so JSON never emits PostgreSQL's
+     * exponent notation (`0E-10`) from `Numeric(20, 10)` columns.
+     */
+    CounterRead: {
+        id: number;
+        counter_group_id: number;
+        community_id: string;
+        name: string;
+        color: string | null;
+        count: string;
+        min: string | null;
+        max: string | null;
+        step: string;
+        initial_count: string;
+        view_mode: PluginApiSchemas["CounterViewMode"];
+        position: string;
+        properties: PluginApiSchemas["PropertySummary"][];
+        created_at: string;
+        updated_at: string;
+    };
+    CounterSetCountRequest: {
+        count: number | string;
+    };
+    /**
+     * Move a counter up or down. `amount` left out moves it by the counter's own
+     * `step`; given, it must be more than nothing, since which way the counter
+     * goes is `direction`'s to say.
+     */
+    CounterStepRequest: {
+        direction: "up" | "down";
+        amount?: number | string | null;
+    };
+    CounterViewMode: "number" | "progress_bar" | "segmented_clock";
+    DocumentCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        initiative_id: number;
+        featured_image_url?: string | null;
+        is_template?: boolean;
+        content?: Record<string, unknown> | null;
+        document_type?: "native" | "whiteboard" | "smart_link" | "spreadsheet";
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    DocumentListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["DocumentSummary"][];
+        sort_by: string | null;
+        sort_dir: string | null;
+    };
+    DocumentProjectLink: {
+        project_id: number;
+        project_name?: string | null;
+        project_icon?: string | null;
+        project_initiative_id?: number | null;
+        attached_at: string;
+    };
+    DocumentRead: {
+        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;
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        featured_image_url: string | null;
+        is_template: boolean;
+        initiative: PluginApiSchemas["InitiativeSummary"] | null;
+        owner: PluginApiSchemas["PluginPerson"] | null;
+        owner_plugin: PluginApiSchemas["OwnerPluginSummary"] | null;
+        projects: PluginApiSchemas["DocumentProjectLink"][];
+        comment_count: number;
+        document_type: PluginApiSchemas["DocumentType"];
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        file_url: string | null;
+        file_content_type: string | null;
+        file_size: number | null;
+        original_filename: string | null;
+        smart_link_url: string | null;
+        yjs_updated_at: string | null;
+        /**
+         * A Lexical editor state. A person is mentioned by a node whose
+         * `mentionUserId` is your reference for them, with `mentionName` and `text`
+         * empty: read who they are from the members search (`members:read`). Write
+         * a mention the same way. A stored file comes without its path: an image's
+         * `src` and a link's `url` are empty.
+         */
+        content: Record<string, unknown>;
+        content_version: string | null;
+    };
+    DocumentSummary: {
+        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;
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        featured_image_url: string | null;
+        is_template: boolean;
+        initiative: PluginApiSchemas["InitiativeSummary"] | null;
+        owner: PluginApiSchemas["PluginPerson"] | null;
+        owner_plugin: PluginApiSchemas["OwnerPluginSummary"] | null;
+        projects: PluginApiSchemas["DocumentProjectLink"][];
+        comment_count: number;
+        document_type: PluginApiSchemas["DocumentType"];
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        file_url: string | null;
+        file_content_type: string | null;
+        file_size: number | null;
+        original_filename: string | null;
+        smart_link_url: string | null;
+        yjs_updated_at: string | null;
+    };
+    /**
+     * Discriminator for document type.
+     */
+    DocumentType: "native" | "file" | "whiteboard" | "smart_link" | "spreadsheet";
+    DocumentUpdate: {
+        name?: string | null;
+        content?: Record<string, unknown> | null;
+        content_version?: string | null;
+        featured_image_url?: string | null;
+        is_template?: boolean | null;
+    };
+    /**
+     * A single field comparison.
+     */
+    FilterCondition: {
+        field: string;
+        op?: PluginApiSchemas["FilterOp"];
+        value?: unknown;
+        negate?: boolean;
+    };
+    /**
+     * Group of conditions combined with AND or OR logic.
+     */
+    FilterGroup: {
+        logic?: "and" | "or";
+        negate?: boolean;
+        conditions: Array<PluginApiSchemas["FilterCondition"] | PluginApiSchemas["FilterGroup"]>;
+    };
+    /**
+     * Comparison operators for filter conditions.
+     */
+    FilterOp: "eq" | "lt" | "lte" | "gt" | "gte" | "in_" | "ilike" | "is_null";
+    /**
+     * What a list draws for a gallery: one picture, at whichever size it has.
+     */
+    GalleryCover: {
+        image_id: number;
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        file_url: string;
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        thumbnail_url: string | null;
+        width: number | null;
+        height: number | null;
+    };
+    GalleryCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        description?: string | null;
+        initiative_id: number;
+        tag_ids?: number[] | null;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    GalleryImageListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["GalleryImageRead"][];
+    };
+    GalleryImageRead: {
+        id: number;
+        gallery_id: number;
+        community_id: string;
+        title: string | null;
+        caption: string | null;
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        file_url: string;
+        /**
+         * A stored file comes as an empty string, without its path. A URL from
+         * elsewhere comes as it is.
+         */
+        thumbnail_url: string | null;
+        file_content_type: string | null;
+        file_size: number | null;
+        original_filename: string | null;
+        width: number | null;
+        height: number | null;
+        created_by: string;
+        uploader: PluginApiSchemas["PluginPerson"] | null;
+        created_at: string;
+        updated_at: string;
+        version_count: number;
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+    };
+    GalleryListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["GallerySummary"][];
+    };
+    /**
+     * A gallery on its own page. The same shape as its summary: the pictures are
+     * paged separately, because a gallery is browsed rather than read.
+     */
+    GalleryRead: {
+        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;
+        cover_image_id: number | null;
+        cover: PluginApiSchemas["GalleryCover"] | null;
+        preview: PluginApiSchemas["GalleryCover"][];
+        comment_count: number;
+    };
+    GallerySummary: {
+        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;
+        cover_image_id: number | null;
+        cover: PluginApiSchemas["GalleryCover"] | null;
+        preview: PluginApiSchemas["GalleryCover"][];
+        comment_count: number;
+    };
+    GalleryUpdate: {
+        name?: string | null;
+        description?: string | null;
+        cover_image_id?: number | null;
+    };
+    HTTPValidationError: {
+        detail?: PluginApiSchemas["ValidationError"][];
+    };
+    /**
+     * What the caller may do in an initiative (:func:`initiative_can`).
+     */
+    InitiativeCan: {
+        manage: boolean;
+        moderate: boolean;
+        view: PluginApiSchemas["Tool"][];
+        create: PluginApiSchemas["Tool"][];
+    };
+    /**
+     * How a guild member may come to hold a membership row in an initiative.
+     */
+    InitiativeJoinPolicy: "private" | "request" | "open";
+    /**
+     * Which initiatives `GET /initiatives/` should return.
+     */
+    InitiativeListScope: "member" | "community";
+    /**
+     * An initiative: the row, its headcount, what the caller may do in it and the
+     * role they hold there. Its roster is read a page at a time from `GET
+     * /initiatives/{id}/members`.
+     */
+    InitiativeRead: {
+        projects_enabled: boolean;
+        documents_enabled: boolean;
+        queues_enabled: boolean;
+        counter_groups_enabled: boolean;
+        calendars_enabled: boolean;
+        dashboards_enabled: boolean;
+        posts_enabled: boolean;
+        galleries_enabled: boolean;
+        wikis_enabled: boolean;
+        name: string;
+        description: string | null;
+        color: string | null;
+        id: number;
+        community_id: string | null;
+        archived_at: string | null;
+        join_policy: PluginApiSchemas["InitiativeJoinPolicy"];
+        auto_join: boolean;
+        keep_content_in: boolean;
+        created_at: string;
+        updated_at: string;
+        can: PluginApiSchemas["InitiativeCan"];
+        member_count: number;
+        role_display_name: string | null;
+    };
+    /**
+     * An initiative as something else names it: enough to label and link it.
+     */
+    InitiativeSummary: {
+        id: number;
+        name: string;
+        color: string | null;
+    };
+    /**
+     * A status column as it appears across one initiative's projects.
+     */
+    InitiativeTaskStatusRead: {
+        name: string;
+        category: PluginApiSchemas["TaskStatusCategory"];
+        color: string;
+        icon: string;
+        project_count: number;
+        projects_total: number;
+    };
+    OccurrenceRequest: {
+        start: string;
+    };
+    /**
+     * An installed plug-in that owns a resource, or may be handed one: the
+     * install's id, its name in this community, and its listing's picture.
+     */
+    OwnerPluginSummary: {
+        id: number;
+        name: string;
+        avatar_url: string | null;
+    };
+    /**
+     * A person, as an installed plug-in receives them wherever one appears.
+     */
+    PluginPerson: {
+        id: string;
+        username?: string | null;
+        discriminator?: number | null;
+        display_name?: string | null;
+        /**
+         * Where the plug-in reads the picture this member uploaded:
+         * `/api/v1/c/0/members/{id}/avatar/{sha256}`, a path on Initiative served
+         * under `members:read`. Absent when they have not uploaded one.
+         */
+        avatar_url?: string | null;
+    };
+    PollOptionRead: {
+        id: number;
+        text: string;
+        position: number;
+        vote_count: number | null;
+        voted_by_me: boolean;
+    };
+    /**
+     * One answer, as the author typed it.
+     */
+    PollOptionWrite: {
+        text: string;
+    };
+    PollRead: {
+        id: number;
+        question: string | null;
+        allows_multiple: boolean;
+        is_anonymous: boolean;
+        hide_results: boolean;
+        closes_at: string | null;
+        is_closed: boolean;
+        options: PluginApiSchemas["PollOptionRead"][];
+        has_voted: boolean;
+        results_visible: boolean;
+        total_voters: number | null;
+        is_locked: boolean;
+    };
+    /**
+     * A whole poll, sent as one thing.
+     */
+    PollWrite: {
+        question?: string | null;
+        options: PluginApiSchemas["PollOptionWrite"][];
+        allows_multiple?: boolean;
+        is_anonymous?: boolean;
+        hide_results?: boolean;
+        closes_at?: string | null;
+    };
+    PostCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        initiative_id: number;
+        /**
+         * A Lexical editor state. A person is mentioned by a node whose
+         * `mentionUserId` is your reference for them, with `mentionName` and `text`
+         * empty: read who they are from the members search (`members:read`). Write
+         * a mention the same way. A stored file comes without its path: an image's
+         * `src` and a link's `url` are empty.
+         */
+        body?: Record<string, unknown>;
+        tag_ids?: number[] | null;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+        scheduled_for?: string | null;
+        poll?: PluginApiSchemas["PollWrite"] | null;
+    };
+    PostListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["PostRead"][];
+    };
+    /**
+     * Pin or unpin one post. `pinned` false clears the expiry with it — an expiry
+     * belongs to a pin, and keeping a stale one around would silently apply to
+     * the next pin.
+     */
+    PostPinUpdate: {
+        pinned?: boolean;
+        expires_at?: string | null;
+    };
+    PostRead: {
+        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;
+        author: PluginApiSchemas["PluginPerson"] | null;
+        /**
+         * A person is mentioned as `@[](<reference>)`, by your reference for them,
+         * with no name: read who they are from the members search (`members:read`).
+         * Write a mention the same way. A stored file comes without its path:
+         * `![alt]()`, `[name]()`.
+         */
+        excerpt: string;
+        pinned_at: string | null;
+        pinned_by: string | null;
+        pin_expires_at: string | null;
+        is_pinned: boolean;
+        published_at: string | null;
+        scheduled_for: string | null;
+        is_published: boolean;
+        is_read: boolean;
+        read_count: number;
+        reactions_enabled: boolean;
+        comment_count: number;
+        reactions: PluginApiSchemas["ReactionGroup"][];
+        /**
+         * A Lexical editor state. A person is mentioned by a node whose
+         * `mentionUserId` is your reference for them, with `mentionName` and `text`
+         * empty: read who they are from the members search (`members:read`). Write
+         * a mention the same way. A stored file comes without its path: an image's
+         * `src` and a link's `url` are empty.
+         */
+        body: Record<string, unknown>;
+        poll: PluginApiSchemas["PollRead"] | null;
+    };
+    PostUpdate: {
+        name?: string | null;
+        body?: Record<string, unknown> | null;
+        scheduled_for?: string | null;
+    };
+    ProjectCan: {
+        edit: boolean;
+        contribute: boolean;
+        delete: boolean;
+        share: boolean;
+        export: boolean;
+        unarchive: boolean;
+        configure: boolean;
+    };
+    ProjectCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        description?: string | null;
+        icon?: string | null;
+        start_date?: string | null;
+        end_date?: string | null;
+        initiative_id?: number | null;
+        is_template?: boolean;
+        template_id?: number | null;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    ProjectDocumentSummary: {
+        document_id: number;
+        name: string;
+        updated_at: string;
+        attached_at: string;
+    };
+    ProjectListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["ProjectRead"][];
+    };
+    ProjectRead: {
+        archived_at: string | null;
+        can: PluginApiSchemas["ProjectCan"];
+        name: string;
+        description: string | null;
+        icon: string | null;
+        start_date: string | null;
+        end_date: string | null;
+        id: number;
+        owner_id: string | null;
+        initiative_id: number;
+        community_id: string | null;
+        created_at: string;
+        updated_at: string;
+        is_template: boolean;
+        pinned_at: string | null;
+        default_view_mode: string | null;
+        owner: PluginApiSchemas["PluginPerson"] | null;
+        owner_plugin: PluginApiSchemas["OwnerPluginSummary"] | null;
+        initiative: PluginApiSchemas["InitiativeSummary"] | null;
+        sort_order: number | null;
+        is_favorited: boolean;
+        last_viewed_at: string | null;
+        documents: PluginApiSchemas["ProjectDocumentSummary"][];
+        task_summary: PluginApiSchemas["ProjectTaskSummary"];
+        task_statuses: PluginApiSchemas["TaskStatusRead"][];
+        comments_enabled: boolean;
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+        grants: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    ProjectTaskSummary: {
+        total: number;
+        completed: number;
+    };
+    ProjectUpdate: {
+        name?: string | null;
+        description?: string | null;
+        icon?: string | null;
+        is_template?: boolean | null;
+        pinned?: boolean | null;
+        default_view_mode?: "table" | "kanban" | "calendar" | null;
+        start_date?: string | null;
+        end_date?: string | null;
+    };
+    PropertyDefinitionRead: {
+        name: string;
+        type: PluginApiSchemas["PropertyType"];
+        position: number;
+        color: string | null;
+        options: PluginApiSchemas["PropertyOption"][] | null;
+        id: number;
+        initiative_id: number;
+        created_at: string;
+        updated_at: string;
+    };
+    /**
+     * One option entry for select / multi_select property definitions.
+     */
+    PropertyOption: {
+        value: string;
+        label: string;
+        color?: string | null;
+    };
+    /**
+     * Lightweight property value for embedding in entity reads.
+     */
+    PropertySummary: {
+        property_id: number;
+        name: string;
+        type: PluginApiSchemas["PropertyType"];
+        options: PluginApiSchemas["PropertyOption"][] | null;
+        /**
+         * Shaped by the property'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.
+         */
+        value: unknown;
+    };
+    /**
+     * What can carry custom property values: every tool and sub-tool.
+     */
+    PropertyTarget: "project" | "document" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "gallery" | "wiki" | "task" | "queue_item" | "calendar_event" | "counter" | "gallery_image" | "wiki_page";
+    /**
+     * Supported value types for a property definition.
+     */
+    PropertyType: "text" | "number" | "checkbox" | "date" | "datetime" | "url" | "select" | "multi_select" | "user_reference";
+    /**
+     * A single (property_id, value) pair submitted by the client.
+     */
+    PropertyValueInput: {
+        property_id: number;
+        value?: unknown;
+    };
+    /**
+     * Replace-all payload for `PUT /properties/{target}/{entity_id}`.
+     */
+    PropertyValuesSetRequest: {
+        values?: PluginApiSchemas["PropertyValueInput"][];
+    };
+    QueueCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        description?: string | null;
+        initiative_id: number;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    QueueItemDocumentRead: {
+        document_id: number;
+        name?: string;
+        attached_at: string;
+    };
+    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"][];
+        documents: PluginApiSchemas["QueueItemDocumentRead"][];
+        tasks: PluginApiSchemas["QueueItemTaskRead"][];
+        attachment_count: number;
+        held_at_round: number | null;
+        created_at: string;
+    };
+    QueueItemTaskRead: {
+        task_id: number;
+        title?: string;
+        attached_at: string;
+    };
+    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;
+    };
+    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: PluginApiSchemas["QueueItemRead"] | 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.
+     */
+    ReactionGroup: {
+        emoji: string;
+        count: number;
+        reacted: boolean;
+        users: PluginApiSchemas["PluginPerson"][];
+    };
+    ResourceAccessLevel: "owner" | "write" | "read";
+    /**
+     * One `resource_grants` row — exactly the columns that define a grant: a
+     * `level` for a user (`user_id`), an initiative role (`role_id`), all
+     * initiative members (`all_initiative_members`), or an installed plug-in
+     * (`plugin_install_id`). Exactly one grantee is set.
+     */
+    ResourceGrantSchema: {
+        level: PluginApiSchemas["ResourceAccessLevel"];
+        user_id?: string | null;
+        role_id?: number | null;
+        all_initiative_members?: boolean;
+        plugin_install_id?: number | null;
+    };
+    SearchEntityType: "calendar" | "calendar_event" | "comment" | "counter" | "counter_group" | "dashboard" | "document" | "gallery" | "gallery_image" | "post" | "project" | "queue" | "queue_item" | "tag" | "task" | "wiki" | "wiki_page";
+    /**
+     * A jump-to target for the command palette: enough to render and route.
+     */
+    SearchSuggestion: {
+        entity_type: PluginApiSchemas["SearchEntityType"];
+        entity_id: number;
+        /**
+         * A person is mentioned as `@[](<reference>)`, by your reference for them,
+         * with no name: read who they are from the members search (`members:read`).
+         * Write a mention the same way. A stored file comes without its path:
+         * `![alt]()`, `[name]()`.
+         */
+        title: string;
+        initiative_id?: number | null;
+        tool?: PluginApiSchemas["Tool"] | null;
+        tool_id?: number | null;
+        can_write?: boolean;
+        tool_title?: string | null;
+        initiative_name?: string | null;
+    };
+    SortDir: "asc" | "desc";
+    SortField: {
+        field: string;
+        dir?: PluginApiSchemas["SortDir"];
+    };
+    /**
+     * Add and/or remove tags across many entities of one type, atomically.
+     */
+    TagBulkEditRequest: {
+        target_type: PluginApiSchemas["TagTarget"];
+        target_ids: number[];
+        add_tag_ids?: number[];
+        remove_tag_ids?: number[];
+    };
+    TagBulkEditResponse: {
+        updated_count: number;
+    };
+    TagRead: {
+        name: string;
+        color: string;
+        id: number;
+        community_id: string;
+        created_at: string;
+        updated_at: string;
+    };
+    /**
+     * Lightweight tag representation for embedding in other schemas.
+     */
+    TagSummary: {
+        id: number;
+        name: string;
+        color: string;
+    };
+    /**
+     * Entity types a bulk tag edit can address.
+     */
+    TagTarget: "project" | "document" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "gallery" | "wiki" | "task" | "queue_item" | "calendar_event" | "gallery_image" | "wiki_page";
+    TaskCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        title: string;
+        priority?: PluginApiSchemas["TaskPriority"];
+        start_date?: string | null;
+        due_date?: string | null;
+        recurrence?: string | null;
+        recurrence_strategy?: "fixed" | "rolling";
+        description?: string | null;
+        project_id: number;
+        tz?: string | null;
+        assignee_ids?: string[];
+        task_status_id?: number | null;
+        tag_ids?: number[];
+        checklist?: PluginApiSchemas["ChecklistItemInput"][];
+    };
+    /**
+     * Lightweight schema for task list endpoints - excludes heavy nested data
+     */
+    TaskListRead: {
+        title: string;
+        priority: PluginApiSchemas["TaskPriority"];
+        start_date: string | null;
+        due_date: string | null;
+        recurrence: string | null;
+        recurrence_strategy: "fixed" | "rolling";
+        description_excerpt: string | null;
+        has_description: boolean;
+        id: number;
+        project_id: number;
+        task_status_id: number;
+        task_status: PluginApiSchemas["TaskStatusRead"];
+        created_at: string;
+        updated_at: string;
+        completed_at: string | null;
+        position: number;
+        archived_at: string | null;
+        created_by: string | null;
+        assignees: PluginApiSchemas["PluginPerson"][];
+        recurrence_occurrence_count: number;
+        recurrence_shift: number;
+        recurrence_until: string | null;
+        comment_count: number;
+        blocked_by_open_count: number;
+        community_id: string | null;
+        community_name: string | null;
+        project_name: string | null;
+        initiative_id: number | null;
+        initiative_name: string | null;
+        initiative_color: string | null;
+        checklist_progress: PluginApiSchemas["ChecklistProgress"] | null;
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+    };
+    TaskListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["TaskListRead"][];
+        sorting: string | null;
+    };
+    TaskMoveRequest: {
+        target_project_id: number;
+    };
+    TaskPriority: "low" | "medium" | "high" | "urgent";
+    TaskProjectSummary: {
+        id: number;
+        name: string;
+        icon: string | null;
+        initiative_id: number | null;
+        initiative: PluginApiSchemas["InitiativeSummary"] | null;
+        archived_at: string | null;
+        is_template: boolean | null;
+    };
+    TaskRead: {
+        title: string;
+        priority: PluginApiSchemas["TaskPriority"];
+        start_date: string | null;
+        due_date: string | null;
+        recurrence: string | null;
+        recurrence_strategy: "fixed" | "rolling";
+        description: string | null;
+        id: number;
+        project_id: number;
+        task_status_id: number;
+        task_status: PluginApiSchemas["TaskStatusRead"];
+        created_at: string;
+        updated_at: string;
+        completed_at: string | null;
+        position: number;
+        archived_at: string | null;
+        created_by: string | null;
+        creator: PluginApiSchemas["PluginPerson"] | null;
+        assignees: PluginApiSchemas["PluginPerson"][];
+        recurrence_occurrence_count: number;
+        recurrence_shift: number;
+        recurrence_until: string | null;
+        series_id: number | null;
+        series_size: number;
+        comment_count: number;
+        blocked_by_open_count: number;
+        project: PluginApiSchemas["TaskProjectSummary"] | null;
+        checklist: PluginApiSchemas["ChecklistItem"][];
+        checklist_progress: PluginApiSchemas["ChecklistProgress"] | null;
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+    };
+    TaskStatusCategory: "backlog" | "todo" | "in_progress" | "done";
+    TaskStatusRead: {
+        name: string;
+        category: PluginApiSchemas["TaskStatusCategory"];
+        position: number;
+        is_default: boolean;
+        color: string;
+        icon: string;
+        id: number;
+        project_id: number;
+    };
+    TaskUpdate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][] | null;
+        title?: string | null;
+        description?: string | null;
+        task_status_id?: number | null;
+        priority?: PluginApiSchemas["TaskPriority"] | null;
+        assignee_ids?: string[] | null;
+        start_date?: string | null;
+        due_date?: string | null;
+        recurrence?: string | null;
+        tz?: string | null;
+        recurrence_strategy?: "fixed" | "rolling" | null;
+        tag_ids?: number[] | null;
+        checklist?: PluginApiSchemas["ChecklistItemInput"][] | null;
+        scope?: "this" | "following" | "all" | null;
+    };
+    Tool: "project" | "document" | "queue" | "counter_group" | "calendar" | "dashboard" | "post" | "gallery" | "wiki";
+    /**
+     * What the caller may do to one of a tool's rows
+     * (`permissions.client_access`).
+     */
+    ToolCan: {
+        edit: boolean;
+        contribute: boolean;
+        delete: boolean;
+        share: boolean;
+        export: boolean;
+        unarchive: boolean;
+    };
+    /**
+     * What a duplicate of any tool may be told. Left out, the copy goes beside
+     * its source as "<name> (Copy)"; in another initiative it keeps the name.
+     */
+    ToolDuplicateRequest: {
+        name?: string | null;
+        target_initiative_id?: number | null;
+    };
+    /**
+     * Paginated envelope for the slim user search/typeahead endpoints.
+     */
+    UserSummaryListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["PluginPerson"][];
+    };
+    ValidationError: {
+        loc: Array<string | number>;
+        msg: string;
+        type: string;
+        input?: unknown;
+        ctx?: Record<string, unknown>;
+    };
+    /**
+     * Body for `POST /api/v1/c/{community_id}/webhooks/subscriptions`.
+     */
+    WebhookSubscriptionCreate: {
+        target_url: string;
+        event_types: string[];
+        fields?: string[] | null;
+        initiative_id?: number | null;
+    };
+    /**
+     * One-time create response — includes the freshly-minted HMAC secret so the
+     * receiver can record it. Never re-emitted on subsequent reads.
+     */
+    WebhookSubscriptionCreated: {
+        id: number;
+        community_ref: string;
+        initiative_id: number | null;
+        created_by_ref: string | null;
+        target_url: string;
+        event_types: string[];
+        fields: string[] | null;
+        active: boolean;
+        dead_letter_count: number;
+        created_at: string;
+        updated_at: string;
+        hmac_secret: string;
+    };
+    WikiCreate: {
+        properties?: PluginApiSchemas["PropertyValueInput"][];
+        name: string;
+        description?: string | null;
+        initiative_id: number;
+        tag_ids?: number[] | null;
+        grants?: PluginApiSchemas["ResourceGrantSchema"][];
+    };
+    WikiListResponse: {
+        total_count: number;
+        page: number;
+        page_size: number;
+        has_next: boolean;
+        has_prev: boolean;
+        items: PluginApiSchemas["WikiSummary"][];
+    };
+    /**
+     * One heading written on a page.
+     */
+    WikiPageHeading: {
+        text: string;
+        level: number;
+        anchor: string;
+    };
+    /**
+     * What a row in a wiki's navigation actually is.
+     */
+    WikiPageKind: "page" | "document";
+    /**
+     * How a wiki's page tree is sorted.
+     */
+    WikiPageOrder: "manual" | "title" | "recently_updated";
+    /**
+     * One page, opened.
+     */
+    WikiPageRead: {
+        id: number;
+        wiki_id: number;
+        community_id: string;
+        kind: PluginApiSchemas["WikiPageKind"];
+        parent_page_id: number | null;
+        position: number;
+        is_draft: boolean;
+        title: string;
+        slug: string;
+        created_by: string | null;
+        created_at: string;
+        updated_at: string;
+        headings: PluginApiSchemas["WikiPageHeading"][];
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+        document_type: string | null;
+        file_content_type: string | null;
+        original_filename: string | null;
+        smart_link_url: string | null;
+        /**
+         * A Lexical editor state. A person is mentioned by a node whose
+         * `mentionUserId` is your reference for them, with `mentionName` and `text`
+         * empty: read who they are from the members search (`members:read`). Write
+         * a mention the same way. A stored file comes without its path: an image's
+         * `src` and a link's `url` are empty.
+         */
+        content: Record<string, unknown>;
+        content_version: string | null;
+        comment_count: number;
+    };
+    /**
+     * One page as the navigation draws it — no body.
+     */
+    WikiPageSummary: {
+        id: number;
+        wiki_id: number;
+        community_id: string;
+        kind: PluginApiSchemas["WikiPageKind"];
+        parent_page_id: number | null;
+        position: number;
+        is_draft: boolean;
+        title: string;
+        slug: string;
+        created_by: string | null;
+        created_at: string;
+        updated_at: string;
+        headings: PluginApiSchemas["WikiPageHeading"][];
+        tags: PluginApiSchemas["TagSummary"][];
+        properties: PluginApiSchemas["PropertySummary"][];
+        document_type: string | null;
+        file_content_type: string | null;
+        original_filename: string | null;
+        smart_link_url: string | null;
+    };
+    /**
+     * Every page of a wiki, in reading order — each page, then what is filed
+     * under it.
+     */
+    WikiPageTree: {
+        items: PluginApiSchemas["WikiPageSummary"][];
+    };
+    /**
+     * A wiki on its own page. The same shape as its summary: the pages are
+     * fetched as a tree of their own, because a wiki is navigated rather than
+     * read end to end.
+     */
+    WikiRead: {
+        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;
+        home_page_id: number | null;
+        page_order: PluginApiSchemas["WikiPageOrder"];
+        contents_depth: number;
+        show_connections: boolean;
+        show_updated_at: boolean;
+        reading_width: PluginApiSchemas["WikiReadingWidth"];
+        accent_color: string | null;
+        template_page_id: number | null;
+        comment_count: number;
+    };
+    /**
+     * How wide a page's body runs.
+     */
+    WikiReadingWidth: "wide" | "comfortable";
+    WikiSummary: {
+        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;
+        home_page_id: number | null;
+        page_order: PluginApiSchemas["WikiPageOrder"];
+        contents_depth: number;
+        show_connections: boolean;
+        show_updated_at: boolean;
+        reading_width: PluginApiSchemas["WikiReadingWidth"];
+        accent_color: string | null;
+        template_page_id: number | null;
+        comment_count: number;
+    };
+    WikiUpdate: {
+        page_order?: PluginApiSchemas["WikiPageOrder"] | null;
+        contents_depth?: number | null;
+        show_connections?: boolean | null;
+        show_updated_at?: boolean | null;
+        reading_width?: PluginApiSchemas["WikiReadingWidth"] | null;
+        accent_color?: string | null;
+        template_page_id?: number | null;
+        name?: string | null;
+        description?: string | null;
+        home_page_id?: number | null;
+    };
+}
+/** Each operation's arguments, by where they go, and its answer. */
+export interface PluginApiOperations {
+    create_subscription: {
+        body: PluginApiSchemas["WebhookSubscriptionCreate"];
+        answer: PluginApiSchemas["WebhookSubscriptionCreated"];
+    };
+    delete_subscription: {
+        path: {
+            subscription_id: number;
+        };
+        answer: void;
+    };
+    list_projects: {
+        query: {
+            /**
+             * 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 templates (true) or only projects that are not templates (false).
+             * Omit for both.
+             */
+            is_template?: boolean | 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;
+            /**
+             * Only projects in this initiative. Omit for every initiative the caller
+             * can see.
+             */
+            initiative_id?: number | null;
+            /**
+             * Return a lightweight projection (id, name, icon, initiative_id, can)
+             * without documents, grants, tags, or the nested initiative. For project
+             * pickers and other list-only callers.
+             */
+            slim?: boolean;
+            /**
+             * Only projects the caller may edit — the pickers that move work into a
+             * project.
+             */
+            writable?: boolean;
+            /**
+             * Order by one of: name, initiative, updated_at. Omit to keep the
+             * reader's own manual order.
+             */
+            sort_by?: string | null;
+            /**
+             * asc (default) or desc.
+             */
+            sort_dir?: string | null;
+            /**
+             * Only projects 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;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["ProjectListResponse"];
+    };
+    create_project: {
+        body: PluginApiSchemas["ProjectCreate"];
+        answer: PluginApiSchemas["ProjectRead"];
+    };
+    list_documents: {
+        query: {
+            initiative_id?: number | null;
+            /**
+             * Filter to specific document IDs — for hydrating a known set of
+             * documents without walking a collection. Maximum 100 IDs.
+             */
+            ids?: number[] | null;
+            search?: string | null;
+            /**
+             * Filter by tag IDs
+             */
+            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;
+            /**
+             * Filter to documents with no tags
+             */
+            untagged?: boolean | null;
+            /**
+             * Only templates (true) or only documents that are not templates (false).
+             * Omit for both.
+             */
+            is_template?: boolean | null;
+            /**
+             * Filter by document type
+             */
+            document_type?: PluginApiSchemas["DocumentType"] | null;
+            page?: number;
+            page_size?: number;
+            /**
+             * Order by one of: name, initiative, updated_at, created_at.
+             */
+            sort_by?: string | null;
+            /**
+             * asc (default) or desc.
+             */
+            sort_dir?: 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;
+        };
+        answer: PluginApiSchemas["DocumentListResponse"];
+    };
+    create_document: {
+        body: PluginApiSchemas["DocumentCreate"];
+        answer: PluginApiSchemas["DocumentRead"];
+    };
+    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;
+            /**
+             * 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 counter groups 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;
+            /**
+             * 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["CounterGroupListResponse"];
+    };
+    create_counter_group: {
+        body: PluginApiSchemas["CounterGroupCreate"];
+        answer: PluginApiSchemas["CounterGroupRead"];
+    };
+    list_calendars: {
+        query: {
+            initiative_id?: number | null;
+            scope?: "community" | 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 calendars 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;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["CalendarListResponse"];
+    };
+    create_calendar: {
+        body: PluginApiSchemas["CalendarCreate"];
+        answer: PluginApiSchemas["CalendarRead"];
+    };
+    list_posts: {
+        query: {
+            initiative_id?: number | null;
+            /**
+             * Full-text match over the notice — its headline and its body. Reads the
+             * same index the search page does, so the board's filter and a search
+             * agree about what matches.
+             */
+            search?: string | null;
+            /**
+             * Order by one of: name, initiative, updated_at. Omit for the board order
+             * — live pins first, then newest first.
+             */
+            sort_by?: string | null;
+            /**
+             * asc (default) or desc.
+             */
+            sort_dir?: string | null;
+            /**
+             * Only posts 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 notices this reader has not read yet.
+             */
+            unread?: boolean;
+            /**
+             * Start the board at this instant and go back — inclusive, and measured
+             * by the same date the feed is ordered by. This is how a timeline jumps
+             * to a month without paging through everything since. An anchored board
+             * is strictly chronological: the pinned band steps aside, because a pin
+             * says what matters now rather than what mattered then.
+             */
+            until?: string | null;
+            page?: number;
+            /**
+             * Posts per page. Small by default: a board renders each post's body, so
+             * a page is that many editors to mount.
+             */
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["PostListResponse"];
+    };
+    create_post: {
+        body: PluginApiSchemas["PostCreate"];
+        answer: PluginApiSchemas["PostRead"];
+    };
+    list_galleries: {
+        query: {
+            initiative_id?: number | null;
+            /**
+             * Full-text match over the gallery's name and description, through the
+             * same index the search page reads.
+             */
+            search?: string | null;
+            /**
+             * Order by one of: name, initiative, updated_at. Omit for newest first.
+             */
+            sort_by?: string | null;
+            /**
+             * asc (default) or desc.
+             */
+            sort_dir?: string | null;
+            /**
+             * Only galleries 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;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["GalleryListResponse"];
+    };
+    create_gallery: {
+        body: PluginApiSchemas["GalleryCreate"];
+        answer: PluginApiSchemas["GalleryRead"];
+    };
+    list_wikis: {
+        query: {
+            initiative_id?: number | null;
+            /**
+             * Full-text match over the wiki's name and description, through the same
+             * index the search page reads.
+             */
+            search?: string | null;
+            /**
+             * Order by one of: name, initiative, updated_at. Omit for newest first.
+             */
+            sort_by?: string | null;
+            /**
+             * asc (default) or desc.
+             */
+            sort_dir?: string | null;
+            /**
+             * Only wikis 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;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["WikiListResponse"];
+    };
+    create_wiki: {
+        body: PluginApiSchemas["WikiCreate"];
+        answer: PluginApiSchemas["WikiRead"];
+    };
+    read_project: {
+        path: {
+            project_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["ProjectRead"];
+    };
+    update_project: {
+        path: {
+            project_id: number;
+        };
+        body: PluginApiSchemas["ProjectUpdate"];
+        answer: PluginApiSchemas["ProjectRead"];
+    };
+    list_task_statuses: {
+        path: {
+            project_id: number;
+        };
+        answer: PluginApiSchemas["TaskStatusRead"][];
+    };
+    list_initiative_task_statuses: {
+        path: {
+            initiative_id: number;
+        };
+        answer: PluginApiSchemas["InitiativeTaskStatusRead"][];
+    };
+    list_tasks: {
+        query: {
+            /**
+             * JSON list of filter conditions, AND-ed together. Each object: {"field":
+             * "<column>", "op": "<operator>", "value": <val>}. Any Task column is
+             * valid plus virtual fields: status_category, assignee_ids, tag_ids,
+             * initiative_ids. An object with a "conditions" key is an AND/OR group:
+             * {"logic": "or", "conditions": [...]}.
+             */
+            conditions?: Array<PluginApiSchemas["FilterCondition"] | PluginApiSchemas["FilterGroup"]>;
+            /**
+             * Include archived tasks
+             */
+            include_archived?: boolean;
+            page?: number;
+            page_size?: number;
+            /**
+             * JSON list of sort fields: [{"field": "due_date", "dir": "desc"}]
+             */
+            sorting?: PluginApiSchemas["SortField"][];
+            /**
+             * IANA timezone name (e.g. America/Los_Angeles) for date_group
+             * calculation
+             */
+            tz?: string | null;
+        };
+        answer: PluginApiSchemas["TaskListResponse"];
+    };
+    create_task: {
+        body: PluginApiSchemas["TaskCreate"];
+        answer: PluginApiSchemas["TaskRead"];
+    };
+    read_task: {
+        path: {
+            task_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["TaskRead"];
+    };
+    update_task: {
+        path: {
+            task_id: number;
+        };
+        body: PluginApiSchemas["TaskUpdate"];
+        answer: PluginApiSchemas["TaskRead"];
+    };
+    move_task: {
+        path: {
+            task_id: number;
+        };
+        body: PluginApiSchemas["TaskMoveRequest"];
+        answer: PluginApiSchemas["TaskRead"];
+    };
+    duplicate_task: {
+        path: {
+            task_id: number;
+        };
+        answer: PluginApiSchemas["TaskRead"];
+    };
+    skip_task: {
+        path: {
+            task_id: number;
+        };
+        answer: PluginApiSchemas["TaskRead"];
+    };
+    toggle_checklist_item: {
+        path: {
+            task_id: number;
+            item_id: string;
+        };
+        body: PluginApiSchemas["ChecklistItemToggle"];
+        answer: PluginApiSchemas["ChecklistItem"][];
+    };
+    list_comments: {
+        query: {
+            task_id?: number | null;
+            document_id?: number | null;
+            project_id?: number | null;
+            queue_id?: number | null;
+            counter_group_id?: number | null;
+            calendar_id?: number | null;
+            dashboard_id?: number | null;
+            post_id?: number | null;
+            gallery_id?: number | null;
+            wiki_id?: number | null;
+            wiki_page_id?: number | null;
+            limit?: number;
+            cursor?: string | null;
+        };
+        answer: PluginApiSchemas["CommentListResponse"];
+    };
+    create_comment: {
+        body: PluginApiSchemas["CommentCreate"];
+        answer: PluginApiSchemas["CommentRead"];
+    };
+    read_comment: {
+        path: {
+            comment_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["CommentRead"];
+    };
+    list_initiatives: {
+        query: {
+            scope?: PluginApiSchemas["InitiativeListScope"];
+        };
+        answer: PluginApiSchemas["InitiativeRead"][];
+    };
+    get_initiative: {
+        path: {
+            initiative_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["InitiativeRead"];
+    };
+    read_document: {
+        path: {
+            document_id: number;
+        };
+        query: {
+            /**
+             * Include the document body. Pass false for the metadata alone — a
+             * document's body is the largest thing this API returns, and a caller
+             * reacting to a change (a name, a tag, a property) does not need it.
+             * Everything else is unchanged.
+             */
+            include_content?: boolean;
+            /**
+             * 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["DocumentRead"];
+    };
+    update_document: {
+        path: {
+            document_id: number;
+        };
+        body: PluginApiSchemas["DocumentUpdate"];
+        answer: PluginApiSchemas["DocumentRead"];
+    };
+    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"];
+    };
+    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;
+        };
+        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["CounterGroupRead"];
+    };
+    update_counter_group: {
+        path: {
+            group_id: number;
+        };
+        body: PluginApiSchemas["CounterGroupUpdate"];
+        answer: PluginApiSchemas["CounterGroupRead"];
+    };
+    read_counter: {
+        path: {
+            counter_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["CounterRead"];
+    };
+    duplicate_counter: {
+        path: {
+            counter_id: number;
+        };
+        answer: PluginApiSchemas["CounterRead"];
+    };
+    set_counter_count: {
+        path: {
+            counter_id: number;
+        };
+        body: PluginApiSchemas["CounterSetCountRequest"];
+        answer: PluginApiSchemas["CounterRead"];
+    };
+    step_counter: {
+        path: {
+            counter_id: number;
+        };
+        body: PluginApiSchemas["CounterStepRequest"];
+        answer: PluginApiSchemas["CounterRead"];
+    };
+    reset_counter: {
+        path: {
+            counter_id: number;
+        };
+        answer: PluginApiSchemas["CounterRead"];
+    };
+    read_calendar: {
+        path: {
+            calendar_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["CalendarRead"];
+    };
+    update_calendar: {
+        path: {
+            calendar_id: number;
+        };
+        body: PluginApiSchemas["CalendarUpdate"];
+        answer: PluginApiSchemas["CalendarRead"];
+    };
+    read_post: {
+        path: {
+            post_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["PostRead"];
+    };
+    update_post: {
+        path: {
+            post_id: number;
+        };
+        body: PluginApiSchemas["PostUpdate"];
+        answer: PluginApiSchemas["PostRead"];
+    };
+    set_post_pin: {
+        path: {
+            post_id: number;
+        };
+        body: PluginApiSchemas["PostPinUpdate"];
+        answer: PluginApiSchemas["PostRead"];
+    };
+    read_gallery: {
+        path: {
+            gallery_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["GalleryRead"];
+    };
+    update_gallery: {
+        path: {
+            gallery_id: number;
+        };
+        body: PluginApiSchemas["GalleryUpdate"];
+        answer: PluginApiSchemas["GalleryRead"];
+    };
+    list_gallery_images: {
+        path: {
+            gallery_id: number;
+        };
+        query: {
+            /**
+             * Only pictures carrying ANY of these tags.
+             */
+            tag_ids?: number[] | null;
+            /**
+             * Match on title, caption or filename.
+             */
+            search?: string | null;
+            /**
+             * Read the gallery in the order it was filled rather than newest first.
+             */
+            oldest_first?: boolean;
+            /**
+             * Start the list at this instant, inclusive, measured by upload time —
+             * which is what the list is ordered by. This is how a timeline jumps to a
+             * month without paging through everything since. It follows the list's
+             * own direction: newest first it is a ceiling and the page walks back
+             * from it, oldest first a floor and the page walks forward, so pair it
+             * with the matching end of the timeline bucket.
+             */
+            until?: string | null;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["GalleryImageListResponse"];
+    };
+    read_wiki: {
+        path: {
+            wiki_id: number;
+        };
+        answer: PluginApiSchemas["WikiRead"];
+    };
+    update_wiki: {
+        path: {
+            wiki_id: number;
+        };
+        body: PluginApiSchemas["WikiUpdate"];
+        answer: PluginApiSchemas["WikiRead"];
+    };
+    list_wiki_pages: {
+        path: {
+            wiki_id: number;
+        };
+        answer: PluginApiSchemas["WikiPageTree"];
+    };
+    read_wiki_page: {
+        path: {
+            page_id: number;
+        };
+        answer: PluginApiSchemas["WikiPageRead"];
+    };
+    duplicate_wiki_page: {
+        path: {
+            page_id: number;
+        };
+        answer: PluginApiSchemas["WikiPageRead"];
+    };
+    read_calendar_event: {
+        path: {
+            event_id: number;
+        };
+        query: {
+            /**
+             * One occurrence of a repeating event, whose answers to show.
+             */
+            occurrence?: string | null;
+            /**
+             * 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["CalendarEventRead"];
+    };
+    update_calendar_event: {
+        path: {
+            event_id: number;
+        };
+        body: PluginApiSchemas["CalendarEventUpdate"];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    create_calendar_event: {
+        body: PluginApiSchemas["CalendarEventCreate"];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    duplicate_calendar_event: {
+        path: {
+            event_id: number;
+        };
+        query: {
+            /**
+             * One date of a repeating event, copied as an event of its own.
+             */
+            occurrence?: string | null;
+        };
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    open_occurrence: {
+        path: {
+            event_id: number;
+        };
+        body: PluginApiSchemas["OccurrenceRequest"];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    detach_occurrence: {
+        path: {
+            event_id: number;
+        };
+        body: PluginApiSchemas["OccurrenceRequest"];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    restore_occurrence: {
+        path: {
+            event_id: number;
+        };
+        body: PluginApiSchemas["OccurrenceRequest"];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    add_occurrence: {
+        path: {
+            event_id: number;
+        };
+        body: PluginApiSchemas["OccurrenceRequest"];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    set_attendees: {
+        path: {
+            event_id: number;
+        };
+        query: {
+            scope?: "this" | "following" | "all" | null;
+            occurrence?: string | null;
+        };
+        body: string[];
+        answer: PluginApiSchemas["CalendarEventRead"];
+    };
+    list_tags: {
+        answer: PluginApiSchemas["TagRead"][];
+    };
+    bulk_edit_tags: {
+        body: PluginApiSchemas["TagBulkEditRequest"];
+        answer: PluginApiSchemas["TagBulkEditResponse"];
+    };
+    set_project_grants: {
+        path: {
+            project_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["ProjectRead"];
+    };
+    set_document_grants: {
+        path: {
+            document_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["DocumentRead"];
+    };
+    set_queue_grants: {
+        path: {
+            queue_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["QueueRead"];
+    };
+    set_counter_group_grants: {
+        path: {
+            group_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["CounterGroupRead"];
+    };
+    set_calendar_grants: {
+        path: {
+            calendar_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["CalendarRead"];
+    };
+    set_post_grants: {
+        path: {
+            post_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["PostRead"];
+    };
+    set_gallery_grants: {
+        path: {
+            gallery_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["GalleryRead"];
+    };
+    set_wiki_grants: {
+        path: {
+            wiki_id: number;
+        };
+        body: PluginApiSchemas["ResourceGrantSchema"][];
+        answer: PluginApiSchemas["WikiRead"];
+    };
+    duplicate_project: {
+        path: {
+            project_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["ProjectRead"];
+    };
+    duplicate_document: {
+        path: {
+            document_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["DocumentRead"];
+    };
+    duplicate_queue: {
+        path: {
+            queue_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["QueueRead"];
+    };
+    duplicate_counter_group: {
+        path: {
+            group_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["CounterGroupRead"];
+    };
+    duplicate_calendar: {
+        path: {
+            calendar_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["CalendarRead"];
+    };
+    duplicate_post: {
+        path: {
+            post_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["PostRead"];
+    };
+    duplicate_gallery: {
+        path: {
+            gallery_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["GalleryRead"];
+    };
+    duplicate_wiki: {
+        path: {
+            wiki_id: number;
+        };
+        body: PluginApiSchemas["ToolDuplicateRequest"] | null;
+        answer: PluginApiSchemas["WikiRead"];
+    };
+    suggest_community: {
+        query: {
+            /**
+             * What to jump to.
+             */
+            search: string;
+            /**
+             * Restrict to these entity types. Omit for the default scope (calendar,
+             * calendar_event, counter, counter_group, dashboard, document, gallery,
+             * gallery_image, post, project, queue, queue_item, tag, task, wiki,
+             * wiki_page); naming a type reaches it explicitly.
+             */
+            types?: PluginApiSchemas["SearchEntityType"][] | null;
+            /**
+             * Restrict to one initiative.
+             */
+            initiative_id?: number | null;
+            /**
+             * Omit for both. `true` returns only templates (a template picker),
+             * `false` only real content (a picker choosing where content goes).
+             */
+            is_template?: boolean | null;
+            /**
+             * The thing being written in, as a reference (`document:12`). It is left
+             * out of the answer: a thing does not point at itself. A reference that
+             * names nothing narrows nothing.
+             */
+            subject?: string | null;
+            limit?: number;
+        };
+        answer: PluginApiSchemas["SearchSuggestion"][];
+    };
+    list_property_definitions: {
+        query: {
+            initiative_id?: number | null;
+        };
+        answer: PluginApiSchemas["PropertyDefinitionRead"][];
+    };
+    set_properties: {
+        path: {
+            target: PluginApiSchemas["PropertyTarget"];
+            entity_id: number;
+        };
+        body: PluginApiSchemas["PropertyValuesSetRequest"];
+        answer: PluginApiSchemas["PropertySummary"][];
+    };
+    archive_entity: {
+        path: {
+            entity_type: PluginApiSchemas["ArchivableType"];
+            entity_id: number;
+        };
+        answer: PluginApiSchemas["ArchiveResponse"];
+    };
+    search_users: {
+        query: {
+            /**
+             * Matches the handle's name part. Type the whole handle (`foobar#1234`)
+             * to pin one member; a partial number after `#` is a prefix of the four
+             * digits as rendered. Display names members set here are matched too.
+             */
+            search?: string | null;
+            user_id?: string[] | null;
+            /**
+             * Only members of this initiative. The caller must reach it: be in it,
+             * administer the community, or (a plug-in) be placed there.
+             */
+            initiative_id?: number | null;
+            /**
+             * With `resource_id`: only the people who can open that row, which is who
+             * may be named on content inside it (assignees, attendees, person
+             * properties). The caller must be able to open it too. For a person's
+             * picker; an installed plug-in's search does not take it.
+             */
+            tool?: PluginApiSchemas["Tool"] | null;
+            resource_id?: number | null;
+            /**
+             * List the caller first, wherever the rest of the order would put them.
+             * For the community's members page, where your own row is where you set
+             * your name.
+             */
+            self_first?: boolean;
+            page?: number;
+            page_size?: number;
+        };
+        answer: PluginApiSchemas["UserSummaryListResponse"];
+    };
+    read_member_avatar: {
+        path: {
+            person: string;
+            digest: string;
+        };
+        answer: Blob;
+    };
+}
+/**
+ * Each operation a plug-in may call: its method, its path after `/api/v1/c/0`, the
+ * scope it needs, and the query parameters it takes as JSON.
+ */
+export declare const pluginApiOperations: {
+    readonly create_subscription: {
+        readonly method: "POST";
+        readonly path: "/webhooks/subscriptions";
+        readonly scope: {
+            readonly per: "event_type";
+            readonly any_of: readonly ["calendars:read", "comments:read", "counter_groups:read", "dashboards:read", "documents:read", "galleries:read", "initiatives:read", "posts:read", "projects:read", "queues:read", "tags:read", "wikis:read"];
+        };
+    };
+    readonly delete_subscription: {
+        readonly method: "DELETE";
+        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", "documents:read", "galleries:read", "initiatives:read", "posts:read", "projects:read", "queues:read", "tags:read", "wikis:read"];
+        };
+    };
+    readonly list_projects: {
+        readonly method: "GET";
+        readonly path: "/projects/";
+        readonly scope: "projects:read";
+    };
+    readonly create_project: {
+        readonly method: "POST";
+        readonly path: "/projects/";
+        readonly scope: "projects:write";
+    };
+    readonly list_documents: {
+        readonly method: "GET";
+        readonly path: "/documents/";
+        readonly scope: "documents:read";
+    };
+    readonly create_document: {
+        readonly method: "POST";
+        readonly path: "/documents/";
+        readonly scope: "documents: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/";
+        readonly scope: "counter_groups:read";
+    };
+    readonly create_counter_group: {
+        readonly method: "POST";
+        readonly path: "/counter-groups/";
+        readonly scope: "counter_groups:write";
+    };
+    readonly list_calendars: {
+        readonly method: "GET";
+        readonly path: "/calendars/";
+        readonly scope: "calendars:read";
+    };
+    readonly create_calendar: {
+        readonly method: "POST";
+        readonly path: "/calendars/";
+        readonly scope: "calendars:write";
+    };
+    readonly list_posts: {
+        readonly method: "GET";
+        readonly path: "/posts/";
+        readonly scope: "posts:read";
+    };
+    readonly create_post: {
+        readonly method: "POST";
+        readonly path: "/posts/";
+        readonly scope: "posts:write";
+    };
+    readonly list_galleries: {
+        readonly method: "GET";
+        readonly path: "/galleries/";
+        readonly scope: "galleries:read";
+    };
+    readonly create_gallery: {
+        readonly method: "POST";
+        readonly path: "/galleries/";
+        readonly scope: "galleries:write";
+    };
+    readonly list_wikis: {
+        readonly method: "GET";
+        readonly path: "/wikis/";
+        readonly scope: "wikis:read";
+    };
+    readonly create_wiki: {
+        readonly method: "POST";
+        readonly path: "/wikis/";
+        readonly scope: "wikis:write";
+    };
+    readonly read_project: {
+        readonly method: "GET";
+        readonly path: "/projects/{project_id}";
+        readonly scope: "projects:read";
+    };
+    readonly update_project: {
+        readonly method: "PATCH";
+        readonly path: "/projects/{project_id}";
+        readonly scope: "projects:write";
+    };
+    readonly list_task_statuses: {
+        readonly method: "GET";
+        readonly path: "/projects/{project_id}/task-statuses/";
+        readonly scope: "projects:read";
+    };
+    readonly list_initiative_task_statuses: {
+        readonly method: "GET";
+        readonly path: "/initiatives/{initiative_id}/task-statuses/";
+        readonly scope: "projects:read";
+    };
+    readonly list_tasks: {
+        readonly method: "GET";
+        readonly path: "/tasks/";
+        readonly scope: "projects:read";
+        readonly json: readonly ["conditions", "sorting"];
+    };
+    readonly create_task: {
+        readonly method: "POST";
+        readonly path: "/tasks/";
+        readonly scope: "projects:write";
+    };
+    readonly read_task: {
+        readonly method: "GET";
+        readonly path: "/tasks/{task_id}";
+        readonly scope: "projects:read";
+    };
+    readonly update_task: {
+        readonly method: "PATCH";
+        readonly path: "/tasks/{task_id}";
+        readonly scope: "projects:write";
+    };
+    readonly move_task: {
+        readonly method: "POST";
+        readonly path: "/tasks/{task_id}/move";
+        readonly scope: "projects:write";
+    };
+    readonly duplicate_task: {
+        readonly method: "POST";
+        readonly path: "/tasks/{task_id}/duplicate";
+        readonly scope: "projects:write";
+    };
+    readonly skip_task: {
+        readonly method: "POST";
+        readonly path: "/tasks/{task_id}/skip";
+        readonly scope: "projects:write";
+    };
+    readonly toggle_checklist_item: {
+        readonly method: "PATCH";
+        readonly path: "/tasks/{task_id}/checklist/{item_id}";
+        readonly scope: "projects:write";
+    };
+    readonly list_comments: {
+        readonly method: "GET";
+        readonly path: "/comments/";
+        readonly scope: "comments:read";
+    };
+    readonly create_comment: {
+        readonly method: "POST";
+        readonly path: "/comments/";
+        readonly scope: "comments:write";
+    };
+    readonly read_comment: {
+        readonly method: "GET";
+        readonly path: "/comments/{comment_id}";
+        readonly scope: "comments:read";
+    };
+    readonly list_initiatives: {
+        readonly method: "GET";
+        readonly path: "/initiatives/";
+        readonly scope: "initiatives:read";
+    };
+    readonly get_initiative: {
+        readonly method: "GET";
+        readonly path: "/initiatives/{initiative_id}";
+        readonly scope: "initiatives:read";
+    };
+    readonly read_document: {
+        readonly method: "GET";
+        readonly path: "/documents/{document_id}";
+        readonly scope: "documents:read";
+    };
+    readonly update_document: {
+        readonly method: "PATCH";
+        readonly path: "/documents/{document_id}";
+        readonly scope: "documents: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 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}";
+        readonly scope: "counter_groups:read";
+    };
+    readonly update_counter_group: {
+        readonly method: "PATCH";
+        readonly path: "/counter-groups/{group_id}";
+        readonly scope: "counter_groups:write";
+    };
+    readonly read_counter: {
+        readonly method: "GET";
+        readonly path: "/counters/{counter_id}";
+        readonly scope: "counter_groups:read";
+    };
+    readonly duplicate_counter: {
+        readonly method: "POST";
+        readonly path: "/counters/{counter_id}/duplicate";
+        readonly scope: "counter_groups:write";
+    };
+    readonly set_counter_count: {
+        readonly method: "POST";
+        readonly path: "/counters/{counter_id}/set";
+        readonly scope: "counter_groups:write";
+    };
+    readonly step_counter: {
+        readonly method: "POST";
+        readonly path: "/counters/{counter_id}/step";
+        readonly scope: "counter_groups:write";
+    };
+    readonly reset_counter: {
+        readonly method: "POST";
+        readonly path: "/counters/{counter_id}/reset";
+        readonly scope: "counter_groups:write";
+    };
+    readonly read_calendar: {
+        readonly method: "GET";
+        readonly path: "/calendars/{calendar_id}";
+        readonly scope: "calendars:read";
+    };
+    readonly update_calendar: {
+        readonly method: "PATCH";
+        readonly path: "/calendars/{calendar_id}";
+        readonly scope: "calendars:write";
+    };
+    readonly read_post: {
+        readonly method: "GET";
+        readonly path: "/posts/{post_id}";
+        readonly scope: "posts:read";
+    };
+    readonly update_post: {
+        readonly method: "PATCH";
+        readonly path: "/posts/{post_id}";
+        readonly scope: "posts:write";
+    };
+    readonly set_post_pin: {
+        readonly method: "PUT";
+        readonly path: "/posts/{post_id}/pin";
+        readonly scope: "posts:write";
+    };
+    readonly read_gallery: {
+        readonly method: "GET";
+        readonly path: "/galleries/{gallery_id}";
+        readonly scope: "galleries:read";
+    };
+    readonly update_gallery: {
+        readonly method: "PATCH";
+        readonly path: "/galleries/{gallery_id}";
+        readonly scope: "galleries:write";
+    };
+    readonly list_gallery_images: {
+        readonly method: "GET";
+        readonly path: "/galleries/{gallery_id}/images";
+        readonly scope: "galleries:read";
+    };
+    readonly read_wiki: {
+        readonly method: "GET";
+        readonly path: "/wikis/{wiki_id}";
+        readonly scope: "wikis:read";
+    };
+    readonly update_wiki: {
+        readonly method: "PATCH";
+        readonly path: "/wikis/{wiki_id}";
+        readonly scope: "wikis:write";
+    };
+    readonly list_wiki_pages: {
+        readonly method: "GET";
+        readonly path: "/wikis/{wiki_id}/pages";
+        readonly scope: "wikis:read";
+    };
+    readonly read_wiki_page: {
+        readonly method: "GET";
+        readonly path: "/wiki-pages/{page_id}";
+        readonly scope: "wikis:read";
+    };
+    readonly duplicate_wiki_page: {
+        readonly method: "POST";
+        readonly path: "/wiki-pages/{page_id}/duplicate";
+        readonly scope: "wikis:write";
+    };
+    readonly read_calendar_event: {
+        readonly method: "GET";
+        readonly path: "/calendar-events/{event_id}";
+        readonly scope: "calendars:read";
+    };
+    readonly update_calendar_event: {
+        readonly method: "PATCH";
+        readonly path: "/calendar-events/{event_id}";
+        readonly scope: "calendars:write";
+    };
+    readonly create_calendar_event: {
+        readonly method: "POST";
+        readonly path: "/calendar-events/";
+        readonly scope: "calendars:write";
+    };
+    readonly duplicate_calendar_event: {
+        readonly method: "POST";
+        readonly path: "/calendar-events/{event_id}/duplicate";
+        readonly scope: "calendars:write";
+    };
+    readonly open_occurrence: {
+        readonly method: "POST";
+        readonly path: "/calendar-events/{event_id}/occurrences";
+        readonly scope: "calendars:write";
+    };
+    readonly detach_occurrence: {
+        readonly method: "POST";
+        readonly path: "/calendar-events/{event_id}/occurrences/detach";
+        readonly scope: "calendars:write";
+    };
+    readonly restore_occurrence: {
+        readonly method: "POST";
+        readonly path: "/calendar-events/{event_id}/occurrences/restore";
+        readonly scope: "calendars:write";
+    };
+    readonly add_occurrence: {
+        readonly method: "POST";
+        readonly path: "/calendar-events/{event_id}/occurrences/add";
+        readonly scope: "calendars:write";
+    };
+    readonly set_attendees: {
+        readonly method: "PUT";
+        readonly path: "/calendar-events/{event_id}/attendees";
+        readonly scope: "calendars:write";
+    };
+    readonly list_tags: {
+        readonly method: "GET";
+        readonly path: "/tags/";
+        readonly scope: "tags:read";
+    };
+    readonly bulk_edit_tags: {
+        readonly method: "POST";
+        readonly path: "/tags/bulk";
+        readonly scope: "tags:write";
+    };
+    readonly set_project_grants: {
+        readonly method: "PUT";
+        readonly path: "/projects/{project_id}/grants";
+        readonly scope: "sharing:write";
+    };
+    readonly set_document_grants: {
+        readonly method: "PUT";
+        readonly path: "/documents/{document_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";
+        readonly scope: "sharing:write";
+    };
+    readonly set_calendar_grants: {
+        readonly method: "PUT";
+        readonly path: "/calendars/{calendar_id}/grants";
+        readonly scope: "sharing:write";
+    };
+    readonly set_post_grants: {
+        readonly method: "PUT";
+        readonly path: "/posts/{post_id}/grants";
+        readonly scope: "sharing:write";
+    };
+    readonly set_gallery_grants: {
+        readonly method: "PUT";
+        readonly path: "/galleries/{gallery_id}/grants";
+        readonly scope: "sharing:write";
+    };
+    readonly set_wiki_grants: {
+        readonly method: "PUT";
+        readonly path: "/wikis/{wiki_id}/grants";
+        readonly scope: "sharing:write";
+    };
+    readonly duplicate_project: {
+        readonly method: "POST";
+        readonly path: "/projects/{project_id}/duplicate";
+        readonly scope: "projects:write";
+    };
+    readonly duplicate_document: {
+        readonly method: "POST";
+        readonly path: "/documents/{document_id}/duplicate";
+        readonly scope: "documents: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";
+        readonly scope: "counter_groups:write";
+    };
+    readonly duplicate_calendar: {
+        readonly method: "POST";
+        readonly path: "/calendars/{calendar_id}/duplicate";
+        readonly scope: "calendars:write";
+    };
+    readonly duplicate_post: {
+        readonly method: "POST";
+        readonly path: "/posts/{post_id}/duplicate";
+        readonly scope: "posts:write";
+    };
+    readonly duplicate_gallery: {
+        readonly method: "POST";
+        readonly path: "/galleries/{gallery_id}/duplicate";
+        readonly scope: "galleries:write";
+    };
+    readonly duplicate_wiki: {
+        readonly method: "POST";
+        readonly path: "/wikis/{wiki_id}/duplicate";
+        readonly scope: "wikis: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", "documents:read", "galleries:read", "posts:read", "projects:read", "queues:read", "tags:read", "wikis:read"];
+        };
+    };
+    readonly list_property_definitions: {
+        readonly method: "GET";
+        readonly path: "/property-definitions/";
+        readonly scope: "initiatives:read";
+    };
+    readonly set_properties: {
+        readonly method: "PUT";
+        readonly path: "/properties/{target}/{entity_id}";
+        readonly scope: {
+            readonly by: "target";
+            readonly scopes: {
+                readonly calendar: "calendars:write";
+                readonly calendar_event: "calendars:write";
+                readonly counter: "counter_groups:write";
+                readonly counter_group: "counter_groups:write";
+                readonly dashboard: "dashboards:write";
+                readonly document: "documents:write";
+                readonly gallery: "galleries:write";
+                readonly gallery_image: "galleries: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";
+            };
+        };
+    };
+    readonly archive_entity: {
+        readonly method: "POST";
+        readonly path: "/archive/{entity_type}/{entity_id}";
+        readonly scope: {
+            readonly by: "entity_type";
+            readonly scopes: {
+                readonly calendar: "calendars:write";
+                readonly counter_group: "counter_groups:write";
+                readonly dashboard: "dashboards:write";
+                readonly document: "documents:write";
+                readonly gallery: "galleries:write";
+                readonly post: "posts:write";
+                readonly project: "projects:write";
+                readonly queue: "queues:write";
+                readonly task: "projects:write";
+                readonly wiki: "wikis:write";
+            };
+        };
+    };
+    readonly search_users: {
+        readonly method: "GET";
+        readonly path: "/users/search";
+        readonly scope: "members:read";
+    };
+    readonly read_member_avatar: {
+        readonly method: "GET";
+        readonly path: "/members/{person}/avatar/{digest}";
+        readonly scope: "members:read";
+    };
+};
+export type PluginApiOperationId = keyof typeof pluginApiOperations;
+/** Every route Initiative's plug-in API describes, as a typed method. A client's `api` is one. */
+export declare class PluginApi {
+    private readonly call;
+    constructor(call: (operation: PluginApiOperationId, args?: PluginApiArgs) => Promise<unknown>);
+    /**
+     * Register a new webhook subscription.
+     *
+     * `POST /webhooks/subscriptions`, needs one of `calendars:read`, `comments:read`, `counter_groups:read`, `dashboards:read`, `documents:read`, `galleries:read`, `initiatives:read`, `posts:read`, `projects:read`, `queues:read`, `tags:read`, `wikis:read`.
+     */
+    createSubscription(args: {
+        body: PluginApiOperations["create_subscription"]["body"];
+    }): Promise<PluginApiOperations["create_subscription"]["answer"]>;
+    /**
+     * Hard-delete a subscription. Who may is the DELETE policy, the same gates
+     * that govern the content it watches; a cross-guild lookup is a 404. An
+     * 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`, `documents:read`, `galleries:read`, `initiatives:read`, `posts:read`, `projects:read`, `queues:read`, `tags:read`, `wikis:read`.
+     */
+    deleteSubscription(args: {
+        path: PluginApiOperations["delete_subscription"]["path"];
+    }): Promise<PluginApiOperations["delete_subscription"]["answer"]>;
+    /**
+     * List Projects
+     *
+     * `GET /projects/`, needs `projects:read`.
+     */
+    listProjects(args?: {
+        query?: PluginApiOperations["list_projects"]["query"];
+    }): Promise<PluginApiOperations["list_projects"]["answer"]>;
+    /**
+     * Create Project
+     *
+     * `POST /projects/`, needs `projects:write`.
+     */
+    createProject(args: {
+        body: PluginApiOperations["create_project"]["body"];
+    }): Promise<PluginApiOperations["create_project"]["answer"]>;
+    /**
+     * List documents in the active guild visible to the current user.
+     *
+     * `GET /documents/`, needs `documents:read`.
+     */
+    listDocuments(args?: {
+        query?: PluginApiOperations["list_documents"]["query"];
+    }): Promise<PluginApiOperations["list_documents"]["answer"]>;
+    /**
+     * Create Document
+     *
+     * `POST /documents/`, needs `documents:write`.
+     */
+    createDocument(args: {
+        body: PluginApiOperations["create_document"]["body"];
+    }): Promise<PluginApiOperations["create_document"]["answer"]>;
+    /**
+     * List queues visible to the current user.
+     *
+     * `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
+     *
+     * `GET /counter-groups/`, needs `counter_groups:read`.
+     */
+    listCounterGroups(args?: {
+        query?: PluginApiOperations["list_counter_groups"]["query"];
+    }): Promise<PluginApiOperations["list_counter_groups"]["answer"]>;
+    /**
+     * Create Counter Group
+     *
+     * `POST /counter-groups/`, needs `counter_groups:write`.
+     */
+    createCounterGroup(args: {
+        body: PluginApiOperations["create_counter_group"]["body"];
+    }): Promise<PluginApiOperations["create_counter_group"]["answer"]>;
+    /**
+     * List calendars visible to the current user (guild admins see all).
+     *
+     * `GET /calendars/`, needs `calendars:read`.
+     */
+    listCalendars(args?: {
+        query?: PluginApiOperations["list_calendars"]["query"];
+    }): Promise<PluginApiOperations["list_calendars"]["answer"]>;
+    /**
+     * Create a calendar.
+     *
+     * `POST /calendars/`, needs `calendars:write`.
+     */
+    createCalendar(args: {
+        body: PluginApiOperations["create_calendar"]["body"];
+    }): Promise<PluginApiOperations["create_calendar"]["answer"]>;
+    /**
+     * List posts visible to the current user (guild admins see all).
+     *
+     * `GET /posts/`, needs `posts:read`.
+     */
+    listPosts(args?: {
+        query?: PluginApiOperations["list_posts"]["query"];
+    }): Promise<PluginApiOperations["list_posts"]["answer"]>;
+    /**
+     * Post a notice to an initiative's board. Requires create_posts permission on
+     * the initiative (or guild admin); the author gets the owner grant.
+     *
+     * `POST /posts/`, needs `posts:write`.
+     */
+    createPost(args: {
+        body: PluginApiOperations["create_post"]["body"];
+    }): Promise<PluginApiOperations["create_post"]["answer"]>;
+    /**
+     * List galleries visible to the current user (guild admins see all).
+     *
+     * `GET /galleries/`, needs `galleries:read`.
+     */
+    listGalleries(args?: {
+        query?: PluginApiOperations["list_galleries"]["query"];
+    }): Promise<PluginApiOperations["list_galleries"]["answer"]>;
+    /**
+     * Create a gallery. Requires create_galleries permission on the initiative
+     * (or guild admin); the creator gets the owner grant.
+     *
+     * `POST /galleries/`, needs `galleries:write`.
+     */
+    createGallery(args: {
+        body: PluginApiOperations["create_gallery"]["body"];
+    }): Promise<PluginApiOperations["create_gallery"]["answer"]>;
+    /**
+     * List wikis visible to the current user (guild admins see all).
+     *
+     * `GET /wikis/`, needs `wikis:read`.
+     */
+    listWikis(args?: {
+        query?: PluginApiOperations["list_wikis"]["query"];
+    }): Promise<PluginApiOperations["list_wikis"]["answer"]>;
+    /**
+     * Create a wiki. Requires create_wikis permission on the initiative (or guild
+     * admin); the creator gets the owner grant.
+     *
+     * `POST /wikis/`, needs `wikis:write`.
+     */
+    createWiki(args: {
+        body: PluginApiOperations["create_wiki"]["body"];
+    }): Promise<PluginApiOperations["create_wiki"]["answer"]>;
+    /**
+     * Read Project
+     *
+     * `GET /projects/{project_id}`, needs `projects:read`.
+     */
+    readProject(args: {
+        path: PluginApiOperations["read_project"]["path"];
+        query?: PluginApiOperations["read_project"]["query"];
+    }): Promise<PluginApiOperations["read_project"]["answer"]>;
+    /**
+     * Update Project
+     *
+     * `PATCH /projects/{project_id}`, needs `projects:write`.
+     */
+    updateProject(args: {
+        path: PluginApiOperations["update_project"]["path"];
+        body: PluginApiOperations["update_project"]["body"];
+    }): Promise<PluginApiOperations["update_project"]["answer"]>;
+    /**
+     * List Task Statuses
+     *
+     * `GET /projects/{project_id}/task-statuses/`, needs `projects:read`.
+     */
+    listTaskStatuses(args: {
+        path: PluginApiOperations["list_task_statuses"]["path"];
+    }): Promise<PluginApiOperations["list_task_statuses"]["answer"]>;
+    /**
+     * The distinct status columns across the initiative's readable projects.
+     *
+     * `GET /initiatives/{initiative_id}/task-statuses/`, needs `projects:read`.
+     */
+    listInitiativeTaskStatuses(args: {
+        path: PluginApiOperations["list_initiative_task_statuses"]["path"];
+    }): Promise<PluginApiOperations["list_initiative_task_statuses"]["answer"]>;
+    /**
+     * List Tasks
+     *
+     * `GET /tasks/`, needs `projects:read`.
+     */
+    listTasks(args?: {
+        query?: PluginApiOperations["list_tasks"]["query"];
+    }): Promise<PluginApiOperations["list_tasks"]["answer"]>;
+    /**
+     * Create Task
+     *
+     * `POST /tasks/`, needs `projects:write`.
+     */
+    createTask(args: {
+        body: PluginApiOperations["create_task"]["body"];
+    }): Promise<PluginApiOperations["create_task"]["answer"]>;
+    /**
+     * Read Task
+     *
+     * `GET /tasks/{task_id}`, needs `projects:read`.
+     */
+    readTask(args: {
+        path: PluginApiOperations["read_task"]["path"];
+        query?: PluginApiOperations["read_task"]["query"];
+    }): Promise<PluginApiOperations["read_task"]["answer"]>;
+    /**
+     * Update Task
+     *
+     * `PATCH /tasks/{task_id}`, needs `projects:write`.
+     */
+    updateTask(args: {
+        path: PluginApiOperations["update_task"]["path"];
+        body: PluginApiOperations["update_task"]["body"];
+    }): Promise<PluginApiOperations["update_task"]["answer"]>;
+    /**
+     * Move Task
+     *
+     * `POST /tasks/{task_id}/move`, needs `projects:write`.
+     */
+    moveTask(args: {
+        path: PluginApiOperations["move_task"]["path"];
+        body: PluginApiOperations["move_task"]["body"];
+    }): Promise<PluginApiOperations["move_task"]["answer"]>;
+    /**
+     * Copy the task beside itself, at the end of its project, as "<title>
+     * (Copy)", with its assignees, tags, links and properties; its checklist
+     * starts unticked.
+     *
+     * `POST /tasks/{task_id}/duplicate`, needs `projects:write`.
+     */
+    duplicateTask(args: {
+        path: PluginApiOperations["duplicate_task"]["path"];
+    }): Promise<PluginApiOperations["duplicate_task"]["answer"]>;
+    /**
+     * Move a repeating task on to its next occurrence without completing it.
+     *
+     * `POST /tasks/{task_id}/skip`, needs `projects:write`.
+     */
+    skipTask(args: {
+        path: PluginApiOperations["skip_task"]["path"];
+    }): Promise<PluginApiOperations["skip_task"]["answer"]>;
+    /**
+     * Tick or untick one checklist item.
+     *
+     * `PATCH /tasks/{task_id}/checklist/{item_id}`, needs `projects:write`.
+     */
+    toggleChecklistItem(args: {
+        path: PluginApiOperations["toggle_checklist_item"]["path"];
+        body: PluginApiOperations["toggle_checklist_item"]["body"];
+    }): Promise<PluginApiOperations["toggle_checklist_item"]["answer"]>;
+    /**
+     * One page of a thread: `limit` conversations, newest first, each with every
+     * reply under it. Follow `next_cursor` for older conversations.
+     *
+     * `GET /comments/`, needs `comments:read`.
+     */
+    listComments(args?: {
+        query?: PluginApiOperations["list_comments"]["query"];
+    }): Promise<PluginApiOperations["list_comments"]["answer"]>;
+    /**
+     * Create Comment
+     *
+     * `POST /comments/`, needs `comments:write`.
+     */
+    createComment(args: {
+        body: PluginApiOperations["create_comment"]["body"];
+    }): Promise<PluginApiOperations["create_comment"]["answer"]>;
+    /**
+     * One comment by id — the read-back for a `comments.*` event.
+     *
+     * `GET /comments/{comment_id}`, needs `comments:read`.
+     */
+    readComment(args: {
+        path: PluginApiOperations["read_comment"]["path"];
+        query?: PluginApiOperations["read_comment"]["query"];
+    }): 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.
+     *
+     * `GET /initiatives/`, needs `initiatives:read`.
+     */
+    listInitiatives(args?: {
+        query?: PluginApiOperations["list_initiatives"]["query"];
+    }): Promise<PluginApiOperations["list_initiatives"]["answer"]>;
+    /**
+     * Get Initiative
+     *
+     * `GET /initiatives/{initiative_id}`, needs `initiatives:read`.
+     */
+    getInitiative(args: {
+        path: PluginApiOperations["get_initiative"]["path"];
+        query?: PluginApiOperations["get_initiative"]["query"];
+    }): Promise<PluginApiOperations["get_initiative"]["answer"]>;
+    /**
+     * Read Document
+     *
+     * `GET /documents/{document_id}`, needs `documents:read`.
+     */
+    readDocument(args: {
+        path: PluginApiOperations["read_document"]["path"];
+        query?: PluginApiOperations["read_document"]["query"];
+    }): Promise<PluginApiOperations["read_document"]["answer"]>;
+    /**
+     * Update Document
+     *
+     * `PATCH /documents/{document_id}`, needs `documents:write`.
+     */
+    updateDocument(args: {
+        path: PluginApiOperations["update_document"]["path"];
+        body: PluginApiOperations["update_document"]["body"];
+    }): Promise<PluginApiOperations["update_document"]["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"]>;
+    /**
+     * 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`.
+     */
+    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"]>;
+    /**
+     * Read Counter Group
+     *
+     * `GET /counter-groups/{group_id}`, needs `counter_groups:read`.
+     */
+    readCounterGroup(args: {
+        path: PluginApiOperations["read_counter_group"]["path"];
+        query?: PluginApiOperations["read_counter_group"]["query"];
+    }): Promise<PluginApiOperations["read_counter_group"]["answer"]>;
+    /**
+     * Update Counter Group
+     *
+     * `PATCH /counter-groups/{group_id}`, needs `counter_groups:write`.
+     */
+    updateCounterGroup(args: {
+        path: PluginApiOperations["update_counter_group"]["path"];
+        body: PluginApiOperations["update_counter_group"]["body"];
+    }): Promise<PluginApiOperations["update_counter_group"]["answer"]>;
+    /**
+     * One counter by id — the read-back for a `counters.*` event.
+     *
+     * `GET /counters/{counter_id}`, needs `counter_groups:read`.
+     */
+    readCounter(args: {
+        path: PluginApiOperations["read_counter"]["path"];
+        query?: PluginApiOperations["read_counter"]["query"];
+    }): Promise<PluginApiOperations["read_counter"]["answer"]>;
+    /**
+     * Copy the counter to the end of its group as "<name> (Copy)", with its
+     * count, tags and properties.
+     *
+     * `POST /counters/{counter_id}/duplicate`, needs `counter_groups:write`.
+     */
+    duplicateCounter(args: {
+        path: PluginApiOperations["duplicate_counter"]["path"];
+    }): Promise<PluginApiOperations["duplicate_counter"]["answer"]>;
+    /**
+     * Put a counter at a number, held within its bounds.
+     *
+     * `POST /counters/{counter_id}/set`, needs `counter_groups:write`.
+     */
+    setCounterCount(args: {
+        path: PluginApiOperations["set_counter_count"]["path"];
+        body: PluginApiOperations["set_counter_count"]["body"];
+    }): Promise<PluginApiOperations["set_counter_count"]["answer"]>;
+    /**
+     * Move a counter up or down, by `amount` or by its own step, held within its
+     * bounds. Two steps landing together each count.
+     *
+     * `POST /counters/{counter_id}/step`, needs `counter_groups:write`.
+     */
+    stepCounter(args: {
+        path: PluginApiOperations["step_counter"]["path"];
+        body: PluginApiOperations["step_counter"]["body"];
+    }): Promise<PluginApiOperations["step_counter"]["answer"]>;
+    /**
+     * Put a counter back to the value it starts from.
+     *
+     * `POST /counters/{counter_id}/reset`, needs `counter_groups:write`.
+     */
+    resetCounter(args: {
+        path: PluginApiOperations["reset_counter"]["path"];
+    }): Promise<PluginApiOperations["reset_counter"]["answer"]>;
+    /**
+     * Read Calendar
+     *
+     * `GET /calendars/{calendar_id}`, needs `calendars:read`.
+     */
+    readCalendar(args: {
+        path: PluginApiOperations["read_calendar"]["path"];
+        query?: PluginApiOperations["read_calendar"]["query"];
+    }): Promise<PluginApiOperations["read_calendar"]["answer"]>;
+    /**
+     * Rename/update a calendar. Asks the edit action, which on a guild calendar
+     * is the guild admin's: a write grant on one writes its events.
+     *
+     * `PATCH /calendars/{calendar_id}`, needs `calendars:write`.
+     */
+    updateCalendar(args: {
+        path: PluginApiOperations["update_calendar"]["path"];
+        body: PluginApiOperations["update_calendar"]["body"];
+    }): Promise<PluginApiOperations["update_calendar"]["answer"]>;
+    /**
+     * Read one notice. A scheduled one is its writers' until it goes up; to
+     * anyone else it is not there (the posts read policy).
+     *
+     * `GET /posts/{post_id}`, needs `posts:read`.
+     */
+    readPost(args: {
+        path: PluginApiOperations["read_post"]["path"];
+        query?: PluginApiOperations["read_post"]["query"];
+    }): Promise<PluginApiOperations["read_post"]["answer"]>;
+    /**
+     * Edit a notice — its headline, its body, or a schedule not yet reached.
+     * Requires write access.
+     *
+     * `PATCH /posts/{post_id}`, needs `posts:write`.
+     */
+    updatePost(args: {
+        path: PluginApiOperations["update_post"]["path"];
+        body: PluginApiOperations["update_post"]["body"];
+    }): Promise<PluginApiOperations["update_post"]["answer"]>;
+    /**
+     * Pin a notice to the top of the board, or take it back down.
+     *
+     * `PUT /posts/{post_id}/pin`, needs `posts:write`.
+     */
+    setPostPin(args: {
+        path: PluginApiOperations["set_post_pin"]["path"];
+        body: PluginApiOperations["set_post_pin"]["body"];
+    }): Promise<PluginApiOperations["set_post_pin"]["answer"]>;
+    /**
+     * Read Gallery
+     *
+     * `GET /galleries/{gallery_id}`, needs `galleries:read`.
+     */
+    readGallery(args: {
+        path: PluginApiOperations["read_gallery"]["path"];
+        query?: PluginApiOperations["read_gallery"]["query"];
+    }): Promise<PluginApiOperations["read_gallery"]["answer"]>;
+    /**
+     * Rename, describe, or choose the cover. Requires write access.
+     *
+     * `PATCH /galleries/{gallery_id}`, needs `galleries:write`.
+     */
+    updateGallery(args: {
+        path: PluginApiOperations["update_gallery"]["path"];
+        body: PluginApiOperations["update_gallery"]["body"];
+    }): Promise<PluginApiOperations["update_gallery"]["answer"]>;
+    /**
+     * One page of a gallery's pictures, newest first.
+     *
+     * `GET /galleries/{gallery_id}/images`, needs `galleries:read`.
+     */
+    listGalleryImages(args: {
+        path: PluginApiOperations["list_gallery_images"]["path"];
+        query?: PluginApiOperations["list_gallery_images"]["query"];
+    }): Promise<PluginApiOperations["list_gallery_images"]["answer"]>;
+    /**
+     * Read Wiki
+     *
+     * `GET /wikis/{wiki_id}`, needs `wikis:read`.
+     */
+    readWiki(args: {
+        path: PluginApiOperations["read_wiki"]["path"];
+    }): Promise<PluginApiOperations["read_wiki"]["answer"]>;
+    /**
+     * Update Wiki
+     *
+     * `PATCH /wikis/{wiki_id}`, needs `wikis:write`.
+     */
+    updateWiki(args: {
+        path: PluginApiOperations["update_wiki"]["path"];
+        body: PluginApiOperations["update_wiki"]["body"];
+    }): Promise<PluginApiOperations["update_wiki"]["answer"]>;
+    /**
+     * Every page of a wiki, in reading order.
+     *
+     * `GET /wikis/{wiki_id}/pages`, needs `wikis:read`.
+     */
+    listWikiPages(args: {
+        path: PluginApiOperations["list_wiki_pages"]["path"];
+    }): Promise<PluginApiOperations["list_wiki_pages"]["answer"]>;
+    /**
+     * One page by its own id, which is all a link to it, a mention or a stored
+     * notification names.
+     *
+     * `GET /wiki-pages/{page_id}`, needs `wikis:read`.
+     */
+    readWikiPage(args: {
+        path: PluginApiOperations["read_wiki_page"]["path"];
+    }): Promise<PluginApiOperations["read_wiki_page"]["answer"]>;
+    /**
+     * Copy the page, without the pages under it, to the end of where it is filed,
+     * as "<title> (Copy)", with its tags, links and properties.
+     *
+     * `POST /wiki-pages/{page_id}/duplicate`, needs `wikis:write`.
+     */
+    duplicateWikiPage(args: {
+        path: PluginApiOperations["duplicate_wiki_page"]["path"];
+    }): Promise<PluginApiOperations["duplicate_wiki_page"]["answer"]>;
+    /**
+     * Read Calendar Event
+     *
+     * `GET /calendar-events/{event_id}`, needs `calendars:read`.
+     */
+    readCalendarEvent(args: {
+        path: PluginApiOperations["read_calendar_event"]["path"];
+        query?: PluginApiOperations["read_calendar_event"]["query"];
+    }): Promise<PluginApiOperations["read_calendar_event"]["answer"]>;
+    /**
+     * Update a calendar event. Requires write access on the calendar (and on the
+     * target calendar when moving the event).
+     *
+     * `PATCH /calendar-events/{event_id}`, needs `calendars:write`.
+     */
+    updateCalendarEvent(args: {
+        path: PluginApiOperations["update_calendar_event"]["path"];
+        body: PluginApiOperations["update_calendar_event"]["body"];
+    }): Promise<PluginApiOperations["update_calendar_event"]["answer"]>;
+    /**
+     * Create a calendar event. Requires write access on the calendar.
+     *
+     * `POST /calendar-events/`, needs `calendars:write`.
+     */
+    createCalendarEvent(args: {
+        body: PluginApiOperations["create_calendar_event"]["body"];
+    }): Promise<PluginApiOperations["create_calendar_event"]["answer"]>;
+    /**
+     * Copy the event beside itself as "<title> (Copy)", with its invitees, who
+     * are invited to it as to a new event, its tags, links and properties. A
+     * repeating event comes with its occurrences changed on their own; one
+     * changed occurrence, or the `occurrence` named, is copied as an event of its
+     * own.
+     *
+     * `POST /calendar-events/{event_id}/duplicate`, needs `calendars:write`.
+     */
+    duplicateCalendarEvent(args: {
+        path: PluginApiOperations["duplicate_calendar_event"]["path"];
+        query?: PluginApiOperations["duplicate_calendar_event"]["query"];
+    }): Promise<PluginApiOperations["duplicate_calendar_event"]["answer"]>;
+    /**
+     * The occurrence starting at `start` as a row of its own, made from the
+     * series the first time it is asked for, so it can change, carry its own
+     * attendees or be linked to alone. Requires write access on the calendar.
+     *
+     * `POST /calendar-events/{event_id}/occurrences`, needs `calendars:write`.
+     */
+    openOccurrence(args: {
+        path: PluginApiOperations["open_occurrence"]["path"];
+        body: PluginApiOperations["open_occurrence"]["body"];
+    }): Promise<PluginApiOperations["open_occurrence"]["answer"]>;
+    /**
+     * Copy the occurrence at `start` out into an event of its own, which the
+     * series then skips.
+     *
+     * `POST /calendar-events/{event_id}/occurrences/detach`, needs `calendars:write`.
+     */
+    detachOccurrence(args: {
+        path: PluginApiOperations["detach_occurrence"]["path"];
+        body: PluginApiOperations["detach_occurrence"]["body"];
+    }): Promise<PluginApiOperations["detach_occurrence"]["answer"]>;
+    /**
+     * Bring back a skipped occurrence of the series.
+     *
+     * `POST /calendar-events/{event_id}/occurrences/restore`, needs `calendars:write`.
+     */
+    restoreOccurrence(args: {
+        path: PluginApiOperations["restore_occurrence"]["path"];
+        body: PluginApiOperations["restore_occurrence"]["body"];
+    }): Promise<PluginApiOperations["restore_occurrence"]["answer"]>;
+    /**
+     * Give the series an extra occurrence at `start`.
+     *
+     * `POST /calendar-events/{event_id}/occurrences/add`, needs `calendars:write`.
+     */
+    addOccurrence(args: {
+        path: PluginApiOperations["add_occurrence"]["path"];
+        body: PluginApiOperations["add_occurrence"]["body"];
+    }): Promise<PluginApiOperations["add_occurrence"]["answer"]>;
+    /**
+     * Set attendees. Requires write access on the calendar.
+     *
+     * `PUT /calendar-events/{event_id}/attendees`, needs `calendars:write`.
+     */
+    setAttendees(args: {
+        path: PluginApiOperations["set_attendees"]["path"];
+        query?: PluginApiOperations["set_attendees"]["query"];
+        body: PluginApiOperations["set_attendees"]["body"];
+    }): Promise<PluginApiOperations["set_attendees"]["answer"]>;
+    /**
+     * List all tags in the current guild.
+     *
+     * `GET /tags/`, needs `tags:read`.
+     */
+    listTags(): Promise<PluginApiOperations["list_tags"]["answer"]>;
+    /**
+     * Add and/or remove tags across many entities of one type, atomically.
+     *
+     * `POST /tags/bulk`, needs `tags:write`.
+     */
+    bulkEditTags(args: {
+        body: PluginApiOperations["bulk_edit_tags"]["body"];
+    }): Promise<PluginApiOperations["bulk_edit_tags"]["answer"]>;
+    /**
+     * Replace the project'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 /projects/{project_id}/grants`, needs `sharing:write`.
+     */
+    setProjectGrants(args: {
+        path: PluginApiOperations["set_project_grants"]["path"];
+        body: PluginApiOperations["set_project_grants"]["body"];
+    }): Promise<PluginApiOperations["set_project_grants"]["answer"]>;
+    /**
+     * Replace the document'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 /documents/{document_id}/grants`, needs `sharing:write`.
+     */
+    setDocumentGrants(args: {
+        path: PluginApiOperations["set_document_grants"]["path"];
+        body: PluginApiOperations["set_document_grants"]["body"];
+    }): Promise<PluginApiOperations["set_document_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).
+     * Every non-owner grant is rebuilt from it; the owner is always preserved.
+     *
+     * `PUT /counter-groups/{group_id}/grants`, needs `sharing:write`.
+     */
+    setCounterGroupGrants(args: {
+        path: PluginApiOperations["set_counter_group_grants"]["path"];
+        body: PluginApiOperations["set_counter_group_grants"]["body"];
+    }): Promise<PluginApiOperations["set_counter_group_grants"]["answer"]>;
+    /**
+     * Replace the calendar'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 /calendars/{calendar_id}/grants`, needs `sharing:write`.
+     */
+    setCalendarGrants(args: {
+        path: PluginApiOperations["set_calendar_grants"]["path"];
+        body: PluginApiOperations["set_calendar_grants"]["body"];
+    }): Promise<PluginApiOperations["set_calendar_grants"]["answer"]>;
+    /**
+     * Replace the post'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 /posts/{post_id}/grants`, needs `sharing:write`.
+     */
+    setPostGrants(args: {
+        path: PluginApiOperations["set_post_grants"]["path"];
+        body: PluginApiOperations["set_post_grants"]["body"];
+    }): Promise<PluginApiOperations["set_post_grants"]["answer"]>;
+    /**
+     * Replace the gallery's entire sharing state in one call — the body is the
+     * full list of grants. Every non-owner grant is rebuilt from it; the owner is
+     * always preserved.
+     *
+     * `PUT /galleries/{gallery_id}/grants`, needs `sharing:write`.
+     */
+    setGalleryGrants(args: {
+        path: PluginApiOperations["set_gallery_grants"]["path"];
+        body: PluginApiOperations["set_gallery_grants"]["body"];
+    }): Promise<PluginApiOperations["set_gallery_grants"]["answer"]>;
+    /**
+     * Set Wiki Grants
+     *
+     * `PUT /wikis/{wiki_id}/grants`, needs `sharing:write`.
+     */
+    setWikiGrants(args: {
+        path: PluginApiOperations["set_wiki_grants"]["path"];
+        body: PluginApiOperations["set_wiki_grants"]["body"];
+    }): Promise<PluginApiOperations["set_wiki_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
+     * 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 /projects/{project_id}/duplicate`, needs `projects:write`.
+     */
+    duplicateProject(args: {
+        path: PluginApiOperations["duplicate_project"]["path"];
+        body?: PluginApiOperations["duplicate_project"]["body"];
+    }): Promise<PluginApiOperations["duplicate_project"]["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 /documents/{document_id}/duplicate`, needs `documents:write`.
+     */
+    duplicateDocument(args: {
+        path: PluginApiOperations["duplicate_document"]["path"];
+        body?: PluginApiOperations["duplicate_document"]["body"];
+    }): Promise<PluginApiOperations["duplicate_document"]["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
+     * 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 /counter-groups/{group_id}/duplicate`, needs `counter_groups:write`.
+     */
+    duplicateCounterGroup(args: {
+        path: PluginApiOperations["duplicate_counter_group"]["path"];
+        body?: PluginApiOperations["duplicate_counter_group"]["body"];
+    }): Promise<PluginApiOperations["duplicate_counter_group"]["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 /calendars/{calendar_id}/duplicate`, needs `calendars:write`.
+     */
+    duplicateCalendar(args: {
+        path: PluginApiOperations["duplicate_calendar"]["path"];
+        body?: PluginApiOperations["duplicate_calendar"]["body"];
+    }): Promise<PluginApiOperations["duplicate_calendar"]["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 /posts/{post_id}/duplicate`, needs `posts:write`.
+     */
+    duplicatePost(args: {
+        path: PluginApiOperations["duplicate_post"]["path"];
+        body?: PluginApiOperations["duplicate_post"]["body"];
+    }): Promise<PluginApiOperations["duplicate_post"]["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 /galleries/{gallery_id}/duplicate`, needs `galleries:write`.
+     */
+    duplicateGallery(args: {
+        path: PluginApiOperations["duplicate_gallery"]["path"];
+        body?: PluginApiOperations["duplicate_gallery"]["body"];
+    }): Promise<PluginApiOperations["duplicate_gallery"]["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 /wikis/{wiki_id}/duplicate`, needs `wikis:write`.
+     */
+    duplicateWiki(args: {
+        path: PluginApiOperations["duplicate_wiki"]["path"];
+        body?: PluginApiOperations["duplicate_wiki"]["body"];
+    }): Promise<PluginApiOperations["duplicate_wiki"]["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`, `documents:read`, `galleries:read`, `posts:read`, `projects:read`, `queues:read`, `tags:read`, `wikis:read`.
+     */
+    suggestCommunity(args: {
+        query: PluginApiOperations["suggest_community"]["query"];
+    }): Promise<PluginApiOperations["suggest_community"]["answer"]>;
+    /**
+     * List property definitions.
+     *
+     * `GET /property-definitions/`, needs `initiatives:read`.
+     */
+    listPropertyDefinitions(args?: {
+        query?: PluginApiOperations["list_property_definitions"]["query"];
+    }): Promise<PluginApiOperations["list_property_definitions"]["answer"]>;
+    /**
+     * Replace the custom property values on one tool or sub-tool.
+     *
+     * `PUT /properties/{target}/{entity_id}`, needs the scope its `target` names.
+     */
+    setProperties(args: {
+        path: PluginApiOperations["set_properties"]["path"];
+        body: PluginApiOperations["set_properties"]["body"];
+    }): Promise<PluginApiOperations["set_properties"]["answer"]>;
+    /**
+     * Mark a thing finished with, and everything inside it. Idempotent: an
+     * already-archived row keeps the stamp it has, so the date means when it was
+     * archived, not when it was last asked about.
+     *
+     * `POST /archive/{entity_type}/{entity_id}`, needs the scope its `entity_type` names.
+     */
+    archiveEntity(args: {
+        path: PluginApiOperations["archive_entity"]["path"];
+    }): Promise<PluginApiOperations["archive_entity"]["answer"]>;
+    /**
+     * Slim, searchable, paginated roster for typeahead/pickers.
+     *
+     * `GET /users/search`, needs `members:read`.
+     */
+    searchUsers(args?: {
+        query?: PluginApiOperations["search_users"]["query"];
+    }): Promise<PluginApiOperations["search_users"]["answer"]>;
+    /**
+     * Serve the picture a member of this community uploaded.
+     *
+     * `GET /members/{person}/avatar/{digest}`, needs `members:read`.
+     */
+    readMemberAvatar(args: {
+        path: PluginApiOperations["read_member_avatar"]["path"];
+    }): Promise<PluginApiOperations["read_member_avatar"]["answer"]>;
+}