@rubytech/create-realagent 1.0.406

package/payload/platform/plugins/waitlist/mcp/dist/tools/waitlist-setup.js

@@ -0,0 +1,336 @@
+/**
+ * Set up automatic waitlist extraction as a workflow.
+ *
+ * Creates:
+ *   1. A Workflow node with 3 steps (scan → LLM extract → persist)
+ *   2. A scheduled Event that dispatches workflow-execute at the
+ *      specified interval
+ *
+ * The extraction prompt is stored in the LLM step and is visible
+ * via workflow-get and editable via workflow-update. The user can
+ * change what fields are extracted, adjust the model, or modify
+ * the prompt — all through conversation.
+ *
+ * Idempotent: if the workflow already exists, returns its details.
+ * Cleans up old-style events that pointed at the removed
+ * waitlist-extract tool.
+ */
+import { randomUUID } from "node:crypto";
+import { getSession } from "../lib/neo4j.js";
+import { computeEmbedding } from "../lib/embedding.js";
+import cronParser from "cron-parser";
+const { parseExpression } = cronParser;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const WORKFLOW_NAME = "Waitlist lead extraction";
+const DEFAULT_RECURRENCE = "0 */4 * * *"; // Every 4 hours
+/**
+ * The extraction prompt — migrated from the former anthropic.ts Haiku call.
+ * This is the editable payload: the user sees it via workflow-get and
+ * modifies it via workflow-update to change extraction behaviour.
+ */
+const EXTRACTION_PROMPT = "You extract contact details and customer discovery intelligence from visitor chat conversations.\n\n" +
+    "Below is a JSON object containing public agent conversations. It has a `conversations` array " +
+    "where each element has a `conversationId` and a `messages` array of user message strings. " +
+    "For each conversation that contains an email address, extract the visitor's details.\n\n" +
+    "Return ONLY a JSON array of objects. Each object must have these fields:\n" +
+    '- "email": the visitor\'s email address (required — skip conversations with no email)\n' +
+    '- "givenName": the visitor\'s first/given name, or null if unclear\n' +
+    '- "familyName": the visitor\'s last/family name, or null if unclear\n' +
+    '- "conversationId": the conversation ID from the input data\n' +
+    '- "businessType": what kind of business they run or work in, or null\n' +
+    '- "role": their role or position, or null\n' +
+    '- "needs": what they need or are looking for, in their own words where possible, or null\n' +
+    '- "challenges": pain points or challenges they mentioned, or null\n' +
+    '- "interests": specific features, capabilities, or topics they asked about, or null\n' +
+    '- "engagementQuality": one of "high" (asked detailed questions, shared specifics), ' +
+    '"medium" (some back-and-forth, genuine interest), or "low" (brief, noncommittal), or null\n' +
+    '- "otherSignals": any other noteworthy signal (timeline urgency, competitor mentions, referral source), or null\n\n' +
+    "Only include fields where the visitor actually revealed information. " +
+    "Return valid JSON only. No markdown, no explanation. If no conversations contain an email, return [].\n\n" +
+    "Conversations:\n{{conversations}}";
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export async function waitlistSetup(params) {
+    const { accountId, timezone } = params;
+    const recurrence = params.recurrence ?? DEFAULT_RECURRENCE;
+    const session = getSession();
+    try {
+        // ------------------------------------------------------------------
+        // Clean up old-style events (actionTool: waitlist-extract)
+        // These pointed at the removed bespoke extraction tool.
+        // ------------------------------------------------------------------
+        await session.run(`MATCH (e:Event {
+        accountId: $accountId,
+        actionPlugin: 'waitlist',
+        actionTool: 'waitlist-extract'
+      })
+       DELETE e`, { accountId });
+        // ------------------------------------------------------------------
+        // Check for existing workflow
+        // ------------------------------------------------------------------
+        const existingResult = await session.run(`MATCH (w:Workflow {accountId: $accountId, name: $name})
+       WHERE w.status IN ['active', 'draft']
+       OPTIONAL MATCH (e:Event {
+         accountId: $accountId,
+         actionPlugin: 'workflows',
+         actionTool: 'workflow-execute'
+       })
+       WHERE e.eventStatus IN ['scheduled', 'due']
+         AND e.actionArgs CONTAINS w.workflowId
+       RETURN w.workflowId AS workflowId,
+              e.eventId AS eventId,
+              e.recurrence AS recurrence,
+              e.nextRun AS nextRun
+       LIMIT 1`, { accountId, name: WORKFLOW_NAME });
+        if (existingResult.records.length > 0) {
+            const existing = existingResult.records[0];
+            const workflowId = existing.get("workflowId");
+            const eventId = existing.get("eventId");
+            // Self-healing: detect broken prompt pattern and update surgically.
+            // The original prompt referenced {{conversations._raw}} which doesn't
+            // exist — waitlist-scan returns structured JSON, not {_raw: text}.
+            // Only updates if the broken pattern is present; preserves any other
+            // user customizations made via workflow-update.
+            await healBrokenPrompt(session, workflowId);
+            // Workflow exists but no event — create one
+            if (!eventId) {
+                const newEventResult = await createScheduledEvent(session, accountId, workflowId, recurrence, timezone);
+                return {
+                    workflowId,
+                    eventId: newEventResult.eventId,
+                    recurrence,
+                    nextRun: newEventResult.nextRun,
+                    alreadyExists: true,
+                };
+            }
+            return {
+                workflowId,
+                eventId,
+                recurrence: existing.get("recurrence"),
+                nextRun: existing.get("nextRun"),
+                alreadyExists: true,
+            };
+        }
+        // ------------------------------------------------------------------
+        // Create workflow with 3 steps
+        // ------------------------------------------------------------------
+        const workflowId = randomUUID();
+        const now = new Date().toISOString();
+        // Compute embedding for workflow discovery
+        const embeddingText = `${WORKFLOW_NAME} — scans public conversations for waitlist sign-ups, extracts contact details and discovery intelligence via LLM`;
+        const embedding = await computeEmbedding(embeddingText);
+        const workflowProps = {
+            workflowId,
+            accountId,
+            name: WORKFLOW_NAME,
+            description: "Scans public agent conversations, extracts contact details and customer discovery intelligence via LLM, " +
+                "and creates Person nodes idempotently. Edit the extraction prompt via workflow-update to change what fields are extracted.",
+            status: "active",
+            createdAt: now,
+            updatedAt: now,
+        };
+        if (embedding.length > 0) {
+            workflowProps.embedding = embedding;
+        }
+        // MERGE on {accountId, name} prevents duplicate workflows when the
+        // heartbeat reconciliation and an admin session call setup concurrently.
+        // Returns the actual workflowId — may differ from the local one if
+        // another caller created the node first.
+        const mergeResult = await session.run(`MERGE (w:Workflow {accountId: $accountId, name: $name})
+       ON CREATE SET w += $props
+       RETURN w.workflowId AS workflowId`, { accountId, name: WORKFLOW_NAME, props: workflowProps });
+        const actualWorkflowId = mergeResult.records[0]?.get("workflowId");
+        if (actualWorkflowId !== workflowId) {
+            // Race: another caller created the workflow concurrently.
+            // Return early — next cycle's existence check handles Event creation.
+            const eventResult = await createScheduledEvent(session, accountId, actualWorkflowId, recurrence, timezone);
+            return {
+                workflowId: actualWorkflowId,
+                eventId: eventResult.eventId,
+                recurrence,
+                nextRun: eventResult.nextRun,
+                alreadyExists: true,
+            };
+        }
+        // Step 1: Scan public conversations
+        const step1Id = randomUUID();
+        await session.run(`MATCH (w:Workflow {workflowId: $workflowId})
+       CREATE (w)-[:HAS_STEP]->(s:WorkflowStep $props)`, {
+            workflowId,
+            props: {
+                stepId: step1Id,
+                workflowId,
+                accountId,
+                type: "tool",
+                plugin: "waitlist",
+                tool: "waitlist-scan",
+                params: null,
+                dependsOn: null,
+                onFailure: "abort",
+                retryLimit: null,
+                outputKey: "conversations",
+                timeout: 30,
+                position: 0,
+                label: "Scan public conversations",
+                // LLM-step fields (null for tool steps)
+                prompt: null,
+                model: null,
+                maxTokens: null,
+            },
+        });
+        // Step 2: LLM extraction
+        const step2Id = randomUUID();
+        await session.run(`MATCH (w:Workflow {workflowId: $workflowId})
+       CREATE (w)-[:HAS_STEP]->(s:WorkflowStep $props)`, {
+            workflowId,
+            props: {
+                stepId: step2Id,
+                workflowId,
+                accountId,
+                type: "llm",
+                prompt: EXTRACTION_PROMPT,
+                model: null, // Uses account's adminModel
+                maxTokens: 4096,
+                dependsOn: JSON.stringify([step1Id]),
+                onFailure: "abort",
+                retryLimit: null,
+                outputKey: "extractions",
+                timeout: 120,
+                position: 1,
+                label: "Extract contacts and discovery intelligence",
+                // Tool-step fields (null for LLM steps)
+                plugin: null,
+                tool: null,
+                params: null,
+            },
+        });
+        // Step 3: Persist extraction results
+        await session.run(`MATCH (w:Workflow {workflowId: $workflowId})
+       CREATE (w)-[:HAS_STEP]->(s:WorkflowStep $props)`, {
+            workflowId,
+            props: {
+                stepId: randomUUID(),
+                workflowId,
+                accountId,
+                type: "tool",
+                plugin: "waitlist",
+                tool: "waitlist-persist",
+                params: JSON.stringify({
+                    extractions: "{{extractions}}",
+                    conversations: "{{conversations}}",
+                }),
+                dependsOn: JSON.stringify([step2Id]),
+                onFailure: "abort",
+                retryLimit: null,
+                outputKey: "results",
+                timeout: 60,
+                position: 2,
+                label: "Create/update Person nodes from extractions",
+                // LLM-step fields (null for tool steps)
+                prompt: null,
+                model: null,
+                maxTokens: null,
+            },
+        });
+        // ------------------------------------------------------------------
+        // Create scheduled event
+        // ------------------------------------------------------------------
+        const eventResult = await createScheduledEvent(session, accountId, workflowId, recurrence, timezone);
+        return {
+            workflowId,
+            eventId: eventResult.eventId,
+            recurrence,
+            nextRun: eventResult.nextRun,
+            alreadyExists: false,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// Event creation helper
+// ---------------------------------------------------------------------------
+async function createScheduledEvent(session, accountId, workflowId, recurrence, timezone) {
+    // Validate cron expression and compute nextRun
+    let nextRun;
+    try {
+        const interval = parseExpression(recurrence, {
+            currentDate: new Date(),
+            tz: timezone,
+        });
+        nextRun = interval.next().toISOString();
+    }
+    catch (err) {
+        throw new Error(`Invalid recurrence expression: "${recurrence}" — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const eventId = randomUUID();
+    const now = new Date().toISOString();
+    const props = {
+        eventId,
+        accountId,
+        name: "Waitlist lead extraction",
+        description: "Executes the waitlist extraction workflow on schedule",
+        startDate: now,
+        eventStatus: "scheduled",
+        recurrence,
+        nextRun,
+        sourcePlugin: "waitlist",
+        actionPlugin: "workflows",
+        actionTool: "workflow-execute",
+        actionArgs: JSON.stringify({
+            workflowId,
+            trigger: "schedule",
+        }),
+        createdAt: now,
+        updatedAt: now,
+    };
+    if (timezone) {
+        props.timezone = timezone;
+    }
+    // Compute embedding for event discoverability
+    const embeddingText = "Event: Waitlist lead extraction — runs workflow to scan public conversations for sign-ups";
+    const embedding = await computeEmbedding(embeddingText);
+    if (embedding.length > 0) {
+        props.embedding = embedding;
+    }
+    await session.run(`CREATE (e:Event $props)`, { props });
+    return { eventId, nextRun };
+}
+// ---------------------------------------------------------------------------
+// Self-healing: fix broken prompt pattern in existing LLM step
+// ---------------------------------------------------------------------------
+const BROKEN_PROMPT_PATTERN = "{{conversations._raw}}";
+const FIXED_PROMPT_FRAGMENT = "{{conversations}}";
+/**
+ * Broken prompt instructions described delimiter-separated text;
+ * fixed version describes the JSON format waitlist-scan actually returns.
+ */
+const BROKEN_INSTRUCTION = "Below are transcripts from public agent conversations. Each conversation is delimited by " +
+    '"--- CONVERSATION <id> ---".';
+const FIXED_INSTRUCTION = "Below is a JSON object containing public agent conversations. It has a `conversations` array " +
+    "where each element has a `conversationId` and a `messages` array of user message strings.";
+const BROKEN_ID_REF = "the conversation ID from the delimiter";
+const FIXED_ID_REF = "the conversation ID from the input data";
+async function healBrokenPrompt(session, workflowId) {
+    const result = await session.run(`MATCH (w:Workflow {workflowId: $workflowId})-[:HAS_STEP]->(s:WorkflowStep {type: 'llm'})
+     WHERE s.prompt CONTAINS $pattern
+     RETURN s.stepId AS stepId, s.prompt AS prompt
+     LIMIT 1`, { workflowId, pattern: BROKEN_PROMPT_PATTERN });
+    if (result.records.length === 0)
+        return;
+    const stepId = result.records[0].get("stepId");
+    const prompt = result.records[0].get("prompt");
+    const healed = prompt
+        .replace(BROKEN_PROMPT_PATTERN, FIXED_PROMPT_FRAGMENT)
+        .replace(BROKEN_INSTRUCTION, FIXED_INSTRUCTION)
+        .replace(BROKEN_ID_REF, FIXED_ID_REF);
+    if (healed === prompt)
+        return; // Nothing changed — defensive guard
+    await session.run(`MATCH (s:WorkflowStep {stepId: $stepId})
+     SET s.prompt = $prompt`, { stepId, prompt: healed });
+}
+//# sourceMappingURL=waitlist-setup.js.map

package/payload/platform/plugins/waitlist/mcp/dist/tools/waitlist-setup.js.map

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

package/payload/platform/plugins/waitlist/mcp/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@maxy/waitlist",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "cron-parser": "^4.9.0",
+    "neo4j-driver": "^5.28.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/payload/platform/plugins/workflows/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "workflows",
+  "description": "Graph-backed workflow CRUD for Maxy. Creates, manages, and discovers persistent named workflows in Neo4j with embedding-based semantic search.",
+  "version": "0.1.0",
+  "author": "Rubytech LLC",
+  "icon": "🔄",
+  "tools": [
+    "workflow-create",
+    "workflow-list",
+    "workflow-get",
+    "workflow-update",
+    "workflow-delete",
+    "workflow-validate",
+    "workflow-execute",
+    "workflow-runs"
+  ]
+}

package/payload/platform/plugins/workflows/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "workflows": {
+      "command": "node",
+      "args": ["~/maxy/platform/plugins/workflows/mcp/dist/index.js"],
+      "env": {
+        "ACCOUNT_ID": "${ACCOUNT_ID}",
+        "PLATFORM_ROOT": "${PLATFORM_ROOT}"
+      }
+    }
+  }
+}

package/payload/platform/plugins/workflows/PLUGIN.md

@@ -0,0 +1,187 @@
+---
+name: workflows
+description: "Structured executable workflows. Named compositions of MCP tool calls with validated references, dependency ordering, failure handling, execution history, and schedule integration."
+metadata: {"taskmaster":{"always":false,"embed":false,"emoji":"🔄","pluginKey":"workflows","optional":true,"recommended":true}}
+---
+
+# Workflows
+
+Workflows are persistent, named compositions of executable steps that the user creates and the engine executes. Steps can chain MCP tool calls and LLM reasoning into composable pipelines. Steps are validated at creation time — a workflow with unmet dependencies cannot be activated. The user manages them conversationally.
+
+## Creating Workflows
+
+When the user describes a recurring process, conditional action, or reusable sequence, create a workflow. Confirm the name, description, and steps with the user before committing.
+
+### Step types
+
+**Tool steps** (`type: "tool"`) — direct MCP tool calls:
+- **plugin** — the plugin that provides the tool (e.g. `memory`, `scheduling`, `telegram`)
+- **tool** — the tool name within that plugin (e.g. `contact-create`, `message`)
+- **params** — parameter object with `{{outputKey.field}}` templates for values from prior steps
+- **timeout** — execution timeout in seconds (default: 30, max: 120)
+
+**LLM steps** (`type: "llm"`) — LLM reasoning via Claude Code OAuth:
+- **prompt** — prompt template sent to the model. Use `{{outputKey.field}}` for data from prior steps. Instruct the model to return JSON for structured output that downstream steps can reference.
+- **model** — Anthropic model ID (optional, defaults to the account's adminModel)
+- **maxTokens** — maximum output tokens (optional, default: 4096)
+- **timeout** — execution timeout in seconds (default: 60, max: 300). LLM calls are slower than tool calls.
+
+LLM steps route through Claude Code's OAuth-authenticated model access. They never use the Anthropic API key directly — that path is exclusively for the public agent.
+
+### Common step fields
+
+- **label** — human-readable description of what this step does
+- **dependsOn** — step positions (as string indexes) that must complete first
+- **onFailure** — `abort` (default), `skip`, or `retry`
+- **retryLimit** — max retries when onFailure is `retry` (max 3)
+- **outputKey** — name under which this step's output is stored for use in subsequent step templates
+
+### Capability validation
+
+At creation time, every step's referenced plugin directory and built MCP server are checked. If any capability is missing, the workflow's status is set to `draft` with specific error messages listing which plugins or tools are unavailable. Only `active` workflows can be executed.
+
+When the missing capability is later installed, use `workflow-validate` to re-check and promote the workflow to `active`.
+
+### Status model
+
+| Status | Meaning |
+|--------|---------|
+| `active` | All capabilities validated, ready to execute |
+| `draft` | Missing capabilities — cannot execute until resolved |
+| `paused` | Manually deactivated — retained but not suggested or executable |
+
+## Discovery
+
+Active workflows are discoverable via `workflow-list` and via `memory-search` (the vector index on the Workflow node surfaces relevant workflows alongside other graph knowledge). When the user's request matches an existing workflow, offer to execute it.
+
+## Execution
+
+Use `workflow-execute` to run a workflow. The engine:
+1. Loads the workflow and its steps
+2. Resolves step dependencies into execution order (topological sort)
+3. For each step: resolves `{{template.variables}}` from context and prior step outputs, spawns the target plugin's MCP server, and calls the specified tool
+4. Records every step's outcome as a StepResult node
+5. Creates a WorkflowRun node with the overall status
+
+### Template variables
+
+Steps receive data from prior steps via named output bindings. If step 1 has `outputKey: "newContact"` and returns `{"contactId": "abc-123"}`, step 2 can reference `{{newContact.contactId}}` in its params.
+
+The execution context can also be seeded with runtime variables via the `context` parameter on `workflow-execute`. These are available alongside step outputs.
+
+Unresolved template variables cause the step to fail with a specific error naming the missing variable.
+
+### Failure handling
+
+Each step declares an `onFailure` policy:
+- **abort** (default) — stop the workflow, mark the run as `failed`
+- **skip** — mark this step as `skipped`, continue to the next step
+- **retry** — retry up to `retryLimit` times before applying abort behaviour
+
+### Run status
+
+| Status | Meaning |
+|--------|---------|
+| `completed` | Every step succeeded |
+| `partial` | Finished, but one or more steps were skipped |
+| `failed` | A step failed with abort policy, execution stopped |
+
+## Execution History
+
+Use `workflow-runs` to query execution history. Returns run status, timing, trigger type, and per-step outcome counts. The admin can ask "show me recent workflow runs" and get structured execution history.
+
+## Schedule Integration
+
+To trigger a workflow on a schedule, create an Event with the scheduling plugin using action dispatch:
+
+```
+action: { plugin: "workflows", tool: "workflow-execute", args: { workflowId: "..." } }
+```
+
+The existing `check-due-events` heartbeat dispatches the workflow execution at the scheduled time. The WorkflowRun captures `trigger: "schedule"`.
+
+## Managing Workflows
+
+- **Pause**: Set status to `paused` via `workflow-update`
+- **Resume**: Set status back to `active` (only if capabilities are still valid)
+- **Edit steps**: Provide the complete new step list via `workflow-update` — replaces all existing steps and re-validates capabilities
+- **Re-validate**: Use `workflow-validate` after installing new plugins to check if draft workflows can now be activated
+- **Delete**: Remove permanently via `workflow-delete` — cascades to steps, runs, and step results. Confirm with the user first.
+
+## Workflow Templates
+
+### Public Chat Review
+
+A digest workflow that reviews recent public chat conversations and persists a structured summary for the admin's session-start briefing.
+
+**Steps:**
+
+| # | Type | What it does |
+|---|------|-------------|
+| 1 | tool | `memory:conversation-list` — fetch recent public conversations with messages inline |
+| 2 | llm | Review transcripts, extract signals (feedback, complaints, feature requests, competitive mentions, unanswered questions), classify by priority |
+| 3 | tool | `memory:memory-write` — persist the digest as a CreativeWork node |
+
+**Example step definitions:**
+
+```json
+[
+  {
+    "type": "tool",
+    "label": "Fetch recent public conversations",
+    "plugin": "memory",
+    "tool": "conversation-list",
+    "params": {
+      "agentType": "public",
+      "since": "{{context.since}}",
+      "includeMessages": true,
+      "limit": 20
+    },
+    "outputKey": "conversations",
+    "onFailure": "abort"
+  },
+  {
+    "type": "llm",
+    "label": "Review conversations and extract signals",
+    "prompt": "Review these public chat conversations and produce a structured digest.\n\nConversations:\n{{conversations._raw}}\n\nExtract and classify:\n- Product feedback (positive or negative)\n- Feature requests\n- Complaints or frustrations\n- Competitive mentions (other products named)\n- Unanswered questions (visitor asked something the agent couldn't answer)\n- High-intent prospects (visitors showing buying signals)\n\nFor each item, include: the signal type, a one-line summary, priority (high/medium/low), and which conversation it came from.\n\nIf no notable signals were found, say so — do not fabricate items.\n\nReturn the digest as a readable summary, not raw JSON.",
+    "maxTokens": 4096,
+    "timeout": 120,
+    "outputKey": "digest",
+    "dependsOn": ["0"],
+    "onFailure": "abort"
+  },
+  {
+    "type": "tool",
+    "label": "Persist digest to graph",
+    "plugin": "memory",
+    "tool": "memory-write",
+    "params": {
+      "labels": ["CreativeWork"],
+      "properties": {
+        "title": "Chat Review {{context.date}}",
+        "abstract": "{{digest._raw}}"
+      },
+      "scope": "admin"
+    },
+    "dependsOn": ["1"],
+    "onFailure": "abort"
+  }
+]
+```
+
+**Runtime context:** The `context.since` and `context.date` variables are supplied via the `context` parameter when executing. For a daily schedule, set `since` to the previous day's ISO 8601 timestamp and `date` to today's date (e.g. `2026-04-01`).
+
+**Schedule:** To run daily, create a scheduled Event with action dispatch pointing to this workflow's `workflowId`. See "Schedule Integration" above.
+
+**Session context:** The persisted digest appears in the admin agent's session-start briefing automatically — `loadSessionContext()` queries recent `Chat Review` CreativeWork nodes and includes them in `<previous-context>`.
+
+## Tools
+
+- `workflow-create` — Create a workflow with name, description, and structured steps
+- `workflow-list` — List workflows with status and step counts
+- `workflow-get` — Fetch a workflow with full step details
+- `workflow-update` — Update name, description, steps (full replacement), or status
+- `workflow-delete` — Permanently remove a workflow and all history
+- `workflow-validate` — Re-check step capabilities and update status
+- `workflow-execute` — Execute a workflow with optional runtime context
+- `workflow-runs` — Query execution history with optional filters

package/payload/platform/plugins/workflows/mcp/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/workflows/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}