@llblab/pi-actors 0.12.0

package/recipes/music-player.json

@@ -0,0 +1,25 @@
+{
+  "name": "music-player",
+  "async": true,
+  "args": [
+    "repo:path",
+    "command:enum(play,pause,resume,toggle,next,previous,stop,status)",
+    "source:string",
+    "loop:bool",
+    "volume:int",
+    "player:enum(auto,mpv,ffplay,cvlc,play)",
+    "state_dir:path"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "command": "play",
+    "loop": "true",
+    "volume": "70",
+    "player": "auto"
+  },
+  "mailbox": {
+    "accepts": ["player.play", "player.pause", "player.resume", "player.toggle", "player.next", "player.previous", "player.stop", "player.status"],
+    "emits": ["player.track"]
+  },
+  "template": "{repo}/scripts/music-player.mjs {command} {source} {loop} {volume} {player} {state_dir}"
+}

package/recipes/pipeline-architect-coordinator.json

@@ -0,0 +1,88 @@
+{
+  "name": "pipeline-architect-coordinator",
+  "async": true,
+  "imports": {
+    "reviewer": "subagent-review.json",
+    "critic": "subagent-critic.json",
+    "verifier": "subagent-verify.json",
+    "merger": "subagent-merge.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "problem:string",
+    "lenses:array",
+    "constraints:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "lenses": [
+      "architecture",
+      "implementation pragmatism",
+      "operator UX",
+      "failure modes"
+    ],
+    "constraints": "Prefer small composable pieces, explicit contracts, and no broad workflow DSL.",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["pipeline.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "parallel": true,
+      "repeat": "{lenses.length}",
+      "failure": "branch",
+      "template": {
+        "name": "reviewer",
+        "values": {
+          "scope": "{problem}",
+          "lens": "{lenses[index]}",
+          "instructions": "Propose one architecture direction and one smallest next slice within constraints: {constraints}",
+          "model": "{model}",
+          "thinking": "medium",
+          "tools": "{tools}"
+        }
+      }
+    },
+    {
+      "name": "critic",
+      "values": {
+        "target": "Use proposed directions from stdin for problem: {problem}",
+        "constraints": "{constraints}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "verifier",
+      "values": {
+        "claim": "The proposed architecture can be advanced by a small validated next slice.",
+        "evidence": "Use proposed directions and critique from stdin.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use brainstorm, critique, and verification outputs from stdin.",
+        "mode": "risk-first",
+        "risk_policy": "Prefer a feasible smallest next slice over ambitious completeness.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use architecture synthesis from stdin.",
+        "format": "Markdown sections: Direction, Rejected Alternatives, Risks, Component Contracts, Next Slice, Validation Gates.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-artifact-report.json

@@ -0,0 +1,52 @@
+{
+  "name": "pipeline-artifact-report",
+  "async": true,
+  "imports": {
+    "normalizer": "subagent-normalize.json",
+    "artifact": "subagent-artifact.json",
+    "message": "utility-actor-message.json"
+  },
+  "args": [
+    "input:string",
+    "artifact_path:path",
+    "artifact_format:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "artifact_format": "Markdown sections: Summary, Findings, Evidence, Risks, Next Actions.",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "emits": ["artifact.prepared", "artifact.blocked"]
+  },
+  "template": [
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "{input}",
+        "format": "{artifact_format}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized report from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "{artifact_format}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "message",
+      "values": {
+        "type": "artifact.prepared",
+        "summary": "Artifact prepared for path {artifact_path}."
+      }
+    }
+  ]
+}

package/recipes/pipeline-artifact-write.json

@@ -0,0 +1,66 @@
+{
+  "name": "pipeline-artifact-write",
+  "async": true,
+  "imports": {
+    "normalizer": "subagent-normalize.json",
+    "artifact": "subagent-artifact.json",
+    "writer": "utility-artifact-write.json",
+    "message": "utility-actor-message.json"
+  },
+  "args": [
+    "input:string",
+    "artifact_path:path",
+    "artifact_format:string",
+    "write_mode:enum(create,overwrite,append)",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "artifact_format": "Markdown sections: Summary, Findings, Evidence, Risks, Next Actions.",
+    "write_mode": "create",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "emits": ["artifact.written", "artifact.blocked"]
+  },
+  "artifacts": {
+    "artifact": "{artifact_path}"
+  },
+  "template": [
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "{input}",
+        "format": "{artifact_format}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized report from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "{artifact_format}",
+        "write_policy": "The caller selected deterministic write mode {write_mode}; produce only the artifact content that should be written, with no surrounding commentary outside the artifact body.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "writer",
+      "values": {
+        "artifact_path": "{artifact_path}",
+        "mode": "{write_mode}"
+      }
+    },
+    {
+      "name": "message",
+      "values": {
+        "type": "artifact.written",
+        "summary": "Artifact written to path {artifact_path} using mode {write_mode}."
+      }
+    }
+  ]
+}

package/recipes/pipeline-async-run-ops.json

@@ -0,0 +1,67 @@
+{
+  "name": "pipeline-async-run-ops",
+  "async": true,
+  "imports": {
+    "summary": "utility-run-summary.json",
+    "events": "utility-jsonl-tail.json",
+    "normalizer": "subagent-normalize.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "state_root:path",
+    "event_file:path",
+    "lines:int",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "state_root": "~/.pi/agent/tmp/pi-actors/runs",
+    "event_file": "~/.pi/agent/tmp/pi-actors/runs/music/outbox.jsonl",
+    "lines": "80",
+    "artifact_path": "./async-run-ops.md",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["operations.completed", "artifact.prepared", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "summary",
+      "values": {
+        "state_root": "{state_root}"
+      }
+    },
+    {
+      "name": "events",
+      "failure": "continue",
+      "values": {
+        "file": "{event_file}",
+        "lines": "{lines}",
+        "mode": "raw"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use async run summary and event tail from stdin. State root: {state_root}. Event file: {event_file}.",
+        "format": "Markdown sections: Active Runs, Terminal Runs, Recent Events, Stale/Risky Runs, Recommended Controls, Follow-up Needed.",
+        "model": "{model}",
+        "thinking": "off",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized async-run operations report from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Status, Events, Risks, Recommended Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-checkpoint-continuation.json

@@ -0,0 +1,57 @@
+{
+  "name": "pipeline-checkpoint-continuation",
+  "async": true,
+  "imports": {
+    "checkpoint": "subagent-checkpoint.json",
+    "followup": "subagent-followup.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "state:string",
+    "question:string",
+    "reply:string",
+    "mode:enum(same-context,degraded-new-branch)",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "reply": "No coordinator reply provided yet; produce a checkpoint artifact only.",
+    "mode": "degraded-new-branch",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.reply", "control.revise", "control.stop"],
+    "emits": ["checkpoint.needs_input", "checkpoint.continued", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "checkpoint",
+      "values": {
+        "state": "{state}",
+        "question": "{question}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "followup",
+      "values": {
+        "checkpoint": "Use checkpoint output from stdin.",
+        "reply": "{reply}",
+        "mode": "{mode}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use checkpoint and follow-up outputs from stdin.",
+        "format": "Markdown sections: Checkpoint, Coordinator Reply, Continuation Mode, Lost Context, Next Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-development-tasking.json

@@ -0,0 +1,73 @@
+{
+  "name": "pipeline-development-tasking",
+  "async": true,
+  "imports": {
+    "planner": "subagent-plan.json",
+    "task_card": "subagent-task-card.json",
+    "critic": "subagent-critic.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "goal:string",
+    "allowed:string",
+    "avoided:string",
+    "checks:string",
+    "constraints:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "allowed": "Caller must provide allowed files, directories, or logical scopes before implementation.",
+    "avoided": "Avoid unrelated files, public contracts, generated artifacts, and broad refactors unless explicitly allowed.",
+    "checks": "Smallest validation that proves the task card is complete.",
+    "constraints": "Split into bounded mutation zones and preserve integrator ownership of shared contracts.",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["task_card.completed", "pipeline.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "planner",
+      "values": {
+        "goal": "{goal}",
+        "scope": "Allowed: {allowed}. Avoided: {avoided}.",
+        "constraints": "{constraints}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "task_card",
+      "values": {
+        "goal": "Use plan from stdin to create one bounded implementation assignment for: {goal}",
+        "allowed": "{allowed}",
+        "avoided": "{avoided}",
+        "checks": "{checks}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "critic",
+      "values": {
+        "target": "Use generated plan and task card from stdin.",
+        "constraints": "{constraints}",
+        "risk_policy": "Find unsafe scope expansion, missing ownership, and weak validation gates.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use plan, task card, and critique from stdin.",
+        "format": "Markdown sections: Task Card, Allowed Files, Avoid Files, Checks, Risks, Integrator Notes.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-docs-maintenance.json

@@ -0,0 +1,72 @@
+{
+  "name": "pipeline-docs-maintenance",
+  "async": true,
+  "imports": {
+    "docs_index": "utility-markdown-index.json",
+    "reviewer": "subagent-review.json",
+    "planner": "subagent-plan.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "docs_dir:path",
+    "readme:path",
+    "change_summary:string",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "docs_dir": "docs",
+    "readme": "README.md",
+    "change_summary": "Recent project changes require documentation/index consistency review.",
+    "artifact_path": "./docs-maintenance.md",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["docs.completed", "artifact.prepared", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "docs_index",
+      "values": {
+        "directory": "{docs_dir}",
+        "title": "Documentation Index",
+        "include_pattern": "*.md"
+      }
+    },
+    {
+      "name": "reviewer",
+      "values": {
+        "scope": "README {readme}, docs directory {docs_dir}, and docs index output from stdin.",
+        "lens": "documentation maintenance and navigation consistency",
+        "instructions": "Review whether docs navigation, README entrypoints, and changed behavior are coherent. Change summary: {change_summary}",
+        "output_format": "Markdown sections: Missing Links, Stale Docs, Needed Updates, Safe No-op Areas.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "planner",
+      "values": {
+        "goal": "Prepare a bounded docs maintenance plan for: {change_summary}",
+        "scope": "Use docs index and documentation review from stdin. README: {readme}. Docs dir: {docs_dir}.",
+        "constraints": "Prefer smallest documentation changes; do not rewrite stable docs cosmetically.",
+        "output_format": "Markdown sections: Required Edits, Optional Edits, Validation, Stop Conditions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use docs review and maintenance plan from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Docs State, Required Updates, Optional Follow-up, Validation.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-media-library.json

@@ -0,0 +1,51 @@
+{
+  "name": "pipeline-media-library",
+  "async": true,
+  "imports": {
+    "playlist": "utility-playlist-build.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "source_dir:path",
+    "extensions:string",
+    "max_depth:int",
+    "output_mode:enum(paths,m3u,inline)",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "source_dir": "~/Music",
+    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
+    "max_depth": "2",
+    "output_mode": "m3u",
+    "artifact_path": "./media-library.md",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["media.completed", "artifact.prepared", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "playlist",
+      "values": {
+        "source_dir": "{source_dir}",
+        "extensions": "{extensions}",
+        "max_depth": "{max_depth}",
+        "output_mode": "{output_mode}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use playlist/media listing from stdin. Source directory: {source_dir}. Output mode: {output_mode}.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Source, Playlist Output, Playback Notes, Next Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-quorum-review.json

@@ -0,0 +1,72 @@
+{
+  "name": "pipeline-quorum-review",
+  "async": true,
+  "imports": {
+    "quorum": "subagent-quorum.json",
+    "merger": "subagent-merge.json",
+    "judge": "subagent-judge.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "prompt:string",
+    "models:array",
+    "merge_mode:enum(consensus-first,risk-first)",
+    "merger_model:string",
+    "judge_model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "models": [
+      "openai-codex/gpt-5.5",
+      "openai-codex/gpt-5.4",
+      "deepseek/deepseek-v4-flash"
+    ],
+    "merge_mode": "consensus-first",
+    "merger_model": "openai-codex/gpt-5.5",
+    "judge_model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["quorum.completed", "review.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "quorum",
+      "values": {
+        "prompt": "{prompt}",
+        "models": "{models}",
+        "tools": "{tools}",
+        "output_format": "Vote-style Markdown: Verdict, Rationale, Evidence, Confidence."
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use quorum outputs from stdin.",
+        "mode": "{merge_mode}",
+        "model": "{merger_model}",
+        "tools": "{tools}",
+        "risk_policy": "Preserve vote shape, minority severe findings, and confidence disagreements."
+      }
+    },
+    {
+      "name": "judge",
+      "values": {
+        "report": "Use merged quorum report from stdin.",
+        "evidence": "Use raw quorum outputs and merged report from stdin.",
+        "model": "{judge_model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use merged and judged quorum output from stdin.",
+        "format": "Markdown sections: Verdict, Vote Shape, Consensus, Minority Findings, Confidence, Required Action.",
+        "model": "{merger_model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}