flowcraft 1.0.0-beta.1

package/sandbox/5.distributed/data/2.job-application/200.json

@@ -0,0 +1,103 @@
+{
+	"nodes": [
+		{
+			"id": "extract_skills",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Extract a list of all technical skills from this resume. Format as a simple comma-separated string:\n\n{{resume}}",
+				"inputs": {
+					"resume": "resume"
+				}
+			}
+		},
+		{
+			"id": "analyze_tone",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Analyze the tone of this cover letter. Respond with a single word: \"professional\", \"casual\", or \"unprofessional\".\n\n{{coverLetter}}",
+				"inputs": {
+					"coverLetter": "coverLetter"
+				}
+			}
+		},
+		{
+			"id": "check_qualifications",
+			"type": "llm-condition",
+			"data": {
+				"promptTemplate": "Does this list of skills `{{skills}}` contain all of the following required skills: `TypeScript, Node.js, SQL`? Also, is the cover letter tone `{{tone}}` professional? Respond only 'true' if both conditions are met, otherwise 'false'.",
+				"inputs": {
+					"skills": "extract_skills",
+					"tone": "analyze_tone"
+				}
+			}
+		},
+		{
+			"id": "send_interview_email",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 201,
+				"outputs": {
+					"send_interview_email": "final_output"
+				},
+				"inputs": {
+					"applicantName": "applicantName"
+				}
+			}
+		},
+		{
+			"id": "send_rejection_email",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 202,
+				"outputs": {
+					"send_rejection_email": "final_output"
+				},
+				"inputs": {
+					"applicantName": "applicantName"
+				}
+			}
+		},
+		{
+			"id": "final_output",
+			"type": "output",
+			"data": {
+				"promptTemplate": "Final email sent to {{applicantName}}:\n\n{{email_body}}",
+				"inputs": {
+					"applicantName": "applicantName",
+					"email_body": [
+						"send_interview_email",
+						"send_rejection_email"
+					]
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "extract_skills",
+			"target": "check_qualifications"
+		},
+		{
+			"source": "analyze_tone",
+			"target": "check_qualifications"
+		},
+		{
+			"source": "check_qualifications",
+			"target": "send_interview_email",
+			"action": "true"
+		},
+		{
+			"source": "check_qualifications",
+			"target": "send_rejection_email",
+			"action": "false"
+		},
+		{
+			"source": "send_interview_email",
+			"target": "final_output"
+		},
+		{
+			"source": "send_rejection_email",
+			"target": "final_output"
+		}
+	]
+}

package/sandbox/5.distributed/data/2.job-application/201.json

@@ -0,0 +1,30 @@
+{
+	"nodes": [
+		{
+			"id": "gen_interview_email",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Write a polite and professional email inviting {{applicantName}} to an interview. Mention you were impressed with their resume.",
+				"inputs": {
+					"applicantName": "applicantName"
+				}
+			}
+		},
+		{
+			"id": "output_email",
+			"type": "output",
+			"data": {
+				"promptTemplate": "{{result}}",
+				"inputs": {
+					"result": "gen_interview_email"
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "gen_interview_email",
+			"target": "output_email"
+		}
+	]
+}

package/sandbox/5.distributed/data/2.job-application/202.json

@@ -0,0 +1,30 @@
+{
+	"nodes": [
+		{
+			"id": "gen_rejection_email",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Write a polite and professional email to {{applicantName}} informing them that you will not be moving forward with their application at this time. Thank them for their interest.",
+				"inputs": {
+					"applicantName": "applicantName"
+				}
+			}
+		},
+		{
+			"id": "output_email",
+			"type": "output",
+			"data": {
+				"promptTemplate": "{{result}}",
+				"inputs": {
+					"result": "gen_rejection_email"
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "gen_rejection_email",
+			"target": "output_email"
+		}
+	]
+}

package/sandbox/5.distributed/data/2.job-application/README.md

@@ -0,0 +1,58 @@
+# Use Case 2: Job Application Screener
+
+This workflow demonstrates a more complex Directed Acyclic Graph (DAG) for screening a job applicant. It showcases parallel processing, data convergence, and conditional branching based on an LLM's evaluation.
+
+## Main Workflow ID: 200
+
+### Description
+
+1. **Parallel Analysis**: The flow begins by analyzing the applicant's `resume` and `coverLetter` simultaneously.
+    - `extract_skills`: Pulls a list of technical skills from the resume.
+    - `analyze_tone`: Determines the professionalism of the cover letter.
+2. **Conditional Check**: The results from the parallel steps are fed into the `check_qualifications` node. This LLM-powered node evaluates if the applicant meets the required criteria (e.g., has specific skills and a professional tone). It returns `true` or `false`.
+3. **Branching**: Based on the result of the check, the flow executes one of two sub-workflows:
+    - **On `true`**: It calls the `Send Interview Email` sub-workflow (ID: 201).
+    - **On `false`**: It calls the `Send Rejection Email` sub-workflow (ID: 202).
+4. **Convergence**: The output from whichever branch was executed is passed to the `final_output` node, which formats the concluding message.
+
+### Visual Graph
+
+```mermaid
+graph TD
+    subgraph "Job Application Screener (ID: 200)"
+        A(Resume) --> B[extract_skills]
+        C(Cover Letter) --> D[analyze_tone]
+        B --> E{check_qualifications}
+        D --> E
+        E -- true --> F["Sub-Workflow: Send Interview (201)"]
+        E -- false --> G["Sub-Workflow: Send Rejection (202)"]
+        F --> H[final_output]
+        G --> H
+    end
+```
+
+---
+
+## Sub-Workflows
+
+### Sub-Workflow ID: 201 (Send Interview Email)
+
+A simple, linear workflow that generates a polite email inviting the candidate to an interview.
+
+```mermaid
+graph TD
+    subgraph "Generate Interview Email (ID: 201)"
+        A[gen_interview_email] --> B[output_email]
+    end
+```
+
+### Sub-Workflow ID: 202 (Send Rejection Email)
+
+A simple, linear workflow that generates a polite rejection email.
+
+```mermaid
+graph TD
+    subgraph "Generate Rejection Email (ID: 202)"
+        A[gen_rejection_email] --> B[output_email]
+    end
+```

package/sandbox/5.distributed/data/3.customer-review/300.json

@@ -0,0 +1,141 @@
+{
+	"nodes": [
+		{
+			"id": "summarize",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Summarize this review in one sentence: {{review}}",
+				"inputs": {
+					"review": "initial_review"
+				}
+			}
+		},
+		{
+			"id": "categorize",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Categorize this review into ONLY ONE of: 'Bug Report', 'Feature Request', 'General Feedback'. Review: {{review}}",
+				"inputs": {
+					"review": "initial_review"
+				}
+			}
+		},
+		{
+			"id": "check_sentiment",
+			"type": "llm-condition",
+			"data": {
+				"promptTemplate": "Is the sentiment of this summary positive? '{{summary}}'. Respond only 'true' or 'false'.",
+				"inputs": {
+					"summary": "summarize"
+				}
+			}
+		},
+		{
+			"id": "positive_branch",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 301,
+				"inputs": {
+					"summary": "summarize"
+				},
+				"outputs": {
+					"final_positive_reply": "final_output"
+				}
+			}
+		},
+		{
+			"id": "negative_branch",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 302,
+				"inputs": {
+					"summary": "summarize",
+					"category": "categorize"
+				},
+				"outputs": {
+					"generated_ticket": "ticket_payload",
+					"generated_reply": "customer_message"
+				}
+			}
+		},
+		{
+			"id": "send_to_ticketing_system",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "--- SIMULATING API CALL ---\nPOST /api/tickets\nPayload: {{ticket_data}}",
+				"inputs": {
+					"ticket_data": "generated_ticket"
+				}
+			}
+		},
+		{
+			"id": "send_email_to_customer",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "--- SIMULATING EMAIL SENT ---\nTo: customer@example.com\nBody: {{email_body}}",
+				"inputs": {
+					"email_body": "generated_reply"
+				}
+			}
+		},
+		{
+			"id": "final_step",
+			"type": "output",
+			"data": {
+				"outputKey": "final_output",
+				"promptTemplate": "--- Final Actions Taken ---\nTicket System: {{ticket_action}}\n\nCustomer Email: {{email_action}}\n\nPositive Flow Result: {{positive_result}}",
+				"inputs": {
+					"ticket_action": [
+						"send_to_ticketing_system"
+					],
+					"email_action": [
+						"send_email_to_customer"
+					],
+					"positive_result": [
+						"final_positive_reply"
+					]
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "summarize",
+			"target": "check_sentiment"
+		},
+		{
+			"source": "categorize",
+			"target": "check_sentiment"
+		},
+		{
+			"source": "check_sentiment",
+			"target": "positive_branch",
+			"action": "true"
+		},
+		{
+			"source": "check_sentiment",
+			"target": "negative_branch",
+			"action": "false"
+		},
+		{
+			"source": "negative_branch",
+			"target": "send_to_ticketing_system"
+		},
+		{
+			"source": "negative_branch",
+			"target": "send_email_to_customer"
+		},
+		{
+			"source": "positive_branch",
+			"target": "final_step"
+		},
+		{
+			"source": "send_to_ticketing_system",
+			"target": "final_step"
+		},
+		{
+			"source": "send_email_to_customer",
+			"target": "final_step"
+		}
+	]
+}

package/sandbox/5.distributed/data/3.customer-review/301.json

@@ -0,0 +1,31 @@
+{
+	"nodes": [
+		{
+			"id": "gen_thanks",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Write a friendly \"thank you\" email to a customer for their positive feedback. Mention that you appreciate them highlighting: \"{{summary}}\".",
+				"inputs": {
+					"summary": "summary"
+				}
+			}
+		},
+		{
+			"id": "output_thanks",
+			"type": "output",
+			"data": {
+				"outputKey": "final_output",
+				"promptTemplate": "{{result}}",
+				"inputs": {
+					"result": "gen_thanks"
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "gen_thanks",
+			"target": "output_thanks"
+		}
+	]
+}

package/sandbox/5.distributed/data/3.customer-review/302.json

@@ -0,0 +1,57 @@
+{
+	"nodes": [
+		{
+			"id": "gen_ticket_data",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Generate a Jira-style ticket in JSON format. The JSON should have two keys: 'title' and 'description'. Title: 'Customer Feedback: {{category}}'. Description: 'User reported an issue summarized as: {{summary}}'.",
+				"inputs": {
+					"category": "category",
+					"summary": "summary"
+				}
+			}
+		},
+		{
+			"id": "gen_customer_reply",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Write a polite, reassuring email to a customer. Inform them that you have received their feedback regarding '{{summary}}' and have created a ticket for the team to review. Do not include a subject line.",
+				"inputs": {
+					"summary": "summary"
+				}
+			}
+		},
+		{
+			"id": "output_ticket",
+			"type": "output",
+			"data": {
+				"outputKey": "ticket_payload",
+				"promptTemplate": "{{result}}",
+				"inputs": {
+					"result": "gen_ticket_data"
+				}
+			}
+		},
+		{
+			"id": "output_reply",
+			"type": "output",
+			"data": {
+				"outputKey": "customer_message",
+				"promptTemplate": "{{result}}",
+				"inputs": {
+					"result": "gen_customer_reply"
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "gen_ticket_data",
+			"target": "output_ticket"
+		},
+		{
+			"source": "gen_customer_reply",
+			"target": "output_reply"
+		}
+	]
+}

package/sandbox/5.distributed/data/3.customer-review/README.md

@@ -0,0 +1,71 @@
+# Use Case 3: Customer Review Analysis
+
+This workflow demonstrates an advanced Directed Acyclic Graph (DAG) that includes parallel processing at the start, conditional branching, and a "fan-out" where a single node triggers multiple parallel downstream tasks.
+
+## Main Workflow ID: 300
+
+### Description
+
+1. **Parallel Analysis**: The flow starts by running two tasks on the `initial_review` in parallel:
+    - `summarize`: Creates a one-sentence summary.
+    - `categorize`: Classifies the review (e.g., 'Bug Report').
+2. **Conditional Check**: The `summary` is passed to `check_sentiment`, which uses an LLM to determine if the review is positive. It returns `true` or `false`. The `category` is also passed along for the negative path.
+3. **Branching**:
+    - **On `true`**: The flow executes the `positive_branch` (Sub-Workflow 301) to thank the customer.
+    - **On `false`**: The flow executes the `negative_branch` (Sub-Workflow 302) to create a support ticket and a customer reply.
+4. **Mid-Flow Fan-Out**: The `negative_branch` is a powerful example of fan-out. After it completes, its multiple outputs are used to trigger two separate, parallel actions:
+    - `send_to_ticketing_system`
+    - `send_email_to_customer`
+5. **Convergence**: All paths eventually lead to the `final_step` node, which aggregates the results from whichever branch was executed.
+
+### Visual Graph
+
+```mermaid
+graph TD
+    subgraph "Customer Review Analysis (ID: 300)"
+        A(Initial Review) --> B[summarize]
+        A --> C[categorize]
+        B --> D{check_sentiment}
+        C --> D
+        D -- true --> E["Sub-Workflow: Positive Reply (301)"]
+        D -- false --> F["Sub-Workflow: Create Ticket & Reply (302)"]
+
+        subgraph "Negative Path (Parallel Fan-Out)"
+            F --> G[send_to_ticketing_system]
+            F --> H[send_email_to_customer]
+        end
+
+        E --> Z[final_step]
+        G --> Z
+        H --> Z
+    end
+```
+
+---
+
+## Sub-Workflows
+
+### Sub-Workflow ID: 301 (Send Thanks)
+
+A simple workflow to generate a thank-you message for positive feedback.
+
+```mermaid
+graph TD
+    subgraph "Send Thanks (ID: 301)"
+        A[gen_thanks] --> B[output_thanks]
+    end
+```
+
+### Sub-Workflow ID: 302 (Create Ticket and Reply)
+
+This sub-workflow itself runs tasks in parallel. It generates the data for a support ticket and a customer-facing reply simultaneously. These outputs are then passed back to the main flow to be used in the parallel fan-out step.
+
+```mermaid
+graph TD
+    subgraph "Create Ticket & Reply (ID: 302)"
+        A[gen_ticket_data] --> B[output_ticket]
+        C[gen_customer_reply] --> D[output_reply]
+    end
+```
+
+```

package/sandbox/5.distributed/data/4.content-moderation/400.json

@@ -0,0 +1,173 @@
+{
+	"nodes": [
+		{
+			"id": "check_for_pii",
+			"type": "llm-condition",
+			"data": {
+				"promptTemplate": "Does the following text contain any Personally Identifiable Information (PII) like an email address, phone number, or physical address? Respond only with 'true' or 'false'.\n\nText: \"{{userPost}}\"",
+				"inputs": {
+					"userPost": "userPost"
+				}
+			}
+		},
+		{
+			"id": "check_for_hate_speech",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "Analyze the following text for hate speech. Respond with only ONE of the following severity levels: 'none', 'moderate', or 'severe'.\n\nText: \"{{userPost}}\"",
+				"inputs": {
+					"userPost": "userPost"
+				}
+			}
+		},
+		{
+			"id": "check_for_spam",
+			"type": "llm-condition",
+			"data": {
+				"promptTemplate": "Does the following text appear to be commercial spam, containing suspicious links or promotional language? Respond only with 'true' or 'false'.\n\nText: \"{{userPost}}\"",
+				"inputs": {
+					"userPost": "userPost"
+				}
+			}
+		},
+		{
+			"id": "triage_post",
+			"type": "llm-router",
+			"data": {
+				"promptTemplate": "Given the following analysis of a user post, decide on the single most appropriate action. Respond with ONLY ONE of the following action codes: 'action_ban', 'action_redact', 'action_delete_spam', 'action_approve'.\n\n- Hate Speech Level: {{hate_speech_level}}\n- PII Found: {{pii_found}}\n- Spam Detected: {{spam_detected}}\n\nRules:\n1. If Hate Speech is 'severe', the action is 'action_ban'.\n2. If PII is 'true' (and hate speech is not 'severe'), the action is 'action_redact'.\n3. If Spam is 'true' (and the above are false), the action is 'action_delete_spam'.\n4. Otherwise, the action is 'action_approve'.",
+				"inputs": {
+					"hate_speech_level": "check_for_hate_speech",
+					"pii_found": "check_for_pii",
+					"spam_detected": "check_for_spam"
+				}
+			}
+		},
+		{
+			"id": "ban_user_branch",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 401,
+				"inputs": {
+					"userId": "userId",
+					"reason": "check_for_hate_speech"
+				},
+				"outputs": {
+					"moderation_result": "ban_summary"
+				}
+			}
+		},
+		{
+			"id": "redact_post_branch",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 402,
+				"inputs": {
+					"userPost": "userPost",
+					"userId": "userId"
+				},
+				"outputs": {
+					"moderation_result": "redaction_summary"
+				}
+			}
+		},
+		{
+			"id": "delete_spam_branch",
+			"type": "sub-workflow",
+			"data": {
+				"workflowId": 403,
+				"inputs": {
+					"userId": "userId"
+				},
+				"outputs": {
+					"moderation_result": "spam_deletion_summary"
+				}
+			}
+		},
+		{
+			"id": "approve_post_branch",
+			"type": "llm-process",
+			"data": {
+				"promptTemplate": "The user post from {{userId}} was analyzed and approved with no issues. Create a simple log message confirming this.",
+				"inputs": {
+					"userId": "userId"
+				}
+			}
+		},
+		{
+			"id": "final_log",
+			"type": "output",
+			"data": {
+				"outputKey": "final_output",
+				"promptTemplate": "--- CONTENT MODERATION COMPLETE ---\n\nFinal Action Log:\n{{final_action_taken}}",
+				"inputs": {
+					"final_action_taken": [
+						"moderation_result",
+						"approve_post_branch"
+					]
+				}
+			}
+		}
+	],
+	"edges": [
+		{
+			"source": "check_for_pii",
+			"target": "triage_post",
+			"action": "true"
+		},
+		{
+			"source": "check_for_pii",
+			"target": "triage_post",
+			"action": "false"
+		},
+		{
+			"source": "check_for_hate_speech",
+			"target": "triage_post"
+		},
+		{
+			"source": "check_for_spam",
+			"target": "triage_post",
+			"action": "true"
+		},
+		{
+			"source": "check_for_spam",
+			"target": "triage_post",
+			"action": "false"
+		},
+		{
+			"source": "triage_post",
+			"target": "ban_user_branch",
+			"action": "action_ban"
+		},
+		{
+			"source": "triage_post",
+			"target": "redact_post_branch",
+			"action": "action_redact"
+		},
+		{
+			"source": "triage_post",
+			"target": "delete_spam_branch",
+			"action": "action_delete_spam"
+		},
+		{
+			"source": "triage_post",
+			"target": "approve_post_branch",
+			"action": "action_approve"
+		},
+		{
+			"source": "ban_user_branch",
+			"target": "final_log"
+		},
+		{
+			"source": "redact_post_branch",
+			"target": "final_log"
+		},
+		{
+			"source": "delete_spam_branch",
+			"target": "final_log"
+		},
+		{
+			"source": "approve_post_branch",
+			"target": "final_log"
+		}
+	]
+}