@inneropen/marvin-sdk 4.2.0 → 4.4.0

package/dist/platform.cjs

@@ -39,6 +39,7 @@ __export(platform_exports, {
   AssetsModule: () => AssetsModule,
   AuthModule: () => AuthModule,
   AutomationsModule: () => AutomationsModule,
+  BlueprintsModule: () => BlueprintsModule,
   CollectionsModule: () => CollectionsModule,
   EmailEventSubscriptionsModule: () => EmailEventSubscriptionsModule,
   EmailTemplatesClient: () => EmailTemplatesClient,
@@ -403,6 +404,9 @@ var HttpClient = class _HttpClient {
         errorText
       );
     }
+    if (options?.responseType === "binary") {
+      return await this.readBinary(response, method, endpoint);
+    }
     const data = await this.readBody(response, method, endpoint);
     if (this.debug && data !== void 0) {
       const sanitized = this.sanitizeForLogging(data);
@@ -448,12 +452,34 @@ var HttpClient = class _HttpClient {
       );
     }
   }
+  /** A successful response's bytes; a 204/205 is an empty array. A failed read is a network error. */
+  async readBinary(response, method, endpoint) {
+    const contentType = response.headers.get("content-type");
+    if (response.status === 204 || response.status === 205) {
+      return { data: new Uint8Array(0), contentType };
+    }
+    try {
+      return { data: new Uint8Array(await response.arrayBuffer()), contentType };
+    } catch (error) {
+      const cause = error instanceof Error ? error : void 0;
+      throw new MarvinNetworkError(
+        `Reading the ${response.status} response to ${method} ${endpoint} failed: ${cause?.message ?? String(error)}`,
+        cause
+      );
+    }
+  }
   /**
    * GET request
    */
   async get(endpoint, params) {
     return this.request("GET", endpoint, { params });
   }
+  /**
+   * GET a binary body (a file download). Follows redirects; retried like any GET.
+   */
+  async getBinary(endpoint, params) {
+    return this.request("GET", endpoint, { params, responseType: "binary" });
+  }
   /**
    * POST request
    */
@@ -534,6 +560,12 @@ var EntriesModule = class {
   async list() {
     return this.http.get("/api/platform/entries");
   }
+  /**
+   * Entry counts by status, zero-filled, plus `total` (what the sidebar's inbox badge reads).
+   */
+  async counts() {
+    return this.http.get("/api/platform/entries/counts");
+  }
   /**
    * Get a single entry by ID
    */
@@ -587,6 +619,38 @@ var EntriesModule = class {
     const validCollectionId = this.http.validatePathParam(collectionId, "collection ID");
     return this.http.delete(`/api/platform/entries/${validEntryId}/collections/${validCollectionId}`);
   }
+  /**
+   * Apply the entry's staged AI suggestion (`suggestionJson`) and clear it — the approval half of
+   * AI write-back. Returns the updated entry.
+   */
+  async applySuggestion(id) {
+    const validId = this.http.validatePathParam(id, "entry ID");
+    return this.http.post(`/api/platform/entries/${validId}/apply-suggestion`, {});
+  }
+  /**
+   * Discard the entry's staged AI suggestion without applying it.
+   */
+  async rejectSuggestion(id) {
+    const validId = this.http.validatePathParam(id, "entry ID");
+    return this.http.post(`/api/platform/entries/${validId}/reject-suggestion`, {});
+  }
+  /**
+   * Approve an AI-suggested asset on an entry: it becomes a normal attached asset (and reaches
+   * published output).
+   */
+  async approveSuggestedAsset(entryId, assetId) {
+    const e = this.http.validatePathParam(entryId, "entry ID");
+    const a = this.http.validatePathParam(assetId, "asset ID");
+    return this.http.post(`/api/platform/entries/${e}/suggested-assets/${a}/approve`, {});
+  }
+  /**
+   * Reject an AI-suggested asset: unlink it, and delete the asset if nothing else uses it.
+   */
+  async rejectSuggestedAsset(entryId, assetId) {
+    const e = this.http.validatePathParam(entryId, "entry ID");
+    const a = this.http.validatePathParam(assetId, "asset ID");
+    return this.http.post(`/api/platform/entries/${e}/suggested-assets/${a}/reject`, {});
+  }
 };
 
 // src/platform/collections.ts
@@ -627,6 +691,22 @@ var CollectionsModule = class {
       smartRules: rules
     });
   }
+  /**
+   * Preview unsaved smart-collection rules: how many items they match (`total`) and the first
+   * `limit` of them (default 10, at most 50), evaluated by the same code that materializes
+   * membership on save. Saves nothing. Needs EDITOR.
+   */
+  async preview(request) {
+    return this.http.post("/api/platform/collections/preview", request);
+  }
+  /**
+   * A collection's members, whatever it groups — entries, assets or resources — as
+   * `{id, label, slug, type}`, ordered by label.
+   */
+  async members(id) {
+    const validId = this.http.validatePathParam(id, "collection ID");
+    return this.http.get(`/api/platform/collections/${validId}/members`);
+  }
   /**
    * Update a collection
    */
@@ -800,6 +880,20 @@ var ResourcesModule = class {
   async getEntries(id) {
     return this.http.get(`/api/platform/resources/${id}/entries`);
   }
+  /**
+   * Apply the resource's staged AI suggestion (`suggestionJson`) and clear it. Needs EDITOR.
+   */
+  async applySuggestion(id) {
+    const validId = this.http.validatePathParam(id, "resource ID");
+    return this.http.post(`/api/platform/resources/${validId}/apply-suggestion`, {});
+  }
+  /**
+   * Discard the resource's staged AI suggestion without applying it. Needs EDITOR.
+   */
+  async rejectSuggestion(id) {
+    const validId = this.http.validatePathParam(id, "resource ID");
+    return this.http.post(`/api/platform/resources/${validId}/reject-suggestion`, {});
+  }
 };
 
 // src/platform/assets.ts
@@ -914,11 +1008,19 @@ var AssetsModule = class {
     return this.http.delete(`/api/platform/assets/${validId}`);
   }
   /**
-   * Fetch the raw file for an asset
+   * Download an asset's file: its bytes and content type. A redirect to storage is followed.
    */
-  async getFile(id) {
+  async download(id) {
     const validId = this.http.validatePathParam(id, "asset ID");
-    return this.http.get(`/api/platform/assets/${validId}/file`);
+    return this.http.getBinary(`/api/platform/assets/${validId}/file`);
+  }
+  /**
+   * Fetch the raw file for an asset.
+   * @deprecated Use {@link download}, which is typed. (Before 4.3 this resolved to `undefined` for
+   * any file that wasn't JSON; it now returns the same `BinaryResponse` as `download`.)
+   */
+  async getFile(id) {
+    return this.download(id);
   }
   /**
    * Get download URL for an asset file
@@ -929,6 +1031,20 @@ var AssetsModule = class {
     const base = baseUrl || (typeof window !== "undefined" && window.location ? window.location.origin : "");
     return `${base}/api/platform/assets/${validId}/file`;
   }
+  /**
+   * Apply the asset's staged AI suggestion (`suggestionJson`) and clear it. Needs EDITOR.
+   */
+  async applySuggestion(id) {
+    const validId = this.http.validatePathParam(id, "asset ID");
+    return this.http.post(`/api/platform/assets/${validId}/apply-suggestion`, {});
+  }
+  /**
+   * Discard the asset's staged AI suggestion without applying it. Needs EDITOR.
+   */
+  async rejectSuggestion(id) {
+    const validId = this.http.validatePathParam(id, "asset ID");
+    return this.http.post(`/api/platform/assets/${validId}/reject-suggestion`, {});
+  }
 };
 
 // src/platform/apiClients.ts
@@ -1179,6 +1295,13 @@ var WorkspacesModule = class {
   async getStats() {
     return this.http.get("/api/platform/stats");
   }
+  /**
+   * The current workspace's dashboard: recent activity and the "needs attention" counts (inbox,
+   * drafts, entries needing review, pending AI suggestions, failures in the last 7 days).
+   */
+  async getDashboard() {
+    return this.http.get("/api/platform/stats/dashboard");
+  }
   /**
    * List available workspace backups
    */
@@ -1841,6 +1964,20 @@ var EventsModule = class {
   async getOptions() {
     return this.http.get("/api/event/types");
   }
+  /**
+   * Every workspace event type, in catalog order, with how many things send it and react to it.
+   */
+  async getConnectionsSummary() {
+    return this.http.get("/api/platform/event-types/connections");
+  }
+  /**
+   * What sends an event type and what reacts to it, with its newest `limit` events (default 10, max 50).
+   * Rejects with 404 for an unknown or platform-scope type.
+   */
+  async getConnections(eventType, options = {}) {
+    const path = `/api/platform/event-types/${encodeURIComponent(eventType)}/connections`;
+    return options.limit === void 0 ? this.http.get(path) : this.http.get(path, { limit: options.limit });
+  }
 };
 
 // src/platform/eventLog.ts
@@ -2875,6 +3012,10 @@ var IncomingWebhooksModule = class {
   async list() {
     return this.http.get("/api/incoming-webhooks");
   }
+  /** The signature schemes a webhook can pick (`signatureScheme`). */
+  async signatureSchemes() {
+    return this.http.get("/api/incoming-webhooks/signature-schemes");
+  }
   async get(id) {
     const validId = this.http.validatePathParam(id, "incoming webhook id");
     return this.http.get(`/api/incoming-webhooks/${validId}`);
@@ -2903,6 +3044,59 @@ var IncomingWebhooksModule = class {
   }
 };
 
+// src/platform/blueprints.ts
+var BASE2 = "/api/groups/blueprints";
+var BlueprintsModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  query(options = {}) {
+    return this.http.buildQueryString({ source: options.source, integration_id: options.integrationId });
+  }
+  /** The catalog, annotated with what this workspace can do about each blueprint. */
+  async list(options = {}) {
+    return this.http.get(BASE2, {
+      kind: options.kind,
+      category: options.category,
+      source: options.source,
+      integration_id: options.integrationId
+    });
+  }
+  /** Category names in catalog order: core's first, then each provider's. */
+  async categories() {
+    return this.http.get(`${BASE2}/categories`);
+  }
+  /** One blueprint, including its payload. */
+  async get(slug, options = {}) {
+    const validSlug = this.http.validatePathParam(slug, "blueprint slug");
+    return this.http.get(`${BASE2}/${validSlug}`, { source: options.source });
+  }
+  /**
+   * Create this blueprint's object in the workspace if it isn't there yet. `params` fills the
+   * parameters the blueprint declares, e.g. `{ entry_type: 'post' }`. Needs ADMIN.
+   */
+  async apply(slug, params, options = {}) {
+    const validSlug = this.http.validatePathParam(slug, "blueprint slug");
+    return this.http.post(`${BASE2}/${validSlug}/apply${this.query(options)}`, params);
+  }
+  /**
+   * Apply several blueprints at once; entry types are created before the collections and tasks that
+   * use them, whatever the order here. `params` is keyed by blueprint slug. Needs ADMIN.
+   */
+  async applyMany(slugs, params, options = {}) {
+    return this.http.post(`${BASE2}/apply${this.query(options)}`, {
+      slugs,
+      ...params ? { params } : {}
+    });
+  }
+  /** Replace an applied workflow's steps with what its integration declares now. Needs ADMIN. */
+  async update(slug, params, options = {}) {
+    const validSlug = this.http.validatePathParam(slug, "blueprint slug");
+    return this.http.post(`${BASE2}/${validSlug}/update${this.query(options)}`, params);
+  }
+};
+
 // src/platform/site.ts
 var REBUILD = "/api/platform/site/rebuild";
 var SiteModule = class {
@@ -2969,6 +3163,8 @@ var PlatformClient = class extends HttpClient {
   automations;
   // Incoming (ingress) webhooks — tokened endpoints that drop events on the bus.
   incomingWebhooks;
+  /** Blueprint catalog: browse and apply collections, entry types, tasks and workflows */
+  blueprints;
   // Site — request a rebuild of the workspace's static site and read its status.
   site;
   // Admin modules
@@ -3013,6 +3209,7 @@ var PlatformClient = class extends HttpClient {
     this.ai = new AIModule(this);
     this.automations = new AutomationsModule(this);
     this.incomingWebhooks = new IncomingWebhooksModule(this);
+    this.blueprints = new BlueprintsModule(this);
     this.site = new SiteModule(this);
     this.adminUsers = new AdminUsersModule(this);
     this.adminSystem = new AdminSystemModule(this);
@@ -3048,6 +3245,7 @@ function createPlatformClient(config) {
   AssetsModule,
   AuthModule,
   AutomationsModule,
+  BlueprintsModule,
   CollectionsModule,
   EmailEventSubscriptionsModule,
   EmailTemplatesClient,

package/dist/platform.d.cts

@@ -1,5 +1,5 @@
-import { H as HttpClient } from './HttpClient-B_rEmJuO.cjs';
-import { t as components, A as AuthToken } from './index-BEEbnrXV.cjs';
+import { H as HttpClient, a as BinaryResponse } from './HttpClient-DXMNOPqu.cjs';
+import { t as components, A as AuthToken } from './index-7sv2m2Pe.cjs';
 
 /**
  * Platform API Types
@@ -14,6 +14,18 @@ import { t as components, A as AuthToken } from './index-BEEbnrXV.cjs';
 type PlatformEntry = components['schemas']['EntryRead'];
 type PlatformEntryCreate = components['schemas']['EntryCreate'];
 type PlatformEntryUpdate = components['schemas']['EntryUpdate'];
+/**
+ * Entry counts by status (`GET /api/platform/entries/counts`): every known status, zero-filled,
+ * plus `total` — e.g. `{ inbox: 2, draft: 5, needs_review: 1, published: 40, …, total: 48 }`.
+ */
+type PlatformEntryCounts = Record<string, number>;
+/**
+ * The dashboard (`GET /api/platform/stats/dashboard`): recent activity and the "needs attention"
+ * counts — inbox, drafts, entries needing review, pending AI suggestions, failures in the last 7 days.
+ */
+type PlatformDashboard = components['schemas']['DashboardData'];
+type PlatformAttentionCounts = components['schemas']['AttentionCounts'];
+type PlatformRecentEvent = components['schemas']['RecentEvent'];
 /**
  * Tag (Platform API) — the shared, group-scoped label vocabulary.
  */
@@ -51,6 +63,28 @@ interface SmartCollectionRules {
     /** how to combine the dimensions above (default "all") */
     match?: 'all' | 'any';
 }
+/**
+ * Smart-collection rule preview: what unsaved rules would select, without saving anything.
+ */
+interface SmartRulesPreviewRequest {
+    /** Which kind of item the rules select (default 'entry'). */
+    targetType?: 'entry' | 'asset' | 'resource';
+    /** The rules, in the same shape as a collection's `smartRules`. */
+    smartRules?: SmartCollectionRules | Record<string, unknown> | null;
+    /** How many matches to list (default 10, at most 50); `total` counts them all. */
+    limit?: number;
+}
+type SmartRulesPreview = components['schemas']['SmartRulesPreview'];
+/**
+ * One member of a collection of any target type (`GET /api/platform/collections/{id}/members`).
+ */
+interface CollectionMember {
+    id: string;
+    /** The entry's title, or the asset's / resource's name. */
+    label: string;
+    slug: string | null;
+    type: 'entry' | 'asset' | 'resource';
+}
 /**
  * Resource (Platform API - full CRUD)
  */
@@ -111,6 +145,10 @@ declare class EntriesModule {
      * List all entries
      */
     list(): Promise<PlatformEntry[]>;
+    /**
+     * Entry counts by status, zero-filled, plus `total` (what the sidebar's inbox badge reads).
+     */
+    counts(): Promise<PlatformEntryCounts>;
     /**
      * Get a single entry by ID
      */
@@ -141,6 +179,24 @@ declare class EntriesModule {
      * Remove entry from a collection
      */
     removeFromCollection(entryId: string, collectionId: string): Promise<void>;
+    /**
+     * Apply the entry's staged AI suggestion (`suggestionJson`) and clear it — the approval half of
+     * AI write-back. Returns the updated entry.
+     */
+    applySuggestion(id: string): Promise<PlatformEntry>;
+    /**
+     * Discard the entry's staged AI suggestion without applying it.
+     */
+    rejectSuggestion(id: string): Promise<PlatformEntry>;
+    /**
+     * Approve an AI-suggested asset on an entry: it becomes a normal attached asset (and reaches
+     * published output).
+     */
+    approveSuggestedAsset(entryId: string, assetId: string): Promise<PlatformEntry>;
+    /**
+     * Reject an AI-suggested asset: unlink it, and delete the asset if nothing else uses it.
+     */
+    rejectSuggestedAsset(entryId: string, assetId: string): Promise<PlatformEntry>;
 }
 
 /**
@@ -170,6 +226,17 @@ declare class CollectionsModule {
      * server keeps membership in sync. Pass extra fields (description, icon, …) via `extra`.
      */
     createSmart(name: string, rules: SmartCollectionRules, extra?: Partial<PlatformCollectionCreate>): Promise<PlatformCollection>;
+    /**
+     * Preview unsaved smart-collection rules: how many items they match (`total`) and the first
+     * `limit` of them (default 10, at most 50), evaluated by the same code that materializes
+     * membership on save. Saves nothing. Needs EDITOR.
+     */
+    preview(request: SmartRulesPreviewRequest): Promise<SmartRulesPreview>;
+    /**
+     * A collection's members, whatever it groups — entries, assets or resources — as
+     * `{id, label, slug, type}`, ordered by label.
+     */
+    members(id: string): Promise<CollectionMember[]>;
     /**
      * Update a collection
      */
@@ -284,6 +351,14 @@ declare class ResourcesModule {
      * Get entries that reference this resource
      */
     getEntries(id: string): Promise<PlatformEntry[]>;
+    /**
+     * Apply the resource's staged AI suggestion (`suggestionJson`) and clear it. Needs EDITOR.
+     */
+    applySuggestion(id: string): Promise<PlatformResource>;
+    /**
+     * Discard the resource's staged AI suggestion without applying it. Needs EDITOR.
+     */
+    rejectSuggestion(id: string): Promise<PlatformResource>;
 }
 
 /**
@@ -343,7 +418,13 @@ declare class AssetsModule {
      */
     delete(id: string): Promise<void>;
     /**
-     * Fetch the raw file for an asset
+     * Download an asset's file: its bytes and content type. A redirect to storage is followed.
+     */
+    download(id: string): Promise<BinaryResponse>;
+    /**
+     * Fetch the raw file for an asset.
+     * @deprecated Use {@link download}, which is typed. (Before 4.3 this resolved to `undefined` for
+     * any file that wasn't JSON; it now returns the same `BinaryResponse` as `download`.)
      */
     getFile(id: string): Promise<unknown>;
     /**
@@ -351,6 +432,14 @@ declare class AssetsModule {
      * Use this to create download links or fetch the file directly
      */
     getDownloadUrl(id: string, baseUrl?: string): string;
+    /**
+     * Apply the asset's staged AI suggestion (`suggestionJson`) and clear it. Needs EDITOR.
+     */
+    applySuggestion(id: string): Promise<PlatformAsset>;
+    /**
+     * Discard the asset's staged AI suggestion without applying it. Needs EDITOR.
+     */
+    rejectSuggestion(id: string): Promise<PlatformAsset>;
 }
 
 /**
@@ -542,6 +631,11 @@ declare class WorkspacesModule {
      * Get platform-level stats for the current workspace
      */
     getStats(): Promise<unknown>;
+    /**
+     * The current workspace's dashboard: recent activity and the "needs attention" counts (inbox,
+     * drafts, entries needing review, pending AI suggestions, failures in the last 7 days).
+     */
+    getDashboard(): Promise<PlatformDashboard>;
     /**
      * List available workspace backups
      */
@@ -1254,9 +1348,22 @@ declare class UserModule {
 /**
  * Events Module - Platform API
  *
- * Event type information for webhooks and automations
- */
-
+ * Event type information for webhooks and automations, and the Events hub: what sends each event type and
+ * what reacts to it in the current workspace (workspace OWNER/ADMIN; platform event types are not listed).
+ *
+ * Routes: /api/event/types, /api/platform/event-types/connections, /api/platform/event-types/{type}/connections.
+ */
+
+/** One event type's whole story: senders, reactions (switched-off ones too), recent events, the chain. */
+type EventConnections = components['schemas']['EventConnections'];
+/** One row of `getConnectionsSummary`: how many senders and reactions a type has, and when it last happened. */
+type EventConnectionCounts = components['schemas']['EventConnectionCounts'];
+/** Something that runs when the event happens: a workflow, integration action, email, webhook or built-in reaction. */
+type EventReaction = components['schemas']['EventReaction'];
+/** Something that sends the event: Marvin itself, a workflow, an incoming webhook or a scheduled task. */
+type EventSender = components['schemas']['EventSender'];
+/** The integration whose blueprint created a workflow, task, incoming webhook or integration action. */
+type EventInstalledBy = components['schemas']['InstalledBy'];
 interface EventVariable {
     slug: string;
     description: string;
@@ -1279,6 +1386,17 @@ declare class EventsModule {
      * Get available event types for webhooks and automations
      */
     getOptions(): Promise<EventOption[]>;
+    /**
+     * Every workspace event type, in catalog order, with how many things send it and react to it.
+     */
+    getConnectionsSummary(): Promise<EventConnectionCounts[]>;
+    /**
+     * What sends an event type and what reacts to it, with its newest `limit` events (default 10, max 50).
+     * Rejects with 404 for an unknown or platform-scope type.
+     */
+    getConnections(eventType: string, options?: {
+        limit?: number;
+    }): Promise<EventConnections>;
 }
 
 /**
@@ -2912,7 +3030,32 @@ declare class AutomationsModule {
  * Routes: /api/incoming-webhooks (CRUD) + /api/incoming-webhooks/{id}/token (mint/revoke).
  */
 
-interface IncomingWebhook {
+/**
+ * How a webhook verifies its sender. Unset = no verification, or the default HMAC check
+ * (`sha256=<hex>` in `X-Signature-256`) once `signingSecretRef` names the workspace secret
+ * holding the sender's key. `signatureScheme` picks a preset (see
+ * {@link IncomingWebhooksModule.signatureSchemes}) or `custom`, described by `signatureConfig`.
+ */
+interface IncomingWebhookSignature {
+    /** Slug of the workspace secret holding the sender's signing key. */
+    signingSecretRef?: string | null;
+    /** The header carrying the signature (defaults to X-Signature-256). */
+    signatureHeader?: string | null;
+    /** A core preset, an integration's preset, or `custom`. */
+    signatureScheme?: string | null;
+    /** The URL the sender signs, for schemes that sign the URL (when it differs from the receiver's). */
+    signatureUrl?: string | null;
+    /** The construction for `custom`. */
+    signatureConfig?: Record<string, unknown> | null;
+}
+/** A scheme a webhook can verify with: core presets, then integration presets, then `custom`. */
+interface IncomingWebhookSignatureScheme {
+    name: string;
+    notes: string;
+    /** `core`, or the slug of the integration that contributes it. */
+    source: string;
+}
+interface IncomingWebhook extends IncomingWebhookSignature {
     id: string;
     groupId: string;
     name: string;
@@ -2924,13 +3067,13 @@ interface IncomingWebhook {
     receivedCount: number;
     lastReceivedAt: string | null;
 }
-interface IncomingWebhookCreate {
+interface IncomingWebhookCreate extends IncomingWebhookSignature {
     name: string;
     slug?: string;
     description?: string;
     enabled?: boolean;
 }
-interface IncomingWebhookUpdate {
+interface IncomingWebhookUpdate extends IncomingWebhookSignature {
     name?: string;
     description?: string;
     enabled?: boolean;
@@ -2940,6 +3083,8 @@ declare class IncomingWebhooksModule {
     constructor(http: HttpClient);
     /** List the workspace's incoming webhooks. */
     list(): Promise<IncomingWebhook[]>;
+    /** The signature schemes a webhook can pick (`signatureScheme`). */
+    signatureSchemes(): Promise<IncomingWebhookSignatureScheme[]>;
     get(id: string): Promise<IncomingWebhook>;
     /** Create an incoming webhook (no token yet — mint one with {@link mintToken}). */
     create(body: IncomingWebhookCreate): Promise<IncomingWebhook>;
@@ -2951,6 +3096,66 @@ declare class IncomingWebhooksModule {
     revokeToken(id: string): Promise<IncomingWebhook>;
 }
 
+/**
+ * Blueprints Module — Platform API
+ *
+ * The catalog of structure a workspace could have — collections, entry types, scheduled tasks and
+ * workflows that core ships and installed integrations contribute — and applying them to the active
+ * workspace. Each catalog entry says whether this workspace can use it (`available`,
+ * `missingRequirements`), already has it (`applied`), or has an older version of it (`outdated`).
+ *
+ * Applying creates what is missing and never overwrites what exists, so a repeat call is a no-op;
+ * the result says what happened. Reads: any member. Apply and update: workspace ADMIN.
+ *
+ * Routes: /api/groups/blueprints (+ /categories, /{slug}, /{slug}/apply, /{slug}/update, /apply).
+ */
+
+type Blueprint = components['schemas']['BlueprintRead'];
+type BlueprintApplyResult = components['schemas']['BlueprintApplyResult'];
+type BlueprintParameter = components['schemas']['BlueprintParameter'];
+interface BlueprintListOptions {
+    /** `collection`, `entry_type`, `scheduled_task`, … */
+    kind?: string;
+    category?: string;
+    /** `core`, or a provider slug. */
+    source?: string;
+    /** The connection to check per-integration blueprints against (`applied`). */
+    integrationId?: string;
+}
+interface BlueprintApplyOptions {
+    /** Pick the blueprint from this source when several share a slug. */
+    source?: string;
+    /** The connection a per-integration blueprint is applied for. */
+    integrationId?: string;
+}
+declare class BlueprintsModule {
+    private http;
+    constructor(http: HttpClient);
+    private query;
+    /** The catalog, annotated with what this workspace can do about each blueprint. */
+    list(options?: BlueprintListOptions): Promise<Blueprint[]>;
+    /** Category names in catalog order: core's first, then each provider's. */
+    categories(): Promise<string[]>;
+    /** One blueprint, including its payload. */
+    get(slug: string, options?: {
+        source?: string;
+    }): Promise<Blueprint>;
+    /**
+     * Create this blueprint's object in the workspace if it isn't there yet. `params` fills the
+     * parameters the blueprint declares, e.g. `{ entry_type: 'post' }`. Needs ADMIN.
+     */
+    apply(slug: string, params?: Record<string, unknown>, options?: BlueprintApplyOptions): Promise<BlueprintApplyResult>;
+    /**
+     * Apply several blueprints at once; entry types are created before the collections and tasks that
+     * use them, whatever the order here. `params` is keyed by blueprint slug. Needs ADMIN.
+     */
+    applyMany(slugs: string[], params?: Record<string, Record<string, unknown>>, options?: BlueprintApplyOptions): Promise<BlueprintApplyResult[]>;
+    /** Replace an applied workflow's steps with what its integration declares now. Needs ADMIN. */
+    update(slug: string, params?: Record<string, unknown>, options?: {
+        source?: string;
+    }): Promise<BlueprintApplyResult>;
+}
+
 /**
  * Site Module - Platform API
  *
@@ -3024,6 +3229,8 @@ declare class PlatformClient extends HttpClient {
     ai: AIModule;
     automations: AutomationsModule;
     incomingWebhooks: IncomingWebhooksModule;
+    /** Blueprint catalog: browse and apply collections, entry types, tasks and workflows */
+    blueprints: BlueprintsModule;
     site: SiteModule;
     adminUsers: AdminUsersModule;
     adminSystem: AdminSystemModule;
@@ -3055,4 +3262,4 @@ declare class PlatformClient extends HttpClient {
  */
 declare function createPlatformClient(config?: Partial<PlatformClientConfig>): PlatformClient;
 
-export { type AIApprovalMode, type AIChatRequest, type AIChatResult, type AICredentialMode, type AIExecution, type AIExecutionListParams, type AIExecutionStatus, AIExecutionsModule, AIMcpServersModule, type AIModel, type AIModelCreate, type AIModelUpdate, AIModelsModule, AIModule, type AIOperationExecuteRequest, type AIOperationInfo, AIOperationsModule, type AIProvider, type AIProviderCreate, type AIProviderTestResult, type AIProviderType, type AIProviderUpdate, AIProvidersModule, type AIReindexRequest, type AISettings, AISettingsModule, type AISettingsUpdate, type AIToolInfo, type AIToolInvokeRequest, AIToolsModule, APIClientsModule, type AdminAboutInfo, AdminBackupsModule, AdminMaintenanceModule, type AdminPlugin, type AdminPluginProvider, AdminScheduledTasksModule, AdminSystemModule, AdminUsersModule, type AdminWorkspaceMemberCreate, type AdminWorkspaceMemberUpdate, type AdminWorkspaceMembership, AdminWorkspacesModule, type AgentToolInfo, type AlertRouting, type AlertRoutingTarget, type AlertRoutingUpdate, type ApiToken, type ApiTokenCreate, type ApiTokenUpdate, type ApiTokenWithToken, type AppAboutInfo, AppModule, type AppTheme, AssetsModule, AuthModule, type Automation, type AutomationAction, type AutomationActionExecution, type AutomationActionOption, type AutomationCondition, type AutomationConditionField, type AutomationCreate, type AutomationDefinition, type AutomationDryRunOptions, type AutomationDryRunResult, type AutomationDryRunSample, type AutomationExecution, type AutomationExecutionDetail, type AutomationIncomingWebhookOption, type AutomationOptions, type AutomationPlanStep, type AutomationPreviewMatch, type AutomationPreviewResult, type AutomationRunResult, type AutomationSamples, type AutomationTarget, type AutomationTargetOption, type AutomationTrigger, type AutomationUpdate, type AutomationValidateResult, type AutomationValidationIssue, type AutomationWebhookOption, AutomationsModule, CollectionsModule, type EmailEventSubscription, type EmailEventSubscriptionCreate, EmailEventSubscriptionsModule, type EmailInvitationRequest, type EmailSettings, type EmailSettingsUpdate, type EmailSuccess, type EmailTemplateCreate$1 as EmailTemplateCreate, type EmailTemplateRead, type EmailTemplateSummary, type EmailTemplateUpdate, EmailTemplatesClient, type EmailTest, EntriesModule, EntryTypesModule, type EventLogEntry, EventLogModule, type EventLogQueryParams, type EventLogSummary, type EventOption, type EventVariable, EventsModule, FormsModule, type IncomingWebhook, type IncomingWebhookCreate, type IncomingWebhookUpdate, IncomingWebhooksModule, type Integration, type IntegrationActionResult, type IntegrationAttention, type IntegrationCheckResult, type IntegrationCreate, type IntegrationErrorOverrides, type IntegrationEventSubscription, type IntegrationEventSubscriptionCreate, type IntegrationEventSubscriptionUpdate, type IntegrationOption, type IntegrationPluginInfo, type IntegrationProviderAction, type IntegrationProviderCredential, type IntegrationProviderEvent, type IntegrationProviderInfo, type IntegrationResolveResult, type IntegrationUpdate, IntegrationsModule, type InviteTokenCreate, type InviteTokenPagination, type InviteTokenSummary, InvitesModule, type LoginInfo, type MaintenanceStorageDetails, type MaintenanceSummary, type McpServer, type McpServerCreate, type McpServerTestResult, type McpServerToolInfo, type McpServerUpdate, type McpTransport, type PasswordChange, type PasswordResetTokenRequest, type PasswordResetTokenResponse, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetUpdate, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformEntry, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformForm, type PlatformFormCreate, type PlatformFormSubmission, type PlatformFormUpdate, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformTag, type PlatformTagCreate, type PlatformTagUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, type RecipientType, ResourcesModule, type ScheduledTask, type ScheduledTaskCreate, type ScheduledTaskExecutionLog, type ScheduledTaskUpdate, ScheduledTasksModule, type SiteBuildStatus, SiteModule, type SiteRebuildPending, type SiteRebuildRequested, type SiteRebuildSent, type SiteRebuildStatus, type SiteRebuildTarget, type SmartCollectionRules, type StartupInfo, type SystemStatistics, TagsModule, type TaskTypeInfo, type TestEmailRequest, ThemeModule, type UnlockUserRequest, type User, type UserCreate, UserModule, type UserPagination, type UserProfile, type UserProfileUpdate, type UserSummary, type UserUpdate, type Webhook, type WebhookCreate, type WebhookMethod, type WebhookPagination, type WebhookUpdate, WebhooksModule, type Workspace, type WorkspaceActivationRequest, type WorkspaceCreate, WorkspaceMembersModule, type WorkspacePagination, type WorkspacePreferences, type WorkspacePreferencesUpdate, type WorkspaceUpdate, type WorkspaceWithMembership, WorkspacesModule, createPlatformClient, createPlatformConfigFromEnv };
+export { type AIApprovalMode, type AIChatRequest, type AIChatResult, type AICredentialMode, type AIExecution, type AIExecutionListParams, type AIExecutionStatus, AIExecutionsModule, AIMcpServersModule, type AIModel, type AIModelCreate, type AIModelUpdate, AIModelsModule, AIModule, type AIOperationExecuteRequest, type AIOperationInfo, AIOperationsModule, type AIProvider, type AIProviderCreate, type AIProviderTestResult, type AIProviderType, type AIProviderUpdate, AIProvidersModule, type AIReindexRequest, type AISettings, AISettingsModule, type AISettingsUpdate, type AIToolInfo, type AIToolInvokeRequest, AIToolsModule, APIClientsModule, type AdminAboutInfo, AdminBackupsModule, AdminMaintenanceModule, type AdminPlugin, type AdminPluginProvider, AdminScheduledTasksModule, AdminSystemModule, AdminUsersModule, type AdminWorkspaceMemberCreate, type AdminWorkspaceMemberUpdate, type AdminWorkspaceMembership, AdminWorkspacesModule, type AgentToolInfo, type AlertRouting, type AlertRoutingTarget, type AlertRoutingUpdate, type ApiToken, type ApiTokenCreate, type ApiTokenUpdate, type ApiTokenWithToken, type AppAboutInfo, AppModule, type AppTheme, AssetsModule, AuthModule, type Automation, type AutomationAction, type AutomationActionExecution, type AutomationActionOption, type AutomationCondition, type AutomationConditionField, type AutomationCreate, type AutomationDefinition, type AutomationDryRunOptions, type AutomationDryRunResult, type AutomationDryRunSample, type AutomationExecution, type AutomationExecutionDetail, type AutomationIncomingWebhookOption, type AutomationOptions, type AutomationPlanStep, type AutomationPreviewMatch, type AutomationPreviewResult, type AutomationRunResult, type AutomationSamples, type AutomationTarget, type AutomationTargetOption, type AutomationTrigger, type AutomationUpdate, type AutomationValidateResult, type AutomationValidationIssue, type AutomationWebhookOption, AutomationsModule, type Blueprint, type BlueprintApplyOptions, type BlueprintApplyResult, type BlueprintListOptions, type BlueprintParameter, BlueprintsModule, type CollectionMember, CollectionsModule, type EmailEventSubscription, type EmailEventSubscriptionCreate, EmailEventSubscriptionsModule, type EmailInvitationRequest, type EmailSettings, type EmailSettingsUpdate, type EmailSuccess, type EmailTemplateCreate$1 as EmailTemplateCreate, type EmailTemplateRead, type EmailTemplateSummary, type EmailTemplateUpdate, EmailTemplatesClient, type EmailTest, EntriesModule, EntryTypesModule, type EventConnectionCounts, type EventConnections, type EventInstalledBy, type EventLogEntry, EventLogModule, type EventLogQueryParams, type EventLogSummary, type EventOption, type EventReaction, type EventSender, type EventVariable, EventsModule, FormsModule, type IncomingWebhook, type IncomingWebhookCreate, type IncomingWebhookSignature, type IncomingWebhookSignatureScheme, type IncomingWebhookUpdate, IncomingWebhooksModule, type Integration, type IntegrationActionResult, type IntegrationAttention, type IntegrationCheckResult, type IntegrationCreate, type IntegrationErrorOverrides, type IntegrationEventSubscription, type IntegrationEventSubscriptionCreate, type IntegrationEventSubscriptionUpdate, type IntegrationOption, type IntegrationPluginInfo, type IntegrationProviderAction, type IntegrationProviderCredential, type IntegrationProviderEvent, type IntegrationProviderInfo, type IntegrationResolveResult, type IntegrationUpdate, IntegrationsModule, type InviteTokenCreate, type InviteTokenPagination, type InviteTokenSummary, InvitesModule, type LoginInfo, type MaintenanceStorageDetails, type MaintenanceSummary, type McpServer, type McpServerCreate, type McpServerTestResult, type McpServerToolInfo, type McpServerUpdate, type McpTransport, type PasswordChange, type PasswordResetTokenRequest, type PasswordResetTokenResponse, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetUpdate, type PlatformAttentionCounts, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformDashboard, type PlatformEntry, type PlatformEntryCounts, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformForm, type PlatformFormCreate, type PlatformFormSubmission, type PlatformFormUpdate, type PlatformRecentEvent, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformTag, type PlatformTagCreate, type PlatformTagUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, type RecipientType, ResourcesModule, type ScheduledTask, type ScheduledTaskCreate, type ScheduledTaskExecutionLog, type ScheduledTaskUpdate, ScheduledTasksModule, type SiteBuildStatus, SiteModule, type SiteRebuildPending, type SiteRebuildRequested, type SiteRebuildSent, type SiteRebuildStatus, type SiteRebuildTarget, type SmartCollectionRules, type SmartRulesPreview, type SmartRulesPreviewRequest, type StartupInfo, type SystemStatistics, TagsModule, type TaskTypeInfo, type TestEmailRequest, ThemeModule, type UnlockUserRequest, type User, type UserCreate, UserModule, type UserPagination, type UserProfile, type UserProfileUpdate, type UserSummary, type UserUpdate, type Webhook, type WebhookCreate, type WebhookMethod, type WebhookPagination, type WebhookUpdate, WebhooksModule, type Workspace, type WorkspaceActivationRequest, type WorkspaceCreate, WorkspaceMembersModule, type WorkspacePagination, type WorkspacePreferences, type WorkspacePreferencesUpdate, type WorkspaceUpdate, type WorkspaceWithMembership, WorkspacesModule, createPlatformClient, createPlatformConfigFromEnv };