padosoft/laravel-flow-ai

Agentic AI layer for padosoft/laravel-flow: LLM prompt nodes, MCP client and server (expose flows as MCP tools), bounded agent nodes, AI flow builder and Flow Advisor. Part of the Laravel Flow 2.0 suite.

v0.0.1 2026-07-07 15:30 UTC

Requires

• php: ^8.3
• illuminate/support: ^13.0

Requires (Dev)

• laravel/pint: ^1.18
• orchestra/testbench: ^11.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.5|^12.5

Suggests

• padosoft/laravel-flow: The core workflow engine this package plugs into.

Apache-2.0

• Lorenzo Padovani

• workflow
• laravel
• agents
• ai
• orchestration
• mcp
• llm
• laravel-flow

Published on Packagist.org on 2026-07-07 15:35 UTC

README

The agentic AI layer for padosoft/laravel-flow: LLM nodes, MCP client/server, bounded agents, AI flow builder and Flow Advisor.

Status

🚧 Under active development — this package is part of the Laravel Flow 2.0 program and is not yet stable. APIs will change without notice until the first tagged minor release. Follow padosoft/laravel-flow for the core engine and roadmap.

What it will provide

• LLM node — provider-agnostic prompt nodes with structured output validated against typed ports (schema-violation auto-retry), token/cost tracked into business impact.
• MCP client node — call external MCP tools as graph nodes.
• MCP server (flow-as-tool) — expose published flows as MCP tools (typed ports → JSON Schema); approval gates pause the calling agent for human sign-off. Disabled by default, per-flow opt-in.
• Bounded agent node — LLM+tools loop with hard token/cost/iteration budgets, tool allowlists and approval escape hatches.
• AI flow builder — natural language → validated flow graph draft.
• Flow Advisor — analyzes your node/MCP catalog and run history to suggest new flows or concrete improvements to existing ones (flow:suggest, flow:improve), always as reviewable drafts.

Requirements

• PHP ^8.3
• Laravel ^13.0

Installation

composer require padosoft/laravel-flow-ai

License

Apache-2.0. See LICENSE.