@elizaos/plugin-workflow 2.0.0-beta.1

package/dist/types/index.d.ts

@@ -0,0 +1,457 @@
+import type { EventPayload } from '@elizaos/core';
+import type { INode, INodeCredentialsDetails, INodeProperties, INodeTypeDescription, IWorkflowSettings } from '@elizaos/workflows';
+export interface WorkflowDefinition {
+    name: string;
+    nodes: WorkflowNode[];
+    connections: WorkflowConnections;
+    active?: boolean;
+    settings?: Partial<IWorkflowSettings>;
+    tags?: WorkflowTag[];
+    meta?: Record<string, unknown>;
+    id?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /**
+     * Metadata generated by LLM (not sent to workflow API)
+     * Used internally for preview and clarification
+     */
+    _meta?: WorkflowMeta;
+}
+/**
+ * Workflow metadata for internal use
+ * Generated by LLM, used for preview and clarification
+ * NOT sent to workflow API
+ */
+export interface WorkflowMeta {
+    assumptions?: string[];
+    suggestions?: string[];
+    /**
+     * Accepts either legacy free-text strings (one question per item) or
+     * structured ClarificationRequest objects. Hosts that consume this field
+     * should run it through `coerceClarificationRequests` to normalize.
+     */
+    requiresClarification?: Array<string | ClarificationRequest>;
+}
+/**
+ * A structured request for additional information from the user before
+ * a workflow can be deployed. Lets the host render a quick-pick UI and
+ * patch the draft at the named param path on resolution, instead of
+ * regenerating the workflow with the LLM.
+ */
+export interface ClarificationRequest {
+    /**
+     * Semantic category of the missing value. Determines how the host
+     * renders the picker (channel/server/recipient pickers vs. free text).
+     */
+    kind: 'target_channel' | 'target_server' | 'recipient' | 'value' | 'free_text';
+    /**
+     * Connector platform this clarification belongs to (e.g. 'discord',
+     * 'slack', 'telegram', 'gmail'). Drives catalog source selection.
+     */
+    platform?: string;
+    /**
+     * Narrowing scope for catalog lookups. For Discord channel pickers,
+     * `scope.guildId` constrains the channel list to a single guild.
+     */
+    scope?: {
+        guildId?: string;
+    };
+    /**
+     * Short, user-facing question rendered above the picker.
+     */
+    question: string;
+    /**
+     * JSON-style path into the draft workflow that points at the parameter
+     * the user's choice should populate. Supports dot and bracketed-string
+     * segments, e.g. `nodes["Discord Send"].parameters.channelId`.
+     */
+    paramPath: string;
+}
+export interface WorkflowNode extends Omit<INode, 'id' | 'parameters' | 'credentials' | 'position'> {
+    id?: string;
+    position: [number, number];
+    parameters: Record<string, unknown>;
+    credentials?: Record<string, WorkflowCredentialReference>;
+    color?: string;
+}
+export interface WorkflowCredentialReference extends Omit<INodeCredentialsDetails, 'id'> {
+    id: string;
+}
+export interface WorkflowConnections {
+    [nodeName: string]: {
+        [outputType: string]: Array<Array<{
+            node: string;
+            type: string;
+            index: number;
+        }>>;
+    };
+}
+export interface WorkflowDefinitionResponse extends WorkflowDefinition {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    versionId: string;
+}
+export interface WorkflowCredential {
+    id: string;
+    name: string;
+    type: string;
+    data?: Record<string, unknown>;
+    isResolvable?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkflowExecution {
+    id: string;
+    finished: boolean;
+    mode: 'cli' | 'error' | 'integrated' | 'internal' | 'manual' | 'retry' | 'trigger' | 'webhook' | 'evaluation' | 'chat';
+    retryOf?: string | null;
+    retrySuccessId?: string | null;
+    startedAt: string;
+    stoppedAt?: string | null;
+    workflowId: string;
+    status: 'canceled' | 'crashed' | 'error' | 'new' | 'running' | 'success' | 'unknown' | 'waiting';
+    waitTill?: string | null;
+    customData?: Record<string, unknown>;
+    data?: {
+        resultData?: {
+            runData?: Record<string, unknown[]>;
+            lastNodeExecuted?: string;
+            error?: {
+                message: string;
+                stack?: string;
+            };
+        };
+        executionData?: {
+            contextData?: Record<string, unknown>;
+            nodeExecutionStack?: unknown[];
+            waitingExecution?: Record<string, unknown>;
+        };
+    };
+}
+export interface WorkflowTag {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface NodeDefinition extends Omit<INodeTypeDescription, 'credentials' | 'group' | 'icon' | 'iconUrl' | 'inputs' | 'outputs' | 'polling' | 'properties' | 'triggerPanel' | 'webhooks'> {
+    icon?: string;
+    iconUrl?: string;
+    group: string[];
+    defaults: {
+        name: string;
+        color?: string;
+    };
+    inputs: string[] | string;
+    outputs: string[] | string;
+    credentials?: Array<{
+        name: string;
+        required: boolean;
+        displayOptions?: unknown;
+    }>;
+    properties: NodeProperty[];
+    webhooks?: Array<Record<string, unknown>>;
+    polling?: boolean;
+    triggerPanel?: unknown;
+}
+export interface NodePropertyOption {
+    name: string;
+    value?: string | number | boolean;
+    displayName?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface NodePropertyCollection {
+    name: string;
+    displayName?: string;
+    values: NodeProperty[];
+    [key: string]: unknown;
+}
+export interface NodeProperty extends Omit<INodeProperties, 'default' | 'displayOptions' | 'options' | 'routing' | 'type'> {
+    type: string;
+    default: unknown;
+    options?: Array<NodePropertyOption | NodePropertyCollection>;
+    displayOptions?: unknown;
+    placeholder?: string;
+    hint?: string;
+    routing?: unknown;
+    [key: string]: unknown;
+}
+export interface NodeSearchResult {
+    node: NodeDefinition;
+    score: number;
+    matchReason: string;
+}
+export interface IntegrationFilterResult {
+    remaining: NodeSearchResult[];
+    removed: NodeSearchResult[];
+}
+export interface KeywordExtractionResult {
+    keywords: string[];
+}
+/**
+ * Result of semantic workflow matching
+ */
+export interface WorkflowMatchResult {
+    matchedWorkflowId: string | null;
+    confidence: 'high' | 'medium' | 'low' | 'none';
+    matches: Array<{
+        id: string;
+        name: string;
+        score: number;
+    }>;
+    reason: string;
+}
+export interface WorkflowValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare const WORKFLOW_CREDENTIAL_PROVIDER_TYPE = "workflow_credential_provider";
+/**
+ * Result of a credential resolution attempt by an external provider.
+ */
+export type CredentialProviderResult = {
+    status: 'credential_data';
+    data: Record<string, unknown>;
+} | {
+    status: 'needs_auth';
+    authUrl: string;
+} | null;
+/**
+ * External credential provider interface.
+ *
+ * Hosts (e.g. eliza-cloud) can register a service implementing this interface
+ * to automatically resolve credentials (via OAuth, API keys, etc.).
+ * The plugin works without one — it's an optional enhancement.
+ *
+ * Register on runtime as service type 'workflow_credential_provider'.
+ */
+export interface CredentialProvider {
+    resolve(userId: string, credType: string): Promise<CredentialProviderResult>;
+    checkCredentialTypes?(credTypes: string[]): CheckCredentialTypesResult;
+}
+export interface CheckCredentialTypesResult {
+    supported: string[];
+    unsupported: string[];
+}
+export interface FeasibilityResult {
+    feasible: boolean;
+    reason: string;
+}
+/**
+ * Type guard to check if a service implements CredentialProvider
+ */
+export declare function isCredentialProvider(service: unknown): service is CredentialProvider;
+export declare const WORKFLOW_RUNTIME_CONTEXT_PROVIDER_TYPE = "workflow_runtime_context_provider";
+export interface RuntimeContextSupportedCredential {
+    credType: string;
+    friendlyName: string;
+    nodeTypes: string[];
+}
+/**
+ * Optional runtime-supplied context the host injects into the workflow-generation
+ * prompt. The plugin treats this as advisory information for the LLM:
+ * - `supportedCredentials` becomes a "## Available Credentials" section so the
+ *   LLM only references credential types the host can actually resolve.
+ * - `facts` becomes a "## Runtime Facts" section with real values (Discord
+ *   guilds/channels, the user's Gmail email, etc.) so the LLM substitutes
+ *   them verbatim instead of emitting `{{YOUR_…}}` placeholders.
+ *
+ * The plugin works without a provider — both sections are simply omitted.
+ */
+export interface RuntimeContext {
+    /**
+     * Optional. When omitted (or empty), the generation prompt simply
+     * skips the "## Available Credentials" section. Implementers can
+     * return only what they have without fabricating empty arrays.
+     */
+    supportedCredentials?: RuntimeContextSupportedCredential[];
+    /**
+     * Optional. When omitted (or empty), the generation prompt simply
+     * skips the "## Runtime Facts" section.
+     */
+    facts?: string[];
+    /**
+     * Optional bias hint for keyword extraction. Lowercase provider tags the
+     * host knows it can satisfy (e.g. `["gmail", "discord"]`). When present,
+     * keyword extraction nudges the LLM toward these providers and away from
+     * generic fallbacks (e.g. emit `gmail` not `imap`, `discord` not
+     * `webhook`). Always optional — older hosts that omit it keep working.
+     */
+    preferredProviders?: string[];
+}
+/**
+ * Originating-conversation routing context. Hosts pass this when the workflow
+ * is being generated from inside a platform conversation (e.g. a Discord DM),
+ * so the LLM can target "this channel" / "back to me" without the user having
+ * to name an ID. The host typically derives it from the inbound message's
+ * `MessageMetadata` and surfaces it as a fact line ("This workflow was
+ * prompted from Discord channel #foo (id 123) in Bar (id 456)…").
+ *
+ * All fields are optional. Hosts only fill the platform block that matches
+ * the trigger source. `resolvedNames` lets the host pass human names for the
+ * channel / server (when available) so the prompt can reference them in
+ * natural language.
+ */
+export interface TriggerContext {
+    /** Source platform — `"discord" | "telegram" | "slack" | "gmail" | …` */
+    source?: string;
+    discord?: {
+        channelId?: string;
+        guildId?: string;
+        threadId?: string;
+    };
+    telegram?: {
+        chatId?: string | number;
+        threadId?: string | number;
+    };
+    slack?: {
+        channelId?: string;
+        teamId?: string;
+    };
+    resolvedNames?: {
+        channel?: string;
+        server?: string;
+    };
+}
+export interface RuntimeContextProviderInput {
+    userId: string;
+    relevantNodes: NodeDefinition[];
+    relevantCredTypes: string[];
+    /**
+     * Optional originating-conversation context. Forward-compatible: hosts that
+     * don't know about it simply omit the field.
+     */
+    triggerContext?: TriggerContext;
+}
+export interface RuntimeContextProvider {
+    getRuntimeContext(input: RuntimeContextProviderInput): Promise<RuntimeContext>;
+}
+/**
+ * Type guard to check if a service implements RuntimeContextProvider.
+ */
+export declare function isRuntimeContextProvider(service: unknown): service is RuntimeContextProvider;
+export declare const WORKFLOW_CREDENTIAL_STORE_TYPE = "workflow_credential_store";
+/**
+ * Runtime event emitted by the host (e.g. agent connector routes) when a
+ * connector is disconnected. WorkflowCredentialStore subscribes to this in
+ * `start()` and purges its cached credential ids for the supplied credTypes,
+ * so the next workflow generation surfaces `needs_auth` instead of returning
+ * a stale id.
+ *
+ * Payload shape kept minimal and serializable so any host can emit without
+ * pulling in plugin-workflow types — `userId` + `credTypes` is enough for
+ * the store to do its job. `connectorName` is informational for subscribers
+ * that want richer context.
+ */
+export declare const CONNECTOR_DISCONNECTED_EVENT = "connector_disconnected";
+export interface ConnectorDisconnectedPayload extends EventPayload {
+    /** Owner of the credentials to purge — typically `runtime.agentId`. */
+    userId: string;
+    /**
+     * Workflow credential type ids tied to the disconnected connector
+     * (e.g. `['gmailOAuth2', 'gmailOAuth2Api']`). Empty list ⇒ no-op.
+     */
+    credTypes: readonly string[];
+    /** Connector name (e.g. `'gmail'`). Informational. */
+    connectorName?: string;
+}
+export interface CredentialMapping {
+    credType: string;
+    workflowCredentialId: string;
+}
+export interface WorkflowCredentialStoreApi {
+    get(userId: string, credType: string): Promise<string | null>;
+    set(userId: string, credType: string, workflowCredId: string): Promise<void>;
+    listByUser(userId: string): Promise<CredentialMapping[]>;
+    /**
+     * Forget the cached workflows credential id for (userId, credType). The next
+     * resolution falls back to credProvider so a disconnect-then-prompt flow
+     * surfaces `needs_auth` instead of reusing stale credentials.
+     *
+     * Optional: external/custom credential-store implementations that pre-date
+     * this method continue to satisfy the interface; hosts that need to cascade
+     * a disconnect must check for the method (`store.delete?.(userId, credType)`)
+     * before calling.
+     */
+    delete?(userId: string, credType: string): Promise<void>;
+}
+export interface CredentialResolutionResult {
+    workflow: WorkflowDefinition;
+    missingConnections: MissingConnection[];
+    injectedCredentials: Map<string, string>;
+}
+export interface MissingConnection {
+    credType: string;
+    authUrl?: string;
+}
+export interface WorkflowPluginConfig {
+    apiKey: string;
+    host: string;
+    credentials?: Record<string, string>;
+}
+export interface WorkflowDraft {
+    workflow: WorkflowDefinition;
+    prompt: string;
+    userId: string;
+    createdAt: number;
+    /** ID of the message that created this draft — used to prevent same-turn auto-confirm. */
+    originMessageId?: string;
+}
+export interface DraftIntentResult {
+    intent: 'confirm' | 'cancel' | 'modify' | 'new' | 'show_preview';
+    modificationRequest?: string;
+    reason: string;
+}
+export interface WorkflowCreationResult {
+    id: string;
+    name: string;
+    active: boolean;
+    nodeCount: number;
+    missingCredentials: MissingConnection[];
+}
+export declare class WorkflowApiError extends Error {
+    statusCode?: number | undefined;
+    response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined);
+}
+export declare class UnsupportedIntegrationError extends Error {
+    unsupportedServices: string[];
+    availableServices: string[];
+    constructor(unsupportedServices: string[], availableServices: string[]);
+}
+/**
+ * JSON schema content from workflows output schemas
+ */
+export interface SchemaContent {
+    type: string;
+    properties?: Record<string, unknown>;
+    items?: SchemaContent;
+    [key: string]: unknown;
+}
+/**
+ * Expression reference found in node parameters
+ */
+export interface ExpressionRef {
+    fullExpression: string;
+    field: string;
+    path: string[];
+    paramPath: string;
+    sourceNodeName?: string;
+}
+/**
+ * Invalid output reference detected during validation
+ */
+export interface OutputRefValidation {
+    nodeName: string;
+    expression: string;
+    field: string;
+    sourceNodeName: string;
+    sourceNodeType: string;
+    resource: string;
+    operation: string;
+    availableFields: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,59 @@
+// Credential provider types
+export const WORKFLOW_CREDENTIAL_PROVIDER_TYPE = 'workflow_credential_provider';
+/**
+ * Type guard to check if a service implements CredentialProvider
+ */
+export function isCredentialProvider(service) {
+    if (!service || typeof service !== 'object') {
+        return false;
+    }
+    return typeof service.resolve === 'function';
+}
+// Runtime context provider types
+export const WORKFLOW_RUNTIME_CONTEXT_PROVIDER_TYPE = 'workflow_runtime_context_provider';
+/**
+ * Type guard to check if a service implements RuntimeContextProvider.
+ */
+export function isRuntimeContextProvider(service) {
+    if (!service || typeof service !== 'object') {
+        return false;
+    }
+    return typeof service.getRuntimeContext === 'function';
+}
+// Credential store types
+export const WORKFLOW_CREDENTIAL_STORE_TYPE = 'workflow_credential_store';
+/**
+ * Runtime event emitted by the host (e.g. agent connector routes) when a
+ * connector is disconnected. WorkflowCredentialStore subscribes to this in
+ * `start()` and purges its cached credential ids for the supplied credTypes,
+ * so the next workflow generation surfaces `needs_auth` instead of returning
+ * a stale id.
+ *
+ * Payload shape kept minimal and serializable so any host can emit without
+ * pulling in plugin-workflow types — `userId` + `credTypes` is enough for
+ * the store to do its job. `connectorName` is informational for subscribers
+ * that want richer context.
+ */
+export const CONNECTOR_DISCONNECTED_EVENT = 'connector_disconnected';
+// Error types
+export class WorkflowApiError extends Error {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'WorkflowApiError';
+    }
+}
+export class UnsupportedIntegrationError extends Error {
+    unsupportedServices;
+    availableServices;
+    constructor(unsupportedServices, availableServices) {
+        super(`Unsupported integrations: ${unsupportedServices.join(', ')}`);
+        this.unsupportedServices = unsupportedServices;
+        this.availableServices = availableServices;
+        this.name = 'UnsupportedIntegrationError';
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AA6QA,4BAA4B;AAE5B,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAkChF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,OAAQ,OAAmC,CAAC,OAAO,KAAK,UAAU,CAAC;AAC5E,CAAC;AAED,iCAAiC;AAEjC,MAAM,CAAC,MAAM,sCAAsC,GAAG,mCAAmC,CAAC;AA8E1F;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,OAAQ,OAAmC,CAAC,iBAAiB,KAAK,UAAU,CAAC;AACtF,CAAC;AAED,yBAAyB;AAEzB,MAAM,CAAC,MAAM,8BAA8B,GAAG,2BAA2B,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAkFrE,cAAc;AAEd,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGhC;IACA;IAHT,YACE,OAAe,EACR,UAAmB,EACnB,QAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAU;QAGzB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAE3C;IACA;IAFT,YACS,mBAA6B,EAC7B,iBAA2B;QAElC,KAAK,CAAC,6BAA6B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAH9D,wBAAmB,GAAnB,mBAAmB,CAAU;QAC7B,sBAAiB,GAAjB,iBAAiB,CAAU;QAGlC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF"}

package/dist/utils/catalog.d.ts

@@ -0,0 +1,16 @@
+import type { IntegrationFilterResult, NodeDefinition, NodeSearchResult } from '../types/index';
+/** Get all nodes in the catalog. Used by route handlers for unfiltered listing. */
+export declare function getAllNodes(): NodeDefinition[];
+/**
+ * Look up a node definition by its type name.
+ *
+ * Handles full names ("workflows-nodes-base.httpRequest") and bare names ("httpRequest").
+ */
+export declare function getNodeDefinition(typeName: string): NodeDefinition | undefined;
+/**
+ * Scoring: exact name 10, word-boundary 7, substring 3, category 3, description 2, word 1
+ */
+export declare function searchNodes(keywords: string[], limit?: number): NodeSearchResult[];
+export declare function filterNodesByIntegrationSupport(nodes: NodeSearchResult[], supportedCredTypes: Set<string>): IntegrationFilterResult;
+export declare function simplifyNodeForLLM(node: NodeDefinition): NodeDefinition;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/utils/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/utils/catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EAEd,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAUxB,mFAAmF;AACnF,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAW9E;AAWD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE,CAiE9E;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,gBAAgB,EAAE,EACzB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,uBAAuB,CAuBzB;AAmFD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAgCvE"}