@llblab/pi-actors 0.12.0

package/recipes/subagent-quorum.json

@@ -0,0 +1,41 @@
+{
+  "name": "subagent-quorum",
+  "async": true,
+  "imports": {
+    "subagent": "subagent-prompt.json"
+  },
+  "args": [
+    "prompt:string",
+    "models:array",
+    "thinking:string",
+    "tools:string",
+    "output_format:string"
+  ],
+  "defaults": {
+    "models": [
+      "openai-codex/gpt-5.5",
+      "openai-codex/gpt-5.4",
+      "deepseek/deepseek-v4-flash"
+    ],
+    "thinking": "off",
+    "tools": "",
+    "output_format": "Vote-style Markdown: Verdict, Rationale, Evidence, Confidence."
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["command.done", "run.done", "run.failed"]
+  },
+  "repeat": "{models.length}",
+  "parallel": true,
+  "failure": "branch",
+  "template": {
+    "name": "subagent",
+    "values": {
+      "prompt": "{prompt}",
+      "model": "{models[index]}",
+      "thinking": "{thinking}",
+      "tools": "{tools}",
+      "output_format": "{output_format}"
+    }
+  }
+}

package/recipes/subagent-review-coordinator.json

@@ -0,0 +1,107 @@
+{
+  "name": "subagent-review-coordinator",
+  "async": true,
+  "imports": {
+    "reviewer": "subagent-review.json",
+    "verifier": "subagent-verify.json",
+    "merger": "subagent-merge.json",
+    "judge": "subagent-judge.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "scope:string",
+    "lenses:array",
+    "claim:string",
+    "reviewer_model:string",
+    "verifier_model:string",
+    "merger_model:string",
+    "judge_model:string",
+    "thinking:string",
+    "tools:string",
+    "evidence_policy:string",
+    "risk_policy:string",
+    "output_format:string"
+  ],
+  "defaults": {
+    "lenses": [
+      "correctness",
+      "architecture",
+      "operator UX"
+    ],
+    "claim": "The reviewed scope is ready for the next implementation or release step.",
+    "reviewer_model": "openai-codex/gpt-5.5",
+    "verifier_model": "openai-codex/gpt-5.5",
+    "merger_model": "openai-codex/gpt-5.5",
+    "judge_model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": "",
+    "evidence_policy": "Cite inspected files, command output, or explicit uncertainty for every material claim.",
+    "risk_policy": "Preserve minority high-impact risks and separate confirmed issues from hypotheses.",
+    "output_format": "Markdown sections: Summary, Consensus Findings, Minority Findings, Verification, Judge Notes, Risks, Next Actions."
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["review.completed", "verification.completed", "merge.completed", "judge.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "parallel": true,
+      "repeat": "{lenses.length}",
+      "failure": "branch",
+      "template": {
+        "name": "reviewer",
+        "values": {
+          "scope": "{scope}",
+          "lens": "{lenses[index]}",
+          "model": "{reviewer_model}",
+          "thinking": "{thinking}",
+          "tools": "{tools}",
+          "evidence_policy": "{evidence_policy}",
+          "risk_policy": "{risk_policy}"
+        }
+      }
+    },
+    {
+      "name": "verifier",
+      "values": {
+        "claim": "{claim}",
+        "evidence": "Use previous reviewer outputs from stdin and named scope: {scope}.",
+        "model": "{verifier_model}",
+        "thinking": "{thinking}",
+        "tools": "{tools}",
+        "evidence_policy": "{evidence_policy}"
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use previous reviewer and verifier outputs from stdin.",
+        "mode": "consensus-first",
+        "model": "{merger_model}",
+        "thinking": "medium",
+        "tools": "{tools}",
+        "risk_policy": "{risk_policy}"
+      }
+    },
+    {
+      "name": "judge",
+      "values": {
+        "report": "Use merged output from stdin.",
+        "evidence": "Use previous reviewer, verifier, and merger outputs from stdin.",
+        "model": "{judge_model}",
+        "thinking": "medium",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use merged and judged output from stdin.",
+        "format": "{output_format}",
+        "model": "{merger_model}",
+        "thinking": "off",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/subagent-review.json

@@ -0,0 +1,30 @@
+{
+  "name": "subagent-review",
+  "async": true,
+  "args": [
+    "scope:string",
+    "lens:string",
+    "instructions:string",
+    "evidence_policy:string",
+    "risk_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "lens": "evidence-grounded review",
+    "instructions": "Return findings with evidence, risk, and recommended next action.",
+    "evidence_policy": "Cite inspected files, command output, or explicit uncertainty for every material claim.",
+    "risk_policy": "Preserve minority high-impact risks and separate confirmed issues from hypotheses.",
+    "output_format": "Markdown sections: Findings, Evidence, Risks, Next Actions.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["review.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Review {scope} through this lens: {lens}. Instructions: {instructions}. Evidence policy: {evidence_policy}. Risk policy: {risk_policy}. Output format: {output_format}"
+}

package/recipes/subagent-task-card.json

@@ -0,0 +1,28 @@
+{
+  "name": "subagent-task-card",
+  "async": true,
+  "args": [
+    "goal:string",
+    "allowed:string",
+    "avoided:string",
+    "checks:string",
+    "handoff_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "allowed": "Caller must name allowed files, directories, or logical scope.",
+    "avoided": "Avoid unrelated files, public contracts, generated artifacts, and broad refactors unless explicitly allowed.",
+    "checks": "Name the smallest validation commands or review gates that prove completion.",
+    "handoff_format": "Markdown sections: Task, Allowed Files, Avoid Files, Expected Output, Checks, Handoff Notes.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["task_card.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Create a bounded implementation task card. Goal: {goal}. Allowed: {allowed}. Avoided: {avoided}. Checks: {checks}. Handoff format: {handoff_format}"
+}

package/recipes/subagent-tools.json

@@ -0,0 +1,17 @@
+{
+  "name": "subagent-tools",
+  "async": true,
+  "args": [
+    "prompt:string",
+    "tools:string",
+    "model:string"
+  ],
+  "defaults": {
+    "model": "openai-codex/gpt-5.5"
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["command.done", "run.done", "run.failed"]
+  },
+  "template": "pi -p --model {model} --tools {tools} {prompt}"
+}

package/recipes/subagent-verify.json

@@ -0,0 +1,27 @@
+{
+  "name": "subagent-verify",
+  "async": true,
+  "args": [
+    "claim:string",
+    "evidence:string",
+    "acceptance:string",
+    "evidence_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "acceptance": "Separate proven, disproven, unknown, and missing evidence.",
+    "evidence_policy": "Do not infer beyond provided evidence or inspected artifacts.",
+    "output_format": "Markdown sections: Verdict, Evidence, Gaps, Confidence.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["verification.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Verify this claim against the provided evidence. Claim: {claim}. Evidence or artifact paths: {evidence}. Acceptance: {acceptance}. Evidence policy: {evidence_policy}. Output format: {output_format}"
+}

package/recipes/subagents-prompts.json

@@ -0,0 +1,32 @@
+{
+  "name": "subagents-prompts",
+  "async": true,
+  "imports": {
+    "subagent": "subagent-prompt.json"
+  },
+  "args": [
+    "prompts:array",
+    "report_path:path",
+    "summary_path:path"
+  ],
+  "defaults": {
+    "report_path": "{state_dir}/stdout.log",
+    "summary_path": "{state_dir}/result.json"
+  },
+  "artifacts": {
+    "report": "{report_path}",
+    "summary": "{summary_path}"
+  },
+  "mailbox": {
+    "emits": ["command.done", "run.done", "run.failed"]
+  },
+  "repeat": "{prompts.length}",
+  "parallel": true,
+  "failure": "branch",
+  "template": {
+    "name": "subagent",
+    "values": {
+      "prompt": "{prompts[index]}"
+    }
+  }
+}

package/recipes/utility-actor-message.json

@@ -0,0 +1,24 @@
+{
+  "name": "utility-actor-message",
+  "async": false,
+  "args": [
+    "type:string",
+    "to:string",
+    "from:string",
+    "summary:string",
+    "metadata:string",
+    "correlation_id:string",
+    "reply_to:string",
+    "repo:path"
+  ],
+  "defaults": {
+    "to": "coordinator",
+    "from": "run:{run_id}",
+    "summary": "",
+    "metadata": "{}",
+    "correlation_id": "",
+    "reply_to": "",
+    "repo": "~/.pi/agent/extensions/pi-actors"
+  },
+  "template": "node {repo}/scripts/recipe-utils.mjs actor-message {type} {to} {from} {summary} {metadata} {correlation_id} {reply_to}"
+}

package/recipes/utility-artifact-manifest.json

@@ -0,0 +1,17 @@
+{
+  "name": "utility-artifact-manifest",
+  "args": [
+    "repo:path",
+    "artifact_path:path",
+    "title:string",
+    "status:enum(draft,ready,blocked,accepted)",
+    "summary:string"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "title": "Artifact",
+    "status": "draft",
+    "summary": "Machine-readable artifact manifest."
+  },
+  "template": "{repo}/scripts/recipe-utils.mjs artifact-manifest {artifact_path} {title} {status} {summary}"
+}

package/recipes/utility-artifact-write.json

@@ -0,0 +1,17 @@
+{
+  "name": "utility-artifact-write",
+  "async": false,
+  "args": [
+    "repo:path",
+    "artifact_path:path",
+    "mode:enum(create,overwrite,append)"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "mode": "create"
+  },
+  "template": {
+    "template": "{repo}/scripts/recipe-utils.mjs artifact-write {artifact_path} {mode}",
+    "output": "stdout"
+  }
+}

package/recipes/utility-changelog-head.json

@@ -0,0 +1,12 @@
+{
+  "name": "utility-changelog-head",
+  "args": [
+    "file:path",
+    "lines:int"
+  ],
+  "defaults": {
+    "file": "CHANGELOG.md",
+    "lines": "80"
+  },
+  "template": "head -n {lines} {file}"
+}

package/recipes/utility-changelog-section.json

@@ -0,0 +1,14 @@
+{
+  "name": "utility-changelog-section",
+  "args": [
+    "repo:path",
+    "file:path",
+    "version:string"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "file": "CHANGELOG.md",
+    "version": "0.7.1"
+  },
+  "template": "{repo}/scripts/recipe-utils.mjs changelog-section {file} {version}"
+}

package/recipes/utility-git-log.json

@@ -0,0 +1,12 @@
+{
+  "name": "utility-git-log",
+  "args": [
+    "repo:path",
+    "count:int"
+  ],
+  "defaults": {
+    "repo": ".",
+    "count": "8"
+  },
+  "template": "git -C {repo} log --oneline --decorate -n {count}"
+}

package/recipes/utility-git-status.json

@@ -0,0 +1,10 @@
+{
+  "name": "utility-git-status",
+  "args": [
+    "repo:path"
+  ],
+  "defaults": {
+    "repo": "."
+  },
+  "template": "git -C {repo} status --short --branch"
+}

package/recipes/utility-jsonl-tail.json

@@ -0,0 +1,11 @@
+{
+  "name": "utility-jsonl-tail",
+  "args": [
+    "file:path",
+    "lines:int"
+  ],
+  "defaults": {
+    "lines": "40"
+  },
+  "template": "tail -n {lines} {file}"
+}

package/recipes/utility-markdown-index.json

@@ -0,0 +1,15 @@
+{
+  "name": "utility-markdown-index",
+  "args": [
+    "directory:path",
+    "title:string",
+    "include_pattern:string",
+    "output_format:string"
+  ],
+  "defaults": {
+    "title": "Documentation Index",
+    "include_pattern": "*.md",
+    "output_format": "Markdown bullet list with relative links and one-line descriptions when headings are available."
+  },
+  "template": "find {directory} -maxdepth 1 -name {include_pattern} -type f -printf '%f\\n'"
+}

package/recipes/utility-package-summary.json

@@ -0,0 +1,12 @@
+{
+  "name": "utility-package-summary",
+  "args": [
+    "package_json:path",
+    "repo:path"
+  ],
+  "defaults": {
+    "package_json": "package.json",
+    "repo": "~/.pi/agent/extensions/pi-actors"
+  },
+  "template": "{repo}/scripts/recipe-utils.mjs package-summary {package_json}"
+}

package/recipes/utility-playlist-build.json

@@ -0,0 +1,18 @@
+{
+  "name": "utility-playlist-build",
+  "args": [
+    "repo:path",
+    "source_dir:path",
+    "extensions:string",
+    "max_depth:int",
+    "output_mode:enum(paths,m3u,inline)"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "source_dir": "~/Music",
+    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
+    "max_depth": "2",
+    "output_mode": "paths"
+  },
+  "template": "{repo}/scripts/recipe-utils.mjs playlist {source_dir} {extensions} {max_depth} {output_mode}"
+}

package/recipes/utility-playlist-scan.json

@@ -0,0 +1,12 @@
+{
+  "name": "utility-playlist-scan",
+  "args": [
+    "source_dir:path",
+    "max_depth:int"
+  ],
+  "defaults": {
+    "source_dir": "~/Music",
+    "max_depth": "2"
+  },
+  "template": "find {source_dir} -maxdepth {max_depth} -type f -print"
+}

package/recipes/utility-run-state-files.json

@@ -0,0 +1,14 @@
+{
+  "name": "utility-run-state-files",
+  "args": [
+    "state_root:path",
+    "file_name:string",
+    "max_depth:int"
+  ],
+  "defaults": {
+    "state_root": "~/.pi/agent/tmp/pi-actors/runs",
+    "file_name": "run.json",
+    "max_depth": "2"
+  },
+  "template": "find {state_root} -maxdepth {max_depth} -name {file_name} -type f -print"
+}

package/recipes/utility-run-summary.json

@@ -0,0 +1,12 @@
+{
+  "name": "utility-run-summary",
+  "args": [
+    "repo:path",
+    "state_root:path"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "state_root": "~/.pi/agent/tmp/pi-actors/runs"
+  },
+  "template": "{repo}/scripts/recipe-utils.mjs run-summary {state_root}"
+}

package/recipes/utility-validate-recipe.json

@@ -0,0 +1,14 @@
+{
+  "name": "utility-validate-recipe",
+  "args": [
+    "target:path",
+    "all:bool",
+    "repo:path"
+  ],
+  "defaults": {
+    "target": "recipes",
+    "all": "true",
+    "repo": "~/.pi/agent/extensions/pi-actors"
+  },
+  "template": "{repo}/scripts/validate-recipe.mjs {target} {all?--all:}"
+}

package/recipes/utility-validation-wrapper.json

@@ -0,0 +1,14 @@
+{
+  "name": "utility-validation-wrapper",
+  "args": [
+    "command:string",
+    "scope:string",
+    "timeout_ms:int"
+  ],
+  "defaults": {
+    "scope": ".",
+    "timeout_ms": "300000"
+  },
+  "timeout": "{timeout_ms}",
+  "template": "bash -lc 'cd {scope} && {command}'"
+}