@joshualelon/clawdbot-skill-flow 0.4.0 → 0.5.0

package/package.json

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

package/src/config.ts

@@ -2,6 +2,11 @@ import { z } from "zod";
 
 export const SkillFlowConfigSchema = z
   .object({
+    flowsDir: z
+      .string()
+      .optional()
+      .describe("Custom flows directory (default: ~/.clawdbot/flows)"),
+
     sessionTimeoutMinutes: z
       .number()
       .int()
@@ -35,11 +40,25 @@ export const SkillFlowConfigSchema = z
 
 export type SkillFlowConfig = z.infer<typeof SkillFlowConfigSchema>;
 
+// Store parsed config for access by other modules
+let pluginConfig: SkillFlowConfig | null = null;
+
 /**
  * Parse and validate plugin config with defaults
  */
 export function parseSkillFlowConfig(
   raw: unknown
 ): SkillFlowConfig {
-  return SkillFlowConfigSchema.parse(raw ?? {});
+  pluginConfig = SkillFlowConfigSchema.parse(raw ?? {});
+  return pluginConfig;
+}
+
+/**
+ * Get the current plugin config (must call parseSkillFlowConfig first)
+ */
+export function getPluginConfig(): SkillFlowConfig {
+  if (!pluginConfig) {
+    throw new Error("Plugin config not initialized. Call parseSkillFlowConfig first.");
+  }
+  return pluginConfig;
 }

package/src/engine/hooks-loader.ts

@@ -10,6 +10,20 @@ import {
   resolvePathSafely,
   validatePathWithinBase,
 } from "../security/path-validation.js";
+import { getPluginConfig } from "../config.js";
+
+/**
+ * Get the flows directory path (same logic as flow-store.ts)
+ */
+function getFlowsDir(api: ClawdbotPluginApi): string {
+  const config = getPluginConfig();
+  if (config.flowsDir) {
+    const expandedPath = config.flowsDir.replace(/^~/, process.env.HOME || "~");
+    return path.resolve(expandedPath);
+  }
+  const stateDir = api.runtime.state.resolveStateDir();
+  return path.join(stateDir, "flows");
+}
 
 /**
  * Load hooks from a file path
@@ -23,7 +37,7 @@ export async function loadHooks(
 ): Promise<FlowHooks | null> {
   try {
     // Validate path is within flows directory
-    const flowsDir = path.join(api.runtime.state.resolveStateDir(), "flows");
+    const flowsDir = getFlowsDir(api);
     validatePathWithinBase(hooksPath, flowsDir, "hooks file");
 
     // Check if file exists
@@ -55,7 +69,7 @@ export async function loadStorageBackend(
 ): Promise<StorageBackend | null> {
   try {
     // Validate path is within flows directory
-    const flowsDir = path.join(api.runtime.state.resolveStateDir(), "flows");
+    const flowsDir = getFlowsDir(api);
     validatePathWithinBase(backendPath, flowsDir, "storage backend");
 
     // Check if file exists
@@ -87,11 +101,8 @@ export function resolveFlowPath(
   flowName: string,
   relativePath: string
 ): string {
-  const flowDir = path.join(
-    api.runtime.state.resolveStateDir(),
-    "flows",
-    flowName
-  );
+  const flowsDir = getFlowsDir(api);
+  const flowDir = path.join(flowsDir, flowName);
 
   // Validate that relativePath doesn't escape flowDir
   return resolvePathSafely(flowDir, relativePath, "flow path");

package/src/state/flow-store.ts

@@ -9,6 +9,7 @@ import { promisify } from "node:util";
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
 import type { FlowMetadata } from "../types.js";
 import { FlowMetadataSchema } from "../validation.js";
+import { getPluginConfig } from "../config.js";
 
 const lock = promisify(lockfile.lock);
 const unlock = promisify(lockfile.unlock);
@@ -17,6 +18,12 @@ const unlock = promisify(lockfile.unlock);
  * Get the flows directory path
  */
 function getFlowsDir(api: ClawdbotPluginApi): string {
+  const config = getPluginConfig();
+  if (config.flowsDir) {
+    // Expand ~ to home directory
+    const expandedPath = config.flowsDir.replace(/^~/, process.env.HOME || "~");
+    return path.resolve(expandedPath);
+  }
   const stateDir = api.runtime.state.resolveStateDir();
   return path.join(stateDir, "flows");
 }

package/src/state/history-store.ts

@@ -7,17 +7,31 @@ import path from "node:path";
 import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
 import type { FlowSession, FlowMetadata } from "../types.js";
 import type { SkillFlowConfig } from "../config.js";
+import { getPluginConfig } from "../config.js";
 import {
   loadStorageBackend,
   resolveFlowPath,
 } from "../engine/hooks-loader.js";
 
+/**
+ * Get the flows directory path (same logic as flow-store.ts)
+ */
+function getFlowsDir(api: ClawdbotPluginApi): string {
+  const config = getPluginConfig();
+  if (config.flowsDir) {
+    const expandedPath = config.flowsDir.replace(/^~/, process.env.HOME || "~");
+    return path.resolve(expandedPath);
+  }
+  const stateDir = api.runtime.state.resolveStateDir();
+  return path.join(stateDir, "flows");
+}
+
 /**
  * Get history file path for a flow
  */
 function getHistoryPath(api: ClawdbotPluginApi, flowName: string): string {
-  const stateDir = api.runtime.state.resolveStateDir();
-  return path.join(stateDir, "flows", flowName, "history.jsonl");
+  const flowsDir = getFlowsDir(api);
+  return path.join(flowsDir, flowName, "history.jsonl");
 }
 
 /**

package/src/types.ts

@@ -43,6 +43,8 @@ export interface FlowMetadata {
     backend?: string; // Path to custom storage backend
     builtin?: boolean; // Also write to JSONL (default: true)
   };
+  // Allow extra fields (e.g., job config)
+  [key: string]: unknown;
 }
 
 export interface FlowSession {

package/src/validation.ts

@@ -58,6 +58,7 @@ const StorageSchema = z
   .optional();
 
 // Complete flow metadata schema
+// Use .passthrough() to allow extra fields (e.g., job config)
 export const FlowMetadataSchema = z.object({
   name: z.string(),
   description: z.string(),
@@ -67,7 +68,7 @@ export const FlowMetadataSchema = z.object({
   triggers: TriggerSchema,
   hooks: z.string().optional(),
   storage: StorageSchema,
-});
+}).passthrough();
 
 /**
  * Normalize button input to Button object