@webiny/mcp 6.2.0 → 6.3.0-beta.1

package/skills/generated/admin/SKILL.md

@@ -2,7 +2,7 @@
 name: webiny-admin-catalog
 context: webiny-api
 description: >
-  admin — 16 abstractions.
+  admin — 19 abstractions.
 ---
 
 # admin
@@ -101,6 +101,21 @@ is automatically removed from DevTools.
 **Import:** `import { Routes } from "webiny/admin"`
 **Source:** `@webiny/app-admin/routes.ts`
 
+---
+**Name:** `Tool`
+**Import:** `import { Tool } from "webiny/admin"`
+**Source:** `@webiny/app-admin/features/tools/index.ts`
+
+---
+**Name:** `ToolPipelineRunner`
+**Import:** `import { ToolPipelineRunner } from "webiny/admin"`
+**Source:** `@webiny/app-admin/features/tools/index.ts`
+
+---
+**Name:** `ToolsFeature`
+**Import:** `import { ToolsFeature } from "webiny/admin"`
+**Source:** `@webiny/app-admin/features/tools/index.ts`
+
 ---
 **Name:** `useFeature`
 **Import:** `import { useFeature } from "webiny/admin"`

package/skills/generated/api/SKILL.md

@@ -2,7 +2,7 @@
 name: webiny-api-catalog
 context: webiny-api
 description: >
-  api — 14 abstractions.
+  api — 21 abstractions.
 ---
 
 # api
@@ -15,6 +15,30 @@ description: >
 
 ## Abstractions
 
+---
+**Name:** `Ai`
+**Import:** `import { Ai } from "webiny/api"`
+**Source:** `@webiny/api-core/features/ai/index.ts`
+**Description:** Interact with AI language models using registered providers.
+
+---
+**Name:** `AiConnectionFactory`
+**Import:** `import { AiConnectionFactory } from "webiny/api"`
+**Source:** `@webiny/api-core/features/ai/index.ts`
+**Description:** Factory that asynchronously produces an AiConnection.
+
+---
+**Name:** `AiSdk`
+**Import:** `import { AiSdk } from "webiny/api"`
+**Source:** `@webiny/api-core/features/ai/index.ts`
+**Description:** A single AI SDK instance (e.g. OpenAI, Anthropic) that resolves model instances.
+
+---
+**Name:** `AiSdkFactory`
+**Import:** `import { AiSdkFactory } from "webiny/api"`
+**Source:** `@webiny/api-core/features/ai/index.ts`
+**Description:** Factory that asynchronously initialises an AI SDK. Register one per provider namespace.
+
 ---
 **Name:** `BaseError`
 **Import:** `import { BaseError } from "webiny/api"`
@@ -58,6 +82,12 @@ description: >
 **Source:** `@webiny/api-core/features/eventPublisher/index.ts`
 **Description:** Base class for all domain events.
 
+---
+**Name:** `Encryption`
+**Import:** `import { Encryption } from "webiny/api"`
+**Source:** `@webiny/api-core/features/encryption/index.ts`
+**Description:** Symmetric encryption and decryption using a configured secret key.
+
 ---
 **Name:** `EventPublisher`
 **Import:** `import { EventPublisher } from "webiny/api"`
@@ -70,6 +100,18 @@ description: >
 **Source:** `@webiny/api-core/features/keyValueStore/index.ts`
 **Description:** Global (non-tenant-scoped) key-value store.
 
+---
+**Name:** `IAiConnection`
+**Kind:** type
+**Import:** `import type { IAiConnection } from "webiny/api"`
+**Source:** `@webiny/api-core/features/ai/index.ts`
+
+---
+**Name:** `IAiConnectionInline`
+**Kind:** type
+**Import:** `import type { IAiConnectionInline } from "webiny/api"`
+**Source:** `@webiny/api-core/features/ai/index.ts`
+
 ---
 **Name:** `KeyValueStore`
 **Import:** `import { KeyValueStore } from "webiny/api"`

package/skills/webiny-sdk/SKILL.md

@@ -6,9 +6,10 @@ description: >
   Use this skill when the developer is building a Next.js, Vue, Node.js, or any external app
   that needs to fetch or write content to Webiny, set up the SDK, use the Result pattern,
   list/get/create/update/publish entries, filter and sort queries, use TypeScript generics
-  for type safety, work with the File Manager, list languages, or create API keys programmatically.
+  for type safety, work with the File Manager, list languages, trigger or monitor background tasks,
+  or create API keys programmatically.
   Covers read vs preview mode, the `values` wrapper requirement, correct method names,
-  and the `fields` required parameter.
+  the `fields` required parameter, and background task management via `sdk.tasks`.
 ---
 
 # Webiny SDK
@@ -291,8 +292,8 @@ The `Language` type:
 ```typescript
 interface Language {
   id: string;
-  code: string;        // e.g. "en-US"
-  name: string;        // e.g. "English (US)"
+  code: string; // e.g. "en-US"
+  name: string; // e.g. "English (US)"
   direction?: "ltr" | "rtl";
   isDefault?: boolean;
 }
@@ -344,40 +345,158 @@ Register (**YOU MUST include the `.ts` file extension in the `src` prop** — om
 <Api.Extension src={"/extensions/MyApiKey.ts"} />
 ```
 
+## Background Tasks
+
+`webiny.tasks` wraps the Background Tasks GraphQL API. All methods return a `Result` and never throw.
+
+### List Task Definitions
+
+Returns all registered task definitions — use this to discover valid `definition` IDs before triggering.
+
+```typescript
+const result = await webiny.tasks.listDefinitions();
+
+if (result.isOk()) {
+  // result.value: TaskDefinition[]
+  for (const def of result.value) {
+    console.log(def.id, def.title, def.description);
+  }
+}
+```
+
+### List Task Runs
+
+```typescript
+const result = await webiny.tasks.listTasks();
+
+if (result.isOk()) {
+  // result.value: TaskRun[]
+  for (const task of result.value) {
+    console.log(task.id, task.taskStatus, task.definitionId);
+  }
+}
+```
+
+### List Task Logs
+
+Optionally filter by a specific task run ID:
+
+```typescript
+// All logs
+const result = await webiny.tasks.listLogs();
+
+// Logs for a specific task run
+const result = await webiny.tasks.listLogs({
+  where: { task: "yourTaskRunId" }
+});
+
+if (result.isOk()) {
+  for (const log of result.value) {
+    for (const item of log.items) {
+      console.log(`[${item.type}] ${item.message}`);
+    }
+  }
+}
+```
+
+### Trigger a Task
+
+```typescript
+const result = await webiny.tasks.triggerTask({
+  definition: "myTaskDefinitionId",
+  input: {
+    someVariable: "someValue",
+    anotherVariable: 42
+  }
+});
+
+if (result.isOk()) {
+  const task = result.value; // TaskRun
+  console.log(task.id, task.taskStatus, task.executionName);
+}
+```
+
+### Abort a Task
+
+The task stops at its next safe checkpoint.
+
+```typescript
+const result = await webiny.tasks.abortTask({
+  id: "yourTaskRunId",
+  message: "Stopped by user request" // optional
+});
+
+if (result.isOk()) {
+  console.log(result.value.taskStatus); // "aborted"
+}
+```
+
+### Background Task Types
+
+```typescript
+import type { TaskDefinition, TaskRun, TaskLog, TaskLogItem, TaskStatus } from "@webiny/sdk";
+
+type TaskStatus = "pending" | "running" | "completed" | "failed" | "aborted" | "stopped";
+
+interface TaskDefinition {
+  id: string;
+  title: string;
+  description?: string;
+}
+
+interface TaskRun {
+  id: string;
+  definitionId: string;
+  taskStatus: TaskStatus;
+  input?: unknown;
+  output?: unknown;
+  startedOn?: string;
+  finishedOn?: string;
+  executionName?: string;
+  iterations?: number;
+  parentId?: string;
+}
+```
+
 ## SDK Modules Reference
 
-| Module                 | Webiny App    | What You Can Do                                                       |
-| ---------------------- | ------------- | --------------------------------------------------------------------- |
-| `webiny.cms`           | Headless CMS  | List, get, create, update, publish, unpublish, delete entry revisions |
-| `webiny.fileManager`   | File Manager  | List, upload, and manage files and folders                            |
-| `webiny.tenantManager` | Multi-tenancy | Create, install, enable, disable tenants                              |
-| `webiny.languages`     | Languages     | List enabled languages (id, code, name, direction, isDefault)         |
+| Module                 | Webiny App       | What You Can Do                                                       |
+| ---------------------- | ---------------- | --------------------------------------------------------------------- |
+| `webiny.cms`           | Headless CMS     | List, get, create, update, publish, unpublish, delete entry revisions |
+| `webiny.fileManager`   | File Manager     | List, upload, and manage files and folders                            |
+| `webiny.tenantManager` | Multi-tenancy    | Create, install, enable, disable tenants                              |
+| `webiny.languages`     | Languages        | List enabled languages (id, code, name, direction, isDefault)         |
+| `webiny.tasks`         | Background Tasks | Trigger, abort, list task runs, definitions, and logs                 |
 
 ## Common Mistakes
 
-| Mistake                     | Correct                                 |
-| --------------------------- | --------------------------------------- |
-| `data: { name: "..." }`     | `data: { values: { name: "..." } }`     |
-| `updateEntry(...)`          | `updateEntryRevision(...)`              |
-| `publishEntry(...)`         | `publishEntryRevision(...)`             |
-| `unpublishEntry(...)`       | `unpublishEntryRevision(...)`           |
-| `sort: ["values.name_ASC"]` | `sort: { "values.name": "asc" }`        |
-| `getEntry({ id: "..." })`   | `getEntry({ where: { id: "..." } })`    |
-| Omitting `fields`           | Always provide `fields: [...]`          |
-| Trailing slash in endpoint  | Remove trailing slash from endpoint URL |
+| Mistake                                        | Correct                                                                                                               |
+| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `data: { name: "..." }`                        | `data: { values: { name: "..." } }`                                                                                   |
+| `updateEntry(...)`                             | `updateEntryRevision(...)`                                                                                            |
+| `publishEntry(...)`                            | `publishEntryRevision(...)`                                                                                           |
+| `unpublishEntry(...)`                          | `unpublishEntryRevision(...)`                                                                                         |
+| `sort: ["values.name_ASC"]`                    | `sort: { "values.name": "asc" }`                                                                                      |
+| `getEntry({ id: "..." })`                      | `getEntry({ where: { id: "..." } })`                                                                                  |
+| Omitting `fields`                              | Always provide `fields: [...]`                                                                                        |
+| Trailing slash in endpoint                     | Remove trailing slash from endpoint URL                                                                               |
+| `triggerTask` with unknown `definition` string | Use an ID returned by `listDefinitions()` — the GQL schema validates it against `WebinyBackgroundTaskDefinitionEnum!` |
 
 ## Quick Reference
 
 ```
-Install:          npm install @webiny/sdk
-Import:           import { Webiny } from "@webiny/sdk";
-Type import:      import type { CmsEntryData } from "@webiny/sdk";
-Initialize:       new Webiny({ token, endpoint, tenant })
-Result check:     result.isOk() -> result.value.data / result.error.message
-API endpoint:     yarn webiny info (in your Webiny project) -- NO trailing slash
-Preview mode:     pass preview: true to listEntries / getEntry
-fields required:  every method needs a fields: string[] array
-values wrapper:   createEntry/updateEntryRevision data must use { values: { ... } }
+Install:              npm install @webiny/sdk
+Import:               import { Webiny } from "@webiny/sdk";
+Type import:          import type { CmsEntryData, TaskRun } from "@webiny/sdk";
+Initialize:           new Webiny({ token, endpoint, tenant })
+Result check:         result.isOk() -> result.value / result.error.message
+API endpoint:         yarn webiny info (in your Webiny project) -- NO trailing slash
+Preview mode:         pass preview: true to listEntries / getEntry
+fields required:      every CMS method needs a fields: string[] array
+values wrapper:       createEntry/updateEntryRevision data must use { values: { ... } }
+Background tasks:     webiny.tasks.triggerTask({ definition, input })
+Abort task:           webiny.tasks.abortTask({ id, message? })
+Filter logs by task:  webiny.tasks.listLogs({ where: { task: "id" } })
 ```
 
 ## Related Skills

package/skills/website-builder/SKILL.md

@@ -341,7 +341,11 @@ createComponent(ProductListing, {
   name: "Custom/ProductListing",
   label: "Product Listing",
   inputs: [
-    createTextInput({ name: "heading", label: "Section Heading", defaultValue: "Our Products" }),
+    createTextInput({
+      name: "heading",
+      label: "Section Heading",
+      defaultValue: "Our Products"
+    }),
     createTextInput({ name: "limit", label: "Number of products", defaultValue: "6" })
   ]
 });