@elizaos/plugin-workflow 2.0.0-beta.1

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { type Plugin } from '@elizaos/core';
+import './register-routes';
+/**
+ * Workflow Plugin for ElizaOS
+ *
+ * Generate and manage workflows from natural language using a RAG pipeline.
+ * Supports workflow CRUD, execution management, and credential resolution.
+ *
+ * **Optional Configuration:**
+ * - `workflows.credentials`: Pre-configured credential IDs for local mode
+ *
+ * **Example Character Configuration:**
+ * ```json
+ * {
+ *   "name": "AI Workflow Builder",
+ *   "plugins": ["@elizaos/plugin-workflow"],
+ *   "settings": {
+ *     "workflows": {
+ *       "credentials": {
+ *         "gmailOAuth2": "cred_gmail_123",
+ *         "stripeApi": "cred_stripe_456"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare const workflowPlugin: Plugin;
+export default workflowPlugin;
+export * from './plugin-routes.js';
+export * from './register-routes.js';
+export * from './services/workflow-dispatch.js';
+export { handleTriggerRoutes, type TriggerRouteContext, type TriggerRouteHelpers, } from './trigger-routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAsBxE,OAAO,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,cAAc,EAAE,MAgD5B,CAAC;AAwEF,eAAe,cAAc,CAAC;AAE9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,126 @@
+import { logger } from '@elizaos/core';
+import { workflowAction } from './actions/index';
+import * as dbSchema from './db/index';
+import { migrateLegacyTextTriggers, migrateLegacyWorkbenchTasks } from './lib/index';
+import { activeWorkflowsProvider, pendingDraftProvider, workflowStatusProvider, } from './providers/index';
+import { workflowRoutes } from './routes/index';
+import { EmbeddedWorkflowService, registerWorkflowDispatchService, WORKFLOW_SERVICE_TYPE, WorkflowCredentialStore, WorkflowService, } from './services/index';
+// Side-effect: register the rawPath route plugin
+// (`@elizaos/plugin-workflow:routes`) with the app-route-plugin-registry so
+// the runtime mounts /api/workflow/* on the host HTTP server. Without this
+// import the registry call in register-routes.ts never fires and every
+// /api/workflow/* request returns 404.
+import './register-routes';
+/**
+ * Workflow Plugin for ElizaOS
+ *
+ * Generate and manage workflows from natural language using a RAG pipeline.
+ * Supports workflow CRUD, execution management, and credential resolution.
+ *
+ * **Optional Configuration:**
+ * - `workflows.credentials`: Pre-configured credential IDs for local mode
+ *
+ * **Example Character Configuration:**
+ * ```json
+ * {
+ *   "name": "AI Workflow Builder",
+ *   "plugins": ["@elizaos/plugin-workflow"],
+ *   "settings": {
+ *     "workflows": {
+ *       "credentials": {
+ *         "gmailOAuth2": "cred_gmail_123",
+ *         "stripeApi": "cred_stripe_456"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export const workflowPlugin = {
+    name: 'workflow',
+    description: 'Generate and deploy workflows from natural language. ' +
+        'Runs supported workflow nodes in-process with credential resolution.',
+    services: [EmbeddedWorkflowService, WorkflowService, WorkflowCredentialStore],
+    schema: dbSchema,
+    actions: [workflowAction],
+    providers: [workflowStatusProvider, activeWorkflowsProvider, pendingDraftProvider],
+    routes: workflowRoutes,
+    init: async (_config, runtime) => {
+        // Check for pre-configured credentials (optional)
+        // Note: runtime.getSetting() only returns primitives — nested objects must be read directly
+        const workflowSettings = runtime.character?.settings?.workflows;
+        if (workflowSettings?.credentials) {
+            const credCount = Object.keys(workflowSettings.credentials).filter((k) => workflowSettings.credentials?.[k]).length;
+            logger.info({ src: 'plugin:workflow:plugin:init' }, `Pre-configured credentials: ${credCount} credential types`);
+        }
+        // Register WORKFLOW_DISPATCH so trigger-kind=workflow tasks can call
+        // runtime.getService("WORKFLOW_DISPATCH").execute(workflowId).
+        registerWorkflowDispatchService(runtime);
+        // Schedule one-shot legacy migrations off the init critical path. Service
+        // start-order is not guaranteed at init: WorkflowService may not be in
+        // the registry yet. Poll up to 10 times (1s spacing) and bail quietly
+        // if it never appears. Each migration is idempotent so a duplicate run
+        // on a future boot is harmless.
+        scheduleLegacyMigrations(runtime);
+        logger.info({ src: 'plugin:workflow:plugin:init' }, 'Workflow Plugin initialized successfully (in-process runtime)');
+    },
+};
+const MIGRATION_RETRY_LIMIT = 10;
+const MIGRATION_RETRY_INTERVAL_MS = 1000;
+function scheduleLegacyMigrations(runtime) {
+    let attempts = 0;
+    const tick = () => {
+        attempts += 1;
+        const ready = runtime.getService(WORKFLOW_SERVICE_TYPE);
+        if (!ready) {
+            if (attempts >= MIGRATION_RETRY_LIMIT) {
+                logger.warn({ src: 'plugin:workflow:plugin:migration' }, `WorkflowService still not registered after ${MIGRATION_RETRY_LIMIT} retries; legacy migrations will run on next boot`);
+                return;
+            }
+            setTimeout(tick, MIGRATION_RETRY_INTERVAL_MS);
+            return;
+        }
+        void runLegacyMigrations(runtime);
+    };
+    // Defer the first attempt off the init stack so the host runtime can
+    // finish wiring before we probe the service registry.
+    setImmediate(tick);
+}
+async function runLegacyMigrations(runtime) {
+    try {
+        const summary = await migrateLegacyWorkbenchTasks(runtime);
+        logger.info({
+            src: 'plugin:workflow:plugin:migration',
+            migrated: summary.migrated,
+            skipped: summary.skipped,
+            failed: summary.failed,
+        }, `Workbench-task migration: ${summary.migrated} migrated, ${summary.skipped} skipped, ${summary.failed} failed`);
+    }
+    catch (err) {
+        logger.warn({
+            src: 'plugin:workflow:plugin:migration',
+            err: err instanceof Error ? err.message : String(err),
+        }, 'Workbench-task migration threw; continuing');
+    }
+    try {
+        const summary = await migrateLegacyTextTriggers(runtime);
+        logger.info({
+            src: 'plugin:workflow:plugin:migration',
+            migrated: summary.migrated,
+            skipped: summary.skipped,
+            failed: summary.failed,
+        }, `Text-trigger migration: ${summary.migrated} migrated, ${summary.skipped} skipped, ${summary.failed} failed`);
+    }
+    catch (err) {
+        logger.warn({
+            src: 'plugin:workflow:plugin:migration',
+            err: err instanceof Error ? err.message : String(err),
+        }, 'Text-trigger migration threw; continuing');
+    }
+}
+export default workflowPlugin;
+export * from './plugin-routes.js';
+export * from './register-routes.js';
+export * from './services/workflow-dispatch.js';
+export { handleTriggerRoutes, } from './trigger-routes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/automations-builder.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Builder for the `/api/automations` response surface.
+ *
+ * Reads workflows in-process via WorkflowService, runtime tasks via the core
+ * runtime task API, and draft conversations via runtime room APIs. There is
+ * no dynamic import of plugin-workflow because this code IS the plugin.
+ *
+ * Trigger task lookup: the runtime stores trigger tasks under three tag
+ * combinations — `["queue","repeat","trigger"]` for user-defined triggers and
+ * `["queue","repeat","heartbeat"]` for plugin-owned heartbeats. We replicate
+ * `listTriggerTasks` from `packages/agent/src/triggers/runtime.ts` here
+ * because plugin-workflow cannot depend on @elizaos/agent.
+ */
+import type { AgentRuntime } from '@elizaos/core';
+import { type AutomationListResponse } from './automations-types';
+export declare function buildAutomationListResponse(runtime: AgentRuntime): Promise<AutomationListResponse>;
+/**
+ * Test-only: clear the last-execution cache between cases.
+ */
+export declare function __resetAutomationsCacheForTests(): void;
+//# sourceMappingURL=automations-builder.d.ts.map

package/dist/lib/automations-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations-builder.d.ts","sourceRoot":"","sources":["../../src/lib/automations-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AASpE,OAAO,EAGL,KAAK,sBAAsB,EAU5B,MAAM,qBAAqB,CAAC;AAge7B,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAyJjC;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}