@webiny/mcp 6.0.0 → 6.1.0-beta.0

package/skills/local-development/SKILL.md

@@ -159,32 +159,6 @@ State files are JSON files that track the current state of your deployment:
 - Essential for managing environments and tracking changes
 - Stored in S3 by default
 
-## Build Parameters
-
-Pass custom config values from `webiny.config.tsx` to your extensions:
-
-```tsx
-// webiny.config.tsx
-<Api.BuildParam paramName="MY_PARAM" value="customValue" />
-<Api.BuildParam paramName="MY_CONFIG" value={{ myKey: 2, nested: { foo: "bar" } }} />
-<Admin.BuildParam paramName="ADMIN_PARAM" value="adminValue" />
-```
-
-Access in API extensions:
-
-```typescript
-import { BuildParams } from "webiny/api/build-params";
-
-class MyExtension implements SomeFactory.Interface {
-  constructor(private buildParams: BuildParams.Interface) {}
-
-  execute() {
-    const value = this.buildParams.get<string>("MY_PARAM");
-    const config = this.buildParams.get<{ myKey: number }>("MY_CONFIG");
-  }
-}
-```
-
 ## Debugging
 
 ### API Errors
@@ -250,5 +224,5 @@ After watch:      yarn webiny deploy api  (MUST redeploy!)
 
 ## Related Skills
 
-- `project-structure` -- Project layout and `webiny.config.tsx`
-- `infrastructure-extensions` -- Customizing AWS infrastructure and environments
+- `webiny-project-structure` -- Project layout and `webiny.config.tsx`
+- `webiny-infrastructure-extensions` -- Customizing AWS infrastructure and environments

package/skills/project-structure/SKILL.md

@@ -35,6 +35,7 @@ my-webiny-project/
 ```
 
 Key points:
+
 - **Single `package.json`** -- no monorepo, no workspaces needed.
 - **Single `tsconfig.json`** -- straightforward TypeScript setup.
 - **`webiny.config.tsx`** -- the entry point for everything. All extensions, infrastructure options, and project settings are declared here.
@@ -51,66 +52,66 @@ import { Admin, Api, Cli, Infra, Project, Security } from "webiny/extensions";
 import { Cognito } from "@webiny/cognito";
 
 export const Extensions = () => {
-    return (
-        <>
-            {/* Infrastructure configuration */}
-            <Infra.Aws.DefaultRegion name={"us-east-1"} />
-            <Infra.OpenSearch enabled={true} />
-            <Infra.Aws.Tags tags={{ OWNER: "me", PROJECT: "my-project" }} />
-
-            {/* Identity provider */}
-            <Cognito />
-
-            {/* API extensions (backend) */}
-            <Api.Extension src={"/extensions/ProductCategoryModel.ts"} />
-            <Api.Extension src={"/extensions/ProductModel.ts"} />
-            <Api.Extension src={"/extensions/contactSubmission/ContactSubmissionHook.ts"} />
-
-            {/* Security hooks */}
-            <Api.Extension src={"/extensions/MyApiKey.ts"} />
-            <Security.ApiKey.AfterUpdate src={"/extensions/MyApiKeyAfterUpdate.ts"} />
-
-            {/* Admin extensions (frontend) */}
-            <Admin.Extension src={"/extensions/AdminTheme/AdminTheme.tsx"} />
-            <Admin.Extension src={"/extensions/AdminTitleLogo/AdminTitleLogo.tsx"} />
-            <Admin.Extension src={"/extensions/contactSubmission/EmailEntryListColumn.tsx"} />
-
-            {/* Infrastructure / Pulumi extensions */}
-            <Infra.Core.Pulumi src={"/extensions/MyCorePulumiHandler.ts"} />
-
-            {/* CLI extensions */}
-            <Cli.Command src={"/extensions/MyCustomCommand.ts"} />
-
-            {/* Project settings */}
-            <Project.Telemetry enabled={false} />
-        </>
-    );
+  return (
+    <>
+      {/* Infrastructure configuration */}
+      <Infra.Aws.DefaultRegion name={"us-east-1"} />
+      <Infra.OpenSearch enabled={true} />
+      <Infra.Aws.Tags tags={{ OWNER: "me", PROJECT: "my-project" }} />
+
+      {/* Identity provider */}
+      <Cognito />
+
+      {/* API extensions (backend) */}
+      <Api.Extension src={"/extensions/ProductCategoryModel.ts"} />
+      <Api.Extension src={"/extensions/ProductModel.ts"} />
+      <Api.Extension src={"/extensions/contactSubmission/ContactSubmissionHook.ts"} />
+
+      {/* Security hooks */}
+      <Api.Extension src={"/extensions/MyApiKey.ts"} />
+      <Security.ApiKey.AfterUpdate src={"/extensions/MyApiKeyAfterUpdate.ts"} />
+
+      {/* Admin extensions (frontend) */}
+      <Admin.Extension src={"/extensions/AdminTheme/AdminTheme.tsx"} />
+      <Admin.Extension src={"/extensions/AdminTitleLogo/AdminTitleLogo.tsx"} />
+      <Admin.Extension src={"/extensions/contactSubmission/EmailEntryListColumn.tsx"} />
+
+      {/* Infrastructure / Pulumi extensions */}
+      <Infra.Core.Pulumi src={"/extensions/MyCorePulumiHandler.ts"} />
+
+      {/* CLI extensions */}
+      <Cli.Command src={"/extensions/MyCustomCommand.ts"} />
+
+      {/* Project settings */}
+      <Project.Telemetry enabled={false} />
+    </>
+  );
 };
 ```
 
 ## Extension Types
 
-| JSX Element | What It Does | File Type |
-|---|---|---|
-| `<Api.Extension src="..." />` | Registers a backend extension (GraphQL schemas, content models, lifecycle hooks) | `.ts` |
-| `<Admin.Extension src="..." />` | Registers a frontend Admin UI extension (themes, branding, custom columns, custom forms) | `.tsx` |
-| `<Infra.Core.Pulumi src="..." />` | Registers a Pulumi infrastructure handler | `.ts` |
-| `<Cli.Command src="..." />` | Registers a custom CLI command | `.ts` |
-| `<Security.ApiKey.AfterUpdate src="..." />` | Registers a security lifecycle hook | `.ts` |
+| JSX Element                                 | What It Does                                                                             | File Type |
+| ------------------------------------------- | ---------------------------------------------------------------------------------------- | --------- |
+| `<Api.Extension src="..." />`               | Registers a backend extension (GraphQL schemas, content models, lifecycle hooks)         | `.ts`     |
+| `<Admin.Extension src="..." />`             | Registers a frontend Admin UI extension (themes, branding, custom columns, custom forms) | `.tsx`    |
+| `<Infra.Core.Pulumi src="..." />`           | Registers a Pulumi infrastructure handler                                                | `.ts`     |
+| `<Cli.Command src="..." />`                 | Registers a custom CLI command                                                           | `.ts`     |
+| `<Security.ApiKey.AfterUpdate src="..." />` | Registers a security lifecycle hook                                                      | `.ts`     |
 
 ## Infrastructure Components
 
 Declarative components for configuring AWS infrastructure:
 
-| Component | Purpose |
-|---|---|
-| `<Infra.Aws.DefaultRegion name="us-east-1" />` | Set the AWS region |
-| `<Infra.Aws.Tags tags={{ KEY: "value" }} />` | Apply tags to all AWS resources |
-| `<Infra.OpenSearch enabled={true} />` | Enable/disable OpenSearch |
-| `<Infra.Vpc enabled={true} />` | Enable/disable VPC deployment |
-| `<Infra.PulumiResourceNamePrefix prefix="myproj-" />` | Prefix all Pulumi resource names |
+| Component                                                             | Purpose                                |
+| --------------------------------------------------------------------- | -------------------------------------- |
+| `<Infra.Aws.DefaultRegion name="us-east-1" />`                        | Set the AWS region                     |
+| `<Infra.Aws.Tags tags={{ KEY: "value" }} />`                          | Apply tags to all AWS resources        |
+| `<Infra.OpenSearch enabled={true} />`                                 | Enable/disable OpenSearch              |
+| `<Infra.Vpc enabled={true} />`                                        | Enable/disable VPC deployment          |
+| `<Infra.PulumiResourceNamePrefix prefix="myproj-" />`                 | Prefix all Pulumi resource names       |
 | `<Infra.ProductionEnvironments environments={["prod", "staging"]} />` | Define which envs use production infra |
-| `<Project.Telemetry enabled={false} />` | Enable/disable telemetry |
+| `<Project.Telemetry enabled={false} />`                               | Enable/disable telemetry               |
 
 ## Environment-Conditional Configuration
 
@@ -130,15 +131,35 @@ Use `<Infra.Env.Is>` to load extensions or config only in specific environments:
 
 ## Build Parameters
 
-Pass custom values from config to extensions at build time:
+Build parameters pass values from config to extensions at build time. They are accessed in backend code via the `BuildParams` DI service (see dependency-injection skill).
+
+**Rule: `<Api.BuildParam>` and `<Admin.BuildParam>` MUST live inside the extension's `Extension.tsx`, NOT directly in `webiny.config.tsx`.** Required parameters are exposed as React props on the extension component. The consumer in `webiny.config.tsx` decides where the value comes from (env var, hardcoded, config, etc.).
+
+```tsx
+// extensions/myExtension/Extension.tsx
+import React from "react";
+import { Api } from "webiny/extensions";
+
+interface MyExtensionProps {
+  apiKey: string;
+}
+
+export const MyExtension = ({ apiKey }: MyExtensionProps) => {
+  return (
+    <>
+      <Api.BuildParam paramName="MY_API_KEY" value={apiKey} />
+      <Api.Extension src={"@/extensions/myExtension/features/myService/feature.ts"} />
+    </>
+  );
+};
+```
 
 ```tsx
-<Api.BuildParam paramName="MY_CUSTOM_PARAM" value="customValue" />
-<Api.BuildParam paramName="MY_CONFIG" value={{ myKey: 2, nested: { foo: "bar" } }} />
-<Admin.BuildParam paramName="ADMIN_CUSTOM_PARAM" value="adminValue" />
+// webiny.config.tsx — consumer decides where the value comes from
+<MyExtension apiKey={process.env.MY_API_KEY || ""} />
 ```
 
-These are accessed in extensions via the `BuildParams` feature (see dependency-injection skill).
+This keeps extensions self-contained — all required configuration is declared via typed props in one place.
 
 ## Installing Pre-Built Extensions
 
@@ -152,5 +173,6 @@ This downloads the extension code into `extensions/`, updates `webiny.config.tsx
 
 ## Related Skills
 
-- `dependency-injection` -- How extensions use DI to access services
-- `local-development` -- How to deploy and develop locally
+- `webiny-dependency-injection` -- How extensions use DI to access services
+- `webiny-local-development` -- How to deploy and develop locally
+- `webiny-full-stack-architect` -- Full-stack extension skeleton, entry points, and shared domain layer

package/skills/webiny-sdk/SKILL.md

@@ -29,9 +29,9 @@ Initialize once and reuse:
 import { Sdk } from "@webiny/sdk";
 
 export const sdk = new Sdk({
-    token: process.env.WEBINY_API_TOKEN!,
-    endpoint: process.env.WEBINY_API_ENDPOINT!,
-    tenant: process.env.WEBINY_API_TENANT || "root"
+  token: process.env.WEBINY_API_TOKEN!,
+  endpoint: process.env.WEBINY_API_ENDPOINT!,
+  tenant: process.env.WEBINY_API_TENANT || "root"
 });
 ```
 
@@ -43,13 +43,14 @@ export const sdk = new Sdk({
 
 Webiny provides three separate GraphQL APIs:
 
-| API | URL Path | Returns | Can Write | Use For |
-|---|---|---|---|---|
-| **Read** | `/cms/read` | Published entries only | No | Public-facing apps, SSG |
-| **Manage** | `/cms/manage` | All revisions (drafts + published) | Yes | Admin tools, content creation |
-| **Preview** | `/cms/preview` | Latest revisions (drafts + published) | No | Content preview |
+| API         | URL Path       | Returns                               | Can Write | Use For                       |
+| ----------- | -------------- | ------------------------------------- | --------- | ----------------------------- |
+| **Read**    | `/cms/read`    | Published entries only                | No        | Public-facing apps, SSG       |
+| **Manage**  | `/cms/manage`  | All revisions (drafts + published)    | Yes       | Admin tools, content creation |
+| **Preview** | `/cms/preview` | Latest revisions (drafts + published) | No        | Content preview               |
 
 The SDK automatically routes to the correct API based on the method:
+
 - `listEntries`, `getEntry` -> Read API
 - `createEntry`, `updateEntry`, `publishEntry`, `unpublishEntry` -> Manage API
 
@@ -61,9 +62,9 @@ Every SDK method returns a `Result` object -- it never throws:
 const result = await sdk.cms.listEntries({ modelId: "product", fields: ["id"] });
 
 if (result.isOk()) {
-    console.log(result.value.data);    // success -- typed data
+  console.log(result.value.data); // success -- typed data
 } else {
-    console.error(result.error.message); // failure -- error info
+  console.error(result.error.message); // failure -- error info
 }
 ```
 
@@ -75,26 +76,26 @@ Pass a type parameter for full type safety on `values`:
 import type { CmsEntryData } from "@webiny/sdk";
 
 interface Product {
-    name: string;
-    price: number;
-    sku: string;
-    description: string;
-    category?: CmsEntryData<ProductCategory>;
+  name: string;
+  price: number;
+  sku: string;
+  description: string;
+  category?: CmsEntryData<ProductCategory>;
 }
 
 interface ProductCategory {
-    name: string;
-    slug: string;
+  name: string;
+  slug: string;
 }
 
 const result = await sdk.cms.listEntries<Product>({
-    modelId: "product"
+  modelId: "product"
 });
 
 if (result.isOk()) {
-    // result.value.data is CmsEntryData<Product>[]
-    const products = result.value.data;
-    // products[0].values.name -- fully typed
+  // result.value.data is CmsEntryData<Product>[]
+  const products = result.value.data;
+  // products[0].values.name -- fully typed
 }
 ```
 
@@ -106,9 +107,9 @@ Reference fields like `category` are typed as `CmsEntryData<T>`, which wraps ref
 
 ```typescript
 const result = await sdk.cms.listEntries<Product>({
-    modelId: "product",
-    sort: ["values.name_ASC"],
-    limit: 10
+  modelId: "product",
+  sort: ["values.name_ASC"],
+  limit: 10
 });
 ```
 
@@ -116,43 +117,43 @@ const result = await sdk.cms.listEntries<Product>({
 
 ```typescript
 const result = await sdk.cms.listEntries<Product>({
-    modelId: "product",
-    where: {
-        "values.price_gte": 100,
-        "values.name_contains": "Pro"
-    },
-    sort: ["values.price_DESC"]
+  modelId: "product",
+  where: {
+    "values.price_gte": 100,
+    "values.name_contains": "Pro"
+  },
+  sort: ["values.price_DESC"]
 });
 ```
 
 ### Filter Operators
 
-| Operator | Description | Example |
-|---|---|---|
-| `_eq` | Equals (default) | `"values.status": "active"` |
-| `_not` | Not equals | `"values.status_not": "archived"` |
-| `_contains` | Contains substring | `"values.name_contains": "Pro"` |
-| `_startsWith` | Starts with | `"values.name_startsWith": "Web"` |
-| `_gt` / `_gte` | Greater than / >= | `"values.price_gte": 100` |
-| `_lt` / `_lte` | Less than / <= | `"values.price_lt": 500` |
-| `_in` | In array | `"values.status_in": ["active", "featured"]` |
+| Operator       | Description        | Example                                      |
+| -------------- | ------------------ | -------------------------------------------- |
+| `_eq`          | Equals (default)   | `"values.status": "active"`                  |
+| `_not`         | Not equals         | `"values.status_not": "archived"`            |
+| `_contains`    | Contains substring | `"values.name_contains": "Pro"`              |
+| `_startsWith`  | Starts with        | `"values.name_startsWith": "Web"`            |
+| `_gt` / `_gte` | Greater than / >=  | `"values.price_gte": 100`                    |
+| `_lt` / `_lte` | Less than / <=     | `"values.price_lt": 500`                     |
+| `_in`          | In array           | `"values.status_in": ["active", "featured"]` |
 
 ### Sort Format
 
 Sort strings follow the pattern `values.<fieldId>_ASC` or `values.<fieldId>_DESC`:
 
 ```typescript
-sort: ["values.name_ASC"]          // alphabetical
-sort: ["values.price_DESC"]         // highest price first
-sort: ["values.createdOn_DESC"]     // newest first
+sort: ["values.name_ASC"]; // alphabetical
+sort: ["values.price_DESC"]; // highest price first
+sort: ["values.createdOn_DESC"]; // newest first
 ```
 
 ### Get Single Entry
 
 ```typescript
 const result = await sdk.cms.getEntry<Product>({
-    modelId: "product",
-    id: "abc123#0001"
+  modelId: "product",
+  id: "abc123#0001"
 });
 ```
 
@@ -162,8 +163,8 @@ Control which fields are returned:
 
 ```typescript
 const result = await sdk.cms.listEntries<Product>({
-    modelId: "product",
-    fields: ["id", "values.name", "values.price"]
+  modelId: "product",
+  fields: ["id", "values.name", "values.price"]
 });
 ```
 
@@ -175,12 +176,12 @@ When omitted, all fields are returned. The `depth` parameter (default: `1`) cont
 
 ```typescript
 const result = await sdk.cms.createEntry({
-    modelId: "contactSubmission",
-    data: {
-        name: "John Doe",
-        email: "john@example.com",
-        message: "Hello from the contact form!"
-    }
+  modelId: "contactSubmission",
+  data: {
+    name: "John Doe",
+    email: "john@example.com",
+    message: "Hello from the contact form!"
+  }
 });
 ```
 
@@ -188,11 +189,11 @@ const result = await sdk.cms.createEntry({
 
 ```typescript
 const result = await sdk.cms.updateEntry({
-    modelId: "product",
-    id: "abc123#0001",
-    data: {
-        price: 29.99
-    }
+  modelId: "product",
+  id: "abc123#0001",
+  data: {
+    price: 29.99
+  }
 });
 ```
 
@@ -222,21 +223,21 @@ For programmatic access, create API keys as an extension:
 import { ApiKeyFactory } from "webiny/api/security";
 
 class MyApiKeyImpl implements ApiKeyFactory.Interface {
-    execute(): ApiKeyFactory.Return {
-        return [
-            {
-                name: "Universal API Key",
-                slug: "universal-key",
-                token: "wat_12345678",
-                permissions: [{ name: "*" }]
-            }
-        ];
-    }
+  execute(): ApiKeyFactory.Return {
+    return [
+      {
+        name: "Universal API Key",
+        slug: "universal-key",
+        token: "wat_12345678",
+        permissions: [{ name: "*" }]
+      }
+    ];
+  }
 }
 
 export default ApiKeyFactory.createImplementation({
-    implementation: MyApiKeyImpl,
-    dependencies: []
+  implementation: MyApiKeyImpl,
+  dependencies: []
 });
 ```
 
@@ -248,11 +249,11 @@ Register:
 
 ## SDK Modules Reference
 
-| Module | Webiny App | What You Can Do |
-|---|---|---|
-| `sdk.cms` | Headless CMS | List, get, create, update, publish, unpublish entries |
-| `sdk.fileManager` | File Manager | List, upload, and manage files and folders |
-| `sdk.websiteBuilder` | Website Builder | List and retrieve website builder content |
+| Module               | Webiny App      | What You Can Do                                       |
+| -------------------- | --------------- | ----------------------------------------------------- |
+| `sdk.cms`            | Headless CMS    | List, get, create, update, publish, unpublish entries |
+| `sdk.fileManager`    | File Manager    | List, upload, and manage files and folders            |
+| `sdk.websiteBuilder` | Website Builder | List and retrieve website builder content             |
 
 ## Quick Reference
 
@@ -267,5 +268,5 @@ API endpoint:   yarn webiny info (in your Webiny project)
 
 ## Related Skills
 
-- `content-models` -- Define the models you query with the SDK
-- `website-builder` -- Use the SDK inside Website Builder components to fetch CMS data
+- `webiny-api-cms-content-models` -- Define the models you query with the SDK
+- `webiny-website-builder` -- Use the SDK inside Website Builder components to fetch CMS data