@joshualelon/clawdbot-skill-flow 0.2.2 → 0.3.0

package/index.ts

@@ -29,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,
@@ -39,7 +39,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-step",
+      name: "flow_step",
       description: "Handle flow step transition (internal)",
       acceptsArgs: true,
       requireAuth: true,
@@ -47,7 +47,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-create",
+      name: "flow_create",
       description: "Create a new flow from JSON",
       acceptsArgs: true,
       requireAuth: true,
@@ -55,7 +55,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-list",
+      name: "flow_list",
       description: "List all available flows",
       acceptsArgs: false,
       requireAuth: true,
@@ -63,7 +63,7 @@ const plugin = {
     });
 
     api.registerCommand({
-      name: "flow-delete",
+      name: "flow_delete",
       description: "Delete a flow",
       acceptsArgs: true,
       requireAuth: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshualelon/clawdbot-skill-flow",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "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,9 +1,9 @@
 /**
- * /flow-start command - Start a flow
+ * /flow_start command - Start a flow
  */
 
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
-import { loadFlow } from "../state/flow-store.js";
+import { loadFlow, listFlows } from "../state/flow-store.js";
 import { createSession, getSessionKey } from "../state/session-store.js";
 import { startFlow } from "../engine/executor.js";
 
@@ -15,10 +15,36 @@ export function createFlowStartCommand(api: ClawdbotPluginApi) {
   }) => {
     const flowName = args.args?.trim();
 
-    // Validate input
+    // Show flow selection buttons when no flow name provided (Telegram)
     if (!flowName) {
+      const flows = await listFlows(api);
+
+      if (flows.length === 0) {
+        return {
+          text: "No flows available.\n\nCreate one with /flow_create",
+        };
+      }
+
+      // Show buttons on Telegram, text list on other channels
+      if (args.channel === "telegram") {
+        const buttons = flows.map((flow) => [
+          {
+            text: `${flow.name}${flow.description ? ` - ${flow.description}` : ""}`,
+            callback_data: `/flow_start ${flow.name}`,
+          },
+        ]);
+
+        return {
+          text: "Choose a flow to start:",
+          channelData: {
+            telegram: { buttons },
+          },
+        };
+      }
+
+      // Fallback for non-Telegram channels
       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 +53,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}`,
       },
     ]);
   }