Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

Release v0.22.0

Louis Choquel5554227787d3
diff --git a/.badges/tests.json b/.badges/tests.json
index a09a02d46..241838ebf 100644
--- a/.badges/tests.json
+++ b/.badges/tests.json
@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
"label": "tests",
- "message": "4002",
+ "message": "4031",
"color": "blue",
"cacheSeconds": 300
}
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bbe206b14..8917fc7c6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,31 @@
# Changelog
+## [v0.22.0] - 2026-03-25
+
+### Added
+
+- **MiniMax Backend Support**: Added integration for MiniMax models (M2, M2.1, M2.5, M2.7 series including high-speed variants) with an `all_minimax` routing profile.
+- **`check-model` Agent CLI Command**: Introduced `pipelex-agent check-model` to validate model references. Provides fuzzy matching suggestions, cross-collection suggestions, and wrong-sigil hints when an invalid model is provided.
+- **Domain-Qualified Pipe References (`pipe_ref`)**: Added a `pipe_ref` property (`domain.code`) as the primary pipe index, allowing pipes with the same code to coexist across different domains. Bare code lookups remain supported as a fallback when unambiguous.
+- **Duplicate Concept Detection**: Added validation to warn about duplicate concept declarations across different bundles within the same library.
+- **Shared TOML Formatter**: Extracted a shared `format_toml_string` utility for consistent multi-line string formatting across the MTHDS factory and Agent CLI.
+
+### Changed
+
+- **Agent CLI Output Formats**: Overhauled `pipelex-agent` CLI output for LLM agents: `concept` and `pipe` commands now output raw TOML to stdout; `models` and `doctor` commands output Markdown by default (JSON still available via `--format json`).
+- **Unified `model` Field in Pipe Specs**: Replaced type-specific talent fields (`llm_talent`, `extract_talent`, `img_gen_talent`, `search_talent`) with a single `model` field accepting model presets directly. Talent mappings removed from `pipelex-agent models` output accordingly.
+- **Initialization Checks**: `check_is_initialized` now additionally verifies the presence of `plxt.toml`.
+- **Documentation & Handoffs**: Updated Claude Code skills plugin docs, CLI references.
+
+### Fixed
+
+- **Domain Metadata Conflicts**: Loading multiple bundles declaring the same domain with differing descriptions or system prompts now emits a warning and keeps the first declaration instead of throwing an error.
+- **Cross-Domain Execution Tracking**: Pipe controllers and the dry-run engine now track visited pipes using `pipe_ref` instead of bare codes, preventing false-positive loop detections when crossing domains.
+
+### Removed
+
+- **`assemble` Agent CLI Command**: Removed the `pipelex-agent assemble` command.
+
## [v0.21.0] - 2026-03-19
### Added
diff --git a/HANDOFF_SKILLS_OUTPUT_FORMAT.md b/HANDOFF_SKILLS_OUTPUT_FORMAT.md
deleted file mode 100644
index 238f5828f..000000000
--- a/HANDOFF_SKILLS_OUTPUT_FORMAT.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# Handoff: Agent CLI Output Format Changes → Skills Repo
-
-**Date**: 2026-03-23
-**PR**: #778 (feature/Output-text-for-agents → dev)
-**Scope**: `../skills/skills/` (the published MTHDS marketplace plugin)
-
-## What changed
-
-The `pipelex-agent` CLI changed its output format for several commands:
-
-| Command | Before | After |
-|---------|--------|-------|
-| `concept` | JSON with `toml` field | Raw TOML to stdout |
-| `pipe` | JSON with `toml` field | Raw TOML to stdout |
-| `models` | JSON | **Markdown by default**, JSON with `--format json` |
-| `doctor` | JSON | **Markdown by default**, JSON with `--format json` |
-| `assemble` | JSON | **Removed entirely** |
-
-## What the skills should do
-
-**Do NOT add `--format json` to `models` or `doctor` calls.** The markdown default is intentional — LLM agents consume markdown more naturally than JSON. The skills should expect and work with the markdown output as-is.
-
-The `concept` and `pipe` commands now return raw TOML directly. Any skill that was parsing JSON to extract the `toml` field should read stdout directly instead.
-
-## Files to update
-
-### `skills/shared/mthds-agent-guide.md`
-
-- **Line 47**: "outputs structured JSON (stdout=success, stderr=error with exit code 1)" → Update to reflect the three output modes: JSON for run/validate/inputs/init, raw TOML for concept/pipe, markdown for models/doctor. Errors are always JSON on stderr.
-- **Lines 281-282**: Command table entries for `models` and `doctor` — note markdown default output.
-
-### `skills/mthds-build/SKILL.md`
-
-- **Lines 254-257**: `mthds-agent pipelex models --type ...` — these calls now return markdown. No code change needed, but any surrounding text that says "parse the JSON" should be updated.
-
-### `skills/mthds-build/references/talents-and-presets.md` and `skills/mthds-edit/references/talents-and-presets.md`
-
-- **Line 7**: References `mthds-agent pipelex models` — output is now markdown.
-
-### `skills/mthds-pipelex-setup/SKILL.md`
-
-- **Lines 57, 119**: References `mthds-agent pipelex doctor` — output is now markdown.
-
-### `skills/mthds-run/SKILL.md`
-
-- **Line 62**: References `mthds-agent pipelex doctor` — output is now markdown.
-
-### `skills/shared/error-handling.md`
-
-- **Lines 105-106, 115**: These reference `doctor` in error hints/instructions — no change needed, they just tell the agent to run the command.
-
-## Summary
-
-The key message: **models and doctor now speak markdown to the agent, not JSON. This is by design. Do not revert to JSON.**
diff --git a/pyproject.toml b/pyproject.toml
index 674355461..af2f341e3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "pipelex"
-version = "0.21.0"
+version = "0.22.0"
description = "Execute composable AI methods declared in the MTHDS open standard"
authors = [{ name = "Evotis S.A.S.", email = "[email protected]" }]
maintainers = [{ name = "Pipelex staff", email = "[email protected]" }]
diff --git a/uv.lock b/uv.lock
index e0368a41e..57b584bb4 100644
--- a/uv.lock
+++ b/uv.lock
@@ -3449,7 +3449,7 @@ wheels = [
[[package]]
name = "pipelex"
-version = "0.21.0"
+version = "0.22.0"
source = { editable = "." }
dependencies = [
{ name = "aiofiles" },