@elizaos/plugin-workflow 2.0.0-beta.1

package/dist/utils/catalog.js

@@ -0,0 +1,211 @@
+import defaultNodesData from '../data/defaultNodes.json';
+/**
+ * workflows node catalog with keyword-based search
+ * @note Uses embedded catalog (457 nodes as of April 2025)
+ * @todo Add dynamic refresh via GET /node-types in v2
+ */
+const NODE_CATALOG = defaultNodesData;
+/** Get all nodes in the catalog. Used by route handlers for unfiltered listing. */
+export function getAllNodes() {
+    return NODE_CATALOG;
+}
+/**
+ * Look up a node definition by its type name.
+ *
+ * Handles full names ("workflows-nodes-base.httpRequest") and bare names ("httpRequest").
+ */
+export function getNodeDefinition(typeName) {
+    const exact = NODE_CATALOG.find((n) => n.name === typeName);
+    if (exact) {
+        return exact;
+    }
+    const bare = typeName.replace(/^workflows-nodes-base\./, '');
+    return NODE_CATALOG.find((n) => {
+        const catalogBare = n.name.replace(/^workflows-nodes-base\./, '');
+        return catalogBare === bare || n.name === bare;
+    });
+}
+/** Split a name into lowercase tokens on camelCase / dot / hyphen / underscore / @ / slash boundaries */
+function tokenize(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase → words
+        .split(/[\s.\-_@/]+/)
+        .map((t) => t.toLowerCase())
+        .filter(Boolean);
+}
+/**
+ * Scoring: exact name 10, word-boundary 7, substring 3, category 3, description 2, word 1
+ */
+export function searchNodes(keywords, limit = 15) {
+    if (keywords.length === 0) {
+        return [];
+    }
+    const normalizedKeywords = keywords.map((kw) => kw.toLowerCase().trim());
+    const scoredNodes = NODE_CATALOG.filter((node) => node.name && node.displayName).map((node) => {
+        let score = 0;
+        const matchReasons = [];
+        const nodeName = node.name.toLowerCase();
+        const nodeDisplayName = node.displayName.toLowerCase();
+        const nodeDescription = node.description?.toLowerCase() || '';
+        const nameTokens = tokenize(node.name);
+        const displayTokens = tokenize(node.displayName);
+        for (const keyword of normalizedKeywords) {
+            if (nodeName === keyword || nodeDisplayName === keyword) {
+                score += 10;
+                matchReasons.push(`exact match: "${keyword}"`);
+                continue;
+            }
+            // Word-boundary match: keyword equals a token in the name
+            const isWordMatch = nameTokens.some((t) => t === keyword) || displayTokens.some((t) => t === keyword);
+            if (isWordMatch) {
+                score += 7;
+                matchReasons.push(`word match: "${keyword}"`);
+            }
+            else if (nodeName.includes(keyword) || nodeDisplayName.includes(keyword)) {
+                score += 3;
+                matchReasons.push(`name contains: "${keyword}"`);
+            }
+            if (nodeDescription.includes(keyword)) {
+                score += 2;
+                matchReasons.push(`description contains: "${keyword}"`);
+            }
+            const descriptionWords = nodeDescription.split(/\s+/);
+            if (descriptionWords.some((word) => word.includes(keyword))) {
+                score += 1;
+            }
+            if (node.group.some((group) => group.toLowerCase().includes(keyword))) {
+                score += 3;
+                matchReasons.push(`category: "${keyword}"`);
+            }
+        }
+        return {
+            node,
+            score,
+            matchReason: matchReasons.join(', ') || 'no strong match',
+        };
+    });
+    return scoredNodes
+        .filter((result) => result.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+export function filterNodesByIntegrationSupport(nodes, supportedCredTypes) {
+    const remaining = [];
+    const removed = [];
+    for (const result of nodes) {
+        const creds = result.node.credentials;
+        // No credentials → utility node → always keep
+        if (!creds || creds.length === 0) {
+            remaining.push(result);
+            continue;
+        }
+        // Service node: keep if ANY credential type is supported
+        const hasSupported = creds.some((c) => supportedCredTypes.has(c.name));
+        if (hasSupported) {
+            remaining.push(result);
+        }
+        else {
+            removed.push(result);
+        }
+    }
+    return { remaining, removed };
+}
+const NOISE_TYPES = new Set(['notice', 'hidden']);
+const STRIP_KEYS = new Set([
+    'routing',
+    'displayOptions',
+    'typeOptions',
+    'hint',
+    'isNodeSetting',
+    'noDataExpression',
+    'validateType',
+    'ignoreValidationDuringExecution',
+    'requiresDataPath',
+    'disabledOptions',
+    'credentialTypes',
+    'modes',
+]);
+function isPropertyCollectionOption(option) {
+    return Array.isArray(option.values);
+}
+function simplifyProperty(prop) {
+    if (NOISE_TYPES.has(prop.type)) {
+        return null;
+    }
+    const slim = { ...prop };
+    for (const key of STRIP_KEYS) {
+        delete slim[key];
+    }
+    if (prop.type === 'resourceLocator') {
+        slim.type = 'string';
+        slim.default = '';
+        slim.description = slim.description || `${prop.displayName} ID`;
+    }
+    if (prop.options && Array.isArray(prop.options)) {
+        slim.options = prop.options.map((opt) => {
+            if (isPropertyCollectionOption(opt)) {
+                return {
+                    name: opt.name,
+                    displayName: opt.displayName,
+                    values: opt.values.map(simplifyProperty).filter((v) => v !== null),
+                };
+            }
+            const { description: _d, ...rest } = opt;
+            return rest;
+        });
+    }
+    return slim;
+}
+/**
+ * Derive a `{ credType: requiredAuthValue }` map from a node's catalog
+ * credential entries. So Gmail's catalog produces
+ * `{ gmailOAuth2: "oAuth2", googleApi: "serviceAccount" }`. The LLM uses
+ * this to set `parameters.authentication` correctly when attaching a
+ * credentials block (Session 21 anti-hallucination Layer 2).
+ *
+ * Returns undefined when no credential entries gate on `authentication`.
+ */
+function buildCredentialAuthMatrix(node) {
+    if (!node.credentials?.length) {
+        return undefined;
+    }
+    const out = {};
+    for (const cred of node.credentials) {
+        const authValues = cred.displayOptions
+            ?.show?.authentication;
+        if (Array.isArray(authValues) && authValues.length === 1) {
+            out[cred.name] = authValues[0];
+        }
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function simplifyNodeForLLM(node) {
+    const cleaned = node.properties
+        .map(simplifyProperty)
+        .filter((p) => p !== null);
+    const seen = new Set();
+    const deduped = [];
+    for (const prop of cleaned) {
+        if (seen.has(prop.name)) {
+            continue;
+        }
+        seen.add(prop.name);
+        deduped.push(prop);
+    }
+    // Layer 2 (Session 21): always emit `version` as an array so the LLM
+    // sees the EXACT set of valid values (catches typeVersion hallucinations
+    // like 2.2 when only [1, 2, 2.1] exist). Pair with the prompt rule
+    // "pick the highest from version[]; never invent versions".
+    const versions = Array.isArray(node.version) ? [...node.version] : [node.version];
+    // Layer 2 (Session 21): expose the credential→authentication mapping
+    // so the LLM sets `parameters.authentication` correctly when it
+    // attaches a credentials block.
+    const credentialAuthMatrix = buildCredentialAuthMatrix(node);
+    return {
+        ...node,
+        version: versions,
+        properties: deduped,
+        ...(credentialAuthMatrix ? { credentialAuthMatrix } : {}),
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/utils/catalog.js.map

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

package/dist/utils/clarification.d.ts

@@ -0,0 +1,17 @@
+import type { ClarificationRequest } from '../types';
+/**
+ * Marker used by the service to flag clarifications produced by post-LLM
+ * catalog validation (vs. clarifications emitted by the LLM itself). Hosts
+ * may surface these differently if needed.
+ */
+export declare const CATALOG_CLARIFICATION_SUFFIX = "\u2014 please provide this value or clarify your requirements";
+export declare function isCatalogClarificationString(value: string): boolean;
+export declare function isCatalogClarification(item: string | ClarificationRequest): boolean;
+/**
+ * Normalize a mixed-shape clarifications array into structured
+ * `ClarificationRequest` objects. Legacy strings become `kind: 'free_text'`
+ * with an empty `paramPath` (host renders a free-form input instead of a
+ * picker). Structured items pass through unchanged.
+ */
+export declare function coerceClarificationRequests(items: ReadonlyArray<string | ClarificationRequest> | undefined | null): ClarificationRequest[];
+//# sourceMappingURL=clarification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clarification.d.ts","sourceRoot":"","sources":["../../src/utils/clarification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,kEACmB,CAAC;AAE7D,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,OAAO,CAInF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,oBAAoB,CAAC,GAAG,SAAS,GAAG,IAAI,GACrE,oBAAoB,EAAE,CAuBxB"}

package/dist/utils/clarification.js

@@ -0,0 +1,46 @@
+/**
+ * Marker used by the service to flag clarifications produced by post-LLM
+ * catalog validation (vs. clarifications emitted by the LLM itself). Hosts
+ * may surface these differently if needed.
+ */
+export const CATALOG_CLARIFICATION_SUFFIX = '— please provide this value or clarify your requirements';
+export function isCatalogClarificationString(value) {
+    return value.endsWith(CATALOG_CLARIFICATION_SUFFIX);
+}
+export function isCatalogClarification(item) {
+    return typeof item === 'string'
+        ? isCatalogClarificationString(item)
+        : isCatalogClarificationString(item.question);
+}
+/**
+ * Normalize a mixed-shape clarifications array into structured
+ * `ClarificationRequest` objects. Legacy strings become `kind: 'free_text'`
+ * with an empty `paramPath` (host renders a free-form input instead of a
+ * picker). Structured items pass through unchanged.
+ */
+export function coerceClarificationRequests(items) {
+    if (!items || items.length === 0) {
+        return [];
+    }
+    const out = [];
+    for (const item of items) {
+        if (typeof item === 'string') {
+            const trimmed = item.trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            out.push({ kind: 'free_text', question: trimmed, paramPath: '' });
+        }
+        else if (item && typeof item === 'object' && typeof item.question === 'string') {
+            out.push({
+                kind: item.kind ?? 'free_text',
+                platform: item.platform,
+                scope: item.scope,
+                question: item.question,
+                paramPath: typeof item.paramPath === 'string' ? item.paramPath : '',
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=clarification.js.map

package/dist/utils/clarification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarification.js","sourceRoot":"","sources":["../../src/utils/clarification.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,0DAA0D,CAAC;AAE7D,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,KAAK,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAmC;IACxE,OAAO,OAAO,IAAI,KAAK,QAAQ;QAC7B,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC;QACpC,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAsE;IAEtE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,SAAS;YACX,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjF,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,WAAW;gBAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/context.d.ts

@@ -0,0 +1,4 @@
+import type { IAgentRuntime, Memory, State } from '@elizaos/core';
+export declare function buildConversationContext(message: Memory, state: State | undefined): string;
+export declare function getUserTagName(runtime: IAgentRuntime, userId: string): Promise<string>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAQ,MAAM,eAAe,CAAC;AAExE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAU1F;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5F"}

package/dist/utils/context.js

@@ -0,0 +1,18 @@
+export function buildConversationContext(message, state) {
+    const raw = state?.values?.recentMessages;
+    const recentMessages = typeof raw === 'string' ? raw : '';
+    const currentText = message.content?.text ?? '';
+    if (!recentMessages) {
+        return currentText;
+    }
+    return `${recentMessages}\n\nCurrent request: ${currentText}`;
+}
+export async function getUserTagName(runtime, userId) {
+    const entity = await runtime.getEntityById(userId);
+    const shortId = userId.replace(/-/g, '').slice(0, 8);
+    const name = entity?.names?.[0];
+    // ElizaOS default name is "User" + UUID — not useful for a tag
+    const isRealName = name && !name.includes(userId.slice(0, 8));
+    return isRealName ? `${name}_${shortId}` : `user_${shortId}`;
+}
+//# sourceMappingURL=context.js.map

package/dist/utils/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,KAAwB;IAChF,MAAM,GAAG,GAAG,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC;IAC1C,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IAEhD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,GAAG,cAAc,wBAAwB,WAAW,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAsB,EAAE,MAAc;IACzE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAc,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,+DAA+D;IAC/D,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/dist/utils/credentialResolver.d.ts

@@ -0,0 +1,22 @@
+import type { CredentialProvider, CredentialResolutionResult, WorkflowCredentialStoreApi, WorkflowDefinition, WorkflowPluginConfig } from '../types/index';
+interface CredentialApiClient {
+    createCredential(credential: {
+        name: string;
+        type: string;
+        data: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+    }>;
+}
+/**
+ * Resolve and inject credentials into workflow.
+ *
+ * Resolution chain (first match wins):
+ *   1. Credential store DB — cached mappings from previous resolutions
+ *   2. Static config — character.settings.workflows.credentials
+ *   3. External provider — registered CredentialProvider service (e.g. cloud OAuth)
+ *   4. Missing — reported for manual configuration in workflows
+ */
+export declare function resolveCredentials(workflow: WorkflowDefinition, userId: string, config: WorkflowPluginConfig, credStore: WorkflowCredentialStoreApi | null, credProvider: CredentialProvider | null, apiClient: CredentialApiClient | null, tagName: string): Promise<CredentialResolutionResult>;
+export {};
+//# sourceMappingURL=credentialResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentialResolver.d.ts","sourceRoot":"","sources":["../../src/utils/credentialResolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAE1B,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAExB,UAAU,mBAAmB;IAC3B,gBAAgB,CAAC,UAAU,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,0BAA0B,GAAG,IAAI,EAC5C,YAAY,EAAE,kBAAkB,GAAG,IAAI,EACvC,SAAS,EAAE,mBAAmB,GAAG,IAAI,EACrC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,0BAA0B,CAAC,CAsCrC"}

package/dist/utils/credentialResolver.js

@@ -0,0 +1,146 @@
+import { logger } from '@elizaos/core';
+/**
+ * Resolve and inject credentials into workflow.
+ *
+ * Resolution chain (first match wins):
+ *   1. Credential store DB — cached mappings from previous resolutions
+ *   2. Static config — character.settings.workflows.credentials
+ *   3. External provider — registered CredentialProvider service (e.g. cloud OAuth)
+ *   4. Missing — reported for manual configuration in workflows
+ */
+export async function resolveCredentials(workflow, userId, config, credStore, credProvider, apiClient, tagName) {
+    const requiredCredTypes = extractRequiredCredentialTypes(workflow);
+    if (requiredCredTypes.size === 0) {
+        return {
+            workflow,
+            missingConnections: [],
+            injectedCredentials: new Map(),
+        };
+    }
+    const injectedCredentials = new Map();
+    const missingConnections = [];
+    for (const credType of requiredCredTypes) {
+        const credId = await resolveOneCredential(credType, userId, config, credStore, credProvider, apiClient, missingConnections, tagName);
+        if (credId) {
+            injectedCredentials.set(credType, credId);
+        }
+    }
+    const resolvedWorkflow = injectCredentialIds(workflow, injectedCredentials);
+    return {
+        workflow: resolvedWorkflow,
+        missingConnections,
+        injectedCredentials,
+    };
+}
+async function resolveOneCredential(credType, userId, config, credStore, credProvider, apiClient, missingConnections, tagName) {
+    // 1. Credential store DB
+    const cachedId = await credStore?.get(userId, credType);
+    if (cachedId) {
+        logger.debug({ src: 'plugin:workflow:utils:credentials' }, `Resolved ${credType} from credential store`);
+        return cachedId;
+    }
+    // 2. Static config
+    if (config.credentials) {
+        const configId = findCredentialId(config.credentials, credType);
+        if (configId) {
+            return configId;
+        }
+    }
+    // 3. External provider
+    if (credProvider) {
+        try {
+            const result = await credProvider.resolve(userId, credType);
+            if (result?.status === 'credential_data') {
+                if (!apiClient) {
+                    logger.error({ src: 'plugin:workflow:utils:credentials' }, `Received credential_data for ${credType} but no apiClient available`);
+                    missingConnections.push({ credType });
+                    return null;
+                }
+                const credName = `${credType}_${tagName}`;
+                const workflowsCred = await apiClient.createCredential({
+                    name: credName,
+                    type: credType,
+                    data: result.data,
+                });
+                try {
+                    await credStore?.set(userId, credType, workflowsCred.id);
+                }
+                catch (cacheError) {
+                    logger.warn({ src: 'plugin:workflow:utils:credentials' }, `Failed to cache credential mapping for ${credType} (credential still usable): ${cacheError instanceof Error ? cacheError.message : String(cacheError)}`);
+                }
+                logger.info({ src: 'plugin:workflow:utils:credentials' }, `Created workflows credential for ${credType}: ${workflowsCred.id}`);
+                return workflowsCred.id;
+            }
+            if (result?.status === 'needs_auth') {
+                missingConnections.push({ credType, authUrl: result.authUrl });
+                return null;
+            }
+        }
+        catch (error) {
+            logger.error({ src: 'plugin:workflow:utils:credentials' }, `Credential provider failed for ${credType}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // 4. Missing
+    missingConnections.push({ credType });
+    return null;
+}
+/**
+ * Look up a credential ID from config, tolerating naming mismatches
+ * (e.g. LLM generates "gmailOAuth2Api" but config has "gmailOAuth2", or vice-versa).
+ */
+function findCredentialId(credentials, credType) {
+    if (credentials[credType]) {
+        return credentials[credType];
+    }
+    // Fuzzy: try without "Api" suffix (e.g. "gmailOAuth2Api" → "gmailOAuth2")
+    const withoutApi = credType.replace(/Api$/, '');
+    if (withoutApi !== credType && credentials[withoutApi]) {
+        logger.debug({ src: 'plugin:workflow:utils:credentials' }, `Fuzzy credential match: "${credType}" → "${withoutApi}" (removed Api suffix)`);
+        return credentials[withoutApi];
+    }
+    // Fuzzy: try with "Api" suffix (e.g. "gmailOAuth2" → "gmailOAuth2Api")
+    const withApi = `${credType}Api`;
+    if (credentials[withApi]) {
+        logger.debug({ src: 'plugin:workflow:utils:credentials' }, `Fuzzy credential match: "${credType}" → "${withApi}" (added Api suffix)`);
+        return credentials[withApi];
+    }
+    return null;
+}
+function extractRequiredCredentialTypes(workflow) {
+    const credTypes = new Set();
+    for (const node of workflow.nodes) {
+        if (node.credentials) {
+            for (const credType of Object.keys(node.credentials)) {
+                credTypes.add(credType);
+            }
+        }
+    }
+    return credTypes;
+}
+function injectCredentialIds(workflow, credentialMap) {
+    const injected = { ...workflow };
+    injected.nodes = workflow.nodes.map((node) => {
+        if (!node.credentials) {
+            return node;
+        }
+        const updatedCredentials = {};
+        for (const [credType, credRef] of Object.entries(node.credentials)) {
+            const credId = credentialMap.get(credType);
+            if (credId) {
+                updatedCredentials[credType] = {
+                    id: credId,
+                    name: credRef.name,
+                };
+            }
+            else {
+                updatedCredentials[credType] = credRef;
+            }
+        }
+        return {
+            ...node,
+            credentials: updatedCredentials,
+        };
+    });
+    return injected;
+}
+//# sourceMappingURL=credentialResolver.js.map

package/dist/utils/credentialResolver.js.map

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

package/dist/utils/generation.d.ts

@@ -0,0 +1,36 @@
+import { type IAgentRuntime } from '@elizaos/core';
+import type { DraftIntentResult, FeasibilityResult, NodeDefinition, NodeSearchResult, OutputRefValidation, RuntimeContext, WorkflowDefinition, WorkflowDraft, WorkflowMatchResult } from '../types/index';
+import type { UnknownParamDetection } from './workflow';
+export declare function extractKeywords(runtime: IAgentRuntime, userPrompt: string, preferredProviders?: string[]): Promise<string[]>;
+export declare function matchWorkflow(runtime: IAgentRuntime, userRequest: string, workflows: WorkflowDefinition[]): Promise<WorkflowMatchResult>;
+export declare function classifyDraftIntent(runtime: IAgentRuntime, userMessage: string, draft: WorkflowDraft): Promise<DraftIntentResult>;
+/**
+ * Layer 3 retry helper (Session 21). When `validateAndRepair` flags errors
+ * it can't auto-fix deterministically (e.g. truly unknown output field),
+ * send a surgical fix prompt to the LLM listing only the failing items
+ * and re-validate. The caller wraps this in a 3-attempt loop.
+ *
+ * Lives next to `correctFieldReferences` and `correctParameterNames` —
+ * those are still the preferred specific-class corrections. This is the
+ * generic backstop for any remaining error class.
+ */
+export declare function fixWorkflowErrors(runtime: IAgentRuntime, workflow: WorkflowDefinition, errors: Array<{
+    kind: string;
+    node: string;
+    detail: string;
+    expression?: string;
+    availableFields?: string[];
+}>, relevantNodes: NodeDefinition[]): Promise<WorkflowDefinition>;
+export declare function generateWorkflow(runtime: IAgentRuntime, userPrompt: string, relevantNodes: NodeDefinition[], runtimeContext?: RuntimeContext): Promise<WorkflowDefinition>;
+export declare function modifyWorkflow(runtime: IAgentRuntime, existingWorkflow: WorkflowDefinition, modificationRequest: string, relevantNodes: NodeDefinition[], runtimeContext?: RuntimeContext): Promise<WorkflowDefinition>;
+export declare function collectExistingNodeDefinitions(workflow: WorkflowDefinition): NodeDefinition[];
+export declare function formatActionResponse(runtime: IAgentRuntime, responseType: string, data: Record<string, unknown>): Promise<string>;
+export declare function assessFeasibility(runtime: IAgentRuntime, userPrompt: string, removedNodes: NodeSearchResult[], remainingNodes: NodeSearchResult[]): Promise<FeasibilityResult>;
+/**
+ * Auto-corrects invalid field references in expressions using parallel LLM calls.
+ * Returns a new workflow with corrected expressions.
+ */
+export declare function correctFieldReferences(runtime: IAgentRuntime, workflow: WorkflowDefinition, invalidRefs: OutputRefValidation[]): Promise<WorkflowDefinition>;
+/** Deterministic fast path + LLM fallback for parameter name correction. */
+export declare function correctParameterNames(runtime: IAgentRuntime, workflow: WorkflowDefinition, detections: UnknownParamDetection[]): Promise<WorkflowDefinition>;
+//# sourceMappingURL=generation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/utils/generation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,eAAe,CAAC;AAOtE,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AASxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiDxD,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAuCnB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,EAAE,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAsE9B;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA6C5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC,EACF,aAAa,EAAE,cAAc,EAAE,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAwD7B;AAuMD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,cAAc,EAAE,EAC/B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CA2B7B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,kBAAkB,EACpC,mBAAmB,EAAE,MAAM,EAC3B,aAAa,EAAE,cAAc,EAAE,EAC/B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAmC7B;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAsB7F;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAkCD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,gBAAgB,EAAE,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,EAAE,mBAAmB,EAAE,GACjC,OAAO,CAAC,kBAAkB,CAAC,CA6D7B;AAqDD,4EAA4E;AAC5E,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,qBAAqB,EAAE,GAClC,OAAO,CAAC,kBAAkB,CAAC,CA+H7B"}