@agentled/cli 0.1.6 → 0.5.0

package/scaffolds/extract-threshold-alert.json

@@ -0,0 +1,131 @@
+{
+  "name": "AI Extract + Threshold Check + Conditional Alert + KG Sync",
+  "goal": "Extract structured metrics from free-form text, compare to configured thresholds, update an external system, alert on breaches only, and persist to the KG for trending.",
+  "description": "Pattern 06 (conditional routing) + pattern 09 (KG history). Generic shape for any 'extract-then-monitor' flow: meeting transcripts → KPIs, support tickets → SLA metrics, incident reports → severity. Configure the target CRM/system, alert channel, and thresholds in input pages.",
+  "status": "draft",
+  "context": {
+    "executionInputConfig": {
+      "title": "Process Input",
+      "description": "Paste the free-form text to extract metrics from.",
+      "runCTALabel": "Process",
+      "fields": [
+        { "name": "source_text", "label": "Source text", "type": "textarea", "required": true },
+        { "name": "entity_id", "label": "External entity id (e.g. CRM record id)", "type": "text", "required": true },
+        { "name": "language", "label": "Language", "type": "select", "options": ["en", "fr", "es", "de"], "required": true }
+      ]
+    },
+    "inputPages": [
+      {
+        "title": "Alert Settings",
+        "pathname": "alert-settings",
+        "configuration": {
+          "contextKey": "alertSettings",
+          "shortDescriptionFields": ["slackChannel"],
+          "fields": [
+            { "name": "slackWebhookUrl", "label": "Slack incoming webhook URL", "type": "text", "required": true },
+            { "name": "slackChannel", "label": "Slack channel", "type": "text", "required": true }
+          ]
+        }
+      },
+      {
+        "title": "Thresholds",
+        "pathname": "thresholds",
+        "configuration": {
+          "contextKey": "thresholds",
+          "fields": [
+            { "name": "metric_a_min", "label": "Metric A floor", "type": "Numeric" },
+            { "name": "metric_b_max", "label": "Metric B ceiling", "type": "Numeric" },
+            { "name": "metric_c_min", "label": "Metric C minimum", "type": "Numeric" }
+          ]
+        }
+      }
+    ]
+  },
+  "steps": [
+    {
+      "id": "start",
+      "type": "trigger",
+      "name": "Manual Start",
+      "pipelineStepStartConditions": { "trigger": { "type": "manual" } },
+      "next": { "stepId": "extract-metrics" }
+    },
+    {
+      "id": "extract-metrics",
+      "type": "aiAction",
+      "name": "Extract Metrics (multilingual)",
+      "pipelineStepPrompt": {
+        "template": "Extract the three target metrics (metric_a, metric_b, metric_c) from this {{input.language}} text. Return null for any metric you cannot confidently extract. Normalize units consistently.\n\nText:\n{{input.source_text}}",
+        "responseStructure": {
+          "metric_a": "number | null",
+          "metric_b": "number | null",
+          "metric_c": "number | null",
+          "notes": "string"
+        }
+      },
+      "creditCost": 10,
+      "next": { "stepId": "check-thresholds" }
+    },
+    {
+      "id": "check-thresholds",
+      "type": "code",
+      "name": "Compare to Thresholds",
+      "codeConfig": {
+        "language": "javascript",
+        "code": "const k = steps['extract-metrics']; const t = context.thresholds || {}; const breaches = []; if (k.metric_a != null && t.metric_a_min != null && k.metric_a < t.metric_a_min) breaches.push({ metric: 'metric_a', value: k.metric_a, threshold: t.metric_a_min }); if (k.metric_b != null && t.metric_b_max != null && k.metric_b > t.metric_b_max) breaches.push({ metric: 'metric_b', value: k.metric_b, threshold: t.metric_b_max }); if (k.metric_c != null && t.metric_c_min != null && k.metric_c < t.metric_c_min) breaches.push({ metric: 'metric_c', value: k.metric_c, threshold: t.metric_c_min }); return { breaches, breach_count: breaches.length, summary: breaches.map(b => `${b.metric}=${b.value} (limit ${b.threshold})`).join(', ') };"
+      },
+      "next": { "stepId": "update-external-system" }
+    },
+    {
+      "id": "update-external-system",
+      "type": "appAction",
+      "name": "Update External System",
+      "app": { "id": "http-request", "actionId": "request", "source": "native" },
+      "stepInputData": {
+        "url": "https://example.com/api/entities/{{input.entity_id}}",
+        "method": "PATCH",
+        "body": "{\"metrics\": {{steps.extract-metrics}}}"
+      },
+      "next": { "stepId": "alert-on-breach" }
+    },
+    {
+      "id": "alert-on-breach",
+      "type": "appAction",
+      "name": "Slack Alert (breaches only)",
+      "app": { "id": "webhook", "actionId": "trigger", "source": "native" },
+      "entryConditions": {
+        "onCriteriaFail": "skip",
+        "conditionText": "Only alert when at least one threshold is breached.",
+        "criteria": [
+          { "variable": "{{steps.check-thresholds.breach_count}}", "operator": ">", "value": 0 },
+          { "variable": "{{context.alertSettings.slackWebhookUrl}}", "operator": "isNotNull" }
+        ]
+      },
+      "stepInputData": {
+        "webhookUrl": "{{context.alertSettings.slackWebhookUrl}}",
+        "inputsJson": "{\"text\":\"Threshold breach for {{input.entity_id}}: {{steps.check-thresholds.summary}}\",\"channel\":\"{{context.alertSettings.slackChannel}}\"}"
+      },
+      "next": { "stepId": "store-history" }
+    },
+    {
+      "id": "store-history",
+      "type": "knowledgeSync",
+      "name": "Store Metric History",
+      "knowledgeSync": {
+        "source": { "stepId": "extract-metrics" },
+        "listKey": "metric_history",
+        "fieldMapping": {
+          "metric_a": "metric_a",
+          "metric_b": "metric_b",
+          "metric_c": "metric_c",
+          "notes": "notes"
+        }
+      },
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Done"
+    }
+  ]
+}

package/scaffolds/lead-scoring-kg.json

@@ -0,0 +1,84 @@
+{
+  "name": "Lead Scoring + KG Storage",
+  "goal": "Score a batch of leads against ICP criteria and persist results to the Knowledge Graph.",
+  "description": "Pattern 09 (KG-storage). Replace the scoring prompt, ICP criteria, and list keys for your workspace.",
+  "status": "draft",
+  "context": {
+    "executionInputConfig": {
+      "title": "Score Leads",
+      "description": "Source list of leads to score.",
+      "runCTALabel": "Run",
+      "fields": [
+        { "name": "source_list_key", "label": "Source list key", "type": "text", "required": true },
+        { "name": "target_list_key", "label": "Target list (scored results)", "type": "text", "required": true }
+      ]
+    }
+  },
+  "steps": [
+    {
+      "id": "start",
+      "type": "trigger",
+      "name": "Manual Start",
+      "pipelineStepStartConditions": { "trigger": { "type": "manual" } },
+      "next": { "stepId": "read-leads" }
+    },
+    {
+      "id": "read-leads",
+      "type": "appAction",
+      "name": "Read Leads",
+      "app": { "id": "kg", "actionId": "read-list", "source": "native" },
+      "stepInputData": {
+        "listKey": "{{input.source_list_key}}",
+        "limit": "500"
+      },
+      "next": { "stepId": "score" }
+    },
+    {
+      "id": "score",
+      "type": "aiAction",
+      "name": "Score Lead",
+      "loopConfig": {
+        "source": "executionContent",
+        "config": { "stepId": "read-leads", "field": "listEntries" },
+        "ItemAlias": "lead"
+      },
+      "pipelineStepPrompt": {
+        "template": "Score this lead against the ICP. Return a structured result.\n\nLead: {{lead}}\n\nReturn: fit_score (0-100), decision (one of: qualify, nurture, reject), reason (short).",
+        "responseStructure": {
+          "fit_score": "number (0-100)",
+          "decision": "string (qualify | nurture | reject)",
+          "reason": "string"
+        }
+      },
+      "creditCost": 8,
+      "next": { "stepId": "sync-scores" }
+    },
+    {
+      "id": "sync-scores",
+      "type": "knowledgeSync",
+      "name": "Save Scores to KG",
+      "entryConditions": {
+        "onCriteriaFail": "wait",
+        "conditionText": "Wait for all scoring calls to complete.",
+        "criteria": [
+          { "type": "loop_completion", "stepId": "score", "operator": "==", "value": true }
+        ]
+      },
+      "knowledgeSync": {
+        "source": { "stepId": "score", "resultsPath": "items" },
+        "listKey": "{{input.target_list_key}}",
+        "fieldMapping": {
+          "fit_score": "fit_score",
+          "decision": "decision",
+          "reason": "reason"
+        }
+      },
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Done"
+    }
+  ]
+}

package/scaffolds/list-match-email.json

@@ -0,0 +1,131 @@
+{
+  "name": "List Match + Outreach Email",
+  "goal": "Score a request against a KG list of candidates, pick the top match, send a personalized outreach email on approval, and store the outcome.",
+  "description": "Pattern 08 (composed email with approval) + pattern 09 (KG outcome storage). Works for any domain where you match one input against a KG list (mentors, suppliers, partners, investors, properties). Requires an outreachProfile input page and a connected email account (Gmail or Outlook).",
+  "status": "draft",
+  "context": {
+    "executionInputConfig": {
+      "title": "Match + Email",
+      "description": "Request to match against a KG list.",
+      "runCTALabel": "Find match",
+      "fields": [
+        { "name": "requester_name", "label": "Requester name", "type": "text", "required": true },
+        { "name": "requester_email", "label": "Requester email", "type": "text", "required": true },
+        { "name": "request", "label": "Request / need", "type": "textarea", "required": true },
+        { "name": "candidate_list_key", "label": "KG list key (candidate pool)", "type": "text", "required": true }
+      ]
+    },
+    "inputPages": [
+      {
+        "title": "Outreach Profile",
+        "pathname": "outreach-profile",
+        "configuration": {
+          "contextKey": "outreachProfile",
+          "shortDescriptionFields": ["name", "fromEmail"],
+          "fields": [
+            { "name": "name", "label": "Sender name", "type": "text", "required": true },
+            { "name": "fromEmailLabel", "label": "From name", "type": "text", "required": true },
+            { "name": "fromEmail", "label": "From email", "type": "connected_emails_selector_multiple", "required": true },
+            { "name": "replyToEmail", "label": "Reply-to (optional)", "type": "text" }
+          ]
+        }
+      }
+    ]
+  },
+  "steps": [
+    {
+      "id": "start",
+      "type": "trigger",
+      "name": "Manual Start",
+      "pipelineStepStartConditions": { "trigger": { "type": "manual" } },
+      "next": { "stepId": "read-candidates" }
+    },
+    {
+      "id": "read-candidates",
+      "type": "appAction",
+      "name": "Read Candidate Pool",
+      "app": { "id": "kg", "actionId": "read-list", "source": "native" },
+      "stepInputData": {
+        "listKey": "{{input.candidate_list_key}}",
+        "limit": "500"
+      },
+      "next": { "stepId": "rank-top-3" }
+    },
+    {
+      "id": "rank-top-3",
+      "type": "aiAction",
+      "name": "Rank Top 3 Candidates",
+      "pipelineStepPrompt": {
+        "template": "Score each candidate's fit for this request on expertise, relevance, and past outcomes. Return the top 3 with the best as top_match.\n\nRequest: {{input.request}}\n\nCandidate pool: {{steps.read-candidates.listEntries}}",
+        "responseStructure": {
+          "matches": "array of { candidate_id, candidate_name, candidate_email, fit_score (0-100), reasoning }",
+          "top_match": "object matching the best candidate"
+        }
+      },
+      "creditCost": 12,
+      "next": { "stepId": "send-outreach-email" }
+    },
+    {
+      "id": "send-outreach-email",
+      "type": "aiAction",
+      "name": "Send Outreach Email",
+      "pipelineStepPrompt": {
+        "type": "email",
+        "template": "Draft a personalized outreach email to {{steps.rank-top-3.top_match.candidate_name}}, introducing {{input.requester_name}} and their request: {{input.request}}.\n\nKeep it warm, concise, and professional.",
+        "responseStructure": {
+          "email": {
+            "from": "{{context.outreachProfile.fromEmail}}",
+            "to": "{{steps.rank-top-3.top_match.candidate_email}}",
+            "subject": "",
+            "body": "",
+            "bodyType": "html"
+          }
+        }
+      },
+      "renderer": {
+        "type": "Email",
+        "config": { "fromContextKey": "outreachProfile" }
+      },
+      "integrations": [
+        {
+          "type": "oneOf",
+          "label": "Email",
+          "connectorType": "email",
+          "options": [
+            { "name": "Gmail", "url": "https://gmail.com", "isUserAccountConnectionRequired": true },
+            { "name": "Outlook", "url": "https://outlook.com", "isUserAccountConnectionRequired": true }
+          ],
+          "selectionHint": "preferConnected"
+        }
+      ],
+      "onApproval": {
+        "executedText": "Email sent by {{name}} at {{date}}",
+        "failedText": "Email failed to send.",
+        "action": "schedule-email"
+      },
+      "creditCost": 5,
+      "next": { "stepId": "store-outcome", "conditions": { "approvalRequired": true } }
+    },
+    {
+      "id": "store-outcome",
+      "type": "knowledgeSync",
+      "name": "Store Match Outcome",
+      "knowledgeSync": {
+        "source": { "stepId": "rank-top-3", "resultsPath": "matches" },
+        "listKey": "match_outcomes",
+        "fieldMapping": {
+          "candidate_id": "candidate_id",
+          "candidate_name": "candidate_name",
+          "fit_score": "fit_score",
+          "reasoning": "reasoning"
+        }
+      },
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Done"
+    }
+  ]
+}

package/scaffolds/minimal.json

@@ -0,0 +1,20 @@
+{
+  "name": "Minimal Workflow",
+  "goal": "Starting skeleton — replace steps with your pipeline.",
+  "description": "Smallest valid pipeline: trigger -> milestone.",
+  "status": "draft",
+  "steps": [
+    {
+      "id": "start",
+      "type": "trigger",
+      "name": "Manual Start",
+      "pipelineStepStartConditions": { "trigger": { "type": "manual" } },
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Done"
+    }
+  ]
+}