@kvasar/openclaw-storyblok-plugin 0.1.4 → 0.1.6

package/index.ts

@@ -10,7 +10,7 @@
 import { Type } from "@sinclair/typebox";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 
-import { StoryblokClient } from "./src/client.js";
+import { StoryblokClient, type StoryblokConfig } from "./src/client.js";
 import { validateConfig, redactTokens } from "./src/config.js";
 
 interface StoryblokPluginConfig {
@@ -20,6 +20,39 @@ interface StoryblokPluginConfig {
   previewToken?: string;
 }
 
+interface OpenClawPluginApi {
+  pluginConfig?: unknown;
+  config?: unknown;
+  registerTool(tool: {
+    name: string;
+    description: string;
+    parameters: unknown;
+    execute: (_id?: string, params?: any) => Promise<unknown> | unknown;
+  }): 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: [
@@ -56,10 +89,10 @@ export default definePluginEntry({
   description:
     "Interact with Storyblok CMS: manage stories, components, and space information.",
 
-  register(api) {
+  register(api: OpenClawPluginApi) {
     const rawCfg = (
-      (api as { pluginConfig?: unknown; config?: unknown }).pluginConfig ??
-      (api as { pluginConfig?: unknown; config?: unknown }).config ??
+      api.pluginConfig ??
+      api.config ??
       {}
     ) as StoryblokPluginConfig;
 
@@ -79,7 +112,14 @@ export default definePluginEntry({
       );
     }
 
-    const client = new StoryblokClient(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);
 
     api.registerTool({
       name: "storyblok_get_space",
@@ -111,7 +151,7 @@ export default definePluginEntry({
         svg_render: Type.Optional(Type.Boolean()),
       }),
       async execute(
-        _id: string,
+        _id: string | undefined,
         params: {
           identifier: string;
           version?: string;
@@ -146,7 +186,7 @@ export default definePluginEntry({
         sort_by: Type.Optional(Type.String()),
         direction: Type.Optional(Type.String()),
       }),
-      async execute(_id: string, params: Record<string, any>) {
+      async execute(_id: string | undefined, params: Record<string, any>) {
         try {
           return ok(await client.listStories(params));
         } catch (error) {
@@ -170,7 +210,7 @@ export default definePluginEntry({
         is_folder: Type.Optional(Type.Boolean()),
         language: Type.Optional(Type.String()),
       }),
-      async execute(_id: string, params: Record<string, any>) {
+      async execute(_id: string | undefined, params: CreateStoryParams) {
         try {
           return ok(await client.createStory(params));
         } catch (error) {
@@ -194,12 +234,13 @@ export default definePluginEntry({
         language: Type.Optional(Type.String()),
         version: Type.Optional(Type.String()),
       }),
-      async execute(_id: string, params: Record<string, any>) {
+      async execute(_id: string | undefined, params: UpdateStoryParams) {
         try {
+          const { story_id, ...update } = params;
           return ok(
             await client.updateStory(
-              params.story_id,
-              params
+              story_id,
+              update
             )
           );
         } catch (error) {
@@ -217,7 +258,7 @@ export default definePluginEntry({
         language: Type.Optional(Type.String()),
         publish_notes: Type.Optional(Type.String()),
       }),
-      async execute(_id: string, params: Record<string, any>) {
+      async execute(_id: string | undefined, params: Record<string, any>) {
         try {
           return ok(
             await client.publishStory(params.story_id, {
@@ -239,7 +280,7 @@ export default definePluginEntry({
         story_id: Type.String(),
         language: Type.Optional(Type.String()),
       }),
-      async execute(_id: string, params: Record<string, any>) {
+      async execute(_id: string | undefined, params: Record<string, any>) {
         try {
           return ok(
             await client.unpublishStory(
@@ -260,7 +301,7 @@ export default definePluginEntry({
         version: Type.Optional(Type.String()),
         language: Type.Optional(Type.String()),
       }),
-      async execute(_id: string, params: Record<string, any>) {
+      async execute(_id: string | undefined, params: Record<string, any>) {
         try {
           return ok(
             await client.getComponents(

package/openclaw.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "openclaw-storyblok",
   "name": "Storyblok Integration",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Provides tools to interact with Storyblok CMS via Management API and Delivery API. Supports stories, components, and space management.",
   "skills": ["skills"],
-  "configSchema": {
+   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvasar/openclaw-storyblok-plugin",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "OpenClaw plugin — interact with Storyblok CMS via Management API and Delivery API",
   "type": "module",
   "main": "./index.ts",
@@ -24,12 +24,12 @@
       "./index.ts"
     ],
     "compat": {
-      "pluginApi": ">=2026.3.24-beta.2",
-      "minGatewayVersion": "2026.3.24-beta.2"
+      "pluginApi": ">=2026.3.13",
+      "minGatewayVersion": "2026.3.13"
     },
     "build": {
-      "openclawVersion": "2026.3.24-beta.2",
-      "pluginSdkVersion": "2026.3.24-beta.2"
+      "openclawVersion": "2026.3.13",
+      "pluginSdkVersion": "2026.3.13"
     }
   },
   "dependencies": {

package/skills/SKILL.md

@@ -29,17 +29,6 @@ This skill package provides agents with the ability to work with **Storyblok CMS
 3. **Page Generation** – Use AI-assisted reasoning to create new landing pages.
 4. **Sync Workflow** – Synchronize content or schemas between Storyblok and a frontend repository.
 
-## Prerequisites
-
-The Storyblok plugin must be configured with valid credentials:
-
-- `baseUrl` (default: https://api.storyblok.com)
-- `spaceId`
-- `managementToken` (required for write operations)
-- `previewToken` (optional for read-only operations)
-
-These are set when installing the plugin. Inside a session, the plugin config will be used automatically.
-
 ## Core Concepts
 
 ### Tools
@@ -64,14 +53,6 @@ All tools are provided by the `openclaw-storyblok` plugin:
 - For `storyblok_list_stories`, you can filter by `folder_id`, `parent_id`, `status`, `tag`, `per_page`, `page`, `sort_by`, `direction`.
 - For management tools, `story_id` can be numeric ID or UUID.
 
-### Error Handling
-
-All tools return a standardized response:
-- Success: `{ content: [{type: "text", text: JSON}], metadata: {...} }`
-- Error: `{ content: [{type: "text", text: "❌ Storyblok: ..."}], isError: true }`
-
-Agents should check `isError` and display the error message to the user.
-
 ## Workflow Guides
 
 ### 1. Content Query

package/src/openclaw-plugin-entry.d.ts

@@ -0,0 +1,3 @@
+declare module "openclaw/plugin-sdk/plugin-entry" {
+  export function definePluginEntry(entry: unknown): unknown;
+}

package/tsconfig.json

@@ -13,6 +13,6 @@
     "declarationMap": true,
     "sourceMap": true
   },
-  "include": ["index.ts", "src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
+  "include": ["index.ts", "src/**/*.ts", "src/**/*.d.ts"],
+  "exclude": ["node_modules", "dist", "src/__tests__/**"]
 }