@frontmcp/skills 1.0.0-beta.12 → 1.0.0-beta.13

package/catalog/frontmcp-development/references/create-tool.md

@@ -209,6 +209,26 @@ async execute(input: { data: string }) {
 
 ## Error Handling
 
+**Do NOT wrap `execute()` in try/catch.** The framework's tool execution flow automatically catches exceptions, formats error responses, and triggers error hooks. Only use `this.fail(err)` for **business-logic errors** (validation failures, not-found, permission denied). Let infrastructure errors (network, database) propagate naturally.
+
+```typescript
+// WRONG — never do this:
+async execute(input) {
+  try {
+    const result = await someOperation();
+    return result;
+  } catch (err) {
+    this.fail(err instanceof Error ? err : new Error(String(err)));
+  }
+}
+
+// CORRECT — let the framework handle errors:
+async execute(input) {
+  const result = await someOperation(); // errors propagate to framework
+  return result;
+}
+```
+
 Use `this.fail(err)` to abort execution and trigger the error flow. The method throws internally and never returns.
 
 ```typescript

package/catalog/frontmcp-guides/references/example-task-manager.md

@@ -309,21 +309,18 @@ export class UpdateTaskTool extends ToolContext {
       this.fail(new Error('Authentication required'));
     }
 
-    try {
-      const updated = await store.update(input.id, userId, {
-        ...(input.status && { status: input.status }),
-        ...(input.priority && { priority: input.priority }),
-      });
-
-      return {
-        id: updated.id,
-        title: updated.title,
-        priority: updated.priority,
-        status: updated.status,
-      };
-    } catch (err) {
-      this.fail(new Error(`Failed to update task: ${String(err)}`));
-    }
+    // No try/catch needed — the framework handles errors in the tool execution flow.
+    const updated = await store.update(input.id, userId, {
+      ...(input.status && { status: input.status }),
+      ...(input.priority && { priority: input.priority }),
+    });
+
+    return {
+      id: updated.id,
+      title: updated.title,
+      priority: updated.priority,
+      status: updated.status,
+    };
   }
 }
 ```
@@ -358,12 +355,9 @@ export class DeleteTaskTool extends ToolContext {
       this.fail(new Error('Authentication required'));
     }
 
-    try {
-      await store.delete(input.id, userId);
-      return { deleted: true, id: input.id };
-    } catch (err) {
-      this.fail(new Error(`Failed to delete task: ${String(err)}`));
-    }
+    // No try/catch needed — the framework handles errors in the tool execution flow.
+    await store.delete(input.id, userId);
+    return { deleted: true, id: input.id };
   }
 }
 ```

package/catalog/frontmcp-guides/references/example-weather-api.md

@@ -99,12 +99,9 @@ export class GetWeatherTool extends ToolContext {
   async execute(input: { city: string; units: 'celsius' | 'fahrenheit' }) {
     const url = `https://api.weather.example.com/v1/current?city=${encodeURIComponent(input.city)}&units=${input.units}`;
 
-    let response: Response;
-    try {
-      response = await this.fetch(url);
-    } catch (err) {
-      this.fail(new Error(`Weather API unreachable: ${String(err)}`));
-    }
+    // No try/catch needed — the framework's tool execution flow handles errors automatically.
+    // Use this.fail() only for business-logic errors (e.g., invalid response).
+    const response = await this.fetch(url);
 
     if (!response.ok) {
       this.fail(new Error(`Weather API error: ${response.status} ${response.statusText}`));

package/catalog/frontmcp-testing/references/setup-testing.md

@@ -316,6 +316,8 @@ test('prompts return well-formed messages', async ({ mcp }) => {
 
 For more control, use `McpTestClient` and `TestServer` directly:
 
+> **Note:** `npx tsx src/main.ts` is correct **only inside E2E tests** (the test framework uses it internally via `resolveServerCommand`). For development and running the server outside of tests, always use `frontmcp dev` (or your package.json `dev` script). Never run `npx tsx src/main.ts` directly for development.
+
 ```typescript
 // advanced.e2e.spec.ts
 import { McpTestClient, TestServer } from '@frontmcp/testing';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/skills",
-  "version": "1.0.0-beta.12",
+  "version": "1.0.0-beta.13",
   "description": "Curated skills catalog for FrontMCP projects",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",