@agentled/cli 0.7.6 → 0.7.8

package/scaffolds/orchestrator-kg-loop.json

@@ -0,0 +1,96 @@
+{
+  "name": "Orchestrator: Loop call-workflow over KG",
+  "goal": "Read rows from a KG list, call a child workflow per row to score/process each, persist the results back to KG, then summarize.",
+  "description": "Pattern 11 (orchestrator) wired to a child built from the `child-with-return` scaffold. The KG list is the source of truth; the child encapsulates the per-row logic. Uses `entryConditions.type: \"loop_completion\"` with `onCriteriaFail: \"wait\"` so downstream steps block until every child finishes.",
+  "status": "draft",
+  "context": {
+    "executionInputConfig": {
+      "title": "Orchestrate Scoring",
+      "description": "Score every `new` row in the KG list by calling a child workflow per row.",
+      "runCTALabel": "Run",
+      "allowRegeneration": false,
+      "fields": [
+        { "name": "source_list_key", "label": "Source KG list key", "type": "text", "required": true },
+        { "name": "child_workflow_id", "label": "Child workflow id (the scoring workflow)", "type": "text", "required": true }
+      ]
+    }
+  },
+  "steps": [
+    {
+      "id": "start",
+      "type": "trigger",
+      "name": "Manual Start",
+      "pipelineStepStartConditions": { "trigger": { "type": "manual" } },
+      "next": { "stepId": "read-candidates" }
+    },
+    {
+      "id": "read-candidates",
+      "type": "appAction",
+      "name": "Read Candidates from KG",
+      "app": { "id": "kg", "actionId": "kg.read-list", "source": "native" },
+      "stepInputData": {
+        "listKey": "{{input.source_list_key}}",
+        "status": "new",
+        "limit": "50"
+      },
+      "next": { "stepId": "call-child" }
+    },
+    {
+      "id": "call-child",
+      "type": "appAction",
+      "name": "Score Row (child workflow)",
+      "loopConfig": {
+        "source": "executionContent",
+        "config": { "stepId": "read-candidates", "field": "listEntries" },
+        "ItemAlias": "row"
+      },
+      "app": { "id": "agentled", "actionId": "agentled.call-workflow", "source": "native" },
+      "stepInputData": {
+        "workflowId": "{{input.child_workflow_id}}",
+        "executionInputData": "{\"entity_id\": \"{{row.id}}\", \"entity_url\": \"{{row.url}}\"}",
+        "timeoutMinutes": "30"
+      },
+      "next": { "stepId": "persist-scores" }
+    },
+    {
+      "id": "persist-scores",
+      "type": "appAction",
+      "name": "Write Scores Back to KG",
+      "app": { "id": "kg", "actionId": "kg.update-rows", "source": "native" },
+      "entryConditions": {
+        "onCriteriaFail": "wait",
+        "conditionText": "Wait for every child call to complete before flipping status.",
+        "criteria": [
+          { "type": "loop_completion", "stepId": "call-child", "operator": "==", "value": true }
+        ]
+      },
+      "stepInputData": {
+        "listKey": "{{input.source_list_key}}",
+        "rowIds": "{{steps.call-child.rowIds}}",
+        "fieldUpdates": "{{steps.call-child.returnData}}",
+        "status": "scored"
+      },
+      "next": { "stepId": "summarize" }
+    },
+    {
+      "id": "summarize",
+      "type": "aiAction",
+      "name": "Summarize Run",
+      "pipelineStepPrompt": {
+        "template": "Summarize this orchestration run.\n\nRows processed: {{steps.read-candidates.count}}\nResults: {{steps.call-child.returnData}}\n\nReport totals, top-3 by score, and anything that looked anomalous.",
+        "responseStructure": {
+          "totals": "object — counts by decision bucket",
+          "top": "array — top 3 rows",
+          "notes": "string"
+        }
+      },
+      "creditCost": 5,
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Orchestration Done"
+    }
+  ]
+}

package/scaffolds/source-from-platform.json

@@ -0,0 +1,78 @@
+{
+  "_scaffold": "source-from-platform",
+  "_description": "Source entities from a native app, normalize them, and upsert to KG with status:new. Pair with a downstream scoring workflow that reads status:new.",
+  "name": "Source from Platform",
+  "goal": "Source entities from a platform and write them to a Knowledge Graph list for downstream processing.",
+  "status": "draft",
+  "context": {
+    "executionInputConfig": {
+      "title": "Run Sourcing",
+      "description": "Source entities and add them to the Knowledge Graph.",
+      "runCTALabel": "Source",
+      "fields": [
+        { "name": "search_query", "label": "Search query", "type": "text", "required": true },
+        { "name": "target_list_key", "label": "Target list key", "type": "text", "required": true, "defaultValue": "leads", "description": "Knowledge list key (e.g. \"leads\", \"startups\")." }
+      ]
+    }
+  },
+  "steps": [
+    {
+      "id": "start",
+      "type": "trigger",
+      "name": "Scheduled sourcing",
+      "pipelineStepStartConditions": {
+        "trigger": {
+          "type": "schedule",
+          "description": "Run weekly.",
+          "config": { "frequency": "weekly", "dayOfWeek": "monday", "time": "08:00" }
+        }
+      },
+      "next": { "stepId": "source-entities" }
+    },
+    {
+      "id": "source-entities",
+      "type": "appAction",
+      "name": "Source entities",
+      "_comment": "Replace the app with the source action. Run: agentled apps for-source <platform>",
+      "app": { "id": "REPLACE_WITH_APP_ID", "actionId": "REPLACE_WITH_APP_ID.REPLACE_WITH_ACTION_ID", "source": "native" },
+      "stepInputData": {
+        "query": "{{input.search_query}}",
+        "limit": "25"
+      },
+      "creditCost": 2,
+      "next": { "stepId": "normalize-entities" }
+    },
+    {
+      "id": "normalize-entities",
+      "type": "aiAction",
+      "name": "Normalize entities",
+      "pipelineStepPrompt": {
+        "template": "Extract real entities from the source output.\n\nSource output:\n{{steps.source-entities}}\n\nRules:\n- Keep only identifiable entities.\n- Use a stable userKey, preferably domain, profile URL, email, or canonical source URL.\n- Set rowData.status to \"new\".\n- Include source, source_url, sourced_at, and enough evidence for a downstream scoring workflow.\n- Do not score, find contacts, or draft outreach here.\n\nReturn JSON only.",
+        "responseStructure": {
+          "rows": "array of { userKey: string, rowData: object }",
+          "count": "number"
+        }
+      },
+      "creditCost": 5,
+      "next": { "stepId": "save-entities" }
+    },
+    {
+      "id": "save-entities",
+      "type": "appAction",
+      "name": "Save entities",
+      "app": { "id": "kg", "actionId": "kg.upsert-rows", "source": "native" },
+      "stepInputData": {
+        "listKey": "{{input.target_list_key}}",
+        "rows": "{{steps.normalize-entities.rows}}",
+        "mergeStrategy": "merge",
+        "status": "new"
+      },
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Sourcing complete"
+    }
+  ]
+}

package/scaffolds/source-to-kg.json

@@ -0,0 +1,88 @@
+{
+  "name": "Source -> KG (idempotent sourcing)",
+  "goal": "Find entities and write them to a KG list with a stable userKey so re-running never produces duplicates.",
+  "description": "Pattern 15a (sourcing half of the Source -> Process split). Pair this scaffold with `kg-process-update` as the consumer. Uses `kg.upsert-rows` with `userKey` for O(1) dedup across runs and `status: \"new\"` so the processing workflow can filter cleanly.",
+  "status": "draft",
+  "context": {
+    "executionInputConfig": {
+      "title": "Source Entities",
+      "description": "Find entities and add them to the shared KG list.",
+      "runCTALabel": "Source",
+      "allowRegeneration": false,
+      "fields": [
+        { "name": "search_query", "label": "Search query / topic", "type": "text", "required": true },
+        { "name": "target_list_key", "label": "Target KG list key", "type": "text", "required": true }
+      ]
+    }
+  },
+  "steps": [
+    {
+      "id": "schedule",
+      "type": "trigger",
+      "name": "Weekly source",
+      "pipelineStepStartConditions": {
+        "trigger": {
+          "type": "schedule",
+          "description": "Run weekly on Monday morning.",
+          "config": { "frequency": "weekly", "dayOfWeek": "monday", "time": "08:00" }
+        }
+      },
+      "next": { "stepId": "generate-queries" }
+    },
+    {
+      "id": "generate-queries",
+      "type": "aiAction",
+      "name": "Generate Optimized Queries",
+      "pipelineStepPrompt": {
+        "template": "Generate 3 optimized search queries to find new entities matching: {{input.search_query}}\n\nUse boolean operators and filters appropriate to the target platform. Return a flat list of strings.",
+        "responseStructure": {
+          "queries": "array of strings"
+        }
+      },
+      "creditCost": 3,
+      "next": { "stepId": "search" }
+    },
+    {
+      "id": "search",
+      "type": "appAction",
+      "name": "Search (replace with target platform)",
+      "app": { "id": "REPLACE_WITH_APP_ID", "actionId": "REPLACE_WITH_APP_ID.REPLACE_WITH_ACTION_ID", "source": "native" },
+      "stepInputData": {
+        "queries": "{{steps.generate-queries.queries}}"
+      },
+      "creditCost": 2,
+      "next": { "stepId": "extract" }
+    },
+    {
+      "id": "extract",
+      "type": "aiAction",
+      "name": "Extract Entities",
+      "pipelineStepPrompt": {
+        "template": "Extract structured entity records from this raw source output.\n\nSource: {{steps.search.output}}\n\nEvery row MUST include a stable identifier (canonical URL, domain, or platform id) — this becomes the userKey for KG dedup. Drop rows you cannot uniquely identify.",
+        "responseStructure": {
+          "items": "array of { userKey: string (stable id e.g. canonical URL), rowData: { name, url, description, ...other fields } }"
+        }
+      },
+      "creditCost": 5,
+      "next": { "stepId": "save-to-kg" }
+    },
+    {
+      "id": "save-to-kg",
+      "type": "appAction",
+      "name": "Upsert to KG (status: new)",
+      "app": { "id": "kg", "actionId": "kg.upsert-rows", "source": "native" },
+      "stepInputData": {
+        "listKey": "{{input.target_list_key}}",
+        "rows": "{{steps.extract.items}}",
+        "mergeStrategy": "merge",
+        "status": "new"
+      },
+      "next": { "stepId": "done" }
+    },
+    {
+      "id": "done",
+      "type": "milestone",
+      "name": "Sourcing Done"
+    }
+  ]
+}