@bettercms-ai/sdk 1.31.0 → 1.32.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, BetterCMSErrorCode, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
 export { ApiError, ApiKey, ApiKeyPermission, ApiKeyTokenType, AssertEqual, AuthSession, AuthUser, BetterCMSErrorCode, BlockType, ButtonBlock, ButtonProps, ColumnsBlock, ColumnsProps, Content, ContentBlock, ContentEntry, ContentModel, ContentModelField, ContentPageResult, ContentResponse, DeepReadonly, DeliveryComponent, DeliveryEntry, DeliveryList, DeliveryPage, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
 
@@ -387,6 +387,159 @@ declare function updateEntry(client: ManagementClient, id: string, input: Update
     ifMatch?: number;
 }): Promise<ManagedContentEntry & EntryWriteWarnings>;
 
+/**
+ * Management API SDK methods — reusable components (discover + author).
+ *
+ * Call /api/v1/management/components (key-auth, content:manage). The MCP server wraps
+ * these so an agent can list/read components and author new ones (blockJson + props).
+ */
+
+/** A component as returned by the Management API (render + author shape). */
+interface ManagedComponent {
+    id: string;
+    projectId: string | null;
+    allowedOn: string[];
+    name: string;
+    slug: string;
+    category: string;
+    description: string | null;
+    blockJson: unknown[];
+    props: unknown[];
+    variantGroupId?: string | null;
+    publishedVariantGroupId?: string | null;
+    variantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }>;
+    publishedVariantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }> | null;
+    thumbnail?: string | null;
+    /** How an instance reads as a row in a parent's slot list. @see ComponentPreview */
+    preview?: ComponentPreview | null;
+    /** The block icon (a /kit schema's document-level `icon`), a dock icon name. */
+    icon?: string | null;
+    /** The /kit tabs no top-level prop sits in (declared, empty). @see ComponentTab */
+    tabs?: Array<{
+        id: string;
+        label: string;
+        icon?: string;
+        order?: number;
+    }> | null;
+    /** The bettercms://kit entry its V2 dock UI was built from (a kit-catalog id), or null. */
+    kitEntry?: string | null;
+    /** Send it back as `ifMatch` on updateComponent. */
+    optimisticVersion?: number;
+}
+/** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
+interface ManagedComponentInput {
+    projectId?: string | null;
+    allowedOn?: string[];
+    name?: string;
+    slug?: string;
+    category?: string;
+    sectionType?: string | null;
+    /**
+     * The organisational Group, by NAME. The API resolves it against the project's Groups and
+     * creates it when missing — a caller filing a whole site's components into folders has a name
+     * ("Sections"), never an id.
+     */
+    group?: string;
+    groupId?: string | null;
+    description?: string;
+    /** title/subtitle/media name top-level prop keys (422 `preview_key_unknown` otherwise); null clears it. */
+    preview?: ComponentPreview | null;
+    /** The block icon, a dock icon name (bettercms://icons/dock); null clears it. */
+    icon?: string | null;
+    /** /kit tabs no top-level prop sits in; null clears them (422 component_tab_invalid on a prop's own tab). */
+    tabs?: Array<{
+        id: string;
+        label: string;
+        icon?: string;
+        order?: number;
+    }> | null;
+    /** The bettercms://kit entry its V2 dock UI follows (an id from bettercms://kit); null clears it. 422 `kit_entry_unknown` for an id not in the catalogue. */
+    kitEntry?: string | null;
+    blockJson?: unknown[];
+    props?: unknown[];
+    /**
+     * Make this a VARIANT of that component (id or slug, same project): it joins that component's
+     * variant family, which is started from it when it has none.
+     */
+    variantOf?: string;
+    /** Create only: a built-in section id (`builtin:<key>`) to copy in; the fields you send win. */
+    from?: string;
+    /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
+    propUi?: Record<string, Record<string, unknown> | null>;
+    propGroup?: Record<string, Record<string, unknown> | null>;
+    propTab?: Record<string, Record<string, unknown> | null>;
+    propLabel?: Record<string, string>;
+    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
+    override?: boolean;
+}
+/**
+ * The catalogue shape: what each component IS, without its block trees.
+ *
+ * The default list carries every component's draft AND live `blockJson`, which on a
+ * componentized site is the largest response this API produces — and a caller asking which
+ * components exist wants none of it. This shape also carries `sectionType`, `status` and the
+ * Group, the three facts that decide whether a component is insertable, whether it is on the
+ * live site, and where an editor finds it.
+ */
+interface ManagedComponentSummary {
+    id: string;
+    projectId: string | null;
+    name: string;
+    slug: string;
+    category: string;
+    sectionType: string | null;
+    status: string | null;
+    groupId: string | null;
+    groupName: string | null;
+    updatedAt: string | null;
+    builtin?: boolean;
+}
+/**
+ * A set of sections that repeat across the project's pages, proposed as one component.
+ * Derived per request from the pages' DRAFT blocks — never stored.
+ */
+interface ExtractionCandidate {
+    /** Identifies the shape. Pass it back to `extractComponent`; it is re-verified server-side. */
+    hash: string;
+    blockType: string;
+    uses: number;
+    suggestedName: string;
+    blockJson: unknown[];
+    /** The leaves that differ between copies, which become the component's editable props. */
+    props: unknown[];
+    sites: {
+        pageId: string;
+        title: string;
+        slug: string;
+        blockId: string;
+        overrides: Record<string, unknown>;
+    }[];
+}
+/**
+ * Create the component from one candidate and repoint every occurrence at it.
+ *
+ * Rewrites page DRAFTS on several pages at once. `hash` is re-verified against a fresh scan,
+ * so a proposal that went stale 409s rather than applying against pages that have moved on.
+ */
+/** The bettercms://kit entry an extracted component records: `link` is its resource, or bettercms://kit when none fits. */
+interface ExtractedKit {
+    kitEntry: string | null;
+    score: number | null;
+    link: string;
+}
+
 /**
  * Management API SDK method — media upload (P2).
  *
@@ -731,129 +884,6 @@ interface ManagedFormInput {
     notifyEmails?: string[];
 }
 
-/**
- * Management API SDK methods — reusable components (discover + author).
- *
- * Call /api/v1/management/components (key-auth, content:manage). The MCP server wraps
- * these so an agent can list/read components and author new ones (blockJson + props).
- */
-
-/** A component as returned by the Management API (render + author shape). */
-interface ManagedComponent {
-    id: string;
-    projectId: string | null;
-    allowedOn: string[];
-    name: string;
-    slug: string;
-    category: string;
-    description: string | null;
-    blockJson: unknown[];
-    props: unknown[];
-    variantGroupId?: string | null;
-    publishedVariantGroupId?: string | null;
-    variantInputMappings?: Array<{
-        inputId: string;
-        targets: Array<{
-            blockId: string;
-            path: string;
-        }>;
-    }>;
-    publishedVariantInputMappings?: Array<{
-        inputId: string;
-        targets: Array<{
-            blockId: string;
-            path: string;
-        }>;
-    }> | null;
-    thumbnail?: string | null;
-    /** How an instance reads as a row in a parent's slot list. @see ComponentPreview */
-    preview?: ComponentPreview | null;
-    /** The block icon (a /kit schema's document-level `icon`), a dock icon name. */
-    icon?: string | null;
-    /** Send it back as `ifMatch` on updateComponent. */
-    optimisticVersion?: number;
-}
-/** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
-interface ManagedComponentInput {
-    projectId?: string | null;
-    allowedOn?: string[];
-    name?: string;
-    slug?: string;
-    category?: string;
-    sectionType?: string | null;
-    /**
-     * The organisational Group, by NAME. The API resolves it against the project's Groups and
-     * creates it when missing — a caller filing a whole site's components into folders has a name
-     * ("Sections"), never an id.
-     */
-    group?: string;
-    groupId?: string | null;
-    description?: string;
-    /** title/subtitle/media name top-level prop keys (422 `preview_key_unknown` otherwise); null clears it. */
-    preview?: ComponentPreview | null;
-    /** The block icon, a dock icon name (bettercms://icons/dock); null clears it. */
-    icon?: string | null;
-    blockJson?: unknown[];
-    props?: unknown[];
-    /**
-     * Make this a VARIANT of that component (id or slug, same project): it joins that component's
-     * variant family, which is started from it when it has none.
-     */
-    variantOf?: string;
-    /** Create only: a built-in section id (`builtin:<key>`) to copy in; the fields you send win. */
-    from?: string;
-    /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
-    propUi?: Record<string, Record<string, unknown> | null>;
-    propGroup?: Record<string, Record<string, unknown> | null>;
-    propTab?: Record<string, Record<string, unknown> | null>;
-    propLabel?: Record<string, string>;
-    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
-    override?: boolean;
-}
-/**
- * The catalogue shape: what each component IS, without its block trees.
- *
- * The default list carries every component's draft AND live `blockJson`, which on a
- * componentized site is the largest response this API produces — and a caller asking which
- * components exist wants none of it. This shape also carries `sectionType`, `status` and the
- * Group, the three facts that decide whether a component is insertable, whether it is on the
- * live site, and where an editor finds it.
- */
-interface ManagedComponentSummary {
-    id: string;
-    projectId: string | null;
-    name: string;
-    slug: string;
-    category: string;
-    sectionType: string | null;
-    status: string | null;
-    groupId: string | null;
-    groupName: string | null;
-    updatedAt: string | null;
-    builtin?: boolean;
-}
-/**
- * A set of sections that repeat across the project's pages, proposed as one component.
- * Derived per request from the pages' DRAFT blocks — never stored.
- */
-interface ExtractionCandidate {
-    /** Identifies the shape. Pass it back to `extractComponent`; it is re-verified server-side. */
-    hash: string;
-    blockType: string;
-    uses: number;
-    suggestedName: string;
-    blockJson: unknown[];
-    /** The leaves that differ between copies, which become the component's editable props. */
-    props: unknown[];
-    sites: {
-        pageId: string;
-        title: string;
-        slug: string;
-        blockId: string;
-        overrides: Record<string, unknown>;
-    }[];
-}
-
 /**
  * Management API SDK methods — AI content + SEO actions (Option B, portable skill).
  *
@@ -1036,6 +1066,7 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     }): Promise<{
         component: ManagedComponent;
         replaced: number;
+        kit?: ExtractedKit;
     }>;
     getManagedLayout(opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
     commandManagedLayout(input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, BetterCMSErrorCode, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
 export { ApiError, ApiKey, ApiKeyPermission, ApiKeyTokenType, AssertEqual, AuthSession, AuthUser, BetterCMSErrorCode, BlockType, ButtonBlock, ButtonProps, ColumnsBlock, ColumnsProps, Content, ContentBlock, ContentEntry, ContentModel, ContentModelField, ContentPageResult, ContentResponse, DeepReadonly, DeliveryComponent, DeliveryEntry, DeliveryList, DeliveryPage, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
 
@@ -387,6 +387,159 @@ declare function updateEntry(client: ManagementClient, id: string, input: Update
     ifMatch?: number;
 }): Promise<ManagedContentEntry & EntryWriteWarnings>;
 
+/**
+ * Management API SDK methods — reusable components (discover + author).
+ *
+ * Call /api/v1/management/components (key-auth, content:manage). The MCP server wraps
+ * these so an agent can list/read components and author new ones (blockJson + props).
+ */
+
+/** A component as returned by the Management API (render + author shape). */
+interface ManagedComponent {
+    id: string;
+    projectId: string | null;
+    allowedOn: string[];
+    name: string;
+    slug: string;
+    category: string;
+    description: string | null;
+    blockJson: unknown[];
+    props: unknown[];
+    variantGroupId?: string | null;
+    publishedVariantGroupId?: string | null;
+    variantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }>;
+    publishedVariantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }> | null;
+    thumbnail?: string | null;
+    /** How an instance reads as a row in a parent's slot list. @see ComponentPreview */
+    preview?: ComponentPreview | null;
+    /** The block icon (a /kit schema's document-level `icon`), a dock icon name. */
+    icon?: string | null;
+    /** The /kit tabs no top-level prop sits in (declared, empty). @see ComponentTab */
+    tabs?: Array<{
+        id: string;
+        label: string;
+        icon?: string;
+        order?: number;
+    }> | null;
+    /** The bettercms://kit entry its V2 dock UI was built from (a kit-catalog id), or null. */
+    kitEntry?: string | null;
+    /** Send it back as `ifMatch` on updateComponent. */
+    optimisticVersion?: number;
+}
+/** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
+interface ManagedComponentInput {
+    projectId?: string | null;
+    allowedOn?: string[];
+    name?: string;
+    slug?: string;
+    category?: string;
+    sectionType?: string | null;
+    /**
+     * The organisational Group, by NAME. The API resolves it against the project's Groups and
+     * creates it when missing — a caller filing a whole site's components into folders has a name
+     * ("Sections"), never an id.
+     */
+    group?: string;
+    groupId?: string | null;
+    description?: string;
+    /** title/subtitle/media name top-level prop keys (422 `preview_key_unknown` otherwise); null clears it. */
+    preview?: ComponentPreview | null;
+    /** The block icon, a dock icon name (bettercms://icons/dock); null clears it. */
+    icon?: string | null;
+    /** /kit tabs no top-level prop sits in; null clears them (422 component_tab_invalid on a prop's own tab). */
+    tabs?: Array<{
+        id: string;
+        label: string;
+        icon?: string;
+        order?: number;
+    }> | null;
+    /** The bettercms://kit entry its V2 dock UI follows (an id from bettercms://kit); null clears it. 422 `kit_entry_unknown` for an id not in the catalogue. */
+    kitEntry?: string | null;
+    blockJson?: unknown[];
+    props?: unknown[];
+    /**
+     * Make this a VARIANT of that component (id or slug, same project): it joins that component's
+     * variant family, which is started from it when it has none.
+     */
+    variantOf?: string;
+    /** Create only: a built-in section id (`builtin:<key>`) to copy in; the fields you send win. */
+    from?: string;
+    /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
+    propUi?: Record<string, Record<string, unknown> | null>;
+    propGroup?: Record<string, Record<string, unknown> | null>;
+    propTab?: Record<string, Record<string, unknown> | null>;
+    propLabel?: Record<string, string>;
+    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
+    override?: boolean;
+}
+/**
+ * The catalogue shape: what each component IS, without its block trees.
+ *
+ * The default list carries every component's draft AND live `blockJson`, which on a
+ * componentized site is the largest response this API produces — and a caller asking which
+ * components exist wants none of it. This shape also carries `sectionType`, `status` and the
+ * Group, the three facts that decide whether a component is insertable, whether it is on the
+ * live site, and where an editor finds it.
+ */
+interface ManagedComponentSummary {
+    id: string;
+    projectId: string | null;
+    name: string;
+    slug: string;
+    category: string;
+    sectionType: string | null;
+    status: string | null;
+    groupId: string | null;
+    groupName: string | null;
+    updatedAt: string | null;
+    builtin?: boolean;
+}
+/**
+ * A set of sections that repeat across the project's pages, proposed as one component.
+ * Derived per request from the pages' DRAFT blocks — never stored.
+ */
+interface ExtractionCandidate {
+    /** Identifies the shape. Pass it back to `extractComponent`; it is re-verified server-side. */
+    hash: string;
+    blockType: string;
+    uses: number;
+    suggestedName: string;
+    blockJson: unknown[];
+    /** The leaves that differ between copies, which become the component's editable props. */
+    props: unknown[];
+    sites: {
+        pageId: string;
+        title: string;
+        slug: string;
+        blockId: string;
+        overrides: Record<string, unknown>;
+    }[];
+}
+/**
+ * Create the component from one candidate and repoint every occurrence at it.
+ *
+ * Rewrites page DRAFTS on several pages at once. `hash` is re-verified against a fresh scan,
+ * so a proposal that went stale 409s rather than applying against pages that have moved on.
+ */
+/** The bettercms://kit entry an extracted component records: `link` is its resource, or bettercms://kit when none fits. */
+interface ExtractedKit {
+    kitEntry: string | null;
+    score: number | null;
+    link: string;
+}
+
 /**
  * Management API SDK method — media upload (P2).
  *
@@ -731,129 +884,6 @@ interface ManagedFormInput {
     notifyEmails?: string[];
 }
 
-/**
- * Management API SDK methods — reusable components (discover + author).
- *
- * Call /api/v1/management/components (key-auth, content:manage). The MCP server wraps
- * these so an agent can list/read components and author new ones (blockJson + props).
- */
-
-/** A component as returned by the Management API (render + author shape). */
-interface ManagedComponent {
-    id: string;
-    projectId: string | null;
-    allowedOn: string[];
-    name: string;
-    slug: string;
-    category: string;
-    description: string | null;
-    blockJson: unknown[];
-    props: unknown[];
-    variantGroupId?: string | null;
-    publishedVariantGroupId?: string | null;
-    variantInputMappings?: Array<{
-        inputId: string;
-        targets: Array<{
-            blockId: string;
-            path: string;
-        }>;
-    }>;
-    publishedVariantInputMappings?: Array<{
-        inputId: string;
-        targets: Array<{
-            blockId: string;
-            path: string;
-        }>;
-    }> | null;
-    thumbnail?: string | null;
-    /** How an instance reads as a row in a parent's slot list. @see ComponentPreview */
-    preview?: ComponentPreview | null;
-    /** The block icon (a /kit schema's document-level `icon`), a dock icon name. */
-    icon?: string | null;
-    /** Send it back as `ifMatch` on updateComponent. */
-    optimisticVersion?: number;
-}
-/** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
-interface ManagedComponentInput {
-    projectId?: string | null;
-    allowedOn?: string[];
-    name?: string;
-    slug?: string;
-    category?: string;
-    sectionType?: string | null;
-    /**
-     * The organisational Group, by NAME. The API resolves it against the project's Groups and
-     * creates it when missing — a caller filing a whole site's components into folders has a name
-     * ("Sections"), never an id.
-     */
-    group?: string;
-    groupId?: string | null;
-    description?: string;
-    /** title/subtitle/media name top-level prop keys (422 `preview_key_unknown` otherwise); null clears it. */
-    preview?: ComponentPreview | null;
-    /** The block icon, a dock icon name (bettercms://icons/dock); null clears it. */
-    icon?: string | null;
-    blockJson?: unknown[];
-    props?: unknown[];
-    /**
-     * Make this a VARIANT of that component (id or slug, same project): it joins that component's
-     * variant family, which is started from it when it has none.
-     */
-    variantOf?: string;
-    /** Create only: a built-in section id (`builtin:<key>`) to copy in; the fields you send win. */
-    from?: string;
-    /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
-    propUi?: Record<string, Record<string, unknown> | null>;
-    propGroup?: Record<string, Record<string, unknown> | null>;
-    propTab?: Record<string, Record<string, unknown> | null>;
-    propLabel?: Record<string, string>;
-    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
-    override?: boolean;
-}
-/**
- * The catalogue shape: what each component IS, without its block trees.
- *
- * The default list carries every component's draft AND live `blockJson`, which on a
- * componentized site is the largest response this API produces — and a caller asking which
- * components exist wants none of it. This shape also carries `sectionType`, `status` and the
- * Group, the three facts that decide whether a component is insertable, whether it is on the
- * live site, and where an editor finds it.
- */
-interface ManagedComponentSummary {
-    id: string;
-    projectId: string | null;
-    name: string;
-    slug: string;
-    category: string;
-    sectionType: string | null;
-    status: string | null;
-    groupId: string | null;
-    groupName: string | null;
-    updatedAt: string | null;
-    builtin?: boolean;
-}
-/**
- * A set of sections that repeat across the project's pages, proposed as one component.
- * Derived per request from the pages' DRAFT blocks — never stored.
- */
-interface ExtractionCandidate {
-    /** Identifies the shape. Pass it back to `extractComponent`; it is re-verified server-side. */
-    hash: string;
-    blockType: string;
-    uses: number;
-    suggestedName: string;
-    blockJson: unknown[];
-    /** The leaves that differ between copies, which become the component's editable props. */
-    props: unknown[];
-    sites: {
-        pageId: string;
-        title: string;
-        slug: string;
-        blockId: string;
-        overrides: Record<string, unknown>;
-    }[];
-}
-
 /**
  * Management API SDK methods — AI content + SEO actions (Option B, portable skill).
  *
@@ -1036,6 +1066,7 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     }): Promise<{
         component: ManagedComponent;
         replaced: number;
+        kit?: ExtractedKit;
     }>;
     getManagedLayout(opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
     commandManagedLayout(input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;

package/dist/index.js

@@ -780,7 +780,7 @@ async function extractComponent(client, input) {
     client.url("/management/components/extract"),
     { method: "POST", body: JSON.stringify(input) }
   );
-  return { component: res.data, replaced: res.replaced };
+  return { component: res.data, replaced: res.replaced, ...res.kit ? { kit: res.kit } : {} };
 }
 async function updateComponent(client, id, input, opts) {
   const res = await client.fetchJSON(