initiative-plugin-sdk 4.2.0 → 6.0.0

package/dist/contract.d.ts

@@ -8,7 +8,7 @@
  * from, and the shape of every object it defines, so this package's types
  * cannot describe a manifest the schema refuses, nor miss a term it allows.
  */
-export type Feature = "dashboards" | "embeds" | "endpoints" | "widgets";
+export type Feature = "actions" | "dashboards" | "endpoints" | "fields" | "pages" | "parts" | "widgets";
 export declare const FEATURES: readonly Feature[];
 export type Protocol = 1;
 export declare const PROTOCOLS: readonly Protocol[];
@@ -46,8 +46,14 @@ export type Scope = "projects:read" | "projects:write" | "files:read" | "files:w
 export declare const SCOPES: readonly Scope[];
 export type SurfaceScope = "community" | "initiative";
 export declare const SURFACE_SCOPES: readonly SurfaceScope[];
-export type EmbedCapability = "camera" | "clipboard-read" | "clipboard-write" | "display-capture" | "fullscreen" | "geolocation" | "microphone";
-export declare const EMBED_CAPABILITIES: readonly EmbedCapability[];
+export type PageCapability = "camera" | "clipboard-read" | "clipboard-write" | "display-capture" | "fullscreen" | "geolocation" | "microphone";
+export declare const PAGE_CAPABILITIES: readonly PageCapability[];
+export type ItemKind = "task" | "calendar_event" | "queue_item" | "counter" | "gallery_image" | "post";
+export declare const ITEM_KINDS: readonly ItemKind[];
+export type FieldKind = "text" | "number" | "date" | "datetime" | "link" | "badge" | "progress" | "checkbox";
+export declare const FIELD_KINDS: readonly FieldKind[];
+export type Tone = "accent" | "positive" | "negative" | "warning" | "neutral" | "muted";
+export declare const TONES: readonly Tone[];
 export type ListingKind = "plugin" | "dashboard";
 export declare const LISTING_KINDS: readonly ListingKind[];
 export type HttpMethod = "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
@@ -78,8 +84,21 @@ export declare const CAPS: {
     readonly endpoints: 64;
     readonly paramsPerEndpoint: 12;
     readonly returnsPerEndpoint: 24;
-    readonly embeds: 12;
-    readonly embedCapabilities: 8;
+    readonly pages: 12;
+    readonly pageCapabilities: 8;
+    readonly fields: 32;
+    readonly parts: 16;
+    readonly actions: 16;
+    readonly partNodes: 50;
+    readonly partDepth: 4;
+    readonly metadataKeyLength: 64;
+    readonly metadataValueBytes: 8192;
+    readonly metadataLookupLength: 255;
+    readonly metadataKeysPerObject: 32;
+    readonly metadataBytesPerObject: 65536;
+    readonly installMetadataKeys: 256;
+    readonly installMetadataBytes: 1048576;
+    readonly partsPlacedPerItem: 3;
     readonly bundledDashboards: 8;
     readonly dashboardWidgets: 50;
     readonly dashboardGridColumns: 12;
@@ -116,7 +135,7 @@ export declare const CAPS: {
     readonly hosts: 8;
     readonly hostLength: 253;
     readonly steps: 3;
-    readonly pages: 10;
+    readonly maxPages: 10;
     readonly perPage: 100;
     readonly requestQuery: 24;
     readonly requestHeaders: 12;
@@ -147,6 +166,7 @@ export declare const CHARSETS: {
     readonly version: "0123456789.-+abcdefghijklmnopqrstuvwxyz";
     readonly artwork: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/._-";
     readonly queryName: "-.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ[]_abcdefghijklmnopqrstuvwxyz~";
+    readonly metadataKey: "._0123456789abcdefghijklmnopqrstuvwxyz";
 };
 /**
  * Every field the contract declares, by the object that owns it.
@@ -173,7 +193,16 @@ export declare const FIELDS: {
     readonly schedule: readonly ["id", "every"];
     readonly endpoint: readonly ["id", "label", "description", "returns", "group", "needs_subject", "direction", "params", "actors", "admin_only", "public", "requires", "cache_ttl_seconds", "identity", "unavailable", "request", "steps", "map", "errors"];
     readonly widget: readonly ["id", "meta", "module_source", "endpoints", "sample_data", "requires"];
-    readonly embed: readonly ["id", "path", "name", "scopes", "admin_only", "capabilities", "requires"];
+    readonly page: readonly ["id", "path", "name", "scopes", "admin_only", "capabilities", "requires"];
+    readonly field: readonly ["key", "name", "kind", "on", "description", "tone", "requires"];
+    readonly sectionNode: readonly ["type", "props", "children"];
+    readonly stackNode: readonly ["type", "props", "children"];
+    readonly fieldNode: readonly ["type", "props"];
+    readonly valueNode: readonly ["type", "props"];
+    readonly textNode: readonly ["type", "props"];
+    readonly buttonNode: readonly ["type", "props"];
+    readonly part: readonly ["id", "name", "on", "tree", "description", "requires"];
+    readonly action: readonly ["id", "name", "endpoint", "on", "confirm", "menu", "requires"];
     readonly bundledDashboard: readonly ["uid", "public_id", "name", "description", "layout", "widgets"];
     readonly bundledDashboardWidget: readonly ["id", "type", "title", "grid", "binding"];
     readonly endpointIdentity: readonly ["kind", "key"];
@@ -190,7 +219,7 @@ export declare const FIELDS: {
     readonly healthState: readonly ["status", "when", "state"];
     readonly webhookEvent: readonly ["when", "emit", "map"];
     readonly webhookStatus: readonly ["when", "connection", "state"];
-    readonly manifest: readonly ["plugin_kind", "service", "features", "default_name", "minimum_age", "min_plugin_api", "hosts", "auth", "vendor", "connections", "webhooks", "schedules", "endpoints", "community_summary", "widgets", "embeds", "dashboards"];
+    readonly manifest: readonly ["plugin_kind", "service", "features", "default_name", "minimum_age", "min_plugin_api", "hosts", "auth", "vendor", "connections", "webhooks", "schedules", "endpoints", "community_summary", "widgets", "pages", "dashboards", "fields", "parts", "actions"];
 };
 export type Identifier = string;
 /**
@@ -791,26 +820,232 @@ export interface Widget {
     sample_data?: Record<string, unknown>;
     requires?: Requires;
 }
-export interface Embed {
+export interface Page {
     id: Identifier;
     path: Path;
     name: LocalizedText;
     /**
-     * Where the surface renders. Declaring both gives it a community-wide entry
-     * and an entry inside each initiative.
+     * Where the page renders. Declaring both gives it a community-wide entry and
+     * an entry inside each initiative.
      */
     scopes?: SurfaceScope[];
     /**
-     * Only the community's admins open this surface, whatever roles a placement
-     * allows — a settings page, say. Who else may open a surface is chosen in the
+     * Only the community's admins open this page, whatever roles a placement
+     * allows — a settings page, say. Who else may open a page is chosen in the
      * community, per initiative and per role, not declared here.
      */
     admin_only?: boolean;
     /**
-     * Browser features the frame is granted. A surface that names nothing is
-     * framed with all of them denied.
+     * Browser features the frame is granted. A page that names nothing is framed
+     * with all of them denied.
      */
-    capabilities?: EmbedCapability[];
+    capabilities?: PageCapability[];
+    requires?: Requires;
+}
+/**
+ * A key the plug-in keeps a value under, on an item or on its own install: a
+ * lowercase letter, then lowercase letters, digits, '_' and '.'.
+ */
+export type MetadataKey = string;
+/**
+ * How one of the plug-in's metadata keys is shown on Initiative's items. The
+ * plug-in keeps the value in Initiative, through its installation token;
+ * Initiative draws it with its own component for `kind` and computes its plain
+ * text itself, so a field filters, sorts and exports with no call to the
+ * plug-in. Which views show it is chosen by the community's managers, never by
+ * the plug-in. Initiative holds what is kept, and these caps are enforced there
+ * rather than here: a value of at most 8192 bytes as JSON, with a string of at
+ * most 255 characters to be found by; at most 32 keys and 65536 bytes on one
+ * item, and 256 keys and 1048576 bytes on the install.
+ */
+export interface Field {
+    /**
+     * The metadata key whose value this shows. Unique among this manifest's
+     * fields.
+     */
+    key: MetadataKey;
+    /**
+     * The field's label.
+     */
+    name: LocalizedText;
+    /**
+     * What the value is, and so how it is drawn: 'text' a string; 'number' a
+     * number; 'date' a 'YYYY-MM-DD' string; 'datetime' an ISO 8601 string with
+     * its offset; 'link' {url, text?}; 'badge' {text, tone?}; 'progress' {value,
+     * max}; 'checkbox' a boolean.
+     */
+    kind: FieldKind;
+    /**
+     * The item kinds it is offered on.
+     */
+    on: ItemKind[];
+    /**
+     * The one line the view editor's Add picker shows beside the name.
+     */
+    description?: LocalizedText;
+    /**
+     * A badge's tone when its value names none.
+     */
+    tone?: Tone;
+    requires?: Requires;
+}
+/**
+ * One node of a part: one of Initiative's own components, told apart by 'type',
+ * with its props and, for a section or a stack, the nodes inside it.
+ */
+export type PartNode = SectionNode | StackNode | FieldNode | ValueNode | TextNode | ButtonNode;
+/**
+ * A titled group, which the reader may fold.
+ */
+export interface SectionNode {
+    type: "section";
+    props?: {
+        title?: LocalizedText;
+        /**
+         * Drawn folded until the reader opens it.
+         */
+        collapsed?: boolean;
+    };
+    /**
+     * Drawn in order, inside this one.
+     */
+    children?: PartNode[];
+}
+/**
+ * Nodes side by side or one above another.
+ */
+export interface StackNode {
+    type: "stack";
+    props?: {
+        direction?: "row" | "column";
+        /**
+         * The space between the nodes. Absent: Initiative's own.
+         */
+        gap?: "none" | "small" | "medium" | "large";
+        /**
+         * A row runs onto a second line rather than past its edge.
+         */
+        wrap?: boolean;
+    };
+    /**
+     * Drawn in order, inside this one.
+     */
+    children?: PartNode[];
+}
+/**
+ * A field's label and its value.
+ */
+export interface FieldNode {
+    type: "field";
+    props: {
+        /**
+         * One of this manifest's fields, by its key, offered on every item kind the
+         * part is.
+         */
+        field: MetadataKey;
+    };
+}
+/**
+ * A field's value alone.
+ */
+export interface ValueNode {
+    type: "value";
+    props: {
+        /**
+         * One of this manifest's fields, by its key, offered on every item kind the
+         * part is.
+         */
+        field: MetadataKey;
+    };
+}
+/**
+ * Words the plug-in wrote.
+ */
+export interface TextNode {
+    type: "text";
+    props: {
+        text: LocalizedText;
+        tone?: Tone;
+    };
+}
+/**
+ * A button that runs one of this plug-in's actions on the item, labelled with
+ * the action's name.
+ */
+export interface ButtonNode {
+    type: "button";
+    props: {
+        /**
+         * One of this manifest's actions, by its id, offered on every item kind the
+         * part is.
+         */
+        action: Identifier;
+        variant?: "primary" | "secondary" | "ghost";
+    };
+}
+/**
+ * A piece of an item's page or view, built from Initiative's own components and
+ * bound to this plug-in's fields and actions. Data only: Initiative draws each
+ * node, and no plug-in code runs in the reader's browser. Which views show it
+ * is chosen by the community's managers, never by the plug-in, and Initiative
+ * places at most 3 of a plug-in's parts on one item.
+ */
+export interface Part {
+    /**
+     * Unique among this manifest's parts.
+     */
+    id: Identifier;
+    /**
+     * What the view editor calls it.
+     */
+    name: LocalizedText;
+    /**
+     * The item kinds it is offered on.
+     */
+    on: ItemKind[];
+    /**
+     * What is drawn: at most 50 nodes, at most 4 deep.
+     */
+    tree: PartNode;
+    /**
+     * The one line the view editor's Add picker shows beside the name.
+     */
+    description?: LocalizedText;
+    requires?: Requires;
+}
+/**
+ * Something a reader runs on one item, from a part's button or the item's own
+ * menu. Initiative only connects: it calls the write endpoint as the
+ * installation, with the reader as 'viewer' and the item as 'subject' in the
+ * call's token, and the endpoint does the work, usually writing the plug-in's
+ * metadata. Initiative then answers the reader with the item's metadata as it
+ * stands.
+ */
+export interface Action {
+    /**
+     * Unique among this manifest's actions.
+     */
+    id: Identifier;
+    /**
+     * The button's or the menu entry's label.
+     */
+    name: LocalizedText;
+    /**
+     * A write endpoint this manifest declares.
+     */
+    endpoint: NamespacedId;
+    /**
+     * The item kinds it is offered on.
+     */
+    on: ItemKind[];
+    /**
+     * A question Initiative asks before running it. Absent: it runs at once.
+     */
+    confirm?: LocalizedText;
+    /**
+     * Also offered in the item's own menu.
+     */
+    menu?: boolean;
     requires?: Requires;
 }
 export interface BundledDashboard {
@@ -1183,8 +1418,10 @@ export interface WebhookStatus {
  * in both directions, UTF-8 byte-size caps, the rules tying a connection's flow
  * and token to its scope and fields, what a webhooks block names, what a vendor
  * setup writes to, whether every expression parses, what a declarative request
- * and its steps name, and the bounds and unique ids of schedules are enforced
- * by the platform on publish and are not expressible here.
+ * and its steps name, the bounds and unique ids of schedules, the unique keys
+ * and ids of fields, parts and actions, what a part's nodes and an action name,
+ * and a part's size and depth are enforced by the platform on publish and are
+ * not expressible here.
  */
 export interface Manifest {
     /**
@@ -1270,11 +1507,29 @@ export interface Manifest {
      */
     community_summary?: NamespacedId;
     widgets?: Widget[];
-    embeds?: Embed[];
+    pages?: Page[];
     /**
      * Ready-made arrangements of this plug-in's own widgets. Publishing the
      * plug-in publishes one ordinary dashboard listing per entry, offered to
      * communities that install the plug-in.
      */
     dashboards?: BundledDashboard[];
+    /**
+     * How the plug-in's metadata is shown on items. A container plug-in's only: a
+     * declarative plug-in holds no installation token, so it keeps no metadata to
+     * show.
+     */
+    fields?: Field[];
+    /**
+     * Pieces of items' pages and views, built from Initiative's components and
+     * bound to the plug-in's fields and actions. A container plug-in's only, as
+     * fields are.
+     */
+    parts?: Part[];
+    /**
+     * What a reader may run on an item, each one of the plug-in's write
+     * endpoints. A container plug-in's only: a declarative plug-in has no handler
+     * to do an action's work.
+     */
+    actions?: Action[];
 }

package/dist/contract.js

@@ -8,7 +8,7 @@
  * from, and the shape of every object it defines, so this package's types
  * cannot describe a manifest the schema refuses, nor miss a term it allows.
  */
-export const FEATURES = ["dashboards", "embeds", "endpoints", "widgets"];
+export const FEATURES = ["actions", "dashboards", "endpoints", "fields", "pages", "parts", "widgets"];
 export const PROTOCOLS = [1];
 export const CONNECTION_SCOPES = ["interactive", "static"];
 export const FLOW_TYPES = ["oauth2"];
@@ -27,7 +27,10 @@ export const DIRECTIONS = ["emit", "read", "write"];
 export const ACTOR_KINDS = ["installation", "member"];
 export const SCOPES = ["projects:read", "projects:write", "files:read", "files:write", "queues:read", "queues:write", "counter_groups:read", "counter_groups:write", "calendars:read", "calendars:write", "dashboards:read", "dashboards:write", "posts:read", "posts:write", "galleries:read", "galleries:write", "wikis:read", "wikis:write", "comments:read", "comments:write", "relationships:read", "relationships:write", "tags:read", "tags:write", "properties:read", "properties:write", "sharing:read", "sharing:write", "members:read", "initiatives:read", "initiatives:moderate", "community:admin"];
 export const SURFACE_SCOPES = ["community", "initiative"];
-export const EMBED_CAPABILITIES = ["camera", "clipboard-read", "clipboard-write", "display-capture", "fullscreen", "geolocation", "microphone"];
+export const PAGE_CAPABILITIES = ["camera", "clipboard-read", "clipboard-write", "display-capture", "fullscreen", "geolocation", "microphone"];
+export const ITEM_KINDS = ["task", "calendar_event", "queue_item", "counter", "gallery_image", "post"];
+export const FIELD_KINDS = ["text", "number", "date", "datetime", "link", "badge", "progress", "checkbox"];
+export const TONES = ["accent", "positive", "negative", "warning", "neutral", "muted"];
 export const LISTING_KINDS = ["plugin", "dashboard"];
 export const HTTP_METHODS = ["DELETE", "GET", "PATCH", "POST", "PUT"];
 export const PAGE_LIMITS = ["refuse", "truncate"];
@@ -52,8 +55,21 @@ export const CAPS = {
     endpoints: 64,
     paramsPerEndpoint: 12,
     returnsPerEndpoint: 24,
-    embeds: 12,
-    embedCapabilities: 8,
+    pages: 12,
+    pageCapabilities: 8,
+    fields: 32,
+    parts: 16,
+    actions: 16,
+    partNodes: 50,
+    partDepth: 4,
+    metadataKeyLength: 64,
+    metadataValueBytes: 8192,
+    metadataLookupLength: 255,
+    metadataKeysPerObject: 32,
+    metadataBytesPerObject: 65536,
+    installMetadataKeys: 256,
+    installMetadataBytes: 1048576,
+    partsPlacedPerItem: 3,
     bundledDashboards: 8,
     dashboardWidgets: 50,
     dashboardGridColumns: 12,
@@ -90,7 +106,7 @@ export const CAPS = {
     hosts: 8,
     hostLength: 253,
     steps: 3,
-    pages: 10,
+    maxPages: 10,
     perPage: 100,
     requestQuery: 24,
     requestHeaders: 12,
@@ -121,6 +137,7 @@ export const CHARSETS = {
     version: "0123456789.-+abcdefghijklmnopqrstuvwxyz",
     artwork: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/._-",
     queryName: "-.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ[]_abcdefghijklmnopqrstuvwxyz~",
+    metadataKey: "._0123456789abcdefghijklmnopqrstuvwxyz",
 };
 /**
  * Every field the contract declares, by the object that owns it.
@@ -147,7 +164,16 @@ export const FIELDS = {
     schedule: ["id", "every"],
     endpoint: ["id", "label", "description", "returns", "group", "needs_subject", "direction", "params", "actors", "admin_only", "public", "requires", "cache_ttl_seconds", "identity", "unavailable", "request", "steps", "map", "errors"],
     widget: ["id", "meta", "module_source", "endpoints", "sample_data", "requires"],
-    embed: ["id", "path", "name", "scopes", "admin_only", "capabilities", "requires"],
+    page: ["id", "path", "name", "scopes", "admin_only", "capabilities", "requires"],
+    field: ["key", "name", "kind", "on", "description", "tone", "requires"],
+    sectionNode: ["type", "props", "children"],
+    stackNode: ["type", "props", "children"],
+    fieldNode: ["type", "props"],
+    valueNode: ["type", "props"],
+    textNode: ["type", "props"],
+    buttonNode: ["type", "props"],
+    part: ["id", "name", "on", "tree", "description", "requires"],
+    action: ["id", "name", "endpoint", "on", "confirm", "menu", "requires"],
     bundledDashboard: ["uid", "public_id", "name", "description", "layout", "widgets"],
     bundledDashboardWidget: ["id", "type", "title", "grid", "binding"],
     endpointIdentity: ["kind", "key"],
@@ -164,6 +190,6 @@ export const FIELDS = {
     healthState: ["status", "when", "state"],
     webhookEvent: ["when", "emit", "map"],
     webhookStatus: ["when", "connection", "state"],
-    manifest: ["plugin_kind", "service", "features", "default_name", "minimum_age", "min_plugin_api", "hosts", "auth", "vendor", "connections", "webhooks", "schedules", "endpoints", "community_summary", "widgets", "embeds", "dashboards"],
+    manifest: ["plugin_kind", "service", "features", "default_name", "minimum_age", "min_plugin_api", "hosts", "auth", "vendor", "connections", "webhooks", "schedules", "endpoints", "community_summary", "widgets", "pages", "dashboards", "fields", "parts", "actions"],
 };
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAG1H,MAAM,CAAC,MAAM,SAAS,GAAwB,CAAC,CAAC,CAAC,CAAC;AAGlD,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AAGvF,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,QAAQ,CAAC,CAAC;AAG1D,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,YAAY,CAAC,CAAC;AAGhE,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAG3F,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAG1E,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAGtG,MAAM,CAAC,MAAM,kBAAkB,GAA+B,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAG1F,MAAM,CAAC,MAAM,wBAAwB,GAAqC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAG5F,MAAM,CAAC,MAAM,iBAAiB,GAA8B,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAGlI,MAAM,CAAC,MAAM,eAAe,GAA6B,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAGtF,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAG/E,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAGxG,MAAM,CAAC,MAAM,kBAAkB,GAA+B,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAG3G,MAAM,CAAC,MAAM,UAAU,GAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAG1E,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAG5E,MAAM,CAAC,MAAM,MAAM,GAAqB,CAAC,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;AAGpmB,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAGnF,MAAM,CAAC,MAAM,iBAAiB,GAA8B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;AAG1K,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;AAG5H,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAGjI,MAAM,CAAC,MAAM,KAAK,GAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAGxG,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAG7E,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAG7F,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAGxE,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAGlF,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AAG3G,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAEvI,0EAA0E;AAC1E,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,WAAW,EAAE,EAAE;IACf,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,oBAAoB,EAAE,GAAG;IACzB,eAAe,EAAE,GAAG;IACpB,UAAU,EAAE,EAAE;IACd,eAAe,EAAE,EAAE;IACnB,oBAAoB,EAAE,GAAG;IACzB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,CAAC;IAClB,SAAS,EAAE,EAAE;IACb,iBAAiB,EAAE,EAAE;IACrB,kBAAkB,EAAE,EAAE;IACtB,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,CAAC;IACnB,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC;IACZ,iBAAiB,EAAE,EAAE;IACrB,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,GAAG;IACzB,qBAAqB,EAAE,EAAE;IACzB,sBAAsB,EAAE,KAAK;IAC7B,mBAAmB,EAAE,GAAG;IACxB,oBAAoB,EAAE,OAAO;IAC7B,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,EAAE;IACpB,oBAAoB,EAAE,EAAE;IACxB,sBAAsB,EAAE,EAAE;IAC1B,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,GAAG;IACnB,UAAU,EAAE,GAAG;IACf,gBAAgB,EAAE,GAAG;IACrB,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,GAAG;IACf,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,IAAI;IACtB,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,GAAG;IACf,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,KAAK;IACxB,eAAe,EAAE,KAAK;IACtB,sBAAsB,EAAE,MAAM;IAC9B,aAAa,EAAE,EAAE;IACjB,mBAAmB,EAAE,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,eAAe,EAAE,EAAE;IACnB,uBAAuB,EAAE,GAAG;IAC5B,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;IACnB,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,EAAE;IAChB,SAAS,EAAE,CAAC;IACZ,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,CAAC;IACtB,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,GAAG;IACZ,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,EAAE;IAClB,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,GAAG;IACf,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;IACpB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,GAAG;IACpB,qBAAqB,EAAE,OAAO;IAC9B,iBAAiB,EAAE,EAAE;IACrB,eAAe,EAAE,EAAE;CACX,CAAC;AAEX,uDAAuD;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,UAAU,EAAE,wCAAwC;IACpD,YAAY,EAAE,yCAAyC;IACvD,QAAQ,EAAE,yCAAyC;IACnD,GAAG,EAAE,kCAAkC;IACvC,IAAI,EAAE,oEAAoE;IAC1E,UAAU,EAAE,iEAAiE;IAC7E,SAAS,EAAE,mEAAmE;IAC9E,SAAS,EAAE,uDAAuD;IAClE,OAAO,EAAE,yCAAyC;IAClD,OAAO,EAAE,oEAAoE;IAC7E,SAAS,EAAE,sEAAsE;IACjF,WAAW,EAAE,wCAAwC;CAC7C,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC9B,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC7B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;IAC3E,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;IACpC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC;IACjD,sBAAsB,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;IACjD,iBAAiB,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,gBAAgB,CAAC;IACrF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC;IACtF,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC;IACtD,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC;IACxF,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,CAAC;IAClL,eAAe,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC;IAC1E,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC1D,aAAa,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;IACnE,YAAY,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC;IACvO,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,CAAC;IAC/E,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,CAAC;IAChF,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC;IACvE,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC;IAC1C,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC;IACxC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;IACvE,gBAAgB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC;IAClF,sBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;IAClE,gBAAgB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IACjC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAChC,aAAa,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC;IAC/F,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IACtC,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IAChC,gBAAgB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;IACxG,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;IAC5D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;IAC7F,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;IACrC,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC;IAChE,gBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC;IAChD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;IACxC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;IACrC,aAAa,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC;IAC9C,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;CAC9P,CAAC"}

package/dist/define.d.ts

@@ -2,7 +2,7 @@
  * One typed definition of a plug-in.
  *
  * {@link definePlugin} takes everything a plug-in declares and does: its endpoints
- * with their handlers, its hooks and schedules, its widgets and surfaces, and
+ * with their handlers, its hooks and schedules, its widgets and pages, and
  * its listing. The same object routes Initiative's calls (`createPlugin`) and
  * becomes the manifest (`initiative-plugin build`), so nothing is stated twice.
  *
@@ -17,10 +17,10 @@
  *
  * Endpoints are named by their key. The manifest id is `plugin.<publicId>.<key>`,
  * and everywhere a definition refers to an endpoint (a widget, a sample, a
- * parameter's `options_from`, a bundled dashboard, `communitySummary`) it uses the
- * key.
+ * parameter's `options_from`, a bundled dashboard, `communitySummary`, an
+ * action) it uses the key.
  */
-import type { ActorKind, PluginScope, BundledDashboard, BundledDashboardWidget, Connection, Embed, Endpoint, EndpointParam, EndpointReturn, ErrorRule, Expression, Manifest, RequestStep, ReturnValueType, Scope, Vendor, VendorAuth, VendorRequest, WebhookEvent, Webhooks, Widget } from "./contract.js";
+import type { Action, ActorKind, PluginScope, BundledDashboard, BundledDashboardWidget, Connection, Page, Endpoint, EndpointParam, EndpointReturn, ErrorRule, Expression, Field, ItemKind, Manifest, Part, RequestStep, ReturnValueType, Scope, Vendor, VendorAuth, VendorRequest, WebhookEvent, Webhooks, Widget } from "./contract.js";
 import type { Client } from "./client.js";
 /**
  * What every handler is handed as `context`: the value given to `createPlugin`.
@@ -72,6 +72,11 @@ export type Actor = {
     kind: "member";
     member: string;
 };
+/** One of Initiative's items, by its kind and id. */
+export interface ItemRef {
+    type: ItemKind;
+    id: number;
+}
 /** What every handler is handed. */
 export interface Call {
     /** The installation: the community, by the reference this plug-in's install knows it by. */
@@ -92,6 +97,10 @@ export interface EndpointCall<P> extends Call {
     initiative: number | null;
     /** Connection id → the handle Initiative gives a token for, where the call depends on one. */
     connections: Record<string, string>;
+    /** On a call one of the plug-in's actions made: the reader who ran it, by this installation's reference for them. */
+    viewer: string | null;
+    /** On a call one of the plug-in's actions made: the item it was run on. */
+    subject: ItemRef | null;
 }
 /** What a handler answers with. `actor` says whose credential ran it; absent, the call's actor. */
 export interface Outcome<R> {
@@ -184,17 +193,17 @@ export interface ScheduleDeclaration {
     every: `${number}${"m" | "h"}`;
     run: (call: ScheduleCall) => Promise<void>;
 }
-/** A member opening one of the plug-in's surfaces, as the handoff token names them. */
+/** A member opening one of the plug-in's pages, as the handoff token names them. */
 export interface Handoff extends Call {
-    surface: string;
+    page: string;
     /** The member, by this installation's reference for them. */
     viewer: string;
     /** Whether the viewer administers the community. For shaping screens; not a grant. */
     admin: boolean;
-    /** The initiative the surface was opened in, or null for the whole community. */
+    /** The initiative the page was opened in, or null for the whole community. */
     initiative: number | null;
 }
-export interface SurfaceCall {
+export interface PageCall {
     request: Request;
     /** Null for a request that carries no handoff token, such as the page's own files. */
     handoff: Handoff | null;
@@ -204,14 +213,19 @@ export interface SurfaceCall {
  * request under its path that carries a handoff token reaches the handler with
  * the handoff verified.
  */
-export interface SurfaceDeclaration extends Omit<Embed, "id"> {
-    handler?: (call: SurfaceCall) => Promise<Response>;
+export interface PageDeclaration extends Omit<Page, "id"> {
+    handler?: (call: PageCall) => Promise<Response>;
 }
 type ReadName<E> = {
     [K in keyof E]: E[K] extends {
         direction: "read";
     } ? K : never;
 }[keyof E] & string;
+type WriteName<E> = {
+    [K in keyof E]: E[K] extends {
+        direction: "write";
+    } ? K : never;
+}[keyof E] & string;
 type EmitName<E> = {
     [K in keyof E]: E[K] extends {
         direction: "emit";
@@ -240,6 +254,10 @@ export interface WidgetDeclaration<E> extends Omit<Widget, "id" | "module_source
         [K in ReadName<E>]?: Result<ReturnsOf<E[K]>>;
     };
 }
+/** Something a reader runs on one item. `endpoint` names a write endpoint by its key. */
+export interface ActionDeclaration<E> extends Omit<Action, "id" | "endpoint"> {
+    endpoint: WriteName<E>;
+}
 export interface DashboardDeclaration<E, W> extends Omit<BundledDashboard, "widgets"> {
     widgets: Array<Omit<BundledDashboardWidget, "type" | "binding"> & {
         type: keyof W & string;
@@ -320,9 +338,15 @@ export interface PluginDefinition<E, W> {
     communitySummary?: ReadName<E>;
     hooks?: Hooks;
     widgets?: W;
-    /** Pages and panels, keyed by surface id. */
-    surfaces?: Record<string, SurfaceDeclaration>;
+    /** Pages and panels, keyed by page id. */
+    pages?: Record<string, PageDeclaration>;
     dashboards?: DashboardDeclaration<E, W>[];
+    /** How the plug-in's metadata is shown on items, keyed by metadata key. */
+    fields?: Record<string, Omit<Field, "key">>;
+    /** Pieces of items' pages and views, keyed by part id. A `tree` may be written as JSX (`initiative-plugin-sdk/parts`). */
+    parts?: Record<string, Omit<Part, "id">>;
+    /** What a reader may run on an item, keyed by action id. */
+    actions?: Record<string, ActionDeclaration<E>>;
     listing?: ListingDeclaration;
 }
 /** Any plug-in's definition, as the server and the build read it. */

package/dist/define.js

@@ -2,7 +2,7 @@
  * One typed definition of a plug-in.
  *
  * {@link definePlugin} takes everything a plug-in declares and does: its endpoints
- * with their handlers, its hooks and schedules, its widgets and surfaces, and
+ * with their handlers, its hooks and schedules, its widgets and pages, and
  * its listing. The same object routes Initiative's calls (`createPlugin`) and
  * becomes the manifest (`initiative-plugin build`), so nothing is stated twice.
  *
@@ -17,8 +17,8 @@
  *
  * Endpoints are named by their key. The manifest id is `plugin.<publicId>.<key>`,
  * and everywhere a definition refers to an endpoint (a widget, a sample, a
- * parameter's `options_from`, a bundled dashboard, `communitySummary`) it uses the
- * key.
+ * parameter's `options_from`, a bundled dashboard, `communitySummary`, an
+ * action) it uses the key.
  */
 import { FEATURES } from "./contract.js";
 export function defineEndpoint(endpoint) {
@@ -51,9 +51,9 @@ export function manifestOf(plugin, modules = {}) {
         endpoints: listOf(plugin.endpoints, (key, endpoint) => endpointOf(id(key), endpoint, id)),
         community_summary: plugin.communitySummary === undefined ? undefined : id(plugin.communitySummary),
         widgets: listOf(plugin.widgets, (key, widget) => widgetOf(key, widget, modules[key] ?? "", id)),
-        embeds: listOf(plugin.surfaces, (key, surface) => {
-            const { handler: _handler, ...embed } = surface;
-            return { id: key, ...embed };
+        pages: listOf(plugin.pages, (key, page) => {
+            const { handler: _handler, ...declared } = page;
+            return { id: key, ...declared };
         }),
         dashboards: plugin.dashboards?.map((dashboard) => ({
             ...dashboard,
@@ -62,6 +62,9 @@ export function manifestOf(plugin, modules = {}) {
                 binding: { ...widget.binding, endpoint_id: id(widget.binding.endpoint_id) },
             })),
         })),
+        fields: listOf(plugin.fields, (key, field) => ({ key, ...field })),
+        parts: listOf(plugin.parts, (key, part) => ({ id: key, ...part })),
+        actions: listOf(plugin.actions, (key, action) => ({ id: key, ...action, endpoint: id(action.endpoint) })),
     };
     const present = Object.fromEntries(Object.entries(blocks).filter(([, value]) => value !== undefined));
     return {