@joshualelon/clawdbot-skill-flow 0.2.1 → 0.2.3

package/index.ts

@@ -4,12 +4,16 @@
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
 import { parseSkillFlowConfig } from "./src/config.js";
-import { initSessionStore } from "./src/state/session-store.js";
+import { initSessionStore, createSession, getSessionKey } from "./src/state/session-store.js";
 import { createFlowStartCommand } from "./src/commands/flow-start.js";
 import { createFlowStepCommand } from "./src/commands/flow-step.js";
 import { createFlowCreateCommand } from "./src/commands/flow-create.js";
 import { createFlowListCommand } from "./src/commands/flow-list.js";
 import { createFlowDeleteCommand } from "./src/commands/flow-delete.js";
+import { saveFlow, loadFlow, listFlows } from "./src/state/flow-store.js";
+import { startFlow } from "./src/engine/executor.js";
+import { FlowMetadataSchema } from "./src/validation.js";
+import type { FlowMetadata } from "./src/types.js";
 
 const plugin = {
   id: "skill-flow",
@@ -25,9 +29,9 @@ const plugin = {
     // Initialize session store with config
     initSessionStore(config);
 
-    // Register commands
+    // Register commands (use underscores per Telegram requirements)
     api.registerCommand({
-      name: "flow-start",
+      name: "flow_start",
       description: "Start a workflow",
       acceptsArgs: true,
       requireAuth: true,
@@ -35,7 +39,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-step",
+      name: "flow_step",
       description: "Handle flow step transition (internal)",
       acceptsArgs: true,
       requireAuth: true,
@@ -43,7 +47,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-create",
+      name: "flow_create",
       description: "Create a new flow from JSON",
       acceptsArgs: true,
       requireAuth: true,
@@ -51,7 +55,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-list",
+      name: "flow_list",
       description: "List all available flows",
       acceptsArgs: false,
       requireAuth: true,
@@ -59,13 +63,116 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-delete",
+      name: "flow_delete",
       description: "Delete a flow",
       acceptsArgs: true,
       requireAuth: true,
       handler: createFlowDeleteCommand(api),
     });
 
+    // Register gateway methods for programmatic access
+    // @ts-expect-error - registerGatewayMethod exists at runtime, types will be available in future clawdbot release
+    api.registerGatewayMethod("skill-flow.create", async ({ params, respond }) => {
+      try {
+        const flow: FlowMetadata = FlowMetadataSchema.parse(params);
+        await saveFlow(api, flow);
+        api.logger.info(`Created flow "${flow.name}" via gateway method`);
+        respond(true, {
+          success: true,
+          flowName: flow.name,
+          message: `Flow "${flow.name}" created successfully`,
+        });
+      } catch (error) {
+        api.logger.error("Gateway method skill-flow.create failed:", error);
+        respond(false, {
+          error: error instanceof Error ? error.message : "Failed to create flow",
+        });
+      }
+    });
+
+    // @ts-expect-error - registerGatewayMethod exists at runtime, types will be available in future clawdbot release
+    api.registerGatewayMethod("skill-flow.list", async ({ respond }) => {
+      try {
+        const flows = await listFlows(api);
+        respond(true, {
+          flows: flows.map((f) => ({
+            name: f.name,
+            description: f.description,
+            version: f.version,
+            author: f.author,
+          })),
+        });
+      } catch (error) {
+        api.logger.error("Gateway method skill-flow.list failed:", error);
+        respond(false, {
+          error: error instanceof Error ? error.message : "Failed to list flows",
+        });
+      }
+    });
+
+    // @ts-expect-error - registerGatewayMethod exists at runtime, types will be available in future clawdbot release
+    api.registerGatewayMethod("skill-flow.start", async ({ params, respond }) => {
+      try {
+        const { flowName, senderId, channel } = params as {
+          flowName: string;
+          senderId: string;
+          channel: string;
+        };
+
+        if (!flowName || !senderId || !channel) {
+          respond(false, {
+            error: "Missing required parameters: flowName, senderId, channel",
+          });
+          return;
+        }
+
+        // Load flow
+        const flow = await loadFlow(api, flowName);
+        if (!flow) {
+          respond(false, {
+            error: `Flow "${flowName}" not found`,
+          });
+          return;
+        }
+
+        // Verify flow has steps
+        if (!flow.steps || flow.steps.length === 0) {
+          respond(false, {
+            error: `Flow "${flowName}" has no steps`,
+          });
+          return;
+        }
+
+        // Create session
+        const session = createSession({
+          flowName: flow.name,
+          currentStepId: flow.steps[0]!.id,
+          senderId,
+          channel,
+        });
+
+        api.logger.info(
+          `Started flow "${flowName}" for user ${senderId} via gateway method (session: ${getSessionKey(senderId, flowName)})`
+        );
+
+        // Get the first step response
+        const response = startFlow(api, flow, session);
+
+        respond(true, {
+          success: true,
+          sessionId: getSessionKey(senderId, flowName),
+          flowName: flow.name,
+          message: `Flow "${flowName}" started`,
+          response,
+        });
+      } catch (error) {
+        api.logger.error("Gateway method skill-flow.start failed:", error);
+        respond(false, {
+          error: error instanceof Error ? error.message : "Failed to start flow",
+        });
+      }
+    });
+
     api.logger.info("Skill Flow plugin registered successfully", {
       sessionTimeoutMinutes: config.sessionTimeoutMinutes,
       enableBuiltinHistory: config.enableBuiltinHistory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshualelon/clawdbot-skill-flow",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "Multi-step workflow orchestration plugin for Clawdbot",
   "keywords": [

package/src/commands/flow-create.ts

@@ -1,5 +1,5 @@
 /**
- * /flow-create command - Create a new flow
+ * /flow_create command - Create a new flow
  */
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
@@ -13,7 +13,7 @@ export function createFlowCreateCommand(api: ClawdbotPluginApi) {
 
     if (!input) {
       return {
-        text: "Usage: /flow-create import <json>\n\nExample:\n/flow-create import {...}",
+        text: "Usage: /flow_create import <json>\n\nExample:\n/flow_create import {...}",
       };
     }
 
@@ -22,7 +22,7 @@ export function createFlowCreateCommand(api: ClawdbotPluginApi) {
 
     if (!importMatch) {
       return {
-        text: "Currently only 'import' mode is supported.\n\nUsage: /flow-create import <json>",
+        text: "Currently only 'import' mode is supported.\n\nUsage: /flow_create import <json>",
       };
     }
 
@@ -46,7 +46,7 @@ export function createFlowCreateCommand(api: ClawdbotPluginApi) {
       api.logger.info(`Created flow "${flow.name}"`);
 
       return {
-        text: `✅ Flow "${flow.name}" created successfully!\n\nStart it with: /flow-start ${flow.name}`,
+        text: `✅ Flow "${flow.name}" created successfully!\n\nStart it with: /flow_start ${flow.name}`,
       };
     } catch (error) {
       if (error instanceof SyntaxError) {

package/src/commands/flow-delete.ts

@@ -1,5 +1,5 @@
 /**
- * /flow-delete command - Delete a flow
+ * /flow_delete command - Delete a flow
  */
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
@@ -11,7 +11,7 @@ export function createFlowDeleteCommand(api: ClawdbotPluginApi) {
 
     if (!flowName) {
       return {
-        text: "Usage: /flow-delete <flow-name>\n\nExample: /flow-delete pushups",
+        text: "Usage: /flow_delete <flow-name>\n\nExample: /flow_delete pushups",
       };
     }
 
@@ -20,7 +20,7 @@ export function createFlowDeleteCommand(api: ClawdbotPluginApi) {
 
     if (!flow) {
       return {
-        text: `Flow "${flowName}" not found.\n\nUse /flow-list to see available flows.`,
+        text: `Flow "${flowName}" not found.\n\nUse /flow_list to see available flows.`,
       };
     }
 

package/src/commands/flow-list.ts

@@ -1,5 +1,5 @@
 /**
- * /flow-list command - List all available flows
+ * /flow_list command - List all available flows
  */
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
@@ -11,7 +11,7 @@ export function createFlowListCommand(api: ClawdbotPluginApi) {
 
     if (flows.length === 0) {
       return {
-        text: "No flows found.\n\nCreate one with: /flow-create import {...}",
+        text: "No flows found.\n\nCreate one with: /flow_create import {...}",
       };
     }
 
@@ -25,7 +25,7 @@ export function createFlowListCommand(api: ClawdbotPluginApi) {
         message += `  🕒 Cron: ${flow.triggers.cron}\n`;
       }
 
-      message += `  Start: /flow-start ${flow.name}\n\n`;
+      message += `  Start: /flow_start ${flow.name}\n\n`;
     }
 
     return { text: message };

package/src/commands/flow-start.ts

@@ -1,5 +1,5 @@
 /**
- * /flow-start command - Start a flow
+ * /flow_start command - Start a flow
  */
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
@@ -18,7 +18,7 @@ export function createFlowStartCommand(api: ClawdbotPluginApi) {
     // Validate input
     if (!flowName) {
       return {
-        text: "Usage: /flow-start <flow-name>\n\nExample: /flow-start pushups\n\nUse /flow-list to see available flows.",
+        text: "Usage: /flow_start <flow-name>\n\nExample: /flow_start pushups\n\nUse /flow_list to see available flows.",
       };
     }
 
@@ -27,7 +27,7 @@ export function createFlowStartCommand(api: ClawdbotPluginApi) {
 
     if (!flow) {
       return {
-        text: `Flow "${flowName}" not found.\n\nUse /flow-list to see available flows.`,
+        text: `Flow "${flowName}" not found.\n\nUse /flow_list to see available flows.`,
       };
     }
 

package/src/commands/flow-step.ts

@@ -1,5 +1,5 @@
 /**
- * /flow-step command - Handle flow step transitions (called via Telegram callbacks)
+ * /flow_step command - Handle flow step transitions (called via Telegram callbacks)
  */
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
@@ -92,7 +92,7 @@ export function createFlowStepCommand(api: ClawdbotPluginApi) {
       }
 
       return {
-        text: `Session expired or not found.\n\nUse /flow-start ${flowName} to restart the flow.`,
+        text: `Session expired or not found.\n\nUse /flow_start ${flowName} to restart the flow.`,
       };
     }
 

package/src/engine/renderer.ts

@@ -55,7 +55,7 @@ function renderTelegram(
     for (let i = 0; i < buttons.length; i += 2) {
       const row = buttons.slice(i, i + 2).map((btn) => ({
         text: btn.text,
-        callback_data: `/flow-step ${flowName} ${step.id}:${btn.value}`,
+        callback_data: `/flow_step ${flowName} ${step.id}:${btn.value}`,
       }));
       keyboard.push(row);
     }
@@ -64,7 +64,7 @@ function renderTelegram(
     keyboard = buttons.map((btn) => [
       {
         text: btn.text,
-        callback_data: `/flow-step ${flowName} ${step.id}:${btn.value}`,
+        callback_data: `/flow_step ${flowName} ${step.id}:${btn.value}`,
       },
     ]);
   }