@capybara-hq/kernel 0.1.0-rc.13 → 0.1.0-rc.15

package/dist/admin/admin.schemas.d.ts

@@ -53,19 +53,11 @@ export declare const DeploymentSettingsBody: z.ZodObject<{
     uiTheme: z.ZodOptional<z.ZodObject<{
         id: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
-    uiArrangement: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        "agent.detail.section": "agent.detail.section";
-        "conversation.panel": "conversation.panel";
-        "conversation.properties.section": "conversation.properties.section";
-        "conversation.tool-result.card": "conversation.tool-result.card";
-        "file.preview": "file.preview";
-        "org.page": "org.page";
-        "org.settings.section": "org.settings.section";
-        "platform.page": "platform.page";
-    }> & z.core.$partial, z.ZodNullable<z.ZodObject<{
-        hidden: z.ZodArray<z.ZodString>;
-        order: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>>>>;
+    uiArrangement: z.ZodOptional<z.ZodType<Partial<Record<"agent.detail.section" | "conversation.composer.frame" | "conversation.empty" | "conversation.panel" | "conversation.properties.section" | "conversation.tool-result.card" | "file.preview" | "org.page" | "org.settings.section" | "platform.page" | "shell.brand" | "shell.overlay", import("../ui/arrangement.js").UiArrangementEntry | null>>, unknown, z.core.$ZodTypeInternals<Partial<Record<"agent.detail.section" | "conversation.composer.frame" | "conversation.empty" | "conversation.panel" | "conversation.properties.section" | "conversation.tool-result.card" | "file.preview" | "org.page" | "org.settings.section" | "platform.page" | "shell.brand" | "shell.overlay", import("../ui/arrangement.js").UiArrangementEntry | null>>, unknown>>>;
+    clientExtensions: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        disabled: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const PurposeParams: z.ZodObject<{
     purpose: z.ZodString;

package/dist/catalog/admin-catalog.controller.d.ts

@@ -1,8 +1,13 @@
+import type { SuggestedAppearance } from "@capybara-hq/plugin-sdk";
 import type { FastifyReply } from "fastify";
 import { z } from "zod";
+import { type ClientBuildSummary, ClientBuilds } from "../client/client-builds.service.js";
+import { PluginGuides, type RenderedSetupGuide } from "../extensions/plugin-guides.js";
 import { PluginIcons } from "../extensions/plugin-icons.js";
 import { type Principal } from "../identity/principal.js";
-import { CatalogItemsQuery, CatalogUpdateBody, CatalogUpdatePreviewBody, CatalogDisabledBody as DisabledBody, CatalogGitImportBody as GitBody, CatalogNpmImportBody as NpmBody, CatalogScopeBody as ScopeBody, CatalogScopePreviewBody as ScopePreviewBody, CatalogShownBody as ShownBody } from "./admin-catalog.schemas.js";
+import { AdminCatalogGuideQuery, CatalogItemsQuery, CatalogUpdateBody, CatalogUpdatePreviewBody, CatalogDisabledBody as DisabledBody, CatalogGitImportBody as GitBody, CatalogNpmImportBody as NpmBody, CatalogScopeBody as ScopeBody, CatalogScopePreviewBody as ScopePreviewBody, CatalogShownBody as ShownBody } from "./admin-catalog.schemas.js";
+import { AppearanceApplyBody } from "./appearance.schemas.js";
+import { type AppearanceResult, AppearanceService } from "./appearance.service.js";
 import { type CatalogItemDetail, type CatalogItemView, CatalogService, type PermissionsMismatch } from "./catalog.service.js";
 import { CatalogScopeService, type ScopePreview } from "./catalog-scope.service.js";
 import { OrgCatalogService } from "./org-catalog.service.js";
@@ -38,7 +43,10 @@ export declare class AdminCatalogController {
     private readonly scope;
     private readonly updater;
     private readonly icons;
-    constructor(catalog: CatalogService, pluginImport: PluginImport, orgCatalog: OrgCatalogService, scope: CatalogScopeService, updater: PlatformPluginUpdater, icons: PluginIcons);
+    private readonly appearance;
+    private readonly clientBuilds;
+    private readonly guides;
+    constructor(catalog: CatalogService, pluginImport: PluginImport, orgCatalog: OrgCatalogService, scope: CatalogScopeService, updater: PlatformPluginUpdater, icons: PluginIcons, appearance: AppearanceService, clientBuilds: ClientBuilds, guides: PluginGuides);
     /**
      * Prepares the import of an uploaded plugin (an npm-pack tgz as the raw body,
      * `application/octet-stream`, at most `packages.maxBytes`): reads and checks the whole plugin
@@ -113,17 +121,43 @@ export declare class AdminCatalogController {
         nextOffset: number | null;
     }>;
     /**
-     * 条目详情与各版本，另给出 `hasIcon`（最新版本有图标，`GET items/:id/icon` 可取）；不存在 → 404
-     * `catalog.item_not_found`。
+     * The item with its versions, plus `hasIcon` (the latest version has an icon, served by `GET
+     * items/:id/icon`) and `suggestedAppearance` (the platform version's, null without one: the page
+     * offers 应用此插件的外观 when set). Each version carries `client`: its extension package's
+     * client build (files with sizes, total, client API version; null without one), what the
+     * permission confirmation of an org's upload shows in its 客户端代码 group (client extensions spec
+     * §5.4). Unknown -> 404 `catalog.item_not_found`.
      */
-    get(id: string): Promise<CatalogItemDetail & {
+    get(id: string): Promise<Omit<CatalogItemDetail, "versions"> & {
+        versions: (CatalogItemDetail["versions"][number] & {
+            client: ClientBuildSummary | null;
+        })[];
         hasIcon: boolean;
+        suggestedAppearance: SuggestedAppearance | null;
     }>;
+    /**
+     * 应用此插件的外观 (client extensions spec §6.5): sets the plugin's suggested theme as the platform
+     * default theme and each suggested replacement as the platform arrangement's `use` of its slot, in
+     * one transaction. `dryRun: true` answers the same changes and writes nothing. A theme that cannot
+     * be the platform default -> 400 `theme.not_available` (nothing written); a replacement not
+     * available on the platform is skipped. No such item, or no suggestion -> 404
+     * `catalog.item_not_found`.
+     */
+    applyAppearance(principal: Principal, id: string, body: z.infer<typeof AppearanceApplyBody>): Promise<AppearanceResult>;
     /**
      * The item's icon (disabled items included; same response headers as the org side, see
      * `sendCatalogIcon`). No icon -> 404 `catalog.icon_not_found`.
      */
     icon(id: string, reply: FastifyReply): Promise<void>;
+    /**
+     * A setup guide of the item as the platform sees it (spec 2026-11-09-setup-guides-v2-design.md
+     * §9.3; the admin console's connector template page): any live item, the admin audience, no org
+     * (`orgName` unresolved, reason `no_org`), no target, no checks run. Unknown item -> 404
+     * `catalog.item_not_found`, unknown guide -> 404 `catalog.guide_not_found`.
+     */
+    guide(itemId: string, guideId: string, q: z.infer<typeof AdminCatalogGuideQuery>): Promise<{
+        guide: RenderedSetupGuide;
+    }>;
     /**
      * What a scope change (`{ scope, orgs? }`, `orgs` only with `named`) or a disable
      * (`{ disabled: true }`) would take away: `{ affected: [{ orgId, orgName, agents,

package/dist/catalog/admin-catalog.controller.js

@@ -9,12 +9,16 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { Controller, Delete, Get, HttpCode, Inject, Param, Post, Put, Req, Res, } from "@nestjs/common";
 import { z } from "zod";
+import { ClientBuilds } from "../client/client-builds.service.js";
 import { ApiError } from "../errors.js";
+import { PluginGuides } from "../extensions/plugin-guides.js";
 import { PluginIcons } from "../extensions/plugin-icons.js";
 import { CurrentPrincipal, patTokenId, requireUser, SuperAdmin, } from "../identity/principal.js";
 import { createZodDto } from "../infra/validation/create-zod-dto.js";
 import { ZBody, ZQuery } from "../infra/validation/zod-params.js";
-import { CatalogItemsQuery, CatalogUpdateBody, CatalogUpdatePreviewBody, CatalogDisabledBody as DisabledBody, CatalogGitImportBody as GitBody, CatalogHash as Hash, CatalogNpmImportBody as NpmBody, CatalogScopeOrgs as Orgs, CatalogScope as Scope, CatalogScopeBody as ScopeBody, CatalogScopePreviewBody as ScopePreviewBody, CatalogShownBody as ShownBody, } from "./admin-catalog.schemas.js";
+import { AdminCatalogGuideQuery, CatalogItemsQuery, CatalogUpdateBody, CatalogUpdatePreviewBody, CatalogDisabledBody as DisabledBody, CatalogGitImportBody as GitBody, CatalogHash as Hash, CatalogNpmImportBody as NpmBody, CatalogScopeOrgs as Orgs, CatalogScope as Scope, CatalogScopeBody as ScopeBody, CatalogScopePreviewBody as ScopePreviewBody, CatalogShownBody as ShownBody, } from "./admin-catalog.schemas.js";
+import { AppearanceApplyBody } from "./appearance.schemas.js";
+import { AppearanceService, suggestedAppearanceOf, } from "./appearance.service.js";
 import { CatalogService, } from "./catalog.service.js";
 import { CatalogScopeService } from "./catalog-scope.service.js";
 import { sendCatalogIcon } from "./org-catalog.controller.js";
@@ -42,6 +46,8 @@ class CatalogImportConfirmBody extends createZodDto(ConfirmBody, "CatalogImportC
 }
 class CatalogGitImportBody extends createZodDto(GitBody, "CatalogGitImportBody") {
 }
+class AdminCatalogGuideQueryDto extends createZodDto(AdminCatalogGuideQuery, "AdminCatalogGuideQuery") {
+}
 class CatalogItemsQueryDto extends createZodDto(CatalogItemsQuery, "CatalogItemsQuery") {
 }
 class CatalogNpmImportBody extends createZodDto(NpmBody, "CatalogNpmImportBody") {
@@ -62,6 +68,8 @@ class CatalogUpdatePreviewBodyDto extends createZodDto(CatalogUpdatePreviewBody,
 }
 class CatalogUpdateBodyDto extends createZodDto(CatalogUpdateBody, "CatalogUpdateBody") {
 }
+class AppearanceApplyBodyDto extends createZodDto(AppearanceApplyBody, "AppearanceApplyBody") {
+}
 /**
  * The platform catalog (`/api/v1/admin/catalog/*`, super admins): plugin import (upload / npm
  * prepare, then confirm, which installs the plugin's extension), the item list and detail, scope and
@@ -75,13 +83,19 @@ let AdminCatalogController = class AdminCatalogController {
     scope;
     updater;
     icons;
-    constructor(catalog, pluginImport, orgCatalog, scope, updater, icons) {
+    appearance;
+    clientBuilds;
+    guides;
+    constructor(catalog, pluginImport, orgCatalog, scope, updater, icons, appearance, clientBuilds, guides) {
         this.catalog = catalog;
         this.pluginImport = pluginImport;
         this.orgCatalog = orgCatalog;
         this.scope = scope;
         this.updater = updater;
         this.icons = icons;
+        this.appearance = appearance;
+        this.clientBuilds = clientBuilds;
+        this.guides = guides;
     }
     /**
      * Prepares the import of an uploaded plugin (an npm-pack tgz as the raw body,
@@ -175,12 +189,42 @@ let AdminCatalogController = class AdminCatalogController {
         return { ...page, items: page.items.map((i) => ({ ...i, icon: icons.get(i.id) ?? null })) };
     }
     /**
-     * 条目详情与各版本，另给出 `hasIcon`（最新版本有图标，`GET items/:id/icon` 可取）；不存在 → 404
-     * `catalog.item_not_found`。
+     * The item with its versions, plus `hasIcon` (the latest version has an icon, served by `GET
+     * items/:id/icon`) and `suggestedAppearance` (the platform version's, null without one: the page
+     * offers 应用此插件的外观 when set). Each version carries `client`: its extension package's
+     * client build (files with sizes, total, client API version; null without one), what the
+     * permission confirmation of an org's upload shows in its 客户端代码 group (client extensions spec
+     * §5.4). Unknown -> 404 `catalog.item_not_found`.
      */
     async get(id) {
         const detail = await this.catalog.get(id);
-        return { ...detail, hasIcon: await this.orgCatalog.hasIcon(id) };
+        const platform = detail.versions.find((v) => v.version === detail.item.platformVersion);
+        const [hasIcon, builds] = await Promise.all([
+            this.orgCatalog.hasIcon(id),
+            this.clientBuilds.summaries(detail.versions.flatMap((v) => (v.extensionSha256 === null ? [] : [v.extensionSha256]))),
+        ]);
+        return {
+            ...detail,
+            versions: detail.versions.map((v) => ({
+                ...v,
+                client: v.extensionSha256 === null ? null : (builds.get(v.extensionSha256) ?? null),
+            })),
+            hasIcon,
+            suggestedAppearance: suggestedAppearanceOf(platform?.manifest),
+        };
+    }
+    /**
+     * 应用此插件的外观 (client extensions spec §6.5): sets the plugin's suggested theme as the platform
+     * default theme and each suggested replacement as the platform arrangement's `use` of its slot, in
+     * one transaction. `dryRun: true` answers the same changes and writes nothing. A theme that cannot
+     * be the platform default -> 400 `theme.not_available` (nothing written); a replacement not
+     * available on the platform is skipped. No such item, or no suggestion -> 404
+     * `catalog.item_not_found`.
+     */
+    applyAppearance(principal, id, body) {
+        const actor = requireUser(principal);
+        const tokenId = patTokenId(actor);
+        return this.appearance.apply({ platform: true }, id, { accountId: actor.account.id, ...(tokenId !== undefined && { tokenId }) }, body.dryRun === true);
     }
     /**
      * The item's icon (disabled items included; same response headers as the org side, see
@@ -189,6 +233,15 @@ let AdminCatalogController = class AdminCatalogController {
     async icon(id, reply) {
         await sendCatalogIcon(reply, await this.orgCatalog.icon(id, true));
     }
+    /**
+     * A setup guide of the item as the platform sees it (spec 2026-11-09-setup-guides-v2-design.md
+     * §9.3; the admin console's connector template page): any live item, the admin audience, no org
+     * (`orgName` unresolved, reason `no_org`), no target, no checks run. Unknown item -> 404
+     * `catalog.item_not_found`, unknown guide -> 404 `catalog.guide_not_found`.
+     */
+    async guide(itemId, guideId, q) {
+        return { guide: await this.guides.renderForPlatform(itemId, guideId, q) };
+    }
     /**
      * What a scope change (`{ scope, orgs? }`, `orgs` only with `named`) or a disable
      * (`{ disabled: true }`) would take away: `{ affected: [{ orgId, orgName, agents,
@@ -326,11 +379,24 @@ __decorate([
     Get("items/:id"),
     __param(0, Param("id"))
 ], AdminCatalogController.prototype, "get", null);
+__decorate([
+    Post("items/:id/appearance"),
+    HttpCode(200),
+    __param(0, CurrentPrincipal()),
+    __param(1, Param("id")),
+    __param(2, ZBody(AppearanceApplyBodyDto))
+], AdminCatalogController.prototype, "applyAppearance", null);
 __decorate([
     Get("items/:id/icon"),
     __param(0, Param("id")),
     __param(1, Res())
 ], AdminCatalogController.prototype, "icon", null);
+__decorate([
+    Get(":itemId/guides/:guideId"),
+    __param(0, Param("itemId")),
+    __param(1, Param("guideId")),
+    __param(2, ZQuery(AdminCatalogGuideQueryDto))
+], AdminCatalogController.prototype, "guide", null);
 __decorate([
     Post("items/:id/scope/preview"),
     HttpCode(200),
@@ -395,6 +461,9 @@ AdminCatalogController = __decorate([
     __param(2, Inject(OrgCatalogService)),
     __param(3, Inject(CatalogScopeService)),
     __param(4, Inject(PlatformPluginUpdater)),
-    __param(5, Inject(PluginIcons))
+    __param(5, Inject(PluginIcons)),
+    __param(6, Inject(AppearanceService)),
+    __param(7, Inject(ClientBuilds)),
+    __param(8, Inject(PluginGuides))
 ], AdminCatalogController);
 export { AdminCatalogController };

package/dist/catalog/admin-catalog.schemas.d.ts

@@ -69,4 +69,14 @@ export declare const CatalogDisabledBody: z.ZodObject<{
 export declare const CatalogShownBody: z.ZodObject<{
     shownToOthers: z.ZodBoolean;
 }, z.core.$strict>;
+/**
+ * `GET :itemId/guides/:guideId`, the super admin's preview of a setup guide (spec
+ * 2026-11-09-setup-guides-v2-design.md §9.3): only the document language; no org, no target.
+ */
+export declare const AdminCatalogGuideQuery: z.ZodObject<{
+    locale: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        zh: "zh";
+    }>>;
+}, z.core.$strict>;
 export declare const ADMIN_CATALOG_ROUTES: readonly RouteSchemas[];

package/dist/catalog/admin-catalog.schemas.js

@@ -52,6 +52,13 @@ export const CatalogDisabledBody = z
     .object({ disabled: z.boolean(), scopeHash: CatalogHash.optional() })
     .strict();
 export const CatalogShownBody = z.object({ shownToOthers: z.boolean() }).strict();
+/**
+ * `GET :itemId/guides/:guideId`, the super admin's preview of a setup guide (spec
+ * 2026-11-09-setup-guides-v2-design.md §9.3): only the document language; no org, no target.
+ */
+export const AdminCatalogGuideQuery = z
+    .object({ locale: z.enum(["en", "zh"]).optional() })
+    .strict();
 export const ADMIN_CATALOG_ROUTES = [
     { route: "GET /api/v1/admin/catalog/items", query: CatalogItemsQuery },
     { route: "GET /api/v1/admin/catalog/items/:id", params: CatalogIdPathParams },

package/dist/catalog/appearance.schemas.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { RouteSchemas } from "../platform/route-schemas.js";
+/**
+ * The body of both "apply this plugin's appearance" routes (client extensions spec §6.5):
+ * `dryRun: true` answers what would change and writes nothing (the confirm dialog's preview).
+ */
+export declare const AppearanceApplyBody: z.ZodObject<{
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const APPEARANCE_ROUTES: readonly RouteSchemas[];

package/dist/catalog/appearance.schemas.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { CatalogIdPathParams } from "./admin-catalog.schemas.js";
+import { OrgExtensionParams } from "./org-extension.schemas.js";
+/**
+ * The body of both "apply this plugin's appearance" routes (client extensions spec §6.5):
+ * `dryRun: true` answers what would change and writes nothing (the confirm dialog's preview).
+ */
+export const AppearanceApplyBody = z.object({ dryRun: z.boolean().optional() }).strict();
+export const APPEARANCE_ROUTES = [
+    {
+        route: "POST /api/v1/admin/catalog/items/:id/appearance",
+        params: CatalogIdPathParams,
+        body: AppearanceApplyBody,
+    },
+    {
+        route: "POST /api/v1/orgs/:orgId/extensions/:extension/appearance",
+        params: OrgExtensionParams,
+        body: AppearanceApplyBody,
+    },
+];

package/dist/catalog/appearance.service.d.ts

@@ -0,0 +1,105 @@
+import { type SuggestedAppearance } from "@capybara-hq/plugin-sdk";
+import { ExtensionHost } from "../extensions/host.js";
+import { SettingsService } from "../identity/settings.js";
+import { SuperAdminLock } from "../identity/super-admin.js";
+import { KernelDb } from "../infra/database/kernel-db.js";
+import { TransactionHost } from "../infra/database/transaction-host.js";
+import { OrgLock } from "../orgs/org-lock.js";
+import { OrgSettingsService } from "../orgs/settings.service.js";
+/** Where the suggestion is applied: the platform defaults, or one org's. */
+export type AppearanceLevel = {
+    platform: true;
+} | {
+    orgId: string;
+};
+/** Why a replacement of the suggestion was left out (client extensions spec §6.5). */
+export type AppearanceSkipReason = "unknown-slot" | "not-available" | "not-eligible";
+/**
+ * What applying a suggestion changes at its level: the default theme (`from`: the theme in effect,
+ * null for none; `to`: the `platform_themes` id; null when the plugin suggests no theme or it is
+ * in effect already), each replacement slot's `use` (`to`: the contribution key
+ * `<extension>/<contribution>`; `from`: the key in effect, null for the built-in; a slot that
+ * already uses it is not listed) and what was skipped, in plugin.json order. At org level `from`
+ * is the org's own entry, else the platform's: `followsPlatform` says which (absent at platform
+ * level), and when the org follows a platform that already uses the suggestion nothing is pinned.
+ */
+export interface AppearanceResult {
+    theme: {
+        from: string | null;
+        to: string;
+        followsPlatform?: boolean;
+    } | null;
+    replacements: {
+        slot: string;
+        from: string | null;
+        to: string;
+        followsPlatform?: boolean;
+    }[];
+    skipped: {
+        what: string;
+        reason: AppearanceSkipReason;
+    }[];
+}
+/** Who applies it: the account, the PAT when one made the call, and extra audit detail. */
+export interface AppearanceActor {
+    accountId: string;
+    tokenId?: string;
+    /** Merged into the settings writer's audit detail (the Platform tool's `via: "agent"`). */
+    auditDetail?: Record<string, unknown>;
+}
+/** The suggestion of a plugin's catalog version, or null (none, or not an object). */
+export declare function suggestedAppearanceOf(manifest: unknown): SuggestedAppearance | null;
+/**
+ * "Apply this plugin's appearance" (client extensions spec §6.5): one step that sets the plugin's
+ * suggested theme as the level's default theme and each suggested replacement as the level's `use`
+ * of its single slot. The writes go through the settings writers (`SettingsService.update` for the
+ * platform, `OrgSettingsService.update` for an org), so their validation, theme checks, lock order
+ * (the level's lock, then catalog item, theme row, `uiTheme` row) and audit apply, both settings in
+ * one call and one transaction: a theme that cannot be set (`theme.not_available`) refuses the
+ * whole call; a replacement that cannot be used where it is set is skipped, never refused (the
+ * arrangement keeps unknown keys anyway). A dry run computes the same answer and writes nothing.
+ */
+export declare class AppearanceService {
+    private readonly db;
+    readonly txHost: TransactionHost;
+    private readonly settings;
+    private readonly orgSettings;
+    private readonly adminLock;
+    private readonly orgLock;
+    private readonly host;
+    constructor(db: KernelDb, txHost: TransactionHost, settings: SettingsService, orgSettings: OrgSettingsService, adminLock: SuperAdminLock, orgLock: OrgLock, host: ExtensionHost);
+    /**
+     * The suggestions of the live plugins named `names`, from the version their components come from
+     * (`platform_synced_version`, else the latest); a plugin without one maps to null.
+     */
+    suggestions(names: readonly string[]): Promise<Map<string, SuggestedAppearance | null>>;
+    /** The live catalog item `itemId` with its suggestion; else `catalog.item_not_found`. */
+    private platformItem;
+    /**
+     * The live plugin of extension `extension`, which must be on in the org, with its suggestion;
+     * else `extension.not_found`.
+     */
+    private orgItem;
+    /**
+     * Applies (or, with `dryRun`, previews) the suggestion of `item` at `level`: for the platform,
+     * `item` is the catalog item id (`POST /api/v1/admin/catalog/items/:id/appearance`, super
+     * admin); for an org, the extension name (`POST /api/v1/orgs/:orgId/extensions/:extension/
+     * appearance`, `org.update`). The writers re-check the actor under their lock.
+     */
+    apply(level: AppearanceLevel, item: string, actor: AppearanceActor, dryRun: boolean): Promise<AppearanceResult>;
+    /** Refuses (`theme.not_available`) a theme the level's writer would refuse; reads only. */
+    private assertThemeSettable;
+    private applyPlatform;
+    private applyOrg;
+    /**
+     * What applying `found` at `level` changes, from the stored settings (no writes): the level's
+     * own, and at org level the platform's it follows where it stores nothing.
+     */
+    private plan;
+}
+/**
+ * The suggested appearance action: its own module, since it writes through the org settings
+ * writer (`OrgsModule`, which imports `CatalogModule`) and the deployment settings writer.
+ */
+export declare class AppearanceModule {
+}