@pipefy/pipefy-process-coder 0.1.0

package/.agents/skills/ppc-pipefy-flow-authoring/examples/README.md

@@ -0,0 +1,42 @@
+# Reference flows
+
+Thirteen real flows from a production trade-finance integration, sanitized
+before being added here — every company name, personal name, email, CNPJ,
+phone number, and address was replaced, and every cached `sampleData` /
+object-shaped `defaultValue` (a captured real API response, not part of the
+flow's structure) was blanked to placeholder values while keeping its shape
+and field names. The scrub was a one-off script, not kept in the repo; a
+future batch needs its own token list built by hand from that batch's real
+values, not a blind re-run of this one's.
+
+**Field names inside the blanked sample data are real and informative** —
+e.g. `cnpjOuCpf`, `idCedente`, `telefoneContato` — only the *values* are
+placeholders. The business logic, node chaining, and CODE steps are
+otherwise unchanged from production.
+
+Two chains, by filename prefix:
+
+## PRD — the live, always-connected chain
+
+| File | What it demonstrates |
+| --- | --- |
+| `01-main-2-webhook-retorno-consulta.json` | `WEBHOOK` trigger → `ROUTER` with an empty branch → calling two subflows (`piece-subflows`) from different branches |
+| `01-main-2-danfe-consulta.json` | `CALLABLE_FLOW` trigger (a subflow's entry point) → `piece-date-helper` → `piece-http-oauth2` (an authenticated external call) → `piece-tables` write |
+| `01-main-4-recebimento-barramento.json` | `WEBHOOK` trigger → `LOOP_ON_ITEMS` over a batch payload → `ROUTER` *inside* the loop with an empty branch → calling a subflow per iteration. The loop-then-router-then-subflow nesting this tool's own compiler had never written before (see `research/ipaas/probe-loop-shape*.ts` and the `AGENTS.md` note on `ADD_ACTION` into a loop) |
+| `02-subflow-2-danfe-retorno.json` | `WEBHOOK` trigger receiving an async callback, `piece-tables` lookup/update, several `CODE` steps formatting Brazilian currency/date/percent values for a Pipefy card update |
+| `02-subflow-4-criacao-operacao.json` | `CALLABLE_FLOW` subflow, `piece-pipefy` `createCard` + `updateCard`, calling a further subflow |
+| `03-subflow-4-criacao-titulo.json` | The deepest one: `LOOP_ON_ITEMS` with a `ROUTER` in its body, `piece-store` for cross-step state (the same `get`/`put`/`remove_value` shape as this project's own CS-request pagination example), `piece-file-helper`, several chained `CALLABLE_FLOW` calls |
+| `04-subflow-4-criacao-cedente.json`, `04-subflow-4-criacao-sacado.json` | Near-identical pair (creditor vs. debtor side of the same process) — good for seeing how two flows built from the same template diverge |
+
+## HML — the staging/monitoring chain
+
+Same business domain, built as standalone monitoring flows rather than
+inline subflows — useful as a *second* worked example of the same node
+types without being a copy-paste of the PRD chain:
+
+| File | What it demonstrates |
+| --- | --- |
+| `hml-01-subflow-1-titulo-acompanhamento-cobranca.json` | `piece-store` state machine, `piece-date-helper`, single-purpose monitoring flow |
+| `hml-01-subflow-1-titulo-nfe-monitoramento.json` | Similar shape, different business event |
+| `hml-01-subflow-1-titulo-retorno-bancario.json` | Similar shape, a bank-return event |
+| `hml-02-subflow-2-retorno-consulta-cedente.json`, `hml-02-subflow-2-retorno-consulta-sacado.json` | `WEBHOOK` trigger + `piece-pipefy` card update, the creditor/debtor pair again |

package/.agents/skills/ppc-pipefy-flow-authoring/examples/hml-01-subflow-1-titulo-acompanhamento-cobranca.json

@@ -0,0 +1,581 @@
+{
+  "name": "✅[PRD][HML][1/1 SUBFLOW][CRIAÇÃO] TÍTULO - AcompanhamentoDeCobranca",
+  "type": "SHARED",
+  "summary": "",
+  "description": "",
+  "tags": [],
+  "blogUrl": "",
+  "metadata": {
+    "externalId": "exampleFlowId10aaaaaa"
+  },
+  "author": "Integrações Ipaas 000000000",
+  "categories": [],
+  "pieces": [
+    "@activepieces/piece-subflows",
+    "@activepieces/piece-date-helper",
+    "@activepieces/piece-pipefy",
+    "@activepieces/piece-store"
+  ],
+  "flows": [
+    {
+      "displayName": "✅[PRD][HML][1/1 SUBFLOW][CRIAÇÃO] TÍTULO - AcompanhamentoDeCobranca",
+      "trigger": {
+        "name": "trigger",
+        "valid": true,
+        "displayName": "Objeto acompanhamentoDeCobranca",
+        "nextAction": {
+          "name": "step_1",
+          "skip": false,
+          "type": "LOOP_ON_ITEMS",
+          "valid": true,
+          "settings": {
+            "items": "{{trigger['output']['data']['acompanhamentoDeCobranca']}}",
+            "sampleData": {}
+          },
+          "nextAction": {
+            "name": "step_5",
+            "skip": false,
+            "type": "PIECE",
+            "valid": true,
+            "settings": {
+              "input": {
+                "key": "listCardId",
+                "store_scope": "RUN"
+              },
+              "pieceName": "@activepieces/piece-store",
+              "actionName": "get",
+              "sampleData": {},
+              "pieceVersion": "0.6.15",
+              "propertySettings": {
+                "key": {
+                  "type": "MANUAL"
+                },
+                "store_scope": {
+                  "type": "MANUAL"
+                },
+                "defaultValue": {
+                  "type": "example"
+                }
+              },
+              "errorHandlingOptions": {
+                "retryOnFailure": {
+                  "value": false
+                },
+                "continueOnFailure": {
+                  "value": false
+                }
+              }
+            },
+            "nextAction": {
+              "name": "step_4",
+              "skip": false,
+              "type": "ROUTER",
+              "valid": true,
+              "children": [
+                {
+                  "name": "step_6",
+                  "skip": false,
+                  "type": "CODE",
+                  "valid": true,
+                  "settings": {
+                    "input": {
+                      "listCardId": "{{step_5['output']}}"
+                    },
+                    "sampleData": {},
+                    "sourceCode": {
+                      "code": "export const code = async (inputs) => {\n  const ids = inputs.listCardId ?? [];\n  const unique = [...new Set(ids.map(String))];\n\n  return {\n    arrayString: JSON.stringify(unique)\n  };\n};",
+                      "packageJson": "{}"
+                    },
+                    "errorHandlingOptions": {
+                      "retryOnFailure": {
+                        "value": false
+                      },
+                      "continueOnFailure": {
+                        "value": false
+                      }
+                    }
+                  },
+                  "nextAction": {
+                    "name": "step_7",
+                    "skip": false,
+                    "type": "PIECE",
+                    "valid": true,
+                    "settings": {
+                      "input": {
+                        "url": {
+                          "url": "https://api.pipefy.com/graphql"
+                        },
+                        "auth": "{{connections['exampleConnectionId3']}}",
+                        "body": {
+                          "data": {
+                            "query": "mutation  {\n  updateCardField(input: {card_id:\"{{trigger['output']['data']['cardIdTitulo']}}\", field_id:\"despacho\", new_value:{{step_6['output']['arrayString']}}}) {\n    clientMutationId\n  } \n\t\n}\n",
+                            "variables": null
+                          }
+                        },
+                        "method": "POST",
+                        "headers": {},
+                        "failsafe": false,
+                        "body_type": "json",
+                        "queryParams": {},
+                        "followRedirects": false,
+                        "response_is_binary": false
+                      },
+                      "pieceName": "@activepieces/piece-pipefy",
+                      "actionName": "custom_api_call",
+                      "sampleData": {},
+                      "pieceVersion": "0.1.8",
+                      "propertySettings": {
+                        "url": {
+                          "type": "MANUAL",
+                          "schema": {
+                            "url": {
+                              "type": "SHORT_TEXT",
+                              "required": true,
+                              "description": "You can either use the full URL or the relative path to the base URL\ni.e https://api.pipefy.com/graphql/resource or /resource",
+                              "displayName": "URL",
+                              "defaultValue": "https://api.pipefy.com/graphql"
+                            }
+                          }
+                        },
+                        "body": {
+                          "type": "MANUAL",
+                          "schema": {
+                            "data": {
+                              "type": "JSON",
+                              "required": true,
+                              "displayName": "JSON Body"
+                            }
+                          }
+                        },
+                        "method": {
+                          "type": "MANUAL"
+                        },
+                        "headers": {
+                          "type": "MANUAL"
+                        },
+                        "timeout": {
+                          "type": "MANUAL"
+                        },
+                        "failsafe": {
+                          "type": "MANUAL"
+                        },
+                        "body_type": {
+                          "type": "MANUAL"
+                        },
+                        "queryParams": {
+                          "type": "MANUAL"
+                        },
+                        "followRedirects": {
+                          "type": "MANUAL"
+                        },
+                        "response_is_binary": {
+                          "type": "MANUAL"
+                        }
+                      },
+                      "errorHandlingOptions": {
+                        "retryOnFailure": {
+                          "value": false
+                        },
+                        "continueOnFailure": {
+                          "value": false
+                        }
+                      }
+                    },
+                    "nextAction": {
+                      "name": "step_8",
+                      "type": "PIECE",
+                      "valid": true,
+                      "settings": {
+                        "input": {
+                          "mode": "simple",
+                          "response": {
+                            "response": {}
+                          }
+                        },
+                        "pieceName": "@activepieces/piece-subflows",
+                        "actionName": "returnResponse",
+                        "sampleData": {},
+                        "pieceVersion": "0.4.15",
+                        "propertySettings": {
+                          "mode": {
+                            "type": "MANUAL"
+                          },
+                          "response": {
+                            "type": "MANUAL",
+                            "schema": {
+                              "response": {
+                                "type": "OBJECT",
+                                "required": true,
+                                "displayName": "Response"
+                              }
+                            }
+                          }
+                        },
+                        "errorHandlingOptions": {
+                          "retryOnFailure": {
+                            "value": false
+                          },
+                          "continueOnFailure": {
+                            "value": false
+                          }
+                        }
+                      },
+                      "displayName": "Return Response",
+                      "lastUpdatedDate": "2026-08-11T12:59:29.194Z"
+                    },
+                    "displayName": "Atualização Retorno Bancário",
+                    "lastUpdatedDate": "2026-08-11T12:59:29.194Z"
+                  },
+                  "displayName": "arrayString",
+                  "lastUpdatedDate": "2026-08-11T12:59:29.194Z"
+                },
+                {
+                  "name": "step_9",
+                  "type": "PIECE",
+                  "valid": true,
+                  "settings": {
+                    "input": {
+                      "mode": "simple",
+                      "response": {
+                        "response": {}
+                      }
+                    },
+                    "pieceName": "@activepieces/piece-subflows",
+                    "actionName": "returnResponse",
+                    "sampleData": {},
+                    "pieceVersion": "0.4.15",
+                    "propertySettings": {
+                      "mode": {
+                        "type": "MANUAL"
+                      },
+                      "response": {
+                        "type": "MANUAL",
+                        "schema": {
+                          "response": {
+                            "type": "OBJECT",
+                            "required": true,
+                            "displayName": "Response"
+                          }
+                        }
+                      }
+                    },
+                    "errorHandlingOptions": {
+                      "retryOnFailure": {
+                        "value": false
+                      },
+                      "continueOnFailure": {
+                        "value": false
+                      }
+                    }
+                  },
+                  "displayName": "Return Response",
+                  "lastUpdatedDate": "2026-08-11T12:59:29.195Z"
+                }
+              ],
+              "settings": {
+                "branches": [
+                  {
+                    "branchName": "Is not empty",
+                    "branchType": "CONDITION",
+                    "conditions": [
+                      [
+                        {
+                          "operator": "LIST_IS_NOT_EMPTY",
+                          "firstValue": "{{step_5['output']}}"
+                        }
+                      ]
+                    ]
+                  },
+                  {
+                    "branchName": "Otherwise",
+                    "branchType": "FALLBACK"
+                  }
+                ],
+                "sampleData": {},
+                "executionType": "EXECUTE_FIRST_MATCH"
+              },
+              "displayName": "Verificar Lista",
+              "lastUpdatedDate": "2026-08-11T12:59:29.194Z"
+            },
+            "displayName": "Get - listCardId",
+            "lastUpdatedDate": "2026-08-11T12:59:29.193Z"
+          },
+          "displayName": "Iteração retornosBancarios",
+          "firstLoopAction": {
+            "name": "step_10",
+            "skip": false,
+            "type": "PIECE",
+            "valid": true,
+            "settings": {
+              "input": {
+                "inputDate": "{{step_1['output']['item']['movData']}}",
+                "inputFormat": "YYYY-MM-DDTHH:mm:ss",
+                "outputFormat": "DD-MM-YYYY",
+                "inputTimeZone": "UTC",
+                "outputTimeZone": "UTC"
+              },
+              "pieceName": "@activepieces/piece-date-helper",
+              "actionName": "format_date",
+              "sampleData": {},
+              "pieceVersion": "0.1.28",
+              "propertySettings": {
+                "inputDate": {
+                  "type": "MANUAL"
+                },
+                "inputFormat": {
+                  "type": "MANUAL"
+                },
+                "outputFormat": {
+                  "type": "MANUAL"
+                },
+                "inputTimeZone": {
+                  "type": "MANUAL"
+                },
+                "outputTimeZone": {
+                  "type": "MANUAL"
+                }
+              },
+              "errorHandlingOptions": {
+                "retryOnFailure": {
+                  "value": false
+                },
+                "continueOnFailure": {
+                  "value": false
+                }
+              }
+            },
+            "nextAction": {
+              "name": "step_2",
+              "skip": false,
+              "type": "PIECE",
+              "valid": true,
+              "settings": {
+                "input": {
+                  "auth": "{{connections['exampleConnectionId3']}}",
+                  "pipeId": "200000006",
+                  "organizationId": "100000001",
+                  "startFormFields": {
+                    "id": "{{step_1['output']['item']['id']}}",
+                    "data": "{{step_10['output']['result']}}",
+                    "valor": "{{step_1['output']['item']['valor']}}",
+                    "c_digo": "{{step_1['output']['item']['movCodigo']}}",
+                    "evento": "{{step_1['output']['item']['evento']}}",
+                    "origem": "{{step_1['output']['item']['movOrigem']}}",
+                    "usu_rio": "{{step_1['output']['item']['movUsuario']}}",
+                    "descri_o": "{{step_1['output']['item']['movDescricao']}}",
+                    "empresa_c_digo": "{{step_1['output']['item']['empCodigo']}}",
+                    "data_para_contato": "{{step_1['output']['item']['dataPContato']}}",
+                    "identifica_origem": "{{step_1['output']['item']['movIdentificaOrigem']}}"
+                  }
+                },
+                "pieceName": "@activepieces/piece-pipefy",
+                "actionName": "createCard",
+                "sampleData": {},
+                "pieceVersion": "0.1.8",
+                "propertySettings": {
+                  "pipeId": {
+                    "type": "MANUAL"
+                  },
+                  "organizationId": {
+                    "type": "MANUAL"
+                  },
+                  "startFormFields": {
+                    "type": "MANUAL",
+                    "schema": {
+                      "id": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "ID"
+                      },
+                      "data": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Data"
+                      },
+                      "valor": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Valor"
+                      },
+                      "c_digo": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Código"
+                      },
+                      "evento": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Evento"
+                      },
+                      "origem": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Origem"
+                      },
+                      "usu_rio": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Usuário"
+                      },
+                      "descri_o": {
+                        "type": "LONG_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Descrição"
+                      },
+                      "empresa_c_digo": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Empresa código"
+                      },
+                      "data_para_contato": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Data para contato"
+                      },
+                      "identifica_origem": {
+                        "type": "SHORT_TEXT",
+                        "required": false,
+                        "description": "",
+                        "displayName": "Identifica Origem"
+                      }
+                    }
+                  }
+                },
+                "errorHandlingOptions": {
+                  "retryOnFailure": {
+                    "value": false
+                  },
+                  "continueOnFailure": {
+                    "value": true
+                  }
+                }
+              },
+              "nextAction": {
+                "name": "step_3",
+                "skip": false,
+                "type": "PIECE",
+                "valid": true,
+                "settings": {
+                  "input": {
+                    "key": "listCardId",
+                    "value": [
+                      "{{step_2['output']['data']['createCard']['card']['id']}}"
+                    ],
+                    "store_scope": "RUN",
+                    "ignore_if_exists": false
+                  },
+                  "pieceName": "@activepieces/piece-store",
+                  "actionName": "add_to_list",
+                  "sampleData": {},
+                  "pieceVersion": "0.6.15",
+                  "propertySettings": {
+                    "key": {
+                      "type": "MANUAL"
+                    },
+                    "value": {
+                      "type": "MANUAL"
+                    },
+                    "store_scope": {
+                      "type": "MANUAL"
+                    },
+                    "ignore_if_exists": {
+                      "type": "MANUAL"
+                    }
+                  },
+                  "errorHandlingOptions": {
+                    "retryOnFailure": {
+                      "value": false
+                    },
+                    "continueOnFailure": {
+                      "value": false
+                    }
+                  }
+                },
+                "displayName": "Add To List - listCardId",
+                "lastUpdatedDate": "2026-08-11T12:59:29.194Z"
+              },
+              "displayName": "Criação Retorno Bancário - 200000008",
+              "lastUpdatedDate": "2026-08-11T12:59:29.194Z"
+            },
+            "displayName": "Formato Data",
+            "lastUpdatedDate": "2026-08-11T12:59:29.193Z"
+          },
+          "lastUpdatedDate": "2026-08-11T12:59:29.193Z"
+        },
+        "lastUpdatedDate": "2026-08-11T12:59:29.193Z",
+        "type": "PIECE_TRIGGER",
+        "settings": {
+          "sampleData": {},
+          "propertySettings": {
+            "mode": {
+              "type": "MANUAL"
+            },
+            "exampleData": {
+              "type": "MANUAL",
+              "schema": {
+                "sampleData": {
+                  "type": "example",
+                  "required": false,
+                  "displayName": "example"
+                }
+              }
+            }
+          },
+          "pieceName": "@activepieces/piece-subflows",
+          "pieceVersion": "0.4.15",
+          "triggerName": "callableFlow",
+          "input": {
+            "mode": "advanced",
+            "exampleData": {
+              "sampleData": {
+                "cardIdTitulo": "example",
+                "acompanhamentoDeCobranca": [
+                  {
+                    "id": "example",
+                    "valor": 0,
+                    "evento": "example",
+                    "movData": "example",
+                    "empCodigo": 0,
+                    "movCodigo": "example",
+                    "movOrigem": "example",
+                    "movUsuario": "example",
+                    "dataPContato": "example",
+                    "movDescricao": "example",
+                    "movIdentificaOrigem": "example"
+                  },
+                  {
+                    "id": "example",
+                    "valor": 0,
+                    "evento": "example",
+                    "movData": "example",
+                    "empCodigo": 0,
+                    "movCodigo": "example",
+                    "movOrigem": "example",
+                    "movUsuario": "example",
+                    "dataPContato": "example",
+                    "movDescricao": "example",
+                    "movIdentificaOrigem": "example"
+                  }
+                ]
+              }
+            }
+          }
+        }
+      },
+      "valid": true,
+      "schemaVersion": "22",
+      "notes": []
+    }
+  ],
+  "status": "PUBLISHED"
+}