@kvasar/openclaw-storyblok-plugin 0.1.8 → 0.1.10

package/index.ts

@@ -11,7 +11,7 @@ import { Type } from "@sinclair/typebox";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 
 import { StoryblokClient, type StoryblokConfig } from "./src/client.js";
-import { validateConfig, redactTokens } from "./src/config.js";
+import { redactTokens } from "./src/config.js";
 
 interface StoryblokPluginConfig {
   baseUrl?: string;
@@ -31,28 +31,6 @@ interface OpenClawPluginApi {
   }): void;
 }
 
-interface CreateStoryParams {
-  title: string;
-  slug?: string;
-  folder_id?: number;
-  parent_id?: number;
-  content?: Record<string, any>;
-  tags?: string[];
-  is_folder?: boolean;
-  language?: string;
-}
-
-interface UpdateStoryParams {
-  story_id: string;
-  title?: string;
-  slug?: string;
-  content?: Record<string, any>;
-  parent_id?: number;
-  tags?: string[];
-  language?: string;
-  version?: string;
-}
-
 function ok(data: unknown) {
   return {
     content: [
@@ -77,12 +55,6 @@ function fail(error: unknown) {
   };
 }
 
-function safeError(error: unknown, cfg: StoryblokPluginConfig) {
-  return fail(
-    redactTokens(String((error as any)?.message ?? error), cfg)
-  );
-}
-
 export default definePluginEntry({
   id: "openclaw-storyblok",
   name: "Storyblok Integration",
@@ -90,54 +62,56 @@ export default definePluginEntry({
     "Interact with Storyblok CMS: manage stories, components, and space information.",
 
   register(api: OpenClawPluginApi) {
-    const rawCfg = (
-      api.pluginConfig ??
-      api.config ??
-      {}
-    ) as StoryblokPluginConfig;
-
-    const cfg: StoryblokPluginConfig = {
-      baseUrl: rawCfg.baseUrl ?? "https://api.storyblok.com",
-      spaceId: rawCfg.spaceId,
-      managementToken: rawCfg.managementToken,
-      previewToken: rawCfg.previewToken,
-    };
-
-    try {
-      validateConfig(cfg);
-    } catch (error) {
-      console.warn(
-        "[openclaw-storyblok] Config validation warning:",
-        error
-      );
+    function resolveClient() {
+      const rawCfg = (api.pluginConfig ?? api.config ?? {}) as StoryblokPluginConfig;
+
+      const cfg: StoryblokPluginConfig = {
+        baseUrl: rawCfg.baseUrl ?? "https://api.storyblok.com",
+        spaceId: rawCfg.spaceId,
+        managementToken: rawCfg.managementToken,
+        previewToken: rawCfg.previewToken,
+      };
+
+      const clientCfg: StoryblokConfig = {
+        baseUrl: cfg.baseUrl!,
+        spaceId: cfg.spaceId ?? "",
+        managementToken: cfg.managementToken ?? "",
+        previewToken: cfg.previewToken,
+      };
+
+      return {
+        client: new StoryblokClient(clientCfg),
+        cfg,
+      };
     }
 
-    const clientCfg: StoryblokConfig = {
-      baseUrl: cfg.baseUrl ?? "https://api.storyblok.com",
-      spaceId: cfg.spaceId ?? "",
-      managementToken: cfg.managementToken ?? "",
-      previewToken: cfg.previewToken,
-    };
-
-    const client = new StoryblokClient(clientCfg);
+    async function executeSafely<T>(
+      handler: (client: StoryblokClient, params?: T) => Promise<unknown>,
+      params?: T
+    ) {
+      const { client, cfg } = resolveClient();
+
+      try {
+        return ok(await handler(client, params));
+      } catch (error) {
+        return fail(
+          redactTokens(String((error as any)?.message ?? error), cfg)
+        );
+      }
+    }
 
     api.registerTool({
       name: "storyblok_get_space",
       description: "Retrieve Storyblok space details.",
       parameters: Type.Object({}),
-      async execute() {
-        try {
-          return ok(await client.getSpace());
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute() {
+        return executeSafely((client) => client.getSpace());
       },
     });
 
     api.registerTool({
       name: "storyblok_get_story",
-      description:
-        "Retrieve a story by ID, UUID, or slug.",
+      description: "Retrieve a story by ID, UUID, or slug.",
       parameters: Type.Object({
         identifier: Type.String({
           description: "Story ID, UUID, or slug",
@@ -150,26 +124,15 @@ export default definePluginEntry({
         language: Type.Optional(Type.String()),
         svg_render: Type.Optional(Type.Boolean()),
       }),
-      async execute(
-        _id: string | undefined,
-        params: {
-          identifier: string;
-          version?: string;
-          language?: string;
-          svg_render?: boolean;
-        }
-      ) {
-        try {
-          return ok(
-            await client.getStory(params.identifier, {
-              version: params.version,
-              language: params.language,
-              svg_render: params.svg_render,
-            })
-          );
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p: any) =>
+          client.getStory(p.identifier, {
+            version: p.version,
+            language: p.language,
+            svg_render: p.svg_render,
+          }),
+          params
+        );
       },
     });
 
@@ -186,12 +149,8 @@ export default definePluginEntry({
         sort_by: Type.Optional(Type.String()),
         direction: Type.Optional(Type.String()),
       }),
-      async execute(_id: string | undefined, params: Record<string, any>) {
-        try {
-          return ok(await client.listStories(params));
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p) => client.listStories(p), params);
       },
     });
 
@@ -203,19 +162,13 @@ export default definePluginEntry({
         slug: Type.Optional(Type.String()),
         folder_id: Type.Optional(Type.Number()),
         parent_id: Type.Optional(Type.Number()),
-        content: Type.Optional(
-          Type.Record(Type.String(), Type.Any())
-        ),
+        content: Type.Optional(Type.Record(Type.String(), Type.Any())),
         tags: Type.Optional(Type.Array(Type.String())),
         is_folder: Type.Optional(Type.Boolean()),
         language: Type.Optional(Type.String()),
       }),
-      async execute(_id: string | undefined, params: CreateStoryParams) {
-        try {
-          return ok(await client.createStory(params));
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p) => client.createStory(p), params);
       },
     });
 
@@ -226,26 +179,17 @@ export default definePluginEntry({
         story_id: Type.String(),
         title: Type.Optional(Type.String()),
         slug: Type.Optional(Type.String()),
-        content: Type.Optional(
-          Type.Record(Type.String(), Type.Any())
-        ),
+        content: Type.Optional(Type.Record(Type.String(), Type.Any())),
         parent_id: Type.Optional(Type.Number()),
         tags: Type.Optional(Type.Array(Type.String())),
         language: Type.Optional(Type.String()),
         version: Type.Optional(Type.String()),
       }),
-      async execute(_id: string | undefined, params: UpdateStoryParams) {
-        try {
-          const { story_id, ...update } = params;
-          return ok(
-            await client.updateStory(
-              story_id,
-              update
-            )
-          );
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p: any) => {
+          const { story_id, ...update } = p;
+          return client.updateStory(story_id, update);
+        }, params);
       },
     });
 
@@ -258,18 +202,15 @@ export default definePluginEntry({
         language: Type.Optional(Type.String()),
         publish_notes: Type.Optional(Type.String()),
       }),
-      async execute(_id: string | undefined, params: Record<string, any>) {
-        try {
-          return ok(
-            await client.publishStory(params.story_id, {
-              version: params.version,
-              language: params.language,
-              publish_notes: params.publish_notes,
-            })
-          );
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p: any) =>
+          client.publishStory(p.story_id, {
+            version: p.version,
+            language: p.language,
+            publish_notes: p.publish_notes,
+          }),
+          params
+        );
       },
     });
 
@@ -280,17 +221,11 @@ export default definePluginEntry({
         story_id: Type.String(),
         language: Type.Optional(Type.String()),
       }),
-      async execute(_id: string | undefined, params: Record<string, any>) {
-        try {
-          return ok(
-            await client.unpublishStory(
-              params.story_id,
-              params.language
-            )
-          );
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p: any) =>
+          client.unpublishStory(p.story_id, p.language),
+          params
+        );
       },
     });
 
@@ -301,17 +236,11 @@ export default definePluginEntry({
         version: Type.Optional(Type.String()),
         language: Type.Optional(Type.String()),
       }),
-      async execute(_id: string | undefined, params: Record<string, any>) {
-        try {
-          return ok(
-            await client.getComponents(
-              params.version,
-              params.language
-            )
-          );
-        } catch (error) {
-          return safeError(error, cfg);
-        }
+      execute(_id, params) {
+        return executeSafely((client, p: any) =>
+          client.getComponents(p.version, p.language),
+          params
+        );
       },
     });
   },

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-storyblok",
   "name": "Storyblok Integration",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Provides tools to interact with Storyblok CMS via Management API and Delivery API. Supports stories, components, and space management.",
   "skills": ["skills"],
    "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvasar/openclaw-storyblok-plugin",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "OpenClaw plugin — interact with Storyblok CMS via Management API and Delivery API",
   "type": "module",
   "main": "./index.ts",

package/skills/SKILL.md

@@ -31,6 +31,68 @@ This skill package provides agents with the ability to work with **Storyblok CMS
 
 ## Core Concepts
 
+
+
+### Storyblok Block Types
+
+Storyblok components can be organized into three structural categories:
+
+#### Nestable Block
+
+Reusable blocks that are inserted **inside other blocks or pages**.
+
+Examples:
+
+- Hero  
+- Grid  
+- Section  
+- Newsletter Section  
+- Chapter  
+- Full Width Image  
+- Slider  
+- CTA Banner  
+- Feature Grid  
+
+Use these when building modular page layouts.
+
+---
+
+#### Content Type Block
+
+Top-level content models representing an entry/page/document.
+
+Examples:
+
+- Landing Page  
+- Post  
+- Authors  
+- Product  
+- Page  
+- Team Members  
+- FAQ Article  
+- Case Study  
+
+Use these as standalone entries in Storyblok.
+
+---
+
+#### Universal Block
+
+A block that can be used **both as a content type and nested block**.
+
+Examples:
+
+- FAQ Section  
+- Testimonials  
+- Rich Text Section  
+- Gallery  
+- Reusable Promo Page  
+- Contact Section  
+
+Use when flexibility is needed across multiple content structures.
+
+---
+
 ### Tools
 
 All tools are provided by the `openclaw-storyblok` plugin: